Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
In the BPMN editor, the The Service panel shows all libraries available in the service. Use the panel to manage your libraries and to use its contents during modeling on the execution pane.
How to Add a Library
You have two options to add a library to a service:
Adding a Library via the Asset Drawer
| Open the Asset Drawer by clicking button |
| If you want to add your own libraries, click the Manage Libraries button in the panel. |
| The dialog Manage Libraries opens. Currently unused libraries are displayed on the left side of the window, the libraries that are already available in this project are shown on the right side. Expand the drop-down list to display the details of the library such as versions and dependencies. | ||
| To add an unused library to the project, click on the | ||
Asset Drawer lists all available assets. It displays assets...
Browse the list to find the asset you want to use in your service. To add a library to your service click the corresponding |
| The library is now displayed in the column Used Libraries. If you have finished, do not forget to Save. | |
| The added library is now displayed in the service panel and you can use it during modeling. |
Adding a Library via the Manage Libraries Dialog
| Use the documentation icon |
| If documentation is available, it will be displayed in a separate pop-up.
| |||||||||||
|
| |||||||||||||
|
| |||||||||||||
|
| |||||||||||||
|
| |||||||||||||
|
| |||||||||||||
|
| |||||||||||||
|
|
Adding Libraries With Dependencies
| Libraries may have dependencies between each other. The Designer supports you to add all necessary libraries: When you add a library that contains dependencies... |
| ... the Designer also adds all dependent libraries. |
| If you add a library, that contains dependencies but not all dependent libraries are available in the current namespace... |
| ... the missing library is added, but highlighted in red. In that case, go to the library administration and upload the missing library to the namespace to make it available in your service. |
Handling Library Conflicts
Using an Updated Library
In the Designer administration, you can update a library version, see Administrating Libraries > Updating a Library for further information.
Info |
---|
Please note, that updated libraries are not automatically updated in the services. If you update the version of a library in the Designer administration, you need to save the library in the service again. |
Proceed as follows:
Image Removed
Follow the steps to update the library in the Designer administration.
Image Removed
Go to the service where you use the library. Use the button Manage Libraries in the service panel to open the Manage Libraries dialog. Since you used this library in your service already, it is displayed in section Used Libraries.
To ensure that the updated version is loaded into the service, just click the Save button.
Image Removed
Multiexcerpt include | ||||||||
---|---|---|---|---|---|---|---|---|
|
Switching Between Library Versions
The Designer allows you to upload several versions of a library. The developer can switch between versions which allows him to decide with which library version he wants to work.
Image Removed
Once a library has been added to a service, all available versions are shown.
The version in use receives the addition Current Version.
Image Removed
If you want to switch to another version, use icon Image Removed to load the desired version.
Image Removed
How to Delete a Library
Image Removed
You can also remove libraries from the list of used libraries.
Open the dialog Manage Libraries again and click the Image Removed icon.
The library will switch back to the Unused Libraries column.
Especially if you develop your own libraries (see Developing and Using Libraries for details) and create different versions, it is possible that library dependencies conflict with each other when you add them to a service.
Example:
Jane developed her own library, Janes_Lib in a first version 1.0.0 . She provides David her library.
He uses Janes_Lib 1.0.0 during the creation of his own library Davids_Lib 1.0.0 .
Now, Jane extends her library and creates Janes_Lib 2.0.0 .
Jane gives the new version of her library to John, who uses Janes_Lib 2.0.0 in his own library Johns_Lib 1.0.0 .
Image Added
| All three developers upload their own libraries to a shared namespace, because they want to develop a service together. |
| David starts modeling the service. He wants to use his library, so he adds Davids_Lib 1.0.0 to the service. Since he used Janes_Lib 1.0.0 in his own library, Janes_Lib is also added to the service - in the necessary version 1.0.0 . |
| John wants to collaborate with David, he also wants to use his library Johns_Lib 1.0.0 . However, the button to add the library is disabled, and John gets a conflict message. Since John used Janes_Lib 2.0.0 in his own library, there is a version conflict between Janes_Lib 1.0.0 in Davids library and Janes_Lib 2.0.0 in Johns library. |
John and David have now two possibilities to solve the version conflict:
- David can upgrade the library version of Janes library to use Janes_Lib 2.0.0 in his library.
This is probably the most common case. - John could downgrade the library version of Janes library to use Janes_Lib 1.0.0 in his library.
Once David and John are using the same version of Janes_Lib , both can use their libraries in the service.
Panel | ||
---|---|---|
| ||
|
Panel | ||
---|---|---|
| ||
Otp | ||||
---|---|---|---|---|
|
Rp |
---|