Editing processes

In the process editor you organize the steps in a process, specify their properties, and connect them to each other.

Procedure

  1. Open the process in the process editor.
    • To open a component process, click Components, click the component, click the Processes tab for the component, and click the process.
    • To open an application process, click Applications, click the Processes tab for the application, and click the process.
    • To open a generic process, click Processes and click the process.
    The process editor opens. The editor is similar for each type of process, but the list of available steps is different for each type of process.
    The process editor, showing the editing area and the list of available steps

    When the Process Design pane opens, the Design view is displayed. Processes are assembled with the Design view. Available steps are listed at the left of the window. IBM® UrbanCode™ Deploy provides several utility steps and plug-ins. More plug-ins and documentations for those plug-ins are available on IBM developerWorks®: UrbanCode Deploy Plug-ins.

    In addition to the process editor, the following two pages provide information about the process:
    • The Configuration page shows the properties and settings for the process.
    • The Changes page shows a record of every change to the process, addition or deletion of a property, and save or deletion of the process.
  2. To add a step:
    1. In the list of steps at the left of the window, click and hold down the mouse on the step that you want to use, and drag it onto the design space.
      Adding a step by dragging it from the list of steps to the design space
    2. Release the mouse over the design space. The Edit Properties window is displayed. Because connections are created after you configure the step properties, you can place the step anywhere on the design space. Steps can be dragged and positioned at any time.
      A typical Edit Propertieswindow, showing the properties for the step
      Configuration dialogs are tailored to the selected step. Only parameters that are associated with the step type are displayed.
    3. Specify the properties for the step. Each step has different properties. See Plug-ins for information about configuring specific steps.
    4. Optional: To add or change the post-processing script, select a script in the Post Processing Script list. For more information, see Post-processing scripts.
    5. After you configure the step properties, save the step by clicking Save.
    The step is in the design space and ready to be connected to other steps. If you change your mind, click Cancel to remove the step from the design space. You can add connections immediately after you place a step, or you can place several steps before you define connections.
  3. Connect the step to the process flow: Connections control the process flow. The originating step runs before the target step. Creating a connection between steps is a simple process: you drag a connection from the originating step to the target step. Connections are formed one at a time between two steps, the originating step and the target step.
    1. Hover the cursor over the step that you want to use as the origin of the connection. The connection tool is displayed.
      The connection tool
    2. Drag the connection tool over the target step. The step beneath the connection tool is highlighted.
      Dragging a connection to a step
    3. Release the connection tool over the target step to complete the connection.
    The connection between two steps and the conditional flag for the connection

    Each connection has a connection delete tool, conditional flag, and might have other tools depending on the originating step. Remove a connection by clicking the delete tool.

  4. Add more steps to the process, connect them, and arrange them in the process editor. You can click and drag steps to move them around the process. In this way, you can arrange the steps in a meaningful arrangement on the process editor canvas.
    Tip: To move more than one step at a time, hold the Ctrl or Command key and click two or more steps to select them. Then, you can drag the steps to a different place in the editor.
  5. Verify that the flow of steps is correct. Each process starts with the Start step and continues until it reaches the Finish step. Therefore, the Start step must connect to the first step or steps to run. Similarly, the last steps must connect to the Finish step, or else the process does not complete correctly.
  6. When you are finished with your work on the process, click Save . If comments are required, the Process Change Comment window opens. Type a comment and then click Save. The system settings control whether comments are required. To learn more about system settings, see Server system settings.

Feedback