Previous Topic: endpoint Element

Next Topic: Connector for Identity Manager Limitations with Active Directory

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:

Important! We recommend not changing the following advanced parameters:

resource-type

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

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.