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

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

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

34 Creating Your Social Network

In WebCenter Portal: Spaces, Connections provides a means of establishing a social network that is comprised of your work friends and associates. Once you have connected with others, you can set up your working environment to provide different levels of access to those who are and are not connected to you. For example, you can enable access to your views of Profile, Message Board, Activity Stream, and Feedback to just your connections, leaving the unconnected without access. For Message Board and Feedback, you can give everyone view access, but limit post access to just your connections or to a limited set of your connections through a connections list.

This chapter provides an overview of Connections task flows and steps you through the tasks you can accomplish using them. It includes the following subsections:

Audience

This chapter is intended for users assigned an application role that includes, minimally, the permission People Connections: Connect with People. To work with connections lists, users must also be granted the permission People Connections: Update People Connections Data.

Users who plan to edit task flow properties must be assigned a role that also includes the permission Edit Pages. In a space (other than the Home space), users must be assigned a role that includes the permission Edit Page Access and Structure.

34.1 What You Should Know About Connections

Connections provides a means of collecting your business friends and contacts into a social network. It furnishes tools for managing your own connections and viewing the connections of others. Using People Connections Preferences, you can grant differing levels of access to those who are and are not your connections. For example, you can limit view privileges on your Profile to just your connections or enable your connections to view certain sections of your Profile, while hiding those sections from users who are not your connections.

See Also:

For information about setting your Connections Preferences, see Section 34.2, "Setting Connections Preferences."

When you connect with other users, you give them access to your People Connections views, and gain access to theirs.

Note:

The People Connections service encompasses Connections, Profile, Activity Stream, Message Board, and Feedback. For more information, see:

Before you begin to build your social network, your application administrator can set global application defaults that affect what all users may see and do with their own and other users' connections. For more information, see Section 6.4, "Configuring People Connections Defaults for the Spaces Application."

WebCenter Portal: Spaces provides the following Connections task flows:

Connections task flows have associated properties that you can use to control the appearance and behavior of a task flow instance. For example, you can use Connections properties to specify the number of connections to show or the number of rows to show in Connections - Card and Connections - Quick View task flows.

See Also:

For more information about Connections properties, see Section 34.5, "Setting Connections Task Flow Properties."

For information about using Connections features, see Section 34.4, "Setting Up Your Social Network."

34.2 Setting Connections Preferences

You use Connections Preferences to specify who can view information about the people you have connected with and whether to accept invitations to be others' connections automatically.

To set Connections preferences:

  1. Click the Preferences link next to the Administration link. This opens the Preferences dialog.

  2. Click People Connections to display People Connections preferences.

  3. Click the Connections tab to bring it forward (Figure 34-5).

    Figure 34-5 Connections Preferences

    Connections Preferences
  4. From the Grant View Access to dropdown list, select the users who can view your list of connections:

    • Everyone—All users, including users who are not logged in, can see information about your connections.

    • Authenticated Users—Only users who are logged in can view your connections.

    • User's Connections—Only you and your Connections can view your connections.

    • User Only—Only you can view your connections.

    Note:

    The Grant View Access to dropdown is disabled in your view if the administrator disables user override for these settings in Connections configuration settings. For more information, see Section 6.4.3.3, "Configuring Connections."

  5. Select Accept Invitations Automatically to automatically accept invitations to connect with another user.

    Deselect this check box to leave yourself the option of accepting, refusing, or ignoring an invitation to connect with another user.

  6. Click OK.

34.3 Adding a Connections Task Flow to a Page

For the steps to add a People Connections service task flow to a page, see Section 18.5, "Adding a Component to a Page."

34.4 Setting Up Your Social Network

Connections provides the core features for building and visualizing your social network. Use Connections task flows to invite other users to connect, to accept connection invitations, to create connections lists, and to remove obsolete connections.

Note:

The level of access you have to a connection is determined by the People Connections defaults set by the application administrator, a given connection's People Connections Preference settings, and properties set on a Connections task flow instance.

For information about Connections Preferences, see Section 34.2, "Setting Connections Preferences." For information about People Connections defaults set by the application administrator, see Section 6.4, "Configuring People Connections Defaults for the Spaces Application." For information about Connections task flow properties, see Section 34.5, "Setting Connections Task Flow Properties."

This section provides information about using Connections to set up and manage your personal social network. It contains the following subsections:

34.4.1 Viewing Your Connections

