IMPORTANT: After creating and editing the script, you should test compiling the script. Compile the scripts in the script library for this 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 140: 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.
Related topics
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.
Related topics
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 it needs to be added to the One Identity Manager database and compiled with the Database Compiler. For more information, see the One Identity Manager Operational Guide.
You might want to label scripts for overriding if there are limits to how much you can modify default scripts. Scripts that can be overwritten are labeled with the overridable property.
NOTE: Only the default scripts that are supplied can be overriden. Custom scripts cannot be overridden because these are saved in a Custom scripts script class.
To override a script
-
In the Designer, select the script to override in Script Library > Overridable scripts.
-
Select the Copy script task.
-
In the Copy script dialog, edit the following information.
-
To create the copy, click OK.
-
In the Script Editor, replace the overridable property with overrides in the script header.
-
Modify the other script code accordingly to suit your requirements.
IMPORTANT: After creating and editing the script, you should test compiling the script. Compile the scripts in the script library for this script to take effect.
Syntax example
Public overridable Function My_Function() as Boolean
'script code of the original version
End Function
Public overrides Function My_Function() as Boolean
End Function
Related topics
