Content Management Interoperability Services (CMIS) Version 1.1

2.2.4.17 deleteTree
Description: Deletes the specified folder object and all of its child- and descendant-objects.
Notes:
• A repository MAY attempt to delete child- and descendant-objects of the specified folder in any order.
• Any child- or descendant-object that the repository cannot delete MUST persist in a valid state in the
CMIS domain model.
• This service is not atomic.
• However, if deletesinglefiled is chosen and some objects fail to delete, then single-filed objects
are either deleted or kept, never just unfiled. This is so that a user can call this command again to
recover from the error by using the same tree.
2.2.4.17.1 Inputs
Required:
• Id repositoryId: The identifier for the repository.
• Id folderId: The identifier of the folder to be deleted.
Optional:
• Boolean allVersions: If TRUE (default), then delete all versions of all documents. If FALSE,
delete only the document versions referenced in the tree. The repository MUST ignore the value of this
parameter when this service is invoked on any non-document objects or non-versionable document
objects.
• Enum unfileObjects: An enumeration specifying how the repository MUST process file-able
child- or descendant-objects. Valid values are:
unfile Unfile all fileable objects.
deletesinglefiled Delete all fileable non-folder objects whose only parent-folders are in the current
folder tree. Unfile all other fileable non-folder objects from the current folder tree.
delete (default) Delete all fileable objects.
• Boolean continueOnFailure: If TRUE, then the repository SHOULD continue attempting to perform
this operation even if deletion of a child- or descendant-object in the specified folder cannot be
deleted.
If FALSE (default), then the repository SHOULD abort this method when it fails to delete a single child
object or descendant object.
2.2.4.17.2 Outputs
• Id failedToDelete: A list of identifiers of objects in the folder tree that were not deleted.
2.2.4.17.3 Exceptions Thrown & Conditions
• See section 2.2.1.4.1 General Exceptions.
• constraint If the method is invoked on a non-folder object.
• updateConflict See section 2.2.1.4.2 Specific Exceptions.
CMIS-v1.1-csprd01
Standards Track Work Product
Copyright © OASIS Open 2012. All Rights Reserved.
18 August 2012
Page 172 of 331