Assigning a disposition schedule

You can associate a disposition schedule with RecordCategory, RecordFolder, or RecordType objects. A record folder can either inherit the disposition schedule associated with the parent record category, or you can associate a different disposition schedule with the record folder.

By default, a record is disposed of according to the disposition schedule associated with the record folder under which it is declared. However, if you want to dispose of a record differently, you should create a record type and specify the appropriate disposition schedule. You can then associate this record type with various records. If different disposition schedules are associated with the parent entity and record type, the disposition schedule associated with the record type will apply to records.

To assign a disposition schedule, call the allocateDisposalSchedule method on a DispositionAllocatableObject object, passing in the DispositionSchedule object to assign. The DispositionAllocatableObject interface is implemented by RecordCategory, RecordFolder, and RecordType objects. The following code fragment provides an example of assigning a disposition schedule using the allocateDisposalSchedule method.
//Assigns a disposition schedule
public void allocateDisposalSchedule(DispositionSchedule aoDisposalSchedule)
{ 
   //Obtains an instance of an existing RecordCategory object 
   RecordCategory loRecCategory = 
      (RecordCategory) loRMStore.getObject(RMType.RM_TYPE_RECORDCATEGORY, 
      "B42CC67A-6E4C-472E-A2D4-1EAC4B70B962"); 

   // Assigns a disposition schedule to the RecordCategory object
   loRecCategory.allocateDisposalSchedule( aoDisposalSchedule ); 
}

Retrieving DispositionSchedule objects

You can retrieve a DispositionSchedule object in the following ways:

  • By calling the getAssociatedDisposalSchedule method on a DispositionAllocatableObject object or by retrieving the object's DisposalSchedule property (for example, by calling the getPropertyValue method on the object) to retrieve the disposition schedule associated with the DispositionAllocatableObject object.
  • By calling getObject on an RMObjectStore object to retrieve the DispositionSchedule object by its ID. For example,
    //Retrieves a disposition schedule
private DispositionSchedule getDispositionSchedule(RMObjectStore aoRMOS, 
String asDispositionId) 

{ 
   DispositionSchedule loCustObject = null; 
   loCustObject = (DispositionSchedule) aoRMOS.getObject(RMType.RM_TYPE_DISPOSALSCHEDULE, 
      asDispositionId); 
   return loCustObject; 

}