Learn about Oracle WebCenter Content’s Redwood UI (user interface), Redwood UI Viewer and Redwood UI Outlook Integration (available on Marketplace).

Introduction

The Redwood UI, Viewer and Outlook Integration introduce a modern interface for WebCenter Content, created with the Oracle Redwood design system. This general-purpose interface is available as an optional standalone client application, enabling users to upload, search, browse, and manage documents within the repository. Additionally, the Redwood UI Viewer allows users to view documents, interact with document properties, and annotate documents. Redwood UI Outlook Integration offer users the ability to interact with documents and folders via Microsoft Outlook.

There are three main entry points to access the Redwood UI features:

Installation

Both the Redwood UI and the Redwood UI Viewer are included in a WebCenter Content component named RedwoodUI. This component is enabled by default in WebCenter Content on Marketplace, but an administrator can enable or disable it using the Component Manager tool found under AdminServer. To verify that the Redwood UI is properly installed, open the Component Manager and ensure that RedwoodUI is enabled. Redwood UI Outlook Integration is included in a WebCenter Content component named WccOutlook listed under Advanced Component Manager in the WebCenter Content web app. This component is disabled by default.

Component Manager page

Thumbnails

The Redwood UI leverages WebCenter Content thumbnail renditions, and these are especially prominent when documents are presented in the card layout. By default, WebCenter Content thumbnails are too small for the card presentation and will appear blurry on the screen. To correct this, it is recommended that you configure WebCenter content to generate larger thumbnail renditions. Optimally, the card view thumbnails need a minimum width of 220px and a minimum height of 113px.

WebCenter Content can either be configured to generate the thumbnails directly on the Content server, or thumbnail generation can be delegated to the Inbound Refinery Service Digital Asset Manager feature.

  ThumbnailWidth=220
  ThumbnailHeight=133
  graphicwidthlimit=220, graphicheightlimit=0

See Setting Up and Managing Image Conversions in the WebCenter Content documentation for full details on how to configure Digital Asset Manager rendition sets.


Note: Inbound Refinery thumbnail generation is an asynchronous process and may take several seconds to complete.

The Redwood UI will display a file icon as the thumbnail immediately after a file is uploaded and until the thumbnail generation process is complete.



The Redwood UI

The Redwood UI is a general-purpose user interface providing access to a broad range of WebCenter Content features. It requires minimal training because it is intuitive and simple. With it, you can easily store, secure, retrieve, and share any type of document.

The Redwood UI is accessed using IdcService=REDWOODUI.

.../cs/idcplg?IdcService=REDWOODUI

The Redwood UI is divided into five separate functional areas, or views, each accessible from the navigation menu at the bottom of the screen.



Administrator Configuration

The Configuration drawer, accessed from the user avatar menu at the top right of the branding header, provides general configuration settings for the Redwood UI. These settings affect the experience for all users.

Configuration Custom Branding Disabled Configuration Custom Branding Enabled

Custom Branding

You can set a custom logo, logo alt text, and custom branding text. Additionally, you can change the theme used by Redwood UI header to one of nine Oracle Redwood color themes: lilac, ocean, pebble, pine, plum (default), rose sienna, slate, or teal. Changing the theme changes the colors of the user avatar and the color stripe.

Custom Branded Header

The Custom Branding Logo can be any image URL. An image with a height of 40px is recommended. While the image can come from anywhere, it can be convient to simply use an image stored within WebCenter Content itself. To do this, first upload the image and ensure it is in a public security group. Then open the links properties tab for the image and copy the system generated download link to use in the branding logo configuration.

Redwood UI Configuration

You can change the default navigation tab that will be displayed when lauching the the RedwoodUI with no routing parameters. You can choose between initially navigating to the Libraries tab (the default) or to the Browse tab. Both the Libraries and Browse navigation routes lists items you have access to in the “Enterprise Libraries” folder, but the Libraries route additionally lists the System Libraries. After lauching into the default route, you can switch to other tab manually using the navigation bar at the bottom of the interface. (Note that the default setting does not override the ojr=libraires or ojr=browse parameter on the URL).

User Preferences

The user preferences dialog, The Configuration drawer, accessed from the user avatar menu at the top right in the branding header, provides per user preference settings, including user’s full name, email address, locale, and time zone. Before values can be changed, you first have to indicate that you want to “Override external user directory settings”. With this option checked, the fields in the dialog become editable.

Preferences Dialog

The Locale field in the preferences dialog only lists Locale that have been enabled in the the Localization Adiminstration page in the WebCenter Content Administration UI. The languages that can be enabled are: Arabic, Chinese-Simplified, Chinese-Traditional, Czech, Dansk(Danish), Deutch(German), English-UK, English-US, Español(Spanish), Estonian, Français(French), Français-Canada (French-Canada), Greek, Hebrew, Italiano(Italian), Japanese, Korean, Lithuanian, Latvian, Magyar (Hungarian), Nederlands(Dutch), Norwegian, Polski(Polish), Português-Brasil (Portuguese-Brazil), Português-Portugal(Portuguese-Portugal), Russian, Suomi(Finnish), Svenska(Swedish), Thai, Türkçe(Turkish), and Romanian.

See “Configuring Interface Language” in the document Administering Oracle WebCenter Content for details on how to enable Locales.



Common User Interface Elements

While each view in the Redwood UI has a unique purpose, there are some user interface elements that are common across all views.

Common User Interface Elements Diagram

Item Description
1 In the branding header located at the top of the screen, you will find the Oracle logo on the left and the user menu on the right.
2 Use the search bar to filter the results shown in the content area. You can choose from predefined facets (which vary based on view) listed below the search bar, or you can manually enter keywords. The results in the content area will be filtered automatically as filter terms are added and removed.
3 The items available to you based on the current view, permissions, and filter criteria are listed in this area of the screen. The results may include libraries, search results, child documents and folders, favorited items, or items in the trash, depending on the selected view. You can filter the results using the options in the search bar at the top of the screen. Depending on the chosen layout option, your results can be displayed as cards, list item rows, or a table.

You can select items in the content area by clicking directly on the item (anywhere other than the title text) or by selecting the item’s check box. Multi-selection is possible by selecting multiple item check boxes or using shift/alt/command to select items. Perform actions on the selected items using the action toolbar above the content area.

Clicking the title of an item will open or view it.
4 The navigation menu at the bottom of the screen is where you can switch to different areas of the Redwood UI. The currently opened view is highlighted, and you can navigate to any other view by selecting Libraries, Browse, Search, Favorites, or Trash.
5

The user avatar displays the logged in user initials. Clicking this item will display the user menu, containing the following items:

  • Configuration - Set general configuration for the RedwoodUI, including custom Branding settings and the default Navigation. The option is only available to administrators.
  • Preferences - Use to set user preferences, such as the user’s full name, email address, locale, and time zone.
  • Help - Open WebCenter Content documentation.
  • About - Display system information details, including the WebCenter Content version and the Redwood UI component version.
  • Logout - Log out of the system.
6 The Items in Workflow notification icon that provides a count of the number of workflow items that are currently assigned to you. The notification icon is not displayed when there are no workflow items assigned to you.
7 The action menu displays the actions available for items in the current view. Actions that create new content in the view (such as Create Library, Upload, or Create Folder) are always present in the menu. Other actions that apply to items in the view will only appear when one or more items are selected. The actions available depend on several factors, including whether a single item or multiple items are selected, your permissions for the selected item(s), and the values of various fields on the items.

If the browser window is too narrow to display all available actions for the selected items, any actions that do not fit will be “collapsed” into a More option. Clicking the More option will open a drop-down menu that provides access to all the actions that couldn’t be displayed in the main action menu area.
8 Choose the sort order for results in the content area. Generally, you can Sort by Name, Created Date, or Last Updated date and choose whether to sort Ascending or Descending.
9 Select the layout for displayed results in the content area. Choose from Card (Card Layout Icon), List (List Layout Icon), and Table (Table View Icon). See Layouts.
10 Configure the columns that will be presented in the table results. This control is only enabled when the Table (Table Layout Icon) layout is active. See Column Configuration under Search View.
11 Refresh results. This button refreshes the results displayed in the results area, synchronizing data with the server. It can be useful when you are expecting changes to the data that may have been caused by activity outside of the current session, or when real time updates to items already displayed may have been delayed for some reason.



The Libraries View

The Libraries view is the default view presented by the WebCenter Redwood UI. You can access it at any time by selecting Libraries in the navigation menu at the bottom of the screen. In the Libraries view, you are presented with all the top-level Enterprise Libraries available to you as well as the predefined System Libraries.

