Oracle® Fusion Middleware User's Guide for Oracle WebCenter Spaces 11g Release 1 (11.1.1.4.0) E10149-06 |
|
![]() Previous |
![]() Next |
In a WebCenter Spaces application, you can add content from one or more connected content repositories to the application, as described in Chapter 39, "Introduction to Adding and Managing Content."
This chapter describes how to publish content on a page in a WebCenter Spaces application using the Content Presenter task flow:
Section 40.1, "What You Should Know About the Content Presenter Task Flow"
Section 40.2, "Adding the Content Presenter Task Flow to a Page"
Section 40.3, "Displaying the Content Presenter Configuration Dialog"
Section 40.7, "Adding Links from Content to Navigation Nodes"
Section 40.8, "Authoring Site Studio Content to Optimize Presentation in Content Presenter"
Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow"
Section 40.11, "Setting Content Presenter Task Flow Properties"
Audience
This chapter is intended for WebCenter Spaces users assigned, minimally, the Pages-Edit Pages
permission who want to add content in a Content Presenter task flow to a page in a WebCenter Spaces application.
The Content Presenter task flow enables you to precisely customize the selection and presentation of content in a WebCenter Spaces application.
The Content Presenter task flow is available only when the connected content repository is Oracle Content Server and your WebCenter Spaces administrator has completed the prerequisite configuration.
See Also: For more information, see:
|
With Content Presenter, you can select a single item of content, multiple content items, query for content, or select content based on the results of a WebCenter Personalization Conductor scenario, and then select a template to render the content on a page in a WebCenter Spaces application.
In addition to displaying the folders and files in an Oracle Content Server repository, Content Presenter integrates with Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
Note: Oracle Site Studio files can also be included in the Folder Viewer, Document Explorer, and Document Manager task flows, and previewed using the Document Viewer. See Section 41.1.7, "Understanding the Document Viewer Task Flow." |
Content Presenter has no dependency on the Documents service for adding or managing the content it displays.
Oracle Site Studio is a powerful, flexible web development application suite that offers a comprehensive approach to designing, building, and maintaining enterprise-scale web sites. Site Studio uses Oracle Content Server as the main repository for a web site.
Site Studio region templates are defined in Site Studio Designer (or JDeveloper). They define the layout and look-and-feel of the data in contribution regions within web pages. They are partial HTML files in that they do not have a head
and body
section. At runtime, the Site Studio contributor data file (an Oracle Content Server document) is merged with the Site Studio region template to create the HTML fragment. This allows Site Studio region templates to be inserted into other HTML code as the web pages are generated for the Site Studio site.
Content Presenter integrates with Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template.
Note: Oracle Site Studio files can also be included in the Folder Viewer, Document Explorer, and Document Manager task flows, and previewed using the Document Viewer. See Section 41.1.7, "Understanding the Document Viewer Task Flow." |
Before you can display Site Studio contributor data files in Content Presenter, the WebCenter application administrator must complete the followings tasks, described in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter:
Enable Site Studio components (SiteStudio
, SiteStudioExternalApplications
, as desribed in "Configuring Oracle Content Server 11g for All WebCenter Applications".
Disable or hide Site Asset categories that are not needed for typical Content Presenter implementations, as described in "Disabling Undesirable Site Asset Categories in Oracle Site Studio".
Enable the WebCenterConfigure component to allow for adding and editing Site Studio documents from within Content Presenter, as described in "What You Should Know About the WebCenterConfigure Component".
For proper surfacing in Content Presenter, the following link types can be used in both Site Studio region templates, as well as in a Site Studio contributor data file:
Link to nodes in the default navigation model, as described in Section 40.7, "Adding Links from Content to Navigation Nodes."
Links to inlined images.
Links to documents (except for absolute or relative path links). When clicking the link at runtime, it renders within the context of the application and display the document using the Default View display template.
Links to Site Studio sections when editing a WYSIWYG field in contribution mode and creating a server-side link.
Absolute HTTP links, whether created in Site Studio contributor mode or in Site Studio Designer region template HTML.
The following Site Studio link types are not supported in Content Presenter:
Links to Site Studio sections, except for the server-side link case listed above.
Absolute or relative path links to Site Studio documents.
For guidelines on authoring recommendations for displaying a Site Studio contributor data file in Content Presenter, see Section 40.8, "Authoring Site Studio Content to Optimize Presentation in Content Presenter".
You can create and edit Site Studio contributor data files from the Content Presenter Configuration dialog (see Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog") or in-context when displayed in Content Presenter at runtime (see Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow").
For more information about creating and using Site Studio contributor data files and Site Studio region templates, refer to the Oracle Site Studio documentation library.
To add a Content Presenter task flow to a page:
Open the page in edit mode.
Click Add Content in the target region to open the Resource Catalog.
Navigate to the section of the Resource Catalog that provides access to the folders and files in the connected content repository.
Tip: The presence or location of this section depends on how the Resource Catalog is configured. For example, in the default Resource Catalog, next to Content Management, click Open to expose the content selections (Figure 40-1). |
Next to Content Management, click Open (Figure 40-1).
For information about the selections shown in the default Resource Catalog, see Section 39.2, "What You Should Know About Content Management Selections in the Resource Catalog."
Add the Content Presenter task flow to the page in one of two ways:
Next to Content Presenter, click Add (Figure 40-2).
A new empty region appears on your page (Figure 40-3).
Or, drill down in the Resource Catalog to the folder or file you want to display on the page: In the default Resource Catalog, next to All Content (or, in WebCenter Spaces, Space Documents or Personal Documents), click Open until you locate the target content, then click Add, and choose Content Presenter from the menu (Figure 40-4).
The selected folder or file displays in a default display template, as shown in Figure 40-5 and Figure 40-6.
:The Content Presenter Configuration dialog enables you to easily configure the Content Presenter task flow to select or change content, or choose a different display template.
Note: You can also specify content and a display template by clicking the properties Edit icon (the second wrench icon in the task flow chrome) and specifying parameters on the Parameters tab of the Component Properties dialog. However, specifying parameters in this way is generally intended for use at design time by developers creating a WebCenter Portal application, or for advanced users who want to bind a parameter to an EL expression. If you modify a property value in the Component Properties dialog, the new value overrides the value specified in the Content Presenter Configuration dialog, and that value cannot subsequently be changed through the Content Presenter Configuration dialog. For information about Content Presenter task flow parameters, see Section 40.11, "Setting Content Presenter Task Flow Properties." |
To display the Content Presenter Configuration dialog:
In the Content Presenter task flow (see Section 40.2, "Adding the Content Presenter Task Flow to a Page"), click the task flow Edit icon (the first wrench icon in the task flow chrome) (Figure 40-7).
The Content Presenter Configuration dialog opens (Figure 40-8).
A green check mark alongside an item indicates that the required information is complete and valid.
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. |
Depending on the type of content you want to display, follow the steps in one of the following sections:
Section 40.4.3, "Selecting Content Based on the Results of a Query"
Section 40.4.5, "Selecting Content Based on the Results of a Scenario"
To select a specific item (including a Site Studio contributor data file) to display on a page in a Content Presenter display template or Oracle Site Studio region template (see Section 40.1.1, "Understanding Site Studio Integration"):
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, expand the Content Source list, and select Single Content Item (Figure 40-9):
Click Browse to locate the content item.
If the WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the Show Hierarchy navigation icon to the left of the repository name to expose the VCR parent node. Click VCR to show all connected content repositories.
Note: If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reportsUnable to retrieve content type information . |
To select a folder to display its contents on a page (in the order stored in the folder) in a Content Presenter display template:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, expand the Content Source list, and select Contents Under a Folder (Figure 40-10):
Click Browse to locate the folder.
If the WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the Show Hierarchy navigation icon to the left of the repository name to expose the VCR parent node. Click VCR to show all connected content repositories.
Note: If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reportsUnable to retrieve content type information . |
To enter query criteria to refine the selection of the content to display on a page in a Content Presenter display template:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, expand the Content Source list, and select Results of a Query (Figure 40-11):
In the Results of a Query pane (Figure 40-12), enter desired values in the fields that you want the query to retrieve, as described in Table 40-1.
Table 40-1 Specifying Query Criteria for Results of a Query
Element | Description |
---|---|
File Name |
Enter the name of a file that you want to display in the selected template. To retrieve multiple content items, use |
Keywords |
Enter any value that may be present in the content. The value may be one or more words or phrases in the content of document. Keyword search requires full-text search to be configured in Oracle Content Server. |
Content Type |
Choose All Content Types to retrieve content items regardless of the content type. Or, choose the name of a content type profile or Site Studio region template definition (see Section 40.1.1, "Understanding Site Studio Integration") defined in Oracle Content Server. A content type profile specifies properties that define a specific type of content (for example, a press release, or a news flash, or an image). The content type IDC:GlobalProfile is the name of a default content type profile defined in Oracle Content Server that can be applied if no other content type profiles are defined. |
Limit Results |
Specify the maximum number of content items to be returned by the query. |
Add Fields |
Choose from the list any of the following to display additional fields to narrow the query:
|
Click Preview Query to see the results of the query.
Note: If the content repository includes an invalid type configuration, then no content displays when you click Preview Query. Instead, an error message reportsUnable to retrieve content type information . |
Content Presenter allows you to create a list of multiple content items. The order you use when creating the list is the order in which they are presented at runtime.
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:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, expand the Content Source list, and select List of Items (Figure 40-9):
In the Select Items to Display pane (Figure 40-14), click Add to browse or search for any number of items to add to a list.
If the WebCenter Spaces application is connected to multiple Oracle Content Server repositories, the browse tree shows the parent folder for the current user, or for the current Space, in the repository that is specified as the primary connection. To access other connected repositories, click the Show Hierarchy navigation icon to the left of the repository name to expose the VCR parent node. Click VCR to show all connected content repositories.
Note: If the content repository includes an invalid type configuration, then no content displays when you click Browse. Instead, an error message reportsUnable to retrieve content type information . |
If your WebCenter application is configured to run WebCenter Personalization scenarios using Content Presenter, you can select content based on the results of a WebCenter Personalization Conductor scenario. For more information, see "Personalizing WebCenter Applications" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter and "Configuring Content Presenter" in Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter.
To enter Conductor service scenario criteria to refine the selection of the content to display on a page in a Content Presenter display template:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, expand the Content Source list, and select Results of a Scenario:
In the Results of a Scenario pane, review the list of scenarios that have been tagged for Content Presenter consumption, select those for which you want to generate results, and enter required parameters.
Click Preview Query to see the results of the selected scenarios.
Note: If the content repository includes an invalid type configuration, then no content displays when you click Preview Query. Instead, an error message reportsUnable to retrieve content type information .
Any results that are returned from a scenario for use by Content Presenter must return a valid CMIS query, as Content Presenter takes the return value and runs it (as a CMIS query) against the repository specified within the Conductor URL. For information about how to format the query and examples, see Oracle Fusion Middleware Content Management REST Service Developer's Guide. |
The display template for the content you have selected on the Content page of the Content Presenter Configuration dialog may be one of the out-of-the-box templates provided with WebCenter Spaces (see Table 40-2 and Table 40-3), a custom template designed for your organization in JDeveloper, or a Site Studio region template (see Section 40.1.1, "Understanding Site Studio Integration").
For information about creating and uploading custom display templates, see "Creating Custom Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter. For information about creating and using Site Studio region templates, refer to the Oracle Site Studio documentation library.
By default, WebCenter Spaces selects an appropriate display template based on the type of content selected. You can change the default template as required.
The WebCenter Spaces administrator can show, hide, and manage the custom display templates on the Resources page of the application administration settings. For more information, see, Section 10.4, "Managing Resources."
To change the display template for the selected content:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Template or the Template tab.
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(s). For more information, see "Identifying Display Templates for Selected Content Items" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.
On the Template page:
If the Content Source selected on the Content page is a Site Studio contributor data file or any other single content item, select a Site Studio region template or a Content Presenter display template, respectively, from the Template list.
The list of available Site Studio region templates includes only the templates that match the region definition of the Site Studio contributor data file selected on the Content page. 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. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
The Content Presenter display templates in the list include the out-of-the-box templates for single content items (see Table 40-2). Other selections that may be available in the list are custom display templates that the application administrator has uploaded to your WebCenter Spaces application.
Figure 40-17 shows the Template list, with a Site Studio region template called PressReleaseFullDisplay selected.
Figure 40-17 Selecting the Custom Display Template
If the Content Source selected on the Content page is a multiple content item (Contents Under a Folder, Results of a Query, or List of Items), select the desired Template Category (Figure 40-18), then the Template (Figure 40-19).
By default, there is only one category: Default Templates. This selection defines the collection of out-of-the-box templates available for multiple content items (see Table 40-3).
Other selections that may be available are custom template categories and display templates that the application administrator has uploaded to your WebCenter Spaces application. For more information, see the "Creating Custom Content Presenter Display Templates" chapter in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.
Table 40-2 Out-of-the-Box Templates for Displaying Single Content Items
Single Content Item Templates | View ID | Description |
---|---|---|
|
Displays detailed information about any single content item including creation date, modification date, created by username, modified by username, path and any comments. |
|
|
Used by multiple content item views to display each individual item. Displays a single line with an icon and item name as a link that either displays or downloads the item when clicked. |
|
|
Displays any single content item, either directly in the browser (images, HTML, text) or as a link that downloads the associated file when clicked. For example, when the selected document type is |
Table 40-3 Out-of-the-Box Templates for Displaying Multiple Content Items
Multiple Content Item Templates | View ID | Description |
---|---|---|
|
Displays multiple content items in an accordion format, where each item can be expanded to display its details. |
|
|
Displays multiple content items in a bulleted list format. Only content items display; folder items are omitted. |
|
|
Displays multiple content items in a bulleted list format. The name of the folder containing the first item in the list displays as a label above the list. This template is intended to be used with Content Source set to Contents Under a Folder to ensure that all items have the same parent folder. Only content items display; folder items are omitted. |
|
|
Displays multiple content items in a carousel format, where items can be browsed by moving a slider left or right. |
|
|
Displays multiple content items in a tiled format with large icons and file names. |
|
|
Displays multiple content items in a simple list. |
|
|
Displays multiple content items in a list on the left, with a panel to the right displaying the details of a selected item. |
|
|
Displays multiple content items in a sortable table that includes the document name, date created, and date modified. |
|
|
Displays multiple content items as tabs that can be selected to display item details. |
To see a preview of your selected content before adding it to the page:
The appearance of the content on the Preview page 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 page 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 Edit icon for the task flow to display the Component Properties dialog, and select the Stretch Content
property (on the Display Options tab). For more information, see Section 17.5.2.5, "Working with Component Display Options."
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. |
From this tab, you can click Edit Web Content to edit HTML and Site Studio files in-context, as described in Section 40.10, "Creating and Editing Files In-Context in a Content Presenter Task Flow"
When you expose content stored in Oracle Content Server in a Content Presenter task flow, consider whether or not you want add one or more links from the content to a node in the default navigation model (see Section 11.2.2.1.8, "Setting Display Options for Navigation Items").
When the content displays in Content Presenter at runtime, an end user can click the links to navigate to the desired navigation model node.
You can create a link in the following content items in Oracle Content Server:
in a document of MIME type text/html (typically HTML files)
in a Site Studio contributor data file (in a Rich Text element)
in Site Studio region template
To add a link to a node in the default navigation model from a content item:
Edit the content item, as described in:
Add a link using the following syntax:
$wcUrl('externalId')
where externalId
is the external identifier as configured in the WebCenter default navigation model.
For example:
<a target="" href="$wcUrl('NEWCUSTOMERSLINK')">New Customers</a>
Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
To optimize the presentation of Oracle Site Studio content in Content Presenter, follow the guidelines provided in the following sections:
Keep the following guidelines in mind as you work with images in Site Studio that will be displayed using Content Presenter:
Store images in Oracle Content Server in a common location (filed).
Insert images into WYSIWYG elements using the Site Studio Contributor image wizard.
Set the image
tag src
attribute to a relative link to an image file in Oracle Content Server. This attribute is rewritten by Content Presenter during rendering to use the GET_FILE
service.
For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.
Example for Apache mod_cache
:
CacheEnable mem /cs
CacheDefaultExpire 3600 (one hour)
Keep the following guidelines in mind as you work with style definitions for Site Studio contributor data files that will be displayed using Content Presenter:
Define styles in CSS files.
Store CSS files either in Oracle Content Server or in your WebCenter portal application.
If stored in Oracle Content Server, add <link>
in <head>
of page template.
Load style class names into WYSIWYG region element definitions.
Select your CSS to format HTML in WYSIWYG elements.
For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.
Example for Apache mod_cache
:
CacheEnable mem /cs
CacheDefaultExpire 3600 (one hour)
Keep the following guidelines in mind as you work with JavaScript in Site Studio contributor data files that will be displayed using Content Presenter:
Recommended: Do not use JavaScript within web content that is rendered within WebCenter Portals.
If your web content uses JavaScript, follow these guidelines:
Add <link>
in <head>
of page template
For performance improvement, use web proxy to cache artifacts at URLs from Oracle Content Server, and set expiration based on tolerance for updates in Oracle Content Server.
Example for Apache mod_cache
:
CacheEnable mem /cs
CacheDefaultExpire 3600 (one hour)
Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
Note: To create or edit Oracle Site Studio content in a seamless interface within WebCenter Spaces, both of the following two requirements must be met:
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 from the Content Presenter Configuration dialog:
In the Content Presenter Configuration dialog (see Section 40.3, "Displaying the Content Presenter Configuration Dialog"), click Select Content or the Content tab.
On the Content page, click Create Web Content (Figure 40-21).
Tip: The Create Web Content button displays only when the Content Source field displays Single Content Item and when at least one Oracle Content Server repository (11g or higher) has the Site Studio component installed. |
The Oracle Site Studio Choose Region Content pane opens (Figure 40-22).
In the Choose Region Content pane, select a Site Studio Region Definition on which the content you want to create or edit is based.
Click Next.
The Choose content file pane opens (Figure 40-23).
In the Choose content file pane, select one of the following:
New Contributor data file to open the Check-in Content pane (Figure 40-24), where you can specify the standard document properties for the new Site Studio contributor data file that you want to check in to Oracle Content Server.
Existing file from server to open the Oracle Content Server (Figure 40-25), showing Site Studio contributor data files that are based on the selected Region Definition.
Make note of the file name, then click Next.
The Check-in Confirmation pane displays (Figure 40-26).
In the Check-in Confirmation pane, choose one of the following:
Edit content item now to open the Site Studio Contributor editor, where you can edit the content item as described in Section 40.10.2, "Editing Site Studio Files In-Context" (beginning with Step 4).
Exit without editing to make no changes to the file.
Click Finish to return to the Content Presenter Configuration dialog.
If you access the WebCenter Spaces application through Oracle HTTP Server (OHS) and 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 OHS and the webContextRoot
parameter are not configured, you can now select the Site Studio contributor data file to display in the Content Presenter task flow: On the Content page, browse to the Site Studio file, select it, and click Select.
In the Content Presenter Configuration dialog, click Save.
In-context editing refers to editing content directly in a WebCenter Spaces application at runtime, where the editor opens in a separate window.
With appropriate permissions, end users can edit HTML and Site Studio content in-context in a Content Presenter task flow.
Note: Users must have permissions to view and edit the page containing the Content Presenter instance, as well as being assigned a role with write permissions on Oracle Content Server. For more information, see Chapter 20, "Understanding WebCenter Spaces Security" and the chapter "Security Groups, Roles and Permissions" in Oracle Fusion Middleware System Administrator's Guide for Content Server. |
The following sections describe how to perform in-context editing:
Section 40.10.1, "Editing Wiki Documents or HTML Files In-Context"
Section 40.10.3, "Creating New Site Studio Content In-Context"
With appropriate permissions, end users can edit in-context wiki documents or HTML files that are presented in a Content Presenter task flow.
To edit a wiki or HTML file in a Content Presenter task flow:
In the Content Presenter task flow, click anywhere in the file content.
Press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a hashed border. Note that you can change this key sequence if you wish. See Section 40.10.4, "Changing the Edit Mode Key Sequence."
Click the Edit icon in the upper right corner of the document chrome (Figure 40-27) to open the file in the Document Viewer preview pane.
In the Document Viewer preview pane, click the Edit action (Figure 40-28) to automatically check the file out and open it for editing in the Rich Text Editor (RTE).
Make required updates, then save and close the file.
The modified file is automatically checked back in.
In the Content Presenter task flow in the WebCenter Spaces application, press Ctrl-Shift-C again to exit the in-context editing mode.
Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
With appropriate permissions, end users can edit Site Studio contributor data files in-context in a Content Presenter task flow.
To edit a Site Studio file in a Content Presenter task flow:
In the Content Presenter task flow, click anywhere in the Site Studio file content.
Press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a hashed border. Note that you can change this key sequence if you wish. See Section 40.10.4, "Changing the Edit Mode Key Sequence."
Click the Edit icon in the upper right corner of the document chrome (Figure 40-29) to open the file in Site Studio Contributor
In the Site Studio Contributor Data File editor, click a region to edit, as shown in Figure 40-30.
For information about editing files in Site Studio Contributor, see the Oracle Site Studio documentation.
Click Save And Close to exit the Site Studio Contributor editor and return to the WebCenter Spaces application.
In the Content Presenter task flow in the WebCenter Spaces application, press Ctrl-Shift-C again to exit the in-context editing mode.
Content Presenter integrates with Oracle Site Studio to allow you to create, access, edit, and display Site Studio contributor data files in either a Site Studio region template or a custom Content Presenter display template. For more information, see Section 40.1.1, "Understanding Site Studio Integration."
With appropriate permissions, end users can create new web content in Site Studio when in in-context editing mode in a Content Presenter task flow.
In-context creation of Site Studio files is slightly different than creating Site Studio files in the Content Presenter Configuration dialog, as described in Section 40.9, "Creating or Editing Site Studio Content in the Content Presenter Configuration Dialog." When creating a new Site Studio file in-context, you are limited to creating content that is of the same region definition, file location, security group, and document type as the content selected in the Content Presenter task flow.
To create a new Site Studio file in a Content Presenter task flow:
Click anywhere in a Site Studio file that is displayed in Content Presenter and press Ctrl-Shift-C to enter the in-context edit mode. The editable areas of the web page are highlighted with a hashed border.
Click the Create icon, as shown in Figure 40-31.
In the Choose Content window, select New Contributor Data File, as shown in Figure 40-32, then click Next.
Fill out the Check-in Content form. This form provides the metadata for the contributor data file and checks the file into the content server. The file is empty until you (or another contributor) edits it. For more information on filling out this form, see "Checking in Files" in Oracle Fusion Middleware User's Guide for Content Server.
In the Check-in Confirmation window, select Edit content item now.
Click Finish.
The Site Studio Contributor Data File editor opens, as shown in Figure 40-33.
Edit the file, then click Save and Close.
To change the edit mode key sequence used to enter in-content editing mode for a Site Studio file in Content Presenter, edit the following entry in the application's adf-config.xml
file:
******** Content Contributor Mode adf-config.xml entries *************** <page-editor-config xmlns="http://xmlns.oracle.com/adf/pageeditor/config"> <mode-switch-key> <enabled>true</enabled> <key-sequence>ctrl e</key-sequence> </mode-switch-key> </page-editor-config>
The Content Presenter task flow has associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle Composer (Figure 40-34).
For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."
The following sections provide information about properties of the Content Presenter task flow and describe the properties on the Parameters tab:
Note: The Content Presenter properties are intended for use at design time by developers creating a WebCenter Portal application (see "Adding Content Task Flows and Document Components to a Portal Page" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter), or for advanced users who want to bind a parameter to an EL expression. If you modify a property value in the Component Properties dialog, the new value overrides the value specified in the Content Presenter Configuration dialog, and that value becomes read-only in the Content Presenter Configuration dialog. |
The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 40.11.2, "Content Presenter Task Flow Parameters" For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."
Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2.5, "Working with Component Display Options" and Section 17.5.2.7, "Working with Style and Content Style Properties."
The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."
All properties on the Parameters and Display Options tabs provide access to an Expression Language (EL) editor, which you can use to select or specify a variable value instead of a constant value. Click the Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."
Table 40-4 describes the parameters that are unique to the Content Presenter task flow.
Table 40-4 Content Presenter Task Flow Parameters
Parameter | Description |
---|---|
The data source of the content. The value depends on the value of
|
|
|
where:
|
The data source type of the content. Corresponds to the Content Source value in the Content Presenter Configuration dialog. Valid values are:
|
|
The maximum number of results to display when Default: |
|
Specifies whether the display template is a Site Studio region definition template. This value is valid only with Oracle Content Server 11g or higher:
For information about creating and using Site Studio region templates, see Section 40.1.1, "Understanding Site Studio Integration" and the Oracle Site Studio documentation library. |
|
The unique identifier of this task flow instance, used internally to maintain the association of the task flow instance with its customization and personalization settings. Do not edit this value. |
|
The display template category ID to use in rendering results for multiple content items. This ID may reference one of the out-of-the-box display templates or a custom display template (see "Creating Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter). |
|
The display template view ID to use in rendering results for single content items. Enter the view ID of a template that is configured in the Resource Manager for a specific content type, or for list-based templates by category ID. This ID may reference one of the out-of-the-box display templates or a custom display template (see "Creating Content Presenter Display Templates" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter). |