You can view your connections in any Connections task flow. One of these is always available on the Connections page, which you can navigate to by clicking your user name wherever it appears in the application. In large lists of connections, you can use a search feature to locate a particular connection.

This section describes how to access the Connections page and view or search through your connections. It includes the following subsections:

34.4.1.1 Viewing Your Connections

To view your connections:

  1. Go to the Home space, and open your profile page, for example, by clicking on your user name in the UI.

    You can also use the following URL to navigate to a Profile page:

    http://host:port/webcenter/spaces/profile/userName
    

    Tip:

    For userName:

    • When userName matches the current user or is not specified, this URL navigates to your view of the Profile page.

    • When userName is not the current user's, it navigates to the specified user's view of the Profile page.

  2. On the resulting page, click the Connections tab to bring it forward (Figure 34-6).

    Figure 34-6 Connections Tab on Profile Page

    Connections Tab on Profile Page
  3. From the Show dropdown, select All Connections.

34.4.1.2 Searching Through Your Connections

The Connections search feature provides an efficient way to locate a particular connection in an otherwise long list of connections.

To search through your connections:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. From the Show dropdown, select All Connections.

  3. In the Filter field, enter the user name of the connection, and click the Find connection icon next to the field.

    Tip:

    Click a connection name to open a Profile dialog and view profile details.

To exit the search, click the Clear icon that appears to the right of the Filter field (Figure 34-7).

Figure 34-7 Clear Icon Next to Filter Field

Clear icon next to Filter field

34.4.2 Inviting Others to Connect

Connecting to another user potentially provides view access to that user's personal Profile and Activity Stream, and view and post access to the user's Message Board. The level of access you have to a connection is determined by the People Connections defaults set by the application administrator, the individual user's People Connections Preference settings, and properties set on the task flow instance.

See Also:

For information about Connections Preferences, see Section 34.2, "Setting Connections Preferences." For information about People Connections defaults set by the application administrator, see Section 6.4, "Configuring People Connections Defaults for the Spaces Application." For information about Connections task flow properties, see Section 34.5, "Setting Connections Task Flow Properties."

You can issue invitations from the Connections - Detailed View task flow and from the Connections page that you access in the Home space. This section describes the Connections page method.

To invite another user to connect:

  1. Go to the Connections page, for example, by clicking your user name in the UI and then selecting the Connections subpage on the resulting Profile page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. On the Connections page, click the Invite People link to open the Invite People dialog.

  3. In the Find User field, enter the user name of the person you want to invite to be your connection, then click the Find user icon (Figure 34-8).

    See Also:

    For tips on searching for a user in the identity store, see Section 54.3.4.1, "Searching for a User or Group in the Identity Store."

    Figure 34-8 Invite People Dialog

    Invite People dialog
  4. Click the Invite link next to the user of interest to open the Invitation Message dialog (Figure 34-9).

    Figure 34-9 Invitation Message Dialog

    Invitation Message dialog
  5. Enter a connection invitation or use the default message.

  6. Optionally, from the Select connection lists dropdown, select one or more connections lists to which to add the user once the invitation is accepted.

  7. Click Invite.

    If the person you have invited set Preferences to automatically accept all invitations, you are connected immediately. Otherwise, the invitation becomes available in the recipient's view of the Connections page.

    Tip:

    You can also view invitations from the Connections - Detailed View task flow For more information, see Section 34.4.3, "Viewing Invitations to Connect."

    See Also:

    For information about Connections Preferences, see Section 34.2, "Setting Connections Preferences."

34.4.3 Viewing Invitations to Connect

You can view the invitations you have sent and received in the Connections - Detailed View task flow and on the Connections page. This section describes the Connections page case. It includes the following subsections:

34.4.3.1 Viewing Invitations You Have Sent

To view invitations you have sent:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. From the Show menu, select Sent Invitations.

    The Connections page refreshes, now showing a list of the pending invitations to connect that you have sent (Figure 34-10).

    Figure 34-10 Sent Invitations View

    Sent Invitations View

    Note:

    In the Show menu, the number next to Sent Invitations represents the number of pending invitations you have sent.

34.4.3.2 Viewing Invitations You Have Received

To view invitations you have received:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. From the Show menu, select Pending Invitations.

    The Connections page refreshes, now showing a list of the pending invitations to connect that you have received (Figure 34-11).

    Figure 34-11 Pending Invitations View

    Pending Invitations view

    Tip:

    In the Show menu, the number next to Pending Invitations represents the number of pending invitations you have received.

34.4.4 Responding to Invitations to Be a Connection

