Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

At the moment, a user can mention another user in a discussion thread by typing '@username'. A notification email will be sent to the mentioned user if his/her Synapse email is open for Synapse Notification emails. 

Use

...

Case

"For one of the consortia (M2OVE-AD) we have one project with multiple working groups. Each working group has a separate team." Mette, who managing/ providing supports to the consortia via Synapse projects and discussion forum, would like to be able to mention a team (or multiple teams) in a discussion thread so that everyone in the mentioned team are aware of the discussion that relevant to them, and invite them to join the discussion. 

More detailed discussion about the use case are captured in 

Jira Legacy
serverJIRA (sagebionetworks.jira.com)
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdba6fb084-9827-3160-8067-8ac7470f78b2
keyPLFM-3875

Requirements

Mentioning a team would work the same way as mentioning a user in a discussion thread including:

  • User type '@team_alias' to start looking for a team they want to mention. 
  • SWC render '@team_alias' with a Team badge.
  • A notification email will be sent to the team if the team 'open to receive emails from the user who did the action.'

Required Services

To meet the requirements above, we still need the services to:

...

Also, teamAlias needs to be exposed, and available in API.

Proposed

...

Solutions for the

...

Missing Services

Option 1 - Add a new service

...

Notification Email Potential Issues

Problem 1 - Redundant

...

Emails

In mentioning a user case, if the user who is mentioned already receive an email because of their subscription, the service will not send them a redundant email.
In mentioning a team, if we send the notification email to the team email address, we would encounter a case where some members subscribed to the forum/thread and already receive an email. The system would just send an email to the team regardless of who is in the team. The notification email via team would be redundant to them. 

Problem 2 - Team's

...

SEND_MESSAGE Permission

Each user can change their profile setting to whether or not they would like to receive notification emails from Synapse. By turning their setting off, they won't receive notification email when someone mentioned them in a thread.

...