Creating Decision Dialogs

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 .

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.

1. 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. ResultStatesand 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 .

2. 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.

3. To activate the object, choose (Activate).