Redwood UI Libraries View

Item Description
1 Enter filter criteria to narrow down the results shown in the content area. In the Libraries view, the term “Libraries” is always included in this control, restricting the results to only Libraries. (If the “Libraries” term is removed, the user interface will automatically switch to the Search view.) You can enter keywords and/or select from predefined facets.

In the Libraries view, keywords search only the names of documents in the library or folder you are browsing, not any other metadata or full-text. Results will return matching any of the keywords entered.
2

Select from the set of predefined facets to further filter the available results. When you select a facet, it will be added as a capsule in the filter input control. You can then click on the facet capsule to choose specific facet values. Some facets allow for multiple values. In the Libraries view, the available facets are:

Facet Selection Values
Libraries Multiple Created By You
Favorited By You
Followed By You
Library Type Single Enterprise Libraries
System Libraries
3 The libraries available to you are listed in this area of the screen. The libraries presented may be filtered by options selected in the search bar at the top of the screen. Depending on the layout option chosen, your results may be presented as cards, list item rows, or as a table.

Items in the content area can be selected either by clicking directly on the item (anywhere other than the name text) or by selecting the item’s check box. Multi-selection is possible either by selecting multiple item check boxes or shift/alt/command to select items. Perform actions on the selected item(s) in the action toolbar above the content area.

Clicking the title of the item will perform the open/view action.
4 Create a new library. Only available if you have permissions to create new libraries. When creating a new library, a dialog opens where you must provide a Name, optional Description, and Security Group for the new library.
5 Select a library and then perform an action such as open, rename, and delete. The actions available in the menu will depend on the permissions you have to the selected library or libraries. When more than one library is selected, only actions that can be performed on all libraries in the selection are presented.

Libraries Viewer vs Enterprise Libraries Folder

The Libraries View displays both top level user-defined Enterprise Libraries as well as System Libraries. System Libraries are system-defined virtual libraries that return results based on a query. Checkout-Out Content, Content In Workflow, Expired Content, and Work In Progress are examples of System Libraries.

There is also an Enterprise Libraries folder that is the parent folder of all user-defined Enterprise Libraries. It is possible to browse into this folder in the Browse View. While they look similar, the browsing into the Enterprise Libraries folder is different from the Libraries View in that System Libraries will not appear when browsing.

Library View Actions

The following table describes all of the actions that are available in the Library View action menu.

Container Actions

Container actions are not dependent on the selection and are always present (for users with appropriate permissions).

Selection Actions



The Browse View

The Browse view provides access to documents filed in FrameworkFolder folders. You can access it at any time by selecting Browse in the navigation menu at the bottom of the screen.

Redwood UI Search View

Item Description
1 Enter filter criteria to limit the results presented in the content area. In the Browse view, the currently opened folder is the first term and is always present, scoping the displayed results to this folder. (If the scope folder term is removed, the user interface will automatically navigate to the Search view.) You can enter keywords and/or select from predefined facets.

In the Browse view, keywords search only the names of documents in the library or folder you are browsing, not any other metadata or full-text, and the scope of the search is limited to items contained in the displayed folder and not from any child folders. Results will return matching any of the keywords entered.
2

Select from the set of predefined facets to further filter the available results. When you select a facet, it will be added as a capsule in the filter input control. You can then click on the facet capsule to choose specific facet values. Some facets allow for multiple values. For Browse view, the available facets are:

Facet Selection Values
Item Type Single Documents
Folders
Items Multiple Belonging To You
Favorited By You
Followed By You
Checked Out By You
3 Expand items in the folder tree to see the full folder hierarchy within the current library. Clicking on any folder in the tree will navigate the Browse view to that folder, but the folder tree will continue to display the hierarchy for the current library. In this way, you can quickly browse around the full hierarchy of the library.

If you browse to a folder higher in the hierarchy than a library folder (either to the Enterprise Libraries folder or to the Root folder), then the root node of the tree will reset to that folder, reflecting the folder hierarchy at that level. If you re-enter a library folder at any time, the root node of the tree will change again to the library folder and remain as long as you are browsing within the library.
4 Select this button to expand or collapse to folder tree panel.
5 Use the breadcrumb to navigate through the hierarchical path from the top-level library to the currently open folder. Click on any folder in the path to navigate directly to it. To access folders above the top-level library (Enterprise Libraries and Root), use the folder drop-down menu to the left of the path. If the browser window is too narrow to display the full path, some items in the path will be truncated and collapsed into a drop-down menu for easy access.
6 Select this button to navigate to the current folder’s parent.
7 The documents and folders contained within the open folder and available to you based on permissions are listed in this area of the screen. The items presented may be filtered by criteria selected in the search bar at the top of the screen. Depending on the layout option chosen, your results may be presented as cards, list item rows, or as a table.
8 Select this action to upload new documents into the current folder. This option is always available in the menu, even when no items are selected. Note that this action uploads new content into the currently open folder only, making the new folder a sibling of the items displayed in the content area. It does not upload content into a selected subfolder. To upload content into a subfolder, first select and open the subfolder, then perform the upload action from within it.
9 Select this action to create a new subfolder within the current folder. This option is always available in the menu, even when no items are selected. Note that this action creates a subfolder only in the currently open folder, making it a sibling of the items displayed in the content area. It does not create a folder as a child of a selected subfolder. To create a folder inside a subfolder, first select and open the subfolder, then perform the create folder action from within it.
10 The action menu displays the actions available for documents and folders selected in the current view. The actions available depend on several factors, including whether a single item or multiple items are selected, your permissions for the selected item(s), and the values of various fields on the items.
11 Select this button to navigate to the Search View to search for items within this folder and optionally its child folders using the more comprehensive set of searching capabilities provided in the Search View. See Folder Scoped Search.

Browse View Actions

The following table describes all of the actions that are available in the Browse View action menu.

Container Actions (always present)
Document Selection Actions
Folder Selection Actions



The Search View

The Search view allows you to search for documents, folders, and libraries across the repository. You can access it at any time by selecting Search in the navigation menu at the bottom of the screen.

Redwood UI Search View

Item Description
1 Enter search criteria to find content in the repository. Results are presented in the content area. You can enter keywords and/or select from predefined facets.

Keyword search behavior is unique in the Search view in that results will return matching all terms.
2

Select from the set of predefined facets to further filter the available results. When you select a facet, it will be added as a capsule in the filter input control. You can then click on the facet capsule to choose specific facet values. Some facets allow for multiple values. For Browse, the available facets are:

Facet Selection Values
Documents Multiple Authored By You
Favorited By You
Followed By You
Type Multiple Application
Document
Security Multiple Choose from the available security groups
Account Multiple Choose from the available accounts
3 Select from this drop-down menu to set the scope of the items to be searched. Select one of Files (the default), Folders, or Libraries.
4 Search results are displayed in this area. Depending on the layout option chosen, your results may be presented as cards, list item rows, or as a table.
5 Select this action to upload new documents into the repository. This option is always available in the menu, even when no items are selected. Items uploaded in the Search screen are unfiled and not contained in a folder.
6 Select this action to create a query folder based on the current search criteria. You will be prompted to enter a name for the new query folder and choose its location.
7 The action menu displays the actions available for documents and folders selected in the current search results. The actions available depend on several factors, including whether a single item or multiple items are selected, your permissions for the selected item(s), and the values of various fields on the items.
8 Select this button to open the Advanced Search drawer. See Advanced Search.

Search View Actions

The following table describes all of the actions that are available in the Search View action menu.

Container Actions (always present)
Document Selection Actions
Folder Selection Actions
Library Selection Actions

The search bar in the Search View and the search bar in the Browse view differ in how they behave. Search in the browse view may be characterized as a filter limiting the listing of child items in the folder and keyword searching matches only with the name field. The search view is a true search returning results from the entire repository and matching a broader range of metadata fields. Folder Scoped Searching allows you to leverage the full range search functionality but also limit the results to being contained within a specified parent folder. Optionally, you can choose to return results either directly in the parent folder or also from any child folder of the parent.

To access Folder Scoped Search, select the Folder facet beneath the search criteria field. A _Folder Capsule will be added to the search criteria. Click this capsule to display a drop-down folder selector allowing you to select the scope folder. You can also choose whether to include Child Folder in the scope or not. (Child Folders are included by default.)

Redwood UI Scope Folder Selector

Once you have selected a scope folder, the capsule label will update to display the selected value. Additional search conditions can be added to further refine the results.

When folder scoped search is active, you can navigate to the Browse view for the selected folder by clicking the Browse “Folder” button (Add Action Icon) above the search criteria field.

