Entering content frameProcedure documentation Unit 12: Integrating the UNTIL Loop for Reapproval Locate the document in its SAP Library structure

Use

If the requester decides to revise and resubmit the notification of absence to their superior, the step Check notification of absence must be executed again.

There are different ways of solving this problem. The solution outlined here is only one example.

To assign values to the container element, container operations must be executed on the workflow container.

For information on the workflow log, see Definition of the Workflow Container in the SAP Business Workflow documentation.

For more information, see Maintenance of UNTIL Loops in the SAP Business Workflow documentation.

Procedure

Start the Workflow Builder and open your workflow definition in change mode. Proceed as described in Unit 7: Including "Check Notification of Absence" in the Workflow Definition.

Create container element in the workflow container

  1. Choose the entry Double-click to create by double-clicking in the Workflow Container tray.

    2. The dialog box for entering a container element is displayed.

  2. Make the following entries:

    3. Element: Flag

    Name: Flag

    Short Description: Flag for approval status

  3. Choose This graphic is explained in the accompanying text.

    4. The Select predefined data type dialog box is displayed.

  4. Choose Flag by double-clicking.

    5. You return to the creation of a container element. The system has made the required entries for a container element that is to contain a flag.

  5. Choose This graphic is explained in the accompanying text.

You have now added a local container element to the workflow container, which is ready to store a flag, based on its data type reference. However, you have not yet determined a value for this container element.

Integrating the UNTIL loop as a step

  1. Choose This graphic is explained in the accompanying text in the step type area. The cursor changes shape.
  2. Position the cursor on the Check notification of absence step and click.

    3. A dialog window is displayed in which you can choose if an empty loop is to be inserted or if the selected block is to be copied to the loop immediately. To assist you, all steps that belong to the selected block are selected.

    Note

    The workflow definition is block-oriented. Every block represents a basic structural element that is a self-contained and consistent arrangement of steps and outcomes.

    If you, for example, create a new step that has one outcome, this pair (step, outcome) represents a block. Operations that are performed on one step (delete, cut, and so on) always affect the entire block associated with that step.

    To display the block structure of your workflow definition in the Workflow Builder, choose Extras ® Options. Here, choose the Technical Groups as the block display on the View tab page.

    For more information, see Block Orientation in the Workflow Definition.

  3. Choose In Loop.

    4. This inserts an UNTIL loop into your workflow definition. The step definition of the UNTIL loop is displayed in the right part of the screen.

    Entering the basic data

  4. Enter Resubmission required? in the Step description field.
  5. Click on the condition area to open the condition editor.

    6. The bottom half of the screen contains the empty condition, whereas the top half shows the operators, the system fields, and the content of the workflow container. The field in the Expression 1 column is ready for input and marked This graphic is explained in the accompanying text. For more information, see Condition Editor.

  6. Choose the Flag container element as the first expression by double-clicking it.

    7. The first expression is now entered in the condition in the lower part of the screen. The Expression 2 field is now ready for input and marked This graphic is explained in the accompanying text.

  7. Choose This graphic is explained in the accompanying text as the operator.
  8. Enter the constant X in the field for Expression 2 and confirm by pressing Enter.
  9. Choose This graphic is explained in the accompanying text.

    10. You have now defined the condition Flag = X. The comparison between the container element Flag and the constant X returns either the result true or the result false. Two outcomes are therefore possible.

  10. Enter the following texts for the outcomes:

    11. True: Flag equal to X - no resubmission

    False: Flag not equal to X - resubmission

    If the result of the evaluated condition is false, the loop is processed again. If the notification of absence is to be resubmitted to the superior, the container element flag must not have the value X. For this purpose, you will insert container operations in the workflow definition in the next unit.

  11. Choose This graphic is explained in the accompanying text.

You have inserted an UNTIL loop in the workflow definition that contains all steps that are in the block opened by Check notification of absence.

Concluding the step definition

  1. Choose This graphic is explained in the accompanying text to align the graphic.
  2. Choose This graphic is explained in the accompanying text to view the entire workflow definition in the workflow area on the screen.
  3. Choose This graphic is explained in the accompanying text.

The workflow definition is checked, saved, and, provided it does not contain any errors, activated. The system displays a message if problems are encountered during the test.

Result

The integration of the UNTIL loop is now complete. The workflow up to this point, however, delivers an incorrect result, since the Flag container element is not assigned a value during execution. The result of the evaluated condition in the UNTIL loop is always false and the workflow can never be completed. To ensure that the workflow is executed correctly, you will add further container operations to the workflow definition in the next unit.

Leaving content frame