Moving a file or folder
MoveFile moves a file or folder from the working directory to a location you specify using the Target element.
When you use MoveFile, 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. If you create a new version, BIRT iHub overwrites the existing file with every update.
Using MaxVersions, you can specify the maximum number of versions to maintain on a BIRT iHub. For example, if you maintain four versions of a file, BIRT iHub deletes the earliest version when you add a fifth version. At this point, BIRT iHub can archive the file, depending on the autoarchive rules that apply to the file.
There are three ways to move a file or folder:
Move a single file or folder using Name or Id.
Move all files or folders that match a given condition using Search.
When you use Search, you can use the optional LatestVersionOnly element to move only the latest version of the file matching the search criteria. Search also supports recursive MoveFile operations.
Move a list of files or folders using NameList or IdList.
The following request uses Name to move Timeshares.rptdesign to the Inventory directory. It also specifies that the Encyclopedia volume keeps up to three versions of this file at a time.
<SOAP-ENV:Body>
<Administrate>
<AdminOperation>
<MoveFile>
<Target>/Inventory</Target>
<Name>/Timeshares.rptdesign</Name>
<MaxVersions>3</MaxVersions>
</MoveFile>
</AdminOperation>
</Administrate>
</SOAP-ENV:Body>