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

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

40 People Connections Task Flow Binding Parameters

Each People Connections task flow has a set of required and optional task flow binding parameters. These provide a means of capturing information that is useful to the task flow's successful function. For example, all People Connections task flows provide a binding parameter for capturing the ID of the current runtime user. This value (typically #{securityContext.userName}) enables the task flow to return People Connections data that is relevant to the current user.

In addition to providing required values for successful task flow rendering, you can use task flow binding parameters to customize the appearance and behavior of a task flow instance. For example, you can use parameter values to determine whether headers and footers are rendered, the number of rows and columns of information to show, whether to apply a filter to returned data, and the like.

You can provide task flow binding parameter values when you drag and drop a task flow onto an application page. Doing so opens the Task Flow Bindings dialog (for more information, see Section 39.2, "How to Add People Connections Task Flows to a Page"). You can also adjust task flow binding parameter values after you have placed a task flow on a page.

This chapter describes how to revise task flow parameter values at design time and provides a table that lists and describes the binding parameters associated with People Connections task flows. It includes the following sections:

40.1 How to Revise People Connections Task Flow Binding Parameters

After you have added a task flow to a page, you may want to customize the instance by revising its binding parameter values. This section describes how to access the Edit Task Flow Binding dialog and change binding parameter values.

To access the Edit Task Flow Binding dialog:

  1. Open the application page and set the view to bindings by clicking the Bindings tab at the bottom of the page.

  2. Under Executables, double-click the task flow for which to revise task flow binding parameters (Figure 40-1) to open the Edit Task Flow Binding dialog (Figure 40-2).

    Tip:

    Task flow names under Executables differ from names in design view. For example, Message Board task flows are instead referred to as wall, and Feedback task flows are instead referred to as kudos.

    Figure 40-1 Bindings View of an Application Page

    Bindings view of an application page
    Description of "Figure 40-1 Bindings View of an Application Page"

    Figure 40-2 Edit Task Flow Binding Dialog

    Edit Task Flow Binding dialog
    Description of "Figure 40-2 Edit Task Flow Binding Dialog"

  3. Revise binding parameter values (for more information, see Section 40.2, "People Connections Task Flow Binding Parameters").

  4. Click OK to save your changes and exit the dialog.

  5. Save and run your page to see the results.

40.2 People Connections Task Flow Binding Parameters

Table 40-1 lists and describes task flow binding parameters applicable to the People Connections service.

Table 40-1 People Connections Service Task Flow Binding Parameters

Parameter Description

__followEnforced

A means of enforcing the follow logic when querying Activity Stream

  • Enter #{true} to establish that the user must follow the business object to access streamed activities, even when the object's activities are queried in an advance query clause. The default is true.

  • Enter #{false} to omit this requirement. The activities streamed for Fusion business objects are returned as far as required by the advanced query, no matter whether the user follows the objects.

This parameter (for Fusion application business objects) is used in conjunction with the advancedQuery parameter.

This parameter is associated with the Activity Stream task flow.

__objectExtHandlerEnabled

A means of using the object extension handler to process Fusion application business objects

  • Enter #{true} to use the object extension handler to process business objects.

  • Enter #{false} to omit using the object extension handler. False is the default.

When you enter #{true}, then, before querying activities for the business objects, the Activity Stream uses the object extension handler to process the business objects. The handler checks whether the user has permission to access the business object. If the user does not have permission, the object is removed from the list, and, none activities are retrieved from this object.

This parameter is associated with the following task flows:

  • Activity Stream

  • Activity Stream - Quick View

__objects

A comma separated list of objects for which to show activities

Enter objects in the format object-id;object-type;service-id. Typically used only for followed objects.

This parameter is associated with the Activity Stream task flow.

__objectSecured

A means of enforcing a security check on a Fusion application business object

  • Enter #{true} to enforce the security check.

  • Enter #{false} to omit the security check. False is the default.

The security check is performed by the resource authorizer that is implemented by the Fusion application. If a user has no permission on a business object, the activities related to that business object are filtered out.

This parameter is associated with the Activity Stream task flow.

This parameter is associated with the following task flows:

  • Activity Stream

  • Activity Stream - Quick View

advancedQuery

A field for specifying a custom query to filter streamed items

For more information, see Section 40.3, "What You Should Know About the Activity Stream Advanced Query Option."

