IMPORTANT: After creating and editing the script, test compiling the script. You must compile the database for the script to take effect.
To copy an existing script
-
In the Designer, select the script that you want to copy from the Script Library category.
-
Select the Copy script task.
-
In the Copy script dialog, check the following information and correct if necessary.
Table 96: Copying a script
|
Old script name |
Name of the copied script. |
|
script |
The name of the new script is made up of the CCC_ prefix and the name of the old script. You can change the name. Prefix custom scripts with CCC_. |
|
Script code |
The script code from the original is copied over. If necessary, you can modify the script code of the script to copy beforehand. |
-
To create the copy, click OK.
-
In the Script Editor, edit the main data of the script.
You can use the Script Editor to test a script.
To test a script
-
In the Designer, select the script in the Script Library.
-
Select the Edit script task.
-
Select the View > Test script menu item.
-
In the Test script view, select the script from the menu and modify the parameters as required.
All the parameters to be passed to the script are displayed with their data types. You can edit the values. You can also predefine values for the Base and Value script base class variables as input parameters and use these in the script.
-
Use Options to select one or more of the following options for running the test.
-
Use main database connection: Specifies whether the script test is tested against the main database or an internal SQLite database. Scripts that relate to the application part of the One Identity Manager data model should always be tested with the main database. Scripts for system parts can be test with against the main database or the internal SQLite database.
-
Use transaction: Specifies whether the script is run within a transaction with subsequent rollback or whether the script is run immediately against the database.
-
Record SQL log: Specifies whether the database actions should be recorded in an SQL log while the script is running. The output is displayed in a separate dialog window. The time to run the script is output in addition to the statement run.
-
Select the Start button to run the script test.
The test results are displayed in the Result field after the script has been run.
If you have created a new script, you need to compile it. The script cannot be generated until it has been compiled. You can test script compilation in the Script Editor.
To test compiling scripts
-
In the Designer, select the script in the Script Library category.
-
Select the Edit script task.
-
Start compilation with the icon 
, the Script > Compile script menu item or F9.
All scripts are converted during compilation. The assemblies are created and placed on the workstation where generating will take place. During the conversion, the script code is tested for validity. This process may required some time.
Error messages are sent to the Compiler errors view. A double-click on the error message takes you straight to the corresponding line in the script code view where you can edit it. It can be modified at this point.
IMPORTANT: Once you have tested the script, commit it to the One Identity Manager database and compile the database with the Database Compiler. For more information, see the One Identity Manager Operational Guide.
If you have created, imported, or modified a script in the Script Editor it must be committed to the One Identity Manager database and compiled. The script cannot be generated until it has been compiled.
To commit and compile a script
-
Commit the script to the One Identity Manager database. In the Designer, select the Database > Commit to database menu item and click Save.
-
Compile the database with the Database Compiler. In the Designer, select the Database > Compile database menu item.
For more information, see the One Identity Manager Operational Guide.
