com.filenet.rm.api

Interface DispositionSchedule

All Superinterfaces:
com.filenet.wcm.api.BaseObject, com.filenet.wcm.api.ContainableObject, com.filenet.wcm.api.CreatableObject, com.filenet.wcm.api.CustomObject, com.filenet.wcm.api.GettableObject, com.filenet.wcm.api.LockableObject, com.filenet.wcm.api.ReadableMetadataObject, com.filenet.wcm.api.ReadableSecurityObject, RMCustomObject, RMObject, java.io.Serializable, com.filenet.wcm.api.ValueObject, com.filenet.wcm.api.WorkflowTarget, com.filenet.wcm.api.WriteableMetadataObject, com.filenet.wcm.api.WriteableSecurityObject

  1. public interface DispositionSchedule
  2. extends RMCustomObject
Represents a set instructions that are allocated to a Records Manager object to indicate how long that object is to be retained for business purposes. In addition, a DispositionSchedule object determines how the Records Manager object is to be processed at the end of the specified retention period.

Field Summary

Modifier and Type Field and Description
  1. static
  2. int
CALENDER_DATE
An int value that indicates that the triggering event for this DispositionSchedule object is a calendar date.
Fields inherited from interface com.filenet.rm.api.RMCustomObject
ACTION_AUTODELETE, ACTION_CUTTOFF, ACTION_DESTROY, ACTION_EXPORT, ACTION_INTRIMTRANSFER, ACTION_REVIEW, ACTION_TRANSFER, ACTION_VITAL_REVIEW, CYCLIC_EVENT, EXTERNAL_EVENT, IS_EQUAL, IS_GREATER, IS_GREATER_OR_EQUAL, IS_LESS, IS_LESS_OR_EQUAL, IS_NOT_EQUAL, IS_NOT_NULL, IS_NULL, LIKE, METADATA_EVENT, PREDEFINED_DATE_EVENT
Fields inherited from interface com.filenet.rm.api.RMObject
AGGREGATION_RECORD, AGGREGATION_RECORD_CATEGORY, AGGREGATION_RECORD_FOLDER, AGGREGATION_VOLUME, CLEAR_INHERITED_CHILDREN, INHERIT_IMMEDIATE_CHILDREN, INHERITED_CHILDREN, NON_INHERITED_CHILDREN, WORK_FLOW_STATUS_COMPLETED, WORK_FLOW_STATUS_NOT_STARTED, WORK_FLOW_STATUS_STARTED
Fields inherited from interface com.filenet.wcm.api.ContainableObject
INVALID_CONTAINMENT_NAME_CHARACTERS
Fields inherited from interface com.filenet.wcm.api.BaseObject
EXPORT_DEFAULT, EXPORT_ENCODED_CONTENT, EXPORT_FULL, EXPORT_OBJECT_ID, EXPORT_OBJECT_SECURITY, IMPORT_DEFAULT, IMPORT_OBJECT_ID, IMPORT_OWNER, IMPORT_PERMISSIONS, TYPE_ACTIVE_MARKING, TYPE_ANNOTATION, TYPE_ANY, TYPE_AUDIT_DEFINITION, TYPE_CBR_ENGINE_TYPE, TYPE_CHOICE, TYPE_CHOICELIST, TYPE_CLASS_SUBSCRIPTION, TYPE_CLASSDEFINITION, TYPE_CLASSDESCRIPTION, TYPE_COLUMN_DEFINITION, TYPE_COMPUTER, TYPE_CONTENT_CACHE_SERVICE, TYPE_CONTENT_MGR_SERVICE, TYPE_CONTENT_REFERENCE, TYPE_CONTENT_TRANSFER, TYPE_CUSTOMOBJECT, TYPE_DOCUMENT, TYPE_DOCUMENT_CLASSIFICATION_ACTION, TYPE_DOCUMENT_LIFECYCLE_ACTION, TYPE_DOCUMENT_LIFECYCLE_POLICY, TYPE_DOCUMENTSTATE, TYPE_DOMAIN, TYPE_DYNAMIC_REFERENTIAL_CONTAINMENT_RELATIONSHIP, TYPE_ENTIRENETWORK, TYPE_EVENT, TYPE_EVENT_ACTION, TYPE_FEATURE_ADD_ON, TYPE_FILESTORE, TYPE_FOLDER, TYPE_GROUP, TYPE_INSTANCE_SUBSCRIPTION, TYPE_LINK, TYPE_LOCALIZED_STRING, TYPE_MARKING_SET, TYPE_MULTIPLEVALUES, TYPE_OBJECT_STORE, TYPE_OBJECTSET, TYPE_OBJSTORE_SERVICE, TYPE_PERMISSION, TYPE_PROPERTY_DEFINITION, TYPE_PROPERTYDESCRIPTION, TYPE_PROPERTYDESCRIPTIONS, TYPE_PUBLISH_REQUEST, TYPE_PUBLISH_TEMPLATE, TYPE_READONLY_OBJECT_SET, TYPE_REALM, TYPE_REFERENTIAL_CONTAINMENT_RELATIONSHIP, TYPE_SECURITY_POLICY, TYPE_SECURITY_TEMPLATE, TYPE_STORAGE_POLICY, TYPE_STORED_SEARCH, TYPE_STYLE_TEMPLATE, TYPE_SUBSCRIBED_EVENT, TYPE_SUBSCRIPTION, TYPE_TABLE_DEFINITION, TYPE_TRANSIENT, TYPE_USER, TYPE_VERSIONSERIES, TYPE_WORKFLOW_CLASS_SUBSCRIPTION, TYPE_WORKFLOW_INSTANCE_SUBSCRIPTION, TYPE_WORKFLOWDEFINITION, TYPE_XML_PROPERTY_MAPPING_SCRIPT

