Service : Integration

Services provide integration service orchestration capabilities. They are essentially workflow for integration.

Description

Services tie together integration structures. They are very similar to Workflows, but instead of a Class as the process token, a Service uses a message. Each step in a Service returns a message. Steps can:

* run script,
* send messages,
* send and receive messages to external systems asynchronously,
* transform messages
* persist object messages to the domain model
* sync object messages using the additional capabilities of the synchronization framework. The sync framework maintains a model of various sync targets and keeps track of each synchronized instance so it can detect conflicts. The sync step is really an extension of the persist step that allows for processing and conflict resolution.
* try/catch blocks to handle exceptions
* dispatch for branching based on conditions of the message or service
* parse and format messages

Services can be either invoked by

* calling SysService'invoke - similar to SysWorkflow'start
* or it can be bound to a channel. When a message arrives on the channel asynchronously the service is activated.

Properties

args : identifierList

Service arguments: arg1 arg2 ... argN. A special argument is *:output* which keeps track of the output channel.

These are arguments that the service expects. They can be passed in by SysService'invoke... or by setting the properties on a Service Binding.

Valid values based on“token”.
(:?[\p{L}_][\p{L}\p{N}_]*(:[\p{L}_][\p{L}\p{N}_]*)*\s+)*(:?[\p{L}_][\p{L}\p{N}_]*(:[\p{L}_][\p{L}\p{N}_]*)*)?	Each element in the list must begin with a letter or underscore. Elements are space delimited.

description : string

Service description.

interface : string

Service interface. If not specified, the service can process any message, which is provided in raw (unparsed) format.

layout : string

GUI layout data.

privilege : string

Privilege required to invoke the service.

privileged : boolean

True to execute the service in privileged mode (without security restrictions).

stream : boolean

True to provide a stream input in the raw message body.

variables : identifierList

Service variables: var1 var2 ... varN.

Variables can be used to pass information from step to step or control message flow.

Valid values based on“token”.
(:?[\p{L}_][\p{L}\p{N}_]*(:[\p{L}_][\p{L}\p{N}_]*)*\s+)*(:?[\p{L}_][\p{L}\p{N}_]*(:[\p{L}_][\p{L}\p{N}_]*)*)?	Each element in the list must begin with a letter or underscore. Elements are space delimited.

Content

• Choice of:

  • Script [1..1]

  • Goto [1..1]

  • Transform [1..1]

  • Dispatch [1..1]

  • Loop [1..1]

  • Semaphore [1..1]

  • TryCatch [1..1]

  • Persist [1..1]

  • Sync [1..1]

  • Send [1..1]

  • SendReceive [1..1]

  • Join [1..1]

  • any [1..1]