Connector Xpress Guide › Connector Xpress Utilities › Edit Metadata

Edit Metadata

You can edit the metadata for a project.

Important! Use the metadata editor at your own risk. Removing or altering important objects in the metadata can render it inoperable.

Follow these steps:

1. Open an existing project.
2. In the Provisioning Servers tree, right-click the endpoint type you want to edit the metadata for, then click Edit Metadata.

   The Edit Metadata for Endpoint Type dialog appears and displays the metadata in an XML tree.

3. Edit the metadata as required, then click Save.

   Connector Xpress redeploys the metadata.

Example: How an Administrator Modifies Metadata Manually

In this example, an administrator wants to change the display name mapping from last name to first name by manually modifying the metadata without using the mapping tree. The administrator:

1. Opens the dyn_jdbc_namespace.con project file.
2. Right-clicks the dyn_jdbc_namespace.con endpoint, then selects Edit Metadata.
3. Expands the dyn_jdbc_namespace node, and navigates to Classes, eTDYNAccount, Properties, eTDYN-str-01 in the Metadata Editor.
4. Modifies the displayName attribute from Last name to First name.
5. Modifies the beanPropertyName attribute from lastName to firstName.
6. Redeploys the modified metadata.
7. hecks that the changes have been made successfully by validating them in the Provisioning Manager.

More information:

Projects

Edit Metadata for Endpoint Type Dialog

Enumerated Values

For static enumerations, defining a new type involves:

• Creating a new unique type name
• Constructing a list of known values, each consisting of an internal value, and an optional display value

Note: Naming your new enum type int or integer does not cause any problems, however it can make maintenance of the metadata more difficult.

For query-based enumerations, define:

• A mapping to an unmanaged class
• The attributes the objects of that class have available for querying
• An association between a managed class and unmanaged class, through an appropriately chosen attribute in the former class

Metadata and Operations Bindings Editors Considerations

Important! You can use the Metadata editor to verify that the mappings you have made, however we recommend that you use the Metadata editor at your own risk. Removing or altering important objects in the metadata can render it inoperable.

Redeploy Metadata

When a connector project is open and metadata is available, you can push the metadata to the endpoint type on the Provisioning Server. You can only deploy metadata to dynamic endpoint types.

Note: If the endpoint type already has metadata, the new metadata cannot alter fundamental aspects of the data model such as adding attribute names or types.

Follow these steps:

1. Open an existing project.
2. In the Provisioning Servers tree, right-click the endpoint type you want to deploy data to, then click Deploy Metadata.

   The Deploy Metadata dialog appears.

3. Confirm that you want to deploy the metadata.

   Connector Xpress deploys the metadata to the selected endpoint type and overwrites any existing metadata.

More information:

Projects

DYN Schema Extensions

The DYN Schema has been extended for the following attributes:

• Container objects (eTDYNContainerXXX) are extended to 10.
• Generic objects (eTDYNObjectXXX) are extended to 35.
• All capability attributes (for example, eTDYN-str-multi-ic-, eTDYN-str-ic-, eTDYN-str-c-, eTDYN-bool-c-, eTDYN-int-multi-c-, eTDYN-int-c-) are extended to 99, with the exception of the multivalued case-sensitive attributes (eTDYN-str-multi-c-), which are extended to 500.
• The noncapability multivalued case-sensitive or case-insensitive attributes (for example, eTDYN-str-multi-, eTDYN-str-multi-i-) are extended to 500.
• The generic cached (that is, data location equals BOTH) multivalued case-sensitive attributes (eTDYN-str-multi-ca-) are extended to 99. These attributes are included in every DYN object.

  Cached attributes have their values stored on the provisioning server and are therefore accessible without contacting the endpoint system. Where their values are provided by the endpoint system, an explore operation is needed to update the values stored for them to match that on the endpoint system.

• Ninety-nine connection-specific cached multivalued case-sensitive attributes (eTDYN-str-multi-ca-sec-) are added for DYN Directory only. These attributes are added in the "encryptwith" line of the DYN password attribute, which can be used to obfuscate sensitive settings.

Metadata Descriptions

For more information about the metadata used in all layers of the architecture including Connector Xpress, JIAM, and CA IAM Connector Server, see the JavaDocs in the CA Identity Manager Bookshelf.

Using Connector Xpress as a Generic Metadata Editor

You can use Connector Xpress as a generic editor for non-JNDI or JDBC endpoint types. Using Connector Xpress as a generic editor lets you edit generic metadata that is not intended for a particular implementation bundle. For example, to edit metadata for the Scripting connector, create classes and attributes from the ground-up that are not mapped to a particular schema.

You can create and edit generic metadata in the following ways:

• Create new attributes, rather than selecting discovered attributes in the attribute mapping table.
• Load a set of predefined custom operational attributes from a predefined dictionary file.
• Load selected operational attributes from a predefined dictionary file.
• Load an extended set of metadata properties from a data file.