Connections provides two methods for responding to an invitation to connect:

  • You can set your Connections Preferences to accept such invitations automatically.

    See Also:

    For information about setting Connections Preferences, see Section 34.2, "Setting Connections Preferences."

  • You can manually accept, decline, or ignore such invitations through the Connections - Detailed View task flow or in your view of the Connections page.

This section describes the manual method of responding to invitations to connect from the Connections page.

To respond to invitations to connect:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. From the Show menu, select Pending Invitations to display a list of your pending invitations (Figure 34-12).

    Figure 34-12 Pending Invitations View Showing Accept, Decline, and Ignore Buttons

    Accept, Decline, and Ignore buttons

    Tip:

    Alternatively, click the Invitations icon (flag).

  3. Next to a given invitation, select your desired response:

    • Accept—Make the connection.

    • Decline—Refuse the connection, with notification. When you decline an invitation to connect, the issuer becomes aware of this by watching his sent invitations.

    • Ignore—Remove the connection, without responding. When you ignore an invitation to connect, the issuer does not become aware of this by watching his sent invitations.

    Once you respond to an invitation, it is removed from the list of received invitations. The users whose invitations you accept appear in your view of the Connections page.

  4. Optionally, return to your default view of the Connections page by selecting All Connections from the Show menu.

34.4.5 Creating and Managing Connections Lists

Connections provides a means of grouping your connections into lists for managing the display of your connections and your connections activities. For example:

This section describes how to create and manage lists of connections. It includes the following subsections:

34.4.5.1 Creating a Connections List

You can create a connections list using the Connections and Connections - Detailed View task flows and on the Connections page. This section describes how to create a connections list on the Connections page.

To create a list of connections:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. Click Organize to open the Organize Connections and Lists dialog (Figure 34-13).

    Figure 34-13 Organize Button and Resulting Dialog

    Organize button and resulting dialog
  3. Click New Connection List to open the Create List dialog

  4. Enter a name for your list of connections, and click OK to create the list and open it in the Organize Connections and Lists dialog (Figure 34-14).

    Figure 34-14 New ST Team Connections List

    New Connections list

    Tip:

    To view all of your connections, click All connections.

    See Also:

    For information about adding connections to a list, see Section 34.4.5.2, "Adding a Connection to a List."

34.4.5.2 Adding a Connection to a List

You can add connections to a Connections list using the Connections page and the Connections and Connections - Detailed View task flows. This section describes the Connections page case.

To add a connection to a Connections list:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. Click Organize to open the Organize Connections and Lists dialog, and select All connections, to show all of your connections (Figure 34-15).

    Figure 34-15 Organize Connections and Lists Dialog

    Organize Connections and Lists dialog
  3. Click Add to List next to the user, and select one or more lists from the resulting dialog (Figure 34-16).

    Figure 34-16 Add to List Dialog

    Add to List dialog
  4. Click Save and Close.

    Tip:

    Click All to add the selected user to all of your Connections lists.

  5. Repeat steps 3 and 4 until you are done.

  6. Click OK to close the Organize Connections and Lists dialog.

34.4.5.3 Removing a Connection from a List

To remove a connection from a list:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. Click Organize to open the Organize Connections and Lists dialog, and select the list from which to remove a connection to show the list (Figure 34-17).

    Figure 34-17 Organize Connections and Lists Dialog with ST Team List Selected

    Organize Connections and Lists dialog
  3. Click Remove from List next to the user to open the Remove from List dialog (Figure 34-18).

    Figure 34-18 Remove from List Dialog

    Remove from List dialog
  4. Select one or more lists from which to remove the selected user, or select My Connections and All My Lists to remove the selected user from all lists and as your connection.

  5. Click Save and Close.

  6. Repeat steps 3 through 5 until you are done.

  7. Click OK to close the Organize Connections and Lists dialog.

34.4.5.4 Deleting a Connections List

When you delete a Connections list, you are not deleting the connections you added to the list. You are deleting only the selected grouping, that is, the list itself. The connections that were on the deleted list continue to be your connections.

You can delete a Connections list from the Connections page and from the Connections and Connections - Detailed View task flows. This section describes the Connections page case.

To delete a connections list:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. Click Organize to open the Organize Connections and Lists dialog.

  3. Click the Actions icon next to the Connections list you want to delete, and select Delete List from the resulting menu (Figure 34-19).

    Figure 34-19 Delete List Option on Actions Menu

    Delete List option on Actions menu
  4. In the resulting confirmation dialog, click Yes to delete the list.

  5. Click OK to close the Organize Connections and Lists dialog.

