Copying a file or folder
CopyFile copies a file or folder from the working directory to a target location. You can indicate whether to create a new version of the file or folder if one with the same name already exists in the target location.
Using MaxVersions, you can specify the maximum number of versions to maintain on BIRT iHub. For example, if you maintain four versions of a file, BIRT iHub deletes the earliest version when you copy a fifth version to the Encyclopedia volume. At this point, BIRT iHub can also archive the file, depending on the file’s autoarchive rules.
There are three ways to copy a file or folder:
Copy all files or folders that match a given condition using Search.
When you use Search, you can use the optional LatestVersionOnly parameter to specify that BIRT iHub copies only the latest version of the file that matches the search criteria. Search also supports recursive CopyFile operations.
Copy a list of files or folders using NameList or IdList.
Copy a single file or folder using Name or Id.
Specify the target directory using the Target element of CopyFile. The following example copies two files to two different directories:
<SOAP-ENV:Body>
<Administrate>
<AdminOperation>
<Transaction>
<TransactionOperation>
<CopyFile>
<Target>/Headquarters</Target>
<Name>/EmployeeList.rptdesign</Name>
</CopyFile>
<CopyFile>
<Target>/SouthwestSales</Target>
<Name>/Prospects.rptdesign</Name>
</CopyFile>
</TransactionOperation>
</Transaction>
</AdminOperation>
</Administrate>
</SOAP-ENV:Body>