This parameter is associated with the Activity Stream task flow.

connectionListName

The name of a connections list

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

currentView

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.

display_maxConnections

The maximum number of connections to show in the task flow

For example, enter 5 to specify that a maximum of five connections can appear in the task flow. A More link appears at the bottom of the task flow when there are more connections than the specified number of connections. Users click More to open the main view of the task flow where all connections are show.

The value entered for this parameter is honored only when values for display_numberOfRows and display_numberOfColumns have not both been specified. If values for both of these parameters have been specified, then Previous and Next links appear when there are more connections than can fit into the specified numbers of rows and columns.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

display_numberOfColumns

The number of columns to show in the task flow

For example, in a Connections - Card task flow that shows six connections, a value of 2 means those connections are shown in two columns with three rows (see also display_numberOfRows and display_maxConnections).

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

display_numberOfRows

The number of rows to show in the task flow

For example, in a Connections - Card task flow that shows six connections and a value of 2 for display_numberOfColumns, a value of 2 for this parameter means connections are shown in two columns with two rows. That is, four connections are shown. A More link appears at the bottom of the task flow when there are more connections than can be fit in the specified number of columns and rows. Users click More to open the main view of the task flow where all connections are shown.

See also display_maxConnections.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

display_profileFormat

The default layout style for the task flow

Enter one of the following:

  • vcard—displays a connection's photo and status message.

  • iconic—displays a connection's photo and user name.

  • list—displays connections in a list, with each list row showing the profile photo, user name (linked to a summary profile view), mail address, job title, status message, and actions icons and links.

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

In all layouts, the name links to a summary view of the user's Profile.

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

display_removalAllowed

A means of showing or hiding the Remove action on the task flow

Enter true to show the Remove action. Enter false to hide the Remove action. The default value (true) is applied if the input is invalid.

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

display_sortedBy

The connections sort order

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

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

displayCount

The number of items to show in the task flow

For example, enter 5 to specify that a maximum of five items can appear in the task flow. In quick views, a More link appears at the bottom of the task flow when there are more items than the specified number of items. Users click More to open the main view of the task flow where all items are accessible. In main views, Previous and Next links are shown. Users click these to page through entries.

This parameter appears in the component properties for the following task flows:

  • Feedback

  • Feedback - Quick View

  • Message Board

  • Message Board - Quick View

displayMessageSize

The number of characters to show for each feedback message

Messages exceeding the specified value are truncated, and an ellipse (…) is appended to the end.

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

editMode

A means of enabling an edit mode on a Profile task flow instance

Enter #{true} to enable an edit mode. Enter #{false} to disable it.

This parameter is associated with the Profile task flow.

enableContextInfo

A means of showing or omitting detailed information about the object in the current context (that is, in a popup or other contextual instrument)

  • Enter #{true} to enable Activity Stream to display the af:contextInfo component (a small, red dot). Users can click this dot to view object detail information.

  • Enter #{false} to omit object detail information.

When this parameter is true and the contextInfoTaskflowId in the service definition is defined, the activity from the service displays the af:contextInfo. Otherwise, no context information is shown.

This parameter is associated with the Activity Stream task flow.

filterPattern

A filter against task flow content

For example, enter pat to show only those connections named pat (including patrick or sripathy).

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

fromDate

The start date of a date range within which to show feedback messages

Enter dates in the format YYYY-MM-DD.

See also toDate.

This parameter is associated with the following task flows:

  • Feedback

  • Feedback - Quick View

  • Message Board

hideActions

A means of hiding the actions normally associated with a Feedback or Message Board entry, such as Edit, Private, Hide, and Delete

  • Enter #{true} to hide actions associated with a Feedback or Message Board entry.

  • Enter #{false} to show such actions. When no value is entered, false is the default.

This parameter appears in the component properties for the following task flows:

  • Feedback – Quick View

  • Message Board – Quick View

hideAttach

Specifies whether the Attach: File|Link option is shown or hidden

  • Check for #{true} to hide the Attach: File|Link option.

  • Clear for #{false} to show the Attach: File|Link option.

This parameter is associated with the Publisher task flow.

hideComments

A means of showing or hiding the Comments feature on streamed activities

Enter true to hide the Comments feature. Enter false to show it.

This parameter is associated with the Activity Stream task flow

hideConfigure

A means of hiding the personalization option on the task flow instance

