Editing project settings

Each project that is created in the Workflow Center repository includes settings that you can change while you are working in IBM® Process Designer, such as global settings, environment variables, and server configurations.

Before you begin

Ensure you have administrative access to the project or are the user who created the project.

Procedure

  1. Open the project in Process Designer.
    The settings editor opens and remains available from the list in the toolbar. It can't be closed.
  2. To edit the general settings, click the Overview tab:
    Setting Description
    Target Environment
    The target environment option determines the runtime environment where your project will be installed and run. Select one of the following target environment options:
    • Traditional: Projects are designated to be installed and run on Workflow Server in the traditional WebSphere runtime environment. The project features are automatically validated to ensure that they are supported in this environment.
    • Traditional or Container: Projects are designated to be installed and run on either Workflow Server in the traditional runtime environment or Workflow Server in the container runtime environment. The project features are automatically validated to ensure that they are supported in both environments.
    Acronym (desktop only)
    Tip: If you are using the web Process Designer, to change the acronym you must open the project in Workflow Center and go to the Manage page.
    The acronym for a project must be unique and is limited to seven characters. IBM Business Automation Workflow uses the acronym to identify this project 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 project that rely on the current acronym are broken unless you update them with the new acronym. For this reason, Process Designer displays a warning, requesting confirmation to continue with the change.
    Important: Do not change the acronyms of system projects such as Saved Search Admin and IBM Process Portal.
    Exposed Items A shortcut list of exposed items to allow for quick navigation to important artifacts in your project. Web services in a project are always exposed. You must explicitly expose BPDs, case types, and human services. For more information, see Exposing processes or Exposing heritage human services.
    Theme

    Set the theme used to style the views in the coaches contained in the project. For information, see Themes.

    Coach XSL (desktop only)

    Coach XSL is where you identify the transform XSL file for heritage coaches.

    Coach CSS (desktop only)

    Coach CSS is where you identify the CSS file for heritage coaches.

    XML Settings
    The Namespace field in the XML Settings pane identifies the namespace of the project. If you don't enter a specific namespace identifer, the editor automatically populates the Namespace field with a shortened version of the project name.
    Tip: To avoid potential namespace collisions, keep the provided value or to replace it with a custom value that is unique among all projects in all the dependent toolkits and process apps.

    Changing the Namespace field impacts projects and external web services that interact with this project. For example, external web services use this serialized representation to interact with toolkit. Changing a namespace means projects, such as process apps and case solutions, that refer to a toolkit with the changed namespace must also be updated. If you change the namespace, ensure that all projects and web services that refer to the project with the changed namespace are updated accordingly.

    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.
    Process application administrators (referred to as Portal Admin Team in the desktop Process Designer)
    By default, members of the tw_admins security group can complete the following administrative actions on instances in the process app.
    • Abort Process Instance
    • Suspend Process Instance
    • Resume Process Instance
    • Change instance Due date
    • Move token
    • Delete Token
    Click Select to add or remove users and teams as process app administrators. Or, click New to create a new team that represents the groups of users in your enterprise that can administer process apps. You can add users or teams as members, or define an expression to determine membership.
    Important: Do not choose System teams as process app administrators. System teams are used in System lanes, for System tasks or services that run automatically without a need for user interaction.
  3. To set environment variables (such as port numbers) for each deployment environment, click the Environment tab.
    For more information, see Setting environment variables.
  4. To add server configurations, click the Server tab.
    For more information, see Adding a server configuration.
  5. Click Save in the main toolbar.