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

Part Number E10148-18
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

38 Introducing the People Connections Service

The People Connections service provides social networking tools for use in enhancing connection and communication within a project team and throughout an enterprise. It does this through a set of features that include:

This chapter describes the task flows associated with the People Connections service and provides some troubleshooting tips.

This chapter includes the following sections:

38.1 Overview of the People Connections Service

The People Connections service provides social networking tools for creating, interacting with, and tracking the activities of one's connections. Its features enable users to manage their personal profiles, access the profiles of other users, provide ad hoc feedback, post messages, track activities, and connect with others.

In a production environment, an enterprise can leverage its back-end identity store as a means of providing People Connections with a population of potential connections. In a development environment, developers can add test-users to the jazn-data.xml file.

See Also:

For information about connecting to a back-end (LDAP) identity store for the production version of your application, see the chapter, "Managing Security," in the Oracle Fusion Middleware Administrator's Guide for Oracle WebCenter Portal. For information about creating test users in jazn-data.xml, see Section 24.2.2, "How to Define Roles and Grant Privileges in the jazn-data.xml File."

This section provides an overview of the People Connections service. It includes the following subsections:

38.1.1 People Connections Service Task Flows

The features of the People Connections service fall into five categories. Each category includes a set of task flows that expose People Connections features to your end users. Note that the Publisher task flow does not belong to these categories, but rather, works in concert with the Activity Stream.

This section introduces these categories. It includes the following subsections:

See Also:

For information about the People Connections service at runtime, see Part VIII, "Organizing Your Collaborative and Social Networking Environment," in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

For information about People Connections task flows, see Section 38.1.1, "People Connections Service Task Flows."

38.1.1.1 Activity Stream

The Activity Stream feature tracks the application activities of a user's connections. Table 38-1 lists the types of activities that may be tracked by the Activity Stream.

Table 38-1 Activities Tracked by Activity Stream

Service Tracked Activities

Announcements

  • Create announcement

  • Edit announcement

Blogs

  • Create blog

  • Update blog

Connections

  • Invitations to connect

  • People are connected

Discussions

  • Create forum

  • Create topic

  • Reply to topic

Documents

  • Create document

  • Edit document

  • Add tag

  • Remove tag

Events

  • Create an event

  • Edit an event

Feedback

  • Feedback left

  • Feedback received

Lists

  • Create a list

  • Add a row to a list

  • Edit a list row

Message Board

  • Message left

  • Message received

Pages

The following activities are tracked when they are performed within the service framework scope (for example, if a user creates pages under /myapp/mypages/, the page operations are not tracked):

  • Create page

  • Edit page

  • Delete page

  • Add tag

Profiles

  • Photo updated

  • Profile updated

  • Personal status note updated

Tagging

  • Add tag

  • Remove tag


Activity Stream compares somewhat to the Recent Activities service, which also tracks and reports on application activities (for more information, see Chapter 50, "Integrating the Recent Activities Service"). Both track the application activities of integrated services, though Activity Stream tracks a broader range of services. For example, Recent Activities tracks the Documents (including wikis and blogs), Announcements, Discussions, and Page services. Activity Stream tracks these services as well as People Connections. Recent Activities tracks activities no matter who performs the action. Activity Stream tracks activities performed by a user's connections and includes information about who performed the activity. Recent Activities does not include names.

The basic difference between these two services can be summarized as follows: Recent Activities provides an overview of what is happening in an application. Activity Stream provides an overview of what is happening with a user's connections.

The Publisher task flow works in concert with Activity Stream to provide content in the form of user messages. A message posted through the Publisher task flow is published to the Activity Streams of the user who entered it and that user's connections.

Activity Stream messages may include attachments, such as a file or a link. Depending on a file's mime type, Activity Stream allows for displaying a preview of such attachments. Activity Stream previews files through either a native web format or through UCM slide rendition. The previewer used depends on the mime type of the file to be previewed.

The mime types that use the native web format include:

  • image

  • htm

  • text

The mime types that use UCM slide rendition include:

  • pdf

  • powerpoint

  • powerpnt

  • pptx

Note:

PDF file previews are available in Activity Stream when the mime type is pdf, webContextRoot is specified in the UCM connection, and the WebCenter Portal: Spaces application is accessed through an Oracle HTTP Server.

Note that the mime types shown in these bullet lists are the only mime types that are previewed. Other mime types appear as links. The mime types docx and xlsx are not previewed in Activity Stream. Note also that a parameter associated with an Activity Stream task flow instance can be set to omit file previews (for more information, see Section 40.2, "People Connections Task Flow Binding Parameters").

Two Activity Stream task flows are available through the Resource Palette:

See Also:

For information about Activity Stream task flows at runtime, see the section, "Working with Activity Stream Task Flows," in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.1.2 Connections

Connections provides users with a means of managing their own connections and viewing the connections of others. Use Connections to collect business friends and contacts into one or more smaller social groups. Use connections lists to manage the display of your connections.

Three Connections task flows are available through the Resource Palette:

See Also:

For information about Connections task flows at runtime, see the section, "Setting Up Your Social Network," in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.1.3 Feedback

Feedback provides users with a means of viewing, posting, and managing feedback. By default, users can view feedback in their own Feedback views. Users can view and post feedback in other users' Feedback views.

