WoodWing Help Center

Elvis 4 REST API - copy

Elvis 4 REST API - copy

GET/POST

http://yourserver.com/services/copy
    ?source=<source path>
    &target=<destination path>
    &folderReplacePolicy=<AUTO_RENAME | MERGE | THROW_EXCEPTION>
    &fileReplacePolicy=<AUTO_RENAME | OVERWRITE
    | OVERWRITE_IF_NEWER | REMOVE_SOURCE
    | THROW_EXCEPTION | DO_NOTHING>
    &filterQuery=<query>
    &flattenFolders=<true | false>
    &async=<true | false>

What does it do?

Copy a folder or a single asset.

When you copy a folder, all subfolders and assets contained in it will also be copied to the new location. The subfolder structure will be kept intact unless you set flattenFolder to true.

Parameters

source

Either a folderPath or assetPath of the folder or asset to be copied.

Required

target

The folderPath or assetPath to which the folder or asset should be copied.

Required

folderReplacePolicy

Policy used when destination folder already exists.

  • AUTO_RENAME - add '-1' number to destination path. The counter is incremented until a free alternative is found.
  • MERGE - merge source folder into destination using fileReplacePolicy.
  • THROW_EXCEPTION - abort the operation.

Optional. If omitted, AUTO_RENAME will be used.

fileReplacePolicy

Policy used when destination asset already exists.

  • AUTO_RENAME - add '-1' number to destination path. The counter is incremented until a free alternative is found.
  • OVERWRITE - remove destination if it already exists.
  • OVERWRITE_IF_NEWER - only remove destination if source is newer. Otherwise remove source instead of moving it.
  • REMOVE_SOURCE - remove source if destination already exists.
  • THROW_EXCEPTION - abort the operation.
  • DO_NOTHING - skip copy of the file.

Optional. If omitted, AUTO_RENAME will be used.

filterQuery

When specified, only source assets that match this query will be copied.

Optional. If omitted, all source assets will be copied.

flattenFolders

When set to true will copy all files from source subfolders to directly below the target folder. This will 'flatten' any subfolder structure.

Optional. If omitted, folders will not be flattened.

async

When true, the process will run asynchronous in the background. The call will return immediate with the processId.

Optional. By default, the call waits for the process to finish and then returns the processedCount.

Return value

The operation returns a JSON object with the following properties:

processedCount Number of assets that were processed by the operation.
errorCount Number of errors that occurred.

If called with async=true, the operation returns a JSON object with the following properties:

processId Unique id of the process that was started.

If the operation fails, a JSON error object is returned.

Examples

Copy single asset

The following copies an asset.

copy

http://demo.elvisdam.com/services/copy
    ?source=/Demo Zone/Images/Travel/Architecture/Louvre.jpg
    &target=/Demo Zone/Images/Travel/Cities/Louvre.jpg

It returns the following response.

{
  "processedCount" : 1
}

Copy folder

The following copies a folder and all the assets contained in it, keeping the sub folder structure intact.

copy

http://demo.elvisdam.com/services/copy
    ?source=/Demo Zone/Images
    &target=/Production/This week/Demo Images
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.