Introduction

The Redwood UI is a modern interface for WebCenter Sites, created with the Oracle Redwood design pattern. This general-purpose interface allows users to create, view, edit, and manage assets within a site. The Redwood UI provides access to site assets using intuitive and familiar design elements.

Getting Started

To use the Redwood UI, the WebCenter Sites Administrator must enable the Redwood UI app for a site. Follow the steps below to enable the Redwood UI for a site:

  1. Navigate to the AdminSite, WEM Admin application.
  2. In the Sites list, choose the site for which the Redwood UI should be enabled.
  3. Select the Manage Site Apps menu option for the site and choose Assign Apps.
  4. Move the Redwood UI to the Selected list and choose Continue.
  5. Select the roles whose users should be granted access to the Redwood UI application. Move RedwoodUser to the Selected list and choose Save and Close.
  6. Assign users the role RedwoodUser in order to grant those users access to the Redwood UI application.

When the Redwood UI has been enabled for a site, its icon appears in the top WEM bar.

Redwood UI Icon in WEM Bar

The Redwood UI

The Redwood UI is a general-purpose user interface providing access to a range of Asset Contribution features. It requires minimal training because it is intuitive and simple. With it you can easily create, update, and manage a wide variety of assets.

The Redwood UI Asset List

The Redwood UI initially displays the Assets List, in either Card View or in Table View. Both views show the assets currently available in the site, filtered by the criteria in the filter settings.

Redwood UI Asset List in Card View

Item Image Description
1 Redwood UI Branding Header 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 User Menu The user avatar displays the logged in user initials. Clicking this item reveals the user menu, containing the following items:
  • Help - Opens the WebCenter Sites Redwood UI documentation.
  • About - Displays system information details, including the version of the Redwood UI.
  • Logout - Log out of the system.
3 WEM Bar Toggle Button Use the WEM Toggle to show or hide the WEM bar at the top of the page.
4 Site Selector The site selector allows the user to start working with the assets of another site. Only the sites enabled for the Redwood UI will be shown in this list.
5 Search Bar The search bar filters the items in the content area. You can choose to filter by the Type predefined facet, or you can manually enter keywords. The results in the content area will be filtered automatically as filter terms are added and removed.
6 Toolbar Action Buttons The actions menu shows actions available for assets in the current view. The asset create button is always present in the menu. Other actions only appear when an asset is selected.

If the browser window is too narrow to display all of the available actions for a selected item, any actions that do not fit will be collapsed into a More option or show the actions as icons. Clicking the More option will open a drop-down menu that provides access to all of the actions that could not be displayed in the main actions menu area.
7 Sort Button Choose the sort order for results in the content area. You can sort by Name, Type, or Subtype, and choose whether to sort in Ascending or Descending order.
8 Layout Buttons Select the layout for the displayed assets in the content area. Choose either Card layout or Table layout.
9 Refresh Button The Refresh button refreshes the display of the results area, synchronizing data server. This can be useful when you are expecting changes to the data that may have been caused outside of the current session or when updates to displayed items may have been delayed for some reason.

Asset Operations

From the Asset List the user has the ability to create a new asset. Additionally, when an asset is selected, several operations become enabled related to that asset, including:

Creating an Asset

The Create (Create) button allows you to create new assets. Selecting this button initially displays the Type Selection dialog.

Create Asset Type Selection Dialog

This dialog presents a list of asset types. Select the type of asset you want to create and press OK.

Subsequently the asset metadata collection form appears.

Create Asset Panel

Enter the metadata relevant to the asset. The fields presented will be specific to the type of asset chosen.

Additional asset properties can be displayed by selecting the Show Properties (Show Properties Button) button.

To create the asset, press the Save button. To discard changes without creating a new asset press the Cancel button.

Inspecting an Asset

The Inspect action allows the user to preview the attributes and metadata of the selected asset. The action opens a side panel that displays the name and attributes of the asset on one side and the standard metadata in a separate closeable panel.

Redwood UI Asset Inspect Panel

To inspect an asset from the list of assets:

  1. Select the desired asset.
  2. Click the Inspect toolbar button.
  3. Toggle the Properties (Properties Toggle Button) button to show or hide the asset properties.
  4. Press the Close (Close Button) button to close the inspect panel.

Editing an Asset

The Edit action allows the user to update the attributes and metadata of the selected asset. The action opens a side panel that displays the name and attributes of the asset on one side and the standard metadata in a separate closeable panel.

Redwood UI Asset Edit Panel

To edit an asset from the list of assets:

  1. Select the desired asset.
  2. Click the Edit toolbar button.
  3. Toggle the Properties (Properties Toggle Button) button to show or hide the asset properties.
  4. Alter the attribute and properties as desired.
  5. Press the Save button to commit the changes. Press the Cancel button to cancel the edit operation.

Tagging Assets

The Tags action allows the user to assign descriptive keywords to the selected asset or assets. This is useful for classifying and describing assets topically.

Redwood UI Asset Tags Dialog

