com.tsgrp.opencontent.alfresco.content

Class AlfrescoEmbContentImpl

java.lang.Object

com.tsgrp.opencontent.core.content.AbstractContentImpl

com.tsgrp.opencontent.alfresco.content.AlfrescoEmbContentImpl

All Implemented Interfaces:

IContent

public class AlfrescoEmbContentImpl
extends AbstractContentImpl

Service that provides content access and manipulation methods.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.alfresco.service.namespace.QName	renditionQName The QName to use when looking for the rendition property on a node.

Fields inherited from class com.tsgrp.opencontent.core.content.AbstractContentImpl

ocPolicyComponent

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AlfrescoEmbContentImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	addRelation(AddRelationRequest req) ALFRESCO NOTE: when you call addRelation for an object that has a working copy (source only), the relationship will be added to the Working Copy (source only).
void	applyAspect(java.lang.String ticket, java.lang.String objectId, java.lang.String aspectType, java.util.Map<java.lang.String,java.lang.Object> mandatoryProperties) Adds an aspect to a document.
boolean	cancelCheckout(java.lang.String ticket, java.lang.String objectId) Cancels checkout of document.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion) Deprecated.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion, OpenContentObject object, boolean newVersion, javax.activation.DataHandler dataHandler) Checks in a node to the repository.
ContentResult	checkin(java.lang.String ticket, java.lang.String objectId, boolean keepLock, java.lang.String versionLabels, java.lang.String comment, boolean majorVersion, OpenContentObject object, boolean newVersion, java.lang.Long size, javax.activation.DataHandler dataHandler) Checks in a node to the repository.
boolean	checkout(java.lang.String ticket, java.lang.String objectId) Checks out a document.
ContentResult	copyDocument(java.lang.String ticket, java.lang.String id, java.lang.String copyName) Returns objectId for the given copied document only, no content returned.
java.lang.String	createObject(java.lang.String ticket, CompleteObject object) Imports document content and properties to the repository.
boolean	deleteObjects(java.lang.String ticket, java.lang.String[] objectIds, boolean allVersions) Deletes objects in the content store.
ContentResult	doEnhancedCreateObject(java.lang.String ticket, EnhancedCompleteObject object)
ContentResult	doEnhancedDeleteObject(java.lang.String ticket, java.lang.String id, boolean allVersions, boolean forceDelete)
ContentResult	doEnhancedUpdateObject(java.lang.String ticket, java.lang.String id, EnhancedCompleteObject object, boolean newVersion, boolean majorVersion) handles the special case of our tsg:controlledDocument minor versioning with a new document
OpenContentObject	doUpdateObject(java.lang.String ticket, OpenContentObject oco)
ContentResult	enhancedGetObject(java.lang.String ticket, java.lang.String id, java.lang.String[] fileExtensionArr) Retrieves document content and properties.
ContentResult	enhancedGetObjectByPath(java.lang.String ticket, java.lang.String path, java.lang.String[] fileExtensionArr)
ContentResult	enhancedGetPathByFolderId(java.lang.String ticket, java.lang.String objectId) Obtain folder path by passing in folder ID
ContentResult	enhancedGetProperties(java.lang.String ticket, java.lang.String id) Returns metadata for the given id only, no content returned.
ContentResult	forceDelete(org.alfresco.service.cmr.repository.NodeRef nodeRef, ContentResult result)
java.util.List<java.lang.String>	getAppliedAspects(java.lang.String ticket, java.lang.String objectId) Retrieves a list of aspects applied to the provided objectId.
ObjectContent	getContent(GetContentRequest request) Retrieves the content of a repository object.
UserResult	getLockOwner(java.lang.String ticket, java.lang.String objectId) Returns a UserResult.
OpenContentObject	getObjectByPath(java.lang.String ticket, java.lang.String path) Obtain object by passing its path WARNING: This method opens an InputStream.
OpenContentObject	getObjectByPath(java.lang.String ticket, java.lang.String path, boolean quietMode) Obtain object by passing its path This accepts a 'quietMode' parameter that will not throw an error if the object doesn't exist at that path.
ContentResult	getObjectByVersion(java.lang.String ticket, java.lang.String id, java.lang.String versionLabel, java.lang.String[] fileExtensionArr) Obtain object for a specific version
ObjectContent	getObjectContent(GetContentRequest request, boolean provideContentStream)
int	getPermissionsRequest(java.lang.String ticket, java.lang.String objectId) Retrieves permissions set on document.
java.util.ArrayList<java.lang.String>	link(java.lang.String ticket, java.lang.String childId, java.lang.String[] unLinkFrom, java.lang.String[] linkTo) Creates a link request between document and folders.
java.lang.String	lockDocument(java.lang.String ticket, java.lang.String objectId) Locks a document.
void	moveObject(java.lang.String ticket, java.lang.String objectId, java.lang.String parentPathOrId) Moves an object in the repository from one folder to another.
ContentResult	removeRelation(java.lang.String ticket, java.lang.String parentObjectId, java.lang.String[] childIds, java.lang.String relationName) ALFRESCO NOTE: when you call removeRelation for an object that has a working copy (source ONLY), the relationship will be removed from the Working Copy AND the original node.
void	setRenditionQName(java.lang.String renditionQName) Used to set the QName to use when looking for the rendition property on a node.
java.lang.String	unlockDocument(java.lang.String ticket, java.lang.String objectId) Unlocks out a document.
java.lang.String	updateObject(java.lang.String ticket, java.lang.String objectId, CompleteObject object, boolean newVersion, boolean majorVersion) Updates existing document object in the repository.
OpenContentObject[]	updateObjects(java.lang.String ticket, OpenContentObject[] ocos) Updates the objects with the same IDs as provided objects.

