Amal Nagm

Before you begin

• The location of the Web service.
• Verification that the Web service uses document/literal style encoding. InfoPath can consume only document/literal style Web services.
• The name of the Web service operation that will send data to the form.
• Whether you can safely store the query results from the Web service on the users' computers for offline use.

Step 1: Add a query data connection

1. On the Tools menu, click Data Connections.
2. In the Data Connections dialog box, click Add.
3. In the Data Connection Wizard, click Create a new connection to, click Receive data, and then click Next.
4. On the next page of the wizard, click Web service, and then click Next.
5. On the next page of the wizard, type the location of the Web service.
   Note If you want to search for a Web service by using a Universal Description Discovery and Integration (UDDI) server, click Search UDDI, enter the URL of the UDDI server that you want to search, specify whether you want to search by provider or by a service that is provided, enter a search keyword, and then click Search. Web services that match your search keyword will appear in the Search result list. Select the Web service that you want to use, and then click OK.
6. Click Next.
7. In the Select an operation list, click the Web service operation that returns data to the form, and then click Next.
8. If the Data Connection Wizard encounters an unknown element in the schema of the Web service, the next page of the wizard may ask you to specify sample values for each parameter to determine what fields or groups to add to the main data source.
   How?
   1. Select a parameter in the Parameters table, and then click Set Sample Value.
   2. In the Sample value box, type a value that your user might use for this field, and then click OK.
   3. Repeat these steps for each parameter in the Parameters table, and then click Next.
   Technical details
   When you configure a data connection to a Web service in the Data Connection Wizard, Microsoft Office InfoPath connects to the Web service and requests the Web Service Description Language (WSDL) file. The WSDL file contains the schema used by the Web service. The Web service responds to the request by sending this file to InfoPath. InfoPath uses the information in this file to add the appropriate fields and groups to the secondary data source in the form template. If InfoPath finds an unknown element type in the WSDL file, InfoPath uses sample data to determine the definition of the unknown element type and then adds the appropriate fields and groups to the secondary data source.
9. If you want the results of the query to be available when the form is not connected to a network, select the Store a copy of the data in the form template check box.
   Security Selecting this check box stores the data on the user's computer when the form uses this data connection. If you are getting sensitive data from this data connection, you may want to disable this feature to help protect the data in case the computer is lost or stolen.
10. Click Next.
11. On the next page of the wizard, type a descriptive name for this secondary data connection.
12. To have the form automatically receive data when it is opened, select the Automatically retrieve data when form is opened check box.

Step 2: Configure the control

1. If the form template has multiple views, click View name on the View menu to go to the view with the control where you want to display the data from the secondary data source.
2. Double-click the list box, drop-down list box, or combo box that you want to populate.
3. Click the Data tab.
4. Under List box entries, click Look up values from an external data source.
5. In the Data Source list, click the data source with the group or fields containing the data that you want to use.
6. Click Select XPath next to the Entries box.
7. In the Select a Field or Group dialog box, specify what data will be shown to the user and what data will be submitted to the external data source by doing one of the following.
   Specify that the data the user will see is the same data that the user will submit
   • Click a field, and then click OK.
   Specify that the data the user will see is different from the data that the user will submit
   Note In this scenario, the data that the user will see is from one of the fields in the group, and the data that the user will submit is in another field in the same group.
   1. Click a group, and then click OK.
   2. In the Control Properties dialog box, click Select XPath next to the Value box.
   3. In the Select a Field or Group dialog box, click a field that contains the data that the user will submit to the external data source, and then click OK.
   4. In the Control Properties dialog box, click Select XPath next to the Display name box.
   5. In the Select a Field or Group dialog box, click a field that contains the data that will appear in the control, and then click OK.
8. If the field in the Display name box has values with similar display names and you want to display only unique names, select the Show only entries with unique display names check box.