Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WDESIGNER and version 24.0

Adding Variables to the Execution Pane

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameexecution_preliminaries
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Select BPMN Element

To add executional parts to a BPMN element, you must first select the BPMN element on the diagram pane to which you want to add the execution.

The execution pane displays the related execution model. If there is no execution model in place, you need to create a new execution model (see Working with the Execution Editor > Adding an Execution Model for details).

Select Type

Next, you need to select the type of the new variable.

Go to the Service panel. Types are available from

  • the standard Bridge Base Types library (see below)
  • class, interface and parameter definitions from the Implementation folder

    Tip

    Go to page Modeling Data Structures for more information on how to define your own classes, operations and interfaces with the Designer.

  • imported libraries

    Tip
Anchor
base_types
base_types

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamebridge_base
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Drag Type to Execution Pane

To add a variable to the execution, simply drag the selected type to the execution pane and drop it to a target area.

You can cancel this procedure by pressing Esc or dropping the element outside the execution pane.


You can drop the type to different targets:

  • to the Local section to create a local variable.
  • to the Persisted section, to create a persisted variable.

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamepersisted
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Tip

    See page Persisting Data for further information.

By dropping a type on an existing variable, you can change the type of the variable (see Changing the Type further below).

Changing a Variable

Changing the Multiplicity

As per default, variables are created with multiplicity 0..1 but you can change this in the attributes of the variable.

Open the attributes panel for the variable in question. To change the multiplicity to 0..*, activate checkbox Array.

Anchor
change_type
change_type

The element type on the pane now is extended by a pair of square brackets to indicate the new multiplicity.

Changing the Type

You can change the type of any variable and there are different ways to do so.

Using Drag & Drop

You can change the type of a variable by dragging a type from your library and dropping it on the variable itself.

Example:
As per default, an incoming message has type Any. To gain access to the data you want to use, you need to apply the correct type from your data model or library - which in our example is the form class IdeaCheck.

After having dropped the type on the variable, the new type is displayed.

Example:
The type of the selected class IdeaCheck is applied to the incoming message.

Using the Type Selection Dialog

You can use the Type Selection dialog to change the type of a variable.

Click on the variable you want to adapt and open the attributes panel. Use icon of option Type to open the dialog.

Use the search box on top to find the type you are looking for. Click on the type you want to apply. Then click Save.

The dialog closes and the selected type is applied to the variable.

Changing the Scope

It is also possible to change the scope for a variable. You can drag & drop variables:

  • From Local to Persisted
  • From Persisted to Local
  • From Message to Persisted or Local

Local to Persisted:

  • The local variable is removed.
  • A new persisted variable with the same name is created. If the name is already in use, a suffix is added.
  • Existing relations are reattached to the new variable.

Persisted to Local:

  • A new local variable with the same name is created. If the name is already in use, a suffix is added.
  • The persisted variable is removed if it is not still used in other places in the process.
  • Existing relations are reattached to the new variable.

Message to Persisted or Local:

  • A new variable is created in the corresponding area. The name of the new variable is derived from the type.
  • An object flow is added from message to the new variable.

Special Case: Adding Persisted Variables

Tip

For detailed information see page Persisting Data.

By creating variables as Persisted, they are usable in all executions throughout the BPMN model.

To use a persisted variable, click the icon to open the list of available persisted variables and select the variable you want to use.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamepersisted_variable_added
PageWithExcerptINTERNAL:_designer_excerpts

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamesecond_persisted_variable
PageWithExcerptINTERNAL:_designer_excerpts