Adding an Activity Stream to a Portal

About the Activity Stream

In WebCenter Portal, Activity Stream provides a streaming view of the activities of users' connections, actions taken in portals, and business activities. For example, Activity Stream can note when a user posts feedback. Additionally, it streams messages and attachments entered through Publisher.

Note:

Activity Stream shows file upload activity that occurs through Publisher. Activity Stream does not show file activity that occurs through Content Manager. For example, if you or your connections edit, upload, download, check out, or check in a file through Content Manager, this activity does not appear in the Activity Stream.

Through Activity Stream Preferences, users can select to show connection and portal activities. (The system administrator can disable users from overriding application-level settings.)

In addition to streaming messages, your Activity Stream can provide access to file attachments and web links added through Publisher. File attachments are rendered as links, which you can use to access the file.

Users can share a streamed activity and its attachments using a Share feature, available on each streamed item.

See Also:

For information about using the Publisher task flow, see Liking, Commenting On, and Sharing Items in Using Portals in Oracle WebCenter Portal.

Table 41-1 lists and describes the types of activities that are reported through Activity Stream.

Note:

Delete activities do not appear per se in the Activity Stream. But references to objects, such as Joe Smith created the document file.xml, are removed from the stream when such objects are deleted.

Table 41-1 Activities Tracked by Activity Stream

Tool/Service	Tracked Activities	Scope	Activities Shared or Private
Blogs	Create blog Update blog	portal Home portal	Activities on portal blogs are shared with other portal members Activities on Home portal blogs are shared with the blogger's connections
Connections	Invite to connect Connection invite accepted	Home portal	Shared with inviter and invitee's connections
Documents	Upload document through Publisher; document activities performed through Content Manager do not appear in the Activity Stream.	portal Home portal	Activities on portal documents are shared with other portal members Activities on Home portal documents are private to user
Feedback	Leave feedback Receive feedback	Home portal	Shared with whomever is permitted to view such activities
Lists	Create list	portal	Shared with other portal members
Message Board	Leave message Receive message	Home portal	Shared with whomever is permitted to view such activities
Pages	Create page Edit page Add tag Remove tag	portal Home portal	Activities on portal pages are shared with other portal members Activities on Home portal pages are private to user
Profiles	Update photo Update profile Update personal status	Home portal	Shared with whomever is permitted to view such activities
Portal Events	Create event Edit event	portal	Shared with other portal members
Portals Management	Create portal Change portal membership Join portal Post comment Like item Update portal configuration Enable portal tool or service Disable portal tool or service Change custom portal attribute Change portal role permissions Change portal role assignment	portal	Shared with other portal members
Tagging	Add tag Remove tag	portal Home portal	Activities in a portal are shared with all portal members. Activities in a Home portal are shared with whomever is permitted to view such activities

Users can use Activity Stream Preferences to specify who can view their individual Activity Stream and the types of activities to show. For more information about Preferences relating to Activity Stream task flows, see Setting Activity Stream Preferences in Using Portals in Oracle WebCenter Portal.

In the page editor, use Activity Stream task flow properties to hide or show various controls on everyone's view of a task flow instance and to limit the types of objects and the specific portals that are tracked. For more information about Activity Stream task flow properties, see Working with Activity Stream Task Flow Properties.

WebCenter Portal provides the following Activity Stream viewers:

Activity Stream for viewing application activities and the activities of your connections and for providing access to the attachments added through the Share link.

Figure 41-1 Activity Stream Task Flow

Description of "Figure 41-1 Activity Stream Task Flow"

This full view of Activity Stream functionality includes options for liking and commenting on listed activities and for sharing different types of objects, such as images, URLs, documents, and the like. Activity Stream also provides a means of hiding the activities and posts of a given user. You can use Activity Stream Options to show those users you have hidden.

The Activities page in the Home portal combines an instance of the Publisher task flow with the Activity Stream task flow.

See Also:

For information about Publisher, see About Publisher..
Activity Stream - Quick View provides a summary view of application activities and the activities of your connections.

Figure 41-2 Activity Stream — Quick View

Description of "Figure 41-2 Activity Stream — Quick View"

Unlike the full view of Activity Stream, Activity Stream - Quick View does not display Like, comments, and Share links. The Activity Stream - Quick View also combines similar activities into one entry. For example, if a user posts two documents, users see one entry that lists both documents; if a user posts two messages, user's see one entry that says the user "posted messages," but only the most recent message is shown.

When there are more streamed items than the Quick View can show, a More link appears at the bottom of the stream. Click More to open a full view of the Activity Stream. In the rare case where you have both the full Activity Stream and the Quick View on the same page, clicking More changes the focus from the Quick View to the full view, and the Quick View is hidden.

A hierarchy of configuration settings control what users can do with their view of the Activity Stream. The system administrator sets application-wide in WebCenter Portal Administration on the Settings page. Users can set their own personal values through People Connections Preferences. You can also set values on a given viewer instance in both the page editor, which affects all users' views of the instance (application customization), and users can set values in page view mode, which affects only their view of the instance (user customization).

Tip:

If users adjust a setting through Preferences that does not seem to affect the behavior of a task flow as expected, it may be because settings on the task flow itself override Preferences settings.

The Activity Stream task flow provides an Options link for accessing configuration settings for a given task flow instance (Figure 41-3).

Figure 41-3 Options Link for Activity Stream Options

Description of "Figure 41-3 Options Link for Activity Stream Options"

The Activity Stream - Quick View task flow provides access to its own configuration settings through a pencil icon (Change the source, filter, and display options) (Figure 41-4).

Figure 41-4 Pencil Icon and Configure Dialog

Description of "Figure 41-4 Pencil Icon and Configure Dialog"

Use these controls to adjust an individual task flow instance with the same kinds of settings that are provided for all of views of Activity Stream through Activity Stream Preferences.

System administrators can archive streamed activities to relieve the burden on your storage and to maintain a record of past activities. For more information, see Activity Stream in WebCenter WLST Command Reference Reference.

Adding an Activity Stream Task Flow to a Page

For the steps to add an Activity Stream task flow to a page, see Adding a Component to a Page.

Tip:

The presence or location of the Activity Stream task flow in the resource catalog depends on how the resource catalog is configured. For example, in the default resource catalog, the Activity Stream task flow is included under the Alerts and Updates folder.

Working with Activity Stream Task Flow Properties

Activity Stream task flows have associated properties that users with sufficient privileges can access through the task flow's View Actions menu. For example, edit the page where the Activity Stream instance appears, click the instance, open the View Actions menu, and select Parameters to display the Parameters dialog (Figure 41-5).

Figure 41-5 Activity Stream Task Flow Component Properties

Description of "Figure 41-5 Activity Stream Task Flow Component Properties"

See Also:

Setting Properties on a Component

The following sections provide information about properties associated with Activity Stream task flows and describe the task flow parameters:

Setting Activity Stream Task Flow Properties

In the page editor, selecting any component exposes a View Actions menu (Figure 41-6), which provides access to the component’s properties: Parameters, Access, Display Options, Style, and Content Style.

Figure 41-6 View Actions Menu on an Activity Stream Task Flow

Description of "Figure 41-6 View Actions Menu on an Activity Stream Task Flow"

To set Activity Stream task flow properties:

Open the page that contains the task flow in the page editor (see Opening a Page in the Page Editor).
Select the task flow, then click the View Actions menu and select the properties you want to set:
- Parameters control the default task flow content. For descriptions of each parameter, see Activity Stream Task Flow Parameters. Parameters can be wired to events, and can be used to facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Wiring Pages and Components.
- Access settings show or hide the component to specific roles, users, or groups. For more information, see Setting Component Access.
- The Display Options, Style, and Content Style properties affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Modifying Component Properties.
The Parameters and Display Options dialogs 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 icon next to a property, then select Expression Builder to open the editor.

