10 Viewing and Annotating Documents

The WebCenter Content user interface has the ability to view documents directly in a standard browser next to the document properties. Single and multipage documents, revisions, and metadata can all be easily viewed without leaving the WebCenter Content user interface.

This chapter has the following sections:

10.1 About Viewing and Annotating Documents

Oracle WebCenter Content converts many document formats to versions that are displayed on the Document page within a standard web browser. This means that even if someone does not have the native software that created a document, they can still view and share the document.

In addition to viewing documents, you can annotate documents and perform a variety of tasks from the Document page, which has the following main sections:

Figure 10-1 Oracle WebCenter Content Document Page

10.1.1 Banner Section

In the banner section, you can perform the following tasks:

File an unfiled document or view the path to a filed document's location in the context of Oracle WebCenter Content
Mark a document as a favorite
View links to the document
Check in new revisions of documents
Access more tasks from the More menu
Log out of Oracle WebCenter Content

10.1.2 Preview Area

Depending on the document format and how your system is configured, Oracle WebCenter Content converts uploaded documents into formats that are viewable using a standard web browser or document viewer. If your system can display a viewable rendition of the document, it is displayed in the preview area. You can perform the following tasks using the toolbar in the preview area:

Going to specific pages
Zooming the page view
Adjusting the document width
Rotating the document
Viewing/hiding, filtering, and adding annotations.

Certain types of documents provide additional viewing and navigation tools, if enabled. The side of the preview area can expand to display thumbnail images of the document pages and the annotations list. You can navigate to specific pages of the document using thumbnails and to specific annotations using the annotations list.

Note:

If a particular document format (for example, .indd or .indt) cannot be converted to a web-viewable version, a blank page is displayed in the preview area.

10.1.3 Properties Section

The properties section displays a summary of document properties with the option to display all properties, including security metadata. From the document properties area you can do these tasks:

Download a copy of the native file
View or download any generated rendition
Download annotated versions of the document if the document has annotations.
Add attachments to the document
View and edit metadata and security properties
View workflow details of documents in a workflow and check in, approve, or reject items assigned to you.

10.2 Viewing Documents on the Document Page

Documents can be accessed from the Find Documents Page and viewed on the View Documents Page. How to access the documents depends on if the results list is set to display as List, Thumbnail, or Tabular:

If set to List or thumbnail, click either the thumbnail or document name to view the document
If set to Tabular, click the View icon or document name to view the document

10.3 Changing the Document View

The View Documents page toolbar allows you to change how a document is displayed in the preview area. Using the toolbar, you can:

Navigate multipage documents
Increase or decrease the display size of the document
Rotate the document page displayed in the viewer
View/hide, filter, and add annotations (If you do not have annotation privileges, the annotation related options do not appear in the toolbar.)

Additionally, the side pane of the preview area can expand to display thumbnail images of each page of the document and the annotations list. Click a page in the thumbnail pane to go to that page.

Figure 10-2 Oracle WebCenter Content Document Page Toolbar

10.4 Viewing Alternate Renditions

Alternate renditions are available for most documents when converted to HTML dynamically or when converted to some other web-viewable format at the time a document is uploaded. Dynamic conversions are not available for some native document formats, and also must be converted each time you select it. Web-viewable renditions are typically available for a wide range of native document formats and are converted once when a document is uploaded.

Dynamic conversions of documents can be viewed in a standard web browser outside of the View Documents page by:

Selecting View Dynamic Conversion from a contextual menu. To access the contextual menu, right-click a document in a results list.
Clicking Dynamic Conversion under the Renditions area in the Properties section of a View Documents Page.

Figure 10-3 Contextual Menu from Search Page

Web-viewable renditions of documents can be viewed in a standard web browser outside of the Document page by:

Selecting View Web Rendition from the list toolbar menu. To access the list toolbar menu, select a document in a results list.
Clicking Web-Viewable under the Renditions area in the Properties section of a View Documents page.

