11 Preparing Your Application for Oracle WebCenter Web 2.0 Services

This chapter describes how to prepare your application to consume Oracle WebCenter Web 2.0 services. It contains the following sections:

Section 11.1, "Preparing Your WebCenter Application to Consume Services"
Section 11.2, "Extending Your Application with Custom Components"
Section 11.3, "Configuring General Settings for Your Services"

Note:

For important basic information about WebCenter applications, such as how to create an application, how to create customizable pages, and how to implement security, see Chapter 3, "Preparing Your Development Environment."

For conceptual information about WebCenter Web 2.0 services, see Section 1.1.4, "Introduction to Oracle WebCenter Web 2.0 Services."

11.1 Preparing Your WebCenter Application to Consume Services

This section describes the steps you must take to prepare your application to use Oracle WebCenter Web 2.0 services. It contains the following subsections:

Section 11.1.1, "How to Prepare Your Application to Consume Services"
Section 11.1.2, "Setting Up an External Application Connection"
Section 11.1.3, "Automated Task Flow Grants"

11.1.1 How to Prepare Your Application to Consume Services

You can configure any application to include a WebCenter Web 2.0 Service. When you create an application in JDeveloper, you can choose to base the application on a template. Although not a requirement, the WebCenter Application template makes all the appropriate WebCenter connection wizards and tag libraries readily visible and available in the New Gallery and Component palette. When you consume a WebCenter Services task flow or component, the necessary libraries are automatically added to the project.Depending upon the service you plan to consume, your application must meet certain prerequisites. For example, if the service needs to know the identity of users, then your application must provide some level of security with user authentication.

11.1.1.1 Implementing Security for Services

