Skip Headers
Oracle® Workspaces Application Developer's Guide
10g Release 1 (10.1.2)

Part Number B25480-01
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

2 Architecture of Oracle Workspaces

This chapter describes the main parts of Oracle Workspaces, and the Java classes that represent these parts in the SDK.

Parts of Oracle Workspaces

Oracle Workspaces consists of the following top-level components:

Users

A user is anyone who is provisioned with an Oracle Collaboration Suite account. Users have access to the Oracle Workspaces application.

An application role is a description of the actions that a user may perform in the Oracle Workspaces application. The following application roles exist:

  • Application administrator: Users who have this role are "super users." They may perform administration tasks, such as grant other users roles, manage templates, or act like the workspace administrators for any workspace.

  • Workspace creator: Users who have this role may create workspaces.

If users are not granted any of these roles, they are simply workspaces users. Any user can be added as a member to any workspace.

When assigning roles to users or adding users as members to a workspace, you could choose to assign workspace roles (reader, writer or administrator) to any user or group. A group is a representation of an Oracle Internet Directory group. The group is expanded to its members before performing a particular operation (such as role assignment or the addition of members to a workspace). As a result, operations are not performed on the group but on the individual users of the group.

Workspaces

A workspace is a container that groups members, resources, and views. The workspace controls how its members may interact with the resources it contains.

Members

A member is a user that belongs to a workspace. Each member may be granted a workspace role.

A workspace role is a description of the actions that the member may perform within one particular workspace. Three predefined workspace roles exist:

  • Reader: Members who have this role may view workspace content but may not create new content or edit or delete existing content.

  • Writer: Members who have this role may read, edit, and delete existing content and add new content.

  • Administrator: Members who have this role have all the privileges of the writer role, and they may also manage workspace configuration and membership.

Resources

A resource is an object that represents an Oracle Collaboration Suite component, or a subsystem that manages a pre-determined set of objects and their functions. The following table describes the resources available in Oracle Workspaces, the name by which they are represented in the Oracle Workspaces Web client, and the Oracle Collaboration Suite components that they represent:

Table 2-1 Resource Class Names and Corresponding Oracle Collaboration Suite Component

Java SDK Resource Class Name What You See in the Oracle Workspaces Web Client Oracle Collaboration Suite Component

CwCalendarResource

Meetings & Tasks

Oracle Calendar

CwDiscussionResource

Discussions

Oracle Discussions

CwEmailResource

Inbox

Oracle Mail

CwFilesResource

Library

Oracle Content Services

CwViewResource

View

No Oracle Collaboration Suite component equivalent, a workspace-specific resource


No two resources of the same type may be added to the same workspace. Each workspace has its own instance of each resource.

Resource Items

A resource item is an object that represents a data item in a specific resource or workspace. The following table describes the resource items that each resource controls, and the name by which each resource item is represented in the Oracle Workspaces Web client:

Table 2-2 Resource Item Class Names and Corresponding Oracle Workspaces Web Client Components

Resource Java SDK Resource Item Class Name What You See in the Oracle Workspaces Web Client

Calendar

CwEvent

Meeting

Calendar

CwTask

Task

Discussion

CwBoard

Forum

Discussion

CwThread

Topic

Discussion

CwMessage

Message

Files

CwFolder

Folder

Files

CwFilesResourceItem, CwFilesResourceItemWithContent

File

Not managed by resource but by workspace

CwAnnouncement, CwAnnouncementList

Announcements


A resource may have multiple instances of resource items. Resource item classes extend the CwResourceItem class.

Announcements

An announcement is a message posted by a member of a workspace that all members of that workspace may see on the workspace home page. Each announcement can have a title, body and an expiration date.

Views

A view is a group of resource items that is treated as one resource item. For example, a product development workspace can contain a view for new developers. This view can include functional and design specifications contained in a files resource, and a developer's forum contained in a discussion resource.

Templates

A template is a container for general workspace characteristics that can be used as a basis for creating new workspaces. A template is stored as an XML file.