DeleteControl indique s'il faut supprimer les descendants, s'ils existent, d'une entité supprimée.
DeleteControl permet d'indiquer s'il faut supprimer des descendants existants
d'une entité qui est supprimée.
La
structure d'un objet de données DeleteControl se compose des éléments suivants :
- deleteDescendants
- permet
d'indiquer s'il faut ou non supprimer les descendants de l'entité, si elle
compte des descendants. Si cette propriété est définie sur True, l'entité et
tous ses descendants sont supprimés. Si cette propriété est définie
sur False, une exception est émise si l'entité a des descendant.
Par
défaut, la valeur est définie sur False.
- returnDeleted
- permet d'indiquer s'il faut retourner les entités qui sont réellement
supprimées de l'objet de données de sortie. La valeur par défaut est définie
sur False, ce qui signifie qu'aucun objet de données de sortie n'est retourné.
Définition de schéma XML
Vous
trouverez ci-dessous la définition du schéma XML pour l'objet de données
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>
Objet de données exemple
Voici
un exemple d'objet de données DeleteControl sans aucune propriété
deleteDescendants de définie. La valeur étant définie par défaut sur True, cet
objet de données est utilisé dans l'interface de programme d'application de suppression
pour supprimer les entités et tous leurs descendants :
<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>