Methods inherited from class com.tsgrp.opencontent.core.content.AbstractContentImpl

bulkEnhancedCreateObjects, bulkEnhancedCreateObjects, enhancedCreateObject, enhancedCreateObject, enhancedDeleteObject, enhancedDeleteObject, enhancedUpdateObject, enhancedUpdateObject, generatePresignedUrl, getObject, setOcPolicyComponent, updateObject

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

renditionQName

protected org.alfresco.service.namespace.QName renditionQName

The QName to use when looking for the rendition property on a node. The default is tsg:rendition.

Constructor Detail

AlfrescoEmbContentImpl

protected AlfrescoEmbContentImpl()

Method Detail

setRenditionQName

public void setRenditionQName(java.lang.String renditionQName)

Used to set the QName to use when looking for the rendition property on a node. Set the renditionQName property on your bean with the id "content" to the value that should be used for the rendition QName or leave it out to use the default of tsg:rendition.

Parameters:

renditionQName - the string representation of the QName to use for the rendition property for a node.

addRelation

public java.lang.String[] addRelation(AddRelationRequest req)

ALFRESCO NOTE: when you call addRelation for an object that has a working copy (source only), the relationship will be added to the Working Copy (source only).

Parameters:

req - an AddRelationRequest object

Returns:

an array of IDs of relation objects added by this method

See Also:

IContent.addRelation(com.tsgrp.opencontent.core.content.model.AddRelationRequest)

lockDocument

public java.lang.String lockDocument(java.lang.String ticket,
                                     java.lang.String objectId)

Description copied from interface: IContent

Locks a document.

Returns:

String

null if the document is already locked.

See Also:

IContent.lockDocument(java.lang.String, java.lang.String)

unlockDocument

public java.lang.String unlockDocument(java.lang.String ticket,
                                       java.lang.String objectId)

Description copied from interface: IContent

Unlocks out a document.

Returns:

String

null if the document is already locked.

See Also:

IContent.unlockDocument(java.lang.String, java.lang.String)

cancelCheckout

public boolean cancelCheckout(java.lang.String ticket,
                              java.lang.String objectId)

Description copied from interface: IContent

Cancels checkout of document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

true if the operation was successful, otherwise false. Note that this method returns true if the object is not locked.

See Also:

IContent.cancelCheckout(java.lang.String, java.lang.String)

