GroupSpace Guide

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Using the GroupSpace Portlets

This chapter describes how to use the BEA WebLogic Portal 9.2 GroupSpace Community portlets. A portlet is a Web-based component that processes requests and generates dynamic content. GroupSpace portlets can communicate with each other. You can customize the content and appearance of a portlet to meet your specific business needs.

GroupSpace contains 13 Community-enabled portlets that work inside the GroupSpace Community. The portlets that do not begin with GS (such as Tasks) can be used outside of a GroupSpace Community in a Community or in a standard desktop.

This chapter contains the following sections:

 


Using the Portlet Icons

Each portlet contains icons that allow you to edit the portlet's properties, delete it, enlarge it, or reduce it, as shown in Figure 7-1.

Figure 7-1 Portlet Icons

Portlet Icons

Editing the portlet's preferences lets you change the language, time zone, and other portal-specific settings.

 


Using the GS Issues Portlet

Use the GS Issues portlet to create lists of topics that are related to a project. For example, project managers can maintain a list of open issues that are migrated to closed issues as they are resolved. Any Community member in a contributor or owner role can create an Issue.

You can create Issues that are Private, Personal, or visible to the Community. See Controlling Who Can View Portlet Data to learn more about who can view portlet data.

You can also filter the list of Issues by status (for example, to show all Open Issues).

Tip: Issues are different than Tasks because Issues do not have a due date. Users could create a Task based on an Issue, to track the work required to resolve the Issue.

Adding an Issue

Perform the following steps to add a new Issue:

  1. Select the Collaborate tab and the Issues tab.
  2. In the Browse tab, select the Community tab to create a Community Issue that all members of the Community can view. Select the Personal tab to create a Personal Issue that the user can view across all the Communities to which the user belongs. (You can also create a Private Issue by creating a Community Issue and marking it as Private. See step 5 for instructions.)
  3. You can create an Issue and place it in the top-level Issues folder, or you can put the Issue in a subfolder. Select the location in the tree where you want the folder and click Create Folder. Enter the name in the Folder Name field and click Create Issue Folder.
  4. Select the folder where you want to place the Issue and click Create Issue, as shown in Figure 7-2.
  5. Figure 7-2 Create a New Issue to Track Comments and Progress


    Create a New Issue to Track Comments and Progress

  6. The text fields for an Issue are limited to 256 characters. In the Create New Issue area, enter the following information:
    • Title - Enter a brief title that describes the Issue. The field is limited to 254 characters.
    • Description - Enter more detail about the Issue. The field is limited to 254 characters.
    • Make Private - Select this check box to ensure that only you can view this Issue in this GroupSpace Community. If you do not select the Make Private check box, all Community members can view the Issue. Community issues are stored in the database at \GroupSpace\collaborationApp\collaborationWebApp\community\ publicCommunity\Issues hierarchy, while Private Issues are stored in your personal folder in the database at \users\<a>\<andrew>\<ProjectStatusIssue> hierarchy. In the example, the <a> directory reflects the first letter of the user name and the <ProjectStatusIssue> represents the name of the Issue.
    • Owner - Enter the Community member you are assigning to the Issue, or click Find User to locate the user. In the Member Picker window, you can click Show All Members to view all Community members, or select a letter to view member names that begin with that letter. Select the radio button next to the member's name and click OK.
    • Notes - Enter more information about the Issue, or report progress on resolving the Issue. If your System Administrator and Portal Administrator enabled the rich text editing formatting toolbar and the bottom toolbar for this portlet, you can use the formatting toolbar (see Figure 4-5 in Chapter 4) to format your text. Clicking the bottom toolbar's HTML button lets you view the body with the HTML tags inserted, and clicking the Preview button allows you to view the Issue before you save it.
    • Tip: If you do not see the formatting toolbar or the bottom toolbar, rich text editing and the bottom toolbar are not enabled for this portlet. The rich text editing formatting bar is enabled by default (but the bottom toolbar is disabled) in the GS Example Community that ships with WebLogic Portal. In other web projects, rich text editing and the bottom toolbar are disabled by default. For instructions on enabling rich text editing, see Setting Up the Rich Text Editor.
    • Priority - Select the drop-down list and choose High, Medium, or Low. This field is internationalized so you can change the displayed language if you want.
    • Status - Select the drop-down list and choose Opened, In Progress, or Closed. This field is internationalized so you can change the displayed language if you want.
    • Resolution - Enter comments after the issue is resolved by editing the Issue and completing this field. For example, you could use these Resolution summaries to review all Issues with a Closed status.
    • Flagged - Select this check box to set the Flagged field to true. Use the Flagged field to monitor Issues that are important to you. Select the Search tab in the Issues tab to search for issues you have flagged.
    • Related Items - Click Add Related Items to insert a relationship to certain content or artifacts, or a QuickLink item to include information that pertains to this issue. The Add Related Items window lets you search for content by choosing a QuickLink item or entering a search query. You can select a Full Text Search (to search all available text) or Field Search (to search specific fields), enter a search query or keyword, and click Search. You can also narrow your search by selecting a type of resource from the Resource Type drop-down list. When you locate a content item, select the check box next to it and click Add. A reference to the document appears in the Related Items field.
    • Figure 7-3 shows the fields to complete to create an Issue.

      Figure 7-3 Create a New Issue


      Create a New Issue

  7. Click Create Issue.
  8. Click Done, and the Issue appears in the GS Issues portlet, as shown in Figure 7-4.
  9. Figure 7-4 New Issue


    New Issue

    Note: An Issue can reside in only one folder You can move (or drag and drop) an Issue to a folder in the tree where the Issue was created. For example, you can move a Community Issue from one folder to another folder in the Community tree, but you cannot move a Community Issue to the Personal tree. Personal data is stored in a different folder than the Community data.
  10. After you create an Issue, you can create Tasks to do to resolve the Issue. See Using the Tasks Portlet.

