PubMan Func Spec History of affiliations

Introduction
Authors of items in PubMan are affiliated to one or more organizational units. These organizational units can merge into other organizational units, i.e. an organizational unit can have one or more predecessors and/or one or more successors.

Following types of relations are maintained:


 * An OU(1) has one direct successor OU(2) and not exists anymore in reality. The OU(1) is set in status closed (replacement).
 * An OU is founded as fusion from two or more other OUs (fusion). The new OU has multiple predecessors.
 * A part of an OU(1) is created as spin-off. The OU(1) exists beside the new OU(2) (spin-off).
 * An OU(1) is split-up into multiple new OUs (OU(3), OU(4), …) and has therefore multiple successors. OU(1) not exist in reality any longer and is therefore set to status ‘closed’. (splitting)

Examples:
x, y and z are Organizational Units

Example 1: Replacement

 * x replaces y
 * x haspredecessor:replacement y
 * This relation will be created
 * y hassuccessor:replacement x
 * This relation will be derived

Example 2: Fusion

 * x + y fusion to z
 * z haspredecessor:fusion x and z haspredecessor:fusion y
 * these two relations will be created
 * z issuccessorof:fusion x and z issuccessorof:fusion y
 * these two relations will be derived

Example 3: Spin-off

 * x is spin-off of y
 * x haspredecessor:spin-off y (y still exists)
 * this relation will be created
 * y hassuccessor:spin-off x (y still exists)
 * this relation will be derived

Example 4: Splitting

 * x is split into y + z
 * z haspredecessor:split x and y haspredecessor:split x
 * these two relations will be created
 * x hassuccessor:split z and x hassuccessor:split y
 * these two relations will be derived

=Scenarios=

The user wants to track the history of an organizational unit. This affects browsing, search, organizational unit management, and view item version.

Status/Schedule

 * Status: implemented
 * Schedule:R5

Triggers

 * The service administrator wants to specify how an organizational unit has been created (e.g. as a replacement, fusion, spin-off or splitting of another organizational unit).

Actors

 * Service administrator

Flow of Events

 * The user selects one organizational unit for editing, adds one or more organizational units from the organizational unit structure and specifies the exact form of the event.


 * See UC_PM_OUM_06 Add predecessor to organizational unit for more details.

Post-Conditions/Results

 * Added organizational units are related as predecessors of the selected organizational unit. The selected organizational unit is therefore a successor of all in this manner related organizational units.
 * The information is shown in the organizational unit edit view and the organizational unit detail view. See future development of the detailed view.

Status/Schedule

 * Status: in specification
 * Schedule: tbd

Requirements

 * The service administrator can also specify one or multiple successors of the organizational unit and their relation (replacement, fusion, spin-off or splitting) to the organizational unit.

Status/Schedule

 * Status: in specification
 * Schedule: tbd

Triggers

 * The user wants to search for items of a specific organizational unit (implemented) and its successor(s)/predecessor(s).

Actors

 * User

Flow of Events

 * The user chooses to do an advanced search.
 * The user chooses an organizational unit from the browse tree (implemented).
 * A search result list is displayed showing all items of the selected organizational unit and its children (implemented).
 * From the search result list view, the user can add single or multiple successors/predecessors or all successors/predecessors of the organizational unit to the search.
 * See UC_PM_SR_03 Do advanced search for more details.

Post-Conditions/Results

 * The user can see all items of the chosen organizational unit and the chosen successor(s)/predecessor(s) of the organizational unit.

Status/Schedule

 * Status: in specification
 * Schedule: tbd

Triggers

 * The user wants to browse by organizational unit (implemented) and the respective successor(s)/predecessor(s) of the organizational unit.

Actors

 * User

Flow of Events

 * The user chooses an oranizational unit from the browse tree.
 * In the organizational unit structure the user can choose an organizational unit detail view to view a description. (implemented)
 * Information on all predecessors of the selected organizational unit is also provided in the detailed view (implemented). See future development of the detailed view.


 * The user wants to see all items of an organizational unit. Choosing an organizational unit in the organizational unit structure, a search result list is displayed showing all items of the selected organizational unit and its children. (implemented)
 * From the search result list view, the user can choose to add the items of single, multiple or all available predecessor(s)/successor(s) of the organizational unit to the search result.


 * See UC_PM_BD_03 Browse by organizational unit for more details.

Post-Conditions/Results

 * The user can see all items of the chosen organizational unit and the chosen predecessor(s)/successor(s) of the organizational unit.

Status/Schedule

 * Status: implemented
 * Schedule: R5

Triggers

 * The user wants to view detailed information on an organizational unit that is linked to an author of an item in the item view.

Actors

 * User

Flow of Events

 * The user chooses the item view of an item.
 * A link shows the organizational unit detail view of the selected organizational unit. (implemented)
 * The organizational detail view also shows the predecessor(s) of the organizational unit. (implemented)
 * See UC_PM_BD_04 View item version for more details.

Post-Conditions/Results

 * The user sees the organizational unit detail view with the respective predecessor organization(s) of the organizational unit.
 * In R5 this information regarding the history of affiliations contains the name(s) of the predecessor organizational unit(s) of the respective organizational unit.

Status/Schedule

 * Status: in specification
 * Schedule: tbd

Requirements

 * The organisational unit detail view also shows the successor organizational unit(s) of the selected organizational unit.
 * The organizational unit detail view also shows the type of relation of the predecessor and successor organizational unit(s) to the organizational unit (e.g. organization x was replaced by organization y).
 * The organizational unit detail view shows StartDate/EndDate of the related affiliations of the selected organizational unit.