Difference between revisions of "Use Case 08: Manage Groups/Communities"

From Federation of Earth Science Information Partners
Line 1: Line 1:
  
 +
Use Case EIE08: Manage Working Group (Communities)
 +
 +
for
 +
 +
ESIP Earth Information Exchange
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
Version 1.0 draft
 +
 +
Prepared by Karl Benedict
 +
 +
Earth Data Analysis Center, University of New Mexico
 +
 +
December 13, 2005
 +
 +
Revision History
 +
 +
 +
 +
Name
 +
 +
Date
 +
 +
Reason For Changes
 +
 +
Version
 +
 +
Karl Benedict
 +
 +
12/13/05
 +
 +
Document created
 +
 +
1
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
1.Use Case Identification
 +
 +
1.1.Use Case Number
 +
 +
EIE08
 +
 +
1.2.Use Case Name
 +
 +
Manage thematically oriented groups within the portal.
 +
 +
2.Use Case Definition
 +
 +
Support for thematically oriented groups within the portal is important for providing a high level organizational structure to the content and presentation of the materials provided by the portal. This use case documents the capability of portal administrators (Operators) to create topical groups on behalf of users that propose the creation of such communities, and the capability for users (acting in the role of community manager) to manage those communities.
 +
 +
2.1.Actors
 +
 +
Users (role: community manager)
 +
 +
Operators
 +
 +
2.2.Preconditions
 +
 +
1.User’s identity has been authenticated.
 +
 +
2.3.Postconditions
 +
 +
1.A new community has been created, or
 +
 +
2.An existing community has been modified.
 +
 +
2.4.Normal Flow
 +
 +
EIE08.0.1) User is authenticated as a registered user
 +
 +
EIE08.0.2) User accesses a form to request the creation of a new community
 +
 +
EIE08.0.3) User completes the form and submits it for review by the portal administrator.
 +
 +
EIE08.0.4) Portal administrator is authenticated as a registered user and portal administrator
 +
 +
EIE08.0.5) Portal administrator reviews the request
 +
 +
EIE08.0.6) Portal administrator accesses a community creation form.
 +
 +
EIE08.0.7) Portal administrator completes the community creation form and submits it to the system. Information included in the form includes: id of designated community manager, name and description of community, status of community.
 +
 +
EIE08.0.8) The community is created as a result of the submission of the community creation form.
 +
 +
2.5.Alternative Flows
 +
 +
Modification of existing community
 +
 +
EIE08.1.1) User is authenticated as a registered user and community manager (for a specified community(ies).
 +
 +
EIE08.1.2) User enters a specific community area
 +
 +
EIE08.1.3) User is presented with an option to manage the community through a link in the community interface.
 +
 +
EIE08.1.4) User selects the community management page.
 +
 +
EIE08.1.5) User provides the needed community management information through the provided management form: i.e. Add datasets, granules, services; modify community area content, manage community membership.
 +
 +
EIE08.1.6) User submits form to portal
 +
 +
EIE08.1.7) Community area of portal is updated with community area modifications.
 +
 +
Deletion of community at request of community managers
 +
 +
EIE08.2.1) User is authenticated as a registered user and community manager (for a specified community(ies).
 +
 +
EIE08.2.2) User enters a specific community area
 +
 +
EIE08.2.3) User is presented with an option to manage the community through a link in the community interface.
 +
 +
EIE08.2.4) User selects the community management page.
 +
 +
EIE08.2.5) User requests that the community be deleted through a form field on the management page.
 +
 +
EIE08.2.6) Portal administrator is authenticated as a portal user and administrator.
 +
 +
EIE08.2.7) Portal administrator reviews request for community deletion.
 +
 +
EIE08.2.8) Portal administrator accesses community management page.
 +
 +
EIE08.2.9) Portal administrator confirms deletion of community through completion of the community deletion form and submission of the form.
 +
 +
EIE08.2.10) Community is deleted from the portal.
 +
 +
Deletion of community by portal administrator.
 +
 +
EIE08.3.1) Portal administrator is authenticated as a portal user and administrator.
 +
 +
EIE08.3.2) Portal administrator accesses community management page.
 +
 +
EIE08.3.3) Portal initiates and confirms the deletion of community through completion of the community deletion form and submission of the form.
 +
 +
EIE08.3.4) Community is deleted from the portal.
 +
 +
2.6.Exceptions
 +
 +
The user designated as the community manager is no longer registered as a user. Notify the portal administrator. A new community manager must be identified, or the portal will be designated as inactive.
 +
 +
Management by an unauthenticated user, or management by a user not designated as the community manager is attempted. Fail, and log the attempt.
 +
 +
2.7.Extension Points
 +
 +
None
 +
 +
2.8.Priority
 +
 +
High.
 +
 +
2.9.Frequency of Use
 +
 +
Invoked infrequently, i.e. Monthly?
 +
 +
2.10.Business Rules
 +
 +
Only registered users are allowed to request the creation of a community.
 +
 +
Only a portal administrator is authorized to create a community.
 +
 +
Designated community manager (users) and portal administrators are authorized to modify existing portals.
 +
 +
