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

The Library Concept

Multiexcerpt include
SpaceWithExcerptINTERNAL
MultiExcerptNamelibrary_concepts
PageWithExcerptINTERNAL:_designer_excerpts
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 versupports versioning.

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 In the Designer, you can create your own libraries, see page Creating a Library for details. If you want to use the libraries in a Designer service, you have to upload them 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. Since PAS 23.1.1 it is also possible to share a library with all users on your PAS installation. Refer to Sharing Designer Content for details.
How to upload your libraries to the Designer is explained in detail on page Administrating Libraries.

In the BPMN Model: Use the Manage Libraries button

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

  • In the Explorer: Open the Libraries folder in your service and use the Manage Libraries button.
  • , open the service, click the Image Added button and use the Asset Drawer to add them or go to the Libraries folder in the Service panel and use its context menu.

    Tip

    Go to page Adding and Updating Libraries for detailed information on how to add a library to a service. Page Using Libraries contains Refer to chapter Modeling Execution for 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.

    a library element to see if This is indicated by the Image Removed icon. .

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

    Image Removed

    Image Removed

    Image Modified

    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
    MultiExcerptNametip_panel_management
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

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

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNametip_library_administration
    DisableCachingtrue
    PageWithExcerptINTERNAL:_designer_excerpts

    Tip

    Open menu Libraries in the Designer administration to upload your own libraries.

    A library can contain the following elements:

    IconName
    Image Modified
    Package
    Image Modified
    Class
    Image Modified
    Property
    Image Modified
    Interface
    Image Modified
    Operation
    Image Modified
    Parameter

    To expand an element in the tree, click on .
    UseImage Modifiedif you want to collapse a tree below an element.


    Image Modified

    Each library element can have a documentation. Hover your mouse on
    an element in the libraries folder to see if documentation is available.
    The documentation is displayed as a tooltip
    .

    Image Added

    You can also copy & paste content from a library to the data model of your service: packages, classes, properties, operations and parameters - including their subelements.
    The implementation of a copied operation, however, will be empty.

    In addition to imported libraries with predefined data types, you can use the provided Base Types, or you can create your own data model.

    Data Model page Mapping

    Image Added

    Multiexcerpt include
    SpaceWithExcerptINTERNAL
    MultiExcerptNamebridge_base
    PageWithExcerptINTERNAL:_designer_excerpts

    Image Modified

    You can also define your own data types in folder

    Implementation. You can add your own packages, classes, interfaces, operations, properties and parameters.

    Tip

    Go to

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

    Go to chapter Developing and Using Libraries to find out how to create your own libraries in the Designer.