IBM Streams 4.2

Editing toolkit information and dependencies

You can view and edit toolkit properties and dependencies in the info.xml file in Streams Studio.

About this task

This task explains how to do the following tasks in Streams Studio:
  • View and edit toolkit properties and dependencies. The Edit Toolkit Information dialog box is used to view and modify the properties of an SPL toolkit. The properties include the identity of the toolkit (name and version) and a list of the other toolkits that are used by this toolkit. This dialog box is typically used to update the version of the toolkit when you make a substantial change or to add or remove toolkit dependencies.
  • Create a toolkit dependency. For example, if your project invokes a Filter operator that is not defined in the Standard Toolkit that is included with the product, you add a toolkit dependency.

Procedure

To view and edit toolkit properties and dependencies:

  1. In the Project Explorer view, right-click a project.
  2. From the menu, select Edit Toolkit Information. The Edit Toolkit Information dialog box is displayed.
  3. In the Overview tab, you can modify the following toolkit properties:
    Option Description
    Toolkit name and Toolkit version The name and the version of the toolkit that is used to identify the toolkit that is being edited.
    Required Streams version The minimum version of IBM® Streams required for this toolkit, or a range of minimum and maximum versions of IBM Streams required for this toolkit.
    Description The description of the operators and functions that are provided by this toolkit.
  4. To display the toolkit dependencies, click the Dependencies tab. In this tab you can add, remove, or modify dependencies on other toolkits.
  5. To add a dependency:
    1. Click Add. The Add Dependency dialog box is displayed.
    2. To specify the toolkit name and version, complete any one of the following tasks:
      • Enter the toolkit name and the minimum version in the Toolkit name and Minimum version fields and click OK.
      • Click the Browse button to select the name and version of a toolkit already available within the Streams Studio and click OK. The selection dialog box displays a list of toolkits from the open SPL projects in your Eclipse workspace and the toolkits available in the Streams Explorer. Select one of the toolkits in the list and click OK.
        Note: If the toolkit you need is not listed in the selection list, you can add additional toolkits to the Streams Studio environment. For information about adding toolkits, see Adding toolkit locations.
    3. Optional: Optionally, you can set the Maximum version along with Inclusive/Exclusive flags to include a range of minimum and maximum versions.
  6. To remove dependencies, select an existing dependency in the list and click Remove.
  7. To modify existing dependencies, select an existing dependency in the list and click Edit. The Edit Dependency dialog box is displayed and works the same way as the Add Dependency dialog.
    Tip: A shortcut for editing the dependencies is to right-click the Dependencies node under a SPL project in the Project Explorer view, and then select Edit Dependencies from the menu. The Edit Toolkit Information dialog box is displayed with the Dependencies tab shown on top. You can edit the dependencies, or other toolkit properties.
  8. To display or add files in an application bundle file, click the Bundle Files tab. In this tab you can add, remove, or modify include and exclude patterns that determine which files are added to the application bundle file.