# instance

<instance> is used to represent an object in eDirectory or the application as part of the response to a <query> command or a <query-ex> command. <instance> does not necessarily represent the complete state of object, but rather just the information requested by the <query> or <query-ex>.

When returned from a driver, an <association> is required.

Example

>     <instance class-name="User" src-dn="\Users\Samuel">
>      <association>1012</association>
>      <attr attr-name="Surname">
>       <value>Jones</value>
>      </attr>
>      <attr attr-name="cn">
>       <value>Samuel</value>
>      </attr>
>      <attr attr-name="Given Name">
>       <value>Samuel</value>
>      </attr>
>      <attr attr-name="Telephone Number">
>       <value>555-1212</value>
>       <value>555-1764</value>
>      </attr>
>     </instance>

## 1. Allowed Content

> association
>   Unique key of the application object.
> parent
>   The parent/container of an object.
> attr
>   Current state of an attribute.
> operation-data
>   Operation additional custom data.

## 2. Attributes

> Attribute | Value(s) | Default Value
> --- | --- | ---
> class-name | CDATA The name of the base class of the object. The class name is mapped between the application and eDirectory name spaces by the schema mapping rule so that DirXML will see the name in the eDirectory namespace and a driver will see the name in the application name space. | #REQUIRED
> event-id | CDATA An identifier used to tag the results of an event or command. | #IMPLIED
> qualified-src-dn | CDATA The qualified version of src-dn. Only used for describing objects from eDirectory. | #IMPLIED
> src-dn | CDATA The distinguished name of source object that generated the event in the namespace of the sender. | #IMPLIED
> src-entry-id | CDATA The entry id of source object that generated the event in the namespace of the sender. (Reserved) Should be ignored by the driver. | #IMPLIED

## 3. Content Rule

> ( association ? , parent ? , attr * , operation-data ? )

## 4. Parent Elements

> output
>   Results of events or commands.

Top Elements || All Elements || Tree