checkin

@Deprecated
public ContentResult checkin(java.lang.String ticket,
                                          java.lang.String objectId,
                                          boolean keepLock,
                                          java.lang.String versionLabels,
                                          java.lang.String comment,
                                          boolean majorVersion)

Deprecated.

Description copied from interface: IContent

Checks in a node to the repository.

Parameters:

ticket - a valid OC ticket.

objectId - the objectId of the object to check in.

keepLock - whether to keep the lock or release it after the checkin is complete.

versionLabels - the version lable of the document that will be checked in.

comment - the comment for checking in the document.

majorVersion - true if the document should become a major version on checkin.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• objectId returns ID of the object checked in

checkin

public ContentResult checkin(java.lang.String ticket,
                             java.lang.String objectId,
                             boolean keepLock,
                             java.lang.String versionLabels,
                             java.lang.String comment,
                             boolean majorVersion,
                             OpenContentObject object,
                             boolean newVersion,
                             java.lang.Long size,
                             javax.activation.DataHandler dataHandler)

Description copied from interface: IContent

Checks in a node to the repository. Overloaded for impls that require size

Parameters:

ticket - a valid OC ticket.

objectId - the objectId of the object to check in.

keepLock - whether to keep the lock or release it after the checkin is complete.

versionLabels - the version lable of the document that will be checked in.

comment - the comment for checking in the document.

majorVersion - true if the document should become a major version on checkin.

object - the object to use for setting new property values on checkin - NOTE: this is currently not implemented.

newVersion - whether this should be a new version or the same version.

size - the object size in bytes

dataHandler - the data handler containing the input stream for the new content of the checked in object.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• objectId returns ID of the object checked in

checkout

public boolean checkout(java.lang.String ticket,
                        java.lang.String objectId)

Description copied from interface: IContent

Checks out a document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

true if the checkout occurred successfully, otherwise false. Note, if the object is already checked out, this method will return false.

See Also:

IContent.checkout(java.lang.String, java.lang.String)

copyDocument

public ContentResult copyDocument(java.lang.String ticket,
                                  java.lang.String id,
                                  java.lang.String copyName)

Description copied from interface: IContent

Returns objectId for the given copied document only, no content returned.

Parameters:

ticket - String representing the session's ticket

id - id of the object we want to make a copy of

copyName - name of the newly copied object. If set to null or "", the name of the new object will be "Copy of ${original object's name}".

Returns:

• ContentResult
• error returns true if get object by version failed, otherwise false
• object contains the newly copied object

See Also:

IContent.copyDocument(java.lang.String, java.lang.String, java.lang.String)

createObject

public java.lang.String createObject(java.lang.String ticket,
                                     CompleteObject object)

Description copied from interface: IContent

Imports document content and properties to the repository. WARNING: This method opens an InputStream. You must close this in the calling method.

Parameters:

ticket - an authentication ticket

object - a CompleteObject obj

Returns:

the object ID of the newly created object

See Also:

IContent.createObject(java.lang.String, com.tsgrp.opencontent.core.content.model.CompleteObject)

deleteObjects

public boolean deleteObjects(java.lang.String ticket,
                             java.lang.String[] objectIds,
                             boolean allVersions)

Description copied from interface: IContent

Deletes objects in the content store.

Parameters:

ticket - an authentication ticket

objectIds - a list of object identifiers to delete

allVersions - if true, deletes all versions

Returns:

true if deletion of all objects was successful, otherwise false

See Also:

IContent.deleteObjects(java.lang.String, java.lang.String[], boolean)

doEnhancedCreateObject

public ContentResult doEnhancedCreateObject(java.lang.String ticket,
                                            EnhancedCompleteObject object)

Specified by:

doEnhancedCreateObject in class AbstractContentImpl

See Also:

IContent.enhancedCreateObject(java.lang.String, com.tsgrp.opencontent.core.content.enhanced.model.EnhancedCompleteObject)

doEnhancedDeleteObject

