Configuring the Developer Sample Forms [InfoPath 2003 SDK Documentation]
When you install the Microsoft Office InfoPath 2003 Software Development Kit (SDK), all of the files for the developer sample forms are copied to your hard disk as subfolders of the <drive>:\Program Files\Microsoft Office 2003 Developer Resources\Microsoft Office InfoPath 2003 SDK\Samples\ folder. Before you use the sample forms, however, you must configure a few preliminary settings. The InfoPath SDK includes a configuration utility for configuring the developer sample forms.
Note The BizTalk Purchase Order and Web Service Purchase Order developer sample forms have additional setup configuration utilities that must also be run before you can use them. See About the BizTalk Purchase Order and Invoice Sample Forms and About the Web Service Purchase Order and Invoice Sample Forms for more details.
To run the configuration utility, click the Start button, point to All Programs, point to Microsoft Office 2003 Developer Resources, point to Microsoft Office InfoPath 2003 SDK, point to Setup, and then click Samples Setup.
The InfoPath SDK configuration utility
The InfoPath SDK configuration utility has three sections with settings and command buttons to configure different parts of your system and the developer sample forms. The following sections describe these configurations.
The first section of the InfoPath SDK configuration utility creates virtual directories in Microsoft Internet Information Services (IIS). These virtual directories include a root directory named InfoPathSDK, with subdirectories for the Data Submission, Information Lookup, and Web Service developer sample forms.
To create the virtual directories, specify the local IIS server name, and then click Execute. When the virtual directories have been created, the status will appear as Complete.
In addition to creating the virtual directories, the configuration utility also grants the ASPNET user account read and write permissions for DataSubmit\server and WebSvc\server directories.
This section of the configuration utility will fail if Internet Information Services (IIS) is not installed on the specified server.
Uninstalling the InfoPath SDK will not remove the virtual directories from IIS; you will need to do this manually.
If IIS was installed after the Microsoft .NET Framework was installed, the following command should be run at the command prompt to register the ASPNET user account:
Note Run this command from the folder in your Windows directory that contains the .NET Framework utilities. Search in %WINDIR%\Microsoft.NET\Framework for aspnet_regiis.exe to find the folder that contains the .NET Framework utilities on your computer.
The second section of the InfoPath SDK configuration utility creates and tests the connection string that is used to connect to a Microsoft SQL Server Northwind database, which is used by some of the developer sample forms.
To create the connection string, specify the name of the SQL Server (which can be local or remote), the authentication type (Windows or SQL Server), and the user ID and password if using SQL Server authentication; then click Test Connection. The configuration utility will attempt to open and close a connection to the Northwind database; if it is successful, the status will appear as Complete.
Note This section of the configuration utility will fail if SQL Server is not installed on the specified server, or if the Northwind database is not present on the specified server.
Note You should successfully execute the commands in the first two sections of the configuration utility before updating the developer sample forms using this section.
The third section of the InfoPath SDK configuration utility updates the developer sample forms with the virtual directories and the connection string for the SQL Server. The configuration utility will extract the form files for each of the sample forms, update information in their form definition (.xsf) and config.xml files, and re-package the files in their original .xsn format.
To update the developer sample forms, click Execute. When the developer sample forms have been updated, the status will appear as Complete.
In addition to the three configuration sections, the InfoPath SDK configuration utility also includes three buttons, shown in the illustration, that perform the following actions:
- Close This button exits the configuration utility.
- Reset This button restores the default values in various fields of the configuration utility.
- Log This button opens a text file with a log of all of the configuration options that the configuration utility has set.