About

Url Builder

The psg.UrlBuilder Script simplifies the use of the REST Connector.

  • Standard pattern to use the REST Connector.

  • Takes care of required prameter encoding

  • Reduces the use of Booomi Components to a minimun.

    • Requires one REST Connector per target API.

    • Work with fully generic REST Operations which can be shared through all connectors.

  • Workaround for the REST Connector bug.

How to use the Url-Builder Script

The script takes two Process Properties as input:

  • UrlBuilder.DPP_PathTemplate - A Template for the Url-Path (excl. the first /) with Dynamic Document and/or Dynamic Process Properties as placeholders. Example: universes/{DPP_UniverseId}/records/{DPP_GRID}/sources/{DPP_SRC_EFX}/unlink?entityId={DDP_EFXID}

  • UrlBuilder.DPP_QueryTemplate - A template for the Url-Query (excl. the ?) with placeholders.

The script builds the full http-encoded URL (Path + Query) into UrlBuilder.DDP_Url.

Path vs. Query Template - Encoding

The reason there are two templates is that the URL path is not encoded, while the query part must be encoded to create a valid URL. The script handles the encoding.

Always set both templates right before calling the script!

REST Client Connector Configuration

Use the UrlBuilder.DDP_Url (output property) as the only configuration setting on the REST Client Connector! The REST Client Connector Operation is 100% generic with no dependency.

A generic REST Operation

A generic REST Operation has no dependency and it could be used with any (all) REST Connector, regardless of the endpoint.

A generic DELETE REST Operation

Last updated