public ContentResult doEnhancedDeleteObject(java.lang.String ticket,
                                            java.lang.String id,
                                            boolean allVersions,
                                            boolean forceDelete)

Specified by:

doEnhancedDeleteObject in class AbstractContentImpl

See Also:

IContent.enhancedDeleteObject(java.lang.String, java.lang.String, boolean, boolean)

forceDelete

public ContentResult forceDelete(org.alfresco.service.cmr.repository.NodeRef nodeRef,
                                 ContentResult result)

enhancedGetObject

public ContentResult enhancedGetObject(java.lang.String ticket,
                                       java.lang.String id,
                                       java.lang.String[] fileExtensionArr)

Description copied from interface: IContent

Retrieves document content and properties. If you only need properties, use IContent.enhancedGetProperties(String, String) instead. Note that since this method gets both content and properties, calling code must close the ContentResult with OCUtil.closeQuietly(ContentResult).

Parameters:

ticket - String representing the session's ticket

id - ID of the object to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object contains the Object we are trying to get

See Also:

IContent.enhancedGetObject(java.lang.String, java.lang.String, java.lang.String[])

enhancedGetObjectByPath

public ContentResult enhancedGetObjectByPath(java.lang.String ticket,
                                             java.lang.String path,
                                             java.lang.String[] fileExtensionArr)

Parameters:

ticket - String representing the session's ticket

path - path to the object to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object contains the Object we are trying to get

See Also:

IContent.enhancedGetObjectByPath(java.lang.String, java.lang.String, java.lang.String[])

enhancedGetPathByFolderId

public ContentResult enhancedGetPathByFolderId(java.lang.String ticket,
                                               java.lang.String objectId)

Description copied from interface: IContent

Obtain folder path by passing in folder ID

Parameters:

ticket - String representing the session's ticket

objectId - id of the folder to get path from

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• ContentResult.result contains the folder path we are trying to get

See Also:

IContent.enhancedGetPathByFolderId(java.lang.String, java.lang.String)

enhancedGetProperties

public ContentResult enhancedGetProperties(java.lang.String ticket,
                                           java.lang.String id)

Description copied from interface: IContent

Returns metadata for the given id only, no content returned.

Parameters:

ticket - String representing the session's ticket

id - ID of the object to get properties from

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• object
• objectType - repo specific object type
• props - metadata for object

See Also:

IContent.enhancedGetProperties(java.lang.String, java.lang.String)

doEnhancedUpdateObject

public ContentResult doEnhancedUpdateObject(java.lang.String ticket,
                                            java.lang.String id,
                                            EnhancedCompleteObject object,
                                            boolean newVersion,
                                            boolean majorVersion)

handles the special case of our tsg:controlledDocument minor versioning with a new document

Specified by:

doEnhancedUpdateObject in class AbstractContentImpl

See Also:

IContent.enhancedUpdateObject(java.lang.String, java.lang.String, com.tsgrp.opencontent.core.content.enhanced.model.EnhancedCompleteObject, boolean, boolean)

getObjectContent

public ObjectContent getObjectContent(GetContentRequest request,
                                      boolean provideContentStream)

Parameters:

request - Request contains content needed. Ex. ticket, objectId, fileExtensions

provideContentStream - Boolean that determines whether or not to return a InputStream with the content

Returns:

ObjectContent object that contains the node's content

getContent

public ObjectContent getContent(GetContentRequest request)

Description copied from interface: IContent

Retrieves the content of a repository object. Note that if you do not set the content type using GetContentRequest.setFileExtension(String[]) this method will attempt to return the PDF rendition first, and then the native content if a PDF rendition does not exist. Note - when using this method, the InputStream contained within ObjectContent.getContent() must be closed after use.

Parameters:

request - a GetContentRequest object

Returns:

ObjectContent - the content of the object

See Also:

IContent.getContent(com.tsgrp.opencontent.core.content.model.GetContentRequest)

getObjectByVersion

public ContentResult getObjectByVersion(java.lang.String ticket,
                                        java.lang.String id,
                                        java.lang.String versionLabel,
                                        java.lang.String[] fileExtensionArr)

