Administration Guide › CA Role & Compliance Manager Integration › How to Configure Integration with CA RCM › How to Configure a Connection in CA RCM › Select Endpoints and Resources › The Customizable Connector Template › resource Element

resource Element

The resource element defines the types of endpoint information that are included in connector jobs. The resource definition is specific to an explicitly declared endpoint in the Identity Manager data tree. Specify an endpoint before you assign any of its resources to a connector. This is reflected in the XML structure. The resource element can only appear as a child of an endpoint element.

When CA RCM polls endpoints, a single resource element in the connector definition usually generates a set of new resource entities in CA RCM. When CA RCM updates endpoints, the field mapping of the connector determines how updated resource data modifies user accounts on the endpoint.

This element has the following format:

<resource 

description="description"
resource-class="resource-class"
resource-name-attribute="resource-name-attribute"
resource-referenced-attribute="resource-referenced-attribute"
resource-appears-in-attribute="resource-appears-in-attribute"
ignore-problematic-resources="ignore-problematic-resources"
>
<value name="name" />
...
<value />
<constant-link value="value" />
<replace-in-links pattern="pattern" new-value="new-value" />

</resource>

This element contains the following attributes and child elements:

• description

  Defines the text mapped to the res_name_3 field of new CA RCM resource records that are based on this resource definition.

• resource-class

  Defines the object class representing this resource type in the provisioning directory.

• resource-name-attribute

  Defines the attribute of the object class that indicates the DN of the resource.

• resource-referenced-attribute

  Defines the attribute of the resource by which an account object references this type of resource object. This attribute defines how a resource is assigned to user accounts.

• resource-appears-in-attribute

  Defines the attribute of the account object that contains a reference to this object. This attribute defines how a resource is assigned to user accounts.

• ignore-problematic-resources

  Specifies data polling behavior if an included data resource cannot be retrieved. Valid values are as follows:

  • true—the connector job continues.
  • false—the connector job is aborted.

Important! We recommend not changing the following advanced parameters:

• resource-type

  Specifies the type of the resource. Valid values are as follows:

  • LDAP_OBJECT
  • CONSTANT_LIST—requires a list of value elements.
• value

  Defines a specific named resource to include in the connector. This child element is used with the resource type attribute to define a fixed list of resources.

• constant-link

  Defines a reference to a specific resource that is automatically added to every account.

• replace-in-links

  Defines automatic replacement of text strings in resource DN references written to accounts.

• resource-reference-level

  Defines the number of levels in the provisioning tree to include in resource references.