Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter
11g Release 1 (11.1.1)
E10149-02
  Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
 
Next
Next
 

14 Working with the Discussions Service

This chapter describes how to use the features provided through the Discussions service. The Discussions service provides a means of creating and participating in text-based discussions with other members of a group space. Use Discussions service task flows to create forums, post questions, and search for answers. Discussion forums additionally provide the means to preserve and revisit discussions.

This chapter includes the following sections:

Audience

This chapter is intended for WebCenter Spaces users interested in viewing, creating, and managing discussions. Much of this information also applies to custom WebCenter applications, though it is written with WebCenter Spaces users in mind. (For information about custom WebCenter applications, see "Integrating the Discussions Service" in Oracle Fusion Middleware Developer's Guide for Oracle WebCenter.)

Your application administrator has the authority to expose or hide task flows from a particular service. Tasks discussed in this chapter are not available to you if the relevant service is hidden.

14.1 What You Should Know About the Discussions Service

You can use the Discussions service to post, respond to, and preserve topical information in discussion forums scoped to group spaces or to entire applications. Users post topics to a discussion forum (Figure 14-1), and other users post information relevant to those topics (Figure 14-2). All of this information is preserved within the forum.

Figure 14-1 Discussion Forum Topics List

Discussion forum topic

Figure 14-2 Posted Topic and Replies

Posted topic and replies

The back-end server that provides the Discussion service manages content in a hierarchy. At the top of the hierarchy are categories, below that are forums, and then topics. Where categories are exposed in your WebCenter application, authorized users can create multiple forums within a given scope and multiple topics under those forums. Where categories are not exposed, authorized users can create multiple topics under one forum within a given scope.

Your WebCenter administrator controls whether users can create multiple forums or multiple topics under a single, provided forum.

In WebCenter Spaces, the Discussions service is scoped to group spaces. That is, you can create forums and topics only within the context of a group space. You can view and participate in discussions in both group spaces and personal spaces, depending on your application permissions.

Access to discussions is influenced by application security. The WebCenter Spaces application is, by default, a secure application. Users can access discussions according to the permissions they are granted by their specific user roles within a given group space.

Scoping additionally limits the users who can view and participate in discussions. For example, only members of the Finance group space can view discussions that transpire in Finance group space forums.

To expose a discussion forum to a specific set of users, you must add just those users as members of the group space where you hold the forum (for more information, see Section 10.12.2, "Granting WebCenter Spaces Users Access to a Group Space"). To open a discussion to all users, you must create a publicly-accessible group space (for more information, see Section 10.12.3, "Granting Public Access to a Group Space").

Most Discussions service task flows provide configuration settings for specifying which forum content to show. This is of particular use in personal spaces, which exist outside a specific group space scope (for more information, see Section 14.3, "Setting Discussions Service Task Flow Properties").

The Discussions service provides a wide variety of task flows for viewing and participating in discussions. These include:


Note:

All instances of the Mail task flow in an application run against the same mail server and it serves no purpose to add multiple Mail task flow instances. This is true for all service task flows that require connections to back-end servers, for example, task flows from Announcements, Mail, and IMP services.

The Discussions service is tightly integrated with other WebCenter services, such as Links and Mail. For example, all mail sent to a group space distribution list can additionally be posted to that group space's default discussion forum. The group space moderator must select Monitor Incoming Mail in the group space settings for the Discussions service (see Section 11.3.4, "Publishing Group Space Mail in a Discussion Forum"). Every discussion topic provides the opportunity to link from the topic to another group space item, such as a document or an announcement. (For information about the Mail service, see Chapter 20, "Working with the Mail Service." For information about the Links service, see Chapter 18, "Working with the Links Service.")

14.2 Working with Discussions Service Task Flows

The Discussions service task flows expose all of the functionality available from the Discussions service. The Discussion Forum Manager is the most feature-rich task flow, providing controls for creating and managing discussion forums and posting and managing discussion topics and replies. The other task flows are useful windows into discussion forum content. They provide different views of the discussion forums and topics available to a particular group space or all group spaces.


Note:

For information about configuring a Discussions service task flow to display the discussions from a particular group space or from all group spaces, see Section 14.3, "Setting Discussions Service Task Flow Properties."

Most of the subsections in this section describe tasks you can accomplish through the Discussion Forum Manager task flow. When you can use other task flows to perform the described actions, this is noted.

This section contains the following subsections:

14.2.1 Creating a Discussion Forum

Create discussion forums on the Discussions page or with the Discussion Forum Manager task flow.

To create forums in WebCenter Spaces, you must be the group space moderator.


Note:

Whether you can create multiple forums or topics under a single forum depends on what the application administrator specified on the template used to create the scope or on the Discussions service connection. For more information, see Section 14.1, "What You Should Know About the Discussions Service."

To create a discussion forum:

  1. Log in, and go to the Discussion Forum Manager task flow in which to create a discussion forum.

  2. Click the Create Forum button (Figure 14-16).

    Figure 14-16 Create Forum Button

    Create Forum button

    The Create Forum dialog opens (Figure 14-17).

    Figure 14-17 The Create Forum Dialog

    Create Forum dialog box
  3. In the Forum Name field, enter a name for the discussion forum.

    Enter up to 255 characters.

  4. Optionally, in the Forum Description text box, enter a description of the discussion forum.

    Enter up to 4000 characters.

  5. Click OK.

    The new forum appears on the list of forums (Figure 14-18). Click a forum name to view forum content.

    Figure 14-18 New Discussion Forum (Picture This)

    New discussion forum (Picture This)

14.2.2 Editing the Forum Name and Description

To rename a discussion forum or revise its description:

  1. Log in, and go to the Discussion Forum Manager task flow in which to rename a discussion forum or revise its description.

  2. Click the Edit Forum link (Figure 14-19).

    Figure 14-19 Edit Forum Link

    Edit Forum button

    The Edit Forum dialog opens (Figure 14-20).

    Figure 14-20 The Edit Forum Dialog

    Edit Forum dialog box
  3. Optionally, in the Forum Name field enter a new name for the discussion forum.

    Enter up to 255 characters.

  4. Optionally, in the Forum Description text box, revise the description of the discussion forum.

    Enter up to 4000 characters.

  5. Click OK.

14.2.3 Creating and Managing Forum Topics and Replies

The life of a discussion forum takes place in its topics and replies. There users can ask questions, post information, exchange ideas, and otherwise communicate in interesting and useful ways.

This section describes how to work with discussion forum topics and replies. It contains the following subsections:

14.2.3.1 Posting a New Forum Topic

When you consider discussion forums hierarchically, the forum is the top container and forum topics are the next level down. Each posted topic additionally has subordinate replies, and the replies themselves may have replies (Figure 14-21).

Figure 14-21 A Posted Topic, a Reply, and a Reply to the Reply

Posted topic and replies

This section describes how to post forum topics using the Discussion Forum Manager task flow. For information about replying to a posted topic, see Section 14.2.3.2, "Replying to Topic Posts."

To post a topic under a discussion forum:

  1. Log in, and go to the Discussion Forum Manager task flow in which to post a topic.

  2. Click the forum under which to post a topic (Figure 14-22).

    Figure 14-22 List of Discussion Forums in a Discussion Forum Manager Task Flow

    List of discussion forums in Discussion Forum Manager
  3. On the resulting screen, click the Create Topic button (Figure 14-23).

    Figure 14-23 Create Topic Button

    Create Topic button

    The Create Topic dialog opens (Figure 14-24).

    Figure 14-24 The Create Topic Dialog

    Create Topic dialog box
  4. In the Subject field, enter the topic subject.

    Enter up to 255 characters.

  5. In the Message field, enter your post about the topic.

    Enter up to 4000 characters.

  6. Click Create.

    The newly-posted topic appears under the selected forum in the Discussion Forum Manager (Figure 14-25).

    Figure 14-25 A New Discussion Forum Topic

    New discussion forum topic

14.2.3.2 Replying to Topic Posts

This section describes how to reply to topic posts through the Discussion Forum Manager, though you can reply to a topic post through any other Discussions service task flow.

By default, the Discussion Forum Manager task flow is exposed as the Discussions page in group spaces.

To reply to topic posts:

  1. Log in, and go to the Discussion Forum Manager task flow in which to read and reply to topic posts.

  2. Click the forum that contains the topic to which to reply (Figure 14-26).

    Figure 14-26 List of Discussion Forums in a Discussion Forum Manager Task Flow

    List of discussion forums in Discussion Forum Manager
  3. On the resulting page, click the relevant topic (Figure 14-27).

    Figure 14-27 Discussion Forum Topic

    Discussion forum topic

    The selected topic opens.

  4. Click the Reply Topic button (Figure 14-28).

    Figure 14-28 Reply Topic Button

    Reply Topic button

    The Reply Topic dialog opens (Figure 14-29).

    Figure 14-29 The Reply Topic Dialog

    Reply Topic dialog box
  5. In the Subject field, either leave the text as is or revise it.

    Enter up to 255 characters.

  6. In the Message text box, enter your reply to the topic.

    Enter up to 4000 characters.

  7. Click Reply.

    Your reply appears below the main topic post (Figure 14-30).

    Figure 14-30 A Topic Post and a Reply

    Viewing a recent topic

To post a reply to a reply, click the Reply to message icon (Figure 14-31) and follow the steps described in this section (starting with step 5).

Figure 14-31 Reply to message Icon

Reply to message icon

14.2.3.3 Viewing Topic Posts and Replies

All discussion forum topics link to a screen that displays all of the replies posted to the topic. This is true for all Discussion service task flows. The amount of navigation required depends on which task flow you are using. For example, in both the Forums and Discussion Forum Manager task flows, first you select a forum (1), then a topic (2), then you view topic posts (3).

Figure 14-32 Accessing Topic Replies in the Discussion Forum Manager

Accessing topic replies

To navigate back up the forum hierarchy, click the breadcrumbs that display above the topic reply area (Figure 14-33).

Figure 14-33 Forum Breadcrumbs

Forum breadcrumbs

With all the other Discussions service task flows, topics are listed up front, and viewing topic posts is a simple matter of clicking the relevant topic (Figure 14-34).

Figure 14-34 Forum Topics in the Recent Topics Task Flow

Topics in the Recent Topics

The topic content displays on a new screen (Figure 14-35).

Figure 14-35 Viewing a Recent Topic

Viewing a recent topic

To return to the task flow main view, click your browser Back button.

14.2.3.4 Editing Topics and Replies

Once you post a topic or a reply, you retain the option of returning to it and revising its content. Only you and group space moderators can edit your replies. This section describes how.

To edit a topic or a reply:

  1. Log in, and go the Discussion Forum Manager task flow that displays the topic or reply you want to edit.

  2. Click the forum that contains the topic or reply you want to edit (Figure 14-36).

    Figure 14-36 List of Discussion Forums in a Discussion Forum Manager Task Flow

    List of discussion forums in Discussion Forum Manager
  3. On the resulting page, click the relevant topic (Figure 14-37).

    Figure 14-37 Discussion Forum Topic

    Discussion forum topic

    The selected topic opens.

  4. Your next step depends on whether you want to edit a topic or a reply:

    • To edit the topic, click the Edit Topic link at the top of the topic screen (Figure 14-38).

      Figure 14-38 Edit Topic Link

      Edit Topic link
    • To edit a reply, click the Edit message icon associated with the reply (Figure 14-39).

      Figure 14-39 Edit message Icon

      Edit message icon on a reply

    The Edit Topic (or Edit Message) dialog opens (Figure 14-40).

    Figure 14-40 The Edit Topic Dialog

    Edit Topic dialog box
  5. Revise the topic (up to 255 characters) or reply (up to 4000 characters).

  6. Click Edit in the Edit Topic dialog, or click Reply in the Edit Reply dialog.

    Your changes are posted to the forum.

14.2.3.5 Deleting Topic Posts and Replies

When you delete a topic, the original topic post and all of its subordinate replies are deleted. When you delete a reply, the original reply and all of its subordinate replies are deleted. Both actions involve very similar steps, which are described in this section.


Note:

To delete a topic post or reply, you must have created it or you must have access equivalent to group space moderator.

To delete a topic or a reply:

  1. Log in, and go to the Discussion Forum Manager task flow that displays the topic or reply you want to delete.

  2. Click the forum that contains the topic or reply you want to delete (Figure 14-41).

    Figure 14-41 List of Discussion Forums in a Discussion Forum Manager Task Flow

    List of discussion forums in Discussion Forum Manager
  3. On the resulting page, click the relevant topic (Figure 14-42).

    Figure 14-42 Discussion Forum Topic

    Discussion forum topic

    The selected topic opens.

  4. Your next step depends on whether you want to delete a topic or a reply:

    • To delete a topic, click the Delete Topic link at the top of the topic screen (Figure 14-43).

      Figure 14-43 Delete Topic Link

      Delete Topic link
    • To delete a reply, click the Delete message icon associated with the reply (Figure 14-44).

      Figure 14-44 Delete Message Icon

      Delete message icon on a reply

    A Delete confirmation dialog opens (Figure 14-45).

    Figure 14-45 The Delete Confirmation Dialog

    Edit Topic dialog box
  5. Click Delete.

    The topic and all of its replies or the reply and all of its subordinate replies are deleted.

14.2.3.6 Switching Between Topic View Modes

You have the option of viewing a topic and all of its replies in a hierarchical, indented mode or a flat, unindented mode. The hierarchical mode (Figure 14-46) uses indenting to indicate whether a reply is to the topic or to another reply.

Figure 14-46 Hierarchical View Mode

Hierarchical view mode

For example, in Figure 14-46 the first entry is the main topic, the second is a reply to the topic, the third is a reply to the reply, the fourth entry is a reply to the topic.

The flat mode (Figure 14-47) makes no such distinctions.

Figure 14-47 Flat View Mode

Flat view mode

All Discussion task flows that show topics and replies in the same screen provide view mode options.

To switch between topic view modes:

  1. Log in, and go to the Discussions task flow that contains the topic you want to view.

  2. Click to open the topic you want to view (Figure 14-48).

    Figure 14-48 Discussion Forum Topic

    Discussion forum topic
  3. From the Show dropdown list, select either Flat or Hierarchical (Figure 14-49).

    Figure 14-49 Show Dropdown List

    Show pick list

    The topic view rerenders according to your selection.

14.2.4 Showing and Hiding Additional Discussion Forum Information

Most discussions task flows provide personalization settings for determining information to show in addition to the forum or topic title (the Discussion Forum Manager does not provide such settings). Additional information can include forum or topic author, creation date, and number of replies or topics.

How you set these display settings is personal, affecting only your view of a task flow instance. How you access these display settings varies slightly from task flow to task flow.

This section describes how to configure display settings for Discussions service task flows. It contains the following subsections:

14.2.4.1 Showing or Hiding Information in the Forums Task Flow

In WebCenter Spaces, the Forums task flow is additionally exposed as the Discussions panel in the Sidebar. The display settings available to the Forums task flow are the same display settings available to the Discussions panel. Use the procedure described in this section to set display settings for both.

To show or hide additional information in the Forums task flow:

  1. Go to the Forums task flow where you want to configure display settings.

  2. Click the Select the data to display icon in the task flow toolbar (Figure 14-50).

    Figure 14-50 Select the data to display Icon in the Forums Task Flow

    Edit icon in the forums task flow

    The Display Settings dialog opens (Figure 14-51).

    Figure 14-51 Display Settings Dialog

    Display Settings dialog box
  3. Select the data you want to show, or clear the checkbox of data you want to hide.

    Choose or clear one or more from:

    • Author—The user name of the person who created the forum or topic

    • Date—The date the forum or topic was last updated

    • Number of Replies—The number of replies associated with the topic (for Watched Forums, this displays number of topics)

  4. Click Save to save your changes and close the dialog.

14.2.4.2 Showing or Hiding Information in the Popular Topics Task Flow

To show or hide additional information in the Popular Topics task flow:

  1. Log in, and go to the Popular Topics task flow where you want to show or hide additional information.

  2. Click the Personalize icon in the task flow header.

    This opens a panel where you can select or clear additional data (Figure 14-52).

    Figure 14-52 Show Panel in a Popular Topics Task Flow

    Show panel in a Popular Topics task flow
  3. Select the data you want to show, or clear the checkbox of data you want to hide.

    Choose or clear one or more from:

    • Author—The user name of the person who posted the topic

    • Date—The date the topic was last updated

    • Number of Replies—The number of replies associated with the topic

  4. Click Save to save your changes and close the panel.

14.2.4.3 Showing or Hiding Information in the Recent Topics Task Flow

To show or hide additional information in the Recent Topics task flow:

  1. Go to the Recent Topics task flow where you want to show or hide additional information.

  2. Click the Personalize icon in the task flow header.

    This opens a panel where you can select or clear additional data (Figure 14-53).

    Figure 14-53 Show Panel in a Recent Topics Task Flow

    Show panel in a Recent Topics task flow
  3. Select the data you want to show, or clear the checkbox of data you want to hide.

    Choose or clear one or more from:

    • Author—The user name of the person who posted the topic

    • Date—The date the topic was last updated

    • Number of Replies—The number of replies associated with the topic

  4. Click Save to save your changes and close the panel.

14.2.4.4 Showing or Hiding Information in the Watched Forums Task Flow

To show or hide additional information in the Watched Forums task flow:

  1. Go to the Watched Forums task flow where you want to show or hide additional information.

  2. Click the Personalize icon in the task flow header.

    This opens a panel where you can select or clear additional data (Figure 14-54).

    Figure 14-54 Show Panel in a Watched Forums Task Flow

    Show panel in a Watched Forums task flow
  3. Select the data you want to show, or clear the checkbox of the data you want to hide.

    Choose or clear one or more from:

    • Date—The date the forum was last updated

    • Number of Topics—The number of topics associated with the forum

  4. Click Save to save your changes and close the panel.

14.2.4.5 Showing or Hiding Information in the Watched Topics Task Flow

To show or hide additional information in the Watched Topics task flow:

  1. Go to the Watched Topics task flow where you want to show or hide additional information.

  2. Click the Personalize icon in the task flow header.

    This opens a panel where you can select or clear additional data (Figure 14-55).

    Figure 14-55 Show Panel in a Watched Topics Task Flow

    Show panel in a Watched Topics task flow
  3. Select the data you want to show, or clear the checkbox of the data you want to hide.

    Choose or clear one or more from:

    • Author—The user name of the person who posted the topic

    • Date—The date the topic was last updated

    • Number of Replies—The number of replies associated with the topic

  4. Click Save to save your changes and close the panel.

14.2.5 Watching Forums and Topics

Watching discussion forums and topics provides a convenient means of keeping a close eye on the information most current and relevant to your efforts. The forums and topics you select to watch are personal, in that your selections appear on your view of watch lists. No other user is affected by the forums and topics you choose to watch.

When a user places a watch on a forum or a topic, whenever users add to that forum or topic, in addition to it appearing in the user's watched forums or topics list, the user receives a mail notification.

In WebCenter Spaces, all watched forums and topics are accessible from the Discussions panel in the Sidebar. All watched forums and topics are accessible from the Forums task flow. The Watched Forums and Watched Topics task flows provide more focussed views of watched forums or watched topics.

This section includes information about how to add, view, and manage watched topics and forums. It contains the following subsections:

14.2.5.1 Adding a Discussion Forum or Topic to Your Watch List

To add a discussion forum or topic to your watch list:

  1. Log in, and go to the discussion forum or topic you want to add to your watch list.

  2. The next step depends on whether you want to watch a forum or a topic:

    • To watch a forum, click the Watch Forum link at the top of the forum (Figure 14-56).

      Figure 14-56 Watch Forum Link on the Futures Discussion Forum

      Watch Forum link on the Futures discussion forum
    • To watch a topic, click the Watch Topic link at the top of the topic (Figure 14-57).

      Figure 14-57 Watch Topic Link on the Topic All Bets Are Off

      Watch Topic link on a discussion forum topic

The Watched icon appears next to the forum or topic name (Figure 14-58).

Figure 14-58 The Watched Icon

Watched icon

And the watched forum or topic is listed on all Watched Forums or Watched Topics lists, for example, on the Discussions panel in the WebCenter Spaces Sidebar (Figure 14-59) and in Watched Forums and Watched Topics task flows.

Figure 14-59 Watched Forums on the Discussions Panel in the Sidebar

Watched forums in the WebCenter Spaces Sidebar

14.2.5.2 Removing a Discussion Forum or Topic from a Watch List

To remove a discussion forum or a discussion topic from your watch list:

  1. Log in, and go to the discussion forum or topic you want to remove from your watch list.

  2. Click the Remove Watch link on the discussion forum or topic (Figure 14-60).

    Figure 14-60 The Remove Watch Link

    Remove Watch link

    The selected item is removed from your forum or topic watch list.

14.2.5.3 Viewing Watched Forums and Topics from the Sidebar

To view a watched forum or topic from the WebCenter Spaces Sidebar:

  1. Log in to WebCenter, and in the Sidebar, expand the Discussions panel or click the Discussions icon (Figure 14-61).

    Figure 14-61 The Sidebar Discussions Icon

    Discussions icon
  2. Set the panel display option to Watched Forums or Watched Topics (Figure 14-62).

    Figure 14-62 Watched Forums on the Discussions Panel in the Sidebar

    Watched forums in the WebCenter Spaces Sidebar
  3. Click the link to the discussion forum or forum topic you want to view.

    The forum or topic opens (Figure 14-63).

    Figure 14-63 A Watched Forum Opened from the Sidebar

    Watched forum opened from Sidebar

14.2.6 Sending Mail from Discussion Topics

Each discussion topic in has an associated Send Mail icon in its toolbar (Figure 14-64). Click the Send Mail icon to initiate a mail message containing the discussion text, location, author, and date it was created. This feature makes it easy for you to communicate interesting discussions to others.

Figure 14-64 Send Mail Icons on Discussion Topics

Send Mail icons on discussion topics toolbars

The WebCenter administrator determines the mail client to use with the Send Mail icon. If a local mail client was set, then a plain text message opens. If the WebCenter Mail service was set as the mail client, then the HTML Mail Compose dialog opens. With either mail client, you can add or edit the standard, prepopulated message before sending.

14.3 Setting Discussions Service Task Flow Properties

Every task flow includes a set of configurable properties that influence the behavior, content, and look-and-feel of a given task flow instance. You can access these properties through the Component Properties dialog in Oracle Composer (Figure 14-65).

Figure 14-65 Discussion Forum Manager Component Properties

Discussion Forum Manager component properties

Discussions service Component Properties appear on five tabs:

Not all components provide the same properties; consequently, not all components display all five tabs.

All properties on the Parameters and Display Options tabs provide access to an editor, which you can use to select or specify a variable value in lieu of a constant value. Click the Edit icon next to a property field to open the editor (Figure 14-66).

Figure 14-66 Edit Icon Next to a Parameter Value Field and the Resulting Editor

Edit icon next to a parameter value field

Use the editor to select predefined values, under Choose a value, or to enter a value or an Expression Language expression, under Type a value or expression. The editor provides a test feature, which you can use to validate your selection or entry. For more information about using the editor and for access to a table of common EL expressions, see Section 7.5.5, "Using Expression Language (EL) Expressions with Component Properties."

Many properties are common to all task flows. Additionally, the method for accessing task flow properties is the same from task flow to task flow. Common task flow properties and how to access them are discussed in Section 7.5, "Setting Properties on Page Content."

Some properties are unique to the task flow type. Those properties unique to Discussions service task flows are described in Table 14-1.

Table 14-1 Parameters of Discussions Service Task Flows

Property Description

Hide Toolbar

A means of showing or hiding the task flow personalization feature (see Section 14.2.4, "Showing and Hiding Additional Discussion Forum Information")

  • true means you want to hide the task flow personalization feature available.

  • false means you want to show the task flow personalization feature. false is the default value.

The Hide Toolbar parameter is associated with the following Discussions service task flows:

  • Popular Topics

  • Recent Topics

  • Watched Forums

  • Watched Topics

Forum ID

On the Discussions server, the identifier under which topics are managed

Use this parameter to identify the default forum to show in the task flow.

Use the following EL expression to return the forum ID of a named group space:

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['groupSpaceName'].forumId}

