Managing toolkit dependencies

You can create a toolkit dependency, change the version (snapshot) of a dependency, and delete a toolkit dependency in the designer.

Before you begin

To create a dependency on a toolkit, one or more versions of that toolkit must exist. The dependency is created on a version and library items only from that toolkit version are available for reuse.

About this task

When you create a dependency on a toolkit, you can use the library items from that toolkit for the implementation of your current project. For example, after you create a dependency on a toolkit that includes services, the services are automatically available when you choose the implementation of activities. After you create a toolkit dependency, you can change the version and delete it in the designer.

When you create a toolkit dependency and that toolkit is later updated, an icon indicates that a more recent version of the toolkit is available. You can choose to upgrade the dependency or to ignore the new version.

Note:

When you use an asset from a toolkit dependency, make sure that the name of the asset is not in use in another toolkit dependency. Duplicate naming can cause inconsistent behavior.

When you change the toolkit version, items in the application might be affected if the items refer to elements that are not in the new toolkit version. In such cases, you need to add these elements to the new toolkit version, or modify the items to fix the reference.

When you delete a toolkit dependency, you must be sure to update any items in the workflow automation that refer to the toolkit elements. For example, if a service from the toolkit is the implementation for an activity, the implementation is missing or broken as soon as you remove the toolkit dependency. Missing implementations are marked with alert icons in the properties for the affected activity.

Procedure

To create, update, or delete a dependency on a toolkit, complete the following steps:

  1. In the designer, open the workflow automation or toolkit whose dependencies you want to modify.
  2. Follow the required option:
    • To create a dependency, click the plus sign next to Toolkits, and select the version of the toolkit that you want.
    • To update or delete a dependency, click the arrow next to the toolkit dependency. Choose Change Version of Dependency or Remove Dependency from the pop-up menu, and select the version that you want.
    Note: Only toolkit versions that are compatible with your project's target environment are listed.

Results

Items for the specific toolkit version or snapshot that carries the dependency are now usable in the dependent toolkit and parent toolkits or process applications. When you expand Toolkits, you see the toolkit version or snapshot that you added. You can click to expand the toolkit to see the items within it.