Managing Issues

You can also perform the following tasks with Issues:

Searching Issues

See Using the Search Portlets for instructions on searching the GS Issues portlet, performing a GroupSpace search, and searching outside GroupSpace.

 


Using the GS Links Portlet

The GS Links portlet helps you create and manage Links to URLs, as well as to content that is internal to the Community. For example, you might use the GS Links portlet to manage a development project, providing links to schedules, progress reports, and software defects.

Links can be created and edited by Community owners, creators, and contributors.

You can use categories to organize your links. Each category appears as a tab in the GS Links portlet. You can add a Link that is visible only to the Community, just to you in this Community (Private), or just by you in all the Communities to which you belong (Personal).

Creating a New Category

The GroupSpace application contains a default Category called Favorite Links. When you create a new category, a new tab appears in the GS Links portlet.

Perform the following steps to create a new category in the GS Links portlet:

  1. Select the Access tab and the Sites tab.
  2. In the GS Links portlet, click Edit Categories.
  3. Click Add New Category.
  4. Enter a name for the new category and click OK. The field is limited to 50 characters.
  5. Click Done. The new Category appears as a tab, as shown in Figure 7-5.
  6. Figure 7-5 Create a New Category


    Create a New Category

You can rename a category by selecting the category tab, clicking Edit Categories, and clicking Rename. Enter the new name and click Update Category Name.

Managing Your Categories

You can re-order the category tabs in the GS Links portlet, and you can also delete categories. When you delete a category from the GS Links portlet, all links associated with the category are also deleted from the portlet.

Perform the following steps to change the tab order in the GS Links portlet:

  1. In the GS Links portlet, click Edit Categories.
  2. In the Reorder column for the category you want to change, click the up or down arrow to change its order.
  3. Note: To delete a category, select the check box next to the category and click Delete Categories.
  4. Click Done.

Adding a New Link

A Link can reside in only one folder.

Perform the following steps to add a new link:

  1. Select the Access tab and the Sites tab.
  2. In the GS Links portlet, select a category tab and click Add New Link.
  3. Enter the following information.
    • Title - Enter text that describes the link. The field is limited to 254 characters.
    • Description - Enter more detail about the link. The field is limited to 254 characters.
    • URL - Enter the URL you want to use as a link. The field is limited to 254 characters.
    • Make Private - Select this check box to be the only user who can view the data in this Community.
  4. Click Add New Link. The new link appears in the GS Links portlet, as shown in Figure 7-6. Clicking a Link opens the link in a browser.
  5. Figure 7-6 New Link


    New Link

Adding a GroupSpace Resource

You can add a new GroupSpace Resource, which is a link to another GroupSpace artifact.

Perform the following steps to add a GroupSpace Resource:

  1. Select the Access tab and the Sites tab.
  2. In the GS Links portlet, select a category tab and click Add GroupSpace Resource.
  3. You can insert a relationship to certain content or artifacts, or a QuickLink item. The Add Related Items window lets you search for content by choosing a QuickLink item or entering a search query. You can select a Full Text Search (to search all available text) or Field Search (to search specific fields), enter a search query or keyword, and click Search. You can also narrow your search by choosing the type of resource from the Resource Type drop-down list. When you locate a content item, select the check box next to it and click Add. The link appears in the category tab.

Managing Your Links

You can also perform the following tasks:

Searching Links

See Using the Search Portlets for instructions on searching the GS Links portlet.

 


Using the GS RSS Reader Portlet

The GS RSS Reader portlet connects to external sites that provide Rich Site Summary (RSS) information and displays the channels as clickable links. RSS is a format used to syndicate news and other web content. RSS channels can include web sites and weblogs. Examples of RSS channels include NewsGator, Safari, and newyorktimes.com.

An RSS channel can be plain text, HTML, or XML. You can set up an RSS channel to be visible to everyone in the Community, just to you in this Community, or just to you in all the Communities to which you belong.

By default, owners, creators, and contributors can add RSS channels; see Editing Default Role Capabilities for more information.

The GS RSS Reader portlet stores the URLs, title, header, and author in the Content Management System, but not the body of the article. An archive feature stores the body of the article.

Subscribing to an RSS Channel

Perform the following steps to subscribe to an RSS channel:

  1. Select the Access tab and the Sites tab.
  2. In the GS RSS Reader portlet's Browse tab, select the Community tab or the Personal tab. Selecting the Community tab allows other Community members to see the new RSS information and places the item in the RSS Channels folder. If you select the Personal tab, only you can see the new RSS information (in all the Communities to which you belong) and the channel is placed in the RSS Feeds folder.
  3. Click Create New RSS Channel.
  4. Enter the URL to the RSS channel. For example, http://rss.news.yahoo.com/rss/oddlyenough.
  5. If you are in the Community tab, you can select the Make Private check box to be the only user who can view the data in this Community.
  6. Click Create RSS Channel.
  7. Click the RSS channel to select it and see its entries, as shown in Figure 7-7.
  8. Figure 7-7 New RSS Channel


    New RSS Channel

