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.1_a

The Library Concept

Libraries help you to make your BPMN process executable. They contain predefined classes, interfaces, operations and parameters you can use during modeling by simple drag & drop.
Libraries are developed with the Builder. The Designer comes with a standard library which already provides all necessary Base Types.

Using libraries has several advantages for developers:

  • You can provide additional data types and operations via libraries.
  • You can reuse implementations you have already developed with the Builder.
  • You can use libraries for modularization:
    • Implementations can be recycled in various processes via libraries.
    • Multiple developers can contribute to the same process implementation by working on different libraries.
  • You can add features to the Designer, for example access to backend systems, via libraries.
  • You can use different versions of the same library as the library administration allows ver

Library Usage in Designer

As libraries are developed with the Builder, you need to upload them to the Designer to make them accessible in your services.

In the Designer, you upload your libraries to a namespace. This is done in the Libraries section of the Designer administration. The uploaded libraries are then available in all services created in this namespace. How to upload your libraries to the Designer is explained in detail on page Administrating Libraries.

Once a library has been uploaded, you can add it to any service created in this namespace. There are two ways to do so:

  • In the Explorer: Open the Libraries folder in your service and use the Manage Libraries button.
  • In the BPMN Model: Use the Manage Libraries button in the Service panel.
Tip

Go to page Adding and Updating Libraries for detailed information on how to add a library to a service. Page Using Libraries contains further information about the usage of libraries during modeling.

The Service Panel

The libraries you have added to a service reside in the Service panel.

Image Added

If you use the panel preset of the BPMN editor, the Service panel is displayed in the upper left corner of the editor.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptName

panels

tip_

general_description

panel_management
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image RemovedImage Added

The Library Service panel gives you direct access to your all libraries of your project, and thus to all of your predefined classes, interfaces, operations and parameters.

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNametip_library_administration
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Modified

Each library element can have a documentation. Hover your mouse on a library element to see if documentation is available. This is indicated by the Image Modified icon. The documentation is displayed as a tooltip.

For easier reading of longer documentation, you can click the icon to see the complete documentation in a pop-up window.:

Image Added

Image Modified

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamebridge_base
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

If you use the panel preset, the library panel is displayed in the upper left corner.

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamehide_panels
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameshow_panels
PageWithExcerptINTERNAL:_designer_excerpts

The icon Image Removed represents the library panel.

Application Options

The panel shows all libraries available in this project. You can use the panel to manage your libraries and to use the contents of the libraries during modeling on the execution pane.

Managing Libraries

Image Removed

If you want to add your own libraries, click the Manage libraries button.

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamemanage_libraries
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameadd_library
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameused_libraries
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

The added library is now displayed in the library panel and you can use it during modeling.

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameremove_libraries
DisableCachingtrue
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNameshow_library_doc
PageWithExcerptINTERNAL:_designer_excerpts

Image Removed

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamelibrary_documentation
PageWithExcerptINTERNAL:_designer_excerpts

Image Added

You can also define your own data types in folder Data Model . You can add your own packages, classes, interfaces, operations, properties and parameters.

Tip

Go to page Modeling Data Mapping for more detailed information on how to work on your own data model and how to define mappings between data types

Using Library Content

Image Removed

In your own libraries you can define the classes, operations and parameters you want to use during modeling.

A library can contain the following elements:

  • Image Removed= Package
  • Image Removed= Class
  • Image Removed= Interface
  • Image Removed= Operation
  • Image Removed= Parameter

To expand an element in the tree, click on Image Removed. If you want to show less content in the tree, use the icon Image Removedto close the corresponding element.

Image Removed

You can drag & drop elements from the library panel to the execution pane.

Operations are dropped to the operations flow in the middle of the execution pane.

Image Removed

Input and output parameters of the operation are displayed in the library panel and as pins on the execution pane.

Image Removed

You can drag & drop classes, interfaces and parameters to the fields Persisted and Local:

  • Persisted: The information is persisted and is therefore available in your whole BPMN model.
  • Local: The information is only existing in the current operations flow.

Image Removed

If you start dragging a relation on the execution pane, the eligible pins of the operation call(s) are highlighted. TipFor more detailed information see page The Execution Pane

.