34.4.6 Removing a Connection

Included in the process of managing your connections is the occasional necessity of weeding people out: they may leave your group or the company, or there may no longer be a compelling reason to stay connected.

Controls for removing a connection are available through the Connections page and the Connections and Connections - Detailed View task flow. This section describes the Connections Page case.

To remove one of your connections:

  1. Go to the Connections page.

    See Also:

    For more information, see Section 34.4.1.1, "Viewing Your Connections."

  2. Click Organize to open the Organize Connections and Lists dialog.

  3. Click the Remove button next to the connection to remove.

  4. In the resulting dialog, click Yes to remove the selected connection (Figure 34-20).

    Figure 34-20 Confirmation Dialog for Remove Connection Action

    Confirmation dialog for Remove Connection action
  5. Click OK to close the Organize Connections and Lists dialog.

34.5 Setting Connections Task Flow Properties

Connections task flows have associated properties, which users with sufficient privileges can access through the Component Properties dialog in Composer (Figure 34-21).

Figure 34-21 Connections Task Flow Component Properties

Connections task flow component properties

See Also:

For information about accessing the Component Properties dialog, see Section 18.6.2, "Setting Properties on a Component."

The following sections provide information about properties associated with Connections task flows and describe the properties available on the Parameters tab:

34.5.1 What You Should Know About Connections Task Flow Properties

When you set property values on a Connections task flow, you are affecting only the task flow instance on which the value is set. Other instances of the same task flow are not affected by such changes.

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 34.5.2, "Connections 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 22, "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. These properties are common to all task flows. For more information, see Section 18.6, "Modifying Page Components."

The content of the Events tab depends on the events supported by the task flow. For more information, see Section 18.6.7, "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 (EL) 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 syntax is invalid, an error appears and the value is neither applied nor saved. Generic Display Options are those cataloged in Table 18-1.

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

34.5.2 Connections Task Flow Parameters

Table 34-1 describes the parameters that are unique to Connections task flows.

Table 34-1 Connections Task Flow Parameters

Parameter Description

Allow Remove

A Boolean value representing whether a control is available on the task flow for removing a connection

Enter either true or false.

This value is honored only when the task flow instance is rendered in list format. For more information, see Profile Format.

This parameter is associated with the Connections - Card task flow.

Connection List Name

The name of a grouped list of connections

Use this parameter to limit the display of connections to those on the specified Connections list.

Enter the name of a Connections list.

This parameter is associated with the Connections - Card task flow.

Current View

The view to display by default

Valid values include:

  • connections—(the default value) a list of connections

  • receivedInvitations—a list of connections invitations you received

  • sentInvitations—a list of connections invitations you sent

  • people—a search field for finding people with whom to connect

When users access the task flow instance, the view specified here is the first one they see. All selections, except people, provide controls for navigating to the application default view (connections). Selecting people provides search and select controls for inviting other users to connect.

This parameter is associated with the Connections task flow.

Filter Pattern

A value to act as a filter against task flow content

For example, to show only those connections with a user name that includes the term pat (including patrick or sripathy), enter pat in the Filter Pattern field.

This parameter is associated with the Connections - Card task flow.

Hide Footer

A Boolean value representing whether to hide the task flow footer

