Web service action

A web service call can be executed with a web service action. This requires a registered web service in the "Integration" module. You can find out how to configure a web service there here.

The web service action can be found in processes in the "Elements" area. From there, it can be inserted and configured at the desired point in the process chain using drag & drop. General information on creating process elements can be found here.

Once you have created the web service action on the workspace, open the properties dialog by double-clicking on the element.

General

All information about the settings in this dialog can be found here.

Web services

The name of the web service call and the path in the WSDL structure are displayed here.

Configure web service

Opens a dialog in which a web service can be registered.

Add web service call

Opens a dialog in which a web service call can be selected.

Select web service request

If web service offers are called up from other Intrexx portals, a login is required if the portal in question is connected with

of the Intrexx authentication is configured. The intrexxLogin operation is used for this.
of the integrated Windows authentication is configured. The login operation must be used here.

The actual web service operations can only be requested after this. In closing, the logout operation needs to be used so that the session is ended correctly.

Select the desired call and click "OK".

Delete web service call

Deletes an entered request.

Edit

Opens the dialog for selecting the web service call, in which the structure of the web service is displayed. You will also find the additional "Configuration" tab.

Increase / decrease priority

The arrow buttons allow the priority to be changed when multiple requests are defined. Multiple web services will be executed one after another in sequence. The uppermost call will be started first; afterwards, all requests below it will follow in order.

Input" tab - Parameter type

Here, the structure of the operation from the request web service is depicted. Select the method that should provide a value from the application. The "Edit" context menu can then be used to define the source of the value. The data type expected by the web service is indicated in brackets next to the method. Further information on the individual parameter types can be found here. Select the desired method and click "Next".

Output" tab

Create session variable

A new session variable can be created here via the context menu, which can then be assigned as a target to the value provided by the web service by clicking on the arrow buttons.

Create variable in the processing context

A new variable can be created here in the processing context via the context menu, which can then be assigned as a target to the value provided by the web service by clicking on the arrow buttons.

Create user-defined variable

A new user-defined variable can be created here via the context menu, which can then be assigned as a target to the value provided by the web service by clicking on the arrow buttons. Information on Namespace and Local Part can be found here.

Parameter types

Here you will find an overview of the parameter types that can be selected as input.

Value from data field

The "Value from data field" parameter type can only be selected if a data group is available - e.g. if the process chain starts with a data group event handler. After clicking on "Next", select the desired data field.

System value

System

Depending on the input parameter type, the current value of the system fields record ID, parent record ID or the date value (today (with time)) can be transferred.

User

Values from the "User" module (e.g. first name, surname, personnel number, etc.) can be selected here. their current value will be used as the input.

Static value

A static value can be defined as the input parameter here. Please use the format yyyy-MM-ddTHH:mm:ssZ for date values (e.g. 2017-09-12T14:45:00Z). Please use "true" or "false" for Boolean values. The value entered here cannot be changed via the browser.

Session variable

Standard values

All values that are saved in a session variable by Intrexx when visiting a page are available for selection here:

Session ID
Creation time of the sessions
Language
Timeout
Anonymous

Additional variables

The "Session variable" parameter type can be used if several web services are queried. For this, the return values of an already requested web service will be written to a user-defined session variable and then later used as an input in one of the subsequent web services. A user-defined session variable can be defined on the "Output" tab. The new session variable is declared there using the "Add session variable" context menu.

Processing context

The sharedState variable name can be entered here. This name should always begin with a lower-case letter. If it is made up of several words, the first letters of the other words are capitalized.

Parameter type: User-defined variable

Enter the namespace and local part here.

An XML qualified name (QName) is constructed of two parts:

A namespace URI
A local part

Example

Namespace: https://schemas.domain.de/variableNames/
Local part: myValue

Namespace: urn:variableNames
Local part: myValue

Two qualified names are the same if both their namespace and their local name match. These entries are case-sensitive.

Return value from web service

The structure of the dialog corresponds to the "Web services" tab in the properties of the web service action.

Output" tab

Here, all return values of the web service that has been selected in the upper area of the dialog will be shown. This means that return values from previously submitted calls can be selected as inputs as well.

Input and output parameter types must match. The priority of the calls, which controls the sequence of requests, must also be taken into account for the parameter type "Return value of web service".

Nil

Nothing is assigned with this parameter type. The ability to make an assignment of "nothing" explicit can be useful in certain cases to resolve ambiguities in the assignment at runtime that would otherwise lead to errors.

Configuration

You can find the configuration if you edit a web service on the "Web services" tab in the properties of the web service action.

Factory class

Classes can be entered here, which are used at runtime in order to create objects that perform web service requests among other things. This mechanism is used, for example, to perform the Intrexx login with the class "de.uplanet.lucy.server.bpee.IntrexxLoginWebServiceCallBpeeExecutableFactory". This class performs two requests in sequence for the Intrexx login operation without making this process visible to the user.

Properties

Factories can be made into parameters, for example with timeout values for the creation of a connection and server reply.

Add parameter inserts a new line, Delete parameter deletes the currently selected parameter.

Name" column

The name of the parameter is shown here. If you click in a cell here, you can select an Intrexx parameter or enter your own parameter directly.

Value" column

The parameter value can be edited here.

Definable parameters

When requesting a web service, the parameters mentioned here can be set.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.socketTimeout

Defines the timeout - how long to wait for a response after a successful connection. The desired time must be specified in milliseconds.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.connectionTimeout

Defines the timeout - how long the web service takes to accept the connection. The desired time must be specified in milliseconds.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.preemptiveAuthentication

In case of HTTP Basic authentication, the credentials are sent in advance before the server sends a possible unauthorized response. The value is false by default.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.username

Static user name that should be used for HTTP Basic authentication.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.password

Static password that should be used for HTTP Basic authentication.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.host

Name of the host to authenticate to.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.port

Port of the host to authenticate to.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.transport.http.protocolVersion

The HTTP protocol version.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.transport.http.chunked

Specify whether chunked transfer encoding should be used (true/false).

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.allowedRetry

Set to true if the authentication scheme should allow retries. The value is false by default.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.realm

Validity range of the current authentication scheme.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.domain

Domain required for authentication.

            de.uplanet.lucy.server.bpee.WebServiceCallBpeeExecutable.authenticator.authSchemes

List for authentication schemes, e.g. Digest Basic.

Script

You can find the "Script" tab if you edit a web service on the "Web services" tab in the properties of the web service action.

Here, you have the option of composing Groovy script that will be performed during the web service request. To do this, the portal right "Publish Velocity and Groovy scripts" must be granted.

Click on "Create Groovy script" to open the Groovy script editor.

More information

Processes" module

Create and manage processes

The areas of the "Processes" module

Creating and editing elements

Analyze log file

Options

External data in processes

Java classes in process objects