An alternative way to enter scoped folder mode is to first browse to the folder in which you would like to search and then click the Search “Folder” and child folders button (Add Action Icon) above the filter criteria field. This will navigate to the Search View with the folder scope criterion already set.

Note:


The Folder Scoped Searching feature is only available with Oracle Text Search (SearchIndexerEngineName=ORACLETEXTSEARCH) and not when using only Metadata Search. Additionally, FoldersIndexParentFolderValues option must not be disabled (FoldersIndexParentFolderValues=true).

Advanced search forms provide more flexibility for entering search criteria. To use an advanced search form, you select the Open Advanced Search Drawer button next to the search criteria field in the general header area. Advanced search forms are only available when searching in Search view. They include the standard form listing all metadata fields, or profile forms listing only those metadata fields used in a specific profile set up by your system administrator. Using an advanced search form, you can search for metadata, full-text if it is configured, or a combination of both on all available fields.

Redwood UI Advanced Search Drawer

With the advanced search form, you can search for document properties such as security group, author, title, or other defining criteria.

Note:


Searches built using an advanced search form separate the metadata fields with the <AND> operator, meaning that each value entered into each field must be met in order to find a document. For example, if you enter January into the Title field and presentation into the Type field, then a search finds content only if it has a presentation type and has January in the title.

How do I use an advanced search form?

To search using an advanced search form:

  1. When searching, select a form from the Search Forms section of the search box menu.

  2. Enter values in the fields you want to search and click Search. For example, you can search for a document title, security group, or if configured for full-text search, then for text in a document. For information on using wildcards to help search, see Supported wildcards. For information on how to use search operators, see Search Operators.

After clicking search, an “Advanced Search” capsule will appear in the search criteria control and results for the search will be displayed in the listing area. You can click on the “Advanced Search” capsule to re-open the advanced search form and edit the entered search criteria. Clicking the X on the capsule will remove the advanced search.


Redwood UI Advanced Search Capsule

Additional facets and keywords can be added along with the Advanced Search capsule to further filter the results displayed in the listing area.


Supported Wildcards

The following wildcard behavior is supported in the search box and Advanced Search form:

Wildcard Behavior
* Enter to represent an infinite number of unknown characters.
? Enter to represent a single unknown character. Enter multiple times to represent a specific number of unknown characters.
Search operators

If you use an advanced search form rather than the search box, you can use search operators to refine the search criteria. These operators are listed as options in lists to the left of each field.

Operator Description Example
Contains

Finds content items with the specified whole word or phrase in the metadata field.

This operator is available only for Oracle Text Search, or for Oracle Database and Microsoft SQL Server database with the optional DBSearchContainsOpSupport component enabled. For more information, contact your system administrator.

If you enter form in the Title field, the search returns items with the whole word form in their title, but does not return items with the word performance, reform, or format.
Matches Finds items with the exact specified value in the metadata field.

When you enter address change form in the Title field, the search returns items with the exact title of address change form.

A query that uses the Matches operator on a non-optimized field behaves the same as a query that uses the Contains operator.

For example, if the xDepartment field is not optimized, then the query xDepartment Matches ‘Marketing’ behaves like xDepartment ContainsMarketing’, returning documents that have an xDepartment value of ‘Marketing Services’ or ‘Product Marketing’.

Has Word Prefix Finds all content items with the specified prefix at the beginning of at least one word in the metadata field.

If you enter form in the Title field, the search finds all content items whose title includes the words form and format, but does not find the words performance or reform.



Column Configuration

All standard views provide a default set of columns that are displayed in the results area when the Table(Table Layout Icon) layout is active. (Note: The set of default columns displayed varies from view to view.) However, you can customize the display by reordering and/or hiding columns using the Columns button at the top right of the view. This button is only active when Table layout is selected. After clicking this button, you are presented with the Columns configuration dialog. In this dialog, you can deselect items to hide them from being displayed and use the drag handles to reorder them. At anytime, you can click Restore defaults to restore the default configuration for the view.

Columns Configuration Dialog

Standard column configuration is available in the Libraries, Browse, Favorites, and Trash views. However, the Search view offers a more advanced column configuration ability where you are not limited to only the default fields. In Search view, you can include nearly any document metadata field in the results area. Additionally, you can create named column configurations that are persisted and can be recalled at any time.

In Search view, the Columns button at the top left of the results area is presented as a combination button and drop-down menu. The columns drop-down menu allows you to select from the column configurations you have created. You can also choose Manage Configuration to create new configurations, edit existing ones, and remove ones you no longer need.

To create a new configuration:

Select Manage Configuration from the columns drop-down menu. The Columns Configuration Dialog is displayed listing your existing configurations.

Columns Configuration Dialog

Select New to create a new configuration. In the New Configuration dialog, give your new configuration a name and then click the Add Column (Add Column Icon) icon to add columns. Next, in the Available Columns dialog, choose columns from the collapsible System, Standard, and Custom sections. Only columns that are not already in the configuration are listed. Click Add when ready.

New Columns Configuration Available Columns

Once columns have been added into the New Configuration dialog, you can reorder them and/or remove them from the configuration. You can use the Add Column (Add Column Icon) icon again to select additional columns. Once the configuration is defined the way you want it to be, click OK. Your configuration will be added to the New Configuration dialog.

New Configuration Dialog

You can click the edit icon (Edit Icon) to edit the configuration, click the delete icon (Delete Icon) to delete the configuration, or click New again to create another configuration. When you have finished creating and editing configurations, click Done to close.

Columns Configuration Dialog

Once you have closed the Configuration dialog, your new configuration is available for selection in the Columns drop-down menu. Clicking the Columns button directly instead of the drop-down menu will directly open the Column configuration dialog for the currently active configuration.

Columns Configuration Dialog

The Favorites View

The Favorites view provides access to favorited documents, folders, and libraries. You can access it at any time by selecting Favorites in the navigation menu at the bottom of the screen.

Redwood UI Favorites View

Item Description
1 Enter filter criteria to narrow down the results shown in the content area. In the Favorites view, the term “Favorites” is always included in this control, restricting the results to only Favorites Items. (If the “Favorites” term is removed, the user interface will automatically switch to the Search view.) You can enter keywords to further filter results.

In the Favorites view, keywords search only the names of documents in the library or folder you are browsing, not any other metadata or full-text. Results will return matching any of the keywords entered.
2 The documents, folders, and libraries you have favorited are displayed in this area of the screen. The items presented may be filtered by criteria selected in the search bar at the top of the screen. Depending on the layout option chosen, your results may be presented as cards, list item rows, or as a table.
3

The action menu will display actions that can be performed on the selected items in the current view. The Favorites view has a limited set of actions that may be performed. The actions are:

  • View / Open
  • Download
  • Properties

Favorites View Actions

The following table describes all of the actions that are available in the Search View action menu.

Folder and Library Selection Actions
Document Selection Actions



The Trash View

The Trash view provides access to documents, folders, and libraries that have been deleted. You can access it at any time by selecting Trash in the navigation menu at the bottom of the screen.

Redwood UI Trash View

Item Description
1 Enter filter criteria to narrow down the results shown in the content area. In the Trash view, the term “Trash” is always included in this control, restricting the results to only item in the Trash. (If the “Trash” term is removed, the user interface will automatically switch to the Search view.) You can enter keywords and/or select from predefined facets.

In the Trash view, keywords search only the names of documents in the library or folder you are browsing, not any other metadata or full-text. Results will return matching any of the keywords entered.
2

Select from the set of predefined facets to further filter the available results. When you select a facet, it will be added as a capsule in the filter input control. You can then click on the facet capsule to choose specific facet values. For Trash, the available facets are:

Facet Selection Values
Item Type Single Documents
Folders
3 The documents, folders, and libraries in your trash are displayed in this area of the screen. Depending on the layout option chosen, your results may be presented as cards, list item rows, or as a table.

Documents and folders in the Trash view cannot be opened or viewed. The title of the item is presented as read-only text field and clicking on the title will not perform any action. Items must be restored to their original location to be opened or viewed.
4

The action menu will display actions that can be performed on the selected items in the current view. The trash view has a restricted set of actions that are not based on the items type or attributes. Rather the actions are exclusive to the item being in Trash. The actions are:

  • Empty - Permanently deletes all items in the trash. This item is present at all times, even when there is no selection.
  • Delete Permanently - Permanently deletes the selected items only. This action displays a confirmation dialog before completing the action since those items cannot be recovered once deleted.
  • Restore - Removes the selected item(s) from trash. The items will be restored to their original location.

Trash View Actions

The following table describes all of the actions that are available in the Trash View action menu.

