Approve items

Before a single item or compound object is added to a collection and becomes available to the end users, it must be approved and indexed. You can approve items if you have the right to approve items and build indexes.

Using the approve function, CONTENTdm administrators can review controlled vocabulary terms, items, and compound objects that have been uploaded to the pending queue from one or more CONTENTdm Project Client workstations or added using the Web-based Add in CONTENTdm Administration.

You can approve pending items:

 Note: Only one approval or index process can run at a time for the same collection (i.e., approval and index processes do not run simultaneously). For example, when a scheduled index is running on the server, the subsequent scheduled approval is queued and executed when the scheduled index completes.

Access the Approve page

After logging in to CONTENTdm Administration, click the items tab, then click approve. Project Client users with appropriate rights can access the Approve page from the Administration menu.

All files in the specified collection's pending queue are displayed. You can review, approve, or delete those items, as well as review and edit controlled vocabulary terms, and set up or manage scheduled and pending approvals.

Approved items are added to the collection, but cannot be searched or browsed until the text index is built. For more information, see Build a collection Index.

Although you can approve a very large number of items at a time, to maintain acceptable performance, we recommend limiting your approval of items to batches of fewer than about 50,000 items.

Review and approve pending items immediately

Choose to approve all pending items and controlled vocabulary terms at once or review the detailed approval queue actions, and edit, approve, or delete individual items and terms.

 Note: A maximum of 100 items can be viewed in the pending queue at one time. As items are approved, the remaining items in the pending queue will display.

Full Approval Queue Actions

If you use the full approval queue actions options, all items are added to the collection, including items containing unauthorized controlled vocabulary terms. The unauthorized controlled vocabulary terms are added to the collection, but the terms are not added to the controlled vocabulary list.

 Note: Items that do not have metadata in required fields are approved when approving all items.

Approve all pending items

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Full Approval Queue Actions box, select Approve All and click Go.
  3. The Approve Items page reloads, displaying a status message while the approval is in progress. You cannot approve or review other items or controlled vocabulary terms until completion.
  4. When the approval process completes, the Approve Items page displays an updated status and view of items in the pending queue.

Approve all pending items and index the collection

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Full Approval Queue Actions box, select Approve & Index All and click Go.
  3. The Approve Items page reloads, displaying a status message while the approval is in progress. You cannot approve or review other items of controlled vocabulary terms until completion.

When the approval process completes, the Approve Items page displays an updated status and view of items in the pending queue.

The index process begins as soon as approval is complete. For more information about indexing, see Build a collection index.

Delete all pending items

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Full Approval Queue Actions box, select Delete All and click Go. The Delete All page displays.
  3. Confirm that you want to delete all pending items by typing "OK" in the text box (case-sensitive), and then click Delete All.

 Caution: Choosing to delete all items from the pending queue deletes all items uploaded by any user. Click Cancel to return to the Approve Items page without deleting items.

The Approve Items page reloads, displaying an updated view of items in the pending queue.

Detailed Approval Queue Actions

The detailed approval queue actions let you edit and add items to the pending queue. If you use the detailed approval queue actions options, only the selected items are added to the collection. You cannot approve items that have unauthorized controlled vocabulary terms unless you first add those terms to the controlled vocabulary or edit them to conform. For more information, see Controlled Vocabulary.

 Note: A maximum of 100 items displays at a time. As items are approved or deleted, the display updates to show the next 100 items in the pending queue.

To edit and approve a single pending item (single approve):

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Detailed Approval Queue Actions box, click Edit for the item you want to edit and approve. The Edit Pending Item page displays.
  3. Edit the metadata as desired. If a field has a controlled vocabulary, you can view its controlled vocabulary list by clicking Controlled Vocabulary (or Shared Controlled Vocabulary, if shared). Controlled vocabulary conflicts are displayed by field at the top of the page. (You cannot approve items that have unauthorized controlled vocabulary terms unless you first add those terms to the controlled vocabulary or edit them to conform.)
  4. Click Approve. The Approve Items page is displayed, and the item is no longer shown as a pending item.

Approve one or more pending items (selected approve)

  1.  In the Detailed Approval Queue Actions box, select the item or items and click Approve. Items marked with an asterisk contain unauthorized controlled vocabulary terms.
  2. The Approve All page displays the items as they are approved (this may be brief).
  3. When all the selected items are approved, the Approve Items page displays, and the items are no longer displayed as pending items.

Delete selected pending items

