Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 21.2a
Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameexecution_preliminaries
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Differences of Operations

Image Removed

Operations in a library can be static or non-static operations.

Tip

Use the execution pane context menu to display the parameter names / pin names.

Image Removed

  • Static operations are like functions. They have no self context, and thus no target pin - only input, output, and return pins.

Image Removed

  • Non-static operations provide a self context. When added to the execution pane, they provide a target pin in addition to the parameters. Here, the user should provide the related element.

Image Removed

You have two options to determine the target of a non-static operation:

  • Check the library: The needed target is the class where the operation resides in.
  • Hover over the target pin: The type of the expected target will be displayed on the execution pane.

Adding Operations

Go to page Adding Variables for detailed information

.


Image Removed
  • Local: Draw a relation between the operation pin to the variable in section Local.

Select the operation you want to use from the service panel.

Drag & drop drop the operation to the operations flow in the execution pane.

Tip

When the operation has been added to the operations flow, the displayed pins indicate needed object flows.

Tip

Hover over a pin to see the name and the type of the expected object flow.

Pins on the left of the action node indicate needed incoming object flow.

Image Modified

Pins on the right indicate outgoing object flow.
Target pins indicate the target of the operation which is the element to which the operation is to be applied.

Image Modified

Now you need to connect the pins with the corresponding variables.

Tip

An output pin can be connected to more than one variable.

Depending on which data is required, you can use variables from the Persisted or Local section.

Info

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamelocal
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

  • Persisted: Open the list of available persisted variables by using the Image Removed icon in section Persisted and select the needed variable.
Tip

Go to page Persisting Data for detailed information about persisted variables.

Image Removed

You can use the search to narrow down the content of the list.

Image Removed

When the persisted variable is displayed on the execution pane, draw the necessary object flow to the operation call.

The color of the pins assists you during modeling, see Pin Highlighting for detailed information.

Got to Adding Variables for more information on variables and the difference between persisted and local variables.


Image Modified

Object flows on the execution pane are routed automatically.

You can use the execution pane context menu to change the algorithm of the relation path.

Image Modified

You can select an object flow to highlight it in blue - in larger models this helps to track the paths more easily.


Image Modified

You can also hover over an object flow to highlight it in black.

Pin Highlighting

While dragging the object flow, the color of the pins assists youchanges to assist you with finding matching connection points.

a relation For example, you cannot , , or is already connected.

When you start dragging an object flow, all pins of the same type and multiplicity are marked blue. Blue pins indicate that the relation will be validthis pin is a valid target for the object flow.

White pins connection points of variables indicate that you are trying to connect pins variables that do not have the same type or multiplicity. The pins are connection point is marked in white only when you have reached them it with the mouse pointer.

It will be is possible to draw a connection to a white pin, an object flow to an invalid connection point but the relation will be invalid and displayed in red.

Image Modified

A pin turns red if

an object flow cannot be created at all.

Image Removed

You cannot

  • connect a local variable with another local variable
  • connect a persisted variable with another persisted variable
  • draw a connection to a pin that

Special Case: Guard Expressions

  • already has an incoming object flow.

Static And Non-Static Operations

Operations can be static or non-static.

Image Added

Static operations are like functions. They have no self context, and thus no target pin - only input, output, and return pins.

Image Added

Non-static operations are related to a specific type. When added to the execution pane, they provide a target pin in addition to the parameters. Here, the user must provide an object of the related type.

Image Added

To determine the target of a non-static operation, you can:

  • Jump to the service panel: The needed target is the class where the operation resides in (see screenshot on the left).
  • Hover over the target pin: The type of the expected target is displayed on the execution pane

Image Removed

Guard expressions (conditions) of exclusive gateways are implemented to the outgoing relations of the gateway.

If you select the outgoing relation of an exclusive gateway on the diagram pane, section Return is displayed in the execution pane automatically.

This section contains the unchangeable object return of type Boolean.

Image Removed

Operations that should be able to be used on a guard need to have a Boolean return value. This value should transport the following meaning:

  • true if the process flow should be continued on this branch.
  • false if this branch should be omitted.
Set the return value of the guard expression by connecting the output pin of the operation call to the return object
  • .