Container Actions (always present)
Selection Actions



Layouts

Card Layout

In the Card layout, result items in the content area are presented as cards arranged in a grid. This view prioritizes the visual representation of each item by displaying a large icon, making it easier to visually distinguish one item from another.

Redwood UI Card Layout

The card for each result displays the following elements.

List Layout

In the List layout, result items in the content area are presented as rows in a list. The icons are smaller than in card view, but more detail is presented for each item.


Redwood UI List Layout

The list view row for each result displays the following elements.

Table Layout

The Table layout displays result items in a table format, offering more detail.

Redwood UI Table Layout

By default, the table view presents items with the following columns, in order from left to right:

The action column contains up to three action icons:

Table Configuration

In the table view layout, columns can be reordered at any time by dragging the column headers left or right. Additionally, you can use the columns button next to the layout controls to open the Columns configuration dialog, where you can show or hide columns in the table (but note that the only exception is the Name column, which cannot be hidden and must always remain in the first position.) Column configuration changes are stored locally in your browser and will not be available if you log in from a different browser.



Properties Panel

The properties drawer displays comprehensive details about a selected library, folder, or file, and allows you to edit metadata, security settings, and other attributes. Properties is present in the results listing views (Libraries, Browse, Search, etc.) as a drawer that can be accessed from either the Properties action menu action or from the Properties instant action icon on the card, list row, or table row actions column. Properties is also available in the document viewer as a collapsible sidebar on the right.

Summary Tab

The Summary tab displays general details about a document, folder, or library. The panel is divided into multiple sections.

  • Library - Displayed only for Library items. Displays the library Owner, Library ID, Created By user, Create date, Last Updated By user, and Last Updated date.
  • Folder - Displayed only for Folder items. Displays the folder Owner, Folder ID, Created By user, Create date, Last Updated By user, and Last Updated date.
  • Revision - Displayed only for document items. Displays the document Name, Title, Author, File Size, Checked Out status, Status, Create date, Release Date, Expiration Date, Comments, Profile, Type, Format, Rendition Set, and ID.
  • Renditions - Displayed only for document items. Lists the available renditions of the document, presenting the rendition Name, Format, and Size.
  • Attachments - Displayed only for document items. Lists the available attachments to the document, presenting the attachment Name and File.
  • Document - Displayed only for document items. Lists additional fields for a document including Content ID and Owner.
Properties Summary Tab

Metadata Tab

The metadata tab displays the metadata fields for a document, folder, or library. For documents, the metadata is shown according to the assigned profile, with the profile name labelled at the top of the panel. You can switch to viewing all standard fields using the Switch to Standard Fields link and return to the profile view with the Switch to {Profile Name} link.

If you have permission to edit the metadata, click the Edit button at the bottom of the panel to enter edit mode. In edit mode, you can modify metadata values. To save your changes, click Save at the bottom of the screen, or click Cancel to exit edit mode without saving.
Properties Metadata Tab

Smart Content

When Smart Content is enabled on the WebCenter Content Server (with both SmartContent and DocumentTagging components enabled), an xDocumentTags metadata field is added to the document. If this field is included in the displayed profile, it appears on the Metadata tab with a specialized tag control. In this control, Smart Tags are identified by a “#” prefix, distinguishing them from user-added tags. In metadata edit mode, you can remove tags (including smart tags) by clicking the “x” on the tag. New tags can be added by typing directly into the tag control and pressing Enter to create a new tag entry.

Smart Tagging is enabled on a per Enterprise Library basis. You can enable the functionality when creating a new library by toggling the Enable Smart Tagging option in the Create Library dialog.

For an existing library, you can see and change this setting in the Options section at the bottom of the Metadata properties panel for the library.
Properties Metadata Tab Options

Properties Metadata Tab Options Edit

Security Tab

The Security tabs display security-related attributes for documents, folders, and libraries. The specific fields displayed may be limited by the profile assigned to the document, but the Security tab will display the following information when the corresponding fields are present in the profile:

  • Security Group
  • Account
  • User Access List
  • Group Access List
  • Role Access List

If you have permission to edit the metadata, click the Edit button at the bottom of the panel to enter edit mode. In edit mode, you can modify security attribute values. To save your changes, click Save at the bottom of the screen, or click Cancel to exit edit mode without saving.

Note:


The Access List fields are available when Access Control List Security is enabled. See Administering Oracle WebCenter Content Links: Managing Access Control List Security .

If Access Control List Security has been enabled and is subsequently disabled (for example, the RoleEntityACL component is disabled), the Role Access List field may continue to appear, but values entered into it will no longer persist. To hide this field, an administrator can uncheck “Enable on User Interface” in the Configuration manager for the ClbraRoleList field.

Properties Security Tab

Revisions Tab

The Revisions tab lists revisions for a document. The per-item action menus allow you to:

  • Make Current (For all revisions other than the current)
  • Download
  • Delete
Properties Revisions Tab

Annotations Tab

The Annotations Tab lists annotations for a document. When accessed in the sidebar of the document viewer, if annotations are currently being displayed on the document, selecting an annotation from the list will highlight that rendition in the document.

Properties Annotations Tab

The Links tab provides access to various links associated with a document. The System Links section offers Preview and Download links for the latest version of the document. You can click these links to navigate directly to the content or use the Copy to Clipboard button to copy the URL for use in another application. The action menu to the right of the System Links section allows you to expand and view additional links. Here, you’ll find Preview and Download links for the specific revision currently being viewed in the document viewer (when accessing the Links tab from the document viewer sidebar).

You can also create one or more public links, granting adhoc access to files and folders to users who do not otherwise have access to the content. See Public Links.

Properties Links Tab

Workflow Tab

The Workflow tab provides access to workflow actions for items currently active in a workflow. It displays detailed information about the current workflow status including the steps and outcomes for steps through which the item has progressed. You can also see the history of past work flows the item has already completed. See Workflow for more details on working with items in workflow.

Properties Workflow Tab

Chat Tab

The chat tab provides access to the Generative AI Chat with Document feature. This feature allows you to chat about the currently selected document with the virtual Chat Assistant. This tab is only available in the Redwood UI Viewer.

See Chat with Document.

Properties Chat Tab



Document Upload Drawer

The document upload drawer is where you will upload new content to the repository and where you will check in new revisions of existing documents. You access this drawer by clicking the Upload action from Browse and Search Views or by clicking the Check In action for a selected document.

Redwood UI Browse View

With the drawer open, you can select documents to upload from your computer by clicking the Add (Add Action Icon) button at the top or clicking the “Document Upload” prompt in the center of the drawer. Alternatively, you can drag files from your desktop in to the drop area.

Redwood UI Browse View

After files are selected, you will see them listed in the drawer. You can repeat the above step by clicking the Add (Add Action Icon) button again to add more files, or you can click the “X” icon to the right of any item to remove it.

Redwood UI Browse View

The list displays details about the items to be uploaded, including a small thumbnail (or a generic icon for non-image file types) and the file name. If there are required metadata fields that need to be provided before uploading, the Status column will show “Not Ready,” and the Upload button at the bottom will be disabled.

While entering metadata, you can select the profile that will be used when checking in the documents. All documents in the upload will use the same profile.

Once all upload requirements are met, the Status column will change to “Ready” and the Upload button at the bottom will become enabled, allowing you to start the upload process. As each file uploads, a progress bar will appear in the row for that item, and the Status will change to “Active”. Once the upload is complete, the Status will update to “Finished”. When all items in the list have a “Finished” status, the Cancel button will change to Close, which you can click to close the drawer.

Location Selection

When uploading a folder in the Browse view or when checking in a new version of an existing document, the folder location of the document is fixed to the currently open folder or the current document location respectively and cannot be changed. However, when uploading a new document from the Search View, you can optionally select a folder location for the new document. If no location is selected, the document will be uploaded in the unfiled state.

Upload Location Selection

With the public links feature, you can create a link to share individual files, or an entire folder, with users who do not otherwise have access to the content. You can email these links, share them in an instant message or paste them in a document. Sending a link is useful if you need to give access to people on an as-needed basis and when you want tight control over how and when that access is made available.

Links are configured to expire on a particular date and can optionally require a passcode for access. You have the ability to manage the link even after it has been sent out. You can adjust the expiration date, change the passcode requirement, or delete the link all together making it no longer accessible.

To access public links for a document or folder, select the item from either the Browse View or Search View, and click the Get Links toolbar action to open the properties side panel Links tab. Alternatively, you can select the Properties action and manually navigate the Properties panel to the Links tab.

You can also access the Public Links feature from the document viewer by clicking the Link action (Link Action Icon) in the viewer header area.

