Content Presenter Configuration

Use the Content Presenter Configuration dialog to select the content to display in the Content Presenter task flow, and to select the template to use to display that content.

In the summary panel on the left, a check mark () alongside an item indicates that the required information is complete and valid. Items that are not complete or valid display an empty box ().

Selecting a Single Content Item

You can display a single item from your Content Server (including a Site Studio contributor data file) in a Content Presenter task flow

To select a specific item:

1. Click Select Content or the Content tab.
2. On the Content tab, from the Content Source list, select Single Content Item.
3. Click Browse to locate the content item in the content repository.

   Note:

   Content Server exposes a content item in the Select Document dialog only after it has a revision status of Released. The revision status of a new content item changes from Done to Released after it has reached its specified release date (specified by the dInDate property). Content items that do not have Released status will not appear in the Select Document dialog. You can find the status of a content item in Content Server on the Content Information Page, as described in Revision Status in Using Oracle WebCenter Content.

   If WebCenter Portal is connected to multiple Content Server repositories, the browse tree shows the parent folder for the current user, or for the current portal, in the repository that is specified as the primary connection. To access other connected repositories, click the navigation list icon in the toolbar to expose the VCR parent node. Click VCR to show all connected content repositories.

   Notes:

   • iFraming is supported only for the default Content Server connection. Therefore, you cannot select a non-default Content Server connection if the Content Presenter task flow will use iFrames to display content.

   • If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

4. Select the item that you want to display and click Select.

Selecting the Contents of a Folder

You can display the contents of a folder from Content Server in a Content Presenter task flow. The contents of the folder are displayed in the order stored in the folder.

To select a folder:

1. Click Select Content or the Content tab.
2. On the Content tab, from the Content Source list, select Contents Under a Folder.
3. Click Browse to locate the folder in the content repository.

   Tip:

   To select the folder as the content source, click in the folder row, not on the folder name (clicking the folder name opens the folder).

   If WebCenter Portal is connected to multiple Content Server repositories, the browse tree shows the parent folder for the current user, or for the current portal, in the repository that is specified as the primary connection. To access other connected repositories, click the navigation list icon in the toolbar to expose the VCR parent node. Click VCR to show all connected content repositories.

   Notes:

   • iFraming is supported only for the default Content Server connection. Therefore, you cannot select a non-default Content Server connection if the Content Presenter task flow will use iFrames to display content.

   • If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

4. Select the folder whose contents you want to display and click Select.

Selecting Content Based on the Results of a Query

You can display content in a Content Presenter task flow based on a query conducted against the Content Server repository.

All query criteria are optional. If you leave all options empty, all documents in the Content Server repository will be returned by the search.

Note:

To select content based on the results of a query against the connected repository, full-text search must be enabled in WebCenter Content Server through OracleTextSearch.

To specify a content query:

1. Click Select Content or the Content tab.
2. On the Content tab, from the Content Source list, select Results of a Query.
3. In the File Name field, enter the name of a file in the Content Server repository that you want to display in the Content Presenter task flow.

   You can use * as a wild card character to retrieve multiple files.

   For example, *.jpg.

4. In the Keywords field, enter any words or phrases that might be present in the content of the documents.
5. From the Content Types list, select:
   • All Content Types to retrieve content items regardless of the content type.
   • The name of a content type profile or Site Studio region template definition defined in Content Server.

   A content type profile specifies properties that define a specific type of content, for example, a press release; news flash; or image. The content type IDC:GlobalProfile is the name of a default content type profile defined in Content Server that can be applied if no other content type profiles are defined.

6. In the Limit Results field, enter the maximum number of content items to be returned by the query.

   The default is 100.

7. To retrieve content items based on creation date:
   1. From the Created list, select:

      • is to search for content items created on the specified date

      • is after to search for content items created after the specified date

      • is before to search for content items created before the specified date

      • is between to search for content items created between the two specified dates

   2. In the corresponding date field(s), enter a date.