Managing RSS Channels

You can also perform the following tasks in the GS RSS Reader portlet:

Searching RSS Feeds

You can use the GS Search portlet (in the Search tab) or the GS RSS Reader's Search tab to search RSS channels. Both types of search let you do a Full Text Search or a Field Search. A Full Text Search is performed against the channel summaries, rather than the feed itself. A Field Search is performed on the properties of individual feed entries (title, visibility, and so on).

See Using the Search Portlets for instructions on searching the GS RSS Reader portlet.

 


Using the GS Announcements Portlets

The GS Announcements portlets displays important notices to the Community. Two GroupSpace portlets let you create and view Announcements:

An Announcement contains a Title, Description, Body, Effective Date and Expiration Date, Severity, and an Address To recipient.

Any Community member with create capabilities can create an Announcement. All Community members can view the Announcement (based on the Address To field). An Announcement is sent only once. When an Announcement expires, it automatically disappears from the GS Announcements portlet and the GS Announcements Manager portlet.

Creating an Announcement

Perform the following steps to create a new Announcement:

  1. Select the Communicate tab and the Announcements tab.
  2. In the GS Announcements Manager portlet, click Create Announcement.
  3. In the New Announcement area, enter the following information:
    • Title - Enter text that briefly describes the Announcement.
    • Description - Enter additional text about the Announcement.
    • Severity - Select one of the following items from the drop-down list:
      • Normal - The Notification is sent based on the normal timer sequence.
      • Critical - One Notification alert is sent per session according to the time you set in the Effective Date field. The GroupSpace application checks every five minutes for Critical Announcements and it sends the Critical Alert, which appears as a pop-up window.
      • Low - The Notification is sent based on the normal timer sequence.
    • Address To - Choose All or a subset of the Community that will receive the Announcement:
    • Effective Date - Click the calendar icon to choose the date and time you want to send the Announcement. The effective date must be later than the current date.
    • Expiration Date - Click the calendar icon to choose the date and time you want the Announcement to expire. The Expiration Date must be later than the Effective Date; the default is one week later. The Announcement must be effective for at least
      24 hours.
    • Body - In the text area, enter the body of the Announcement. If your System Administrator and Portal Administrator enabled the rich text editing formatting toolbar and the bottom toolbar for this portlet, you can use the formatting toolbar (see Figure 4-5 in Chapter 4) to format your text. Clicking the bottom toolbar's HTML button lets you view the body with the HTML tags inserted, and clicking the Preview button allows you to view the Announcement before you save it.
    • Tip: If you do not see the formatting toolbar or the bottom toolbar, rich text editing and the bottom toolbar are not enabled for this portlet. The rich text editing formatting bar is enabled by default (but the bottom toolbar is disabled) in the GS Example Community that ships with WebLogic Portal. In other web projects, rich text editing and the bottom toolbar are disabled by default. For instructions on enabling rich text editing, see Setting Up the Rich Text Editor.

      Figure 7-8 shows a new Announcement.

      Figure 7-8 New Announcement


      New Announcement

  4. Click Add. Based on the Address To field, some or all Community members receive a Notification when the Announcement is created. A Notification also appears in your Notifications Center.

Managing Announcements

Owners and contributors can also perform the following tasks in the GS Announcements Manager portlet:

Editing or deleting an Announcement affects its status in the Notifications Center.

Viewing Announcements

All users can view the GS Announcements portlet.

You can perform the following actions in the GS Announcements portlet:

The Announcement disappears from the GroupSpace application when it expires.

 


Using the GS Document Library Portlet

The GS Document Library portlet provides access to a collection of documents and other content for GroupSpace Community members. This document library lets you create, group, and share documents with other Community members. The GS Document Library portlet lets you place items in folders and subfolders. Content is saved to the BEA Virtual Content Repository.

GroupSpace creators, owners, and contributors can create documents and content items. The GS Document Library portlet also allows users to browse the directory where they have access privileges. If the user belongs to more than one Community, all personal content that the user is allowed to see is displayed.

Documents can be any type of file; for example, MS Word files, text files, or binary files.

Tip: You might want to create a folder before you create a document; so that you can place the document directly in the folder. Click Create Folder, enter a name, and click Create Document Folder. You can create folders for Community documents, but not for Personal documents.

Perform the following steps to add a new document or file to the GS Document Library:

  1. Select the Access tab and the Content tab.
  2. In the Browse tab of the GS Document Library portlet, select the Community tab to add a document that is visible to all Community members. In the Community tab, you can choose to make the document Private (visible only to you in this Community). You can select the Personal tab to add a document that is visible to you in all the Communities to which you belong.
  3. Select the folder where you want to place the document and click Create Document. (You cannot create folders for Personal documents.)
  4. Enter the following information:
    • Title - Enter a unique name for this document.
    • Description - Enter text that describes the document.
    • Make Private - Select the check box to make this document visible only to you in this Community. If you do not select the check box, the document is visible to all Community members.
    • Author - Enter the Community member who created this document.
    • Keywords - Enter searchable words that are contained in this document. This field allows you to quickly retrieve the document when you perform a property search.
    • File - Attach a file. Click Browse, locate the file, and click Open. The file can be any type of file, including an MS Word file, text file, or a binary file.
    • Related Items - Click Add Related Items insert a relationship to certain content or artifacts, or a QuickLink item to include information that pertains to this document. The Add Related Items window lets you search for content by choosing a QuickLink item or entering a search query. You can select a Full TextSearch (to search content or metadata) or Field Search (to search specific fields), enter a search query or keyword, and click Search. You can also narrow your search by selecting a type of resource from the Resource Type drop-down list. When you locate a content item, select the check box next to it and click Add. A reference to the document appears in the Related Items field.
    • Review Figure 7-10 to see all the fields.

      Figure 7-10 New Document


      New Document

  5. Click Create Document. The new document appears in the GS Document Library portlet.

