Description

All XML documents sent as a request operation or returned as a response to that operation must use <nds> as the top level element in the document. In addition, these documents may contain exactly one <input> element or exactly one <output> element, not both. The <source> element is optional.

Definition

  <!ELEMENT nds (source?, (input | output))>
  <!ATTLIST nds 
            ndsversion     CDATA          #REQUIRED
            dtdversion     CDATA          #REQUIRED >
  
  <!ELEMENT source (product?, contact?)>
  
  <!ELEMENT product (#PCDATA)>
  <!ATTLIST product 
            version        CDATA          #IMPLIED 
            asn1id         CDATA          #IMPLIED>
  
  <!ELEMENT contact (#PCDATA)>
  

Attributes of <nds>

ndsversion

Specifies the current version of eDirectory. It must be set to 8.5 or higher.

dtdversion

Specifies the current version of DirXML. It must be set to 1.0.

Elements

source

Specifies the source that created the XML document.

input

Specifies the operations to perform. The document can contain only one <input> element, and if it contains an <input> element, it cannot contain an <output> element.

output

Specifies the results of an operation. The document can contain only one <output> element, and if it contains an <output> element, it cannot contain an <input> element.

Parent

• None

Example

The DirXML engine sends the following:

  <nds dtdversion="1.0" ndsversion="8.5">
     <source>
        <product asn1id="2 16 840 1 113719 1 x" version="1.0b3">DirXML</product>
        <contact>Novell, Inc.</contact>
     </source>
     <input>
        <modify class-name="User" event-id="0" src-dn="\ATREE\Users\Julia" 
                src-entry-id="33967">
           <association state="associated">{B43E7155-CDF9-d311-9846-0008C76B
                16C2}</association>
           <modify-attr attr-name="Surname">
              <add-value>
                 <value type="string">Gulia</value>
              </add-value>
           </modify-attr>
        </modify>
     </input>
  </nds>
  
  

The driver returns the following

  <nds dtdversion="1.0" ndsversion="8.5">
     <source>
        <product version="1.0b3">Some Application Driver</product>
           <contact>Nobody in particular</contact>
     </source>
     <output>
        <status event-id="0" level="success"/>
     </output>
  </nds>