Script Editor

Applies to: Kyvos Reporting

Kyvos Reporting provides scripting support for report field properties and events, enabling you to control report behavior dynamically during runtime.

Accessing the Script Editor

To open the Script Editor:

On the home screen, select Tools > Scripting.
The Script Editor – JScript window opens.

Context-Sensitive Help

The Script Editor offers context-sensitive help to assist with syntax and object selection.

When you type object prefixes such as rpt., the editor displays suggestions for applicable properties and methods.
Use this feature to quickly access fields, sections, and controls during script authoring.

Accessing Report Fields

You can access report fields through the rpt.Fields collection. Use this to reference layout controls during events.

Example: Adding a field during Data Initialize

rpt.Fields.add("MyField");

Warning

Avoid adding a field that already exists. Doing so will cause a fatal error.

Example: Setting a value during data fetch

rpt.Fields("SomeFieldName").value = "<SomeValue>";

Accessing Layout Controls

Layout controls such as text boxes, shapes, or images can be accessed through the rpt.Sections("SectionName").Controls("ControlName") hierarchy.

Example:

rpt.Sections("Detail").Controls("imgLogo").visible = false;

Note

You cannot connect to the database using report scripts.

Compiling Scripts

After entering a script, click the Compile button to check for syntax errors.

Errors appear in a panel below the script editor.
Correct the errors and recompile to ensure the script runs as expected.

Find and Replace

Use Ctrl + F or click the Find icon to open the Find and Replace panel. You can:

Search up or down
Match case
Match whole words
Replace one or all instances of a term