Importing Studio Reports Parameters

Applies to: Kyvos Reporting

You can import parameters stored in the repository and reuse them while designing reports. Parameters can be imported in two ways:

• Individually: A copy of the parameter is imported into the report.

• By reference: The parameter remains linked to the original in the repository. Any changes made to the source parameter automatically reflect in all reports using it by reference.

Steps to Import Parameters

1. On the Parameters screen, click the Import button.

2. The Import screen appears.
   
   

   Open

   

3. In the Category object selector, navigate to the desired folder to list available parameters.

4. In the list:

   • Select the Selected checkbox to import the parameter.

   • Select the By Ref checkbox to import it by reference.

5. Click Apply.

6. Click OK to complete the import and close the dialog.

Adding Validation Scripts for Parameters

You can define scripts to validate parameter values and apply dynamic behavior based on user input.

Steps to Add a Script

1. On the Parameters screen, click Add Script to open the Script Editor.
   
   

   Open

   

2. Write your validation script in the editor.

3. Click Compile to check the script.

4. Click OK to save or Cancel to discard changes.

Script Execution Behavior

Scripts support the OnChange() event, which is triggered when the user performs any of the following:

Script Capabilities

• Access other report parameters (read-only).

• Access parameter objects (even if not imported) and global business parameters.

• Return True for valid input, or False to trigger a validation failure.

• Display custom error messages if validation fails.

• Prevent report generation if validation fails.

You can also modify parameter behavior based on the script outcome. For example: