Adding Stages

A stage describes a step in a taskflow usually performed by one individual. Each stage has an action. These actions can have parameters in which values are supplied at runtime.

You define a stage using these three tabs:

  • General: Defines the stage name, description and user ID of the user responsible for running the stage. The user can be an initiator, which is the owner of the first stage in the taskflow, or another user for the other stages.

  • Processing: Defines the action to be performed when the taskflow is run and any required parameters.

  • Starting Event: Defines the taskflow start time, and the scheduled times for the event to occur, based on the application server time, not the local user’s computer. This tab is displayed only for the first stage in the taskflow. It displays the scheduled event (taskflow start time), or is disabled (for the manual start of a taskflow executed by the Run Now option).

  To add stages:

  1. From the taskflow editor, click Add Stage.

    A new stage is displayed in the left panel, and stage details are displayed in the right panel. If stages exist in the taskflow, the new stage is created at the end of the taskflow.

  2. Select General and enter this information:

    1. For Name, enter a stage name; for example, Data_Synchronization.

      Note:

      Stage names cannot contain spaces. The name can contain up to 30 characters.

    2. Optional: For Description, enter a taskflow description; for example, Perform synchronization daily.

    3. From Run As, select UserName, and enter a username and password for the user who launches the taskflow.

      Note:

      Stage 1 requires that you enter a username and password. When you create future stages, you can select to run as the Initiator, which tells the system to use the user ID and password that was defined in Stage 1.

  3. Select Processing and enter this information:

    1. From Application, select an application from which to run the task.

    2. From Action, select an action to perform; for example, Data_Synchronization.

      Note:

      See Shared Services Stage Actions and Parameters.

    3. From Type for each parameter, select Picklist, Text Box, or URL for the Point of View, depending on the action, and enter values for the parameter.

      For the data file and log file names and paths, you must manually enter the information in a text box. The taskflow is executed from the server, so you must make sure that the file names and paths are valid and can be accessed from the server running the task. Therefore, you should not enter a path such as c:\file.dat that references your own hard drive. You must identify the computer name and share directory for the file using Universal Naming Convention (UNC); for example, \\HFMServer\share\path\file.dat.

  4. Select Starting Event and enter this information:

    1. From Starting Event, select an event.

      The Server Date information is displayed for informational purposes.

    2. For Start Date, enter the date for the task to be run, or click the pop-up calendar and select a date.

    3. From Start Time, select a time for the task to be run.

      Note:

      This time is based on the application server, which is identified on the Server Date line.

    4. For a recurring task, select Recurrence, and from Recurrence Pattern, select the task frequency.

    5. Select an option for the task end date and time:

      • No End Date

      • End After occurrences, and enter the number of occurrences

      • End Date, enter an end date and select an End Time.

  5. Optional: To add a stage, click Add Stage and complete the stage information for General and Processing

    Note:

    The Starting Event tab is available only for the first stage. However you can schedule taskflows independent of creating stages by using the Schedule Taskflow functionality. See Scheduling Taskflows.