Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces
11g Release 1 (11.1.1.6.0)

Part Number E10149-10
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

69 Working with the Recent Activities Service

The Recent Activities service provides a means of tracking recent activities within a Spaces application. For example, the Recent Activities task flow tracks the changes you and other users make to application pages, documents, discussion forums, lists, and the like (Figure 69-1).

Figure 69-1 The Recent Activities Task Flow

Recent Activity task flow
Description of "Figure 69-1 The Recent Activities Task Flow"

This chapter provides information about the Recent Activities service. It contains the following sections:

Note:

You can track recent activities through your favorite RSS reader. For more information, see Chapter 68, "Working with the RSS Service."

Audience

This chapter is intended for users interested in understanding and using the features of the Recent Activities service.

The Spaces administrator has the authority to expose or hide task flows from a particular service. Tasks discussed in this chapter are not available to you if the relevant service is hidden.

Note:

For information about seeded user roles, see Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal.

69.1 What You Should Know About the Recent Activities Service

The Recent Activities service provides the Recent Activities task flow, which links to the additions and revisions to some services available to your application (Figure 69-2).

Figure 69-2 The Recent Activities Task Flow

Recent Activity task flow
Description of "Figure 69-2 The Recent Activities Task Flow"

Tracked changes include additions and revisions to pages, documents, discussion forums, lists (Spaces only), and events.

By default, the Recent Activity list displays 25 recent activities for a given service. If more than 25 activities have occurred, the Recent Activity list displays the 25 most recent. Your application administrator can change the default value, so your limit may be more or less than 25.

The level of information provided in the Recent Activity list depends on the context in which the list is placed. For example, in a Framework application, changes are tracked on all applicable services across the entire application.

In a space page, the Recent Activity list summarizes changes occurring in that space. In a personal space, the Recent Activities task flow must have a space specified (see Section 69.3, "Setting Recent Activities Task Flow Properties"). The Recent Activity list summarizes changes occurring in the specified space.

You can use the Recent Activity list as an access point to new and revised content. The Recent Activity list displays new and revised content as links, which you can click to go directly to the content.

69.2 Working with the Recent Activities Task Flow

With the Recent Activities task flow, there is very little to do to make the most of its features. It automatically detects recent activities on other WebCenter Portal service and reports on its findings.

There are, nonetheless, a few recent-activity-centered actions you can take on the task flow. For example, you can personalize your view of recent activities, access a changed item, and refresh your view to update the task flow with the latest changes. This section tells you how. It contains the following subsections:

69.2.1 Adding the Recent Activities Task Flow to a Custom Resource Catalog

WebCenter Portal: Spaces provides rich Resource Catalogs that expose components and connections that Spaces users can add to their pages. You can use a Resource Catalog to populate resources such as page templates, navigation models, pages, and task flows.

As a Spaces administrator or a space moderator, you can make the Recent Activities task flow available in a custom Resource Catalog so that users can add the task flow to their pages and use it for keeping track of recent activities.

To make the Recent Activities task flow available in a custom Resource Catalog:

  1. Create a Resource Catalog or make a copy of an existing one. Creating a Resource Catalog follows the same procedure as any other resource. For information about creating a blank Resource Catalog, see Section 10.2, "Creating Resources." For information about copying an existing Resource Catalog, see Section 10.4.1, "Copying a Resource."

  2. To add the Recent Activities task flow to the Resource Catalog, on the Resources page, select your newly created Resource Catalog.

  3. From the Edit menu, choose Edit.

  4. If you have created folders (see Section 16.3.1.1, "Creating a Folder") and want to add resources inside a particular folder, select the folder in the Edit dialog.

  5. In the Edit dialog, select Add, and then Add From Library.

  6. In the Add Resource Catalog Item dialog, click Task Flows on the left.

  7. From the list on the right, select Recent Activities (Figure 69-3).

    Figure 69-3 Adding the Recent Activities Task Flow to a Resource Catalog

    Adding the Notes Task Flow to a Resource Catalog
    Description of "Figure 69-3 Adding the Recent Activities Task Flow to a Resource Catalog"

  8. Click Add.

    The Recent Activity task flow displays in your Resource Catalog.

    Figure 69-4 Recent Activities Task Flow in a Resource Catalog

    Notes Task Flow in a Resource Catalog
    Description of "Figure 69-4 Recent Activities Task Flow in a Resource Catalog"

  9. Click OK to close the Edit dialog of your Resource Catalog.

  10. Configure the application or space to use the new catalog as the default one. For information, see Section 16.10, "Configuring Resource Catalogs in Your Application."