Note:

When you enter EL in the Display Options dialog, the parser reports an error only if it detects invalid syntax, such as a missing closing bracket. Validation is performed only on syntax, not on the expression value. Generic Display Options are those cataloged in Table 10-1.

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

If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal.
Save your changes.

Activity Stream Task Flow Parameters

Table 41-2 describes the parameters that are unique to Activity Stream task flows.

Table 41-2 Activity Stream Task Flow Parameters

Parameter	Description
`Advanced Query`	A field for specifying a custom query to filter streamed items. For more information, see Using an Advanced Query to Filter Activity Stream Items. This parameter is associated with the Activity Stream task flow.
`Enable Context Info`	A check box for specifying whether contextual information is shown when users click a Context Info icon. Description of the illustration wcsug_as_contextinfo.gif For example, if the item `John created the purchase order General Supplies` appears in the Activity Stream with a Context Info icon (the reddish dot), users who see the streamed item can click the icon to view the purchase order (PO) in a popup or navigate to the PO, depending on how the event is configured. This parameter is primarily for use where, unless otherwise handled (such as the Profile popup on a user name), resources are rendered within the Resource Viewer system page: Select the check box to enable context information (`#{true}`). Deselect the check box to prevent the display of context information (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Hide Comments`	A check box for specifying whether a comments link is shown on a task flow instance: Select the check box to show the comments link (`#{true}`). Deselect the check box to hide the comments link (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Hide Configuration Button`	A check box for specifying whether the Options link appears on the Activity Stream task flow or the pencil icon appears on Activity Stream - Quick View: Select the check box to show the configuration control (`#{true}`). Deselect the check box to hide the configuration control (`#{false}`). This parameter is associated with the following task flows: Activity Stream - Quick View Activity Stream
`Hide Inline Preview`	A check box for specifying whether to hide previews of streamed files: Select the check box to hide previews of streamed files (`#{true}`). Links to streamed files are provided but previews are omitted. Deselect the check box to show previews of streamed files (`#{false}`). Both links to and previews of streamed files are shown. For information about the mime types that are supported for file previewing in Activity Stream, see About the Activity Stream. This parameter is associated with the Activity Stream task flow.
`Hide Like`	A check box for specifying whether to hide the Like link on streamed items: Select the check box to hide the Like link (`#{true}`). Deselect the check box to show the Like link (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Hide Share`	A check box for specifying whether to hide the Share menu on streamed items: Select the check box to hide the Share menu (`#{true}`). Deselect the check box to show the Share menu (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Hide Portal Options`	Specifies whether to show the Portals options in the Activity Stream and Activity Stream - Quick View Configuration dialogs. The Portals options enable users to specify whether to show activities from all portals, the portals of which they are a member, no portals, or just the portal on which the task flow is placed. Select the check box to show the Portals options. This is the default (`#{true}`). Deselect the check box to hide the Portals options (`#{false}`). This parameter is associated with the following task flows: Activity Stream Activity Stream - Quick View
`No of activities to display per page`	A field for entering the number of streamed items to show per page This parameter is associated with the following task flows: Activity Stream Activity Stream - Quick View
`Pagination`	A check box for specifying whether to provide Previous and Next links to enable users to page through streamed activities: Select the check box to show Previous and Next links (`#{true}`). Deselect the check box to hide them (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Profile Only`	A check box for specifying whether to stream activities only from user profiles: Select the check box to stream only those activities associated with the current user (`#{true}`). Deselect the check box to stream the activities of other users along with those associated with the current user (`#{false}`). This parameter is associated with the Activity Stream task flow.
`Resource Id`	A field for entering the ID of the current user. This value is provided by default, `#{securityContext.userName}`. Users should not change this value when the task flow instance appears in the context of a portal. You can use it in the Home portal to view the activities of a named user. This parameter is associated with the Activity Stream task flow.
`Service Categories`	A field for entering the IDs of components from which to stream activities. Use this parameter to limit the display of streamed activities to only those associated with the specified component or components. Enter the category ID or the service ID. For a list of service IDs, see Service IDs in Developing for Oracle WebCenter Portal. This parameter is associated with the Activity Stream task flow.
`Portals`	A field for entering the names of portals from which to stream activities. Use this parameter to limit the display of streamed activities to only those associated with the specified portal or portals. Enter the GUID of the portal or the portal's internal name. The portal internal name is the name specified by the Portal URL on the General page of a portal's administration settings. Note that the activities that are streamed in an Activity Stream task flow that is scoped to a particular portal are visible to all members of that portal, regardless of whether they are formally connected to each other. This parameter is associated with the Activity Stream task flow.

Using an Advanced Query to Filter Activity Stream Items

The Activity Stream task flow provides an Advanced Query parameter for creating custom filters against streamed activities using a SQL WHERE clause. For example, using SQL you can set up an Activity Stream instance to show only those activities relating to the page or streaming from the current user or a named user.

This section provides an overview of the Activity Stream Advanced Query option and steps you through the process of entering an advanced query. It includes the following subsections:

About the Activity Stream Advanced Query Option

Use Advanced Query to create filters against 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 41-3 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 41-3.

If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal.

Table 41-3 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 (e.g., `#{serviceCtx.scope.GUID}`). `SERVICE_ID`—The service ID of the component to track. For a list of service IDs, see the Service IDs table in Developing for Oracle WebCenter Portal. `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 41-4.
ACTIVITY (ACTOR)	AD	`ACTOR_NAME`—The user name of the person performing the activity.
ACTIVITY (OBJECT)	OD	`SERVICE_ID`—The service ID of the component from which the tracked object issues. For a list of service IDs, see the Service IDs table in Developing for Oracle WebCenter Portal. `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` `forum` `topic` `bookmark` `list` `page` `blog` `document` `wiki`

Table 41-4 provides a list of valid activity type names for the ACTIVITY database object described in Table 41-3.

Table 41-4 Activity Type Names for Advanced Query

Tool/Service	Activity Type Name
Events	`createEvent` `updateEvent`
Tags	`updateBookmark`
Lists	`createList` `editList`
Page	`createPage` `editPage`
Documents Note: Document activities in 12c (12.2.1) are not streamed, with the exception of documents uploaded through Publisher. Integration with Documents will return in a later release.	`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. If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal.

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

Note that the advanced query WHERE clause is always ANDed to the internal query that is generated by Activity Stream based on the current user, portal 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 41-5 lists examples of advanced queries.

Table 41-5 Examples of Advanced Queries for Use with Activity Stream

Use Case	Query Syntax
Stream only discussion activities.	`AE.SERVICE_ID = \'oracle.webcenter.collab.forum\'`
Stream activities only from an object or current portal.	`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 discussions, but only create activities or all activities for the current user.	`(AE.SERVICE_ID IN (\'oracle.webcenter.collab.forum\') AND AE.ACTIVITY_TYPE IN (\'createTopic\')) OR AD.ACTOR_NAME = \'#{securityContext.userName}\'`

Entering an Advanced Query Against an Activity Stream Task Flow Instance

To enter an advanced query against an instance of the Activity Stream task flow:

Edit the page where the Activity Stream appears.
Click the Activity Stream you want to change, and select Parameters from its View Actions menu.

See Also:

Setting Properties on a Component
In the Parameters dialog, provide a value for the property Advanced Query.

See Also:

See About the Activity Stream Advanced Query Option, for information about the type and format of values you can enter in this field.
When you finish revising parameters, click OK.
Save your changes, and exit the page editor.

Going forward, streamed activities are filtered by your query.

Using Properties to Configure an Activity Stream Task Flow Instance

This section provides examples of how you use property values to affect the behavior of a given task flow instance. It includes the following subsections:

Preventing Users from Customizing an Activity Stream

By default, Activity Stream task flows provide user customization controls that enable users to specify whose actions they want to see and from what services and portals in a given Activity Stream. On the Activity Stream task flow, this is the Options link. On the Activity Stream - Quick View task flow, this is the pencil icon.

The Hide Configuration Button property is available when you want to prevent users from overriding application-level customizations with their own user-level customizations.

To prevent users from customizing an Activity Stream task flow instance:

Edit the page, and click the Activity Stream instance.
Click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Hide Configuration Button.

Note:

To show the Options link or pencil icon, deselect Hide Configuration Button.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Preventing Users from Commenting on Streamed Items

By default, a comments link is shown with all items in an Activity Stream task flow to enable users to comment on a given item (Figure 41-7).

Figure 41-7 Comments Link on a Streamed Item

Description of "Figure 41-7 Comments Link on a Streamed Item"

You can use the Hide Comments property to suppress the display of the Comment link and, consequently, prevent users from commenting on streamed items in a given task flow instance.

To prevent users from commenting on streamed items:

In the Activity Stream task flow instance toolbar, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Hide Comments.

Note:

To show the Comment link on streamed items, deselect Hide Comments.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Preventing Users from Liking Streamed Items

By default, a Like link is shown with all items in an Activity Stream task flow to enable users to express a favorable opinion of a given item (Figure 41-8).

Figure 41-8 Like Link on a Streamed Item

Description of "Figure 41-8 Like Link on a Streamed Item"

Once clicked, the Like link switches to an Unlike link to enable users to undo their favorable opinion.

You can use the Hide Like property to suppress the display of the Like link, and, consequently, prevent users from liking streamed items in a given task flow instance.

To prevent users from liking streamed items:

In the Activity Stream task flow instance toolbar, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Hide Like.

Note:

To show the Like link on streamed items, deselect Hide Like.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Preventing Users from Sharing Streamed Items

By default, a Share menu is shown with all items in an Activity Stream task flow to enable users to share a streamed item with their connections (Figure 41-9).

Figure 41-9 Share Menu on a Streamed Item

Description of "Figure 41-9 Share Menu on a Streamed Item"

You can use the Hide Share property to suppress the display of the Share menu, and, consequently prevent users from sharing streamed items from a given task flow instance.

To prevent users from sharing streamed items:

In the Activity Stream task flow instance toolbar, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Hide Share.

Note:

To show the Share option on streamed items, deselect Hide Share.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Hiding Portal Options in Activity Stream Task Flows

By default, users see portal options on the Settings tab of the Activity Stream and Activity Stream - Quick View Options dialogs (Figure 41-10). Portal options enable users to specify whether to show activities from all portals, the portals they are a member of, no portals, or just the portal where the task flow is placed.

Figure 41-10 Portal Options on Settings Page of Activity Stream Options Dialog

Description of "Figure 41-10 Portal Options on Settings Page of Activity Stream Options Dialog"

You can use the Hide portal Options parameter to suppress the display of the Portals section on the Settings page of the Activity Stream task flow Options dialogs.

To hide the Portals options:

Click the Activity Stream task flow instance to show the View Actions menu.

See Also:

Setting Properties on a Component
From the menu, select Parameters.
In the Parameters dialog, select Hide Portals Options.

Note:

To show the Portals options, deselect Hide Portals Options.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Limiting the Stream to Activities from One or More Portals

Configuration options in both the Activity Stream and Activity Stream - Quick View task flows provide all-or-none options for streaming activities from portals (see Tracking Portal Activities in Using Portals in Oracle WebCenter Portal).

The Portals property associated with the Activity Stream task flow provides the additional dimension of selecting specific portals from which to stream activities.

To limit the stream to activities from one or more portals:

In the Activity Stream task flow instance toolbar, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, in the Portals field, enter a comma-separated list of the portal names or portal GUIDs from which to stream activities in this task flow instance.

Tip:

Enter the portal internal name. The portal internal ID is specified on the Overview page of a portal's administration settings.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Limiting the Stream to One or More Services

Configuration options for both the Activity Stream and Activity Stream - Quick View task flows provide a way to select the service categories from which to stream activities (see Tracking Portal Activities in Using Portals in Oracle WebCenter Portal).

The Service Categoriesproperty associated with the Activity Stream task flow extends this capability by enabling you to enforce a particular selection. For example, you can specify the service category lists, and only those connections' activities that stream from lists are shown in the task flow instance.

To limit streamed activities to one or more services:

Edit the page, and click the Activity Stream instance.
Click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, in the Service Categories field, enter a comma-separated list of the services from which to stream activities in this instance.

Tip:

Enter the service category ID or the service ID. For a list of valid service IDs, see the Service IDs table in Developing for Oracle WebCenter Portal.
When you finish revising component properties, click OK.
Save your changes, and exit the page editor.

Limiting the Stream to Your Own Activities

You can use the Profile Only property associated with the Activity Stream task flow to limit the display of streamed activities to just the user's own activities.

To limit streamed activities to just the user's own activities:

Edit the page, and click the Activity Stream instance.
Click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Profile Only.

Note:

To show a user's own activities and those of their connections, deselect Profile Only.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Working with Activity Stream Task Flows

For information about how users work with Activity Stream task flows, see Tracking Portal Activities in Using Portals in Oracle WebCenter Portal.

About Publisher

The Publisher task flow is available for publishing messages, files, and URLs to the Activity Streams of all of your connections or to those connections who have access to a specified portal.

See Also:

For information about parameters associated with the Publisher task flow, see Working with Publisher Task Flow Properties.

Things you should know about the Publisher task flow:

You can use it to send out messages, but not to receive them. It provides no feature for viewing messages.
It is specifically made to work in conjunction with Activity Stream, where the messages you enter are published.
It has its own distinct set of properties (see Working with Publisher Task Flow Properties).
It is not controlled by configuration settings at the application level nor through a user's personal Preferences. Users specify who sees their published messages through a control on the task flow itself. You can also exercise some control over the message destination through task flow properties. For example, the Publisher task flow has an associated property, Is Update Status, that shows the last published message as the user's Profile status message.

See Also:

Adding Profiles to a Portal

There is one Publisher task flow, but, depending on how you set the properties, it can show options for sharing messages, files, or links (Figure 41-11) or just show options for sharing documents (Figure 41-12).

Figure 41-11 Publisher Task Flow

Description of "Figure 41-11 Publisher Task Flow"

Figure 41-12 Publisher Task Flow with Upload Document Only Option

Description of "Figure 41-12 Publisher Task Flow with Upload Document Only Option"

In default WebCenter Portal installations, the Publisher task flow is placed on the Activities business role page provided in the Home portal for all authenticated users (that is, users who are logged in).

The default Activities business role page also contains an Activity Stream task flow where the messages you enter through the Publisher are published.

See Also:

Managing Business Role Pages in Administering Oracle WebCenter Portal

Adding a Publisher Task Flow to a Page

For the steps to add a Publisher task flow to a page, see Adding a Component to a Page.

Tip:

The presence or location of the Publisher task flow in the resource catalog depends on how the resource catalog is configured. For example, in the default resource catalog, the Publisher task flow is included under the Social and Communication folder.

Working with Publisher Task Flow Properties

The Publisher task flow has associated properties that users with sufficient privileges can access through the task flow's View Actions menu. For example, edit the page where the task flow instance appears, click the task flow, open the View Actions menu, and select Parameters to display the Parameters dialog (Figure 41-13).

Figure 41-13 Publisher Parameters Dialog

Description of "Figure 41-13 Publisher Parameters Dialog"

See Also:

Setting Properties on a Component

The following sections provide information about properties associated with the Publisher task flow and describe the task flow parameters:

Setting Publisher Task Flow Properties

In the page editor, selecting any component exposes a View Actions menu (Figure 41-14), which provides access to the component’s properties: Parameters, Access, Display Options, Style, and Content Style.

Figure 41-14 View Actions Menu on a Publisher Task Flow

Description of "Figure 41-14 View Actions Menu on a Publisher Task Flow"

To set Publisher task flow properties:

Open the page that contains the task flow in the page editor (see Opening a Page in the Page Editor).
Select the task flow, then click the View Actions menu and select the properties you want to set:
- Parameters control the default task flow content. For descriptions of each parameter, see Publisher Task Flow Parameters. Parameters can be wired to events, and can be used facilitate the wiring of the task flow to page parameters and page definition variables. For more information, see Wiring Pages and Components.
- Access settings show or hide the component to specific roles, users, or groups. For more information, see Setting Component Access.
- The Display Options, Style, and Content Style properties affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Modifying Component Properties.
The Parameters and Display Options dialogs 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 icon next to a property, then select Expression Builder to open the editor.

Note:

When you enter EL in the Display Options dialog, the parser reports an error only if it detects invalid syntax, such as a missing closing bracket. Validation is performed only on syntax, not on the expression value. Generic Display Options are those cataloged in Table 10-1.

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

If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal.
Save your changes.

Publisher Task Flow Parameters

Table 41-6 describes the parameters that are unique to the Publisher task flow.

Table 41-6 Publisher Task Flow Parameters

Parameter	Description
`Hide Attach Links`	Specifies whether the Attach: File \| Link option is shown or hidden Select to hide the Attach: File \| Link option. Deselect to show the Attach: File \| Link option. The Attach: File \| Link option is shown by default.
`Hide Document Uploader`	Specifies whether the File link is available on the task flow for uploading a document Select to hide the File link. Deselect to show the File link. The File link will show only if the Attach: File \| Link option is shown. The File link is shown by default. Note: Do not select this option if the `Upload Document Only` option is selected. If you select both options, Publisher displays no controls.
`Hide Sharing Picker`	Specifies whether the Share with menu is shown or hidden Select to hide the Share with menu. Deselect to show the Share with menu. The Share with menu is shown by default.
`Message key of hints text`	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.
`Is Update Status`	Indicates whether the message entered in the task flow instance should also be published as the user's Profile status message Select to publish the message as the user's Profile status message and in the selected recipients' Activity Streams. Deselect to publish the message only in the selected recipients' Activity Streams. If you attach a file or URL to a published message, then the message is not used as a Profile status message, even if `Is Update Status` is selected. For information about Profiles, see Adding Profiles to a Portal.
`Keep open the Publisher after publish`	Specifies whether Publisher remains open after a user clicks the Publish button Select to keep the text box open after a message is published. Deselect to close the Publisher controls after a message is published. Publisher remains open after a message is published by default.
`Object Id`	The ID of the object to be shared This property assists in generating a link used in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal
`Object Type`	The type of object to be shared This property assists in generating a link used in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal
`Scope Id`	The ID of the scope to which to publish This property assists in generating a link used in navigating to the published object. It is not necessary to provide a value, unless you plan to do so using an EL expression. If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal
`Service Id`	The service ID of the service to which the shared object belongs This property assists in generating a link used in navigating to the published object. It is not necessary to provide a value, unless you plan to do so by entering a specific service ID or using an EL expression. For a list of valid service IDs, see ELs Related to Tools and Services in Developing for Oracle WebCenter Portal. If you need EL assistance, an application developer can provide an EL expression; see Expression Language Expressions in Developing for Oracle WebCenter Portal
`Space Name`	The name of the portal in which to publish the messages entered in this task flow instance Enter the portal internal name and not the portal display name. The portal internal name is the name specified by the portal URL on the General page of a portal's administration settings. The portal display name is specified by Display Name, and is the name that appears in the portal banner at the top of the portal.
`Upload Document Only`	Specifies that Publisher shows only the document upload feature, hiding the text entry area and the Attach: Link option (Figure 41-12) Select to show only the document upload feature and hide the text entry area and the Attach: Link option. Deselect to show the text entry area and the Attach: File \| Link option. This option is not enabled by default. Note: If you select this option, make sure the `Hide Document Uploader` is not selected. If you select both options, Publisher displays no controls.
`User Name`	The name of the user who owns the current view This value is supplied by default. We recommend that you not change the default value, `#{o_w_w_i_v_b_resourceViewerBean.username}`.
`Via User`	The user name of the person who provided the object the current user is sharing For example, if John is shares a document with everyone that Jane originally shared with him, Jane is the "via" user.

Blocking File Uploads Through a Publisher Task Flow Instance

You can use the Hide Document Uploader property to hide the Attach: File option on a Publisher task flow instance. Users will be unable to share files—though they will still be able to share links.

To block file uploads through a Publisher task flow instance:

In the Publisher task flow instance, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Hide Document Uploader.

Note:

To show the Attach: File option, deselect Hide Document Uploader.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Limiting the Scope of Recipients

You can use the Space Name property to limit the scope of recipients of published messages to a user's connections in a particular portal. When you do this, the message is streamed only to your and your connections' views of the Activity Stream in the named portal.

To limit the scope of recipients to a particular portal:

Edit the page, and click the Publisher instance.
Click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, enter the internal name of the portal in the Portal Name field.

Tip:

The portal internal name is the name specified by the portal URL on the General page of a portal's administration settings. The portal display name is specified by Display Name, and is the name that appears in the portal banner at the top of the portal.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

Messages posted through that Publisher task flow instance will be shared with only those connections who have access to the named portal.

Using the Publisher as a Profile Status Updater

You can use the Publisher parameter Is Update Status to specify that all messages without attachments are published not only to specified recipients, but also as the user's profile status message (Figure 41-15).

Figure 41-15 Published Message Used as Profile Status

Description of "Figure 41-15 Published Message Used as Profile Status"

Messages that have an attached file or link are not published as a profile status message.

To specify that messages are also published as profile status messages:

Edit the page where the Publisher task flow is placed.
Click the Publisher task flow to show the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Is Update Status and click OK.
Save your changes, and exit the page editor.

Messages that do not include attachments that are posted through that Publisher task flow instance are also shared as the user's personal Profile status message.

Using the Publisher as a File Uploader

You can use the Upload Document Only property to limit the functionality of the Publisher task flow to a file uploader (Figure 41-16).

Figure 41-16 Publisher Task Flow as Document Uploader

Description of "Figure 41-16 Publisher Task Flow as Document Uploader"

Files uploaded through the Publisher task flow are placed in the Public folder in the document library of the selected scope. That is:

In the Home portal:
- Select Everyone to publish the file to the Public folder in each of your connections' personal Document Library.
- Select a named portal to publish the file to the Public folder in the selected portal's Document Library.
In a portal, the file is published to the Public folder in the portal's Document Library.

To use the Publisher task flow as a file uploader:

In the Activity Stream task flow instance, click the View Actions menu, and select Parameters.

See Also:

Setting Properties on a Component
In the Parameters dialog, select Upload Document Only.

Note:

To show the message and link controls, deselect Upload Document Only.
When you finish revising component parameters, click OK.
Save your changes, and exit the page editor.

The Publisher task flow instance renders as a file uploader (see Figure 41-16). The text area and the Share link icon are not rendered.

Working with the Publisher Task Flow

For information about how users work with the Publisher task flows, see Liking, Commenting On, and Sharing Items in WebCenter Portal in Using Portals in Oracle WebCenter Portal.