Managing Documents

Creators, owners, and contributors can perform the following tasks in the GS Document Library portlet (except where indicated):

Searching Documents

See Using the Search Portlets for instructions on searching the GS Document Library portlet.

 


Using the GS GroupNotes Portlet

Owners and Contributors can use the GS GroupNotes portlet to create and update formatted documents to share with the Community. Standard formatting includes bullets, italics, bold, or colored text, and so on. You can also insert links or references to web sites, other GroupNotes documents, and GroupSpace content items (such as Issues).

Tip: You might want to create a folder before you create a document, so that you can place the document directly in the folder. Click Create Folder, enter a name, and click Create Folder.

Creating a GroupNote

Perform the following steps to create a new document:

  1. Select the Collaborate tab and the GroupNotes tab.
  2. In the GS GroupNotes portlet, expand the tree and select the folder where you want to place the document.
  3. Click Create GroupNote to start a new document.
  4. In the Title field, enter a name for this document.
  5. In the Description field, enter text that describes your document.
  6. Select the Make Private check box to make this document viewable only by you in this Community. If you do not select the Make Private check box, the document is available to the entire Community, or to all Communities to which you belong. Personal documents are stored in a separate folder from Community and Private information.
  7. In the Body area, type information about the GroupNote. If your System Administrator and Portal Administrator enabled the rich text editing formatting toolbar and the bottom toolbar for this portlet, you can use the formatting toolbar (see Figure 4-5 in Chapter 4) to format your text. Clicking the bottom toolbar's HTML button lets you view the body with the HTML tags inserted, and clicking the Preview button allows you to view the GroupNote before you save it.
  8. Tip: If you do not see the formatting toolbar or the bottom toolbar, rich text editing and the bottom toolbar are not enabled for this portlet. The rich text editing formatting bar is enabled by default (but the bottom toolbar is disabled) in the GS Example Community that ships with WebLogic Portal. In other web projects, rich text editing and the bottom toolbar are disabled by default. For instructions on enabling rich text editing, see Setting Up the Rich Text Editor.
  9. In the Body, you can also insert the following kinds of links in a GroupNotes document:
    • Web Site - Choose Insert > Link to insert a link to a web site by adding the URL to a fully qualified URL. The fields in the Link Properties window correspond to standard HTML attributes for an anchor tag. Click OK.
    • GroupNote Rich Text Document - Choose Insert > GroupNote Link to insert a link to another rich text object. Use the portlet search tool to locate the document you want to insert in this GroupNote.
    • GroupSpace Content item - Choose Insert > GroupSpace Link to insert a link to a content item, such as an Issue, contained in the virtual content repository. Use the portlet search tool to locate the content you want to insert in this GroupNote.
  10. Click Add Related Items to insert a relationship to certain content or artifacts, or a QuickLink item to include information that pertains to this GroupNote. The Add Related Items window lets you search for content by choosing a QuickLink item or entering a search query. You can select a Full Text Search (to search content or metadata) or Field Search (to search content properties), enter a search query or keyword, and click Search. You can also narrow your search by selecting a type of resource from the Resource Type drop-down list. When you locate a content item, select the check box next to it and click OK. A reference to the document appears in the Related Items field.
  11. Figure 7-11 shows a GroupNote document.

    Figure 7-11 Creating a New GroupNote


    Creating a New GroupNote

  12. Click Create GroupNote. The document appears in the GS GroupNotes portlet.
  13. Click Done.

Managing GroupNotes

Owners, creators, and contributors can also perform the following tasks in the GS GroupNotes portlet:

Searching GroupNotes

See Using the Search Portlets for instructions on searching the GS GroupNotes portlet.

 


Using the Tasks Portlet

The Tasks portlet allows you to create and track Community items or personal items on a To Do list. You can view recent tasks and quickly add new tasks. The Tasks portlet can store personal information and Community information.

The Tasks portlet provides summary information about a list of tasks including priority, attachments, subject, status, and due date. Tasks can be sorted by each of these fields, except file attachments and priority.

Adding a Task

