Skip to content

Collaborators ​

A collaborator has access to a negotiation and can view and edit it.

Only the negotiation author can decide who works on it: adding collaborators, removing them, and transferring the negotiation to another user are all reserved for the author. A collaborator may remove themselves from a negotiation at any time.

The feature is behind the FEATURE_FLAG_COLLABORATORS deployment flag and is off by default. When it is disabled, the collaborators section and the Add Collaborator button are hidden.

Add Collaborators ​

The add collaborator feature allows you to add a user to a negotiation as a collaborator by entering their Subject ID.

How to Add a Collaborator ​

  1. Find the Negotiation: Locate the negotiation in the sidebar or list.
  2. Open the Modal:
    • Click the Add Collaborator button (person icon with “Add Collaborator ” label). The button is only shown to the negotiation author.
  3. Enter Subject ID:
    • Type the new collaborator’s Subject ID (e.g., 1001@bbmri.eu) in the Subject ID field.
    • Find the ID on the user’s profile page.
    • Press Enter or click Confirm to submit.
  4. Review the Outcome:
    • Success: A green message shows, e.g., “The user has been added as a collaborator!”.
    • Error: A red error message appears, e.g., “Negotiation or user not found.” Correct the ID and retry.
    • Common errors:
      • “Invalid Subject ID” (wrong or non-existent ID)
      • “Not authorized” (lacking permission)
      • “Negotiation or user not found”
      • “Network error” (connection issue)

Tips ​

  • Verify ID: Check the Subject ID on the user’s profile to avoid errors.
  • Permissions: Ensure you have the required permissions; contact an admin if denied.
  • Connection: Retry if a network error occurs.

Remove Collaborators ​

The remove collaborator feature allows you to remove a collaborator from a negotiation by selecting them from the collaborators list in the negotiation sidebar. After a successful removal, the collaborator will lose access to the negotiation. Note: The negotiation author can remove any collaborator. A collaborator can only remove themselves, which they do with the same button on their own entry in the list.

How to Remove a Collaborator ​

  1. Find the Negotiation: Locate the negotiation in the sidebar or list.
  2. Open the Modal:
    • Click the Remove Collaborator button (red person icon next to the collaborator in the collaborator list).
  3. Confirm Removal:
    • Check the confirmation dialog and click Remove to remove the collaborator.
  4. Review the Outcome:
    • Success: A message shows, e.g., “[username] has been removed as a collaborator.”.

Tips ​

  • Permissions: Ensure you have the required permissions; contact an admin if denied.
  • Connection: Retry if a network error occurs.

Released under the AGPL-3.0 License.