Rendition area of Summary Tab in Properties section

10.4.1 Viewing and Working with Digital Asset Renditions

Some digital assets such as images and videos may be set to have additional renditions created automatically. Select a digital asset rendition to display a tool bar next to the rendition title that allows you to download a rendition, copy a rendition to the rendition clipboard, get links to a rendition, or delete the rendition if you have rights to do so.

10.4.2 Use the Renditions Clipboard

What is on the renditions clipboard?

Renditions of files that you put here. These are one or more of the following:

The native file. This is the one that you or someone else first uploaded to the server.
The web-viewable rendition. This is nearly always created when you first upload the native file to the server.
Other renditions of this file that may have been created, usually by a process set up by the system administrator.

How did these renditions get onto this clipboard?

You added a rendition to the clipboard by selecting an item in a search result list and choosing the Add to Rendition Clipboard option. Or you did so using the rendition tool bar on the View Documents Summary tab.

What can I do with the renditions on the clipboard?

View a native file on a page within WebCenter Content: Click the item's thumbnail image, or select Open in New Tab from the context menu of the Native File link.
View the web-viewable file in a web browser: Click the Web-Viewable link or select Open in New Tab from its context menu.
View other renditions in their associated application: Click the rendition's link [or select Open from its context menu].
Download the renditions: Check the boxes for the renditions you want to download, then click the Download Renditions icon. Files are downloaded as a zip file through the Save As dialog.
Get links to renditions: Check the boxes for the renditions you want to get links to, then select the Get Link to Renditions icon. The links are listed in a pop-up box. You can copy and paste the links from here yourself, or you can use the special feature to send them in an email.

You can also remove a rendition from the clipboard by checking its box and selecting the Remove Renditions from Clipboard icon, or you can empty the clipboard of all renditions by clicking Empty.

10.5 Viewing the Native File

If you have the software to open a native version of a document, you can download a copy and view it using the native software by clicking Native File in the Renditions area on the Summary tab of a View Documents page. See Checking Out and Downloading Documents for information on downloading a document.

10.6 Viewing Previous Document Revisions

The preview area of the View Documents Page provides access to all previous revisions of a document. Revision numbers are listed above the View Documents page toolbar. Clicking a revision number displays that revision of the document in the preview area and the metadata of that revision in the document properties section.

Figure 10-4 Revision Tabs in Document View

10.7 Annotating Documents

Provided you have the permissions to do so, you can add or modify annotations to documents. Among other things, documents can be stamped Approved, have a particular text highlighted, or have a note addressing a specific issue added.

This section has the following topics:

10.7.1 About Annotation Security

When you create an annotation, you can set permissions for the annotation using the annotation toolbar. The usual options available are Standard (S), Restricted (T), and Hidden (H). The permissions you can set, and the annotations you can modify or see, are determined by the permissions you have been given by the system administrator.

Note:

Annotations created with Standard or Restricted permissions can be viewed by any user who has access to the document, but Hidden annotations can be viewed only by the user with Hidden privileges. To modify an annotation, the user must have either created the annotation or have the permission associated with the annotation. Permissions to modify annotations can be controlled through Content Server configurations.

10.7.2 Viewing and Hiding Annotations

Note:

A change in viewer technology starting with Imaging version 11.1.1.6.0 may cause stamp, sticky note, or text annotations created in earlier Imaging versions to be resized when first opened in the 11.1.1.6.0 version of the viewer. Redactions, line, and highlight annotations should not be affected. The change in size is caused by the ability of the new viewer to size annotations based on the resolution (in dots per inch) of the document image.

In some cases when viewing a document, annotations may get in the way of seeing information on the document you need to see. Click the Hide Annotations icon in the Document Page Toolbar to hide annotations on a document. Alternatively, click the Show Annotations icon to view all annotations on a document.

10.7.3 Creating Annotations

