UC AWOB CM 04 SPEC Invite Consortium Members

MPDL,GAVO

=R0.9=

UC_AWOB_CM_04_2_R0.9Request Membership to Consortium

 * R0.9
 * Make consortium title with an option to request a membership is available for all registered awob users.

Actor

 * 1) Registered AWOB user.

Steps

 * 1) Actor logins in to AWOB.
 * 2) Actor sees a consortium name with a link with an option to request a membership.
 * 3) the link leads to consortium overview page[TBD].
 * 4) Actor selects an option to request.
 * 5) The system displays on the interface the following information to be sent along with the request.
 * 6) All fields should be editable by the actor as necessary.
 * 7)    actor's name
 * 8)    actor's email address
 * 9)    Actor's affiliation
 * 10) for 'Other' show blank.
 * 11) Actor is given an option to enter comment to be sent along with the request.
 * 12) Actor sends the request.
 * 13) The system confirms the action.
 * 14) Actor confirms affirmative or negative.

Post conditions
Actor confirms affirmative.
 * 1) Display the request on the actor’s personal workspace as a ‘pending application or request’
 * 2) also shows when, consortium title, your text sent along with the application
 * 3) Notify the consortium lead & consortium manager of  the consortium to which actor applied.
 * 4)  By
 * 5) email
 * 6) Internal AWOB notification
 * 7) Display the request on the consortium members page something like 'Membership applications' (This option is available only to the consortium lead and the consortium Managers)
 * 8) Who including
 * 9) email
 * 10) name
 * 11) affiliation if exists
 * 12) When
 * 13) the applicant's text.
 * 14) an option to accept/decline the request (see the Respond_to_Application_to_Join_Consortium use case)
 * 15) an option to add comment sent along with the response.
 * 16) Log it in what’s new/progress of the relevant consortium.

UC_AWOB_CM_04_3_R0.9Response to Application to Join Consortium

 * R0.9

Actors

 * 1) Consortium Lead
 * 2) Consortium Manager

Preconditions

 * 1) The system status of consortium is open.

Steps

 * 1) Actor sees an application on the Consortium's members page (something like 'Membership applications').
 * 2) Who applied including
 * 3) name
 * 4) email
 * 5) affiliation
 * 6) When applied
 * 7) Short text (mandatory)
 * 8) The actor is given an option to respond as follows
 * 9) accept or decline.
 * 10) Assign consortium role to the accepted applicant
 * 11) a short reply/comment (optional)
 * 12) The whole membership applications are available only to the actors.
 * 13) Actor submits the response.

Post conditions
The system does the following
 * 1) If accepted
 * 2) Add the applicant to the consortium with the selected role.
 * 3) Notify the applicant of the response to the application.
 * 4) By email including the decision whether approved or not, short comment which sent along
 * 5) In AWOB including the decision whether approved or not
 * 6) Display the response on the applicant’s personal workspace.
 * 7) When
 * 8) Assigned Role
 * 9) Short comment if there is.
 * 10) Response date time
 * 11) Update the application from the consortium's members page.
 * 12) Log the response in what’s new/progress of the consortium.
 * 13) The actual implementation is as follows:
 * 14) There is no display of the response on the applicant's personal workspace.
 * 15) notified by
 * 16) email including the decision whether approved or not, short comment which sent along.
 * 17) awob notification including the decision whether approved or not.

=R0.7=

UC_AWOB_CM_04_1_R0.7Invite Members to Consortium
This spec is the same as what's implemented for project invitation in AWOB release 0.6. The differences are: 3. Please note that if your account is created with an email address different from this one, there will be no invitation waiting on your personal workspace. You can always change the email address for your account later.
 * what was 'project' in project invitation spec is replaced by 'consortium'
 * On the 'sent invitations' table an option to cancel becomes available immediately after an invitation is sent from consortium in the following way:
 * For consortium lead an option to cancel is available to any 'pending' invitation sent from a given consortium.
 * For consortium manager an option to cancel is available to any 'pending' invitation which he/she sent from a given consortium.
 * added the following phrase in the default email invitation text to clarify

Actors

 * Consortium lead
 * Consortium manager

Preconditions

 * Actor can invite members to only a consortium of which system status is  open.

Steps

 * The actor specifies invitees either
 * by choosing one or more Registered Users from the registered users list.
 * by entering email addresses to which wishes to send invitations.
 * allow the actor to put more than one email address per line.
 * The actor selects  awob role which is proposed to invitees.
 * AWOB roles that consortium lead can propose
 * consortium manager


 * consortium member
 * AWOB roles that consortium manager can propose

Dear Colleague,
 * consortium member
 * For the invitation text the actor can do one of the followings.
 * to take the default message without changing it.
 * to select the default message and to update it.
 * to select the last invitation text sent from consortium.
 * to select the last invitation text sent from consortium and update it.
 * The actor submits the invitation.
 * The default text sent to AWOB users.

I would like to invite you to participate in my $full_name $type. A short description of the $full_name $type is as follows:

$short_description

You can accept or decline to join the $type through the invitation waiting on your AWOB personal home.

Best Regards,

$invitor_name $invitor_address where $type is either project, working group, consortium, $full_name and $short_description are title of a selected $type, and its short description, respectively. Dear Colleague,
 * The default text sent to email addresses

I would like to invite you to participate in my $full_name $type. For this $type I have created a collaborative site in the online Astronomer's Workbench (AWOB). You will get access to this $type site if you accept the invitation.

A short description of the $full_name $type is as follows:

$short_description

If you are an AWOB user, you can accept or decline to join the $type through the invitation waiting on your AWOB personal home.

If you are not an AWOB user yet, and do not wish to participate in the $type, please notify me by email of your decision. If you wish to accept the invitation please do the following steps:

1. Please create an AWOB account at $registration_link. 2. If your account is created with this email address, you should find an invitation waiting on your personal dashboard. If not, please notify me of your new AWOB user name by email or using the AWOB messaging functionality. Once I receive your user name, I will invite you again and you can accept the invitation on your AWOB home. 3. Please note that if your account is created with an email address different from this one, there will be no invitation waiting on your personal workspace. You can always change the email address for your account later. You can find information about the AWOB platform at $link_to_awob.

Best Regards,

$invitor_name $invitor_address

Postconditions

 * The system sends email with appropriate invitation text to ALL invitees specified by the actor
 * For an invitations sent to an AWOB user,
 * the invitation is available from the user's personal workspace.
 * the invited AWOB user is notified by AWOB notification.
 * For an invitations sent to an email address entered explicitly by actor
 * if the email address is not identified as an AWOB registered user the system creates a personal workspace for the email address
 * the invitation is available from this workspace
 * the system notifies the invitation in AWOB.
 * On the Collaborators(or Members) page of the consortium invitations sent out appear on "sent invitations"  table.
 * On the 'sent invitations' table an option to cancel becomes available immediately after an invitation is sent from consortium in the following way:
 * For consortium lead an option to cancel is available to any 'pending' invitation sent from a given consortium.
 * For consortium manager an option to cancel is available to any 'pending' invitation which he/she sent from a given consortium.
 * If the invitation text is different from the default text the system stores it as 'the last invitation sent'.
 * the invitation is visible in the What's new of the consortium