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

From Federation of Earth Science Information Partners
m ([BOT] Misspelling correction: | desireable -> desirable)
 
(5 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
 
Use Case EIE08: Manage Working Group (Communities)
 
Use Case EIE08: Manage Working Group (Communities)
  
Line 5: Line 4:
  
 
ESIP Earth Information Exchange
 
ESIP Earth Information Exchange
 
 
 
 
 
 
 
 
 
 
 
 
  
  
Line 31: Line 18:
  
  
 +
=1.Use Case Identification=
  
Name
+
==1.1.Use Case Number==
 
 
Date
 
 
 
Reason For Changes
 
 
 
Version
 
 
 
Karl Benedict
 
 
 
12/13/05
 
 
 
Document created
 
 
 
1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1.Use Case Identification
 
 
 
1.1.Use Case Number
 
  
 
EIE08
 
EIE08
  
1.2.Use Case Name
+
==1.2.Use Case Name==
  
 
Manage thematically oriented groups within the portal.
 
Manage thematically oriented groups within the portal.
  
2.Use Case Definition
+
=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.
 
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
+
==2.1.Actors==
  
Users (role: community manager)
+
*Users (role: community manager)
 +
*Operators
  
Operators
+
==2.2.Preconditions==
  
2.2.Preconditions
+
*1.User’s identity has been authenticated.
  
1.User’s identity has been authenticated.
+
==2.3.Postconditions==
 
 
2.3.Postconditions
 
  
 
1.A new community has been created, or
 
1.A new community has been created, or
Line 88: Line 47:
 
2.An existing community has been modified.
 
2.An existing community has been modified.
  
2.4.Normal Flow
+
==2.4.Normal Flow==
  
EIE08.0.1) User is authenticated as a registered user
+
*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.
  
EIE08.0.2) User accesses a form to request the creation of a new community
+
==2.5.Alternative Flows==
  
EIE08.0.3) User completes the form and submits it for review by the portal administrator.  
+
===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.
  
EIE08.0.4) Portal administrator is authenticated as a registered user and portal administrator
+
===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.
  
EIE08.0.5) Portal administrator reviews the request
+
===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.
  
EIE08.0.6) Portal administrator accesses a community creation form.
+
==2.6.Exceptions==
 
 
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.
 
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.
Line 162: Line 93:
 
Management by an unauthenticated user, or management by a user not designated as the community manager is attempted. Fail, and log the attempt.
 
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
+
==2.7.Extension Points==
  
 
None
 
None
  
2.8.Priority
+
==2.8.Priority==
  
 
High.
 
High.
  
2.9.Frequency of Use
+
==2.9.Frequency of Use==
  
 
Invoked infrequently, i.e. Monthly?
 
Invoked infrequently, i.e. Monthly?
  
2.10.Business Rules
+
==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.
+
*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
+
==2.11.Special Requirements==
  
 
None
 
None
  
2.12.Assumptions
+
==2.12.Assumptions==
  
 
None
 
None
  
2.13.Notes and Issues
+
==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?
+
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 desirable, 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.
 
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.

Latest revision as of 07:19, December 20, 2007

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


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 desirable, 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.