Description copied from interface: IContent

Obtain object for a specific version

Parameters:

ticket - String representing the session's ticket

id - id of the object we are trying to get

versionLabel - version of the object we are trying to get

fileExtensionArr - An array of content types. By default, this array consists of {"pdf", ".*"}, which indicates PDF is preferred, then fall back to the native content.

Returns:

• ContentResult
• error returns true if get object by version failed, otherwise false
• object contains the Object we are trying to get

See Also:

IContent.getObjectByVersion(java.lang.String, java.lang.String, java.lang.String, java.lang.String[])

getPermissionsRequest

public int getPermissionsRequest(java.lang.String ticket,
                                 java.lang.String objectId)

Description copied from interface: IContent

Retrieves permissions set on document.

Parameters:

ticket - an authentication ticket

objectId - the identifier used to locate a document

Returns:

the permission on the object

See Also:

IContent.getPermissionsRequest(java.lang.String, java.lang.String)

link

public java.util.ArrayList<java.lang.String> link(java.lang.String ticket,
                                                  java.lang.String childId,
                                                  java.lang.String[] unLinkFrom,
                                                  java.lang.String[] linkTo)

Description copied from interface: IContent

Creates a link request between document and folders.

Parameters:

ticket - String representing the session's ticket

childId - ID of the object that is to be linked

unLinkFrom - String[] representing the folders that the object will be unlinked from

linkTo - String[] representing the folders that the object will be linked to

Returns:

A of folder IDs that objectId was linked to

See Also:

IContent.link(java.lang.String, java.lang.String, java.lang.String[], java.lang.String[])

removeRelation

public ContentResult removeRelation(java.lang.String ticket,
                                    java.lang.String parentObjectId,
                                    java.lang.String[] childIds,
                                    java.lang.String relationName)

ALFRESCO NOTE: when you call removeRelation for an object that has a working copy (source ONLY), the relationship will be removed from the Working Copy AND the original node.

Parameters:

ticket - An authentication ticket

parentObjectId - ID of the parent object to remove the rendition relation from

childIds - An array of child IDs to remove from relation

relationName - - name of parent-child relation to remove

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• result set to parentId if the remove succeeded, null if it failed

No content is brought back on the EnhancedCompleteObjects representing our versions

See Also:

IContent.removeRelation(java.lang.String, java.lang.String, java.lang.String[], java.lang.String)

updateObject

public java.lang.String updateObject(java.lang.String ticket,
                                     java.lang.String objectId,
                                     CompleteObject object,
                                     boolean newVersion,
                                     boolean majorVersion)

Description copied from interface: IContent

Updates existing document object in the repository.

Parameters:

ticket - an authentication ticket

objectId - the identifier for the document to update

object - a CompleteObject obj

newVersion - true to version or overwrite the existing object, otherwise false

majorVersion - true to increment the version to a new major version, otherwise false

Returns:

the object id of the updated or newly-versioned object

See Also:

IContent.updateObject(java.lang.String, java.lang.String, com.tsgrp.opencontent.core.content.model.CompleteObject, boolean, boolean)

updateObjects

public OpenContentObject[] updateObjects(java.lang.String ticket,
                                         OpenContentObject[] ocos)

Description copied from interface: IContent

Updates the objects with the same IDs as provided objects. Note: This method 'replaces' the object the repo with the object you provide. Any properties on the repo object that are NOT on the supplied object will be removed/nulled out. Will attempt to update objectType, aspects, and properties. Note that this does not version or check in.

ocos - - The objects to update

Returns:

- The updated objects

See Also:

IContent.updateObjects(String, com.tsgrp.opencontent.core.model.json.OpenContentObject[])

getLockOwner

public UserResult getLockOwner(java.lang.String ticket,
                               java.lang.String objectId)

Description copied from interface: IContent

Returns a UserResult. If the document is locked the UserBean[] will be populated with the UserBean of the locking User, otherwise, the UserBean[] field will be null.

Returns:

UserResult

