Amal Nagm

• Simple Object Access Protocol (SOAP) SOAP is the communication protocol that defines the XML messages that are used to communicate with the Web service.
• Web Services Description Language (WSDL) WSDL is the XML Schema standard that is used to describe the location, communication protocols, and interfaces to a Web service. InfoPath can consume only document/literal style Web services.
• Universal Description Discovery and Integration (UDDI) UDDI is the directory service that describes the Web services that are offered by a business.

Compatibility considerations

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 or receive data from the forms that are based on this form template.

Design a form template with a query data connection

1. Create the form template When you create a form template that can receive data from a Web service, InfoPath creates a main data connection with a query data connection between the Web service and a form that is based on this form template. InfoPath also creates the main data source of the form template.
2. Add one or more controls to display the query results To allow users to see and edit the data in the fields in the main data source when they open the form, you can add a control to the form template and then bind that control to a field in the main data source.

Step 1: Create the form template

1. On the File menu, click Design a Form Template.
2. Under Design a new, in the Design a Form Template dialog box, click Form Template.
3. In the Based on list, click Web Service.
4. If you are designing a browser-compatible form template, select the Enable browser-compatible features only check box.
5. Click OK.
6. In the Data Connection Wizard, click Receive data, and then click Next.
7. On the next page of the wizard, type the location of the Web service, and then click Next. 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.
   
8. In the Select an operation list, click the Web service operation that returns data to the form, and then click Next.
9. If the Data Connection Wizard encounters an unknown element in the Web service's schema, 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.
10. If the Web service accepts change information, the next page of the wizard asks if you want to include change information in the query data. In most cases, leave the Include change information when submitting data check box selected, and then click Next. If you do not want to include change information, clear the Include change information when submitting data check box, and then click Next. Note This check box is disabled if you are designing a browser-compatible form template.
    Technical details
    This page in the wizard appears only if the Web Services Description Language (WSDL) file for the Web service indicates that the Web service returns a Microsoft ADO.NET DataSet.
11. On the next page of the wizard, type a name for the data connection.
12. Verify that the information in the Summary section is correct and then click Finish.

Step 2: Add one or more controls to display the query results

1. If the Controls task pane is not visible, click More Controls on the Insert menu, or press ALT+I, C.
2. Drag a control onto your form template.
3. In the Control Binding dialog box, select the group or field that you want to bind the control to.

Design a form template with a submit data connection

1. Create the form template When you create a form template that can submit data to a Web service, InfoPath creates a main data connection with a submit data connection between the Web service and a form that is based on this form template. InfoPath also creates the form template's main data source.
2. Add one or more controlsand bind them to groups or fields, or set the control properties to display the data in a field To allow users to edit the data in the fields in the main data source, you can add controls to the form template and then bind those controls to fields in the main data source.
3. Configure the submit options You can configure what data you want to submit to the Web service and the submit options for the form.

Step 1: Create the form template

1. On the File menu, click Design a Form Template.
2. Under Design a new, in the Design a Form Template dialog box, click Form Template.
3. In the Based on list, click Web Service.
4. If you are designing a browser-compatible form template, select the Enable browser-compatible features only check box.
5. Click OK.
6. In the Data Connection Wizard, click Submit data, and then click Next.
7. On the next page of the wizard, type the location of the Web service where your users will submit their data, and then click Next. 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.
   
8. Click Next.
9. In the Select an operation list, click the Web service operation that takes the submitted data, and then click Next.
10. On the next page of the wizard, type a name for the data connection .
11. Verify that the information in the Summary section is correct and then click Finish.

Step 2: Add one or more controls and bind them to groups or fields

1. If the Controls task pane is not visible, click More Controls on the Insert menu, or press ALT+I, C.
2. Drag a control onto your form template.
3. In the Control Binding dialog box, select the group or field that you want to bind the control to.
4. Repeat steps 2 and 3 for any other controls you want to add to the form template.

Step 3: Configure the submit options

1. On the Tools menu, click Data Connections.
2. In the Data Connections dialog box, click the submit data connection in the main data connection, and then click Modify.
3. In the Data Connection Wizard, click Next twice.
4. On the next page of the wizard, do one of the following to select what data in the form to submit for each parameter in the Web service. Submit the data in a field or group
   
   1. In the Parameters list, click the Web service parameter that will receive the data from the form.
   2. Under Parameter options, click Field or group.
   3. Click Modify .
   4. In the Select a Field or Group dialog box, click the field or group whose data you want to submit, and then click OK.
   5. In the Include box, click Text and child elements only to submit just the data in this field and the child elements of the field or group, or click XML subtree, including selected element to submit the field name, the data in the field, and the child elements in the selected group or field.
   Submit all of the data in the form
   
   1. In the Parameters list, click the Web service parameter that will receive the data from the form.
   2. Under Parameter options, click Entire form (XML document, including processing instructions).
   Submit the data as a string
   
   1. In the Parameters list, click the Web service parameter that will receive the data from the form.
   2. Under Parameter options, click Entire form (XML document, including processing instructions).
   3. Select the Submit data as a string check box. Note Typically, you select this check box to submit digitally signed data. In most cases, clear this check box.
      
   Technical details about ADO.NET DataSet objects
   If the Web service requires an ADO.NET DataSet object, select a dataset node when you configure this data connection. If you use any other type of node for a data connection to a Web service that requires an ActiveX Data Objects (ADO) dataset, the submit action will fail.
5. Click Next.
6. Click Finish.
7. Click Close.
8. On the Tools menu, click Submit Options.
9. To change the name of the Submit button that appears on the Standard toolbar and the Submit command that appears on the File menu when users fill out the form, type the new name in the Caption box in the Submit Options dialog box. Tip If you want to assign a keyboard shortcut to this button and command, type an ampersand (&) before the character that you want to use as a keyboard shortcut. For example, to assign ALT+B as the keyboard shortcut for the Submit button and command, type Su&bmit.
   
