<cs-object>

Article
06/16/2010

Contains information about a single object in the connector space. In many cases, an element is present only when a synchronization tower is present. The synchronization tower is built in memory whenever Forefront Identity Manager Synchronization Service (FIM Synchronization Service) must calculate the specific state of an object or update delta information.

Schema Hierarchy

<cs-objects>

Syntax

<cs-object>
  <transient-dn>
  </transient-dn>
  <transient-details>
  </transient-details>
  <unapplied-export>
  </unapplied-export>
  <escrowed-export>
  </escrowed-export>
  <unconfirmed-export>
  </unconfirmed-export>
  <pending-import>
  </pending-import>
  <synchronized-hologram>
  </synchronized-hologram>
  <unapplied-export-hologram>
  </unapplied-export-hologram>
  <escrowed-export-hologram>
  </escrowed-export-hologram>
  <unconfirmed-export-hologram>
  </unconfirmed-export-hologram>
  <pending-import-hologram>
  </pending-import-hologram>
  <connector>
  </connector>
  <connector-state>
  </connector-state>
  <sequencers>
  </sequencers>
  <pending-ref-delete>
  </pending-ref-delete>
  <import-errordetail>
  </import-errordetail>
  <export-errordetail>
  </export-errordetail>
  <cs-mv-links>
  </cs-mv-links>
  <disconnection-type>
  </disconnection-type>
  <disconnection-id>
  </disconnection-id>
  <disconnection-time>
  </disconnection-time>
  <last-import-delta-time>
  </last-import-delta-time>
  <last-export-delta-time>
  </last-export-delta-time>
  <fully-qualified-domain-name>
  </fully-qualified-domain-name>
  <domain-name>
  </domain-name>
  <account-name>
  </account-name>
  <user-principal-name>
  </user-principal-name>
  <partition-name>
  </partition-name>
</cs-object>

element

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Type	Required	Description
cs-dn	dn	yes	Contains the distinguished name of the object in the connector space.
id	guid	yes	Contains the globally unique identifier of the object in the connector space.
object-type	string	no	Indicates the type of the object. This attribute is management agent–specific.
status	string	no	If the value is "corrupted", the object is corrupted. In most cases, the synchronization engine tries to recover by throwing away its deltas and, possibly, its hologram.
transient	0 \| 1	no	Indicates whether this object has the same distinguished name as another object in the connector space, but a different anchor. A value of 1 implies true, and a value of 0 implies false. Typically this object is renamed or deleted.

Child Elements

Element	Min Occurs	Max Occurs	Description
<account-name>	0	1	Contains the name of the account that is associated with this object.
<connector>	1	1	Indicates whether the object is a connector. This element is present only when a synchronization tower is present.
<connector-state>	1	1	Indicates the state of the object, if it is a connector. This element is present only when a synchronization tower is present.
<cs-mv-links>	1	1	Contains information about the metaverse objects to which this object is associated.
<disconnection-id>	0	1	Contains a globally unique identifier for the disconnector object.
<disconnection-time>	1	1	Contains the date and time of when the object was created as a disconnector object.
<disconnection-type>	1	1	Indicates the type of disconnector object. Disconnector objects are not linked to a metaverse object.
<domain-name>	0	1	Indicates the domain name of the object.
<escrowed-export>	0	1	Contains information about the difference between the <unconfirmed-export-hologram> element and the <escrowed-export-hologram> element. This element is present only when a synchronization tower is present.
<escrowed-export-hologram>	0	1	Contains information about the object if all the exports that are in progress are applied to the object. This element is present only when a synchronization tower is present.
<export-errordetail>	0	1	Contains information about the last export error.
<fully-qualified-domain-name>	0	1	Contains the fully qualified domain name of the object.
<import-errordetail>	0	1	Contains information about the last import error.
<last-export-delta-time>	1	1	Contains the date and time of when the last export delta was run.
<last-import-delta-time>	1	1	Contains the date and time of when the last import delta was run.
<partition-name>	0	1	Contains the name of the partition.
<password-change-history>	1	1	Contains information about one or more password change events.
<pending-import>	0	1	Contains information about the difference between the <synchronized-hologram> element and the <pending-import-hologram> element. This element is present only when a synchronization tower is present.
<pending-import-hologram>	0	1	Contains information about the object that has been imported into FIM Synchronization Service from a full or delta import run profile, but it has not yet been synchronized with the metaverse and subjected to synchronization rules. This element is present only when a synchronization tower is present.
<pending-ref-delete>			Indicates whether a deletion that is scheduled for a referenced object is awaiting confirmation.
<sequencers>	1	1	Identifies when a change is staged on the object that must be exported to the connected directory. This element is present only when a synchronization tower is present.
<synchronized-hologram>	0	1	Contains information about the object that reflects all imports that are successfully run through the synchronization process. This element is present only when a synchronization tower is present.
<transient-details>	0	1	Contains information about the transient object. This element is present only if the transient attribute is 1.
<transient-dn>	0	1	Contains the distinguished name of the transient object. This element is present only if the transient attribute is 1.
<unapplied-export>	0	1	Contains information about the difference between the <synchronized-hologram> element and the <unapplied-export-hologram> element. This element is present only when a synchronization tower is present.
<unapplied-export-hologram>	0	1	Contains information about the object if all the exports from the metaverse are successfully applied to the connector space object, but have not yet been sent to the connected data source. This element is present only when a synchronization tower is present.
<unconfirmed-export>	0	1	Contains information about the difference between the <pending-import-hologram> element and the <unconfirmed-export-hologram> element. This element is present only when a synchronization tower is present.
<unconfirmed-export-hologram>	0	1	Contains information about the object that has been sent to the connected data source, but has not yet been imported again. This element is present only when a synchronization tower is present.
<user-principal-name>	0	1	Indicates the name of the user principal that is associated with this object.

Parent Elements

Element	Description
<cs-objects>	Contains information about the objects of a management agent in the connector space.