The task prompts the user to make choice by showing an Alert dialog with title, message and a set of buttons. Buttons can be either an array, specially formatted text or manually defined values as "Buttons (Static)". If "Buttons (Static)" is specified - input will be ignored.

To define choices in a text the following simple format should be used: each choice should occupy one line and choice's name and value should be delimited by = sign. For example, "Yes | No | Cancel" choices can be defined as:

Yes = 1
No = 2
Cancel = 0

The best way to specify choices as text is to introduce an "Enter Text" task as a part of "Installation Workflow", which would store textual choices in an action, family or system variable.

The following are "Choice - Alert" task properties:

Message: message to show in alert.

Buttons (Static): list of static buttons - use a decimated editor to maintain it.

Button Name: optional macro expression that defines title for a button. Use a self variable to denote a single button and then specify property(s) to form a title. For example, $(self.address) defines title as location's address if task shows a list of locations. It is also possible to define sub-title similar way - use pipe | as a delimiter e.g. $(self.address)|$(self.latitude), $(self.longitude).

Add/Update SWITCH to Handle Selection: specifies whether a related SWITCH task should be automatically added or updated to handle selection. Note, this option is applicable to handle static Buttons only.

See also:
Common Task Attributes
Task Options
Variable Types