Method Summary

Modifier and Type Method and Description
  1. void
addAlternateRetention(java.lang.String aoPhaseGuid,com.filenet.wcm.api.Properties[] aoArrProps)
Creates AlternateRetention objects for each element in a specified Properties collection and associates the new objects with a specified Phase object.
  1. RMCustomObject
createPhase(com.filenet.wcm.api.Properties aoProps,com.filenet.wcm.api.Permissions aoACL)
Deprecated. Use the createPhaseWithAlternateRetention method instead.
  1. RMCustomObject
createPhaseWithAlternateRetention(com.filenet.wcm.api.Properties aoProps,com.filenet.wcm.api.Permissions aoACLS,com.filenet.wcm.api.Properties[] aoArrAltcreatePhaseWithAlternateRetentionernateRetentionProps)
Creates a Phase object using the specified properties and permissions, and adds the new object as the last entry in the Phase collection associated with this DipositionSchedule object.
  1. void
deleteAlternateRetention(java.lang.String asAlternateRetentionGuid)
Deletes a specified AlternateRetention object.
  1. void
deletePhase(java.lang.String asPhaseGuid)
Deletes the specified Phase object and updates the sequence of all associated Phase objects to reflect the change.
  1. RMCustomObjects
getPhases()
Returns all Phase objects that are associated with this DispositionSchedule object.
  1. void
modifyAlternateRetention(java.lang.String asAlternateRetentionGuid,com.filenet.wcm.api.Properties aoProps)
Modifies the Properties collection for a specified AlternateRetention object.
  1. void
recalculateCutOff(DisposableObject aoRMObject)
Recalculates and updates the pre-cutoff data based on the schedule associated with a specified DisposableObject object or its parent.
  1. void
runDisposaltrigger(DispositionAllocatableObject aoDisAllObject)
  1. void
runDisposaltrigger(DispositionAllocatableObject aoDisAllObject,RecordInfos aoRecordInfos)
Checks the disposal event for the specified DispositionAllocatableObject object and, if the event has occurred, sets the pre-cutoff date and other disposal-related data for the object or its children.
  1. void
triggerNextPhase(RMObject aoRMObject)
Sets the subsequent phase data on the specified RMObject object according to the schedule object that is associated with the RMObject object or its parent.
  1. void
updateCurrentPhaseDataOnEntity(DisposableObject aoDisposableObject)
Recalculates the phase data for the specified DisposableObject object to to cater conditions such as modification of to the phase or the object.
  1. void
updateDateEffectiveModified()
Sets the EffectiveDateModified property of this DipositionSchedule object to the latest modified date on an associated trigger and cutoff action.
  1. void
updatePhase(java.lang.String asPhaseGuid,com.filenet.wcm.api.Properties aoProps,com.filenet.wcm.api.Permissions aoACL)
Updates the specified Phase object using the property and permission values that are passed as parameters.
  1. void
updatePhaseDataOnEntity(DisposableObject aoDisposableObject)
Recalculates the phase data for the specified DisposableObject object to reflect modifications to the phase or the object.
  1. void
