Show TOC Start of Content Area

Procedure documentation Creating Decision Dialogs  Locate the document in its SAP Library structure

Use

Decision dialogs are a specific type of callable object that enable loops and alternatives in the process flow. They implement different result states that enable you to set a different action for each available option, complete the process, or execute a particular action, for example.

You need decision dialogs to create blocks of the following types:

      Pre-conditional loop

      Post-conditional loop

      Alternatives

For more information, see Defining Block Flow.

Procedure

...

       1.      Open the gallery, and choose Create Callable Object from the contextual panel.

       2.      From the Type list, select Process Control Decision Dialog and enter the required basic data as follows:

Parameter

Description

Name

Enter an arbitrary name. You are not required to use a unique name for the callable object.

Description

Enter a brief description explaining what the object does, for example.

Original Language

Select the original language, in which the object is created. It is relevant for translation purposes.

Folder

Click Choose… to specify the folder where you want to store the callable object.

 

       3.      Choose Next to open the Define Object screen.

Select which type of decision dialog you want to create. The following table describes the available options, as well as the relevant parameters that you configure on the Set Configuration screen.

Option

Used In
(Block Type)

Configuration

Decision for loops

Pre-conditional loop

Post-conditional loop

The system creates a decision dialog with two result states (Continue and Break). When you use the object in a loop block, the result states are not displayed in the block flow.

Choose Next to open the Set Configuration screen, and configure the following parameters:

·        Heading – enter a heading for the Web Dynpro page that is displayed when the decision dialog is called in the process.

·        Message – enter instructions to the user. For example, instruct the user to choose a button either to complete, or to repeat the block.

·        Continue Button Label – enter a label for the button that enables the block loop

·        Break Button Label – enter a label for the button that cancels the loop

Complex decision with result states

Alternatives

You can configure a decision dialog with multiple options classified into option groups.

Choose Next to open the Set Configuration screen, and configure the following parameters:

      Decision Options

       You can define as many decision option groups as required using Add Group. The first group is automatically created for you.

       To maintain group parameters (name and description), choose Edit next to the group’s title.

       To add an option to a group, choose Add Option next to the group’s title.

       To define the order of the groups, use Up or Down.

       You can order the groups into columns. To create an additional column, use Add Column.

      Result States and Button Labels

You can:

       Create a result state for each option – when you use this decision dialog in a block, you can configure a different action to be executed for each option that the user selects

       Create one result state for all options – in a block, you can assign only one action to be executed regardless of the selected option

       Create an additional result state for the cancellation option – in a block, you can use this result state to cancel the execution of the selected option.

You can define custom labels for the choose and cancel buttons, or leave the defaults.

Note

When configuring targets for result states that are in different blocks, you have to make sure they are in accordance with the relevant block types you are using.

For more information, see Defining Block Flow.

       4.      Choose Next, and then Finish and Open.

The design time for the callable object opens. You can edit the object definition, and grant permissions to other users to view or edit the object.

       5.      To activate the object, choose This graphic is explained in the accompanying text (Activate).

 

End of Content Area