- Introduction to WorkXpress
- Building Your Application
- Examples and Best Practices
- Technical Manual
This action will communicate with a web service. Currently both SOAP and REST web services are supported. There are many such public (free) and premium web services in existence supporting integrations and new functionality to incorporate into your application.
Use a web service action whenever a remote, SOAP web service should be triggered. The web service action type reads the provided WSDL and interprets the services available as well as the input and output parameters of the service. In other words, it asks the web service what all it can do, and then for each thing it can do it figures out what has to be given to the service, and what it will give back.
Example: Suppose an application works with customers that are in both the UK and the USA. A useful form on the dashboard would be a US Dollars to Pounds converter. A builder would create a field grid with a currency field for the US Dollars amount, and when that form is saved trigger a Web Services actions to connect to a service like this one to get the most recent conversion multiplier for US dollars into pounds, do the math, and show that to their user.
The result of this expression will be used when the action is processed. This can be IP address based (e.g. http://255.255.255.0/soap.php?wsdl) or domain name based (e.g. http://www.myserver.com/soap.php?wsdl).
If the URL entered in the expression builder above has a dynamic component that you can't access in this context, enter a static version of your URL here. This setting will be used only for setting up the action.
Enter the number of seconds to wait for the service to respond before bypassing this action.
The WSDL was read successfully, and these services are available. Please select one to call. The values the service you select needs to function and the values it returns will be displayed below.
Depending on the WSDL you enter, the services list will change based on what the WSDL can do.
The selected service needs to know the following value(s). Use expression builders to define each one. These values will be sent to the service when this Action runs.
This list of service-dependent values are needed by the service to do it's job.
The selected service will return the following value(s). Use query builders to define where to store each returned value. These values will be returned from the service when this action runs.
Useful as a comment, this description will overwrite the automatically generated description in the Action Manager.
Use a web service action whenever a remote, REST web service should be triggered. Unfortunately, REST API's don't have the same self-documenting capabilities as SOAP Web Services, so you will have to rely on the REST API's documentation to clearly define what services are available, and what request and response formats the service requires. Our interfaces allow you to call GET, PUT, POST, PATCH and DELETE REST web services, pass request information via HTTP Headers, JSON or XML, and store the response Code, Text, and any Response Headers.
REST Web Services will be available in Platform version 13.10.836.
The result of this expression will be used when the action is processed. This can be IP address based (e.g. http://255.255.255.0/contacts/12345) or domain name based (e.g. http://www.myserver.com/contacts/12345).
Some web services may use HTTP Basic Authentication as a way of securing their API from unauthorized access. If the service requires the use of HTTP Basic Authentication use the Expression Fields to provide the username and password.
Enter the number of seconds to wait for the service to respond before bypassing this action.
An optional field, make a choice between XML, JSON, or HTTP Header Key/Value Pairs. Since this is an optional field, it can be left blank if there is no need to pass request information other than through the Requestion URL.
The result of this expression will be sent with the REST request as the request body. Be sure to consult the documentation for the REST API you're integrating with for details.
The result of this expression will be sent with the REST request as the request body. Be sure to consult the documentation for the REST API you're integrating with for details.
Define a set of Request Headers to send in the request and use an expression to define the value to send. If a web service, for instance, expects the details for a Product in it's headers, instead of in XML, or JSON in the request body, then you might create Header Name's like “Product ID” and “SKU Number” to define these values for the API request.
Query a record and choose a field in which to store the web service's result's response body. If the headers of the response contains a Content Type that indicates that the response body is a binary file then the response body is encoded using Base64. This allows for the response body to be stored in the Encoded File part of a File Attachment field.
The Binary Content Types supported are:
Query a record and choose a field in which to store the web service's result's response code.
Define a set of Response Headers to read from the response and use a query to find the field to store the value in. If a web service, for instance, returns the details for a Product in it's headers, instead of in XML, or JSON in the response body, then you might create Header Name's like “Product ID” and “SKU Number” to pull these values from the HTTP Headers and store them in WorkXpress.
Useful as a comment, this description will overwrite the automatically generated description in the Action Manager.
If a web page retrieved uses a cookie to generate a session then child REST actions under this action will use the same session. This is useful in cases where the first REST call is to a login page and subsequent calls are made to pages that are secured by the login.