This chapter describes how to customize disposition actions for Oracle WebCenter Content: Records. Disposition actions are used in disposition instructions, which define the sequence of actions to be performed on content during its life cycle.
This chapter includes the following sections:
Important:
If custom dispositions were previously created using an older version of the Records system, those dispositions should be re-examined and updated to use the newest services and actions. The Action Service parameters have changed from previous versions of this software and any changes to existing custom dispositions are not mapped automatically.
A large number of built-in disposition actions are included, including Cutoff, Destroy, Transfer, Move, Declassify. Your environment may require disposition actions other than the predefined options. Disposition actions can be designed to reflect your organization's specific needs.
Custom disposition actions are based on Oracle WebCenter Content services, which can be called with specific parameters to define the behavior of the disposition actions. For example, you could create a disposition action to automatically retain the last three revisions of content items using the DELETE_ALL_BUT_LAST_N_REVISIONS_SERVICE
service with the NumberOfRevisions=3
parameter.
Important:
Custom disposition features are available only to users with the Rma.Admin.Customization right. By default, this right is not assigned to any of the predefined roles. You must assign it to a role before this functionality is exposed.
The following tasks are for managing dispositions:
Section 20.2.1, "Creating or Editing a Custom Disposition Action"
Section 20.2.2, "Viewing Custom Disposition Action Information"
To create a custom disposition action:
Important:
Creating custom disposition actions requires in-depth technical knowledge of Oracle WebCenter Content. Contact Consulting Services to define custom disposition actions.
Permissions:
The Rma.Admin.Customization right is required to perform this task. This right is not assigned by default to any of the predefined roles, which means it must be assigned to a role for this functionality to be exposed.
Choose Records then Configure from the Top menu. Choose Disposition Actions then Custom.
On the Configure Dispositions page, click Add in the Custom Disposition Action section.
On the Create or Edit Disposition Action page, enter a unique ID for the custom disposition action in the Action ID text box.
Enter a name for the custom disposition action in the Action Name text box.
Enter a description for the custom disposition action in the Brief Description text box.
Enter a group name for the custom disposition action in the Group Name text box. The default value for this field is stored in the ww_strings.htm
file in the wwOptGroupLabelCustomDispositionActionsList
. It is set to Custom Actions
by default.
To use a different group name than Custom Actions, modify the string value in the resource file and restart Content Server. Do not change the suggested default value in the Group Name field.
Choose the service to be used for the custom disposition action from the Action Service list.
(Optional) Specify one or more parameters for the selected action service.
(Optional) Select any of the checkboxes as required. Selections include Must Be First, Must Be Last, Require Approval. These actions determine when the custom disposition action will be used and how.
Click Create.
A message is displayed saying the disposition action was created successfully, with the action information.
Click OK.
The following Action Service Parameters are required for the specific Action Service.
Disposition/Event | Service Parameters |
---|---|
Superseded |
isScrub=1 |
Delete All Revisions (Destroy Metadata) |
NumberOfRevisions=0, isDestroy=1, dRevRank=0 |
Delete Revision |
NumberOfRevisions=0, isDestroy=1 |
Mark Transfer Completed |
NumberOfRevisions=0, isDestroy=1, dRevRank=0 |
Mark Move Completed |
NumberOfRevisions=0, isDestroy=1, dRevRank=0 |
Mark Accession Completed |
NumberOfRevisions=0, isDestroy=1, dRevRank=0 |
Delete Previous Revision |
NumberOfRevisions=1 |
Delete Old Revision |
NumberOfRevisions=1 |
Mark Archive Completed |
NumberOfRevisions=0, isDestroy=1, dRevRank=0 |
Archive Leave Metadata |
isScrub=1 |
Mark Accession Completed (leave metadata) |
isScrub=1 |
Mark Move Completed (leave metadata) |
isScrub=1 |
Mark Transfer Complete (leave metadata) |
isScrub=1 |
Mark Delete Revision Completed |
NumberOfRevisions=0, isDestroy=1 |
Delete Complete |
NumberOfRevisions=0, isDestroy=1 |
Mark Transfer Completed (prompt to keep or delete metadata) |
NumberOfRevisions=0, isDestroy=1 |
Mark Move Complete (prompt to keep or delete metadata) |
NumberOfRevisions=0, isDestroy=1 |
Mark Accession Complete (prompt to keep or delete metadata) |
NumberOfRevisions=0, isDestroy=1 |
Mark Archive Complete (prompt to keep or delete metadata) |
NumberOfRevisions=0, isDestroy=1 |
Mark Related Content |
IsMarkAllRelations=1 |
To edit a custom disposition action:
Choose Records then Configure from the Top menu. Choose Disposition Actions then Custom.
On the Configure Dispositions page, choose Edit Action from a disposition Actions menu.
Make modifications as required on the Create or Edit Disposition Action page, and click Submit Update when done.
A message is displayed saying the disposition action was created successfully, with the action information.
Click OK.
To view the information about a custom disposition action:
Permissions:
The Rma.Admin.Customization right is required to perform this task. This right is not assigned by default to any of the predefined roles, which means you must assign it to a role before this functionality is exposed.
Choose Records then Configure from the Top menu. Choose Disposition Actions then Custom.
On the Configure Dispositions page, click the disposition name to view.
When done viewing, click OK.
Permissions:
The Rma.Admin.Customization right is required to perform this task. This right is not assigned by default to any of the predefined roles, which means you must assign it to a role before this functionality is exposed.
Custom disposition actions can be deleted only if they are no longer used in the disposition instructions for any category.
To delete a custom disposition action:
Choose Records then Configure from the Top menu. Choose Disposition Actions then Custom.
On the Configure Dispositions page, choose Delete Action from a disposition's item Actions menu. You can also select the checkbox by the action name and choose Delete from the Table menu.
A message is displayed saying the disposition action was deleted successfully.
Click OK.
To delete multiple dispositions, select the checkbox for the dispositions to delete on the Configure Dispositions page, and choose Delete from the Table menu.
Permissions:
The Rma.Admin.Customization right is required to perform this task. This right is not assigned by default to any of the predefined roles, which means you must assign it to a role before this functionality is exposed.
Important:
Some dispositions are required for processing of instructions to occur. Disabling a disposition could interfere with the processing of disposition instructions. Always verify ahead of time that it is acceptable to disable a disposition.
To disable a custom disposition action:
Choose Records then Configure from the Top menu. Choose Disposition Actions then Disable.
On the Disposition Actions Configuration page, select the checkbox next to the actions that should be disabled.
Click Submit Update when done.
This example creates a custom disposition action that automatically retains the last three revisions of a content item.
Permissions:
The Rma.Admin.Customization right is required to perform this task. This right is not assigned by default to any of the predefined roles, which means you must assign it to a role before this functionality is exposed.
Choose Records then Configure from the Top menu. Choose Disposition Actions then Custom.
On the Configure Dispositions page, in the Custom Disposition Action section, click Add.
Complete the metadata fields as follows on the Create or Edit Disposition Action page:
In the Action ID field, type RetainLast3Rev
.
In the Action Name field, type Retain Last 3 Revisions
.
In the Brief Description field, type Only keep the last 3 revisions of a content item
.
In the Group Name field, type Custom
.
From the Action Service list, choose the wwString
name of a disposition action; for example, Notify Author
.
In the Action Service Parameters field, type NumberOfRevisions=3
.
Click Create.
The newly created disposition action can now be selected from the list of available disposition actions when creating disposition rules.
Physical items can be assigned retention schedules, which define their life cycle. When creating a physical item you can assign a retention schedule to it. This links the physical item to a set of retention and disposition rules, which specify how long an item should be stored and when and how it should be disposed.
The same retention schedules and disposition rules may be used for physical items as for electronic items, but disposition rules used only for physical items can also be defined.