Selecting an annotation tool then clicking and dragging on a document creates an annotation and opens a toolbar for editing. Typical options on the editing toolbar include rotating the annotation, changing annotation color, and setting annotation permissions. Additional options are determined by the type of annotation. For example, the stamp annotation tool lets you choose from several stamps, and the note annotation toolbar lets you open a rich text editor.

Figure 10-5 Note Annotation with Annotation Toolbar and Rich Text Editor Displayed

Note annotation with toolbar and rich text dialog.

Once you have finished creating an annotation, save it using the Save button on the editing toolbar. Navigating away from a viewed document without saving changes may cause changes to be lost.

The following table lists and describes the types of annotations available.

Table 10-1

Annotation Style	Icon	Description
Text		Select then drag on document to display the editing toolbar. Enter the content in the description field of the toolbar.
Highlight		Select then drag on the current page to highlight a portion of the current page. Opacity and color are controlled by the accompanying toolbar.
Note		Select then drag on the current page to display the editing toolbar. Click the Edit Note icon in the accompanying toolbar to open the rich text dialog.
Redaction		Select then drag on the current page to cover a portion of the current page. Redaction annotations are placed based on coordinates and may shift with inconsistent use of fonts. If your redaction annotation has shifted, talk to your system administrator about ensuring that a consistent set of fonts is used across the server and clients.
Box		Select then drag on the current page to enclose a portion of the page in a box. The box color and border are controlled by the accompanying toolbar.
Stamp		Select then click the current page to add a predefined watermark annotation to the page. There are four default stamp options: Approved On Hold Received Rejected The stamp message, size, orientation, and opacity is controlled by the accompanying toolbar.
Line		Select then drag on the current page to add a line notation for underlining or striking through a word or image on the current page. Color, line width, and inclusion of arrowheads are controlled by the accompanying toolbar.

10.7.4 Modifying Annotations

After you create an annotation, you can modify aspects of the annotation using the same toolbar that you used to create the annotation. To display the toolbar, click the annotation you want to modify. Use the toolbar to modify the annotation in variety of ways, including:

Change the text in a text annotation by editing the description field in the annotation toolbar.
Change the text in a note annotation by clicking the Edit Note icon in the annotation toolbar to display the rich text editor.
Cut, copy, paste, reorganize and undo changes to content within a note annotation using the rich text editor.
Change an annotation background and border color using the background fill color and border color tools.
Change the opacity of a highlight or stamp annotation using the Annotation Opacity Level icon and the slider to fade or darken the annotation.
Resize or rotate a stamp annotation.
Change permissions to an annotation using the permissions drop-down menu in the annotation toolbar.
Move the annotation to a different location on a page by clicking and dragging to a new location.
Resize an annotation by clicking and dragging the edges of the annotation.

Note:

To modify an annotation, you must have appropriate permissions. See, About Annotation Security for details.

10.7.5 Viewing Annotation History

Select an annotation and click the Information icon on the annotation toolbar to view the annotation history.

Figure 10-6 Annotation History

10.7.6 Deleting Annotations

Select the annotation and click the Delete button in the annotation toolbar to delete an annotation.

10.7.7 Downloading Annotated Documents

If the document has annotations, an Annotations section is included in the Summary Properties page. This section lists downloadable versions of the document that have the annotations applied. Click on a particular version to download it.

The annotations you see on the downloaded document will depend on the permissions you have been given by the system administrator.

Note:

If a document has redactions and if you do not have the permission to see the content under redactions, you can download only the annotated version of the document. The options to download the native file and other rendition types are disabled.

10.8 Using Links

Links to view a document can be easily shared with others. If a person does not have rights to view a document, it remains secure and is not displayed. Document links can be displayed in these ways:

Clicking the Link icon in the View Documents page banner section
Selecting Get Links from the More menu in the View Documents page banner area
Clicking the Get Links icon in the results list toolbar on the Find Documents page
Right-clicking a document in a results list and select Get Link from the contextual menu

Links can also be displayed for folders and libraries.