69.2.2 Adding the Recent Activities Task Flow to a Page

To add the Recent Activities task flow to a page, you need to add Recent Activities using the Resource Catalog (Figure 69-5).

Figure 69-5 Selecting the Recent Activities Task Flow from the Resource Catalog

Notes Task Flow in the Resource Catalog
Description of "Figure 69-5 Selecting the Recent Activities Task Flow from the Resource Catalog"

The procedure for adding the Recent Activities task flow to a page is same as adding any component from the Resource Catalog. For the generic procedure, see Section 17.5.1, "Adding a Component to a Page."

69.2.3 Personalizing the Recent Activities Task Flow

The Recent Activities task flow provides a way to specify the range of time within which to view changes and additions to other services. These time-range options display on the Show menu in the Recent Activities task flow toolbar (Figure 69-6).

Figure 69-6 Time-Range Options on the Recent Activity List

Time-range options on the Recent Activity list
Description of "Figure 69-6 Time-Range Options on the Recent Activity List"

Select an option from the Show menu to view recent activities occurring within the selected time range. The time range you select is applicable only to that task flow instance. If you have more than one Recent Activities task flow instance on the page, you can display activities from a different time range in each task flow instance.

Tip:

Ensure that your application Preferences reflect your own local time zone. To access your time zone preference in the Spaces application, click the Preferences link at the top of the application and then select General. For more information, see Section 35.3, "Setting Date and Time Preferences."

The default options on the Show menu include:

  • Today—The task flow displays all activities that have taken place between 12:00AM (2400 hours) and now.

  • Since Yesterday—The task flow displays all activities that have taken place between now and yesterday at 12:00AM (2400 hours).

  • Last 7 days—The task flow displays all activities that have taken place in the last 7 days.

  • Last 30 days—The task flow displays all activities that have taken place in the last 30 days.

Note:

These options are described according to their default meanings. In some instances, an advanced user can provide alternative definitions for them. For more information, see Section 69.3, "Setting Recent Activities Task Flow Properties."

69.2.4 Accessing Recently Acted-On Items

The Recent Activities task flow groups the different services it reports on into nodes that are named for each service (Figure 69-7).

Figure 69-7 Service Nodes in the Recent Activities Task Flow

Service nodes on a Recent Activity task flow
Description of "Figure 69-7 Service Nodes in the Recent Activities Task Flow"

Expand a node, and access the changed item directly by clicking its link (Figure 69-8).

Figure 69-8 Recent Discussion Link in the Recent Activities Task Flow

Accessing a changed service from Recent Activity
Description of "Figure 69-8 Recent Discussion Link in the Recent Activities Task Flow"

The targets of linked items open on dynamically-generated pages, or in the Spaces application, on dynamically-generated, top-level tabs. Link targets display according to their parent service. For example, click a Discussions service link to access a forum or a specific topic under a forum; click a Lists service link to access an updated list of lists or a specific updated list; click an event to display event details; and so on.

69.2.5 Refreshing the Recent Activities Task Flow

If you prefer not to wait for an automatic refresh of the Recent Activities task flow, you always have the option of refreshing the task flow yourself by clicking its Refresh icon (Figure 69-9).

Figure 69-9 The Refresh Icon on a Recent Activities Task Flow

Refresh icon on a Recent Activity task flow
Description of "Figure 69-9 The Refresh Icon on a Recent Activities Task Flow"

The task flow updates and indicates the number of recently-changed items by increasing the value displayed in parenthesis next to each affected service.

