Page tree
Skip to end of metadata
Go to start of metadata

With the URL adapter, it is possible to get and post messages via the protocols listed below. The input and output of this adapter is always of type Blob to support all possible data types (e.g. binary for images, text with HTML code, XML messages, etc.).

We differ between static and dynamic requests. Static means that the whole backend information (host, path, protocol, etc.) is defined in the component diagram and is not modified when called within an action state.
A dynamic call means that the definition is kept in the component diagram, but is modified before sending the request to the host. This is sometimes required, for example, when URL parameters must be calculated or are known at runtime only. Refer to URL Adapter Reference for more information on the URL adapter parameters.

Example File (Builder project Add-ons/URL):

<your example path>\Add-ons\URL\uml\urlUrl.xml

The URL adapter supports the following protocols:

ProtocolDescriptionExample
ldap Via the URL adapter, it is possible to connect an LDAP server to retrieve user information.
You can also access a Microsoft Active Directory Service (ADS) if it provides an LDAP interface.
An E2E example model is provided with the documentation (see example reference).

Example File (Builder project Add-ons/URL):

<bridgeDocPath>\Add-ons\URL\uml\urlLdap.xml
ftp

Example File (Builder project Add-ons/URL):

<bridgeDocPath>\Add-ons\URL\uml\urlFtp.xml

ftps
sftp
http
https
file
gopher
telnet



If large amounts of data have to be transferred, the URL adapter offers the possibility of streaming the data from or into a file so avoiding to utilize large memory chunks. The Streaming FTP section explains how to do this for the ftp protocol. Applying streaming to the other protocols works analogously.

Find an overview on all tagged values and parameters of the URL adapter on URL Adapter Reference.