Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When you configure a Data Connector applet to get data from or send data to an external web service, you can send static values to that web service in the request object. You can also send values that other applets in the interaction plan have collected and stored in Data Sources—Data Sources are specific to each interaction so you cannot know their values when you configure the Data Connector applet. For example, you can pass the contents of a Data Source that contains the caller's order ID, and use this order ID to get information about the caller's order from the configured web service.

To You can use Data Source values in the following ways:

  • If you are defining the web service interaction using XML, to insert a Data Source value into a request, use a placeholder in the Url element, Key or Value element of a header, or in the CDATA section of the Body element.

...

  • If you are using a template to define the web service interaction, to insert a Data Source value into a request, use a placeholder in any required request parameter fields.

Placeholders must be in the format $(DataSourceName). Replace DataSourceName Replace DataSourceName with the name of the Data Source that contains the value you want to use in the request.

...

If the Data Source is null, the placeholder is removed.

Info
titleRemove leading '+' characters

If a data source contains a phone number in E.164 format, with a leading '+' character, you can use the data source with the RemoveLeadingPlus formatter. RemoveLeadingPlus removes '+' characters at the beginning of the data source value.

For example, if data source CustomerClid contains the value '+1234567890' and the value is required without the '+' character, add the RemoveLeadingPlus as a suffix at the end of the data source name: $(CustomerClid:RemoveLeadingPlus). The data source value is returned as '1234567890'.