On the properties panel Links tab, you will find, in addition to the system defined Preview and Download link, the Public Links section listing all existing public links for the document or folder. Each entry lists the Name of the link, its description, the expiration date, and optionally the “key” icon (Key Icon) indicating that the link requires a passcode.

For each link, you can see both the Preview and Download link. (Note: for document links these are links to the latest version of that document.) You can click the copy to clipboard action button to copy a link for pasting in another application. Click select the more actions menu (…) to edit the link attributes.


Properties Links Tab


Click the Add Public Link button at the bottom of the Public Links list to create a new public link. The Public link edit form is opened where you can enter the link Name and Description, set Permissions the link provides to the content, optionally enter a Passcode for the link, and set the Expiration Date for the link.


Properties Links Tab


Note:


If provided, the Passcode must be at least 8 characters in length and can contain only alpha-numeric characters.

An Expiration Date is required and will default to a date of 30 days from the date the link is created if not provided. The Expiration Date is limited to a maximum of 180 days.

Workflow

About Workflows

A workflow specifies how to route content for review and approval before it is released to the system. The workflow notifies users by e-mail when they have a file to review, and by displaying a workflow notification icon in the banner next to their user name.

Workflow Types

From a workflow participant’s point of view, there are two types of workflows:

Entering a File to a Workflow

If you have been assigned as a contributor to a basic workflow, it notifies you that you have an item in the workflow by e-mail and a notification flag in the branding header next to the user menu.

Workflow Checkin Message

To start the workflow, you must check in the designated files as the first step. To do so, click the Items in Workflow notification icon (Items in Workflow Notification Icon) on the home page banner to display a listing of all the workflow items assigned to you. The notification icon provides a count of the number of workflow items that are currently assigned to you. The notification icon is not displayed when you there are no workflow items assigned to you.

Alternatively, you can open the Redwood UI to the Libraries view and open the Content In Workflow system library.

In either case, the resulting list displays all the content items assigned to you. Items requiring contribution will appear in the list with generic icons and opening the properties for the item will reveal a message banner indicating the item is waiting for you to check in a new document.


Workflow Contribution Thumbnail Workflow Contribution Message


Do one of the following:


Workflow Checkin Message

Clicking the Check In button opens the Check In Workflow Content drawer, which is an instance of the standard Document Upload Drawer. In this, you are limited to selecting a single file for upload.

Select a profile and optionally choose the folder location for the document to be checked in. If no location is selected, the result to document will be added in unfiled state.

Workflow Checkin Message

Select a file to check in and fill in the check-in form, then click Upload, noting the following:

Reviewing Workflow Items Assigned to You

When you are assigned to the current step in a workflow, you receive an e-mail message and a notification flag in the branding header next to the user menu. When the required number of reviewers approve the revision, the content item goes to the next step in the workflow.

To review a file in a workflow, click the Items in Workflow notification icon (Items in Workflow Notification Icon) on the home page banner to display a listing of all the workflow items assigned to you. Alternatively, navigate the Redwood UI to the Libraries view and open the Content In Workflow system library. The resulting list displays all the content items assigned to you. Workflow items are assigned to you when you have a responsibility to check in or review the item.

Select an item requiring approval and the toolbar will present actions to Approve or Reject the item. If you open the Summary tab in the properties panel for the item, you will see a message banner with similar actions to Approve or Reject.


Workflow Approve or Reject Message


Actions For Workflow Items

Workflow Details

To obtain details of the current workflow as well as the workflow history for a document, click the Details button in the workflow message banner on the Summary tab to open the Workflow sidebar panel. Alternatively, you can open the properties sidebar panel and manually select the Workflow sidebar panel tab.


Workflow Properties Panel

Chat with Document

The Chat with Document feature is available via integration of Generative AI technology with WebCenter Content. This feature allows you to ask natural language questions about the content of textual documents stored in a WebCenter Content repository. For example, you might ask whether a specific expense is covered based on the requirement details in a company’s expense policy document. Or, you might ask if a particular RFP term is compliant with a corporate sale proposal guideline document.

Note:


The Chat with Document feature will only appear if WebCenter Content is configured by an administrator to support it. Refer to the appropriate WebCenter Content documentation.

You can access the Chat with Document feature from a text document (Word Document, PDF, etc.) by selecting the Chat toolbar action or by selecting the Chat (Chat Action Icon) quick action icon on the item row or card. Using either of these options will open the document in the Redwood UI Viewer with the properties Chat panel open.

If you are already viewing a document with the Redwood UI Viewer already open, you can access the Chat feature by clicking the Chat action icon in the viewer header. Or you can simply select the Chat tab in the properties sidebar.

Once the Chat properties panel is open, the Chat assistant will introduce itself, and ask you if it can summarize the selected document. Or, you can ask the assistant questions about the document in the “Enter Message” text field at the bottom.


Chat with document



The Redwood UI Viewer

Features of the Redwood UI Viewer

The Redwood UI viewer user interface supports the following key features:

Redwood UI Viewer URL

In addition to being accessed through links from the native WebCenter Content UI, the Redwood UI Viewer can be accessed directly using the viewer service URL. The service for the viewer is displayed on the Content Information form in the UI as shown above.

.../cs/idcplg?IdcService=REDWOODUI_VIEWER&dID=123

URL Configuration Reference

This URL will present the viewer with all functionalities enabled. However, individual elements of the viewer can be disabled and/or enabled using the parameters on the URL. 

Parameter Type Comments
embed Boolean

If false, all options are presumed to be on unless explicitly turned off.

If true, all options are presumed to be off unless explicitly turned on.

When not provided, this option defaults to false.

dID String The dID of the document to display.
thumbnails ‘on’ | ‘off’

Determines whether the thumbnail panel is displayed.

When not provided, the default is determined by the value of the embed option. It is ‘off’ if embed is true.

topbarControls ‘on’ | ‘off’ | ‘custom’ Sets the behavior of top bar control configuration.
  • on - all config options are implicitly ‘on’. (topbarControlsConfig is ignored.)
  • off - all config options are implicitly ‘off’. (topbarControlsConfig is ignored.)
  • custom - options must be individually defined as ‘on’ or ‘off’ in the topbarControlsConfig parameter.)
topbarControlsConfig object

Required when topbarControls=custom. Default value for each property is ‘off’.

{
  documentLink?: 'on'|'off',
  downloadLink?: 'on'|'off',
  revisionLink?: 'on'|'off',
}
  • documentLink: - Display or hide the document link button.
  • downloadLink: - Display or hide the download link button.
  • revisionLink: - Display or hide the revision label/button.
properties ‘on’ | ‘off’ | ‘custom’ Sets the behavior of properties configuration.
  • on - all config options are implicitly ‘on’. (propertiesConfig is ignored.)
  • off - all config options are implicitly ‘off’. (propertiesConfig is ignored.)
  • custom - options must be individually defined as ‘on’ or ‘off’ in the propertiesConfig parameter.)
propertiesConfig object

Required when properties=custom. Default value for each property is ‘off’.

{
    summary?: 'on'|'off',
    metadata?: 'on'|'off',
    security?: 'on'|'off',
    revisions?: 'on'|'off',
    annotations?: 'on'|'off',
    links?: 'on'|'off'
}
  • summary: - Display or hide the Summary properties panel.
  • metadata: - Display or hide the Metadata properties panel.
  • security: - Display or hide the Security properties panel.
  • revisions: - Display or hide the Revisions properties panel.
  • annotations: - Display or hide the Annotations properties panel.
  • links: - Display or hide the Links properties panel.
imageControls ‘on’ | ‘off’ | ‘custom’ Sets the behavior of image controls configuration.
  • on - all config options are implicitly ‘on’. (imageControlsConfig is ignored.)
  • off - all config options are implicitly ‘off’. (imageControlsConfig is ignored.)
  • custom - options must be individually defined as ‘on’ or ‘off’ in the imageControlsConfig parameter.)
imageControlsConfig object

Required when imageControls=custom. Default value for each property is ‘off’.

