DeleteControl DataObject

DeleteControl especifica si se deben suprimir los descendientes, si existen, de una entidad suprimida.

DeleteControl se utiliza para especificar si deben suprimirse los descendientes existentes de una entidad que se está suprimiendo.

La estructura de un objeto de datos DeleteControl está formada por los elementos siguientes:
deleteDescendants
se utiliza para indicar si deben suprimirse o no los descendientes de la entidad, si tiene descendientes. Si esta propiedad se establece en true, se suprime la entidad y todos sus descendientes. Si la propiedad se establece en false, se emite una excepción si la entidad tiene algún descendiente. El valor predeterminado es false (falso).
returnDeleted
se utiliza para indicar si deben devolverse las entidades que se han suprimido realmente en el objeto de datos de salida. El valor predeterminado es false, que significa que no se devuelve ningún objeto de datos de salida.

Definición de esquema XML

A continuación se proporciona la definición del esquema XML para el objeto de datos DeleteControl:
<xsd:complexType name="DeleteControl">
    <xsd:complexContent>
	<xsd:extension base="Control">
	    <xsd:attribute name="deleteDescendants" type="xsd:boolean" default="true"/>
	    <xsd:attribute name="returnDeleted" type="xsd:boolean" default="false"/>
	</xsd:extension>
    </xsd:complexContent>
	</xsd:complexType>

Objeto de datos de ejemplo

A continuación se proporciona un DeleteControl DataObject de ejemplo que no tiene definida la propiedad deleteDescendants. Puesto que el valor predeterminado es true, este objeto de datos se utiliza en la API de supresión para suprimir las entidades y todos sus descendientes:
<wim:Root>
    <wim:entities>
      <wim:identifier uniqueName="o=Sales,cn=users,dc=yourco,dc=com"/>
    </wim:entities>
    <wim:controls xsi:type="wim:DeleteControl" />
  </wim:Root>


Condiciones de uso | Comentarios