updatePhases(java.util.List aoPhasePropCollection,com.filenet.wcm.api.Permissions aoPermissions)
Updates the associated phases with properties collection specified by the aoPhasePropCollection parameter, which provides a collection of collections in sequential order.
Methods inherited from interface com.filenet.rm.api.RMObject
getObjectStore, getRMDeclassificationOffset, getRMEntityType, getRMImplementationType, registerExternalEvent, setState
Methods inherited from interface com.filenet.wcm.api.CustomObject
applySecurityTemplate, changeClass, delete, getHeadLinks, getHeadLinksXML, getPermissionsXML, getSubscriptions, getTailLinks, getTailLinksXML, getUserAccess, getUserAccess, getUserAccess, raiseEvent
Methods inherited from interface com.filenet.wcm.api.ContainableObject
file, file, file, file, getContainers, getContainersXML, getContainmentNames, getContainmentPaths, getSecurityParent, setContainmentName, setContainmentName, setSecurityParent, unfile, unfile
Methods inherited from interface com.filenet.wcm.api.WorkflowTarget
getWorkflowSubscriptions, getWorkflowSubscriptionsXML, getWorkflowSubscriptionsXML
Methods inherited from interface com.filenet.wcm.api.WriteableSecurityObject
setPermissions, setPermissions
Methods inherited from interface com.filenet.wcm.api.WriteableMetadataObject
setProperties, setProperties
Methods inherited from interface com.filenet.wcm.api.ReadableSecurityObject
getAccessMask, getPermissions, getPermissions
Methods inherited from interface com.filenet.wcm.api.ReadableMetadataObject
getProperties, getProperties, getPropertiesXML, getPropertyBinaryValue, getPropertyBooleanValue, getPropertyDateValue, getPropertyDoubleValue, getPropertyIntValue, getPropertyStringValue, getPropertyValue, getPropertyValuesValue, refresh, refresh
Methods inherited from interface com.filenet.wcm.api.BaseObject
equals, exportObject, getClassId, getId, getName, getObjectStoreId, getObjectType, getSession, hashCode, thisBaseObject
Methods inherited from interface com.filenet.wcm.api.LockableObject
extendLock, extendLock, isLocked, lock, unlock, unlock

Field Detail

CALENDER_DATE

  1. static final int CALENDER_DATE
An int value that indicates that the triggering event for this DispositionSchedule object is a calendar date.
See Also:

Method Detail

createPhase

  1. RMCustomObject createPhase(com.filenet.wcm.api.Properties aoProps,
  2. com.filenet.wcm.api.Permissions aoACL)
  3. throws RMException
Deprecated. Use the createPhaseWithAlternateRetention method instead.
Creates a Phase object in Content Engine and associates that Phase object with this DispositionSchedule object.
Parameters:
aoProps - A Properties collection that defines the properties for the new Phase object.
aoACL - A Permission collection that defines the permissions for the new Phase object.
Returns:
An RMCustomObject object that represents the new Phase object.
Throws:
RMException - If a Records Manager error occurs.

updatePhase

  1. void updatePhase(java.lang.String asPhaseGuid,
  2. com.filenet.wcm.api.Properties aoProps,
  3. com.filenet.wcm.api.Permissions aoACL)
  4. throws RMException
Updates the specified Phase object using the property and permission values that are passed as parameters.
Parameters:
asPhaseGuid - A String that represents the GUID of the Phase object to be modified.
aoProps - A Properties collection that contains the property values to be applied to the specified Phase object.
aoACL - A Permissions collection that contains the permission values to be applied to the specified Phase object.
Throws:
RMException - If a Records Manager error occurs.

deletePhase

  1. void deletePhase(java.lang.String asPhaseGuid)
  2. throws RMException
Deletes the specified Phase object and updates the sequence of all associated Phase objects to reflect the change.
Parameters:
asPhaseGuid - A String that represents the GUID of the Phase object to be deleted.
Throws:
RMException - If a Records Manager error occurs.

getPhases

  1. RMCustomObjects getPhases()
  2. throws RMException
Returns all Phase objects that are associated with this DispositionSchedule object.
Returns:
A RMCustomObjects collection containing the Phase objects that are associated with this DispositionSchedule object.
Throws:
RMException - If a Records Manager error occurs.

runDisposaltrigger

  1. void runDisposaltrigger(DispositionAllocatableObject aoDisAllObject,
  2. RecordInfos aoRecordInfos)
  3. throws RMException
Checks the disposal event for the specified DispositionAllocatableObject object and, if the event has occurred, sets the pre-cutoff date and other disposal-related data for the object or its children. The disposal event that is associated with this DispositionSchedule object determines the objects to be modified by this method.
Parameters:
aoDisAllObject - The DispositionAllocatableObject object for which the disposal event is to be checked.
aoRecordInfos - If the DispositionAllocatableObject object is a RecordType object, set this parameter to the RecordInfos collection that contains the records associated with the RecordType object. For all other types of object, set this parameter to null.
Throws:
RMException - If a Records Manager error occurs.

runDisposaltrigger

  1. void runDisposaltrigger(DispositionAllocatableObject aoDisAllObject)
  2. throws RMException
