Defining a Report Wizard Script

1. Go to the Home > Wizard List menu command.

The Wizard List page opens.

2. Click the New Wizard button located in the upper-right corner of the page.

The Wizard Editor overlay opens .



Figure 1 - The Wizard Editor overlay

3. Type a name for the new wizard into the Name field.
4. Type in a description if required.

The wizard can be made available to any user (Public), or it can only be available to you and other users to whom you have given access permission.

5. Check the Public box if you wish the wizard to be available to any user.
6. Save the changes.

The wizard is created and saved in the Wizard list, and the Script, Testing and User Permissions tabs become available.

7. Go to the Script tab .

Figure 2 - Here you can type or copy in the script required for the wizard.

Figure 3 - Example of scripting for a wizard

The script in the above example .is written in "functional blocks".

• The first block defines the template and any styles that are to be used. This is optional, and if no template or styles are defined then any default styles from the template you select will be used. These can then be changed at the page or object level as necessary.
• The report name is also not necessary - there is a field in the report wizard in which you can enter a report name.
• The remainder of the script in the example above creates the report, in this case a folder called "Questions", containing a page for each single or multi question in the project.

Using the script you can create parameter folders in the Report wizard, and a parameter folder can have folders and questions. You can name a parameter folder, and there may be any level of nested folders. Inside a parameter and a parameter folder, the folders will be listed first followed by the questions. Inside "create parameter", use indented "create parameter_folder" to create folder. You can also set a number of the report properties, create Analyst folders and tables, and quotas.

Note: Names for folders, pages, tables, parameters etc. used in wizard scripts must follow the same rules for lengths and characters as when created/renamed in the Report toolbox.