User interaction and general scripting

The user interaction and general scripting commands provide Analytics scriptwriters with a set of commands for structuring and controlling the behavior of scripts.

Command descriptions

Command Description

ACCEPT

Creates a dialog box that interactively prompts users for one or more script input values. Each input value is stored in a named character variable.

ASSIGN

Creates a variable and assigns a value to the variable.

CALCULATE

Calculates the value of one or more expressions.

CLOSE

Closes an Analytics table, index file, or log file, or ends a Script Recorder session.

COMMENT

Adds an explanatory note to a script without affecting processing.

DELETE

Deletes an Analytics project item, a field from a table layout, a variable, one or more table history entries, a relation between tables, or a file in a Windows folder. Also removes a column from a view.

DIALOG

Creates a custom dialog box that interactively prompts users for one or more script input values. Each input value is stored in a named variable.

DO SCRIPT

Executes a secondary script, or an external script, from within an Analytics script.

ESCAPE

Terminates the script being processed, or all scripts, without exiting Analytics.

EXECUTE

Executes an application or process external to Analytics. Emulates the Windows Run command. Can be used to interact with the Windows command prompt.

GROUP

Executes one or more ACLScript commands on a record before moving to the next record in the table, with only one pass through the table. Command execution can be controlled by conditions.

IF

Specifies a condition that must evaluate to true in order to execute a command.

LOOP

Executes a series of ACLScript commands repeatedly on a record while a specified condition evaluates to true.

NOTIFY

Sends an email notification message.

PASSWORD

Creates a password definition, without a password value, that prompts users for a password while a script is running.

PAUSE

Pauses a script, and displays information in a dialog box for users.

RCOMMAND

Passes an Analytics table to an external R script as a data frame and creates a new table in the Analytics project using output from the external R script.

RENAME

Renames an Analytics project item or a file.

SET

Sets a configurable Analytics option.