• UserResult.getError() - True if there is an error
• UserResult.getErrorDetails() - Details about the error
• UserResult.getUserBeans() - If the document is locked, an array of length 1, containing the userbean of the locking user or null of there is no lock.

See Also:

IContent.getLockOwner(java.lang.String, java.lang.String)

doUpdateObject

public OpenContentObject doUpdateObject(java.lang.String ticket,
                                        OpenContentObject oco)

Specified by:

doUpdateObject in class AbstractContentImpl

getObjectByPath

public OpenContentObject getObjectByPath(java.lang.String ticket,
                                         java.lang.String path)

Description copied from interface: IContent

Obtain object by passing its path WARNING: This method opens an InputStream. You must close this in the calling method.

Parameters:

ticket - String representing the session's ticket

path - path to the object to get

Returns:

OpenContentObject

Throws:

OCObjectNotFoundException - if the object specified by the path is not found

See Also:

IContent.getObjectByPath(String, String)

getObjectByPath

public OpenContentObject getObjectByPath(java.lang.String ticket,
                                         java.lang.String path,
                                         boolean quietMode)

Description copied from interface: IContent

Obtain object by passing its path This accepts a 'quietMode' parameter that will not throw an error if the object doesn't exist at that path. In certain scenarios, a majority of the time the object won't be there, so we don't want to pollute the logs with stacktraces and/or errors.

Parameters:

ticket - sessions ticket

path - path to the object to het

quietMode - If true, we will not throw an error if the object doesn't exist

Returns:

checkin

public ContentResult checkin(java.lang.String ticket,
                             java.lang.String objectId,
                             boolean keepLock,
                             java.lang.String versionLabels,
                             java.lang.String comment,
                             boolean majorVersion,
                             OpenContentObject object,
                             boolean newVersion,
                             javax.activation.DataHandler dataHandler)

Description copied from interface: IContent

Checks in a node to the repository. This may fail on implementations that require size (e.g. Dynamo). Use the overloaded checkin for implementations that require size.

Parameters:

ticket - a valid OC ticket.

objectId - the objectId of the object to check in.

keepLock - whether to keep the lock or release it after the checkin is complete.

versionLabels - the version lable of the document that will be checked in.

comment - the comment for checking in the document.

majorVersion - true if the document should become a major version on checkin.

object - the object to use for setting new property values on checkin - NOTE: this is currently not implemented.

newVersion - whether this should be a new version or the same version.

dataHandler - the data handler containing the input stream for the new content of the checked in object.

Returns:

• ContentResult
• error returns true if method failed, otherwise false
• objectId returns ID of the object checked in

getAppliedAspects

public java.util.List<java.lang.String> getAppliedAspects(java.lang.String ticket,
                                                          java.lang.String objectId)

Retrieves a list of aspects applied to the provided objectId. Note: For obvious reasons, this method will only produce results on an Alfresco backend. For other filesystems, will return an empty list of strings.

Parameters:

ticket -

objectId -

Returns:

A list of aspects applied to the given objectId in bean format eg, tsg_rendition

applyAspect

public void applyAspect(java.lang.String ticket,
                        java.lang.String objectId,
                        java.lang.String aspectType,
                        java.util.Map<java.lang.String,java.lang.Object> mandatoryProperties)

Description copied from interface: IContent

Adds an aspect to a document. Note: This will throw an error if called from a non Alfresco backend.

Parameters:

ticket - a valid OC ticket

objectId - the object the aspect will be applied to

aspectType - the type of aspect to be added (in OCName format)

mandatoryProperties - a list of properties that are mandatory for the aspect (in OCName format). Set to null/empty map for no properties

See Also:

IContent.applyAspect(java.lang.String, java.lang.String, java.lang.String, java.util.Map)

moveObject

public void moveObject(java.lang.String ticket,
                       java.lang.String objectId,
                       java.lang.String parentPathOrId)

Description copied from interface: IContent

Moves an object in the repository from one folder to another.

Parameters:

ticket - a valid OC ticket.

objectId - the ID of the object to move to a new folder.

parentPathOrId - the path or ID of the folder to move the new object to.