69.3 Setting Recent Activities Task Flow Properties

For the steps to add a Recent Activities task flow to a page, see Section 17.5, "Adding Resource Catalog Components to Pages."

The Recent Activities task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Oracle WebCenter Portal's Composer (Figure 69-10).

Figure 69-10 Recent Activities Task Flow Component Properties

Recent Activity task flow properties
Description of "Figure 69-10 Recent Activities Task Flow Component Properties"

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 Recent Activities task flow and describe the properties on the Parameters tab:

69.3.1 What You Should Know About the Recent Activities Task Flow Properties

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 69.3.2, "Recent Activities 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. These properties are unique to the task flow type. For more information, see Chapter 17, "Setting Properties on Page Components." For information about wiring pages and components, 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 Chapter 17, "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 Chapter 17, "Working with Component Contextual Events."

The Child Components tab displays all of the components contained within the current component. It provides controls for rearranging, showing, and hiding child components. Not all components contain children. So you may find this tab devoid of content. For more information, see Chapter 17, "Working with Child Components."

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 Expression Builder 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."

Note:

Wherever you enter EL on the generic Display Options tab in the Component Properties dialog, the entry is automatically validated. If the EL is invalid, an error appears and the value is neither applied nor saved. Generic Display Options are those cataloged in Table 17-1.

EL validation is not performed on non-generic display options.

69.3.2 Recent Activities Task Flow Parameters

Table 69-1 describes the parameters that are unique to the Recent Activities task flow.

Table 69-1 Recent Activities Task Flow Parameters

Parameter Description

Group Space Name

Applicable in Spaces only. Leave this field blank if the task flow is on a Framework application page.

Use this parameter to specify the space for which to display recent activities. On a personal space page, use this to narrow the range of displayed activities. Rather than tracking activities application-wide—the default behavior—you can, for example, set a Constant value of a particular space's display name.

On a space page, use this parameter to display some other space's recent activities or to display recent activities for all spaces.

Valid values include:

  • The display name or GUID of the space to search

  • null (empty), to search according to the contextual default

    Use for space pages only. An empty value on a space page searches the current space.

    Note: Always specify a value on a personal space page. An empty value does not return any results. If no value is specified, then the following message displays in the Recent Activities task flow:

    Recent Activity in the Personal Space requires a groupSpace taskflow parameter value to use for the search.
    
  • defaultScope (or the defaultScope GUID), to search all spaces

Medium Time Period in minutes

Defaults to Yesterday on the Recent Activity Show menu. For defining the time range between Short and Long within which activities are displayed on the Recent Activity list.

Valid values include:

  • TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

  • YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

  • A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Long Time Period in minutes

Defaults to Last 7 Days on the Recent Activity Show menu. Used for defining the time range between Medium and Longest within which activities are displayed on the Recent Activity list.

Valid values include:

  • TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

  • YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

  • A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Longest Time Period in minutes

Defaults to Last 30 Days on the Recent Activity Show menu. For defining the longest range of time within which activities are displayed on the Recent Activity list.

Valid values include:

  • TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

  • YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

  • A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")

Shortest Time Period in minutes

Defaults to Today on the Recent Activity Show menu. Used for defining the shortest range of time within which activities are displayed on the Recent Activity list. Today is measured from midnight in your selected time zone.

Valid values include:

  • TODAY—Activities that have occurred since midnight in the currently selected time zone display on the Recent Activity list.

  • YESTERDAY—Activities that have occurred since midnight yesterday in the currently selected time zone display on the Recent Activity list.

  • A number of minutes—Activities that have occurred within the specified number of minutes display on the Recent Activity list. For example, a value of 60 renders as Last Hour on the Show menu. A value of 1440 is rendered as Last Day.

Example values:

Constant: TODAY (Displays all activity since midnight)
Constant: 2880 (Displays all activity within the last 2880 minutes. This is displayed as Last 2 Days on the Show menu.)
EL Expression: ${myAppBean.timePeriod} (Displays based on the value from the given Bean property "timePeriod")