DeleteControl 数据对象

如果已删除实体的后代仍然存在,那么 DeleteControl 指定是否要将它们一同删除。

DeleteControl 用于指定是否删除要删除的实体的任何现有后代。

DeleteControl 数据对象的结构包含:
deleteDescendants
用于指示是否删除实体的后代(如有)。如果此属性设置为 true,那么将删除实体及其所有后代。如果此属性设置为 false,那么当实体具有任何后代时将抛出异常。缺省值为 false。
returnDeleted
用于指示是否在输出数据对象中返回实际删除的实体。缺省值为 false,表示不返回任何输出数据对象。

XML 模式定义

以下是 DeleteControl 数据对象的 XML 模式定义:
<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>

样本数据对象

以下是未定义属性 deleteDescendants 的样本 DeleteControl 数据对象。由于缺省值为 true,因此此数据对象在 delete API 中用于删除实体及其所有后代:
<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>


使用条款 | 反馈