Removing an Attribute Using the Command Line Tool
Note: | When you remove an attribute from an asset type, keep the following in mind:  If there are many existing instances, the remove operation can take some time to complete. You cannot remove a predefined attribute from a predefined asset type. You can, however, remove a custom (i.e. user-defined) attribute from a predefined asset type. |
There is a command line tool remove Attribute that allows you to remove an attribute from an asset type, in cases where existing instances of the type contain a value for the attribute. Using the tool, the attribute's value is automatically removed from all existing instances, then the attribute is removed from the type.
You can use the command line tool CentraSiteCommand.cmd (on Windows) or CentraSiteCommand.sh (on UNIX). The command line tool is located in <SuiteInstallDir>/CentraSite/utilities.
If you start the command line tool with no parameters, you receive a help text summarizing the required input parameters.
The parameters of the command are case-sensitive, so for example the parameter -url must be specified as shown and not as -URL.
If you omit the passwords from the command, you will be prompted to provide them.
To remove an attribute from an asset type, use a command of the following format:
CentraSiteCommand remove Attribute [-url <CENTRASITE-URL>]
-user <USER-ID>-password <PASSWORD> -assetType <ASSET-TYPE>
[-attributeKind <ATTRIBUTE-KIND>] -attributeName <ATTRIBUTE-NAME>
Input Parameters
The following table describes the complete set of input parameters that you use with the remove Attribute utility:
Parameter | Description |
-url | The fully qualified URL (http://localhost:53307/CentraSite/CentraSite) for the CentraSite registry/repository. |
-user | The user ID of a user who has the CentraSite Administrator role. |
-password | The password of the user identified by the parameter -user. |
-assetType | The name of the asset type, in the format "{<namespace of the asset type>}SchemaName". |
-attributeKind | A one-character code representing the type of the attribute you wish to remove. Allowable values are "C" for Classification, "R" for Relationship, "F" for File and "S" for all other attribute types. The use of the attributeKind parameter is optional. For more information about the various kinds of attributes, see What Is a Type?. |
-attributeName | The name of the attribute schema for attributes whose AttributeKind is "S". For attributes with an AttributeKind other than "S" it is the name of the attribute itself. |
Example 24. Example
CentraSiteCommand remove Attribute -url http://localhost:53307/CentraSite/CentraSite
-user Administrator -password manage -assetType
{http://namespaces.CentraSite.com/Schema}XMLSchema
-attributeKind S -attributeName test_String_Attribute
