Managing Scripts: Difference between revisions

From QPR ProcessAnalyzer Wiki
Jump to navigation Jump to search
(214612)
(214612)
Line 47: Line 47:
#Click '''Create from Clipboard'''.
#Click '''Create from Clipboard'''.


Note that there cannot be duplicated global ID's (= the identifier in the '''Script GUID''' field) in the same context. If there are multiple scripts with the same global ID, you will receive an error message and the script is not copied.
Note that there cannot be duplicated global ID's (= the identifier in the '''Script GUID''' field). If there are multiple scripts with the same global ID, you will receive an error message and the script is not copied.


=== Deleting Scripts ===
=== Deleting Scripts ===

Revision as of 09:34, 15 July 2014

Script Manager

Scripts are tied to specific contexts, and the Script Manager dialog lists all the scripts accessible to the user according to the context selections defined by the Context, Selected User, Selected Project, and Selected Model drop-down menus. The Script Gallery accessible via the Run button on the ribbon will show the scripts for the context that was last selected in the Script Manager.

Note: In order to run scripts successfully, the allowed maximum number of scripts in the model is 1000.

By default, the following information is displayed for each script:

  • Context Type: the context to which the script is tied. The possible options are:
    • <All>: shows all available scripts
    • System: shows scripts available in the system
    • User: shows scripts made by the selected user
    • Project: shows scripts available for all the models in the selected project
    • Model: shows scripts available for the current model
  • Name: the name of the script.
  • Group: the name of the script group.
  • Tags: the tags added to the script.
  • Created On: the date and time when the script was created.
  • Created By: the user who created the script.
  • Last Modified On: the date and time when the script was last modified.
  • Last Modified By: the user who last modified the script.
  • Help: the URL of the defined help page for the script.

In addition, the following columns are hidden by default:

  • Id: the id of the script in the database.
  • Model Id: the id of the model to which the script is linked.
  • Model Name: the name of the model to which the script is linked.
  • Project Id: the id of the project to which the script is linked.
  • Project Name: the name of the project to which the script is linked.
  • Script GUID: the globally unique id of the script.
  • User Id: the id of the user to which the script is linked.

To unhide a column:

  1. Right click a column title and select Column Chooser from the popup.
  2. Drag the column to be shown to the desired position.

Viewing or Editing Script Properties

To view or edit the script properties of a script, select the script from the list and click Properties.

Running a Script

To run a script, select it from the list and click Run. Alternatively, you can run a script by clicking Run on the ribbon and selecting the script to be run from the menu that opens.

Creating a New Script

To create a new script, click New and define the Script Properties.

Copying Scripts to Another Context

  1. Select the script(s) you want to copy from the list by left-clicking a script. To select multiple scripts hold down either the Shift key or the Ctrl key.
  2. Click Copy to Clipboard.
  3. From the Context and the Selected User/Selected Project/Selected Model drop-down menus, select the context to which you want to copy the script(s).
  4. Click Create from Clipboard.

Note that there cannot be duplicated global ID's (= the identifier in the Script GUID field). If there are multiple scripts with the same global ID, you will receive an error message and the script is not copied.

Deleting Scripts

To delete script(s), select them from the list and click Delete.

Script Properties

The Script Properties dialog is used to view and edit the script properties:

  • Name: the name of the script.
  • Script GUID: the globally unique id of the script that is generated automatically when you save the script.
  • Support Link: the URL of the help page for the script.
  • Group: the name of the script group. This shows which scripts belong to the same script group in the drop-down menu of the Script Gallery accessible via the Run button on the ribbon.
  • Tags: the tags (keywords) added to the script.
  • Description: the description of the script.
  • Script Code: the actual script that is to be run.
  • Show in Script Gallery: when this is selected, the script will be shown in the menu that opens by clicking the Run button in the ribbon.
  • Hide Script Details: when this is selected, only users who have the right to modify the script can see the script details, when unselected, all users who have view permissions can see the script details.

Saving or Discarding Changes

  • After making changes to the script properties, click Save to save the changes. You can also press Ctrl + S to save the changes.
  • To discard changes done since the script was last saved, click Cancel Edit.

Running a Script

Click Run to run the script. Alternatively, you select it from the list on the Script Manager dialog and click Run, or you can click Run on the ribbon and select the script to be run from the menu that opens.