Editing toolkit settings

Each process application and toolkit created in the Process Center repository includes settings that you can change while working in the Designer, such as global settings, environment variables and server configurations for your process application.

Before you begin

To edit toolkit settings, you must have administrative access to the toolkit or you must be the user who created the toolkit.

Procedure

To edit toolkit settings:

  1. Open the toolkit in Process Designer. The Toolkit Settings editor opens. The settings editor is always available from the drop down list in the toolbar, and cannot be closed.
  2. To edit the general settings, click the Overview tab:
    Setting Description
    Acronym
    Tip: To change the acronym name if you are using the Process Designer web editor, you must instead open the toolkit in Process Center and use the Manage page to change the acronym.

    The acronym for a toolkit must be unique and is limited to seven characters. IBM® Business Process Manager uses the acronym to identify this toolkit and the library items that it contains and so it must be a valid JavaScript identifier. When you change the acronym, any existing scripts or other implementations in the toolkit that rely on the current acronym will be broken unless you update them with the new acronym. For this reason, Process Designer displays a warning, requesting confirmation to continue with the change.

    Exposed Items A shortcut list of exposed items to allow for quick navigation to important artifacts in your toolkit. Web services in a toolkit are always exposed. You must explicitly expose BPDs and Human services by choosing the exposure settings from the Overview page of the item. For more information, see Exposing processes or Exposing heritage human services
    Theme

    Set the theme used to style the coach views and controls in the coaches contained in the toolkit. For information, see Themes.

    Coach XSL (desktop only)

    Coach XSL is where you identify the transform XSL file for heritage coaches. For information, see Specifying an XSL transform override for a heritage coach.

    Coach CSS (desktop only)

    Coach CSS is where you identify the CSS file for heritage coaches. For information, see Specifying a custom CSS for a heritage coach.

    XML Settings The Namespace field in the Advanced XML Settings pane identifies the namespace of the toolkit. If you do not enter a specific namespace identifer, the editor automatically populates the Namespace field with a shortened version of the toolkit name.

    The Namespace field should only be changed by an advanced user as the namespace is used by other process applications to reference this toolkit. In addition, external web services use its serialized representation to interact with this toolkit. A change to the namespace means these applications referencing this toolkit also need to be updated.

    The Optimize settings for IBM Integration Designer check box indicates that this project is being used or is intended to be eventually used in collaboration with IBM Integration Designer.

    Optimize settings for IBM Integration Designer (desktop only) Select this option if this project is being used or is intended to be eventually used in collaboration with IBM Integration Designer.
  3. To set environment variables (such as port numbers) for each deployment environment, click the Environment tab and see Setting environment variables for instructions.
  4. To add server configurations, click the Server tab and see Adding a server configuration for instructions.
  5. Click Save in the main toolbar.