Modifying Action Template Details
Pre-requisites:
To modify the details of an action template through CentraSite Command Line Interface, you must have the CentraSite Administrator role.
CentraSite provides a command tool named update Action Template for this purpose.
The action template you want to modify is specified by the parameter ID. Any change of the template's property value must be provided using an updated configuration file. All property values provided by the configuration file, including the specified object types, event types, and the parameter templates, are overwritten.
To modify the details of an action template
Run the command update Action Template. The syntax is of the format: C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Action Template [-url <CENTRASITE-URL>] -user <USER-ID> -password <PASSWORD> -id <ID> [-file <CONFIG-FILE>] [-implementationzip <IMPLEMENTATION-ZIP>] [-forceedit <FORCE-EDIT>]
The input parameters are:
Parameter | Description |
CENTRASITE-URL | (Optional). The URL of the CentraSite registry. For example, http://localhost:53307/CentraSite/CentraSite. |
USER-ID | The user ID of a registered CentraSite user who has the CentraSite Administrator role. For example, Administrator. |
PASSWORD | The password for the registered CentraSite user identified by the parameter USER-ID. |
ID | The ID of the action template you want to update. You can specify the UDDI key of the template using an optional prefix uddi:. For example: uddi:95f79c00-52a9-11e4-969c-d398081308d4 |
CONFIG-FILE | (Optional). Name of the action template configuration file that contains the input parameters to be modified. Note: | If you are saving the file in a different location other than <CentraSiteInstall_Directory>/utilities, provide the absolute file path. |
Important: | If the action template whose configuration you want to modify has one or more active policies associated to it, the upload of the configuration file fails, and displays a warning message. |
|
IMPLEMENTATION-ZIP | (Optional). Name of the Java implementation zip file that contains the elements to be modified. Note: | If you have saved the zip file to a different location other than the default location <CentraSiteInstall_Directory>/utilities, provide the absolute path to the zip file. |
Important: | If the action template whose implementation you want to modify has one or more active policies associated to it, then the zip file upload fails, and displays a warning message. In this case, you will need to enable the FORCE-EDIT option to update the implementation details of action template. |
CentraSite has a sample implementation zip file uniquenamechecker.zip that you can use to enforce unique asset names in the CentraSite registry. This sample implementation zip file is located in <CentraSiteInstall_Directory>/ demos\CustomActions\Java. |
FORCE-EDIT | (Optional). Allows to forcibly modify the implementation details of an action template that has one or more policies in the Active state. Supported values are - true, false Note: | In general, you are not allowed to modify the implementation details of an action template that has at least one policy in the Active state. |
|
Examples (all in one line):
Providing action template configuration file:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Action Template -url http://localhost:53307/CentraSite/CentraSite –user Administrator –password manage -id uddi:95f79c00-52a9-11e4-969c-d398081308d4 –file c:\temp\Custom_Action_Template_Config.xml
Providing action implementation file:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Action Template -url http://localhost:53307/CentraSite/CentraSite –user Administrator –password manage -id uddi:95f79c00-52a9-11e4-969c-d398081308d4 –file c:\temp\Custom_Action_Template_Config.xml -implementationzip c:\temp\custom_action_implementation.zip -forceedit true
The response to this command could be:
Executing the command : update Action Template
Action Template named Custom Action Template is updated successfully
Successfully executed the command : update Action Template
