Skip Headers
Oracle® Fusion Middleware User's Guide for Oracle WebCenter Spaces
11g Release 1 (11.1.1.5.0)

Part Number E10149-09
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

52 Managing Space Members and Roles

This chapter provides information about managing members and roles for a Space. It contains the following sections:

Audience

This chapter is intended for users who are responsible for managing Space members and their role assignments. It describes how to set up a Space membership policy and define member roles and responsibilities.

This chapter is intended for users assigned, minimally, the Space Moderator role or a custom role that includes the default permissions granted to a moderator.

The WebCenter Spaces administrator has the authority to expose or hide some features and services for all Spaces. Contact your WebCenter Spaces administrator if some tasks discussed in this chapter are not available to you.

Note:

For more information about Space roles, see Section 52.2.1, "What You Should Know About Roles and Permissions for a Space".

52.1 Setting Up the Membership Policy for a Space

Space moderators determine the membership policy for their Space, choosing between an "invitation only" membership policy, allowing WebCenter users to join themselves by subscribing to (and unsubscribing from) the Space, adding new members directly, or using any combination of these membership options.

Enabling self-service does not necessarily mean that users automatically gain access to a Space. Moderators can still control who joins (or leaves) the Space through an approval process.

Default membership permissions are derived from the template used to create the Space. Moderators can change these settings at any time. This section describes:

52.1.1 Managing Self-Service Membership for a Space

As Space moderator, you can limit access to a Space, or allow WebCenter users to join themselves, without an invitation, through self-service.

Additionally, you may allow WebCenter users to join a Space or change their Space membership without approval, or require approval for certain roles. When membership requests require approval, new members do not automatically gain access when they subscribe to a Space. Instead, the moderator receives a subscription notification that he or she can either accept or reject.

