cs-object Element

Article
02/16/2009

The <cs-object> element 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 Microsoft Identity Integration Server 2003 must calculate the specific state of an object or to update delta information.

Usage

<cs-object
    cs-dn = "dn"
    id = "guid"
    transient = "0 | 1"
    object-type = "Any character string"
    status = "Any character string"
/>

Attributes

Attribute	Type	Required	Description
cs-dn	dn	Yes	The distinguished name of the object in the connector space.
id	guid	Yes	The globally unique id of the object in the connector space.
transient	0 \| 1	No	Whether this object has the same distinguished name as another object in the connector space, but a different anchor. "1" implies true, "0" implies false. Typically this object is going to be renamed or deleted.
object-type	character string	No	The type of the object. This attribute is management agent–specific.
status	character string	No	If "corrupted", the object is corrupted. In most cases, the synchronization engine will attempt to recover by throwing away its deltas and, possibly, its hologram.

Child Elements

Element	Description
<account-name>	The name of the account associated with this object.
<connector>	Whether the object is a connector. This element is present only when a synchronization tower is present.
<connector-state>	The state of the object, if it is a connector. This element is present only when a synchronization tower is present.
<cs-mv-links>	Information about the metaverse objects to which this object is associated.
<disconnection-id>	A globally unique identifier for the disconnector object.
<disconnection-time>	The date and time when the object was created as a disconnector object.
<disconnection-type>	The type of disconnector object. Disconnector objects are not linked to a metaverse object.
<domain-name>	The domain name of the object.
<escrowed-export>	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>	Information about the object if all of the exports that are in progress are applied to the object. This element is present only when a synchronization tower is present.
<export-errordetail>	Information about the last export error.
<fully-qualified-domain-name>	The fully qualified domain name of the object.
<import-errordetail>	Information about the last import error.
<last-export-delta-time>	The date and time when the last export delta was run.
<last-import-delta-time>	The date and time when the last import delta was run.
<partition-name>	The name of the partition.
<password-change-history>	Information about one or more password change events.
<pending-import>	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>	Information about the object that has been imported into Microsoft Identity Integration Server 2003 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.
<sequencers>	Identifies when a change is staged on the object that needs to be exported to the connected directory. This element is present only when a synchronization tower is present.
<synchronized-hologram>	Information about the object that reflects all imports that have been successfully run through the synchronization process. This element is present only when a synchronization tower is present.
<transient-details>	Information about the transient object. This element is present only if the transient attribute is "1".
<transient-dn>	The distinguished name of the transient object. This element is present only if the transient attribute is "1".
<unapplied-export>	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>	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>	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>	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>	The name of the user principal associated with this object.

Parent Elements

Element
<cs-objects>

Child Element Sequence

The tree shows the ordering and number of child elements. Child elements in a Sequence must appear in the order given and child elements in a Choice are mutually exclusive. Sequences and Choices can be nested. Element names are followed by the minimum and maximum occurrences.

Sequence
    transient-dn (Minimum = 0; Maximum = 1)
    transient-details (Minimum = 0; Maximum = 1)
    unapplied-export (Minimum = 0; Maximum = 1)
    escrowed-export (Minimum = 0; Maximum = 1)
    unconfirmed-export (Minimum = 0; Maximum = 1)
    pending-import (Minimum = 0; Maximum = 1)
    synchronized-hologram (Minimum = 0; Maximum = 1)
    unapplied-export-hologram (Minimum = 0; Maximum = 1)
    escrowed-export-hologram (Minimum = 0; Maximum = 1)
    unconfirmed-export-hologram (Minimum = 0; Maximum = 1)
    pending-import-hologram (Minimum = 0; Maximum = 1)
    connector (Exactly 1)
    connector-state (Exactly 1)
    sequencers (Exactly 1)
    import-errordetail (Minimum = 0; Maximum = 1)
    export-errordetail (Minimum = 0; Maximum = 1)
    cs-mv-links (Exactly 1)
    disconnection-type (Exactly 1)
    disconnection-id (Minimum = 0; Maximum = 1)
    disconnection-time (Exactly 1)
    last-import-delta-time (Exactly 1)
    last-export-delta-time (Exactly 1)
    password-change-history (Exactly 1)
    fully-qualified-domain-name (Minimum = 0; Maximum = 1)
    domain-name (Minimum = 0; Maximum = 1)
    account-name (Minimum = 0; Maximum = 1)
    user-principal-name (Minimum = 0; Maximum = 1)
    partition-name (Minimum = 0; Maximum = 1)
Sequence

Element Information

Can be empty

Send comments about this topic to Microsoft

Build date: 2/16/2009

Partager via