39 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 38.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:

Section 39.1, "How to Revise People Connections Task Flow Binding Parameters"
Section 39.2, "People Connections Task Flow Binding Parameters"
Section 39.3, "What You Should Know About the Activity Stream Advanced Query Option"

39.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:

Open the application page and set the view to bindings by clicking the Bindings tab at the bottom of the page.
Under Executables, double-click the task flow for which to revise task flow binding parameters (Figure 39-1) to open the Edit Task Flow Binding dialog (Figure 39-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 39-1 Bindings View of an Application Page

Description of "Figure 39-1 Bindings View of an Application Page"

Figure 39-2 Edit Task Flow Binding Dialog

Description of "Figure 39-2 Edit Task Flow Binding Dialog"
Revise binding parameter values (for more information, see Section 39.2, "People Connections Task Flow Binding Parameters").
Click OK to save your changes and exit the dialog.
Save and run your page to see the results.

39.2 People Connections Task Flow Binding Parameters

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

Table 39-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 39.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.
`enableContextInf`o	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.

39.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 39-2 lists and describes the types of database objects against which you can construct a query and provides their alias prefixes.

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 39-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`

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`

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}\'`