|
|
| (43 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | ==Summary==
| + | Summary: this page contains a proposal to change the Person registry static models with regard to the linking of person records. The proposal effectively also applies to any other role based registry, it's an example of a [[Design Patterns for RIM Models]]. |
| − | This page documents a proposed way (for role-based registries) of dealing with
| |
| − | #the merging of multiple Roles into one single Role. Example: merging a Patient role with a temporary ID (a 'John Doe') with the Patient role which has a permanent ID.
| |
| − | #the unmerging of a Role in multiple Roles. Example: the aforementioned merge of two patient roles was erroneous and needs to be undone.
| |
| | | | |
| − | Note: although the examples used are related to Patient registry the proposed solution is also applicable to all other role based registries. | + | *Note: This page contains the current/open proposal. Past discussions are archived on the [[Talk:Linking and Unlinking of Roles in Registries]] page. |
| | | | |
| − | ==Identity of Roles, modeling aspects==
| + | Note: the HL7 Norway wiki is being migrated, some images/links are still missing. |
| − | One of the main issues to discuss is the meaning of [[Object_identity#Object_Identity_for_Roles|Role Identity]], ''fusion of roles'', ''merging roles'' and ''linking roles''.
| |
| − | *'''Fusion''' is a process whereby two identical Role-objects are fused into one single Role-object.
| |
| − | **Example: if, because of serialization requirements, a receiver has an in-memory object structure which contains the same object twice, these can be fused into one object.
| |
| − | *'''Merging''' is generally understood to be a process where multiple different Role-objects are considered to be ''effectively'' one and the same Role-object, and where one of these Roles is judged to be "the best record" (in terms of richness, identification scheme used, etc.) of the role. If two Role-objects are merged, on of the Role.id attributes is meant to "survive" the merge, the other Role.id can no longer be used after the merge. After the merge it will appear as if the second Role.id never existed at all. Merging is a one -way process, there is no unmerge.
| |
| − | **One could also think of this as a "Replace": upon receipt of a merge message, the receiver is requested to replace all mention/use/references to the old Role (Role.id) with the details of the surviving Role (Role.id). After the replacement the old Role and Role.id will be purged from the system.
| |
| − | *'''Linking''' is is generally understood to be a process where multiple different Role-objects are considered to be ''effectively'' one and the same Role-object. If two Role-objects are linked, both Role-objects, as well as their Role.id attributes, can be used after the linking has taken place.
| |
| − | A link between Roles can be undone by means of an unlink.
| |
| − | **Upon receipt of a link message, the receiver should establish the link between the Role.ids. The application should act as if these are all one Role - even though they are a SET of Roles, each with a different Id. Example: if one of the Role.ids is used in a query, results for that Role.id and all linked Role.ids should be returned in the response.
| |
| | | | |
| − | ===Linking Role IDs=== | + | ==Proposal== |
| − | The current mechanism for associating IDs (previously associated with different roles) with a Role is by means of the so-called OtherIds modeling pattern.
| + | This page proposes a number of changes: |
| | + | #See [http://www.hl7.no/hl7wiki/index.php?title=Identification_of_Patients_and_Persons#HL7_version_3_model] for documentation of the modeling principles used to link Person Records - this model is the outcome of prior discussions (see above for a link to the documentation associated with that discussion) |
| | + | #PA D-MIM: add identifiedBy and OtherIdentifiedPerson classes, as shown in the R-MIM model on this wiki page: [http://www.hl7.no/hl7wiki/index.php?title=PersonRegistry.LinkPersonRecords]. |
| | + | #*Discussion PA Sept. 1011: in UV model, add optional recursive RoleLink IDENT on OtherIdentifiedperson. Helen: add recursion on IdentifiedPerson ? Rene: has the effect that scoper becomes required for all roles in the IDENT link. Helen: or make scoper of IdentifiedPerson optional ? Rene: ask MnM and PA lists. ACTION Jay to do so. |
| | + | #Add an R-MIM and interaction for a new LinkPersonRecords interaction with an application acknowledgement, see [http://www.hl7.no/hl7wiki/index.php?title=PersonRegistry.LinkPersonRecords] |
| | + | #Add an R-MIM and interaction for a new UnlinkPersonRecords interaction with an application acknowledgement, see [http://www.hl7.no/hl7wiki/index.php?title=PersonRegistry.UnlinkPersonRecords]. |
| | + | #Add the identifiedBy and OtherIdentifiedPerson classes to the response interaction of the GetPersondemographics interaction, to expose any linkages in the response, see [http://www.hl7.no/hl7wiki/index.php?title=PersonRegistry.GetDemographics] |
| | + | #Discuss whether the guidance provided in the Norwegian project related to the collapsing (transitivity of) linkages in section [http://www.hl7.no/hl7wiki/index.php?title=Identification_of_Patients_and_Persons#Method_of_linking_identifiers] is universallay applicable or whether such guidance is project specific. |
| | | | |
| − | [[Image:Patreg otherids.PNG]]
| + | PA Sept 2011: request to send link to Norwegian wiki to PA list. |
| | | | |
| − | Example: the entity plays aRole, but also has multiple OtherIDs (a role with an id attribute). aRole is the primary role, OtherIDs (as the name indicates) contains the other IDs. The entire set of IDs is 'linked' via the entity.
| + | PA MOTION: (see minutes) PA agrees with direction. |
| − | | |
| − | ===Role equivalence===
| |
| − | The RIM also offers one top specify that one Role is "identical" (for lack of better word) to another one, by means of the IDENT RoleLink.
| |
| − | | |
| − | *From the RIM (RoleLinkType coding system): '''IDENT''': ''The source role provides identification for the target role. The source role must be IDENT. The player entity of the source role is constrained to be the same as the player of the target role if present. If the player is absent from the source role, then it is assumed to be the same as the player of the target role.''
| |
| − | | |
| − | [[Image:Patreg ident.PNG]]
| |
| − | | |
| − | Example: Role1 (with a temporary patient ID) has an IDENT RoleLink with Role2 (with the permament patient ID). This means that Role1 (with Role1.id) identifies Role2 (with Role2.id). Effectively this establishes a link between Role1.id and Role2.id. The RoleLink.effectiveTime.high attribute could be used to terminate the IDENT RoleLink, which terminates the linkage.
| |
| − | | |
| − | ==Role based registries, modeling aspects==
| |
| − | ===The nature of Role based Registries===
| |
| − | The registry functionality provided in HL7 is based on a model which contains a RegistrationProcess (REG) Act, with a subject Role.
| |
| − | | |
| − | [[Image:Patreg 1.PNG]]
| |
| − | | |
| − | The RegistrationProcess contains meta-information related to the registered Role (e.g. the author of the registration, the validity of the registration). Where document registries maintain a set of document metadata (as well as the document itself) throughout the document lifecycle, Role registries maintain a set of metadata (as well as the details of the Role) throughout the Role lifecycle.
| |
| − | | |
| − | Registrationprocess.statusCode contains the status of the registration. If 'active' the registration and its subject Role are to be considered valid-for-use; if 'obsolete' the registration and its subject Role are to be considered not valid (obsoleted, replaced by a different RegistrationProcess act and another Role).
| |
| − | | |
| − | Example: a Patient registry contains Patient Registrations (a combination of the RegistrationProcess Act and the Patient Role details). Only those registrations that are 'active' will be inlcluded in the potential result set for the query.
| |
| − | | |
| − | ===Linking of registrations===
| |
| − | Role based registries support the concept of merging roles (e.g. Patient Registry Duplicates Resolved(PRPA_IN201304UV02)). One doesn't actually merge roles; the existing Roles remain 'active'. The ID attributes (and perhaps some of the associated demographics details) are used (after the merge) in one single Role (''the top one in the figure below''). The non-surviving Role is modeled (''as the bottommost act and role'') as an 'obsoleted' registration act.
| |
| − | | |
| − | [[Image:Patreg merge 1.PNG]]
| |
| − | | |
| − | RegistrationProcess.id is optional, quite a few registries identify the applicable RegistrationProcess act by means of the Role.id attribute of the Role. If a registry doesn't use RegistrationProcess.id it can not contain multiple instances of the same Role (it's a SET of Roles, not a BAG or Roles).
| |
| − | | |
| − | | |
| − | ==Example use-case==
| |
| − | This section documents a use-case from the Norwegian Patient Registry project. The use-case is referenced in the remaining sections of this proposal.
| |
| − | | |
| − | If the central registry has two patient records:
| |
| − | -regsitrationact 1, Role.id A1, registrationAct.statusCode active
| |
| − | -registrationAct 2, Role.id B1, registrationAct.statusCode active
| |
| − | | |
| − | OPTION 1 - We merge these using duplicates resolved, we get (registrationAct 1 replaces registrationAct2):
| |
| − | -regsitrationact 1, Role.id A1, OtherId B1, registrationAct.statusCode active
| |
| − | -registrationAct 2, Role.id B1, registrationAct.statusCode obsolete
| |
| − | | |
| − | OPTION 2 - We merge these using duplicates resolved, we get (new registrationAct 3 replaces registrationAct2; registrationAct 3 also replaces registrationAct1):
| |
| − | -regsitrationact 1, Role.id A1, registrationAct.statusCode obsolete
| |
| − | -registrationAct 2, Role.id B1, registrationAct.statusCode obsolete
| |
| − | -registrationAct 3, Role.id A1, OtherIDs B1, registrationAct.statusCode obsolete
| |
| − | | |
| − | Is option 1, or option 2, the proper way to do things? Both would probably work..
| |
| − | | |
| − | There are Norwegian use-cases for UNmerging/Unlinking. Our current registry material is silent on that subject. If the statusCode of an (registration)Act is obselete, we can't reactivate. Therefore, unlinking A1 and B1 (in the above example) requires that we obsolete all registrations that have A1 or B1 in either Role.id or OtherIds.id, and create two entirely new registrationActs:
| |
| − | -registrationAct 98, Role.id A1, registrationAct.statusCode active
| |
| − | -registrationAct 99, Role.id B1, registrationAct.statusCode active
| |
| − | | |
| − | So that would be two new registrationActs, that (as a group with 2 components) replaces a group of existing registrations (i.e. all registrations related to A1 and B1).
| |
| − | | |
| − | Maybe we need just one interaction: "replaceRegistration". That's effectively what both Duplicatesresolved and Unmerge accomplish.
| |