Two Feedback task flows are available through the Resource Palette:

  • Feedback—Provides users with the main view of the Feedback task flow. The main view contains controls for viewing, posting, sorting, and filtering Feedback—both given and received—and for hiding received Feedback (Figure 38-6).

    Figure 38-6 Feedback Task Flow

    Feedback task flow
    Description of "Figure 38-6 Feedback Task Flow"

  • Feedback - Quick View—Provides users with a truncated view of the Feedback task flow, where only the most recent posts are shown. When there are more posts than can be displayed in the initial view, users can click a More link to navigate to the main view of the Feedback task flow. When user A accesses user B's view of Feedback - Quick View, user A additionally sees an Add Feedback option (Figure 38-7).

    Figure 38-7 Feedback - Quick View Task Flow

    Feedback - Quick View task flow
    Description of "Figure 38-7 Feedback - Quick View Task Flow"

See Also:

For information about Feedback task flows at runtime, see the section, "Working with Feedback Task Flows," in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.1.4 Message Board

Message Board provides a means of viewing and posting messages and attachments to Message Boards and Activity Streams.

Two Message Board task flows are available through the Resource Palette:

  • Message Board—Message Board provides users with the main view of Message Board messages and a means of adding, viewing, updating, hiding, deleting, and managing your view of messages, and for marking messages as private and sharing private messages (Figure 38-8).

    Figure 38-8 Message Board Task Flow

    Message Board task flow
    Description of "Figure 38-8 Message Board Task Flow"

  • Message Board - Quick View—Provides users with a truncated view of Message Board messages and a means of adding, viewing, updating, hiding, and deleting messages, and for marking messages as private and sharing private messages. Users can click a More link to navigate to the Detailed View (Figure 38-9).

    Figure 38-9 Message Board - Quick View Task Flow

    Message Board - Quick View task flow
    Description of "Figure 38-9 Message Board - Quick View Task Flow"

See Also:

For information about Message Board task flows at runtime, see the section, "Working with Message Board Task Flows" in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.1.5 Profile

Profile provides users with a variety of views into their own and other users' personal profile information. Such information can include a user's email address, phone number, office location, department, manager, direct reports, and so on. Profile takes the bulk of its information from the back-end identity store that provides your WebCenter Portal application with its users. Additionally, Profile may offer opportunities for altering some of this information and for providing additional data not included in the identity store.

Three Profile task flow are available through the Resource Palette:

  • Profile—Exposes a user's profile details, such as a user's email address, phone number, office location, department, manager, direct reports, and so on. It also exposes any personal image a user may have provided and the user's personal status message (Figure 38-10).

    Figure 38-10 Profile Task Flow

    Profile task flow
  • Profile - Snapshot—Exposes any personal image a user may have uploaded and provides a means of publishing messages, files, and links to a selected audience (Figure 38-11).

    Figure 38-11 Profile - Snapshot Task Flow

    Profile - Snapshot task flow

    Note:

    To enable users to upload anything to your ADF-based application at runtime, the page on which you have placed the upload task flow must have the usesUpload attribute set on the form. Additionally, for profile images, you must set the task flow binding parameter photoUploadAllowed to true. For more information, see the Note at the end of Section 39.2, "How to Add People Connections Task Flows to a Page," and see Chapter 40, "People Connections Task Flow Binding Parameters."

  • Profile Gallery—Provides a summary view of each People Connections task flow. For example, it includes Activity Stream - Quick View, Connections - Quick View, and so on (Figure 38-12).

    Figure 38-12 Profile Gallery Task Flow

    Profile Gallery task flow
    Description of "Figure 38-12 Profile Gallery Task Flow"

See Also:

For information about Profile task flows at runtime, see the section, "Viewing and Editing Personal Profiles" in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.1.6 The Publisher Task Flow

The Publisher task flow works in concert with Activity Stream. Users enter content into Publisher, which is then published to the Activity Stream of the user who posted it as well as to the Activity Streams of that user's connections (Figure 38-13).

Figure 38-13 Publisher Task Flow

Publisher task flow
Description of "Figure 38-13 Publisher Task Flow"

See Also:

For information about the Publisher task flow at runtime, see the section, "Sharing Items, Files, and URLs Through the Publisher Task Flow" in the Oracle Fusion Middleware User's Guide for Oracle WebCenter Portal: Spaces.

38.1.2 People Connections Service Requirements

For a successful integration of People Connections with your WebCenter Portal: Framework application, ensure that the following steps have been taken:

  1. Create a WebCenter Portal: Framework application (for more information, see Section 5.2, "Creating a Framework Application").

  2. Set up the WebCenter schema, and create a database connection to it (for more information, see Chapter 7, "Preparing Your Application for WebCenter Portal Services").

  3. Create a JSF (.jspx) page (for more information, see Section 5.3, "Adding Pages to a Portal").

  4. Secure your application and create some test users (for more information, see Chapter 69, "Securing Your WebCenter Portal: Framework Application," and Section 24.2.2, "How to Define Roles and Grant Privileges in the jazn-data.xml File").

  5. Drag and drop a People Connections task flow onto your page (for more information, see Section 39.2, "How to Add People Connections Task Flows to a Page").

  6. Provide required values for task flow bindings (for more information, see Chapter 40, "People Connections Task Flow Binding Parameters").

  7. Run the page.

  8. When required, provide the user name and password of a test user you created at Step 4.

38.2 Troubleshooting the People Connections Service

This section provides information to assist you in troubleshooting problems you may encounter while using the People Connections service.

People Connections task flows take up the full browser, even when empty

This problem may arise if you are using Internet Explorer, version 8 (IE8). In IE8, go to Tools, Compatibility View Settings. In the Compatibility View Settings dialog, clear the following check boxes:

New Profile Image is Not Shown

Changes to a Profile image may not be rendered immediately due to a stale WebCenter Database cache. Clicking the Refresh icon under the stale image will cause the image to update.