Input Dialog

Created by akaBot Support, Modified on Tue, 21 Jan at 3:44 PM by akaBot Support

This is about the "Input Dialog" activity, which displays a dialog box.

TABLE OF CONTENTS

Activity program name
Description
Property
How to use

1. Activity program name

RCA.Activities.Core.InputDialog

2. Description

Studio Version ~2.0.2.0
Quick Access: "Toolbox" > "Core" > "Input Dialog"

Studio Version 2.0.3.0~
Quick Access: "Toolbox" > "Core" > "Dialog" > "Input Dialog"

This activity displays a dialog box that allows users to enter text or select a value from given options.

Note: The operation has been verified on akaBot Studio versions 2.0.1.7 and 2.0.1.8. The wording may vary depending on the version.

3. Property

Property item	Property name	Input field	Description
Misc	Public	Checkbox	The variables and arguments within the activity are written to the log file and pushed to Center. (For details, refer to "Public" Property section.)
Misc	Display name	Enter value (String type)	Reflected in the activity name in the Designer panel.
Output	Result	Enter value (OutArgument type)	The value entered or selected by the user from the dialog is output.
Input	Option	Enter value (String type)	Stores the text or options to be displayed in the dialog box beforehand. Note: Only one of either Options or Password can be set.
	Title	Enter value (String type)	Reflected as the title name of the dialog box.
	Password	Check item	Check this option to treat the input value as a password. When the user inputs a value, it will be displayed as "●" on the screen. ※ Only one of the options, either "Options" or "Password," can be set.
	Label	Enter value (TimeSpan type)	It will be reflected in the text displayed within the dialog box.

4. How to use

Depending on the settings of the 'Input > Option' property, the dialog display will vary. Note that the 'Option' property and the 'Password' property cannot be used simultaneously. If the 'Password' option is checked, the dialog will automatically display without any settings specified for the 'Option' property.

Pattern	Value to Specify in the "Option" Property	Dialog Box Displayed
1	No value specified	Text box
2	One element	The specified value is displayed in the text box
3	Two or three elements	The specified values are displayed as radio buttons
4	Four or more elements	The specified values are displayed in a dropdown

Let’s review the flow. First, let's prepare for checking each pattern.

Drag and drop the 'Core > Input Dialog' activity from the Toolbox to the Designer panel.

Set the 'Title' and 'Label' properties within the activity. This time, enter 'Dialog Title' for the 'Title' property and 'Text inside the dialog' for the 'Label' property.

To verify the selected value in the dialog box, set the variable 'ValueDialog' in the 'Output > Result' property. The method for creating variables is explained in the 'Creating Variables' section, so please refer to it.

Drag and drop the 'Core > Log > Log Message' activity from the Toolbox to the Designer panel.

Enter the variable 'ValueDialog' that was set earlier into the 'Input > Message' property

Now that the preparation is complete, let's go over each pattern from here.

Pattern 1: When no value is specified for the "Option" property

With the preparation in place, click "Home > Start" or press the "F5 key" to run. A dialog box will appear. The "Dialog Title" specified in the "Title" property will be displayed at the top of the dialog, and the "Text inside the dialog" specified in the "Label" property will be shown inside the dialog. Since no value is specified for the "Option" property, a text box will be displayed. You can enter text here.

This time, enter 'Input Dialog' and click 'OK'.

Check that the log is present in the 'Output' section of the akaBot Studio. The text 'Input Dialog' entered in the dialog is displayed in the log.

Pattern 2: When one element is specified for the "Option" property

Specify one element in the "Option" property of the "Input Dialog" activity. This time, specify {"1"}.

Click 'Home > Start' or press the 'F5 key' to run, and the dialog will appear. The text box in the dialog will display the '1' specified in the 'Option' property. Editing is possible, but this time, click 'OK' as is.

Check that the log is present in the 'Output' section of akaBot Studio. The value '1' is displayed in the log.

Pattern 3: When two or three elements are specified for the "Option" property

Specify two elements in the "Option" property of the "Input Dialog" activity. This time, specify {"1", "2"}.

Click 'Home > Start' or press the 'F5 key' to run, and the dialog will appear. In the dialog box, the values '1' and '2' specified in the 'Option' property will be available as selectable radio buttons. This time, select '2' and click 'OK'.

Check that the log is present in the 'Output' section of akaBot Studio. The value '2' is displayed in the log.

Pattern 4: When four or more elements are specified for the "Option" property

Specify four elements in the "Option" property of the "Input Dialog" activity. This time, specify {"1", "2", "3", "4"}.

Click 'Home > Start' or press the 'F5 key' to run, and the dialog will appear. In the dialog box, the values '1', '2', '3', and '4' specified in the 'Option' property will be available for selection in a dropdown. This time, select '4' and click 'OK'.

Check that the log is present in the 'Output' section of akaBot Studio. The value '4' is displayed in the log.

Note: In each pattern, if the "OK" button is clicked without entering anything in the text box, without selecting any radio button, or without selecting anything in the dropdown list, no error will occur. Instead, a blank line will appear in the 'Output' log.