Content Management Interoperability Services (CMIS) Version 1.1

2.2.4.14 bulkUpdateProperties
Description: Updates properties and secondary types of one or more objects.
Notes:
• A repository MAY automatically create new document versions as part of an update properties operation.
Therefore, the objectId output NEED NOT be identical to the objectId input.
• Only properties whose values are different than the original value of the object SHOULD be provided.
• This service is not atomic. If the update fails, some objects might have been updated and others might
not have been updated.
• This service MUST NOT throw an exception if the update of an object fails. If an update fails, the
object id of this particular object MUST be omitted from the result.
2.2.4.14.1 Inputs
Required:
• Id repositoryId: The identifier for the repository.
• objectIdAndChangeToken: The identifiers of the objects to be updated and
their change tokens. Invalid object ids, for example ids of objects that don't exist, MUST be ignored.
Optional:
Change tokens are optional. See section 2.2.1.3 Change Tokens.
The updated property values that MUST be applied to the ob-
• Properties properties:
jects.
• Id addSecondaryTypeIds:
objects.
A list of secondary type ids that SHOULD be added to the
• Id removeSecondaryTypeIds: A list of secondary type ids that SHOULD be removed from
the objects. Secondary type ids in this list that are not attached to an object SHOULD be ignored.
2.2.4.14.2 Outputs
• objectIdAndChangeToken:
of:
A triple for each updated object composed
1. The original object id. MUST always be set.
2. The new object id if the update triggered a new version. MUST NOT be set if no new version has
been created.
3. The new change token of the object. MUST be set if the repository supports change tokens.
Objects that have not been updated MUST NOT be returned. This service does not disclose why
updates failed. Clients may call updateProperties for each failed object to retrieve individual exceptions.
2.2.4.14.3 Exceptions Thrown & Conditions
• See section 2.2.1.4.1 General Exceptions.
• invalidArgument If the input list of object ids is empty.
• invalidArgument If secondary type ids are provided that don't exist in the repository.
• constraint If the number of objects is too high for the repository.
CMIS-v1.1-csprd01
Standards Track Work Product
Copyright © OASIS Open 2012. All Rights Reserved.
18 August 2012
Page 169 of 331