For the Transformer to call a third-party web service, you must map the input and output attributes and define the web service in the Output Transformations settings. The names of the input and output attributes are fixed for specific web service.
To configure third-party web services
- Right-click the Transformer process and select Edit Process. You can also double-click the process to open it for editing.
- Click the Output Conditionals tab.
- Right-click within the Output Transformations pane (right-hand side) and select Add > New > Web Service. The Web Service window opens.
- Enter a brief Description of the web service. The description will be inserted in the statistics file.
-
Specify the location and the name of the Map File. Do one of the following:
- If your Map File is on the server, select it by clicking Import from server.
- If your Map File is on the client, select it by clicking Upload from client.
- If you want to copy the Map File from the server to the client, select the file by clicking Import from server, and then click Copy to Client. After copying the file to the client, click Upload from client and select the file.
Note: You cannot manually enter a path to the Map File location. Once specified, the Map File will be moved to the \tables folder in the repository. Each type of web service call requires its own Map File, even if the same service is called when a different response is requested or a different input method is supplied. For example, if a web service allows a call with either an entire address as one argument or a set of arguments corresponding to the address elements such as house number and street name, then each of these calls requires its own Map File even though the return value would be the same. -
Click Map File Attributes Configuration. The Input Attributes Configuration window opens, showing the names of the input attributes for your web service.
Do one of the following:
- If the input attributes are not yet specified, you need to map them. Go to Step 7 and do the mapping.
- If the input attributes are already specified, you do not need to map them. Confirm that the Use blank map value option is correctly set for each attribute and then go to Step 10.
- Use blank map value is used to identify input attributes you do not want to use. If this option is checked, the web service will send a blank value for that input attribute instead of looking for a value in the Transformer output data buffer.
- Click Select Mapping. The Web Service Input Mapping window opens.
-
Select attributes in the Unmapped Attributes column and click Select to move selected attributes to the Mapped Attributes column. You can concatenate multiple attributes. There is no limitation to the number of attributes that can be mapped. You can also do the following:
- UnSelect. Move selected attributes to Unmapped Attributes column.
- Select All. Select all attributes and move them to the Mapped Attributes column.
- Unselect All. Clear all attributes from the Mapped Attributes column.
- Move Up. Move selected mapped attribute up one position.
- Move Down. Move selected mapped attribute down one position.
- After you have done mapping for all input attributes, click OK. You can remove attributes from mapping by clicking the X icon next to the attribute name.
- Select the Output Attributes Configuration tab. The Output Selection window opens and displays the Output Selection Map for your web service in a tree structure. Depending on the web service, there are multiple sets of output selection (for example, 0-10).
-
Do one of the following to select the web service attributes to be generated in the output:
- To select all attributes in the section, click the check box next to each Output Selection Map.
- To select individual attributes, click the arrow on the left of each Output Selection Map to expand the section, and then click the check boxes next to individual attributes.
The selected output attributes will be added to the output schema. The default encoding for those attributes is UTF8.
- (Optional) Enter Length for each attribute. The default is 50. If you want to set all attributes to be the same length, enter a value in the Set All Length box and click Set All.
-
(Optional) To redefine the output attributes, select the attribute from the list under the Redefine section.
Note: The length specified in this step will override the original length specified in the output schema.
- When you finish configuring the input and output attributes, click Back to save the configuration.
- (Optional) Enter the number for Time Out. It sets the maximum wait time in seconds for a service response before timeout occurs.
-
(Optional) If applicable, in the User Credentials section, enter Type and Value for the web service. Use Remove this credential to clear the credentials you entered. Use Add new credential to add multiple credentials.
- See examples
-
Type: key Value: 4g3w2wuqfqjujrum4xxpwwwwwwww
Type: k Value: 12520156051659197627-a6d8e761-4fe3-4fd1-881dwwwwww
-
Click Finish.