10. If you do not want people to use a Submit command or the Submit button on the Standard toolbar when they fill out your form, clear the Show the Submit menu item and the Submit toolbar button check box.
11. By default, after users submit a form, InfoPath keeps the form open and displays a message to indicate if the form was successfully submitted. To change this default behavior, click Advanced, and then do one of the following:
    • To close the form or create a new blank form after the user submits a completed form, click the option that you want in the After submit list.
    • To create a custom message to indicate if the form was successfully submitted, select the Use custom messages check box, and then type your messages in the On success and On failure boxes. Tip Use a message in the On failure box to tell users what to do if they cannot submit their form. For example, you can suggest that users save their form and contact someone for further instructions.
      
    • If you do not want to display a message after the user submits a form, clear the Show success and failure messages check box.

Design a form template with query and submit data connections

1. Create the form template When you create a form template that can both query and submit data to a Web service, InfoPath creates a main data connection between the form template and the Web service with a query data connection and a submit data connection. InfoPath also creates the form template's main data source.
2. Add a control and bind it to a field to display the data in a field To allow users to see and edit the data in the fields in the main data source, you can add controls to your form template and then bind those controls to fields in the main data source.
3. Configure the submit options You can configure what data you want to submit to the Web service and the submit options for the form.

Step 1: Create the form template

1. On the File menu, click Design a Form Template.
2. Under Design a new, in the Design a Form dialog box, click Form Template.
3. In the Based on list, click Web Service.
4. If you are designing a browser-compatible form template, select the Enable browser-compatible features only check box.
5. Click OK.
6. In the Data Connection Wizard, click Receive and submit data, and then click Next.
7. On the next page of the wizard, type the location of the Web service with the operation that sends data to the form template, and then click Next. 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.
   
8. In the Select an operation list, click the Web service operation that returns data to the form, and then click Next.
9. 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.
10. If the Web service accepts change information, the next page of the wizard asks if you want to include change information in the query data. In most cases, leave the Include change information when submitting data check box selected and click Next. If you do not want to include change information, click to clear the Include change information when submitting data check box and then click Next. Note The check box is disabled if you are designing a browser-compatible form template.
    Technical details
    This page in the wizard appears only if the Web Services Description Language (WSDL) file for the Web service indicates that the Web service returns an ADO.NET DataSet.
11. On the next page of the wizard, type a name for the query data connection, and then click Next.
12. On the next page of the wizard, type the location of the Web service where your users will submit their forms, and then click Next. 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.
    
13. In the Select an operation list, click the Web service operation that takes the submitted data, and then click Next.
14. On the next page of the wizard, do one of the following to select what data in the form to submit for each parameter in the Web service. Submit the data in a field or group
    
    1. In the Parameters list, click the Web service parameter that will receive the data from the form.
    2. Under Parameter options, click Field or group.
    3. Click Modify .
    4. In the Select a Field or Group dialog box, click the field or group whose data you want to submit, and then click OK.
    5. In the Include box, click Text and child elements only to submit just the data in this field and the child elements of the field or group, or click XML subtree, including selected element to submit the field name, the data in the field, and the child elements in the selected group or field.
    Submit all of the data in the form
    
    1. In the Parameters list, click the Web service parameter that will receive the data from the form.
    2. Under Parameter options, click Entire form (XML document, including processing instructions).
    Submit the data as a string
    
    1. In the Parameters list, click the Web service parameter that will receive the data from the form.
    2. Under Parameter options, click Entire form (XML document, including processing instructions).
    3. Select the Submit data as a string check box. Note Typically, you select this check box to submit digitally signed data. In most cases, clear this check box.
       
    Technical details about ADO.NET DataSet objects
    If the Web service requires an ADO.NET DataSet object, select a dataset node when you configure this data connection. If you use any other type of node for a data connection to a Web service that requires an ADO.NET DataSet, the submit action will fail.
15. Click Next.
16. On the next page of the wizard, type a name for the submit data connection, and then click Finish.

Step 2: Add a control and bind it to a field to display the data in a field

1. If the Controls task pane is not visible, click More Controls on the Insert menu, or press ALT+I, C.
2. Drag a control onto your form template.
3. In the Control Binding dialog box, select the field that you want to bind the control to.

Step 3: Configure the submit options

1. On the Tools menu, click Submit Options.
2. To change the name of the Submit button that appears on the Standard toolbar and the Submit command that appears on the File menu when users fill out the form, type the new name in the Caption box in the Submit Options dialog box. Tip If you want to assign a keyboard shortcut to this button and command, type an ampersand (&) before the character that you want to use as a keyboard shortcut. For example, to assign ALT+B as the keyboard shortcut for the Submit button and command, type Su&bmit.
   
3. If you do not want people to use a Submit command or the Submit button on the Standard toolbar when they fill out your form, clear the Show the Submit menu item and the Submit toolbar button check box.
4. By default, after users submit a form, InfoPath keeps the form open and displays a message to indicate if the form was successfully submitted. To change this default behavior, click Advanced, and then do one of the following:
   • To close the form or create a new blank form after the user submits a completed form, click the option that you want in the After submit list.
   • To create a custom message to indicate if the form was successfully submitted, select the Use custom messages check box, and then type your messages in the On success and On failure boxes. Tip Use a message in the On failure box to tell users what to do if they cannot submit their form. For example, you can suggest that users save their form and contact someone for further instructions.
     
   • If you do not want to display a message after the user submits a form, clear the Show success and failure messages check box.