You use the Edit Asset Type wizard to view or edit the properties and options for an existing asset type. When editing an existing type, keep the following points in mind:
You can modify the type's display name, description, icons and advanced options. You cannot modify the type's Schema Name or its Namespace property. These two properties are set when the type is created and cannot be changed thereafter.
With respect to attributes:
You can add new optional attributes to the type at any time.
You can add new required attributes if there are no existing instances of the type in the registry. If there are existing instances of a type, you can add a new required attribute of type "slot" or "classification", but not of type "relationship" or "file".
If you add a new attribute, regardless of whether it is optional or required, no automatic update of existing instances takes place. This prevents the potential degradation of performance that could arise from the automatic update of a large number of instances.
You cannot modify the data type for an attribute, but you can modify many of an attribute's other options. Be aware that certain are not permitted if assigned (i.e., non-empty) instances of the attribute are present in the registry. For information about the kinds of changes you can make to an existing attribute, see the property and option descriptions in Defining Attributes for a Type.
You cannot delete an attribute from a type if an instance of the type exists with a value assigned to the attribute. In such a situation, you must first remove the attribute's value from each such instance before you can delete the attribute.
Note that the command line tool "CentraSiteCommand" provides support for removing an attribute, in cases where existing instances contain a value for the attribute. See below for details.
You can add, modify, delete, rename and reorganize the profiles associated with a type at any time.
Important:
If you are modifying one of the predefined asset types installed
with CentraSite, review the information in
The Predefined Asset Types
Installed with CentraSite before you begin. It explains
the kinds of modifications that you can make to the predefined
types.
Important:
If you are using CentraSite in conjunction with other software
products, for example, the products of the Software AG webMethods Product Suite
or a third-party product, those products can add their own asset types to
CentraSite. Be aware that CentraSite treats these types as user-defined
custom types, which can be modified by an administrator with the appropriate
permissions (just like any other custom type). Modifying or deleting these
types in CentraSite can lead to inconsistencies or errors in the product that
uses the type. For example, if you modify or delete a type that is used by the
webMethods Product Suite, components such as the webMethods Integration Server
may no longer be able to publish assets to CentraSite. To prevent these types
of errors, do not modify or delete any asset type on which other Software AG
components or third-party products depend. For a list of the predefined
types that the webMethods Product Suite uses, see
The Predefined Types
Installed with CentraSite.
To view or edit a type
In CentraSite Control, go to > .
By default, all of the available types are displayed in the tab.
If you want to filter the list to see just a subset of the available types, enter a partial string in the Search field. CentraSite applies the filter to the Name column. The Search field is a type-ahead field, so as soon as you enter any characters, the display will be updated to show only those types whose name contains the specified characters. The wildcard character "%" is supported.
In the tab, click the name of the asset type that you want to modify.
In the Asset Type Details page, click to open the Edit Asset Type wizard.
On panel 1, edit the following fields as necessary:
| In this field... | Do the following... |
|---|---|
| Name |
Specify the display name for the type. Be sure to use a name that your users will recognize and understand. For example, use "BPEL Process Document", not "bpdoc". The name you assign to the asset type can contain any character, including spaces. Note: |
| Description |
Optional. Enter a brief description of the type. |
If you want to modify the icons associated with the type or change the type's advanced settings, click and modify the settings in the Advanced Settings dialog box as needed. For additional information about the settings in this dialog box, see the descriptions for these settings in Creating a New Type.
In panel 2, edit the type's attributes as necessary. If you need procedures for this step, see Defining Attributes for a Type.
In panel 3, edit the type's profiles as necessary. If you need procedures for this step, see Defining Profiles for an Asset Type.
In panel 4, change the selection of generic profiles as necessary. For more information about generic profiles, see Generic Profiles.
In panel 5, rearrange the order of the type's profiles as necessary.
Click to save the updated type.
You can view multiple asset types as follows:
To view multiple asset types
In CentraSite Control, go to > .
Ensure that the Types tab is selected.
Mark the checkboxes of the types whose details you want to view.
In the menu, click .
The Details view of each of the selected types is now displayed.
There is a command line tool 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.
Notes:
To remove an attribute from an asset type
At the command line, enter 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>
The following table describes the complete set of input parameters
that you can 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
attributeKindparameter is optional. See the description of attribute types in the section What is a Type? for more information about the various kinds of attributes. |
-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. |
Here is an example of a call of this command:
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"
You can execute the above command in the command line interface CentraSiteCommand.cmd (Windows) or CentraSiteCommand.sh (UNIX) of Command Central. The tool is located in <CentraSiteInstallDir>/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".