This parameter is associated with the following task flows:

  • Activity Stream

  • Activity Stream - Quick View

hideDocumentUploader

A means of showing or hiding the Publisher task flow's document uploader

Enter #{true} to hide the Publisher task flow's document uploader. Enter #{false} to show it.

This parameter is associated with the Publisher task flow.

hideFooter

A means of showing or hiding the task flow footer

The task flow footer contains the More link that appears at the bottom of a task flow when there are more items to show than can be accommodated in the current view. Hiding the footer hides the More link. Hiding the footer does not affect Previous and Next links that may also appear at the bottom of a task flow.

Enter true to hide the footer. Enter false (default) to show the footer.

This parameter is associated with the following task flows:

  • Activity Stream - Quick View

  • Connections - Card

  • Connections - Quick View

  • Feedback - Quick View

  • Message Board - Quick View

hideGiven

A means of showing or hiding feedback given to a user

Enter true to allow the rendering of given feedback. Enter false to prohibit it.

This parameter is associated with the following task flows:

  • Feedback

  • Feedback - Quick View

hideHeader

A means of showing or hiding the task flow header

Enter true to hide the task flow header. Enter false (default) to show the task flow header.

This parameter is associated with the following task flows:

  • Activity Stream - Quick View

  • Connections - Quick View

  • Feedback

  • Feedback - Quick View

  • Message Board

  • Message Board - Quick View

hideInlinePreview

A means of allowing or omitting an inline preview of files attached to streamed activities

Enter true to omit a file preview. Enter false to show it.

This parameter is associated with the Activity Stream task flow.

hideLike

A means of showing or hiding the Like link on a streamed activity

Enter true to hide the Like link. Enter false to show it.

This parameter is associated with the Activity Stream task flow

hidePublisher

A means of showing or hiding the message entry field and the upload file and URL controls (the Publisher)

  • Enter #{true} to disable the display of the message entry field in a given task flow instance.

  • Enter #{false} to allow the display of the message entry field in a given task flow instance.

This parameter is associated with the following task flows:

  • Message Board

  • Message Board - Quick View

hideScopePicker

Specifies whether the Share something with option is shown or hidden

  • Check for #{true} to hide the Share something with option.

  • Clear for #{false} to show the Share something with option.

This parameter is associated with the Publisher task flow.

hintsTextKey

Specifies the resource bundle class and message key for hint text

Use the format key[,RBClass]. __EMPTY__ as the predefined key for no hint text. This is the default value.

This parameter is associated with the Publisher task flow.

imageSize

The display size of the profile photo

Enter one of the following values:

  • ORIGINAL

  • LARGE

  • MEDIUM

  • SMALL

This parameter is associated with the Profile - Snapshot task flow.

isUpdateStatus

A means of dedicating the task flow instance to updating the current user's Profile status message

Enter #{true} to devote the task flow instance to updating user status messages. Enter #{false} to omit publishing messages to the current user's Profile status message.

This parameter is associated with the Publisher task flow.

keepOpenAfterPublish

Specifies whether the text box remains active after a user clicks the Publish button

  • Enter #{true} to keep the text box open after a message is published.

  • Enter #{false} to close the text box after a message is published.

This parameter is associated with the Publisher task flow.

numberOfRows_list

The number of rows to show when the Connections task flow instance is set to list view

This parameter is associated with the Connections task flow.

objectId

The ID of an object to associate with a published message

This parameter is associated with the Publisher task flow.

objectType

The type of an object to associate with a published message

This parameter is associated with the Publisher task flow.

orgBreadCrumbsShown

A means of showing or omitting organization breadcrumbs on a user profile that renders a management chain that is linked to each member up the chain

Enter #{true} to show organizational breadcrumbs. Enter #{false} to omit them.

This parameter is associated with the Profile - Snapshot task flow.

pageSize

The number of items to stream in a given task flow instance

This parameter is associated with the following task flows:

  • Activity Stream

  • Activity Stream - Quick View

pagination

The form of pagination to use on a multipage stream

  • Enter #{true} to show Previous and Next links.

  • Enter #{false} hide to omit Previous and Next links. Instead, a more link is rendered, enabling users to navigate to a fuller view of the task flow where all streamed activities are shown.

This parameter is associated with the Activity Stream task flow.

photoUploadAllowed

A means of allowing a photo upload from the profile screen