Enter the group space name in lieu of the variable groupSpaceName. The group space name is available on the General tab of the group space Settings page.

The Forum ID parameter is associated with the following Discussions service task flows:

  • Discussion Forum Manager

  • Popular Topics

  • Recent Topics

  • Watched Topics

Show Recursive Forums

A means of specifying whether all forums under a given category/subcategory are shown or only a category's direct child forums are shown

  • true means all forums under a given category/subcategory are shown. true impacts performance.

  • false means only the category's direct child forums are shown. This is the default value.

The Show Recursive Forums parameter is associated with the Discussion Forum Manager task flow.

Category ID

On the Discussions server, the category ID under which a given set of forums is managed

For the Discussion Forum Manager task flow, use this parameter to specify the set of forums to present. For all other discussions task flows, use this parameter to specify the parent ID of the topics to show by default.

If omitted, the value defaults to the Category ID associated with the current group space. In personal spaces, it takes the root Category ID.

Use the following EL expression to return the Category ID of a named group space:

#{sessionContext['oracle.webcenter.collab.forum'].groupInfo['groupSpaceName'].categoryId}

Enter the group space name in lieu of the variable groupSpaceName. The group space name is available on the General tab of the group space Settings page.

The Category ID parameter is associated with the following Discussions service task flows:

  • Discussion Forum Manager

  • Forums

  • Popular Topics

  • Recent Topics

  • Watched Forums

  • Watched Topics

Show Categories

A means of showing the forums grouped under the Category ID category or the topics specified under the Forum ID forum.

  • true means the task flow displays the forums classified under Category ID.

  • false means the task flow displays the topics associated with the specified Forum ID, and navigation to a forums list view is not available.

The Show Categories parameter is associated with the Discussion Forum Manager task flow.