{
    fitWidth?: 'on'|'off',
    fitPage?: 'on'|'off',
    actualSize?: 'on'|'off',
    fullWidth?: 'on'|'off',
    fullScreen?: 'on'|'off',
    zoomSlider?: 'on'|'off',
    rotation?: 'on'|'off',
    annotations?: 'on'|'off',
    filterAnnotations?: 'on'|'off',
    createAnnotations?: 'on'|'off'
}
  • fitWidth: - Display or hide the Fit width tool on the image viewer toolbar.
  • fitPage: - Display or hide the Fit page tool on the image viewer toolbar.
  • actualSize: - Display or hide the Actual size tool on the image viewer toolbar.
  • fullWidth: - Display or hide the Full width tool on the image viewer toolbar.
  • fullScreen: - Display or hide the Full screen tool on the image viewer toolbar.
  • zoomSlider: - Display or hide the Zoom Slider tools on the image viewer toolbar.
  • rotation: - Display or hide the Rotate left and Rotate right tools on the image viewer toolbar.
  • annotations: - Display or hide the Show annotations tool on the image viewer toolbar.
  • filterAnnotations: - Display or hide the Filter annotations tool on the image viewer toolbar.
  • createAnnotations: - Display or hide the Create annotations tool on the image viewer toolbar.
videoControls ‘on’ | ‘off’ | ‘custom’ Sets the behavior of video controls configuration.
  • on - all config options are implicitly ‘on’. (videoControls is ignored.)
  • off - all config options are implicitly ‘off’. (videoControls is ignored.)
  • custom - options must be individually defined as ‘on’ or ‘off’ in the videoControls parameter.)
videoControlsConfig object

Required when videoControls=custom. Default value for each property is ‘off’.

{
    fitWidth?: 'on'|'off',
    fitPage?: 'on'|'off',
    actualSize?: 'on'|'off',
    fullScreen?: 'on'|'off',
    zoomSlider?: 'on'|'off'
}
  • fitWidth: - Display or hide the Fit width tool on the video viewer toolbar.
  • fitPage: - Display or hide the Fit page tool on the video viewer toolbar.
  • actualSize: - Display or hide the Actual size tool on the video viewer toolbar.
  • fullScreen: - Display or hide the Full screen tool on the video viewer toolbar.
  • zoomSlider: - Display or hide the Zoom Slider tools on the video viewer toolbar.

Object properties can either be provided using a full JSON syntax or in simplified JavaScript literal syntax.

Examples

Example 1

Hide all features (only the center area is displayed):

.../cs/idcplg?IdcService=WCC_VIEWER&dID=123&embed=true

Example 2

Hide all features and then show the thumbnails panel:

.../cs/idcplg?IdcService=WCC_VIEWER&dID=123&embed=true&thumbnails=on

Example 3

Show all features (embed=false is implied), but hide the properties panel:

.../cs/idcplg?IdcService=WCC_VIEWER&dID=123&properties=off

Example 4

Hide all features, but show the top bar with only the revision link button, show the thumbnails panel, and show the properties panel with only the Revisions tab:

.../cs/idcplg?IdcService=REDWOODUI_VIEWER&dID=123&embed=true&topbarControls=custom&topbarControlsConfig={"revisionLink":"on"}&thumbnails=on&properties=custom&propertiesConfig={"revisions":"on"}



Annotating Documents

If you have the necessary permissions, you can add or modify annotations to documents. Among other options, documents can be stamped Approved, have a particular text highlighted, or have a note addressing a specific issue added.

About Annotation Security

In some cases, not all annotations should be seen or allowed to be modified by all people. For example, upper management may annotate a request for proposal with pertinent information regarding an upcoming merger. Legally they may not be able to share that information with others in an organization who need access to that proposal, so the annotation permission is set to hide the annotation from those without proper permissions. Or perhaps a manager annotates a raise request denying the raise. The annotation can be restricted so the person who made the request cannot approve it by modifying the annotation. Or a document may contain personal information such as Social Security numbers or health issues that need to be redacted and protected. Redaction annotation can be set to restricted to prevent others from hiding or modifying them to see the information.

When you create an annotation, you can set permissions for the annotation using the annotation toolbar. 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. Generally, the following options are available in the toolbar:

Note:


If no annotation security is assigned to a person, they cannot create new or modify existing annotations. However, they still can view all Standard and Restricted annotations. This ensures that redaction annotations are applied for all people with rights to view a document. Users must be granted the security level they assign to an annotation. For example, users assigned only the restricted security level can grant only the restricted security level to any annotation they create. Users that have been assigned the standard and restricted security levels by an administrator can specify a security level of standard or restricted, but not hidden.

Note:


Redaction annotations cannot be marked hidden.

Show and Hide Annotations

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 Show Annotations tool (hotkey “a”) in the image viewer toolbar to toggle the display of annotations on the document.


This image shows the image viewer toolbar with the “Show annotations” button highlighted with a red square.


Create Annotations

Before creating annotations, you need to first select the page on which the new annotations are to be placed. Click on the page anywhere other than on an existing annotation. Alternatively, you can select the page from the thumbnails panel to the left of the screen. Once selected, the outer border of the page will change to a highlighted state.

Next, select the type of annotation you want to create from the “Create Annotations” tool drop-down menu on the image viewer toolbar. Choose from one of the following annotation types: Box, Highlight, Line, Redaction, Stamp, or Sticky Note.


This image shows the image viewer toolbar with the ‘Create annotation’ button highlighted with a red square and its drop-down menu open, showing the available annotation types.


Upon selection, a new instance of the annotation type will appear in the center of the selected page, and it will be displayed in its selected state. You can move it by dragging it around the page, resize it by adjusting one of the eight grab handles that appear around its perimeter, or adjust its properties by first selecting the pencil icon in the upper left hand corner of the annotation and then editing its attributes in the Annotations sidebar panel.


This image shows a newly created sticky note annotation in its selected state, with create icon grab handled and move cursor.


Edit Annotations

To edit an existing annotation, you first need to select it, either by clicking it directly on the page or by selecting it from the list in the Annotation sidebar. When selecting from the list in the properties panel, the document page will be scrolled so that the selected annotation is visible in the view port.

Once selected, you can move it by dragging the annotation around the page, resize it by adjusting one of the eight grab handles that appear around its perimeter, or edit its attributes in the Annotations sidebar panel.

To access the annotation’s attributes in the Attributes properties panel, you can either click the pencil icon directly on the annotation, or click the arrow on the right hand side of the item in the annotation lists in the properties panel. The attribute details panel for that annotation will slide in to the Attributes properties, revealing all of its available attributes. The specific attributes presented will vary based on the annotation type. To edit the attributes, click the Edit button at the bottom to enter edit mode, make changes and save or cancel as necessary. At anytime, you can return to the annotation list by click the Back button at the top of the Annotations properties panel.


Delete Annotations

To delete an annotation, you first need to select it and access its attribute details view, as described above. From the details view, select the Edit button at the bottom to enter edit mode. Select the Delete icon at the bottom to delete the annotation. Since this operation cannot be undone, a dialog will appear asking you to confirm your intention to delete the selected annotation.

This image shows the Delete icon available in the Annotations tab in Edit mode.

Filter Annotations

Use the filter tool on the image viewer toolbar to filter the displayed annotations by users. You can filter out or show annotations for all users or filter out or show annotations for specific users, including the annotations created by the current users. If annotations created by the current user (you) are filtered out and you try to create a new annotation, the filter for the current user will be cleared so that the newly created annotation can be displayed.

This image shows the image viewer toolbar with the “Filter annotations” button highlighted with a red square.



Accessing the Redwood UI Viewer from the Native WebCenter Content UI

The View in Redwood Viewer option that will allow you to open a document in the Redwood UI Viewer is available as a new Actions menu item in the search results. The Redwood Viewer option is also available in the Content Information page for a document in the links section. Note that these options are only present for logged-in users. The new document viewer is not yet supported for viewing publicly accessible documents anonymously.

This image shows the View File option on the Search Results page.

This image shows the View File option on the Content Information page.

