Microsoft Identity Integration Server 2003 Developer Reference

cs-object

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"
cs-dn The distinguished name of the object in the connector space. 

	id = "guid"
id The globally unique id of the object in the connector space. 

	transient = "0 | 1"
transient 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 = "Any character string."
object-type The type of the object. This attribute is management agent–specific. 

	status = "Any character string."
status 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. 

/>

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 Any character string. No The type of the object. This attribute is management agent–specific.
status Any 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
<transient-dn> The distinguished name of the transient object. This element is present only if the transient attribute is 1.
<transient-details> Information about 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.
<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.
<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.
<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.
<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.
<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.
<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.
<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.
<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.
<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.
<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.
<import-errordetail> Information about the last import error.
<export-errordetail> Information about the last export error.
<cs-mv-links> Information about the metaverse objects to which this object is associated.
<disconnection-type> The type of disconnector object. Disconnector objects are not linked to a metaverse object.
<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.
<last-import-delta-time> The date and time when the last import delta was run.
<last-export-delta-time> The date and time when the last export delta was run.
<password-change-history> Information about one or more password change events.
<fully-qualified-domain-name> The fully qualified domain name of the object.
<domain-name> The domain name of the object.
<account-name> The name of the account associated with this object.
<user-principal-name> The name of the user principal associated with this object.
<partition-name> The name of the partition.

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
<transient-dn> The distinguished name of the transient object. This element is present only if the transient attribute is 1. 
 (Minimum = 0; Maximum = 1)
	transient-details
<transient-details> Information about the transient object. This element is present only if the transient attribute is 1. 
 (Minimum = 0; Maximum = 1)
	unapplied-export
<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. 
 (Minimum = 0; Maximum = 1)
	escrowed-export
<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. 
 (Minimum = 0; Maximum = 1)
	unconfirmed-export
<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. 
 (Minimum = 0; Maximum = 1)
	pending-import
<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. 
 (Minimum = 0; Maximum = 1)
	synchronized-hologram
<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. 
 (Minimum = 0; Maximum = 1)
	unapplied-export-hologram
<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. 
 (Minimum = 0; Maximum = 1)
	escrowed-export-hologram
<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. 
 (Minimum = 0; Maximum = 1)
	unconfirmed-export-hologram
<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. 
 (Minimum = 0; Maximum = 1)
	pending-import-hologram
<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. 
 (Minimum = 0; Maximum = 1)
	connector
<connector> Whether the object is a connector. This element is present only when a synchronization tower is present. 
 (Exactly 1)
	connector-state
<connector-state> The state of the object, if it is a connector. This element is present only when a synchronization tower is present. 
 (Exactly 1)
	sequencers
<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. 
 (Exactly 1)
	import-errordetail
<import-errordetail> Information about the last import error. 
 (Minimum = 0; Maximum = 1)
	export-errordetail
<export-errordetail> Information about the last export error. 
 (Minimum = 0; Maximum = 1)
	cs-mv-links

 (Exactly 1)
	disconnection-type
<disconnection-type> The type of disconnector object. Disconnector objects are not linked to a metaverse object. 
 (Exactly 1)
	disconnection-id
<disconnection-id> A globally unique identifier for the disconnector object. 
 (Minimum = 0; Maximum = 1)
	disconnection-time
<disconnection-time> The date and time when the object was created as a disconnector object. 
 (Exactly 1)
	last-import-delta-time
<last-import-delta-time> The date and time when the last import delta was run. 
 (Exactly 1)
	last-export-delta-time
<last-export-delta-time> The date and time when the last export delta was run. 
 (Exactly 1)
	password-change-history
<password-change-history> Information about one or more password change events. 
 (Exactly 1)
	fully-qualified-domain-name
<fully-qualified-domain-name> The fully qualified domain name of the object. 
 (Minimum = 0; Maximum = 1)
	domain-name
<domain-name> The domain name of the object. 
 (Minimum = 0; Maximum = 1)
	account-name
<account-name> The name of the account associated with this object. 
 (Minimum = 0; Maximum = 1)
	user-principal-name
<user-principal-name> The name of the user principal associated with this object. 
 (Minimum = 0; Maximum = 1)
	partition-name
<partition-name> The name of the partition. 
 (Minimum = 0; Maximum = 1)
Sequence

Element Information

Can be empty No