To manage self-service for a Space:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select Membership Options in the toolbar.

  3. Under Membership Self-Service:

    • To prevent non-members from joining the Space through self-service or requesting changes to their current membership, select Do Not Allow Self-Service Membership or Self-Service Membership Change (Figure 52-1).

      Figure 52-1 Disabling Self-Service

      Enable Self-Registration enabled
      Description of "Figure 52-1 Disabling Self-Service"

    • To allow non-members to join a Space and members to request changes to their current membership, select Allow Self-Service Membership or Self-Service Membership Change (All Roles Available).

      Note:

      If you select this option, make sure that other people can see the Space through their Spaces page and through searches (see Section 51.14.3, "Making a Space Known (Discoverable)").

      When you select this option, the following additional options become available through the Spaces page:

      • Spaces that allow self-service display a Join Space button in the Space Information dialog box (select About> About this Space from the Space's Actions menu, as described in Section 49.6, "Joining a Space").

      • Select Membership> Change Role from the Space's Action menu.

  4. To be notified of self-service requests so you can approve or reject them before users become members of the Space, select Moderator Approval Required.

    Tip:

    This checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.
  5. To specify which roles users see on Request Membership and Change Membership pages, select Allow Self-Service Membership or Self-Service Membership Change (Selected Roles Available) to display a table showing all the roles available (Figure 52-2).

    • Select Enable to offer the role on the Request Membership and Change Membership pages. Clear Enable to hide a role.

    • Select Approval Required to specify that moderator approval is required before the request is granted. The request is sent to the moderator's Worklist to approve or reject (if the Space has multiple moderators, all moderators receive the request; only one moderator must process the request). Clear Approval Required to allow the change without moderator approval.

      The Approval Required checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.

    Figure 52-2 Choosing Roles Available on Self-Service Membership

    Customize Roles selected
    Description of "Figure 52-2 Choosing Roles Available on Self-Service Membership "

  6. Click Save.

New members can now join this Space through self-service. For more information, see Section 49.6, "Joining a Space".

52.1.2 Managing Self-Service Membership Removal from a Space

If moderator approval is required to unsubscribe from a Space, an unsubscription request is sent to the moderator's Worklist when a member leaves to either accept or reject.

To configure approval options for Space unsubscription:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select Membership Options in the toolbar.

  3. Under Membership Self-Service (Figure 52-3):

    • To specify that moderator approval is required to leave a Space, select Moderator Approval Required for Self-Service Membership Removal.

    • To allow members to leave without approval, clear Moderator Approval Required for Self-Service Membership Removal.

    Tip:

    This checkbox only displays when WebCenter Spaces workflows are configured for your application and the Worklist service is up and running.

    Figure 52-3 Specifying Unsubscribe Request Approval Requirements

    Approval Required enabled
    Description of "Figure 52-3 Specifying Unsubscribe Request Approval Requirements"

  4. Click Save.

52.2 Managing Roles and Permissions for a Space

The Space moderator is responsible for setting up roles to control what members can do in the Space. Space moderators can manage permission assignments for existing roles, create new roles, and delete roles that are no longer required.

This section describes how moderators manage member roles and permissions:

52.2.1 What You Should Know About Roles and Permissions for a Space

When you create a new Space, WebCenter Spaces automatically creates some defaults roles, with default permissions. If the default roles do not meet the needs of the Space, Space moderators can define custom roles. This section provides the following information:

52.2.1.1 Understanding the Default Roles for a Space

WebCenter Spaces automatically creates several default roles for a new Space, as shown in Table 52-1.

Note:

These default roles are always available for Spaces based on out-of-the-box templates (Basic, Group Project, and Community of Interest). Spaces based on user-defined templates may offer a different set of default roles. The default permissions assigned to the default roles are shown in Table 52-2.

Table 52-1 Default Roles for Spaces

Space Role Description Modify Permissions Delete Role

Moderator

The Moderator role is automatically assigned to the creator of a Space. This role is automatically granted the highest level of permissions, as shown in Table 52-2.

The Space moderator or anyone with the Space Manage All permission can modify permissions as necessary and appropriate.

Yes (except for Manage All)

No

Participant

The Participant role is automatically granted the default permissions shown in Table 52-2.

The Space moderator or anyone with Space Manage All permission can grant additional permissions as necessary and appropriate.

Yes

Yes

Viewer

The Viewer role is automatically granted the default permissions shown in Table 52-2.

The Space moderator or anyone with Space Manage All permission can grant additional permissions as necessary and appropriate.

Yes

Yes

Authenticated-User

The Authenticated-User role is given to authenticated users of WebCenter Spaces, with no access to Space information by default. Once logged in, users assigned this role typically have access to the Home Space, and always inherit any permissions granted to the Public-User role.

To grant access to a Space, additional permissions must be granted by the Space moderator or anyone with Space Manage All permission (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role").

Yes

No

Public-User

Any user with access to WebCenter Spaces who is not logged in assumes the Public-User role. Users with the Public-User role have no access to Space information by default. Such users are anonymous, unidentified, and Space permissions must be granted explicitly by the Space moderator or anyone with Space Manage All permission (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role" and Section 51.14.5, "Granting Public Access to a Space").

Yes

No


52.2.1.2 Understanding Permissions and Permission Models in a Space

Members can perform actions within a Space as specified by the permissions assigned to their role.

When assigning roles, moderators can choose one of two permission models:

  • Standard permission model:

    • Basic Services collectively control access to pages, lists, events, links and notes

    • Resources collectively control access to all resources types, including page templates, navigations, skins, resource catalogs, and so on

    Table 52-2 lists the permission categories and permissions that are available when standard permissions are enabled.

  • Advanced permission model:

    • Separate service categories enable you to control access on a service-by-service basis. Separate permissions are provided for the following services: Pages, Events, Links, Lists, Notes.

    • Separate resource categories enable you to control access on a resource-by-resource basis. Separate permissions are provided for the following resources: Skins, Page Templates, Navigations, Resource Catalogs, Page Styles, Content Presenter Templates, Data Controls, Task Flows.

    While detailed permissions give you more flexibility over role assignments, they can become complex to manage and maintain. Table 52-3 lists the permission categories and permissions that are available when advanced permissions are enabled.

It is the Space template that determines the default permission model for a Space. Spaces that are based on out-of-the-box Space templates adopt the simpler, standard permission model by default, but moderators can switch to the advanced permission model if required. For more information. see Section 52.2.4, "Using the Advanced Permission Model".

Note:

Permissions do not inherit the privileges of "lesser" permissions. Therefore, be careful to assign the appropriate set of permissions to allow users to perform required actions. For example, whenever you assign the Create permission, select the View permission too.

Table 52-2 Space Permissions - Simple Permission Model

Permission Category Permissions Roles Granted Permission By Default

Administration

Manage All - Enable access to all Space Administration pages.

Includes Manage Configuration and Manage Membership permissions.

Moderator
 

Manage Configuration - Same as the Manage All permission but excludes security privileges. Users with this permission cannot access the Roles and Members pages.

Users with the Configure permission must be allowed to view the Space.

 
 

Manage Membership -Enables access to the Roles and Members pages in the Space administration settings. Through these pages, users can create, edit and delete members and roles for the Space.

 

Basic Services

(Events, Links, Lists, and Notes)

Edit Page Access, Structure, and Content - Create, edit and delete pages in the Space. Manage page access and edit page properties. Add and remove task flows and portlets. Create, edit, and delete lists, events, links, and notes.

Specifically, users with this permission can perform the following operations within the Space:

  • Events - Create, delete, edit, and view events

  • Links - Create, and delete links

  • Lists - Create, delete, edit, update, and view lists

  • Notes - Create, delete, edit, and view events

Moderator
 

Edit Page Access and Structure - Manage page access and edit properties of pages in the Space. Add and remove task flows and portlets.

Moderator
Participant
 

Customize Pages and Edit Content - Customize your view of pages in the Space. Add and remove list content, events, links, and notes.

Moderator
Participant
 

View Pages and Content - View pages, lists, events, links, and notes in the Space.

Moderator
Participant
Viewer

Announcements

Create, Edit, and Delete Announcements - Perform any operation on announcements associated with the Space.

Note: This permission does not take effect for the Public-User role.

Moderator
 

Create and Edit Announcements - Create and edit announcements. Delete announcements that you create.

Users with the Edit permission must be allowed to view announcements.

Note: This permission does not take effect for the Public-User role.

Participant
 

View Announcements - View announcements.

Participant
Viewer

Discussions

Create, Edit, and Delete Discussions - Perform any operation on discussions associated with the Space; create topics and replies. Edit and delete any topic or reply.

Note: The Manage permission does not take effect for the Public-User role.

Moderator
 

Create and Edit Discussions - Create topics and replies. Edit topics and replies that you create. Users with this permission must be allowed to view discussions.

Participant
 

Reply To Discussions - Reply to existing topics and edit replies that you create. Users with this permission must be allowed to view discussions.

Participant
 

View Discussions - View discussions.

Participant
Viewer

Documents

Administration - Configure document workflows and access control settings.

Moderator
 

Delete Documents - Delete any folder and any file in the Space, including wikis and blogs. Users with this permission can also move folder and files.

Users with the Delete permission must be allowed to create and view folders and files.

Moderator
Participant
 

Create and Edit Documents - Create files, wikis, blogs, and folders, and upload files. Delete files, wikis, blogs, and folders that you create. Delete other files and folders if permissions allow.

Users with the Create permission must be allowed to view folders and files.

Moderator
Participant
 

View Documents - Browse files, wikis, blogs, and folders.

Moderator
Participant
Viewer

Resources

Create, Edit, and Delete Resources - Create, edit, and delete resources owned by the Space, such as page, templates, navigations, resource catalogs, skins, page styles, content presenter templates, mashup styles, task flows, and data controls.

Moderator
 

Create Resources - Create new resources for the Space.

 

Edit Resources - Edit resources owned by the Space.

 

Table 52-3 Space Permissions - Advanced Permission Model

Permission Category Permissions Roles Granted Permission By Default

Administration

Manage All - Enable access to all Space administration pages.

Includes Manage Configuration and Manage Membership permissions.

Manage Configuration - Same as the Manage All permission but excludes security privileges. Users with this permission cannot access the Roles and Members pages.

Users with the Configure permission must be allowed to view the Space.

Manage Membership -Enables access to the Roles and Members pages in the Space administration settings. Through these pages, users can create, edit and delete members and roles for the Space.

Moderator

Pages

Create, Edit, and Delete Pages - Create and delete pages in the Space. Manage page access and edit page properties. Add and remove page content.

Moderator
 

Create Pages - Create pages in the Space.

 
 

Edit Pages - Edit page properties and content for any page in the Space.

Moderator
Participant
 

Delete Pages - Delete any page in the Space.

 
 

Customize Pages - Customize your page view.

Moderator
Participant
 

View Pages - View pages in the Space.

Moderator
Participant
Viewer

Announcements

Create, Edit, and Delete Announcements - Perform any operation on announcements associated with the Space.

Note: This permission does not take effect for the Public-User role.

Moderator
 

Create and Edit Announcements - Create and edit announcements. Delete announcements that you create.

Users with the Edit permission must be allowed to view announcements.

Note: This permission does not take effect for the Public-User role.

Participant
 

View Announcements - View announcements.

Participant
Viewer

Content Presenter Templates

Create, Edit, and Delete Content Presenter Templates - Create, edit and delete content display templates for the Space.

Create Content Presenter Templates - Create content display templates for the Space.

Edit Content Presenter Templates - Edit Space-level content display templates.

See also, Chapter 40, "Publishing Content Using Content Presenter".

 

Discussions

Create, Edit, and Delete Discussions - Perform any operation on discussions associated with the Space; create topics and replies. Edit and delete any topic or reply.

Note: The Manage permission does not take effect for the Public-User role.

Moderator
 

Create and Edit Discussions - Create topics and replies. Edit topics and replies that you create. Users with this permission must be allowed to view discussions.

Participant
 

Reply To Discussions - Reply to existing topics and edit replies that you create. Users with this permission must be allowed to view discussions.

Participant
 

View Discussions - View discussions.

Participant
Viewer

Documents

Administration - Configure document workflows and access control settings.

Moderator
 

Delete Documents - Delete any folder and any file in the Space. Users with this permission can also move folder and files.Users with the Delete permission must be allowed to create and view folders and files.

Moderator
Participant
 

Create and Edit Documents - Create files and folders, and upload files. Delete files and folders that you create. Delete other files and folders if permissions allow.

Users with the Create permission must be allowed to view folders and files.

Moderator
Participant
 

View Documents - Browse files and folders.

Moderator
Participant
Viewer

Links

Create, and Delete Links - Create and delete links between objects, and manage link permissions.

Create Links - Create links between objects.

Delete Links - Delete a link between two objects.

 

Lists

Create, Edit, and Delete Lists - Create, edit, and delete lists and list data.

Create Lists - Create a list.

Edit Lists - Edit list column definitions.

Delete Lists - Delete any list.

Edit List Data - Add, edit, and delete list data.

View Lists - View lists and list data.

 

Mashup Styles

Create, Edit, and Delete Mashup Styles - Create, edit and delete mashup styles for the Space.

Create Mashup Styles - Create mashup styles for the Space.

Edit Mashup Styles - Edit Space-level mashup styles.

See also, Section 26.3.4, "Managing Mashup Styles".

 

Navigations

Create, Edit, and Delete Navigations - Create, edit and delete navigations for the Space.

Create Navigations - Create navigations for the Space.

Edit Navigations - Edit Space-level navigations.

See also, Chapter 11, "Working with Navigation".

 

Notes

Create, Edit, and Delete Notes - Create, edit and delete notes for the Space.

Create Notes - Create notes for the Space.

Edit Notes - Edit notes.

Delete Notes - Delete notes.

View Notes - View notes.

 

Page Styles

Create, Edit, and Delete Page Styles - Create, edit and delete page styles for the Space.

Create Page Styles - Create page styles for the Space.

Edit Page Styles - Edit Space-level page styles.

See also, Chapter 15, "Working with Page Styles".

 

Page Templates

Create, Edit, and Delete Page Templates - Create, edit and delete page templates for the Space.

Create Page Templates - Create page templates for the Space.

Edit Page Templates - Edit Space-level page templates.

See also, Chapter 12, "Working with Page Templates".

 

Resource Catalogs

Create, Edit, and Delete Resource Catalogs - Create, edit and delete resource catalogs for the Space.

Create Resource Catalogs - Create resource catalogs for the Space.

Edit Resource Catalogs - Edit Space-level resource catalogs.

See also, Chapter 16, "Working with Resource Catalogs".

 

Skins

Create, Edit, and Delete Skins - Create, edit and delete skins for the Space.

Create Skins - Create skins for the Space.

Edit Skins - Edit Space-level skins.

See also, Chapter 14, "Working with Skins".

 

Space Events

Create, Edit, and Delete Events - Create, edit and delete events for the Space.

Create Events - Create events.

Edit Events - Edit any event.

Delete Events - Delete any event.

View Events - View events.

 

Task Flows

Create, Edit, and Delete Task Flows - Create, edit and delete task flows based on a mashup style for the Space.

Create Task Flows - Create task flows for the Space.

Edit Task Flows - Edit Space-level task flows.

See also, Section 26.3, "Creating and Managing Task Flows".

 

52.2.1.3 Understanding Custom Roles in Spaces

If the default roles do not meet the requirements of your Space, moderators can define custom roles that better suit its members. See Section 52.2.2, "Defining Custom Roles for a Space".

Alternatively, moderators can modify the permissions assigned to the default roles. See Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

52.2.2 Defining Custom Roles for a Space

If the default roles provided by WebCenter Spaces do not meet the needs of the Space, you can define custom roles to better suit the requirements of your members.

To create a new role for a Space:

  1. In the Space administration settings, display the Roles page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

    On the Roles page, current roles defined for this Space display as columns in the table.

  2. To define a new role for this Space, click Create Role.

    The Create Role dialog box opens (Figure 52-4).

    Figure 52-4 Creating a New Role for a Space

    Create Role dialog
    Description of "Figure 52-4 Creating a New Role for a Space"

  3. Enter a suitable Role Name. Names can contain alphanumeric characters, blank spaces, @, and underscores. Ensure that role names are self-descriptive to make it as obvious as possible which member should belong to which roles.

  4. Enter a Description for the role.

  5. Optionally, choose a Template Role.

    The new role inherits permissions from the template role. You can modify these permissions in the next step. If you do not choose a template role, the new role is created with no permissions.

    Choose Moderator to create a role that inherits full administrative privileges for the Space. Choose Viewer (if available) to create a role starting with minimal, view-only privileges.

  6. Click OK.

    The new role appears as a column in the table on the Roles page.

  7. To modify permissions for the role, select Edit Permissions, and then select or clear each permission checkbox. For details, see Section 52.2.3, "Viewing and Editing Permissions of a Space Role".

    Take care to assign appropriate access rights when assigning permissions for new roles. Do not allow users to perform more actions than are necessary for the role but at the same time, try not to inadvertently restrict them from activities they must perform.

52.2.3 Viewing and Editing Permissions of a Space Role

The Edit Permissions dialog lists permissions available for the Space, pages in the Space, Space resources, and services that are enabled for the Space. If a service is not shown, then either no permissions are required for that service (for example, the Mail service), or the service is disabled in the Space. For more information, see Section 51.10.1, "Enabling and Disabling Services Available to a Space".

If the default permissions assigned by WebCenter Spaces do not meet the needs of the Space, or you want to change previously assigned permissions, you can modify the permissions to better suit your role requirements.

Note:

The Moderator role permission Manage All cannot be modified.

To change the permissions assigned to a role:

  1. In the Space administration settings, display the Roles page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select the role you want to change, then click Edit Permissions.

  3. On the Edit Permissions for <role_name> dialog, select or clear the checkboxes to enable or disable permissions for a role (Figure 52-5).

    Figure 52-5 Modifying Permissions for a Space

    Roles subtab
    Description of "Figure 52-5 Modifying Permissions for a Space"

  4. Click Save.

New permissions are effective immediately.

Note:

For more detailed information about granting access permissions to a Space, and to individual pages within a Space, refer to Section 51.14.4, "Granting WebCenter Spaces Users Access to a Space".

52.2.4 Using the Advanced Permission Model

Advanced permissions are detailed permissions that give you more flexibility over role assignments, but can become complex to manage and maintain. For example, you can set create, edit, view, and delete permissions for individual services and resources, rather than setting the same permission for all services or all resource types.If you switch to using the advanced permission model, you cannot revert back to standard permissions later. See also, Section 52.2.1.2, "Understanding Permissions and Permission Models in a Space".

To use advanced permissions:

  1. In the Space administration settings, display the Roles page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Click Advanced Permissions.

    A warning message displays.

  3. Click OK to continue.

52.2.5 Deleting Roles in a Space

When a role is no longer required, the Space moderator can remove it from the Space. This helps maintain a valid role list and prevents inappropriate role assignment.

Note:

The roles Moderator, Authenticated-User, and Public-User cannot be deleted.

To delete a role in a Space:

  1. In the Space administration settings, display the Roles page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select the role you want to delete, then click Remove Role (Figure 52-6).

    Figure 52-6 Deleting a Role for a Space

    Delete icon on Roles subtab
  3. In the Delete Role confirmation dialog box, click Delete to confirm that you want to delete the role.

52.3 Managing Members and Assigning Roles

This section describes how moderators manage membership for a Space. It includes the following subsections:

52.3.1 What You Should Know About Space Membership

Member participation is central to any Space. It is the moderator's responsibility to manage membership and determine member participation through the permissions assigned to the various roles defined for the Space. A Space can gather members in several ways:

52.3.2 Viewing Members of a Space

To review current membership for a Space:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. In the Members table, review the current list of members and their current role assignment.

  3. Using the Filter dropdown, choose All Members to see a full list or choose the name of a role to list members with a particular role.

52.3.3 Composing Messages to New Members

When you add or invite someone to your Space, they receive a message through the Mail service (if configured) and through their Worklist (if Worklists are set up). Before you start recruiting new members, take some time to compose suitable greetings and messages for the following scenarios:

  • Adding a WebCenter Spaces user as a member of your Space.

  • Inviting a WebCenter Spaces user to join your Space.

  • Inviting someone to register with WebCenter Spaces and join your Space.

To compose messages sent out to new members:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select Membership Options in the toolbar.

    The Membership Options dialog displays (Figure 52-7).

    Figure 52-7 Editing Messages to New Members

    Set Add and Invite Member Message
    Description of "Figure 52-7 Editing Messages to New Members"

  3. Enter a short message to include in membership notifications or invitations in the appropriate sections, as required. Use the message text to describe the Space and how it might be of use to new members.

  4. Click OK to save.

52.3.4 Adding Members to a Space

This section describes various ways that a moderator can enlist Space members:

52.3.4.1 Adding WebCenter Spaces Users and Groups

As Space moderator, you can add any registered WebCenter Spaces user to become a member of your Space. WebCenter Spaces users receive notification through the Mail service (if configured) and through their Worklist (if Worklists are set up).

To add a member to your Space:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. (Optional) Click Membership Options to edit the greeting messages sent to new members (see Section 52.3.3, "Composing Messages to New Members").

  3. Choose one of:

    • Add People to add one or more individual users as members of the Space.

    • Add Groups to add multiple users belonging to a named user group in the identity store.

  4. If you know the exact name of the person or group, enter the name in the box provided, separating multiple names with a comma (Figure 52-8).

    If you are not sure of the name you can search the identity store. Enter one or more characters of the name you are looking for and click the Filter icon. Users (or groups) matching your search criteria display in the table.

    The First Name, Last Name, Mail Address, and CN fields are included in the search.

    Search Tips:

    • Use * as a wildcard, for example *sales.

    • Leave the search field blank to list all users (or groups) in the identity store.

    • Enter a space between two search terms to search First Name and Last Name, for example jo sm, searches for jo in First Name and sm in Last Name.

    Figure 52-8 Adding a New Member

    Add Member on Members subtab
  5. Select one or more user names from the list.

    Note:

    Adding the PUBLIC user to a Space does not make the Space available to the public. To find out how to make a Space public, see Section 51.14.5, "Granting Public Access to a Space".
  6. Select a role for the new (or invited) members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

  7. Click Add.

All the users and groups you select display in the Members table.

52.3.4.2 Inviting a WebCenter Spaces User

As Space moderator, you can invite anyone who is a registered WebCenter Spaces users to become a member of your Space. WebCenter Spaces users receive notification through the Mail service (if configured) and through their Worklist (if Worklists are set up).

To invite a member to your Space:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. (Optional) Click Membership Options to edit the greeting message sent to invited members (see Section 52.3.3, "Composing Messages to New Members").

  3. Choose Invite People to invite individual users to become a member of the Space.

  4. If you know the exact name of the person, enter the name in the box provided, separating multiple names with a comma (Figure 52-8).

    If you are not sure of the name you can search the identity store. Enter one or more characters of the name you are looking for and click the Filter icon. Users (or groups) matching your search criteria display in the table.

    The First Name, Last Name, Mail Address, and CN fields are included in the search.

    Search Tips:

    • Use * as a wildcard, for example *sales.

    • Leave the search field blank to list all users (or groups) in the identity store.

    • Enter a space between two search terms to search First Name and Last Name, for example jo sm, searches for jo in First Name and sm in Last Name.

    Figure 52-9 Inviting a New Member

    Add Member on Members subtab
  5. Select one or more user names from the list.

    Note:

    Adding the PUBLIC user to a Space does not make the Space available to the public. To find out how to make a Space public, see Section 51.14.5, "Granting Public Access to a Space".
  6. Select a role for the invited members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

  7. Click Invite.

52.3.4.3 Allowing a WebCenter Spaces User to Self-Subscribe

Self-service enables a WebCenter Spaces user to request membership without an invitation from the Space moderator. Certain types of Spaces, especially interest-based communities, are particularly suited to this form of member enrollment as the Space often reaches a wider audience.

The capabilities of self-service members depends on which roles you decide to offer on the Request Membership page. For more information, see Section 52.1.1, "Managing Self-Service Membership for a Space".

52.3.4.4 Inviting a Non-WebCenter Spaces User

If your WebCenter Spaces application allows unregistered people to become members, Space moderators can invite anyone with a valid mail address to join the Space. Prospective members receive an invitation by mail, inviting them to join the Space. Upon accepting the invitation, unregistered users are prompted to register with WebCenter Spaces before gaining access to the Space.

To invite someone outside the WebCenter Spaces community to join your Space:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Click Membership Options to edit the greeting message that is sent to non-WebCenter Spaces users (see Section 52.3.3, "Composing Messages to New Members").

  3. Click Invite People, then Invite Non-WebCenter Spaces Users:

    Note:

    The Invite Non-WebCenter Spaces Users section displays only when self-registration is enabled through WebCenter Spaces Administration:
    • Allow Self-Registration Through Invitations

    • Allow Public Users to Self-Register

    See also, Chapter 22, "Enabling Self-Registration".

  4. Enter the Email Address(es) for one or more prospective members, separated by commas.

  5. Select a Role for the prospective members. If the role you want is not listed, create a role that meets your requirements (see Section 52.2.2, "Defining Custom Roles for a Space").

  6. Click Invite.

Prospective members receive an mail invitation to join the Space with the message you compose using the Invite Non-WebCenter Spaces User Message (see Section 52.3.3, "Composing Messages to New Members"). The invitation includes a secure, self-registration URL that the invited party can click to register with WebCenter Spaces and accept Space membership (see Section 49.6.2, "Joining a Space (Unregistered WebCenter Spaces User)".

52.3.5 Changing Member Role Assignments

Moderators can change a member's role at any time. Users are notified of membership changes through their Worklist.

To change a member's current role:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select one or more members, and then click the Change Role icon.

  3. In the Change Role dialog box, choose a different role.

    If you are not sure which role to choose, click the Roles tab to determine the range of actions that current roles allow (see Section 52.2.3, "Viewing and Editing Permissions of a Space Role"). If the existing roles do not meet your requirements, consider creating a new role (see Section 52.2.2, "Defining Custom Roles for a Space").

  4. Click OK.

52.3.6 Approving Requests for Membership of a Space

If someone requests membership of your Space or an existing member requests a new role, a notification appears in your Worklist. As Space moderator, you can approve or reject these requests.

The person making the request receives notification of your decision. If you reject a request, you should explain the reasons why.

For details, see Chapter 70, "Working with the Worklist Service".

52.3.7 Communicating with Moderators and Members of a Space

You can send messages to individual members, and also to the moderator(s) or all the members of a Space. WebCenter creates a default distribution list for every Space if the Mail server is Microsoft Exchange and active directory connection details (LDAP) are provided in the mail server connection settings. As members leave or join the Space, WebCenter updates the default distribution list.

For information about setting up a custom Space mail distribution list, see Section 51.10.2, "Configuring a Custom Space Mail Distribution List".

There are several ways to communicate with the moderator(s) and members of a Space:

52.3.7.1 Sending a Message from the Spaces Page

(Members only) To send a message to the moderator(s) or all members from the Spaces page:

  1. In the Home Space, click Spaces.

  2. On the Spaces page, find the Space to which you want to send mail. If it is not shown, use Filter or Search to list it (see Section 49.3, "Viewing Available Spaces").

  3. Right-click the Space's icon, and then choose Contact> Send Mail to Members or Send Mail to Moderators (Figure 52-10).

    These options are available only to members.

    Figure 52-10 Actions Menu

    Group Space Actions menu

52.3.7.2 Sending a Message from the Members Page

(Moderators only) To send a message to all members, or an individual member, from the Members page:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Under Members:

    • To send a message to all members of the Space, click Mail Members in the toolbar.

    • To send a message to an individual member, click the member's icon, and then click the members mail address.

52.3.7.3 Contacting Space Moderator(s)

You can contact a Space moderator from the Spaces page:

  1. In the Home Space, click Spaces.

  2. On the Spaces page, find the Space to which you want to send mail. If it is not shown, use Filter or Search to list it (see Section 49.3, "Viewing Available Spaces").

  3. Right-click the Space's icon, and then choose Contact> Send Mail to Moderators (Figure 52-10).

    These options are available only to members.

    Figure 52-11 Actions Menu

    Group Space Actions menu

52.3.8 Revoking Membership

Moderators can revoke user membership for a Space at any time. Users receive notification through their Worklist when you cancel their membership.

To revoke membership:

  1. In the Space administration settings, display the Members page.

    Tip:

    The way you access this page depends on the page template in use. For example, in a side navigation template, you may access it through a Manage menu.

    You can also navigate to this page using the direct URL provided in Section A.3, "User Interface URLs for Space Pages."

  2. Select one or more members in the table, and then click Remove Member. (Figure 52-12)

    Figure 52-12 Removing a Member

    Delete icon on Members subtab
    Description of "Figure 52-12 Removing a Member"

  3. In the Remove Member dialog box, click Remove to confirm.

52.4 Working with the Space Members Task Flow

WebCenter Spaces provides a Space Members Task Flow, which lists all the members of a particular Space. This task flow is an abbreviated version of the Members page in the Space administration settings, as described in Section 52.3.2, "Viewing Members of a Space."

To add a Space Members task flow to a page, see Section 51.16.1, "Adding a Space Task Flow to a Page."

This section includes the following subsections:

52.4.1 What You Should Know About the Space Members Task Flow

The Space Members Task Flow enables you to get an at-a-glance view of the members of a Space. It lists the members of the Space and also shows each user's role within the Space, for example, Moderator, Participant, and Viewer. The Space Members Task Flow also provides a quick way of getting to the Space administration Members page where you can manage Space membership, if you have the appropriate permissions.

To add a Space Members task flow to a page, see Section 51.16.1, "Adding a Space Task Flow to a Page."

52.4.2 Managing Space Membership Through the Space Members Task Flow

Moderators can quickly access the tools for managing membership from the Space Members Task Flow.

To manage Space membership:

  1. Log in and locate the Space Members Task Flow.

  2. In the Space Members Task Flow, click the Add icon (Figure 52-13).

    The Add icon only displays to moderators or members with the Space permission Manage All.

    Figure 52-13 The Add Icon in the Space Members Task Flow

    Add icon in the Members task flow
  3. This takes you to the Members tab where you can add members as described in Section 52.3.4.1, "Adding WebCenter Spaces Users and Groups."

  4. On the Members tab, you can also remove members, invite users to join the Space, and edit exiting members' roles within the Space. For more information, see Section 52.3, "Managing Members and Assigning Roles."

52.4.3 Contacting All Space Members

If you have a message to send to all members of the Space, you can do this from the Space Members Task Flow.

To contact all Space members:

  1. Log in and locate the Space Members Task Flow.

  2. Click Mail All Members in the Space Members Task Flow toolbar (Figure 52-14).

    You may be presented with a login window. If so, then enter your user name and password for your mail application. If your preferences are set up to deliver your login credentials automatically, then you can start your message right away. For more information about login credentials and preferences, see Chapter 35, "Setting Your Personal Preferences."

    Figure 52-14 Mail All Members Icon in the Space Members Task Flow

    Send Mail icon in the Members task flow
  3. Compose your message and click Send.

52.4.4 Contacting Individual Members of a Space

It's easy to contact a Space member from the Space Members Task Flow:

To contact a member:

  1. Log in and locate the Space Members Task Flow.

  2. In the Space Members Task Flow, click the name of the member you want to contact (Figure 52-15).

    Figure 52-15 Contacting a Member Using the Space Members Task Flow

    Contacting a member using the Members task flow

    By default, when you click a member's name their profile summary displays. From here, you can contact the member by mail, send them an instant message, and so on. See also, Section 30.5.1, "Viewing Profile Details."

    The profile does not display if the Profile Launched on Selection parameter is disabled, for details see Section 52.4.7.2, "Space Members Task Flow Parameters".

52.4.5 Sorting Members

You can sort the list of members by name or by recent activity. Use the Sort Criteria parameter described in Section 52.4.7.2, "Space Members Task Flow Parameters".

52.4.6 Filtering Members

Use filtering to help find a particular member in the Members task flow.

To filter the list of members:

  1. Log in and locate the Members task flow.

  2. In the Members task flow, enter a full or partial name in the Filter field (Figure 52-16), and then click the Filter arrow icon to the right of the field.

    Figure 52-16 Filtering Options in the Members Task Flow

    Search field in Members task flow
  3. The list of members refreshes, displaying only those members that match the search term.

    Filtering searches against a listed member's user name. For example, if your search criteria is "c", the search results might include members named "chris", "vicki", or "weblogic".

  4. Alternatively, filter the members by role by selecting a Role from the dropdown list.

  5. To return the list of members to its default display, click the Clear Filter icon (Figure 52-17) and select All Members from the Role dropdown.

    Figure 52-17 Clear Search Icon in the Members Task Flow

    Clear search icon in Members task flow

52.4.7 Setting Space Members Task Flow Properties

The Space Members Task Flow has associated properties, which users with sufficient privileges can access from the Component Properties dialog in Oracle Composer (Figure 52-18).

Figure 52-18 Space Members Task Flow Component Properties

Member Task Flow Component Properties properties

For information about accessing the Component Properties dialog, see Section 17.5.2.3, "Setting Component Properties."

The following sections provide information about properties of the Space Members task flow and describe the properties on the Parameters tab:

52.4.7.1 What You Should Know About Space Members Task Flow Properties

The properties on the Parameters tab of the Component Properties dialog control the default task flow content. For descriptions of the parameters on this tab, see Section 52.4.7.2, "Space Members Task Flow Parameters." For some task flows, parameters on this tab facilitate the wiring of the task flow to page parameters and page definition variables. For information about wiring pages and components, see Chapter 19, "Wiring Pages, Task Flows, Portlets, and UI Components."

Changes to the properties on the Display Options, Style, and Content Style tabs affect the appearance and behavior of the task flow for all users. These properties are common to all task flows. For more information, see Section 17.5.2, "Setting Properties on Page Components."

The contents of the Events tab depend on the events supported by the task flow. For more information, see Section 17.5.2.8, "Working with Component Contextual Events."

All properties on the Parameters and Display Options tabs 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 Edit icon next to a property field to open the editor. For more information about using the editor and for descriptions of common EL expressions, see Appendix B, "Expression Language Expressions."

52.4.7.2 Space Members Task Flow Parameters

Table 52-4 describes the parameters that are unique to the Space Members Task Flow.

Table 52-4 Space Members Task Flow Parameters: Parameter Tab

Parameter Description

Group Space Name

The name of the Space for which to display members. Default value is the current Space. Use this parameter to display member details for a different Space.

You can obtain a Space's name from its About this Space dialog.

Express values using the following formats:

Number of Columns

The number of columns used to display members. The default is null which means 'no limit' and in this case member details wrap to fill the entire width of the task flow.

To fix the number of members displayed in each row, enter the number of 'columns' you require. Horizontal scroll bars display if there is not enough space to display the number of members specified here.

Express values using the following formats:

Number of Rows

The number of rows used to display members. The default is null which means that member details wrap to fill the space available. Vertical scroll bars display if there is not enough space to display all the members.

To fix the maximum number of rows displayed, enter the number of 'rows' you require. Previous and Next buttons automatically display if more member details are available.

Express values using the following formats:

Profile Launched on Selection

Determines whether to launch a profile popup when you select a member's name.

Deselect this option if you do not want to launch profile details.

Sort Criteria

The order in which to sort the members.

Specify LAST_ACTIVITY_TIME to sort the members in descending order of date/time at which they were last involved in any activity. If not specified, members are sorted by name, alphabetically.