The Relocate operation enables you to move the contents
and metadata of a container object to a different location in the
file plan hierarchy. You can relocate only a record category or record
folder within a file plan.
In addition, when a record category or a record folder
is relocated, all the record categories, record folders, volumes,
and records under that record category or record folder are also moved
to the specified destination. When relocating a record category or
a record folder, you should keep the following points in mind:
- You can relocate a record category only to a category that does
not have any record folders under it and vice versa, because you cannot
have a record category and a record folder at the same level in the
hierarchy.
- You cannot relocate a record folder under another record folder,
because you cannot create a record folder within a record folder.
- You cannot relocate a record folder under the classification scheme,
record folders can exist only under record categories and not directly
under the classification scheme.
- The destination container should be open and active to allow relocation
to this container. However, the source object can be inactive or closed.
- You cannot relocate container objects across file plans.
To relocate a record category or record folder, call the
move method on a
RecordCategory or
RecordFolder object, respectively. You
must specify the destination where the object will be relocated and
the reason for the relocation. The following code snippet relocates
a record folder from its parent container to a destination container.
//Relocates a RecordFolder object
public void move(RecordFolder aoRF, RMFolder aoDestination,
String asReason, DispositionSchedule aoDS)
{
aoRF.move(aoDestination, asReason, aoDS);
}
For information about simultaneously relocating
multiple objects, refer to Performing bulk operations.