HTTP (Input Agent Cron)

Introduction: Phase 1 and HTTP and Lobster_data.


Data is requested via a URL. The response has to be in text format.


images/download/attachments/36578782/Cron_HTTP_1_EN-version-2-modificationdate-1565675295000-api-v2.png

images/download/attachments/36578782/Cron_HTTP_2_EN-version-2-modificationdate-1565677188000-api-v2.png

images/download/attachments/36578782/Cron_HTTP_3_EN-version-1-modificationdate-1563873005000-api-v2.png


(1) Here you can select a channel of type HTTP. Note: If possible, always use channels to centrally manage connection parameters. In addition to the increased clarity that also facilitates maintenance. If the connection parameters change, you only have to adjust the data in one place and you do not forget a profile.

(2) If (3) is an HTTPS URL, you can optionally assign a client certificate. To do this, you select one of the local certificates.

(3) The URL (with port) of the remote HTTP(S) server. Note: There is no URL encoding.

(4) If set, the DMZ server (if available) will be used for sending the request instead of the internal Integration Server.

(5) You can set an optional timeout for the HTTP connection. Default: 90 seconds.

(6) If this checkbox is set, then HTTP status codes not equal to 2xx (success) do not cause the profile to terminate. This allows custom error handling. See also system variables MSG_CALL_VAR_HTTP_<name of header in uppercase letters>. Example: MSG_CALL_VAR_HTTP_STATUS_CODE .

(7) If you click this button, another dialogue opens, in which you can enter additional HTTP headers. You can use variables for the header names and the values. Syntax: @<Variable name>@. Note: You can use header Set-Cookie to write cookies.

(8) Optionally, authentication data can be specified here. Variables are allowed. For Microsoft IIS with authentication by NTLM v1 or NTLM v2 see also section Windows Authentication at HTTP Server.

(9) This checkbox is only required when operating the profile as a web service. If set, additional button will appear below the data field. See section Web Services.

(10) The HTTP method, the MIME type (content type of the body) and the data (content of the body) of the HTTP request.

(11) You can insert multiparts or file attachments. Only HTTP methods POST, PUT and PATCH are supported, see (10). If a wrong method is used, method POST will automatically be set.

If the prefix file: is used in an entry in column Value/Path, e.g. file:./conf/data/communication_list.pdf, the file ./conf/data/communication_list.pdf is loaded at runtime and inserted as a multipart. You have to set checkbox Is file, the value of column File name replaces the name of the specified file and the MIME type is optional (default value application/octet-stream). Without the prefix, the content of the columns is inserted as a file attachment with UTF-8 encoding. In both cases, the key is arbitrary, but must be unique.

Note: See also function http(a,b,c,d,e,f,g,h,i,j,k,l,m,n).

System Variables


The system variables MSG_CALL_VAR_HTTP_<name of header in uppercase letters> are relevant for reading out HTTP response headers. Example: MSG_CALL_VAR_HTTP_STATUS_CODE .