To apply tags to one or more assets:

  1. Select the desired asset or assets.
  2. Click the Tags toolbar button.
  3. Update tag information in the fields.
    • If more than one asset is selected, the tags shared in common among the assets are displayed in the upper field. Tags added or removed there will be added to or removed from all of the selected assets. Tags displayed in the lower field are distinct to one or more assets, not shared in common among all of the selected assets. Removing tags from this field will remove the tags from the selected assets in which they exist.
    • If only one asset is selected, the Tags dialog only shows one field.
  4. Click the Apply button. Press the Cancel button to cancel the tagging operation.

Approving Assets

The Approve action allows the user to approve or unapprove the selected assets for publishing. The Approve panel provides the ability to manage the approval status of the selected assets.

To approve one or more assets:

  1. Select the desired asset or assets.
  2. Click the Approve toolbar button.
  3. In the Destination dialog, choose the appropriate publish destination for the approval operation and press OK. Redwood UI Asset Approve Destination Dialog
  4. In the Approve Assets panel, select the desired assets and click the Approve or Unapprove toolbar button. Redwood UI Asset Approve Panel
    • To approve or unapprove a single asset, click the Approve (Approve Button) or the Unapprove (Unapprove Button) action button for the asset.
    • To view the dependencies for an asset, click the View Dependencies (View Dependencies Button) button.
  5. If an asset is held due to dependencies that also need to be approved, click the View Dependencies (View Dependencies Button) button. This will display the Approve Dependencies panel. Redwood UI Asset Approve Dependencies Panel
    • To approve an asset dependency, click the Approve (Approve Button) button.
    • To view additional status information about an item, select the Show Details (Show Details Button) button.
  6. Click the Close (Close Button) button to close the panel.

Copying Assets

The Copy action allows the user to make a copy of the selected asset or assets.

Copying Single Assets

When one asset is selected for copying, the action opens a side panel that displays the prefilled attributes of the asset on one side and the standard metadata in a separate closeable panel.

Redwood UI Asset Copy Panel

To copy an asset from the list of assets:

  1. Select the desired asset to copy.
  2. Click the Copy toolbar button.
  3. Toggle the Properties (Properties Toggle Button) button to show or hide the asset properties.
  4. Alter the attribute and properties as desired.
  5. Press the Save button to commit the copy. Press the Cancel button to cancel the copy operation.
Copying Multiple Assets

If more than one asset is selected for copying, the Copy toolbar action immediately starts a copy operation. A notification popup will show the progress of the copy operation and indicate when it has completed.

Redwood UI Asset Copy Notification

Copied items will have the original name of the asset prefixed by “Copy Of”.

Deleting Assets

The Delete action allows the user to delete the selected asset or assets. The action opens the Delete Assets panel.

To delete one or more assets:

  1. Select the desired assets to delete.
  2. Click the Delete toolbar button.
  3. The Delete Assets panel shows the state of the selected assets. Redwood UI Asset Delete Confirmation Some assets may be ready to be deleted. Others may have references that must be removed before the asset can be deleted.
    • To delete an asset click the Delete Asset (Delete Asset Button) button. The Delete Ready Assets button will delete all of the assets in the list in the “Ready to be deleted” state.
    • To remove an asset from the list without deleting it, press the Remove from List (Remove from List Button) button.
    • To view a list of assets that have references to the asset, select the View References (View References Button) button.
  4. To view references to an asset in the list, click the View References (View References Button) button. This displays a list of referencing assets in a panel. Remove References Panel
    • To unlink the references in the other asset, select the Remove References (Remove References Button) button.
    • To unlink all of the references in all of the listed assets, select the Remove Qualified References button.
  5. Click the Close (Close Button) button to close the panel.

Showing Asset Properties

The Properties action allows the user to view or edit the properties of the selected asset. The action opens a side panel that displays the name and other properties of the asset in tabs.

Redwood UI Asset Properties

To show the properties for an asset from the list of assets:

  1. Select the desired asset to delete.
  2. Click the Properties toolbar button.
  3. To edit the asset properties, click the Edit button.
  4. Press the Close (Close Button) button to close the properties panel.
The Asset Metadata Tab

The Properties Metadata tab displays the metadata associated with the asset. If necessary, the list can be scrolled to view other metadata values.

Redwood UI Asset Metadata Panel

To edit the metadata for the asset, click the Edit button.

The Asset URL Tab

The URL tab in the Properties panel displays the URLs, if any, associated with the asset.

Redwood UI Asset URL Panel

The Asset References Tab

The References tab in the Properties panel displays a list of other assets that the selected asset references, if any. Links within the entries can be clicked to show a preview of the associated asset.

Redwood UI Asset References Panel

The sections of the panel can be expanded and collapsed by pressing the Expand (Expand Button) and Collapse (Collapse Button) buttons.

The Asset Referenced By Tab

The Referenced By tab in the Properties panel displays a list of other assets with references to the selected asset, if any. The entries can be clicked to show a preview of the referencing asset.

Redwood UI Asset Referenced By Panel