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

The system adapter can be used for rapid prototyping by enabling the reuse of existing programs (e.g. batch jobs). However, this adapter must be used carefully because the E2E Bridge does not impose any constraints on the executed program. Additionally, the Bridge performance degrades, if the system adapter gets called frequently because each call creates new processes on the host. We recommend using the system adapter for purchased executable software and modules or existing complex executable modules which would be too expensive to re-build with UML.

Example File (Builder projectAdd-ons/System):

<your example path>\Add-ons\System\uml\system.xml

The system adapter is marked with the stereotype <<SystemAdapter>> on the action node. The executable program has to be defined in the tagged value command of the action node. There are two mandatory parameters of the <<SystemAdapter>> which must be named as follows: inputCount and outputCount (both of type Integer). If the system command requires no parameters, the value has to be set to 0.

If the program to be executed can be run without parameters, the call is very simple, see the figure below.

Figure: Execution of an External Program without Parameters

If the program has input parameters and output values, which have to be handled by the Bridge, the following objects have to be used:

The name and type must be defined in exactly that way, so that the Bridge can pass the input parameter to the calling executable and map the output of the program to UML classes.
The type must be an array of blobs for both objects. The reason for using the type Blob is to have the flexibility to have any kind of input (Strings, binaries like used in images, etc.). For example, if the parameter is a String value, it has to be transcoded to a Blob type first (see transcodeToBlob() Operation). As it has to be possible to provide more than one input parameter and more than one output value (e.g. one for the value and one for the error message) arrays are used and not simple blobs.

The Bridge expects the input parameters and output values to be files. If the executable does not support a file interface, the whole system command must be prepared by Bridge operations (see Figure: System call with calculated command line).