User Message Box steps

This group collects any step concerned with presenting information to users on the remote clients in different types of message boxes. This group of steps is applicable to Windows, MacOS, and Linux systems.

Advanced Message Box

This step displays an advanced message box to the user. An advanced message box is a dialog box that appears on the display asking for confirmation from the user.

Parameter	Description
Validation Button Label	Defines the text to be displayed on the confirmation button in the dialog box, such as for example OK or Yes .
Cancel Button Label	Defines the text to be displayed on the cancel button in the dialog box, such as for example Cancel or No . This button does not appear in the final message box if the text field is left empty.
Full Screen	Check this box if the message box is to be displayed in full screen mode.
Message Title	Defines the title string to display at the top of the dialog box.
Message Text	Enter into this field the main text displayed to be displayed in the dialog box.
Always display in foreground	Defines if the window is to be displayed always in the foreground, that is, every other window called is not positioned on top of the window but stays behind it.
Timeout (sec)	Defines the time to wait in seconds for the user to confirm or cancel. If the user does not react within this timeframe, the window is automatically validated and closed.
Success after timeout	Check this box if the step is to be executed after the defined timeout passed without user action (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Success if no one is logged on to device	Check this box if the step is to be executed if no user is logged on to the device (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Action if Screen Saving	Select from this dropdown box the way the step is to behave if the screen saver is active: Wait for End of Screen Saver : do nothing until the screen saver is ended and the user takes action Success : execute the step without waiting (this is the same as if the user clicked the validation button). Failure : Do not execute the step (this is the same as if the user clicked the cancel button).

Advanced Message Box With Image

This step displays an advanced message box with a customizable background image to the user. An advanced message box is a dialog box that appears on the display asking for confirmation from the user.

Parameter	Description
Validation Button Label	Defines the text to be displayed on the confirmation button in the dialog box, such as for example OK or Yes .
Cancel Button Label	Defines the text to be displayed on the cancel button in the dialog box, such as for example Cancel or No . This button does not appear in the final message box if the text field is left empty.
Local Image File Path (bmp only)	Enter into this field the path to the image file which must be of type .bmp. If the image cannot be found, that is, because it is of another type, or it is too small, the default BCM image is used. If the image is too large it is cropped to fit the window. The default size of the BCM image is 460x310 pixels.
Message Title	Defines the title string to display at the top of the dialog box.
Message Text	Enter into this field the main text to be displayed in the dialog box.
Success after timeout	Check this box if the step is to be executed after the defined timeout passed without user action (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Success if no one is logged on to device	Check this box if the step is to be executed if no user is logged on to the device (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Success if the device is in screen saver mode	Select from this dropdown box the way the step is to behave if the screen saver is active: Wait for End of Screen Saver : do nothing until the screen saver is ended and the user takes action Success : execute the step without waiting (this is the same as if the user clicked the validation button). Failure : Do not execute the step (this is the same as if the user clicked the cancel button).
Timeout (sec)	Defines the time to wait in seconds for the user to confirm or cancel. If the user does not react within this timeframe, the window is automatically validated and closed.
Always display in foreground	Defines if the window is to be displayed always in the foreground, that is, every other window called is not positioned on top of the window but stays behind it.

Close Information Dialog

This step allows you to close the information dialog that appeared for the Display Information Dialog step.

No parameters need to be defined for this step.

Display Information Dialog

This step displays an information message in form of a dialog box without a button. Reexecuting the step allows you to update the displayed message. This dialog must be closed again with the Close Information Dialog step.

Parameter	Description
Message Text	Enter the text of the message box here, for example, The software program xyz is installed on your computer. Do you want to proceed with the installation now?

Localized Message Box

This step allows you to display the contents of a message box in the language of the local operating system language. You may define four different target languages, for any other language the specified default message will be displayed.

Parameter	Description
Text Button 1	Enter the localized button text of the message box.
Text Button 2	Enter the localized button text of the message box.
Text Button 3	Enter the localized button text of the message box.
Text Button 4	Enter the localized button text of the message box.
Default Button Text	Enter the default text to appear on the button of the message box, that is displayed if the local operating system is not one of those defined below.
Default Message Title	Enter the default title of the message box, that is displayed if the local operating system is not one of those defined below.
Default Text	Enter into this field the default message text of the message box, that is displayed if the local operating system is not one of those defined below.
Language 1	Select the language for which the text specified in the following three fields is defined. The language selected here encompasses all 'versions' of the language, such as selecting English includes British English, American English, New Zealand English, etc.
Language 2	Select the language for which the text specified in the following three fields is defined. The language selected here encompasses all 'versions' of the language, such as selecting English includes British English, American English, New Zealand English, etc.
Language 3	Select the language for which the text specified in the following three fields is defined. The language selected here encompasses all 'versions' of the language, such as selecting English includes British English, American English, New Zealand English, etc.
Language 4	Select the language for which the text specified in the following three fields is defined. The language selected here encompasses all versions of the language, such as selecting English includes British English, American English, New Zealand English, etc.
Text 1	Enter the localized message text of the message box.
Text 2	Enter the localized message text of the message box.
Text 3	Enter the localized message text of the message box.
Text 4	Enter the localized message text of the message box.
Title Message 1	Enter the localized message title of the message box.
Title Message 2	Enter the localized message title of the message box.
Title Message 3	Enter the localized message title of the message box.
Title Message 4	Enter the localized message title of the message box.

Send Customized Form

This step creates a form to update the custom inventory of the local target client. Once the rule is executed, a browser window opens on the target, in which a form with several fields is to be filled by the local user.

The form has two buttons, OK to confirm the filled in form and Later to postpone the filling in of the values. Once the form is completed and confirmed the custom inventory .xml file is updated with the new information. This newly added information will be added to the custom inventory in the Console and the agent interface pages at the next update. The fields are prefilled in for a personal information form.

Parameter	Description
Validation Button Label	Defines the text to be displayed on the confirmation button in the dialog box, such as for example OK or Yes .
Cancel Button Label	Defines the text to be displayed on the cancel button in the dialog box, such as for example Later . This button does not appear in the final message box if the text field is left empty.
Labels of Custom Inventory Fields	Contains the semi-colon separated list of field names as which they appears in the custom inventory. Make sure that the order and the number of the fields is the same as in the Form Fields above. for example, Field List: Name;FirstName;Phone, these are the 'internal' references to the new fields, Labels: Family Name;First Name;Office Phone Number, this is the text as which the fields appears in the HCHL form and under the custom inventory node.
Footer Text	This free text field is below the list of fields to be filled in and may contain additional information.
Form Field Data Type	Contains the semi-colon separated list of the data types of the fields defined above to be filled into the form. Possible values are string, integer, combo:string, combo:integer and boolean . For example, string;integer;boolean;combo:string for the above listed form fields of Name;Age;Driving License;Mobile Phone Operator .
Default Field Values	Allows you to define default values for the form fields that is displayed to be selected via a drop down list. The entry default values are separated by commas (,), the default values for each field are separated by a semi-colon (;).
Form Fields	Contains the semi-colon separated list of fields of the form to be filled in, for example, Name;Age;Driving License;Mobile Phone Operator .
Title	Enter the title of the form into this field, for example, Custom Inventory - Local Information .
Header Text	A short textual explication for the local regarding the fields of the form below.
Insert a logo	Check this box if the background of the title is to show a logo. The default logo is the BCM logo, but the logo may be customized. It is located in directory <InstallationDirectory>/master/ui/custom/common/images . The 'logo' consists of two files logo.gif and text.jpg which are put next to each other. To customize modify the contents of the files but do NOT modify the names.
Retry Interval (min)	The retry interval defines the interval at which the step is to effect its retries in minutes.

User Acknowledgement via Advanced Message Box

This step allows the user to acknowledge information on his screen. If the timeout for the last try expires, this has the same effect as if OK was clicked.nNote: If you want to add another step after this one, the Stop on failed step condition must be set for this step.

Parameter	Description
Message Title	Enter the title of the message box into this field, for example, Installation.
Message Text	Enter the text of the message box here, for example, The software program xyz is installed on your computer. Do you want to proceed with the installation now?
Validation Button Label	Define the label of the validation button, such as OK to indicate to the operational rule to proceed with its execution.
Cancel Button Label	Define the label of the cancel button, such as Later , to indicate not now, proceed later.
Number of Retries	Defines how often the user has the choice to postpone the announced operation.
Retry Interval (min)	Defines the interval in minutes at which the user is presented with this user message box.
Always display in foreground	Defines if the window is to be displayed always in the foreground, that is, every other window called is not positioned on top of the window but stays behind it.
Full Screen	Check this box if the message box is to be displayed in full screen mode.
Timeout (sec)	Defines the time to wait in seconds for the user to confirm or cancel. If the user does not react within this timeframe, the window is automatically validated and closed.
Success after timeout	Check this box if the step is to be executed after the defined timeout passed without user action (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Success if no one is logged on to device	Check this box if the step is to be executed if no user is logged on to the device (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Action if Screen Saving	Select from this dropdown box the way the step is to behave if the screen saver is active: Wait for End of Screen Saver : do nothing until the screen saver is ended and the user takes action Success : execute the step without waiting (this is the same as if the user clicked the validation button). Failure : Do not execute the step (this is the same as if the user clicked the cancel button).

User Acknowledgement

This step sends a message box to the local client which informs the user of actions that will be taken on his/her device and provide him/her with the possibility to postpone these operations until he/she has taken the steps necessary to save all current work. A situation in which this step is useful is before a remote software installation, for instance.

Parameter	Description
Title	Enter a title for the window and the message below, such as Application Installation .
Message	Enter here the message to the user to inform him of what is undertaken on his machine.
Number of Retries	Defines how often the user has the choice to postpone the announced operation.
Retry Interval (min)	Defines the interval in minutes at which the user is presented with this user message box.

User Acknowledgement via Message Box

This step creates a message box on the target device. The purpose is to allow the end user to acknowledge information. The end user can accept or delay the operation; however, the user cannot completely cancel the operation. After the specified number of retries and retry intervals, the execution will be forced.nNote: If you want to add another step after this one, the Stop on failed step condition must be set for this step.

Parameter	Description
Validation Button Label	Define the label of the validation button, such as OK to indicate to the operational rule to proceed with its execution.
Cancel Button Label	Define the label of the cancel button, such as Later , to indicate not now, proceed later.
Message Title	Enter the title of the message box into this field, for example, Installation.
Message Text	Enter the text of the message box here, for example, The software program xyz is installed on your computer. Do you want to proceed with the installation now?
Number of Retries	Defines how often the user has the choice to postpone the announced operation.
Retry Interval (min)	Defines the interval in minutes at which the user is presented with this user message box.

User Message Box

This step displays a message box to the user on the target devices. A message dialog box is a small box that appears on the display screen to give you information or to warn you about a potentially damaging operation.

For example, it might warn you that the system is deleting one or more files. Unlike normal dialog boxes, message boxes do not require any user input. However, you need to acknowledge the alert box by pressing the Enter key or clicking a mouse button to make it go away. The functions of this Chilli module enable you to create such boxes.

Parameter	Description
Button Text	Defines the text to be displayed on the single button in the dialog box.
Message Title	Defines the title string to display at the top of the dialog box.
Message Text	Enter into this field the main text displayed to be displayed in the dialog box.
Success if no one is logged on to device	Check this box if the step is to be executed if no user is logged on to the device (this is the same as if the user clicked the validation button). If the box remains unchecked the step is not executed (this is the same as if the user clicked the cancel button).
Action if Screen Saving	Select from this dropdown box the way the step is to behave if the screen saver is active: Wait for End of Screen Saver : do nothing until the screen saver is ended and the user takes action Success : execute the step without waiting (this is the same as if the user clicked the validation button). Failure : Do not execute the step (this is the same as if the user clicked the cancel button).