Support for multiple roles per organisation in Licenses

Purpose:
A single organisation can fulfil multiple roles in relation to a single license, and this story is to implement the ability to support this effectively

Mockups
New display for an Organization with multiple roles (taken from Agreements, but Licenses display should follow the same pattern)

New edit card for an Organization with multiple roles (taken from Agreements, but Licenses display should follow the same pattern)

Error on trying to link a single Organization multiple times (taken from Agreements, but Licenses display should follow the same pattern)

User story statement(s):

As a e-resource librarian,
I want to be able to record multiple roles for a single organisation
so that it is easy for me to indicate where one organisation plays multiple roles in relation to the license

As a e-resource librarian,
I want to be able to record a note about the organisation in relation to the license
so I can record some general, free text, information about an organisation

As a e-resource librarian,
I want to be able to record a note that relates directly to the role an organisation fulfils in relation to the license
so I can record some free text, information about an organisation fulfilling a specific role

As a e-resource librarian,
I want to be able to see information about an organisation in relation to an license in a glance
so I can easily understand the relationships between the organisation and the license

As a e-resource librarian,
I want to be able to see which is the main organisation to which the license is relevant
so I can easily understand which organisation has the primary role in relation to the license

As a e-resource librarian,
I want to be able define the list of roles that organisations play in relation to an license
so I can record the information I need to in Folio

As a e-resource librarian,
I want to be able record multiple organisations fulfilling the same role in relation to an license, no matter what the role
so the information recorded in Folio reflects the reality of relationships between license and organisations

Scenarios:

1. Scenario:
   • Given Organisations section in license edit screen
   • When I click 'Add organisation'
   • Then the organization card appears
2. Scenario:
   • Given an organisation card
   • Then there is an option to set the organization as the "primary organization"
   • And there is an option to "Link organization"
   • And there is an option to enter an Organization note
   • And there is an option to select a role
   • And there is an option to set a note for the role
   • And there is an option to add another role
3. Scenario:
   • Given an organisation card
   • When I click "Link organization"
   • Then I see the Organizations search plugin
4. Scenario:
   • Given the Organizations search plugin triggered from an Organizations card
   • When I select an Organization in the results list that is not already linked in a card
   • Then the plugin is closed
   • And the card is visible with the organization linked
5. Scenario:
   • Given the Organizations search plugin triggered from an Organizations card
   • When I select an Organization in the results list that is already linked in another card
   • Then the plugin is closed
   • And the organization is not shown in the card
   • And an error message is displayed "<organization name> was not linked because it is already linked to this license"
6. Scenario:
   • Given the Organisation card
   • When I click "add role"
   • Then a new role dropdown and note field are displayed
7. Scenario:
   • Given I select a role in the "role" drop down
   • When that role has already been assigned to the organization in the card
   • Then an error message is displayed "A role can only be assigned to an organisation once within an license"
8. Scenario:
   • Given an Organization card in the Licenses edit view
   • When I check the "Set as Primary organization"
   • Then the check box is checked, and any existing "Set as Primary organization" check box on other Organization cards are cleared (this behaviour can be seen on Organizations -> Contact information addresses)
9. Scenario:
   • Given an Organization card in the Licenses edit view with the "Set as Primary organization" box checked
   • When I click the "Set Primary organization" box
   • Then the check box is unchecked. It is possible for an license to have no primary organization set (this behaviour can be seen on Organizations -> Contact information addresses)
10.  Scenario:
    • Given an license displayed in the license view pane
    • Then I see the name of the primary organization (if one has been selected) in the License summary (in place of the current "Licensor" display)
11. Scenario:
    • Given an license displayed in the license view pane
    • When I open the Organizations accordion
    • Then I see the name of the linked organization
    • And I see if the linked organization is the Primary organization for this license
    • And I see a bulleted list of roles that have been set for the organization in relation to the license
    • And I see any notes recorded against the roles
    • And I see any notes recorded against the organization in relation to the license
    • And I see the interface details from the organization application
12. Scenario:
    • Given an license with a linked organization which has no notes
    • When I open the Organizations accordion
    • Then no notes, or Notes heading displays

Notes:

• All notes fields should be able to hold large amounts of data (not restricted to 255 characters)

Restrictions:

• It should not be possible to link the same organization twice within a single license
• It should not be possible to assign the same role twice to a single organisation

Migration of existing data

All notes on existing Org/License links become (from the users perspective) "role notes" (see mockups)

Where there is an license with the same organization linked multiple times to the same license, this would result (at least from the user perspective) to the license having a single organization with multiple roles. Any notes that were recorded on previous org/role links would become "role notes" (see mockups)

Where there is an Org linked with role "Licensor" this should be migrated to be the "Primary organization"