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

Image RemovedImage Added

To add any execution 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.

Image Modified

The execution pane displays the related execution model. If there is no execution model will be displayed in the execution pane. For some BPMN elementsin place, you need to create it manually a new execution model (see Working with the Execution Editor > Adding an Execution Model for details).

As no execution has been implemented yet, the panel shows an empty operations flow.

Image Removed

As in our example the selected BPMN element is a Message Start Event, the execution pane also shows section Message with an incoming variable message of type Any.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameinfo_message_section
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

If you have selected the outgoing relation of an Exclusive Gateway, section Return is displayed, containing the unchangeable variable return of type Boolean.

Select Type

Select Type

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

Image Added

Go to the Service panel. Types are available from

Image Removed

Now go to the Service panel and expand the library or the data model you want to use.

  • 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

further details about
    • more details on the library concept and the Service panel.
On page is explained
    • explains how to upload a library to the Designer
.Go to page Modeling Data Mapping for further informations on the Data Model folder
    • .
Anchor
base_types
base_types

Image Modified

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamebridge_base
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Drag Type to Execution Pane

Image Added

To add a variable

Image Removed

Adding variables

to the execution

pane is simple:
  • Select the necessary data type from your library.
  • Drag it from the library panel and drop it on the execution pane.

There are different targets to drop an element to:

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

You can cancel this procedure

Image Removed

You can cancel the operation

Image Removed

You can add a new variable by dropping it in section Persisted or Local.

Info

You can drag the following library contents to the pane:

  • Interface
  • Class
  • Parameter

Image Removed

This applies to variables from your own data model, from customized libraries as well as to the Bridge base types.

Image Removed

by pressing Esc or dropping the element outside the execution pane.

  Anchornew_variablenew_variable

Adding a New Variable

Image Added


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.

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamelocal
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Anchorchange_typechange_type

Adding Multiplicity

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.

Image Added

Image Removed

Once you have dragged a variable to the execution pane, you can add multiplicity.

Open the attributes panel for the variable in question.

Here you will find the attribute Array. To add multiplicity, activate the checkbox.

To change the multiplicity to 0..*, activate checkbox Array.

Image Added

Anchor
change_type
change_type

The element type on the pane now

Image Removed

If the checkbox is activated, the variable has the multiplicity 0..* and the element on the pane is extended by a pair of square brackets :Image Removedto indicate the new multiplicity.

Changing the Type

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

Use simple type Any from library Bridge Base

to change the

message type back to its default.

Using Drag & Drop

You can change the type of any variable if you drag a variable by dragging a type from your library and drop dropping it on the variable itself.

Example:
As per default, the 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 MyClassthe form class IdeaCheck.

After you have having dropped the type on the variable, it has changed its typethe new type is displayed.

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

Image Added

Using the Type Selection Dialog

You can use the Type Selection dialog

Image Removed

Tip
titleExpert Tipp

Image Removed

Variable message cannot be of simple type. If you try to drop a simple type other than default type Any on the message element, a red frame indicates that this is prohibited.
Changing the Section

type of a variable.

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

Image Added

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.

Image Added

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

Changing the Scope

It is also possible to change the section 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 , 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 The persisted variable is removed and 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.

Image RemovedImage Added

Message to Persisted or Local:

  • A new variable is created in the corresponding area. Its The name is of the same as if a new variable of is derived from the same type as the message was created. A relation is drawn .
  • An object flow is added from message to the new variable.

Special Case: Adding Persisted Variables

Tip

For detailed information see page Persisting Data.

If you add variables to section By creating variables as Persisted, they are usable in all executions of throughout the BPMN model.

Image Modified

To use a persisted variable, click the Image Added icon Image Removed 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