In the Detailed Approval Queue Actions box, select the item or items and click Delete. The Approve Items page is displayed, and the items are no longer shown as pending.

 Note: Deleted items are permanently removed and are never added to the collection unless they are re-added and approved.

Scheduled approvals

Scheduled approvals approve all currently pending items and controlled vocabulary terms.

 Note: To add terms to the controlled vocabulary, you must use the detailed approval queue actions on the Approve Items page.

You can choose to set up an approval process to start once at a specified future date and time, or to use recurring approvals. This is a useful way to automate some of your collection management tasks and allow approval processes to run in the background during convenient times.

You may want to schedule related index processes, as well. For more information, see Build a collection index.

After you have set up scheduled approvals, you can view and cancel pending approvals.

 Note: All times are displayed in the time zone of your server.

Schedule a one-time approval process

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Scheduled Approvals box, click Add. The Manage Scheduled Approvals page displays.
  3.  In the Scheduled Approvals box, select the Once On option and specify the date and time that the approval process should start. Clicking in the date field displays a calendar that you can use to select a date.
  4. Click Schedule Approval to save. The Approve Items page displays the new scheduled approval as pending.
    • You may need to click See All in the Scheduled Approvals — Pending box to see all pending approvals because the box displays only the next three approval processes.

You can confirm that the process was successfully run by viewing the approval history.

Schedule a recurring approval process

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Scheduled Approvals box, click Add. The Manage Scheduled Approvals page displays.
  3. In the Scheduled Approvals box, select the Recurring At option and specify the time and day(s) that the approval process should always be started.
  4. Click Schedule Approval to save. The Approve Items page displays the new scheduled approval as pending.
    • You may need to click See All in the Scheduled Approvals — Pending box to see all pending approvals because the box displays only the next three approval processes.
  5. Confirm that the process was successfully run by viewing the approval history.

Cancel scheduled approvals

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Scheduled Approvals box, find the scheduled approval process you want to cancel, and then click Cancel.

If you have more than three pending approvals, click See All. The Scheduled Approvals page displays a list of all pending approvals. You can choose to cancel one or all scheduled approvals.

After clicking Cancel or Cancel All, a dialog box displays, confirming that you want to cancel the approval process(es).

 Note:

  • Canceling recurring pending approvals cancels all occurrences.
  • Alternatively, you can click Add to display the Manage Scheduled Approvals page, where you can review pending approvals, the approval history, and cancel approvals in one view.
  1. Click OK to confirm the cancellation. The Approve Items page displays, with the canceled scheduled approval(s) removed from the pending list.

Controlled Vocabulary

A controlled vocabulary defines a list of valid terms that can appear in metadata fields within CONTENTdm. A controlled vocabulary allows an administrator to restrict metadata in selected fields to specific words or phrases. Pending controlled vocabulary terms displayed on the Approve Items page are not authorized for the collection until you add or edit them.

Add. Adds the term to the controlled vocabulary.

Edit. Takes you to an edit list that provides you with a list of all items that contain the pending vocabulary term in their metadata. Clicking edit on one of those items lets you edit the term.

 Note: If you are administering a shared controlled vocabulary, any changes will also change the vocabulary in other fields and collections that use it. A good practice is to always review the list of fields and collections that share the controlled vocabulary before making changes, to help you determine the impact. For more information, see Use Controlled Vocabulary.

To add term(s) to the controlled vocabulary:

  1. Open CONTENTdm Administration and navigate to the Approve Items page.
  2. In the Detailed Approval Queue Actions box, review the terms in the Controlled Vocabulary list.
  3. Click the Add link for the term you want to add to the controlled vocabulary. Or you can click Add All to add all the displayed terms.
  4. The Approve Items page updates with the term(s) removed from the Controlled Vocabulary list.

To change or delete the term within the item:

  1. On the Approve Items page in the Detailed Approval Queue Actions box, locate the term that you want to add to the controlled vocabulary.
  2. Click Edit to display the Edit List, which enables you to then choose the item that contains the metadata to change.
  3. Click Edit next to the item. The Edit Pending Item page displays.
  4. Review the Conflicts list and edit or delete the term within the controlled vocabulary field.
  5. Click Approve to add the item to the collection.

 Note: If the term that you changed is not in the controlled vocabulary list, a message displays that the term is not in the controlled vocabulary field.
Clicking OK displays the Edit Pending Item page.

Approval History

The approval history lets you review the date, time, duration, and number of items for all past approval processes (both scheduled and immediate).

Review the approval history

Click the view approval history link in the upper-right corner of the Full approval queue actions.