8. To retrieve content items based on when they were last edited, select:
   1. From the Last Modified list, select

      • is to search for content items last modified on the specified date

      • is after to search for content items last modified after the specified date

      • is before to search for content items last modified before the specified date

      • is between to search for content items last modified between the two specified dates

   2. In the corresponding date field(s), enter a date.
9. To retrieve content items based on who first uploaded them, in the Created By field, enter the user name.
10. To retrieve content items based on who last edited them, in the Last Modified By field, enter the user name.
11. If you selected a specific content type in the Content Type list you can also:
    1. Define Additional Query Filters to refine the query based on one or more specific property settings

       Click Add and select from the available properties.

    2. Specify a Sort Order based on the properties available for the content type.

       From the Sort On list, select the property to sort by, then select whether to sort in ascending or descending order.

    If Content Type is set to IDC:Global Profile, then Additional Query Filters is not available.

12. Click Preview Results to see the results of the query.

    Based on the results shown in the preview, you can accept or modify your search criteria.

    Note:

    If the content repository includes an invalid type configuration, then no content displays when you click Preview Results. Instead, an error message reports Unable to retrieve content type information.

Selecting a List of Content Items

You can create a list of content items to display in a Content Presenter task flow.

To browse or search for any number of items to add to a list, and delete or reorder the items before adding the list to a page in a Content Presenter display template:

1. Click Select Content or the Content tab.
2. On the Content tab, from the Content Source list, select List of Items.
3. Under Select Items to Display, click Add to browse or search for any number of items to add to the list.
4. In the Select One or More Content Items dialog, select multiple content items using Ctrl+click or Shift+click.

   Note:

   Content Server exposes a content item in the Select One or More Content Items dialog only after it has a revision status of Released. The revision status of a new content item changes from Done to Released after it has reached its specified release date (specified by the dInDate property). Content items that do not have Released status will not appear in the Select One or More Content Items dialog. You can find the status of a content item in Content Server on the Content Information Page, as described in Revision Status in Using Oracle WebCenter Content.

   If WebCenter Portal is connected to multiple Content Server repositories, the browse tree shows the parent folder for the current user, or for the current portal, in the repository that is specified as the primary connection. To access other connected repositories, click the navigation list icon in the toolbar to expose the VCR parent node. Click VCR to show all connected content repositories.

   Note:

   • iFraming is supported only for the default Content Server connection. Therefore, you cannot select a non-default Content Server connection if the Content Presenter task flow will use iFrames to display content.

   • If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reports Unable to retrieve content type information.

5. When you have selected all the items that you want to display, click Select.

   You can add more items to the list later by clicking Add again.

6. Use the arrow buttons to rearrange the order of the items in the list.

   The order you use when creating the list is the order in which they are presented at runtime.

Creating or Editing Site Studio Content

You can create and edit Site Studio contributor data files from within the Content Presenter Configuration dialog.

To create or edit Oracle Site Studio content in a seamless interface within Oracle WebCenter Portal, WebCenter Portal must be connected to a Content Server repository, with the webContextRoot parameter set to the Content Server path, for example /cs.

Without this configuration, it is still possible to create or edit Site Studio content from within Content Presenter, but the create and edit actions launch new browser windows (or tabs) rather than opening within the Content Presenter task flow.

To create or edit Oracle Site Studio content in the Content Presenter Configuration dialog:

1. Click Select Content or the Content tab.
2. On the Content tab, click Create Web Content.

   The Oracle Site Studio Choose Region Content pane opens.

3. In the Choose Region Content pane, select a Site Studio region definition on which the content you want to create or edit is based.

   Note:

   • To create or edit Oracle Site Studio content, at least one region definition must have been previously created in the Site Studio application.

   • To create articles for the Articles View and Full Article View templates, select the Article (RD_ARTICLE) region definition.

4. Click Next.

   The Choose content file pane opens.

5. In the Choose content file pane, select one of the following:

   • New Contributor data file to open the Check-in content pane, where you can specify the standard document properties for the new Site Studio contributor data file that you want to check in to Content Server.

   • Existing file from server to open Content Server, showing Site Studio contributor data files that are based on the selected region definition.

