Details on Script – Act on Property Change

This dialog is used to define a script action that should be performed whenever a document property changes its value. It can be reached from the Properties tab of the Document Properties dialog, from the Document properties panel or from the Property Control dialog.

Option	Description
Each time the property value changes, perform this action
No action	Select this radio button if no action is desired when the property changes value.
Execute the script selected below	Select this radio button to connect all property value changes to a script action.
Available scripts	Lists all currently defined scripts. Note: The Remark field can contain information about whether a script is trusted or not. Scripts that you have created yourself are trusted, and so are scripts saved as trusted to the library by a member in the Script Author group. If you receive an analysis file containing a script directly from another person, the script will be listed as "Not trusted". This does not necessarily mean that the script contains any unsafe material, but you should determine whether you trust the script or not by inspecting it in the Edit Script dialog. By clicking OK in the Edit Script dialog, the script will be trusted. If you know all scripts are safe, you can click Trust All. However, due to security reasons, scripts cannot be used in a TIBCO Cloud Spotfire web client environment. In a Spotfire on premises web client environment, scripts can be executed if they are saved as trusted by a member in the Script Author group. See also Usage of Scripts and Data Functions.
Add	Lets you select an analysis file from which to import all available scripts, or to define a new script. Note: Spotfire compares the scripts you are trying to import with already existing scripts. A script whose script body is identical to an existing script will not be imported even if it has a different name. If you choose to add a new script the New Script dialog is opened.
Edit	Opens the Edit Script dialog where you can edit the selected script or its parameters.
Delete	Deletes the selected script.
Manage trust	Opens the Manage trust dialog where you can review and trust all the scripts in the analysis, together with any other custom extensions such as mods or data functions.
Necessary input for the selected script	Lists all parameters that have been defined for the selected script. Click on a parameter to modify the input. Different parameter types have different input settings.
Value	Click this radio button if you want to type a value to use as input for the selected parameter.
Property	Click this radio button to associate the selected parameter with a property.
Select Property...	Opens the Select Property dialog where you can specify which property to get the input to the script from.
Expression	Click this radio button to calculate the value for the selected parameter via an expression.
Edit Expression...	Opens the Edit Expression dialog where you can specify an expression using columns, properties and functions.
Select visualization	Select the visualization in the current analysis that you want to associate with the selected script parameter.
Select page	Select the page in the current analysis that you want to associate with the selected script parameter.
Select data table	Select the data table in the current analysis that you want to associate with the selected script parameter.