Perform the following steps to create a new Task:

  1. Select the Schedule tab and the Tasks tab.
  2. Select the Community tab to add a Community task or the Personal tab to add a personal task.
  3. Click Add Task
  4. Enter the following information:
    • Primary Information - Click Primary Information and enter the following information:
      • Subject - Enter text describing the Task.
      • Due Date - Click the calendar icon and select a due date and time.
      • Start Date - Click the calendar icon and select a start date and time.
      • Status - Click the drop-down list and choose Not Started, Completed, or In Progress.
      • Importance - Click the drop-down list and choose High, Low, or Medium. On the Tasks portlet, high priority tasks are denoted with a red exclamation point, while low priority tasks have a blue down arrow.
    • Other Information - Click Other Information to add categories for this Task (separated by a semicolon), adjust the Percent Complete, or add detailed Comments. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.
    • Attachments - Click Attachments to add a document to this Task. Click Browse to locate the document and click Attach. The Task is saved before you add the attachment.
    • See Figure 7-12.

      Figure 7-12 New Task with an Attachment


      New Task with an Attachment

  5. Click Save. This Task appears in the Tasks portlet with a red exclamation point to show it has a high priority, as shown in Figure 7-13.
  6. Figure 7-13 High Priority Task


    High Priority Task

    You can view information differently by clicking the columns to reorder them.

Managing Tasks

 


Using the Discussion Forums Portlet

The Discussion Forums portlet lets users post and monitor topics of interest. A Community owner or creator creates categories (folders) and Discussion Forums, and other Community members can post topics and reply to the threaded discussions. Community owners and creators can create, edit, and delete categories, Discussion Forums, and topics. Community owners, creators, and contributors have create and edit capabilities, and viewers have read capability only.

A Discussion Forum exists within the Community, rather than outside the Community (such as an RSS channel).

You can organize your Discussion Forums by creating categories to organize Forums with similar topics.

Adding a Category and a Discussion Forum

Perform the following steps to create a category and a Discussion Forum:

  1. Select the Collaborate tab and the Discussion Forums tab.
  2. You can create a category to organize Discussion Forums with similar topics. Click Add Category.
  3. Enter the following information for the new category:
    • Name - Enter text describing the category that will contain the Discussion Forums.
    • Keywords - Enter searchable words that are contained in this Discussion Forum. Keyword searching does not support search connectors; if you enter car truck, only discussion forums that have car truck in that order will be retrieved. This field allows you to quickly retrieve relevant Discussion Forums when you perform a property search.
    • Description - Enter text describing the category. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.

      See Figure 7-14.

      Figure 7-14 New Category


      New Category

  4. Click Add. The category appears in the portlet.
  5. Create a Discussion Forum by selecting the category and clicking Add Forum.
  6. Enter the following information for the new Discussion Forum:
    • Name - Enter text describing the purpose of the Discussion Forum.
    • Keywords - Enter searchable words that are contained in this discussion. Keyword searching does not support search connectors; if you enter car truck, only discussion forums that have car truck in that order will be retrieved. . This field allows you to quickly retrieve the Discussion Forum when you perform a property search.
    • Author Masked - Select this check box to not display the author.
    • Description - Enter text describing the Discussion Forum topic. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.
  7. Click Add. The new Discussion Forum appears in the portlet, as shown in Figure 7-15.
  8. Figure 7-15 New Discussion Forum


    New Discussion Forum

Adding a Discussion Topic

After you create a Discussion Forum, Community members can add topics to it.

Perform the following steps to add a topic to a Discussion Forum:

  1. Select the Collaborate tab and the Discussion Forums tab.
  2. Select the category and click the name of the Discussion Forum in the Forum column.
  3. Click Post New Topic.
  4. Enter the following information:
    • Name - Enter text describing this topic. The topic name must be unique, and the following characters are not permitted: \ and /.
    • Keywords - Enter searchable words that are contained in this topic. Keyword searching does not support search connectors; if you enter car truck, only discussion topics that have car truck in that order will be retrieved. This field allows you to quickly retrieve topics when you perform a property search.
    • Author Masked - Select this check box to not display the author.
    • Description - Enter text for your topic. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.
    • Attachments - Add a file by clicking Attachments and clicking Browse. Locate your file and click Open. Add the file by clicking Attach.
  5. Click Save. The Discussion Topic appears in the Discussion Forums portlet. See Figure 7-16.
  6. Figure 7-16 The New Discussion Topic Appears in the Discussion Forums Portlet


    The New Discussion Topic Appears in the Discussion Forums Portlet

Replying to a Discussion Topic

After you create topics, Community members can post replies to topics.

Perform the following steps to add a topic to a Discussion Forum:

  1. Select the Collaborate tab and the Discussion Forums tab.
  2. In the Browse tab, select the category and the Discussion Forum.
  3. Click the name of the Discussion Forum in the Forum column.
  4. Click the topic's name in the Topic column and click Reply.
  5. Enter your reply information and click Save.

Managing Discussion Forums

GroupSpace owners, creators, and contributors can also perform the following tasks in the Discussion Forums portlet:

In addition to adding a topic to a Discussion Forum, Community members can also perform the following tasks:

 


Using the Mail Portlet

The Mail portlet allows users to send and receive personal e-mail to other members in your GroupSpace Community and to people outside the Community.

Unread messages are highlighted and display a closed envelope icon. Messages in the Inbox that you have already read are not in bold text and the icon is not highlighted.

Configuring the Mail Portlet

You must configure your mail account and add information about your incoming and outgoing mail server.