If using Trays Layout preference (configurable from the user's profile page), the new UI appears embedded within the UI as shown here. In Top Menus Layout, the viewer will appear full page within the same tab window as the client. In either case, the browser's Back button will return to the page used to launch the viewer. 

This image shows the new UI embedded within the UI. On the left side, navigation options such as My Content Server, Browse Content, Search, Content Management, and Administration are available. On the right side, tabs such as Summary, Metadata, Security, and Revisions are available.

This image shows the viewer in the Top Menus Layout. It appears full page in this layout.


The Redwood UI Outlook Integration

Features of the Redwood UI Outlook Integration

The Outlook Add-in is contextual to the currently selected item and supports two flows: the first one, to embed documents and folders, either as links or as attachments, into the item, and the second one, to save the item’s content as a new document(s).

The add-in is available for mail and calendar items, either new or existing. It is invoked from the Apps button, which depending on the type of item selected, can be found either on the Outlook top toolbar, for items under composition (new or exisiting), or on the item’s contextual toolbar above the body, for all other existing items (not under composition).

The add-in is displayed as a panel inside of outlook and is structured as a wizard, where users can go back and forth between pages to adjust the settings. All pages have an action button located on the bottom right corner. All secondary pages have a button to return to the main page located on the top left corner.

Before starting using the add-in, the users need to authenticate. This process will take them to a browser page, and once the authentication is successful, they will be instructed to return to the add-in.


This image shows the Welcome page.


Once a flow is completed, a confirmation page will be displayed, and the users can either continue using the add-in or they can close it. Any errors encountered during the usage would be displayed at the top of the panel in a auto closable banner.


This image shows the Confirmation page.


Insert Items

This flow is available for outlook items under composition (new or edit) and allows the users to insert links or attachments to the selected item.

Select File Or Folder Page

The users can select a file or a folder by browsing, searching or using the MRU (Most Recently Used>) list. Once a selection is made the Next button will become enabled. The page will open automatically to the previously used location (if available) or to the root.


This image shows the Select File or Folder page.


Insert File Or Folder Page

The users select how the file or folder will be inserted: as a link or as an attachment.

Files can be inserted using either options. As links, files can be inserted either as system link or as public link (if available). When using public links, the users can either create or select an existing one. The insert file operation will result in 2 links being inserted in the item’s body: view only and download.

Folders can be inserted only as native system links (view only).


This image shows the Insert File or Folder page.


Save Items

This flow is available for read only (not under composition) items, and allows the user to take the content of the selected item and save it as one or more documents.

Message Parts Page

The users can select which parts of the outlook message they want to save: the whole message and/or the attachments. Each option is associated with a suggested name for the file to be saved. The users can modify the names, and any invalid characters would be highlighted. Any errors would need to be addressed first, before proceeding to the next step.


This image shows the Select Message Parts page.


Select Location Page

The users can select the location where the files would be saved. The page will open automatically to the previously used location (if available) or to the root.


This image shows the Select Location page.


Check In Page

Each file to be saved needs to be associated with a profile. The users can select to use a profile for all files (default behavior) or only for a particular file. If a file has all the profile’s required fields filled up, then it is ready to be saved. When all files satisfy this condition, then the action button will be enabled. Once the save operation starts, each processed file will display a progress bar and an updated status.


This image shows the Check In page.


Notes for Administrators

In order to use the Redwood UI Outlook Integration, the following steps will need to be performed.
  1. Copy the manifest.xml and save it locally.
  2. Open the manifest for editing.
  3. Inside the file, replace all the occurrences of the placeholder text “https://localhost:443” with the url for your instance and save the changes.
  4. Navigate to Advanced Component Manager tool found under AdminServer in the WebCenter Content web app and enable the WccOutlook component.
  5. Enable AutoSuggestConfig component to have access to search functionality in the add-in.
  6. Deploy the modified manifest file to your Exchange server (Microsoft 365 Admin Center).

manifest.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" xmlns:mailappor="http://schemas.microsoft.com/office/mailappversionoverrides/1.0" xsi:type="MailApp">
  <Id>8C6D5898-89ED-433C-993B-077FE1E7D496</Id>
  <Version>1.0.0.1</Version>
  <ProviderName>Oracle</ProviderName>
  <DefaultLocale>en-US</DefaultLocale>
  <DisplayName DefaultValue="Oracle WebCenter"/>
  <Description DefaultValue="Oracle WebCenter Content Outlook Add-in."/>
  <IconUrl DefaultValue="https://localhost:443/cs/resources/wccoutlook/common/assets/icon-64.png"/>
  <HighResolutionIconUrl DefaultValue="https://localhost:443/cs/resources/wccoutlook/common/assets/icon-128.png"/>
  <SupportUrl DefaultValue="https://www.oracle.com/help"/>
  <AppDomains>
    <AppDomain>https://www.oracle.com</AppDomain>
  </AppDomains>
  <Hosts>
    <Host Name="Mailbox"/>
  </Hosts>
  <Requirements>
    <Sets>
      <Set Name="Mailbox" MinVersion="1.1"/>
    </Sets>
  </Requirements>
  <FormSettings>
    <Form xsi:type="ItemRead">
      <DesktopSettings>
        <SourceLocation DefaultValue="https://localhost:443/cs/idcplg?IdcService=WCC_OUTLOOK"/>
        <RequestedHeight>250</RequestedHeight>
      </DesktopSettings>
    </Form>
  </FormSettings>
  <Permissions>ReadWriteItem</Permissions>
  <Rule xsi:type="RuleCollection" Mode="Or">
      <Rule xsi:type="ItemIs" ItemType="Message" FormType="ReadOrEdit"/>
      <Rule xsi:type="ItemIs" ItemType="Appointment" FormType="ReadOrEdit" />
  </Rule>
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Hosts>
      <Host xsi:type="MailHost"/>
    </Hosts>
    <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
      <Requirements>
        <bt:Sets DefaultMinVersion="1.3">
          <bt:Set Name="Mailbox"/>
        </bt:Sets>
      </Requirements>
      <Hosts>
        <Host xsi:type="MailHost">
          <DesktopFormFactor>
            <!-- Message Edit -->
            <ExtensionPoint xsi:type="MessageComposeCommandSurface">
                <!-- Use the default tab of the ExtensionPoint or create your own with <CustomTab id="myTab"> -->
                <OfficeTab id="TabDefault">
                    <Group id="msgEditGroup">
                        <Label resid="GroupLabel" />
                        <Control xsi:type="Button" id="msgEditOpenPaneButton">
                            <Label resid="TaskpaneEditButton.Label" />
                            <Supertip>
                                <Title resid="TaskpaneEditButton.Title" />
                                <Description resid="TaskpaneEditButton.Tooltip" />
                            </Supertip>
                            <Icon>
                      <bt:Image size="16" resid="Icon.16x16"/>
                      <bt:Image size="32" resid="Icon.32x32"/>
                      <bt:Image size="80" resid="Icon.80x80"/>                      
                            </Icon>
                            <Action xsi:type="ShowTaskpane">
                                <SourceLocation resid="Taskpane.Url" />
                            </Action>
                        </Control>
                        <!-- Go to http://aka.ms/ButtonCommands to learn how to add more Controls: ExecuteFunction and Menu -->
                    </Group>
                </OfficeTab>
            </ExtensionPoint>
            <!-- Appointment Compose-->
            <ExtensionPoint xsi:type="AppointmentOrganizerCommandSurface">
                <!-- Use the default tab of the ExtensionPoint or create your own with <CustomTab id="myTab"> -->
                <OfficeTab id="TabDefault">
                    <!-- Up to 6 Groups added per Tab -->
                    <Group id="apptEditGroup">
                        <Label resid="GroupLabel" />
                        <!-- Launch the add-in : task pane button -->
                        <Control xsi:type="Button" id="apptEditOpenPaneButton">
                            <Label resid="TaskpaneEditButton.Label" />
                            <Supertip>
                                <Title resid="TaskpaneEditButton.Title" />
                                <Description resid="TaskpaneEditButton.Tooltip" />
                            </Supertip>
                            <Icon>
                      <bt:Image size="16" resid="Icon.16x16"/>
                      <bt:Image size="32" resid="Icon.32x32"/>
                      <bt:Image size="80" resid="Icon.80x80"/>
                            </Icon>
                            <Action xsi:type="ShowTaskpane">
                                <SourceLocation resid="Taskpane.Url" />
                            </Action>
                        </Control>
                        <!-- Go to http://aka.ms/ButtonCommands to learn how to add more Controls: ExecuteFunction and Menu -->
                    </Group>
                </OfficeTab>
            </ExtensionPoint>
            <!-- Message Read -->
            <ExtensionPoint xsi:type="MessageReadCommandSurface">
              <OfficeTab id="TabDefault">
                <Group id="msgReadGroup">
                  <Label resid="GroupLabel"/>
                  <Control xsi:type="Button" id="msgReadOpenPaneButton">
                    <Label resid="TaskpaneReadButton.Label"/>
                    <Supertip>
                      <Title resid="TaskpaneReadButton.Title"/>
                      <Description resid="TaskpaneReadButton.Tooltip"/>
                    </Supertip>
                    <Icon>
                      <bt:Image size="16" resid="Icon.16x16"/>
                      <bt:Image size="32" resid="Icon.32x32"/>
                      <bt:Image size="80" resid="Icon.80x80"/>
                    </Icon>
                    <Action xsi:type="ShowTaskpane">
                      <SourceLocation resid="Taskpane.Url"/>
                    </Action>
                  </Control>
                </Group>
              </OfficeTab>
            </ExtensionPoint>
            <!-- Appointment read -->
            <ExtensionPoint xsi:type="AppointmentAttendeeCommandSurface">
              <!-- Use the default tab of the ExtensionPoint or create your own with <CustomTab id="myTab"> -->
              <OfficeTab id="TabDefault">
                <!-- Up to 6 Groups added per Tab -->
                <Group id="apptReadGroup">
                  <Label resid="GroupLabel" />
                  <!-- Launch the add-in : task pane button -->
                  <Control xsi:type="Button" id="apptReadOpenPaneButton">
                    <Label resid="TaskpaneReadButton.Label" />
                    <Supertip>
                      <Title resid="TaskpaneReadButton.Title" />
                      <Description resid="TaskpaneReadButton.Tooltip" />
                    </Supertip>
                    <Icon>
                      <bt:Image size="16" resid="Icon.16x16"/>
                      <bt:Image size="32" resid="Icon.32x32"/>
                      <bt:Image size="80" resid="Icon.80x80"/>
                    </Icon>
                    <Action xsi:type="ShowTaskpane">
                      <SourceLocation resid="Taskpane.Url" />
                    </Action>
                  </Control>
                  <!-- Go to http://aka.ms/ButtonCommands to learn how to add more Controls: ExecuteFunction and Menu -->
                </Group>
              </OfficeTab>
            </ExtensionPoint>
          </DesktopFormFactor>
        </Host>
      </Hosts>
      <Resources>
        <bt:Images>
          <bt:Image id="Icon.16x16" DefaultValue="https://localhost:443/cs/resources/wccoutlook/common/assets/icon-16.png"/>
          <bt:Image id="Icon.32x32" DefaultValue="https://localhost:443/cs/resources/wccoutlook/common/assets/icon-32.png"/>
          <bt:Image id="Icon.80x80" DefaultValue="https://localhost:443/cs/resources/wccoutlook/common/assets/icon-80.png"/>
        </bt:Images>
        <bt:Urls>
          <bt:Url id="Taskpane.Url" DefaultValue="https://localhost:443/cs/idcplg?IdcService=WCC_OUTLOOK"/>
        </bt:Urls>
        <bt:ShortStrings>
          <bt:String id="GroupLabel" DefaultValue="Oracle WebCenter"/>
          <bt:String id="TaskpaneReadButton.Label" DefaultValue="Save Files"/>
          <bt:String id="TaskpaneEditButton.Label" DefaultValue="Insert Links"/>
          <bt:String id="TaskpaneReadButton.Title" DefaultValue="Save files to Oracle WebCenter"/>
          <bt:String id="TaskpaneEditButton.Title" DefaultValue="Insert links from Oracle WebCenter"/>
        </bt:ShortStrings>
        <bt:LongStrings>
          <bt:String id="TaskpaneReadButton.Tooltip" DefaultValue="Opens panel to save files to Oracle WebCenter."/>
          <bt:String id="TaskpaneEditButton.Tooltip" DefaultValue="Opens panel to insert links from Oracle WebCenter."/>
          <bt:String id="ActionButton.Tooltip" DefaultValue="Perform an action when clicked."/>
        </bt:LongStrings>
      </Resources>
    </VersionOverrides>
  </VersionOverrides>
</OfficeApp>


Developers Guide

You can provide access to files and folders in Oracle WebCenter Content using the applink endpoints of the WebCenter Content REST API and then embed the files or folders into a custom web application. Applinks are generated server-side using credentials that have access to the content. The applink details are then provided to the browser, where the content is embedded on the page to presented anonymously. Applinks are created on demand and expire quickly and automatically after use.

Note:


Applink URLs cannot be used direcly in the address bar of a browser. Applinks are inherently a developer centric feature and require custom integration code to work.

The following endpoints are used to create applinks:

See REST API for Oracle WebCenter Content for full details on the usage of these APIs.

You can create applinks with read (R), read and write (RW), or read, write and delete (RWD) permissions. The user used to create the applink must have at least the request permissions to the item. You cannot create an applink with greater permissions than you have.

The response from the Create File Applink or Create Folder Applink REST API includes an applink ID, access token, and refresh token and might look as follows:

{
  "dAppLinkID": "LDyqaygFMt0IsLr4cfmfNoykhwbjXQ6otUPVRMNx35I_08JDVoxjAEOqKmMhYVWNCuhnBqyCG7zbKfs2YhnbhVWg==",

  "dAppLinkAccessToken": "tL5Ot18ZC5X92S8IyBcGB8AO1eWlONYz51MQu2hyRwXJuxB9Nuz0qq-05m0FP3wl",

  "dAppLinkRefreshToken": "hvqLCBjCCtREw463ucOeU_oZdpG1qe0Z_oHbpvvaVEU8PYvjTO6ByYpA_L5sbxjd",

  "dEmbedUrl": "http://hostname/cs/idcplg?IdcService=REDWOODUI_VIEWER&dDocName=MHONG1SUBN6522017014&RevisionSelectionMethod=LatestReleased&dAppLinkID=LDyqaygFMt0IsLr4cfmfNoykhwbjXQ6otUPVRMNx35I_08JDVoxjAEOqKmMhYVWNCuhnBqyCG7zbKfs2YhnbhVWg=="
}

Displaying applinks with the WebCenter Content RedwoodUI requires that the UI be embedded in an iframe element on the page, with the src attirbute set to the dEmbedURL value from the create applink response. This url contains the dApplinkId value. For security reasons, it intentionally does not contain the dApplinkAccessToken or dAppLinkRefreshToken. As it is initializing in the frame, the Redwood UI it will pause to send a postMessage request to its hosting parent requesting these two value. It is the hosting parents responsibility to respond to this postMessage event and reply back to the iframe with a postMessage request containing these two values. Once it has recieved these values from the hosting parent, the Redwood UI will continue loading and display the requested content. Once loaded, the Redwood UI will automatically refresh the access token (using the refresh token) when necessary to keep the connection working.

Note:


In order to embed the Redwood UI in an any iframe, you must provide a Content Security Policy frame-ancestors configuration. This is done by adding the RedwoodUIFrameAncestors configuration variable to the config.cfg file. For example:

RedwoodUIFrameAncestors=*.myhost.com

See documentation for CSP:frame-ancestors for details and options on how to format this value.

Use the following step to host the applink UI on a web page.

  1. Add an iframe to the page
  2. Add an event listener for the message event to listen for postMessage events coming from the embedded Redwood UI.
  3. In the message event handler, add a condition to look for message containing a data property name message with a value of appLinkReady.
  4. In response to the message, postMessage back to the iframe data with message=setAppLinkTokens and include the dAppLinkID, dAppLinkAccessToken, and dAppLinkRefreshToken.
  5. Set the src attribute on the iframe to the dEmbedUrl value from the create applink response.

The following sample html code demonstrates applink usage.

<html>
  <head>
    <meta charset="UTF-8" />
    <title>Applink Sample</title>
  </head>
  <body>
    <iframe  id="applink_frame" name="applink" src=""></iframe>

    <script>
      // Data obtained from create applink REST API response. 
      const createApplinkResponse = {
        "dAppLinkID": "LDyqaygFMt0IsLr4cfmfNoykhwbjXQ6otUPVRMNx35I_08JDVoxjA...",
        "dAppLinkAccessToken": "tL5Ot18ZC5X92S8IyBcGB8AO...",
        "dAppLinkRefreshToken": "hvqLCBjCCtREw463ucOeU_oZdp...",
        "dEmbedUrl": "http://hostname/cs/idcplg?IdcService=REDWOODUI_VIEWER&dDocName=SAMPLE16522017014&RevisionSelectionMethod=LatestReleased&dAppLinkID=LDyqaygFMt0IsLr4cfmfNoykhwbjXQ6otUPVRMNx35I_08JDVoxjA..."
      }

      const wccOrigin = new URL(createApplinkResponse.dEmbedUrl).origin;

      const iframe = document.getElementById('applink_frame');

      window.addEventListener('message', (event) => {
        if (event.origin !== wccOrigin) return; // ensure message is from WCC

        if (event.data?.message === 'appLinkReady') {
          var iframewindow = iframe.contentWindow ? iframe.contentWindow : iframe.contentDocument.defaultView;
          iframewindow.postMessage({
              message: 'setAppLinkTokens',
              dAppLinkID: createApplinkResponse.dAppLinkID,
              dAppLinkAccessToken: createApplinkResponse.dAppLinkAccessToken,
              dAppLinkRefreshToken: createApplinkResponse.dAppLinkRefreshToken,
          }, '*');
        }
      }, false);

      iframe.src = createApplinkResponse.dEmbedUrl;

    </script>
  </body>
</html>