Some services must know the identity of the user (for example, the Search service needs the user's identity for saving searches). For these services, you must at least configure your application to authenticate users such that they have distinct identities for the purposes of personalization and user preferences.

For details on how to implement a basic security solution for your WebCenter custom application, see Section 3.5.1, "How to Configure ADF Security." For details on how to implement a complete security solution for your custom application, see Chapter 24, "Securing Your WebCenter Application."

Once you configure ADF security for your application, you can open the jazn-data.xml file and modify your sample user's privileges for each task flow. To open the ADF Security Policies Editor, locate the file in the Application Resources pane and double-click its name. You will see the default task flow grants, as shown in Figure 11-1. You can further configure these grants in this view.

Figure 11-1 ADF Security Policies in the jazn-data.xml file

Description of "Figure 11-1 ADF Security Policies in the jazn-data.xml file"

11.1.2 Setting Up an External Application Connection

When a WebCenter Web 2.0 service interacts with an application that handles its own authentication, you can associate that application with an external application definition to allow for credential provisioning.

The following WebCenter Web 2.0 services permit the use of an external application to connect with the service and define authentication for it:

Documents
Instant Messaging and Presence
Mail
RSS Viewer (when using a secured RSS feed)

For more information about setting up the external application for a WebCenter Web 2.0 service, see Chapter 14, "Integrating the Documents Service," Chapter 15, "Integrating the Instant Messaging and Presence Service," Chapter 17, "Integrating the Mail Service," and Chapter 19, "Integrating the RSS Service." For more information about external applications in general, see Section 24.2, "Working with External Applications."

11.1.3 Automated Task Flow Grants

Table 11-1 lists the grants that are given when a task flow from the corresponding service is consumed. Common grants are granted whenever any Oracle WebCenter Web 2.0 service is consumed.

Table 11-1 Automated Task Flow Grants

Service	Grant	Actions	Name (Target)
Common	TaskFlowPermission	View	/oracle/webcenter/framework/service/controller/taskflows/resourceViewer.xml#resourceViewer
Announcement	TaskFlowPermission	View	/oracle/webcenter/collab/announcement/view/taskflows/main-view-definition.xml#announcement-main-view /oracle/webcenter/collab/announcement/view/taskflows/mini-view-definition.xml#announcement-mini-view /oracle/webcenter/collab/announcement/view/taskflows/link-existing-view-definition.xml#link-existing-view-definition /oracle/webcenter/collab/announcement/view/taskflows/config-view-definition.xml#announcement-config-view /oracle/webcenter/collab/announcement/view/taskflows/announcement-view-definition.xml#announcement-resource-view
	RegionPermission	View	oracle.webcenter.collab.announcement.view.pageDefs.oracle_webcenter_collab_announcement_view_jsf_pages_AnnouncementLinkExistingViewPageDef oracle.webcenter.collab.announcement.view.pageDefs.oracle_webcenter_collab_announcement_view_jsf_pages_AnnouncementLinkResourceViewPageDef
Discussions	TaskflowPermission	View	/oracle/webcenter/collab/forum/view/taskflows/main-task-flow.xml#forum-main /oracle/webcenter/collab/forum/view/taskflows/miniview-task-flow.xml#forum-miniview /oracle/webcenter/collab/forum/view/taskflows/popularTopic-task-flow.xml#forum-popularTopic /oracle/webcenter/collab/forum/view/taskflows/recentTopic-task-flow.xml#forum-recentTopic /oracle/webcenter/collab/forum/view/taskflows/watchedTopic-task-flow.xml#forum-watchedTopic /oracle/webcenter/collab/forum/view/taskflows/watchedForum-task-flow.xml#forum-watchedForum /oracle/webcenter/collab/forum/view/taskflows/config-task-flow.xml#forum-config-view /oracle/webcenter/collab/forum/view/taskflows/link-existing-task-flow.xml#forum-link-existing /oracle/webcenter/collab/forum/view/taskflows/link-new-task-flow.xml#forum-link-new /oracle/webcenter/collab/forum/view/taskflows/message-task-flow.xml#forum-message /oracle/webcenter/collab/forum/view/taskflows/resource-view-task-flow.xml#forum-resource-view /oracle/webcenter/collab/forum/view/taskflows/scope-config-task-flow.xml#forum-scope-config-view
	RegionPermission	View	oracle.webcenter.collab.forum.view.pageDefs.oracle_webcenter_collab_forum_view_jsf_pages_ForumLinkExistingViewPageDef oracle.webcenter.collab.forum.view.pageDefs.oracle_webcenter_collab_forum_view_jsf_pages_ForumLinkNewViewPageDef oracle.webcenter.collab.forum.view.pageDefs.oracle_webcenter_collab_forum_view_jsf_pages_ForumLinkResourceViewPageDef
Documents	TaskflowPermission	View	/oracle/webcenter/doclib/view/jsf/taskflows/mainView.xml#doclib-document-library /oracle/webcenter/doclib/view/jsf/taskflows/docListViewer.xml#doclib-document-list-viewer /oracle/webcenter/doclib/view/jsf/taskflows/recentDocuments.xml#doclib-recent-documents
	RegionPermission	View	oracle.webcenter.doclib.view.pageDefs.oracle_webcenter_doclib_view_jsf_fragments_mainViewPageDef oracle.webcenter.doclib.view.pageDefs.oracle_webcenter_doclib_view_jsf_pages_linkToExistingDocumentPageDef oracle.webcenter.doclib.view.pageDefs.oracle_webcenter_doclib_view_jsf_pages_linkToNewDocumentPageDef
External Application	TaskflowPermission	View	/oracle/adfinternal/extapp/view/fragments/extapp-credential-provisioning-taskflow.xml#extapp-credential-provisioning-taskflow /oracle/adfinternal/extapp/view/fragments/extapp-change-password-taskflow.xml#extapp-change-password-taskflow
Instant Messaging and Presence
Links	TaskflowPermission	View	/oracle/webcenter/relationship/view/jsf/resources/links-detail.xml#links-detail /oracle/webcenter/relationship/view/jsf/resources/links-detail-popup.xml#links-detail-popup
	RelationshipPermission	Manage	*
Mail	TaskflowPermission	View	/oracle/webcenter/collab/mail/view/jsf/regions/compose-task-flow.xml#mail-compose-view /oracle/webcenter/collab/mail/view/jsf/regions/content-view-definition.xml#mail-content-view /oracle/webcenter/collab/mail/view/jsf/regions/dl-config-definition.xml#dl-config-view /oracle/webcenter/collab/mail/view/jsf/regions/mini-view-definition.xml#mail-mini-view
	RegionPermission	View	oracle.webcenter.collab.mail.view.pageDefs.oracle_webcenter_collab_mail_view_jsf_pages_ComposeviewPageDef oracle.webcenter.collab.mail.view.pageDefs.oracle_webcenter_collab_mail_view_jsf_pages_ContentViewPageDef
Page Editor	TaskflowPermission	View	/oracle/webcenter/.* /oracle/adfinternal/pageeditor/.*
	RegionPermission	View	oracle.webcenter.*
Page	TaskFlowPermission	View	/oracle/webcenter/page/view/jsf/fragments/page-create-page.xml#page-create-page /oracle/webcenter/page/view/jsf/fragments/page-doc-prop-panel-definition.xml#page-doc-prop-panel-definition /oracle/webcenter/page/view/jsf/fragments/page-doc-sec-panel-definition.xml#page-doc-sec-panel-definition /oracle/webcenter/page/view/jsf/fragments/golink-prop-panel-definition.xml#golink-prop-panel-definition
People	TaskFlowPermission	View	/oracle/webcenter/people/view/jsf/regions/people-contacts.xml#people-contacts
Recent Activities	TaskFlowPermission	View	/oracle/webcenter/recentactivity/controller/taskflows/recent-activities.xml#recent-activities
RSS	TaskFlowPermission	View	/oracle/webcenter/rssviewer/view/jsf/fragments/RSSViewerTaskFlow.xml#RSSViewerTaskFlow
Search	TaskFlowPermission	View	/oracle/webcenter/search/controller/taskflows/searchResults.xml#search-view /oracle/webcenter/search/controller/taskflows/localToolbarSearch.xml#search-toolbar /oracle/webcenter/search/controller/taskflows/preferences.xml#search-preferences /oracle/webcenter/search/controller/taskflows/allSavedSearches.xml#all-saved-searches /oracle/webcenter/search/controller/taskflows/simpleSearchResults.xml#search-simple-view /oracle/webcenter/search/controller/taskflows/customize.xml#search-customize
Tags	TaskFlowPermission	View	/oracle/webcenter/tagging/controller/taskflows/related-links.xml#tagging-related-links /oracle/webcenter/tagging/controller/taskflows/launch-dialog.xml#tagging-launch-dialog /oracle/webcenter/tagging/controller/taskflows/tagging-personal-view.xml#tagging-personal-view /oracle/webcenter/tagging/controller/taskflows/tag-selection.xml#tag-selection /oracle/webcenter/tagging/controller/taskflows/related-resources.xml#related-resources /oracle/webcenter/tagging/controller/taskflows/tag-center-task-flow.xml#tag-center /oracle/webcenter/tagging/controller/taskflows/tag-center-related-tags.xml#tag-center-related-tags /oracle/webcenter/tagging/controller/taskflows/tag-center-related-users.xml#tag-center-related-users
	RegionPermission	View	oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_launch_dialogPageDef oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_tag_centerPageDef oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_tag_center_related_resourcesPageDef oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_tag_center_related_tagsPageDef oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_tag_center_related_usersPageDef oracle.webcenter.tagging.view.pageDefs.oracle_webcenter_tagging_view_jsf_fragments_tag_center_tag_selectionPageDef
Worklist	TaskFlowPermission	View	/oracle/webcenter/worklist/view/jsf/taskFlowDefs/worklist.xml#worklist

In addition to the services in Table 11-1, grants are also given when the External Application - Change Password task flow is applied when creating an external application in Oracle JDeveloper. Specifically, the TaskflowPermission is given and placed in /oracle/adfinternal/extapp/view/fragments/.*.

11.2 Extending Your Application with Custom Components

This section introduces the Resource Action Handling Framework and describes how to register a resource viewer. It contains the following subsections:

Section 11.2.1, "Introducing the Resource Action Handling Framework"
Section 11.2.2, "Registering a Resource Viewer"

11.2.1 Introducing the Resource Action Handling Framework

Custom components are just like out-of-the-box WebCenter Web 2.0 services in that they manage and own resources. As such, they must make declarations that enable their resources to be accessible to the WebCenter Web 2.0 services that invoke other services (that is, the Search, Tags, Links, and Recent Activities services). WebCenter provides a Resource Action Handling framework fo r services that expose resources to be viewed, searched, and tagged.

For example, the Resource Action Handling framework enables the Search service to look up and follow the mechanism to render a resource for any given service. Other facilities of the Resource Action Handling framework allow for authorization of resources to be declared and enforced when access is made.

The following services invoke resource viewers using the Resource Action Handling framework:

Search
Tags
Links
Recent Activities

The following services own task flows that can be invoked by the Resource Action Handling framework.

Announcements
Discussions
Documents (Resource URL rewriter to point to GET handler)
Events
Mail
Notes
Page (Resource URL rewriter to point to page URL)
Tags - Tag Center

11.2.2 Registering a Resource Viewer

You must register a r esource viewer to enable custom resources to be rendered using Search or Tags, or to make the resources linkable to and from each other.

In the service-definition.xml file, you can define a resource viewer for any service to render that service's resources. The viewer can be a task flow or a URL rewriter acting on the resource ID.

For example, suppose a discussion forum message is found through the Search service. Clicking the result link launches the resource viewer that was declared for the Discussions service (by looking up the service-definition.xml of the Discussions service). By default, the target is rendered in a dialog.

Note:

When you add a Search, Tags, or Recent Activities task flow to your application, that service creates a sample service-definition.xml file. This file enables developers to declare their resource viewers as well as their implementations of interfaces for interacting with the Links and Search services; for example, the QueryManager interface implementation.

To register a custom resource viewer:

In the Application Navigator, right-click the Page Flows node for the ViewController project and select New from the context menu.
Under Categories, select JSF, then ADF Task Flow.
Click OK.
In the Create ADF Task Flow dialog, change File Name to resource-viewer.xml. The Task Flow ID should automatically update to resource-viewer (Figure 11-2).

Figure 11-2 Create ADF Task Flow Dialog for Resource Viewer

Description of "Figure 11-2 Create ADF Task Flow Dialog for Resource Viewer"
Click OK.

Ensure that the resource-viewer.xml file is created under ..\public_html\WEB-INF.
From the Component Palette, make sure that ADF Task Flow is selected and drag View onto the task flow to create a page fragment.
Rename the page fragment to resource-viewer, and click in an open area of the canvas to accept the change.
Define a JSFF file for your page fragment.
Double-click the page fragment.
Click OK in the Create New JSF Page Fragment dialog.

Go to the Source view in the editor and paste an af:outputText tag inside of the jsp:root element.

Example 11-1 provides a very simple resource viewer. You could create a much more complex viewer.

Example 11-1 Simple Resource Viewer

<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.0"
          xmlns:af="http://xmlns.oracle.com/adf/faces/rich">
  <af:outputText value="Rendering #{pageFlowScope.resourceId}"
                 inlineStyle="font-size:5"/>
</jsp:root>

Add a resourceId input parameter to the task flow, and set the value to #{pageFlowScope.resourceId}.
After the task flow is defined, you must register it in the service-definition.xml file. In the Application Navigator, expand Application Resources, Descriptors and ADF META-INF.
Double-click service-definition.xml to open it in the editor.
In the file, you will find a service definition that has been commented out. Uncomment it by removing the  tags around it.
Set the id attribute to the service identifier.

For example, the service identifier used when defining the Tagging Button could be mycompany.myproduct.myapp.mycomponent.
Set the taskFlowId to /WEB-INF/resource-viewer.xml#resource-viewer.

This identifier is the task flow path and file name concatenated with the task flow identifier declared in the Create ADF Task Flow dialog. You can omit the remaining tags.
The <resource-view> declaration has a class specification for the resource authorizer. This provides various ways to specify the resource view and determine which tagged objects are visible (and searchable) to users.
Example 11-2 Specifying a Task Flow ID in a resource-view Declaration
```
<resource-view taskFlowId="/somepath/somefile.xml#someId"
               authorizerClass="some.service.id.Authorizer1"/>
```
The Search, Tags, and Discussions services use this type of declaration. Instead of having a view ID (JSPX page), the service supplies a task flow to render the resource.
- The attribute taskFlowId signifies that the renderer is a task flow.
- A task flow is used to render the resource specified by the resource ID.
- The task flow honors a resourceId input parameter and uses that to render the resource.
Example 11-3 Specifying a URL Rewriter Class Name (1)
```
<resource-view urlRewriterClass="oracle.webcenter.framework.internal.resource.IdentityResourceUrlRewriter"
               authorizerClass="some.service.id.Authorizer5"/>
```
or
Example 11-4 Specifying a URL Rewriter Class Name (2)
```
<resource-view urlRewriterClass="oracle.webcenter.framework.internal.resource.MessageFormatResourceUrlRewriter"
               authorizerClass="some.service.id.Authorizer4">
  <parameters>
    
    <parameter name="message" value="/content/conn/UCM/path/{0}"/>
  </parameters>
</resource-view>
```
or
Example 11-5 Specifying a URL Rewriter Class Name (3)
```
<resource-view urlRewriterClass="oracle.webcenter.framework.internal.resource.MyResourceUrlRewriter"
               authorizerClass="some.service.id.Authorizer6">
  <parameters>
    <parameter name="myParam" value="myValue"/>
  </parameters>
</resource-view>
```
Services, such as Oracle SES and Documents, use a URL rewriter to treat the resource ID as a URL and rewrite the URL in an appropriate fashion. A URL rewriter changes the resource ID into a URL that can be launched with a goLink. Two ResourceUrlRewriters are provided:
- oracle.webcenter.framework.internal.resource.IdentityResourceUrlRewriter is for Oracle SES. It takes the resourceId value as a URL as is.
- oracle.webcenter.framework.internal.resource.MessageFormatResourceUrlRewriter is for Documents. It takes in a message parameter (in the service-definition). The message parameter contains a {0}, which is replaced with the value of the resourceId. The urlExternal parameter applies to all URL rewriters. This parameter's value determines whether the JSPX that consumes a resource action handler link should open a new window.
The default behavior is to launch a new window dialog with that URL.

Some services, like the Page service, can have no resource viewer but may allow dubbing their resource IDs as page view IDs (Example 11-6).
Example 11-6 No Resource Viewer (Resource ID as Page View ID)
```
<resource-view authorizerClass="some.service.id.Authorizer3"/>
```
The resource authorizer interface makes use of Java interfaces and classes to return useful information about service resources. For example, the oracle.webcenter.framework.resource.ResourceAuthorizer interface contains a method that returns the status (available or not available) for a unique resource ID (Example 11-7).
Example 11-7 Method for Returning Status Against a Unique Resource ID
```
/*
 * Check if the passed in resourceIds are viewable by the current user.
 *
 * @param resourceId - the resourceId that we want to check
 * @return - a <code>ResourceInfo</code> with a ResourceStatus
 * of RESOURCE_IS_AVAILABLE if the passed in resourceId
 * is viewable by current user, otherwise returns
 * <code>RESOURCE_IS_NOT_AVAILABLE</code>.
 */
ResourceInfo getResourceInfo(String resourceId, Scope scope);
 
/*
 * Check if the passed in resourceIds are viewable by the current user.
 *
 * @param resourceIds - the resourceIds that we want to check
 * @return - a List of <code>ResourceInfo</code> with a ResourceStatus
 * of RESOURCE_IS_AVAILABLE if the passed in resourceId
 * is viewable by current user, otherwise returns
 * <code>RESOURCE_IS_NOT_AVAILABLE</code>.
 */
List<ResourceInfo> getResourceInfo(List<String> resourceIds, Scope scope);
```
The oracle.webcenter.framework.resource.ResourceInfo interface exposes the following method:
```
public ResourceStatus getResourceStatus();
```
The oracle.webcenter.framework.resource.ResourceInfo.ResourceStatus enumeration includes the following possible values:
Example 11-8 Possible ResourceStatus Values
```
/**
 * Used to describe a related object's status.
 *
 * Certain operations may be performed by relationship service depending
 * on what object status it receives from the service.  For example,
 * if it receives {@link #RESOURCE_DOES_NOT_EXIST} it may remove all
 * relationships associated with this object from the relationship schema
 * so future calls are not wasted on this object.
 */
 public enum ResourceStatus
 {
   /**
    * Used to describe a resource that is available.
    */
   RESOURCE_IS_AVAILABLE,
 
   /**
    * Used to describe a resource that does not exist.
    */
   RESOURCE_DOES_NOT_EXIST,
 
   /**
    * Should be used when the user does not have view access on the resource.
    */
   USER_DOES_NOT_HAVE_ACCESS;
 }
```
The only method in the oracle.webcenter.framework.resource.ResourceUrlRewriter interface writes the URL, after a unique identifier is passed in. This URL can be an absolute URL or it can be one relative to the faces context root of the owning application.
Example 11-9 Resource URL Rewriter Method
```
public String rewriteUrl(String id);
```

Your service should look similar to the one shown in Example 11-10.

Example 11-10 Sample Service Definition for Resource View

<service-definitions>
  <service-definition id="mycompany.myproduct.myapp.mycomponent"
                      version="11.1.1.0.0">
  <resource-view taskFlowId="/somepath/somefile.xml#someId"
authorizerClass="mycompany.myproduct.myapp.mycomponent.ResourceAuthorizer"/>
  <name>My Custom Component</name>
  <description>My Custom Component's Description</description>
  <icon>/mycompany/myproduct/myapp/mycomponent/component.png</icon>
  </service-definition>
 ...
</service-definitions>

Save the service-definition.xml file.

11.3 Configuring General Settings for Your Services

Optionally, you can enable users to set the time zone, the date and time format, the language (locale), and the accessibility mode for the services you add to your application. You can provide these capabilities through the WebCenter General Settings Service. This service contains values that you can modify either directly from the JSF page(s) in your WebCenter application or indirectly, through an API. The WebCenter General Settings Service covers five areas:

Time Zone: By default, displays the time defined by the server running the WebCenter application.
Date-Time Format: By default, configured to java.text.DateFormat.SHORT.
Language: By default, defined by the locale of the user's browser.
Accessibility Mode: A value to use with the accessibility-mode setting in the trinidad-config.xml file.
Skin Family: A value to use with the skin-family setting in the trinidad-config.xml file.

To use the service directly from your application, you can use Expression Language in your JSF pages to access the generalSettings managed Bean. When you add generalSettings as the value attribute of an ADF component, for example af:activeOutputText, you can open the Expression Builder, then navigate to JSF Managed Beans > generalSettings to view the preference values for the bean.

Figure 11-3 Expression Builder for the generalSettings JSF Managed Bean

Description of "Figure 11-3 Expression Builder for the generalSettings JSF Managed Bean"

Table 11-2 describes the seven different preference values for the General Settings service.

Table 11-2 General Settings Managed Bean Preference Values and Descriptions

General Settings Preference Value	Description
`formattedCurrentDate`	Displays the current date in the user's selected locale.
`formattedCurrentDateTime`	Displays the current date and time in the user's selected locale.
`formattedCurrentTime`	Displays the current time in the user's selected locale.
`preferredAccessibilityMode`	Displays the preferred accessibility mode (`default`, `inaccessible`, or `screenReader`).
`preferredDateStyle`	Java date style to be used in `dateStyle` attributes when displaying dates and times.
`preferredTimeStyle`	Java time style to be used in `timeStyle` attributes when displaying dates and times.
`userTimeZone`	Java timezone to be used in `timeZone` attributes when displaying dates and times.

For example, to display the current date and time in the user's selected locale, time zone, and format, add the following to your page:

Example 11-11 Code for Displaying Current Date and Time in User's Locale

<af:outputText value="#{generalSettings.formattedCurrentDateTime}"/>

Or, to display a specific date and time:

Example 11-12 Code for Displaying Specified Date and Time

<af:outputText value="#{row.dateTimeValue}">
    <af:convertDateTime type="both"
                        dateStyle="#{generalSettings.preferredDateStyle}"
                        timeStyle="#{generalSettings.preferredTimeStyle}"
                        timeZone="#{generalSettings.userTimeZone}"
                        locale="#{facesContext.externalContext.requestLocale}" />
    </af:outputText>>

To take advantage of the preferred accessibility mode, you must add an EL (Expression Language) expression to the application's trinidad-config.xml file to set the accessibility mode, for example:

Example 11-13 Setting the Accessibility Mode in trinidad-config.xml

<accessibility-mode>#{generalSettings.preferredAccessibilityMode}</accessibility-mode>

You can also build a user interface using the General Settings API to enable users to either accept the default settings or apply their desired settings. The API contains the same seven preference values as described in Table 11-2.

Any WebCenter Web 2.0 service that displays a date and time uses the settings configured in the General Settings service. For more information on using the General Settings Service API to build a General Settings User Interface, see the Javadoc for oracle.webcenter.generalsettings.