Versions Compared

Key

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

Insert excerpt
_ExcerptWSDC
_ExcerptWSDC
nopaneltrue

When you configure a Data Retriever Connector applet to get data from or send data to an external web service, you can send hard-coded values to that web service in the request object. You can also send custom configuration values that are encrypted and stored by NewVoiceMediaVonage Contact Center. For example, your web service might require a password to access it. Instead of hard-coding the password in the Data Retriever Connector applet for anyone with access to the applet to see, you can request that NewVoiceMedia Vonage Contact Center encrypts and stores this password for you in a custom configuration setting. You can then send the password in the request to the configured web service.To insert

You can use Data Source values in the following ways:

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

...

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

Placeholders must be in the format #(CustomConfigurationKey). Replace CustomConfigurationKey with CustomConfigurationKey with the name of the custom configuration setting that contains the value you want to use in the request.

Expand
titleExample

For example, using the placeholder #(WebServicePassword) the value of the setting called WebServicePassword is decrypted and sent in the request. You can use the placeholder in the following places:

  • In the Url element:

...

...

  • Url>.
  • In a Header element: <Header><Key>OrderId</Key><Value>#(WebServicePassword)</Value><Header>
  • In the Body element: <Body>![CDATA[#(WebServicePassword)]]</Body>

When the call reaches this applet, #(WebServicePassword) is replaced with the decrypted WebServicePassword and the web service uses the password accordingly.

If the custom configuration setting does not exist or has no value, the call is routed to the Interface Failure applet.

If the custom configuration setting is null, the placeholder is removed.