Only community managers (users) are authorized to request the deletion of a community.
 +
 +
Only portal administrators are authorized to delete portals or change their status.
 +
 +
2.11.Special Requirements
 +
 +
None
 +
 +
2.12.Assumptions
 +
 +
None
 +
 +
2.13.Notes and Issues
 +
 +
Degree of delegated authority provided to community managers (as opposed to portal administrators) needs to be clearly defined. Being able to delegate all day-to-day management authority to community managers would be highly desireable, but what additional authority should be vested in them?
 +
 +
Community status conditions should be defined to facilitate management: i.e. Active, inactive, public, private, deleted. Use of these status flags will streamline the 'publication' process for community areas.

Revision as of 13:55, January 30, 2006

Use Case EIE08: Manage Working Group (Communities)

for

ESIP Earth Information Exchange








Version 1.0 draft

Prepared by Karl Benedict

Earth Data Analysis Center, University of New Mexico

December 13, 2005

Revision History


Name

Date

Reason For Changes

Version

Karl Benedict

12/13/05

Document created

1






1.Use Case Identification

1.1.Use Case Number

EIE08

1.2.Use Case Name

Manage thematically oriented groups within the portal.

2.Use Case Definition

Support for thematically oriented groups within the portal is important for providing a high level organizational structure to the content and presentation of the materials provided by the portal. This use case documents the capability of portal administrators (Operators) to create topical groups on behalf of users that propose the creation of such communities, and the capability for users (acting in the role of community manager) to manage those communities.

2.1.Actors

Users (role: community manager)

Operators

2.2.Preconditions

1.User’s identity has been authenticated.

2.3.Postconditions

1.A new community has been created, or

2.An existing community has been modified.

2.4.Normal Flow

EIE08.0.1) User is authenticated as a registered user

EIE08.0.2) User accesses a form to request the creation of a new community

EIE08.0.3) User completes the form and submits it for review by the portal administrator.

EIE08.0.4) Portal administrator is authenticated as a registered user and portal administrator

EIE08.0.5) Portal administrator reviews the request

EIE08.0.6) Portal administrator accesses a community creation form.

EIE08.0.7) Portal administrator completes the community creation form and submits it to the system. Information included in the form includes: id of designated community manager, name and description of community, status of community.

EIE08.0.8) The community is created as a result of the submission of the community creation form.

2.5.Alternative Flows

Modification of existing community

EIE08.1.1) User is authenticated as a registered user and community manager (for a specified community(ies).

EIE08.1.2) User enters a specific community area

EIE08.1.3) User is presented with an option to manage the community through a link in the community interface.

EIE08.1.4) User selects the community management page.

EIE08.1.5) User provides the needed community management information through the provided management form: i.e. Add datasets, granules, services; modify community area content, manage community membership.

EIE08.1.6) User submits form to portal

EIE08.1.7) Community area of portal is updated with community area modifications.

Deletion of community at request of community managers

EIE08.2.1) User is authenticated as a registered user and community manager (for a specified community(ies).

EIE08.2.2) User enters a specific community area

EIE08.2.3) User is presented with an option to manage the community through a link in the community interface.

EIE08.2.4) User selects the community management page.

EIE08.2.5) User requests that the community be deleted through a form field on the management page.

EIE08.2.6) Portal administrator is authenticated as a portal user and administrator.

EIE08.2.7) Portal administrator reviews request for community deletion.

EIE08.2.8) Portal administrator accesses community management page.

EIE08.2.9) Portal administrator confirms deletion of community through completion of the community deletion form and submission of the form.

EIE08.2.10) Community is deleted from the portal.

Deletion of community by portal administrator.

EIE08.3.1) Portal administrator is authenticated as a portal user and administrator.

EIE08.3.2) Portal administrator accesses community management page.

EIE08.3.3) Portal initiates and confirms the deletion of community through completion of the community deletion form and submission of the form.

EIE08.3.4) Community is deleted from the portal.

2.6.Exceptions

The user designated as the community manager is no longer registered as a user. Notify the portal administrator. A new community manager must be identified, or the portal will be designated as inactive.

Management by an unauthenticated user, or management by a user not designated as the community manager is attempted. Fail, and log the attempt.

2.7.Extension Points

None

2.8.Priority

High.

2.9.Frequency of Use

Invoked infrequently, i.e. Monthly?

2.10.Business Rules

Only registered users are allowed to request the creation of a community.

Only a portal administrator is authorized to create a community.

Designated community manager (users) and portal administrators are authorized to modify existing portals.

Only community managers (users) are authorized to request the deletion of a community.

Only portal administrators are authorized to delete portals or change their status.

2.11.Special Requirements

None

2.12.Assumptions

None

2.13.Notes and Issues

Degree of delegated authority provided to community managers (as opposed to portal administrators) needs to be clearly defined. Being able to delegate all day-to-day management authority to community managers would be highly desireable, but what additional authority should be vested in them?

Community status conditions should be defined to facilitate management: i.e. Active, inactive, public, private, deleted. Use of these status flags will streamline the 'publication' process for community areas.