Editing Digital Objects

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

Editing Digital Objects

Editors can view and edit metadata for all three object types (IE, representation, file) using the Web Editor interface. When you make changes to data in the repository, the system creates a working copy and locks the IE so that it is read-only to other users and cannot be opened for editing. Only after you have completed edits is the edited IE regenerated by the system and unlocked. The exception to this rule is when a staff user is editing access rights. Access rights are implemented immediately with no working copy generated. For more information, see Access Rights.

For information on adding and editing representations, see Adding a Representation: Process and Steps.

Editing Digital Collections

To add or edit a collection metadata element:

From the Metadata tab of the collection you want to edit, click Edit in the row of the metadata type.

Editing Existing Metadata for a Collection

The Add Tag page opens.

Add Metadata Tag

Click one or more elements from the list to add to your collection’s metadata.
Click Select.
The Full View page for the metadata type you selected opens. It contains the element(s) that you entered.

DC Full View Page

To enter data in the new field, click the text of the new field (in the above image, Date).
The DC Field page opens.

DC Field Page

A definition for the field and comments about its usage appear at the bottom section of the page (under the Help tab).

Enter a value for the field in the Update Value field.
Enter a qualifier value, if relevant.
To save the new value(s), click the Save Field button.
The DC (or other metadata) Full View page opens with the new field and value(s) in the list of tags.

DC Full View, Element Added

The metadata profile assigned to the material flow that was used to create the IE continues to be enforced.

From this page, you can:

Repeat the procedure and add another tag (click Add Tag)
Delete any tags (by selecting their check boxes and clicking the Delete button
Change the display of tags from tag name (“text”) to tag code or the reverse (click the Display Option button and select the code or name display)

Code Versus Text for Metadata Elements

View any error messages (Error Message Report tab)
Cancel your edits (click Cancel)
Validate the metadata changes you made (click the Validate button)

When you have finished with your edits, click the Save button.

The system saves your edits to the collection metadata.

Editing Metadata through the Web Editor Interface

To edit metadata from the Web Editor:

Access the object whose metadata you want to edit by running a search and selecting Info in the object’s row.
The Web Editor opens to your object.
If the object is not an IE, click the IE object level in the left pane.
Click the Actions drop-down menu in the lower right corner. If the option to Lock Object appears, select it and click the GO button. (If the object is already locked, move to the next step.)

Web Editor Page, Locking an Object

The page refreshes with a note in red informing you that the object is locked to your ID.

If Lock Object does not appear in the Actions drop-down menu, you (or another user) have already locked it for use or you are not authorized to edit the IE.

In the content pane, click the Metadata tab.

Web Editor - Metadata Tab

Editing Descriptive Metadata

To edit descriptive metadata:

In the Descriptive row, click Edit. The following appears:

Tag List

To edit a tag, click the tag. The following appears, for example:

Edit Tag

Enter a value and click Save Field.
To add a new tag, select Add Tag. The following appears:

Add Tag

Select a tag and click Select. The new tag is added to the list of tags.

Adding or Editing Source Metadata

The Rosetta Web editor allows you to add and edit metadata from original IEs, representations, or files when the metadata format does not conform to the standard Dublin Core used in most parts of the Rosetta system. This protects the integrity of the original metadata, which can be compromised when mapping to an often simpler DC format.

To add and edit source metadata:

From the Metadata tab of the Web editor, click the Add Metadata button.
The first step of the Add Source Metadata wizard opens.

Add Source Metadata Wizard - Step 1

To insert new metadata by entering text, select the Insert new (empty) option. To upload an existing metadata xml file, select Insert from PC.
The wizard prompts you to select your metadata type from a drop-down list.

Step 2 of the Add Source MD Wizard

If you selected the option of inserting an existing XML file from your PC, there will be an additional field for you to browse to the file on your PC and upload it.

For either selection, click the Edit Metadata button. The page opens to Text View.

Text View

To display Grid View, click Grid.

Grid View

You can add tags by clicking the tag types on the right side of the page. Add or edit the text. When you are finished, you can click the Validate button to check the XML. Rosetta displays any errors under the Error Message Report tab.
Click Save.

The source metadata is saved to the Rosetta repository. From there, it can be:

viewed through the Delivery module after an administrative user has edited the relevant XSL file(s); see the Delivery XSL section of the Configuring Delivery chapter of the Rosetta Configuration Guide.
published using a converter installed as a plug-in. Rosetta supplies one that converts source metadata in MARC XML format. This converter is available through the Developer's Network and Rosetta staff can use it to develop their own plug-in.

Adding a Logical Structmap

You can use the Rosetta Web Editor to add logical structmaps to representations.

To add a logical structmap to a representation:

In the Web Editor, select the representation to which you want to add the structmap.
Select the Metadata tab and click Add Metadata.
To insert new metadata by entering text, select the Insert new (empty) option. To upload an existing metadata xml file, select Insert from PC.
If you selected the option of inserting an existing XML file from your PC, there is an additional field for you to browse to the file on your PC and upload it.
Select Structmap from the drop-down list, and click Edit Metadata. The page opens to Text View.
Rosetta displays the physical structmap as a template for you to create a logical structmap.

Add Structmap – Text View

To display Grid View, click Grid.

Add Structmap – Grid View

You can add tags by clicking the tag types on the right side of the page. Add or edit the text. When you are finished, you can click the Validate button to check the XML. Rosetta displays any errors under the Error Message Report tab.
Click Save.
The structmap is added.

Added Sructmap

Click Edit to edit the structmap and Remove to remove it.

Generating a Logical StructMap

A logical <structMap> can be generated for a representation using the Generate Logical Structmap task. The generated structMap will be based on the content of each file's fileOriginalPath DNX value, with a forward or backward slash as a delimiter (the file name is ignored).

The tasks parameters are as follows:

Task Parameters
Parameter	Description
Preservation Type (required)	The preservation type of the representation for which the structMap is to be generated.
Replace existing	Replace existing logical structMap(s) with the newly-generated structMap(s). (Default = no; if yes, all existing logical structMaps in the representation are replaced.)

Objects will be tarred or flat based on the export_flat general parameter value. Refer to the General Parameters section in the System Administration Guide for further information.
This task can be added to an enrichment task chain.

If the folder of streams is flat (that is, if all files in the representation have the same fileOriginalPath), no logical structMap will be generated since this is the equivalent of a physical structMap.

Editing a Physical Structmap

You can use the Rosetta Web Editor to edit physical structmaps of representations.

To edit a physical structmap:

In the Web Editor, select the representation whose structmap you want to edit.
Select the Metadata tab and click Edit for the METS Section.

Edit Physical Structmap

Edit the Structmap Label, Root Label, and file label.
The edited labels now appear in the viewer.

Exporting Objects

Objects can be exported out of the Rosetta system to expedite their editing or review. The export function copies information as described in the following table:

Export Rules
Object Type	Objects to Export
IE	All representations and files in the IE are exported to an exports directory on the server.
Representation	The representation and all of its files are exported to an exports directory on the server. The export function exports the linked IEs and representations, but does not export any other representations in the IE.
File	The file is exported to the user’s hard drive or to an exports directory on the server.

The exported files are structured according to their initial structure when they were ingested into Rosetta. This information is saved in the fileOriginalPath DNX field. If you want to change this information, edit the path in this field.

To export an object:

Find the IE, representation, or file you want to export by conducting a search of the system.
Open the object in the Web Editor. (See Accessing the Web Editor.)
Select the IE, representation, or file in the tree view of the Web Editor.
Click the down arrow of the Actions drop-down field and select IE Export, Representation Export, or File Download, depending on your object type. Then click Go.

The system generates an export process and prompts the user for an export path and other export task-related parameters.

If the enforce_ar_export general parameter is set to true, Access Rights will be enforced during export. Certain representations, or the entire IE, may not be exported, in accordance with the IE/REP AR policies.

Log on to the server (if necessary) and locate the exported item in the directory specified.

AIP Export

You can export an AIP using the AIP Export task. This task exports the IE together with previous versions, associated files, and shared metadata . You can configure a task chain and add this task to it from Administration > General Task Chains. The AIP Export Task has the following parameters:

Export Path – The location to place the AIP. The path is relative to the IE Export path (../operational_shared/staff_work_area/{username}/export).
Preservation Type filter – select a preservation filter.
Include Shared Metadata – select to add a shared folder under the IE and include all versions of all shared metadata (AR, RP, CMS) for all levels (IE/representation/file.
Compress – select to create a tar.gz archive for each exported IE folder.
Ignore Missing data – select to export the IE even when data is missing from the file system. A warning message is written to the server log and the IE will be exported with all available data. When this checkbox is cleared, no data from the IE is exported and the IE is sent to the process exception queue.

Commit or Rollback Changes

When you have made changes to an object, you must indicate to the system that you want to save (commit) those changes or discard (roll back) them. Once you commit, the object will be saved as you determined and unlocked, and the object will be returned to the permanent repository.

To commit or roll back changes to an object:

From the Web Editor page of your object, select the object (IE, Representation, or File) in the tree view.
In the Actions drop-down menu, select Commit Changes to save the changes you have made or Rollback Changes to save the previous version of the object (without the changes you just made).
If you do not see the options for commit or roll back, click Lock Object from the Actions drop-down menu, then click Go and wait for the page to reload.
Click the Go button.
For events generated from changes in the Metadata tab and in the Contents tab for structural IEs, a dialog box opens asking you to confirm the commit with a reason field where you can enter a reason for the changes made.

For changes done with the following task services, you can add a reason in the task parameter when executing the task:
- Assign Access Rights
- Assign AR Policy to Files
- Assign AR Policy to Representations
- Create Copy Representation
- Assign Collection By Name
- Assign Collection By DC
- AssignRetentionPolicyTask
- UassignRetentionPolicyTask
- Generate Logical Structmap Task
- Update IE DNX
- Update REP DNX
- Update FILE DNX
The system commits or rolls back your changes. The Web page reloads with the following message appearing in red text:

“Currently Being Committed/Rolled Back By: Me. Refresh Page.”
Click Refresh Page to continue working on this IE.