Perform the following steps to configure your mail account for incoming and outgoing mail:

  1. Select the Communicate tab and the Mail tab.
  2. If the Add Account page does not display, click the Mail portlet's Edit button.
  3. Enter information by clicking Account Information, General Mail Settings, Incoming Mail Settings, and Outgoing Mail Settings:
    • Account Information - Enter the name of your mail account. Do not use special characters. Select the Set as the default account to make this your default mail account.
    • General Mail Settings - In the Mail message `display from' field, enter the name you want to appear in the From field in your e-mails. In the From email address field, enter your e-mail address.
    • Incoming Mail Messages - Complete all of the fields to set up your incoming mail server. Each field is required:
      • The incoming mail username - The username to access your incoming mail server.
      • The incoming mail password - The password to access your incoming mail server.
      • Incoming mail host name or IP address - The server name or IP address of the incoming mail server.
      • Incoming mail protocol - The protocol the incoming mail server supports. You can select POP3 or IMAP.
      • Incoming mail port - The port to connect to the incoming mail server. This defaults to the value for the selected protocol. Enter port 110 for POP3 or 143 for IMAP.
      • The mail timer retrieve mail interval - The time out value in seconds for the incoming mail server to poll for new messages.
    • Outgoing Mail Messages - Complete all of the fields to set up your outgoing mail server. Each field is required:
      • Outgoing mail username - The username to access your outgoing mail server.
      • Outgoing mail password - The password to access your outgoing mail server.
      • Outgoing mail host name or IP address - The outgoing host name or IP address.
      • Outgoing mail protocol - The protocol the outgoing mail server supports. You can select SMTP.
      • Outgoing mail port - The port to connect to the outgoing mail server. This defaults to the value for the selected protocol. For SMTP, enter 25.
      • See Figure 7-17.

        Figure 7-17 Configuring the Mail Servers


        Configuring the Mail Servers

  4. Click Save.

Sending E-Mail

Perform the following steps to send an e-mail:

  1. Select the Communicate tab and the Mail tab.
  2. Click New Message to send a new e-mail.
  3. Enter information by clicking Primary Information, Attachments, or Options:
  4. Primary Information - Click Primary Information and enter the recipients, subject, and additional text. The To field is the only required field. You can also click To to pick a recipient from your list of personal contacts. You can click Check Names to view your contacts. In the text area, enter text for the body of the e-mail. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
  5. Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.
    • Attachments - Click Attachments to add a file to the e-mail. Click Browse, select the file, click Open, and click Attach. The file can be a document or a binary file.
    • Options - Click Options and select a priority for your e-mail. You can also save a copy of the e-mail to your Sent folder and be notified when the recipient reads the mail.
    • See Figure 7-18.

      Figure 7-18 New E-Mail Message


      New E-Mail Message

  6. Click Send. (Clicking Save as Draft saves the e-mail in your Drafts folder so you can send it later.) You cannot delete your Inbox, Sent Items, or Drafts folders.

Viewing Mail

Perform the following steps to send and view your e-mail and attachments:

  1. View an e-mail by clicking the item.
  2. You can click Reply to send a reply to the e-mail, or Forward to send the e-mail to someone else.
  3. If the e-mail has an attachment, click it and click the attachment name, and Open to view it or Save to download it.
  4. Click Done to return to your other mail messages.
Tip: Click Check Messages to refresh the page and display new e-mails.

Managing Mail

You can also perform the following tasks in the Mail portlet:

Searching Mail

You can search for individual Mail folders and messages for keywords that appear in the Subject, Body, From, or Date fields.

See the Using the Search Portlets for more information on searching the Mail portlet, the GroupSpace Community, and the enterprise.

 


Using the Calendar Portlet

The Calendar portlet lets you create and schedule appointments. The Calendar portlet can store personal Calendar information and Community Calendar information.

You can customize the number of Calendar days that display. A Calendar appointment shows up in the Notifications Center when the appointment time is within the amount of time you specify.

Adding a Calendar Appointment

Perform the following steps to add an appointment to your calendar:

  1. Select the Schedule tab and the Calendar tab.
  2. Select the Community tab or the Personal tab to add an item to each of those Calendars.
  3. Click Add Appointment. You can also click the appropriate time in the calendar and add the appointment.
  4. Enter the following information about the appointment:
    • Primary Information - Click Primary Information and enter the subject, time, date, description, and location of your appointment. You can indicate whether the calendar shows your appointment time as busy or free. You can also indicate the importance of the appointment: High, Medium, or Low. These settings are reflected on the calendar.
    • In the Description field, enter text describing the appointment. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.
    • Repeating - Click Repeating and indicate the frequency of the appointment. For example, if you select Weekly, the appointment is scheduled automatically for the same day and time each week. By default, meetings do not repeat. You can also specify an end date for repeating meetings. Figure 7-19 shows a recurring meeting every Monday for five months.
    • Figure 7-19 Repeating Calendar Appointment


      Repeating Calendar Appointment

    • Attachments - Click Attachments and add a file to the appointment by clicking Browse, choosing a file on your file system, and clicking Attach.
    • See Figure 7-20 to view information for a new appointment.

      Figure 7-20 New Calendar Appointment


      New Calendar Appointment

  5. Click Save. The new appointment appears in the Calendar portlet.

Managing Your Calendar

You can also perform the following tasks:

 


Using the Contacts Portlet

Use the Contacts portlet to view and manage names, addresses, phone numbers, e-mail addresses, and other information in a personal address book. The Contacts portlet can store Personal Contacts and Community Contacts.

The Contacts portlet works with the Mail portlet. If you receive an e-mail from someone, you can open the e-mail in the Mail portlet and click Add to Contacts to add the sender to your Contacts list.

Adding a Contact

Perform the following steps to add a new Contact:

  1. Select the Communicate tab and the Contacts tab.
  2. Select the Community tab to add a Community contact or the Personal tab to add a personal contact.
  3. Click Add Contact. The Add Contact dialog appears.
  4. Enter information about the contact by clicking each of the following:
    • Primary Information - Enter the contact's name, including first, middle, and last name, as well as title and name suffix. You can also enter the contact's e-mail address.
    • Business Information - Enter the contact's business details in the Business Information section. This section is optional.
    • Personal Information - Enter the contact's personal information, such as home phone, personal cell phone, birthday, and so on. This section is optional.
    • Other Information - Enter information about the contact. This section is optional. If your System Administrator and Portal Administrator enabled rich text editing for this portlet, you can click Rich text to use the formatting toolbar to format your text, or click Plain text to enter text without formatting. If rich text editing is disabled for this portlet, the Rich text and Plain text links are not available.
    • Tip: Rich text editing is enabled by default in the GS Example Community that ships with WebLogic Portal, but not in other web projects. For instructions on enabling rich text editing in a portlet, see Setting Up the Rich Text Editor.

      See Figure 7-21 to view the fields for a new business contact.

      Figure 7-21 Adding a New Business Contact


      Adding a New Business Contact

  5. Click Save. The contact appears in the Contacts portlet, as shown in Figure 7-22.
  6. Figure 7-22 New Contact


    New Contact

Filtering and Navigating Contacts

The Contacts portlet provides several ways to filter and navigate through your list of contacts. If the list of contacts is long, the GroupSpace application breaks it into pages. Navigate these pages using the arrow buttons.

To change the default number of contacts per page, click the portlet's Edit icon. Click Addressbook Preferences and use the Contacts per Page drop-down list to change the default number of contacts that appear.

The Contacts portlet lets you filter the contacts that are displayed in the table in several ways, including the following:

Managing Contacts

You can also perform the following tasks:

Searching Contacts

You can use the following information to search for contacts:

To perform a search, enter the search string in the Search field and click Search. The results appear in the portlet.

See the Using the Search Portlets for more information on searching the Contacts portlet, the GroupSpace Community, and outside the GroupSpace Community.

 


Using the CM Browser Portlet

Use the CM Browser portlet to read content in BEA content repositories and non-BEA content repositories. The Shared Content Repository is the default content repository for a GroupSpace application that is created when you create a new GroupSpace domain. If you used the Domain Configuration Wizard to create a domain, and you selected the WebLogic Portal GroupSpace Application check box, the Shared Content Repository is installed automatically. You can browse this repository in your GroupSpace Community; to edit the content, use the WebLogic Portal Administration Console.

If you create a new enterprise application in Workshop for WebLogic and select the GroupSpace facets, the BEA Repository is added to it (rather than the Shared Content Repository).

You can browse this repository in your GroupSpace Community. You can set Visitor Entitlements on a repository or its sub folders; see the Security Guide for more instructions on setting up Visitor Entitlements.

Browsing Content

Perform the following steps to read content in the repository:

  1. Select the Access tab and the Content tab.
  2. In the Browse tab of the CM Browser portlet, select the repository with the documents you want to read. If a subfolder exists, click the subfolder to view its documents. The GS Example Community uses the Shared Content Repository. The Shared Content Repository is the default content repository for a GroupSpace application that is created when you create a new GroupSpace domain.
  3. View a document by clicking the document name.

Managing Content

You can also perform the following tasks:

Searching Content

To perform a search, click the Search tab in the CM Browser portlet. Enter the search string and click Search. The results appear in the portlet. You can also search using a Saved Search. See Using the Search Portlets for more information on searching the content in the CM Portlet, the GroupSpace Community, and outside the GroupSpace Community.

 


Using the Search Portlets

The Search portlets let you perform full text searches and browse information. All American Standard Code for Information Interchange (ASCII) characters are supported in a search expression.

You can perform three types of search in the GroupSpace Community:

Configuring an Enterprise Search

You must configure the Enterprise Search portlet to narrow its scope. For example, if you want to search URLs, you must add the URLS where the search can be performed to a configuration file. If you do not restrict an Enterprise Search, the results could be too large for you to manage.

Three configuration files exist for an Enterprise Search:

Performing an Enterprise Search

Perform the following steps to perform an Enterprise search:

  1. Log in as a GroupSpace Community owner, creator, or member.
  2. Select the Search tab.
  3. In the GS Enterprise Search portlet, enter the keywords for your query by completing the following fields:
    • All of these words - Retrieves documents that contain every word listed in this field, in any order.
    • This exact phrase - Retrieves documents that contain an exact match, in this precise order.
    • Any of these words - Retrieves documents that contain at least one of the words listed in this field.
    • Include the following sources in the search - Select the drop-down list to pick individual content repositories or all databases that were configured to be searched. See Configuring an Enterprise Search.
    • See Figure 7-24 for an example.

  4. Click Search. The results display at the bottom of the Search portlet.
  5. Figure 7-24 An Enterprise Search of Three Databases for the Word Climbing


    An Enterprise Search of Three Databases for the Word Climbing

  6. Click Download to save a local copy of a document.

Performing a GroupSpace Search

A GroupSpace Search retrieves content and properties that are contained in the GroupSpace Portlets (Links, Issues, Document Library, Discussion Forums, and so on). For example, searching your GroupSpace application for an author with a specific name can retrieve documents written by the person, topics the person posted in a Discussion Forum, and so on.

If you want to perform a GroupSpace Search for restricted values (values that appear in a drop-down list, such as Priority or Status), you should perform a Field Search, rather than a Full Text Search. Within your Field Search, select the value from the drop-down list, such as In Progress for a Status field when searching Issues.

Perform the following steps to perform a GroupSpace search:

  1. Select the Search tab or click the global Search button.
  2. If you have already created a Saved Search, select the drop-down list to pick a search that you created and stored. See Saving Your Search Queries for instructions on saving a search phrase.
  3. In the GS Search portlet, select Full Text Search or Field Search. A Full Text Search lets you search on specific words that might be part of either the property or the binary data. A Field Search searches just content properties, such as title, description, owner, status, resolution, and so on for the terms you specify for the portlets you want to search.
  4. In the Resource Type drop-down list, select which GroupSpace portlet you want to search. You can search all the data in the portlets that are listed, or you can narrow your search to a specific portlet.
  5. Tip: You cannot perform a Field Search for the Discussion Forums portlet; Discussions does not appear in the Resource Type drop-down list.
  6. Depending on the option you specified in step 4, complete the fields for the search query.
  7. Click Search. The results display at the bottom of the Search portlet, as shown in Figure 7-25.
  8. Figure 7-25 A GroupSpace Search of All Portlets for the Word Project


    A GroupSpace Search of All Portlets for the Word Project

Performing a Portlet Search

You can search the following portlets:

If you want to perform a Portlet Search for restricted values (values that appear in a drop-down list, such as Priority or Status), you should perform a Field Search, rather than a Full Text Search. Within your Field Search, select the value from the drop-down list, such as In Progress for a Status field when searching Issues.

Perform the following steps to perform a portlet search:

  1. Select the tab for the portlet you want to search and select the Search tab or locate the Search bar in the portlet.
  2. If you are using the portlet's Search bar, enter the keyword, as shown in Figure 7-26.
  3. Figure 7-26 Portlet Search for the Word Project


    Portlet Search for the Word Project

    If you are using the query builder in the portlet's Search tab, select Full Text Search or Field Search. A Full Text Search lets you search on specific words that might be part of either the property or the binary data. A Field Search searches just content properties, such as title, description, owner, status, resolution, and so on for the terms you specify for the portlets you want to search.

    Enter the keywords for your query by completing the following fields:

    • All of these words - Retrieves items with every word listed in this field.
    • This exact phrase - Retrieves items that contain an exact keyword match.
    • Any of these words - Retrieves items that contain at least one of the words listed in this field.
  4. Click Search. The search results appear in the portlet. You can change the order in which they appear by clicking a column header.

Saving Your Search Queries

You can save your search terms so that you or other Community members can run them again later. A saved search consists of the search term, but not the search results. You can re-run the search exactly as it was saved or you can edit the search query before you run it. When you save the search term, you can determine who can view the saved search by marking it as Community, Personal, or Private.

You can save your search queries and run them against the following portlets:

Creating a Saved Search

Perform the following steps to create and save a search query:

  1. Select the Search tab.
  2. Select Full Text Search or Field Search. A Full Text Search searches all properties for your search term, while a Field Search searches specific properties, such as Title, Description, or Visibility for the values you enter.
  3. At Resource Type, use the drop-down list to select which portlet you want to search. You can also select All to search all five portlets.
  4. Complete the remaining fields for your query and click Save Search.
  5. Complete the Title and Description fields for the saved search. The Title field must be unique according to the visibility—you can have a Private Default Search in the GS Issues portlet called Project and a Community Default Search in the GS Issues portlet called Project, but you cannot have two Community Default Searches in GS Issues that are both called Project.
  6. At Visibility, select one of the following options to determine who can see the saved search:
    • Community - The saved search query is visible to the entire Community
    • Personal - The saved search query is visible to all Communities to which you belong
    • Private - The saved search query is visible just to you in this Community
  7. Click Save to store and run the search.
  8. Click Search to run the search.
Tip: You can also search an individual portlet by selecting the Search tab within a portlet. For example, you can search only the GS Issues portlet.

Running a Saved Search

Perform the following steps to run a saved search:

  1. Select the Search tab.
  2. In the Saved Searches field, select a search query from the drop-down list. The fields are populated with the choices you made when you saved the search.
  3. Click Search.

Editing the Properties of a Saved Search

Perform the following steps to change the name, description, and visibility (only from Private to Community) of a saved search:

  1. View your saved searches by clicking Manage Saved Searches.
  2. Click Edit Search to change the name or description of the search, or who can see the saved search. (If you want to change the search term, create a new search.) You can change the visibility of a saved search query only from Private to Community. You can also delete a saved search from the Manage Saved Searches page by selecting the check box next to the search and clicking Delete Searches.
  3. From the Manage Saved Searches page, click Done.

 


Optimizing Portlet Performance

When you perform a GroupSpace search or a portlet search, the speed of the search can be affected by how you sort the columns and properties in the portlets. Some GroupSpace data has explicit properties, such as Title, Description, Owner, and Visibility. You can efficiently sort these explicit properties. All other properties are implicit. An implicit property sort is performed in memory after the data is retrieved. If your implicit property sort results in a large amount of data, you could experience a small delay in viewing the data.


  Back to Top       Previous  Next