The goal

 In translate5 it is possible to assign multiple users to the same workflow step of a task. Usually all of these users have to work on the job and finish it.

With the introduction of the "user crowds", a user

• will only be able to edit a job, after he accepted it (a user is able to open the job for viewing as often as he wants, before he accepts it)
• when he accepts the job, all other users are unassigned automatically and receive an automatic email about their unassignment

A flag in the task properties and on system level in Zf_configuration decides, if task assignments are handled as user crowds or as multiple users in the same workflow step.

Implementation

Task and system property

A Zf_configuration property decides, if multiple task assignments for the same workflow step are handled as "competing users" or "multiple users on the same workflow step". The config is named runtimeOptions.import.initialTaskUsageMode and knows currently the values 'competitive' and 'cooperative'.

The Zf_configuration value decides upon the default value.

In the task properties of translate5 a radio button range with 2 options is implemented.

"When assigning multiple users to same workflow step"

• "Multiple users editing same task"
• "Competing users: First user, who accepts job, does job. Others are unassigned automatically."

The texts translate to German as

"Wenn mehrere Benutzer demselben Workflow-Schritt zugewiesen werden"

• "Mehrere Benutzer bearbeiten dieselbe Aufgabe"
• "Konkurrierende Benutzer: Der erste Benutzer, der einen Job annimmt, führt einen Job aus. Allen anderen wird automatisch die Aufgabe entzogen."

The option in the task properties can only be changed, if no user is assigned to the task. If a user is assigned to the task, the radio buttons are disabled and a message is shown above the radio buttons that reads "Option can only be changed, if no user is assigned". In German: "Diese Option kann nur verändert werden, wenn kein Benutzer der Aufgabe zugewiesen ist."

The radio button is always visible and if the user chooses "Competing users" the initial task state for this task is set automatically to "unconfirmed".

When assigning users to a task

No automatic assignment mail is sent anymore right away after assignment. (just delete the according entry in action table).

If the PM closes the task properties window (and the user associations were changed) a popup pops up and asks the PM if all associated users should be informed. If he clicks on yes, the current action behind the "notify proofreaders" button is triggerd.

The "notify proofreaders" button must be removed then.

The notifyAllAssociatedUsers notification method must  be changed, so that the current hardcoded ROLE_LECTOR filter is removed, but it should be possible to set the affected roles in the action parameters config field in the action table.

IMPORTANT: inform our API using (t5Connect too) clients that the mail must be triggered via API, since no single mail is sent.

For competing user assignments

If the task has more than 1 user assigned for the same workflow step AND the above option is set to "competing users", below the following line in the assignent mail

A task was associated to you in the task-portal URL.

a new line is added that reads:

Attention: Competing users: First user, who accepts job, does job. Others are unassigned automatically..

In German:Achtung: Konkurrierende Benutzer: Der erste Benutzer, der einen Job annimmt, führt einen Job aus. Allen anderen wird automatisch die Aufgabe entzogen.

For multiple users working on the same task

• The button "Notify proofreaders" is removed
• THIS NEEDS TO BE DISCUSSED - MAYBE IT MAKES MORE SENSE TO ALWAYS LIST ALL ASSIGNED USERS AND SET THE ANONYMIZE OPTION BY DEFAULT TO TRUE - A new system config is introduced: "List all assigned users in assignment mails". The default is "true".  If it is set to true, assigned users are listed with their roles and names in the emails. If the anonymize feature is active, this of course will be done anonymized.
  ATTENTION: Notify the company who needs this option about the change.

When opening a task for editing

If the above option is set to "multiple users editing same task"

Everything stays, as it currently is in translate5

If the above option is set to "Competing users: ..."

• A user always has to accept a job first (after opening it) before he can edit it
• The message for accepting a job in translate5 editor GUI  is changed.
  Currently it reads: "Do you want to approve the task? <br> Only an approved task can be edited".
  The following line is added to the message "<br><br> All other users will be unassigned and this will be your sole responsibility."
  In German: "<br><br>Allen anderen Benutzern wird die Aufgabe entzogen und sie wird ausschließlich in Ihrer Verantwortung liegen."
• If the user a accepts a job
  • All other users of the same workflow step are unassigned
  • The unassigned users receive the following email
    • From: Project manager name and email
    • Subject: Another user took the job "taskName"
    • Mail body:
      Dear FIRSTNAME LASTNAME,

another user took responsibility for the job "taskName" at "URL of translate5".

You have automatically been unassigned from the job.

best regards

PROJECT MANAGER NAME

PS.: This is an auto-generated mail

• • German version of the mail
    • From: Name und E-Mail des Projektmanagers
    • Betreff: Ein anderer Benutzer hat den Job "taskName" übernommen
    • E-Mail-Text:
      Lieber Vorname Nachname,

Ein anderer Benutzer hat die Verantwortung für den Job "taskName" unter "URL of translate5" übernommen.

Ihre Zuweisung zum Job wurde Job automatisch entfernt.

Freundliche Grüße

NAME DES PROJEKTMANAGERS

PS .: Dies ist eine automatisch generierte Mail