Develop > Wizards Guide > Using the Wizard Tool > File Selection tab field definitions

File Selection tab field definitions

Use this tab to designate system language or JavaScript code to be run before file selection and determine the content of $L.file. The tab includes three subtabs, described below. The Select $L.file by subtab includes four main options, listed from top to bottom as they appear on the screen.

Field Description

Initial Expressions subtab

init.expressions

Enter expressions using system language syntax that will be evaluated after the $L.file is initialized. Use these expressions to initialize variables.

JavaScript subtab

javascript.init

Enter the JavaScript code that will run after the $L.file is initialized. Use this section to initialize variables or select values from related tables.
Select $L.file by subtab You must choose one of the four main options listed below to designate how the wizard will select the $L.file variable.

No $L.file (use typecheck)

file.selection

This option means that the wizard should not expect a file variable to be passed in from wherever the wizard is called; in fact, if one is passed in, it will be ignored. Instead it creates $L.file by initializing it as a record in the "typecheck" table, which is an internal table that contains fields corresponding to different field types supported by the system.

This is often used in simple wizards that require only a small amount of input that does not need to be saved into the database.

$L.file passed in

file.selection

Selecting this option indicates that the file variable ($L.file) was passed into this wizard as a parameter from the calling application or wizard. If a wizard is called as a next wizard, the file variable is automatically passed on. This option should be selected if you plan to continue to work on the current record stored in $L.file.

Create a record

file.selection

Selecting this option indicates that the wizard will create a new record. You must enter or select the dbdict name in the record of type field. This initializes $L.file with the structure of the record from the table selected in the "of type" option.

of type (for Create a record)

create.record.filename

Click Fill to select the dbdict that defines the record to be created.

Select records

file.selection

Select this option to use a query statement to select one or many records.

of type (for Select records)

select.record.filename

This field determines the record type for a query. Enter the dbdict name of the table from which the records should be selected, such as location. Click Fill to select a name from a list of all dbdict names.

using query

select.query

Enter a query, using system language syntax, to search for records that will be used to select records. For example:

"agreement.id="+$G.new.sla

Note The quotes (") are required.

Resolve Variables
resolve.variables
Select this box (set to true) to ensure that any variables entered in the Select Records field are evaluated before running the query.

No Records Message

select.no.records

The text to display to the user if the query returns no records. This field also takes a message number from the message database.

For example: scmsg(111,"wizard")