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>