Checks the disposal event for the specified DispositionAllocatableObject object and, if the event has occurred, sets the pre-cutoff date and other disposal-related data for the object or its children. The disposal event that is associated with this DispositionSchedule object determines the objects to be modified by this method.
Parameters:
aoDisAllObject - The DispositionAllocatableObject object for which the disposal event is to be checked.
Throws:
RMException - If a Records Manager error occurs.

triggerNextPhase

  1. void triggerNextPhase(RMObject aoRMObject)
  2. throws RMException
Sets the subsequent phase data on the specified RMObject object according to the schedule object that is associated with the RMObject object or its parent.
Parameters:
aoRMObject - The RMObject object for which the disposal event is to be set.
Throws:
RMException - If a Records Manager error occurs.

updateDateEffectiveModified

  1. void updateDateEffectiveModified( )
  2. throws RMException
Sets the EffectiveDateModified property of this DipositionSchedule object to the latest modified date on an associated trigger and cutoff action.
Throws:
RMException - If a Records Manager error occurs.

updatePhaseDataOnEntity

  1. void updatePhaseDataOnEntity(DisposableObject aoDisposableObject)
  2. throws RMException
Recalculates the phase data for the specified DisposableObject object to reflect modifications to the phase or the object.
Parameters:
aoDisposableObject - The DisposableObject object for which disposal data is to be set.
Throws:
RMException - If a Records Manager error occurs.

updateCurrentPhaseDataOnEntity

  1. void updateCurrentPhaseDataOnEntity( DisposableObject aoDisposableObject)
  2. throws RMException
Recalculates the phase data for the specified DisposableObject object to to cater conditions such as modification of to the phase or the object.
Parameters:
aoDisposableObject - The DisposableObject object for which disposal data is to be set.
Throws:
RMException - If a Records Manager error occurs.

updatePhases

  1. void updatePhases(java.util.List aoPhasePropCollection,
  2. com.filenet.wcm.api.Permissions aoPermissions)
  3. throws RMException
Updates the associated phases with properties collection specified by the aoPhasePropCollection parameter, which provides a collection of collections in sequential order.
Parameters:
aoPhasePropCollection - A List object specifying the property collections for the phase properties. Each phase property collection should contain the GUID of the phase to be updated.
aoPermissions - A Permissions collection for all phases.
Throws:
RMException - If a Records Manager error occurs.

addAlternateRetention

  1. void addAlternateRetention(java.lang.String aoPhaseGuid,
  2. com.filenet.wcm.api.Properties[] aoArrProps)
Creates AlternateRetention objects for each element in a specified Properties collection and associates the new objects with a specified Phase object.
Parameters:
aoPhaseGuid - A String representing the GUID of the Phase object with which the new AlternateRetention objects are to be associated.
aoArrProps - The Properties collection from which the AlternateRetention objects are to be created

modifyAlternateRetention

  1. void modifyAlternateRetention(java.lang.String asAlternateRetentionGuid,
  2. com.filenet.wcm.api.Properties aoProps)
  3. throws RMException
Modifies the Properties collection for a specified AlternateRetention object.
Parameters:
asAlternateRetentionGuid - A String that represents the GUID of the AlternateRetention object that is to be modified.
aoProps - A Properties collection containing the property values that are to be applied to the specified AlternateRetention object.
Throws:
RMException - If a Records Manager error occurs.

deleteAlternateRetention

  1. void deleteAlternateRetention(java.lang.String asAlternateRetentionGuid)
  2. throws RMException
Deletes a specified AlternateRetention object.
Parameters:
asAlternateRetentionGuid - A String that represents the GUID of the AlternateRetention object to be deleted.
Throws:
RMException - If a Records Manager error occurs.

createPhaseWithAlternateRetention

  1. RMCustomObject createPhaseWithAlternateRetention( com.filenet.wcm.api.Properties aoProps,
  2. com.filenet.wcm.api.Permissions aoACLS,
  3. com.filenet.wcm.api.Properties[] aoArrAltcreatePhaseWithAlternateRetentionernateRetentionProps)
  4. throws RMException
Creates a Phase object using the specified properties and permissions, and adds the new object as the last entry in the Phase collection associated with this DipositionSchedule object.
Parameters:
aoProps - The Properties collection containing the property values for the new Phase object.
aoACLS - The Permissions collection containing the permission values for the new Phase object.
aoArrAltcreatePhaseWithAlternateRetentionernateRetentionProps -
Returns:
An RMCustomObject object representing the new Phase object.
Throws:
RMException - If a Records Manager error occurs.

recalculateCutOff

  1. void recalculateCutOff(DisposableObject aoRMObject)
Recalculates and updates the pre-cutoff data based on the schedule associated with a specified DisposableObject object or its parent. This method can be used to verify the state of a DisposableObject object before completion of cut-off.
Parameters:
aoRMObject - The DisposableObject for which pre-cutoff data is to be recalculated.