Web Service actions allow the connection to communicate with the Web Service or HTTP listener. The Type option is important as it determines whether you will be making a true Web Service call or simply passing data over HTTP to an application that is listening.
•String Result - This indicates that you are passing data as parameters via an HTTP call and expect returned data to be passed back as a string. The available Service methods on the right hand side will only include POST and GET.
•XML Result - This gives you the option to also select the SOAP Service method.
If you use either of these methods, then PerfectApps will pass individual app fields as individual parameters. In the Name column, specify a name that the App Designer will be shown. In the Service Parameter Name column, specify the name of the parameter that will be passed to the HTTP listener. You will need one row in this table for each app field you want to pass.
Once the data has been passed, any response from the listener will be returned as the Result field. This can be examined by app behaviors so the app can handle responses appropriately.
SOAP Settings
You have more options available when making a SOAP call. First, click the '...' button to the right of the Service Operation drop-down. This will call the service and retrieve a list of methods exposed by the service's WSDL and populate the drop-down list with these methods. You should now select one of these methods to be used by the action.
As soon as you select a method, PerfectApps will retrieve a list of all the parameters that the selected method expects to be passed. These will be shown to the app designer who can then map app fields to these parameters.
The Return Parameters represents the individual data elements that are returned by the service. You will need to list the fields of data that you want to extract from the returned XML and expose them to the app designer who can then map these fields back into app fields. You will need to use an XPath expression to extract this data.
 |
A full explanation of XPath can be found at the World Wide Web Consortium's page on XPath 1.0 |
See also: REST Web Services Connections, Connection and Action Permissions
Return to: Creating PerfectApps Connections, Integration