Use this parameter to show or hide a link at the bottom of the task flow that enables users (when shown) to navigate to a detailed view of Connections when the number of available connections exceeds the number of connections that are shown.

  • Select the check box (#{true}) to hide the task flow footer.

  • Deselect the check box (#{false}) to show the task flow footer.

This parameter is associated with the following task flows:

  • Connections – Card

  • Connections – Quick View

Hide Header

A Boolean value representing whether to hide the task flow header

Use this parameter to show or hide a link at the bottom of the task flow that enables users (when shown) to navigate to a detailed view of Connections when the number of available connections exceeds the number of connections that are shown.

  • Select the check box (#{true}) to hide the task flow header.

  • Deselect the check box (#{false}) to show the task flow header.

This parameter is associated with the Connections - Quick View task flow.

Number of Columns

The number of columns to show in the task flow

For example, with six connections to show, a value of 2 means those connections are shown in two columns with three rows.

When a user's number of connections exceeds the number of connections allowed after column and row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections. (See also Number of Rows.)

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

Number of Connections per page

The number of connections to show in the given task flow instance

Enter a numeric value, such as 10, 2, 15, and so on.

The number you enter here limits the number of connections that are shown in the task flow instance. If a user's number of connections exceeds the specified value, a More link is shown, enabling the user to navigate to a full view of the Profile page's Connections subpage.

This parameter is ignored if both the number of rows and the number of columns have been specified together as parameters.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Detailed View

  • Connections - Quick View

Number of Rows

The number of rows to show in the task flow

For example, with six connections to show and a value of 2 for Number of Columns, a value of 2 for Number of Rows means connections are shown in two columns with two rows. That is, four connections are shown.

When a user's number of connections exceeds the number of connections allowed after column and row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections. (See also Number of Columns.)

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

Number of Rows (list layout)

The number of rows to show in a list layout of the Connections task flow

This value is honored only when the view of the Connections task flow is set to connections. (For more information, see Current View.)

When a user's number of connections exceeds the number of connections allowed after row restrictions are applied, Previous and Next links are shown, enabling the user to page through his connections.

This parameter is associated with the Connections task flow.

Profile Format

The layout style for the task flow

Enter one of the following:

  • vcard—Renders each connection in a virtual business card and includes the connection's user name and status message and quick-access buttons for interacting with your connections.

  • iconic—Renders the connection's personal profile photo and shows the user name below the photo.

  • list—Renders connections in a list, showing the personal profile photo, user name, information about recent profile updates, and quick-access buttons for interacting with your connections.

  • tiled—Renders the connection's personal Profile photo and shows the user name and job title beside the photo.

This parameter is associated with the Connections - Card task flow.

Profile Launched on Selection

A Boolean value representing whether a Profile popup should open when a user clicks a connection listed in the task flow

  • Select the check box (#{true}) to enable a Profile popup to launch when a user clicks a connection.

  • Deselect the check box (#{false}) to suppress this option.

This parameter is associated with the Connections - Card task flow.

Sort Criteria

The connections sort order

Enter LAST_ACTIVITY_TIME to sort connections in descending date/time order. Leave blank to sort alphabetically by name.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Detailed View

User Id

The ID of the user to show in the task flow

This value is set automatically (#{securityContext.userName}). Do not edit this value.

This parameter is associated with the following task flows:

  • Connections - Quick View

  • Connections - Detailed View

User Name

The ID of the user to show in the task flow

This value is set automatically (#{securityContext.userName}). Do not edit this value.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections


34.5.3 Using Properties to Configure a Connections Task Flow Instance

This section provides examples of how you use property values to affect the behavior of a given task flow instance. Because you make these changes in page edit mode (Composer), they affect all users' views of the affected task flow instance.

This section includes the following subsections:

34.5.3.1 Adding a Remove Button to Connections - Card

By default, the Connections - Card task flow does not provide a control for permanently removing a connection. You can use the Allow Remove property on a Connections - Card task flow instance to render a Remove button next to each listed connection. Allow Remove is honored when the task flow's Profile Format property is set to List or Virtual Business Card.

To enable the removal of a connection in a Connections - Card task flow:

  1. Edit the properties of a Connections - Card task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Set Profile Format to list.

  4. Provide a value for Allow Remove:

    • Select the check box (#{true}) to enable the display of a Remove button next to a listed connection (Figure 34-22).

      Figure 34-22 Remove Icon on a Connections - Card Task Flow

      Remove icon on a Connections - Card task flow
    • Deselect the check box (#{false}) to disable this feature.

  5. Click OK.

34.5.3.2 Restricting Connections Displayed to Those on a Named List

In an instance of the Connections - Card task flow, you can use the Connection List Name property to restrict the display of connections to only those users included on a named Connections list.

See Also:

For information about Connections lists, see Section 34.4.5, "Creating and Managing Connections Lists."

To restrict a Connections - Card task flow to a particular Connections list:

  1. Edit the properties of a Connections - Card task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. In the Connection List Name field, enter the name of the Connections list to use to limit the display of connections.

  4. Click OK.

34.5.3.3 Specifying an Initial View for a Connections Task Flow Instance

Use the Current View property to specify the initial view of a Connections task flow instance. For most views, users can change the default you specify here. The exception is the people view, in which there are no controls for switching to a different view.

To specify an initial view for a Connections task flow instance:

  1. Edit the properties of a Connections task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. For Current View, select one of the following:

    • connections—(the default value) a list of connections

    • receivedInvitations—a list of connections invitations you received

    • sentInvitations—a list of connections invitations you sent

    • people—a search field for finding people with whom to connect

  4. Click OK.

34.5.3.4 Limiting the Number of Displayed Connections

The Connections - Card, Connections - Detailed View, and Connections - Quick View task flows provide the property Number of Connections per page for limiting the number of connections to show at a time. If a user's number of connections exceeds the specified value, a link is shown at the bottom of the task flow to enable the user to navigate to a full view of the Profile page's Connections subpage.

To limit the number of displayed connections in a Connections - Card, Connections - Detailed View, or Connections - Quick View task flow instance:

  1. Edit the properties of a Connections - Card, Connections - Detailed View, or Connections - Quick View task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Provide a value for Number of Connections per page.

  4. Click OK.

34.5.3.5 Specifying Numbers of Rows and Columns

The Connections, Connections - Card, and Connections - Quick View task flows provide properties for controlling the number of columns and rows to show at a time. When column and row values are both specified, and a user's number of connections exceeds the specified values, Previous and Next links are shown, enabling the user to page through his connections.

To specify the number of rows and columns of connections to show:

  1. Edit the properties of a Connections, Connections - Card, or Connections - Quick View task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Enter a numeric value to control the number of rows to show:

    • For Connections, enter a number for Number of Rows (list layout).

    • For Connections - Card and Connections - Quick View, enter a number for Number of Rows.

  4. For Connections - Card and Connections - Quick View, enter a numeric value in the Number of Columns field to control the number of columns to show.

  5. Click OK.

34.5.3.6 Applying a Filter to a Connections - Card Task Flow Instance

The Filter Pattern property enables you to apply a filtering term that limits the display of connections in a Connections - Card task flow instance to only those who meet the filtering criteria. For example, to show only those connections with a user name that includes the term pat (including patrick or sripathy), enter pat for the Filter Pattern property.

The filter is applied to all of the information in a given card, so you can filter against things like the user's job title or name. For example, entering the term manager, ensures that only those connections whose job title includes manager are displayed in the task flow instance.

To apply a filter to a Connections - Card task flow instance:

  1. Edit the properties of a Connections - Card task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Enter a filtering term for Filter Pattern.

    Tip:

    For example, enter a job title, a user name, or partial values, such as man.

  4. Click OK.

34.5.3.7 Selecting a Display Format for a Connections - Card Task Flow Instance

The Profile Format property provides options for controlling the arrangement of connections within a Connections - Card task flow instance. Both the placement of information and the amount of information shown are affected by your selection.

To select a display format for a Connections - Card task flow instance:

  1. Edit the properties of a Connections - Card task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Select a format from the Profile Format dropdown list:

    • Virtual Business Card—Renders each connection in a virtual business card and includes the connection's user name and status message and quick-access buttons for interacting with your connections (Figure 34-23).

      Figure 34-23 Connections - Card in Virtual Business Card Format

      Connections - Card in virtual business card format
    • Iconic—Renders the connection's personal profile photo and shows the user name below the photo (Figure 34-24).

      Figure 34-24 Connections - Card in Iconic Format

      Connections - Card in Iconic format
    • List—Renders connections in a list, showing the personal profile photo, user name, information about recent profile updates, and quick-access buttons for interacting with your connections (Figure 34-25).

      Figure 34-25 Connections - Card in List Format

      Connections - Card in List format
    • Tiled—Renders the connection's personal Profile photo and shows the user name and job title beside the photo (Figure 34-26).

      Figure 34-26 Connections - Card in Tiled Format

      Connections - Card in Tiled format
  4. Click OK.

34.5.3.8 Invoking a Profile Popup from a Connections - Card Task Flow Instance

The Profile Launched on Selection property provides a means of launching a Profile popup when users click a connection name in a Connections - Card task flow instance (Figure 34-27).

Figure 34-27 Invoking a Profile Popup from the Connections - Card Task Flow

Invoking a Profile popup from Connections - Card

When this option is not selected, clicking a connection name in the task flow simply selects the connection.

To enable the launch of a Profile popup from a Connections - Card task flow instance:

  1. Edit the properties of a Connections - Card task flow instance.

    See Also:

    For information about editing task flow properties, see Section 18.6, "Modifying Page Components."

  2. In the Component Properties dialog, bring the Parameters tab forward.

  3. Select an option for Profile Launched on Selection:

    • Select the check box (#{true}) to enable a Profile popup to launch when a user clicks a connection.

    • Deselect the check box (#{false}) to suppress this option.

  4. Click OK.