Enter true (default) to allow users to upload a photo to their profile. Enter false to prevent users from uploading a photo.

This parameter is associated with the task flow Profile - Snapshot.

profileEditLinkShown

A means of showing or omitting an Edit link on a Profile - Snapshot task flow

Enter #{true} to show the Edit link. Enter #{false} to hide it.

This parameter is associated with the Profile - Snapshot task flow.

profileLaunchedOnSelection

A means of launching a user Profile when the user name is clicked

Enter true to launch a user Profile when the user name is clicked. Enter false to prevent launching a user Profile

This parameter is associated with the task flow Connections - Card

profileOnly

A means of streaming activities only from user profiles

  • Enter true to stream only those activities associated with user profiles.

  • Enter false to stream other types of activities along with those associated with user profiles.

This parameter is associated with the Activity Stream task flow.

profileUserId

ID of the user from whom to stream activity

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

resourceId

The current user ID

Enter #{securityContext.userName} to return the current user.

This parameter is associated with the following task flows:

  • Activity Stream

  • Connections

  • Feedback

  • Message Board

  • Profile

  • Profile Gallery

scopeId

The ID of the scope to which to publish

This property value assists in generating a link for use in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. For information about EL expressions, seeAppendix G, "Expression Language Expressions."

This parameter is associated with the Publisher task flow.

sectionWiseEditEnabled

A means of enabling or disabling section-by-section edit capability on the task flow

  • Enter #{true} to enable section-by-section editing. An Edit control is shown on each editable Profile section.

  • Enter #{false} to disable section-by-section editing.

This parameter is associated with the Profile task flow.

serviceCategories

A field for entering a comma-separated list of names of services from which to stream activities

Use this parameter to limit the display of streamed activities to only those associated with the specified service or services. Enter one or more service IDs, for example:

oracle.webcenter.collab.announcement, oracle.webcenter.collab.forum

For a list of valid service ID, see Table G-7, "Service IDs". Note that all listed service IDs cannot be used because all services do not stream items to the Activity Stream. For example, the RSS service does not stream any activities.

This parameter is associated with the Activity Stream task flow.

serviceId

The service ID of the service to which the object associated with a published message belongs

For a list of service IDs, see Table G-7, "Service IDs".

This parameter is associated with the Publisher task flow.

spaceName

The space to which to publish messages

If your application does not support spaces, do not provide a value for this parameter.

This parameter is associated with the following task flows:

  • Message Board

  • Message Board - Quick View

  • Publisher

spaces

A comma-separated list of names or GUIDs of spaces from which to stream activities

Use this parameter to limit the display of streamed activities to only those associated with the specified space or spaces.

If your application does not support spaces, do not provide a value for this parameter.

This parameter is associated with the Activity Stream task flow.

statusUpdateAllowed

A boolean value representing whether a control is available on the task flow for updating a profile status message

Enter either true or false.

This parameter appears in the component properties for the Profile - Snapshot task flow.

toDate

The end date of a date range within which to show feedback messages

Enter dates in the format YYYY-MM-DD.

See also fromDate.

This parameter is associated with the following task flows:

  • Feedback

  • Feedback - Quick View

  • Message Board

uploadDocumentOnly

A means of limiting the Publisher task flow to its document upload feature

Enter #{true} to limit the Publisher task flow to be only a document uploader. Enter #{false} to expose all Publisher features.

This parameter is associated with the Publisher task flow.

userId

The current user ID

Enter #{securityContext.userName} to return the current user.

This parameter is associated with the following task flows:

  • Connections - Card

  • Connections - Quick View

  • Feedback - Quick View

  • Message Board - Quick View

  • Profile - Snapshot

userName

The name of the user to whom to publish messages

This value is supplied by default. We recommend that you do not change the default value, #{o_w_w_i_v_b_resourceViewerBean.username}.

This parameter is associated with the Publisher task flow.

viaUser

The user name of the person who provided the object the current user is sharing

For example, John is sharing a document with everyone that Jane originally shared with him. In this case, Jane is the via user.

This parameter is associated with the Publisher task flow.


40.3 What You Should Know About the Activity Stream Advanced Query Option

Use Advanced Query to create filters against streamed activities in an Activity Stream task flow. Create filters for user names, service IDs, and object details, such as a document's display name. You can use SQL syntax for parameter values. Additionally you can place EL expressions within the SQL.