6. Make note of the file name, then click Next.

   The Check-in Confirmation pane opens.

7. In the Check-in Confirmation pane, select one of the following:

   • Edit content item now to open the Site Studio Contributor editor, where you can edit the content item.

     You start editing when you click Finish.

   • Exit without editing to make no changes to the file.

8. Click Finish to return to the Content Presenter Configuration dialog.

   • If you have configured the webContextRoot parameter, as described in the note at the top of this section, the Site Studio contributor data file you selected is shown auto-selected in the Content Presenter Configuration dialog.

   • If webContextRoot parameter is not configured, you can now select the Site Studio contributor data file on the Content page.

9. In the Content Presenter Configuration dialog, click Save.

Selecting a Display Template

By default, WebCenter Portal selects an appropriate Content Presenter display template based on the type of content selected. You can change the default template as required.

Note:

Although Site Studio region templates are supported, it is recommended that for Site Studio contributor data files, you use Content Presenter display templates that use region definitions instead. Site Studio region templates display the details of the contributor data file rather than the contributed content. For information about Site Studio region templates, refer to the Oracle WebCenter Content documentation library.

To change the display template for the selected content:

1. Click Select Template or the Template tab.
2. If the Content Source selected on the Content tab is a multiple content item source (Contents Under a Folder, Results of a Query, or List of Items), from the Template Category list, select:

   • Default Templates to select one of the built-in Content Presenter display templates.

   • Site Studio Templates to select a Content Presenter display template that uses region definitions to display Site Studio contributor data files.

     Although Site Studio region templates are supported, they display the details of the contributor data files rather than the contributed content. It is strongly recommended that for Site Studio contributor data files, you use Content Presenter display templates that use region definitions instead.

   • Custom Template Category to select a custom Content Presenter display template, if any exist. There may be multiple custom template categories listed.

     Custom Content Presenter display templates are created in Oracle JDeveloper and published to WebCenter Portal.

3. From the Template list, select the Content Presenter display template that you want to use.

   The templates that are available for selection in the Template list are those that are identified by Content Presenter as suitable for displaying the selected content item source type. If you select a Single Content Item, only those templates that display single items are listed. If you select a multiple content item source (Contents Under a Folder, Results of a Query, or List of Items), only those templates that display multiple items (and are of the selected Template Category) are listed.

   The Template list includes built-in display templates, custom display templates (created in JDeveloper and published to WebCenter Portal), and Site Studio region templates.

   Note:

   Choose templates appropriate to the type of content. Site Studio region templates should be used for Site Studio defined Contributor Data Files (CDF). Using non-Site Studio templates will display the details of the CDF file, rather than the content; using Site Studio templates for non-Site Studio content will simply not display. To identify the Site Studio region templates, hover your mouse pointer over the templates in the list to display hint text identifying the Site Studio region templates.

Previewing Content in the Content Presenter Configuration Dialog

You can get an idea of how your selected content will look using the selected display template before exiting the Content Presenter Configuration dialog.

To preview content in the Content Presenter Configuration dialog:

In the Content Presenter Configuration dialog, click Preview or the Preview tab.

The appearance of the content on the Preview tab is dependent on whether the selected display template uses a stretch or flow layout. While the final view of the task flow can be configured to use either a stretch layout or a flow layout, the Preview tab only uses a flow layout. As a result, the preview of content using templates that were designed for a stretch layout displays unstretched at a fixed default size. This is the normal behavior of stretchable content when displayed in non-stretching flow layout. To allow stretchable content to stretch to its full size and fill the task flow space entirely, click the View Actions icon in the task flow toolbar, and select Display Options. In the Advanced tab of the Display Options dialog, from the Stretch Content list, select true.

Note:

Content Presenter does not support non-ASCII characters in files that are encoded using the non-UTF-8 character encoding. When users preview such files in Content Presenter, non-ASCII characters appear garbled.