You can construct queries against specific database objects, which are represented by aliases that are prefixed to the inquiry. Table 40-2 lists and describes the types of database objects against which you can construct a query and provides their alias prefixes.

See Also:

In many cases, you can use EL expressions to obtain the value you require for the supported fields and columns listed in Table 40-2. For more information, see Appendix G, "Expression Language Expressions."

Table 40-2 Supported Database Objects for Constructing a SQL WHERE Clause

Database Object Alias Prefix Supported Fields/Columns

ACTIVITY

AE

  • SCOPE_ID—The GUID of the scope (you can use an EL to return this value, for example, #{serviceCtx.scope.GUID}).

  • SERVICE_ID—The service ID of the service to track. See Table G-7 for a list of service IDs.

  • ACTIVITY_TIME—The time the activity occurs.

    Use the datetime format that is supported in the SQL or target database. You can also use Oracle database SQL constructs, such as to_date().

  • ACTIVITY_TYPE—The type of activity to track

    For a list of valid activity type names, see Table 40-3.

ACTIVITY (ACTOR)

AD

ACTOR_NAME—The user name of the person performing the activity.

ACTIVITY (OBJECT)

OD

  • SERVICE_ID—The service ID of the service from which the tracked object issues. See Table G-7 for a list of service IDs.

  • OBJECT_ID—The GUID of the object.

  • DISPLAY_NAME—The object display name.

  • OBJECT_TYPE—The object type.

    Object type names for use with Advanced Query include:

    • event

    • announcement

    • forum

    • topic

    • bookmark

    • list

    • page

    • blog

    • document

    • wiki


Table 40-3 Activity Type Names for Advanced Query

Service Activity Type Name

Events

  • createEvent

  • updateEvent

Announcements

  • createAnnouncement

  • updateAnnouncement

Discussions

  • createForum

  • createTopic

  • replyTopic

Tags

  • updateBookmark

Lists

  • createList

  • editList

Page

  • createPage

  • editPage

Documents

  • create-blog

  • update-blog

  • create-document

  • create-wiki

  • update-document

  • update-wiki

People Connections (Profile)

  • updateStatus

  • updateProfile

  • updatePhoto

People Connections (Message Board)

  • postScope

  • postself

  • post

  • sharescope

  • shareself

  • share

  • shareobjectscope

  • shareobjectself

  • shareobject

  • updatescope

  • updateself

  • update

People Connections (Connections)

  • connect

  • inviteForConnection

People Connections (Feedback)

  • post


The SQL string that is passed as the advanced query parameter complies with SQL standards. That is, it supports SQL constructs, such as AND, OR, IN, and the like. Note, however, that it does not support INSERT, UPDATE, DELETE, SELECT, JOIN constructs. The syntax of the advanced query must contain only the WHERE clause portion of a SQL query. Because SELECT is not supported, the WHERE clause cannot have nested queries or subqueries.

The Advanced Query parameter also supports EL expressions, which can be embedded in the WHERE clause or used to generate the whole WHERE clause.

All the literals in the query must be escaped by prepending a backward slash (\); otherwise, such characters generate syntax errors (see Table 40-4 for examples).

Note that the advanced query WHERE clause is always AND'ed to the internal query that is generated by Activity Stream based on the current user, space membership, connection list, and the like. This is to prevent a user from viewing activities to which he or she does not have access.

Table 40-4 lists examples of advanced queries.

Table 40-4 Examples of Advanced Queries for Use with Activity Stream

Use Case Query Syntax

Stream only document creation activities.

AE.SERVICE_ID = \'oracle.webcenter.doclib\'

Stream activities only from an object or current space.

OD.OBJECT_ID = \'objectA\' OR AE.SCOPE_ID = \'#{serviceCtx.scope.GUID}\'

Stream activities only about wikis created by the current user.

OD.OBJECT_TYPE = \'Wiki\' AND AD.ACTOR_NAME = \'#{securityContext.userName}\'

Stream activities for documents and discussions, but only create activities or all activities for the current user.

(AE.SERVICE_ID IN (\'oracle.webcenter.doclib\', \'oracle.webcenter.collab.forum\') AND AE.ACTIVITY_TYPE IN (\'createDocument\', \'createTopic\')) OR AD.ACTOR_NAME = \'#{securityContext.userName}\'