This wiki has undergone a migration to Confluence found Here
<meta name="googlebot" content="noindex">

Difference between revisions of "Proposal: New AdministrativeContactRoleType Codes"

From HL7Wiki
Jump to navigation Jump to search
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
Return to [[Patient_Administration]]
 
Return to [[Patient_Administration]]
  
'''Proposal Name: New codes for EducationLevel code system'''
+
'''Proposal Name: New PersonalRelationshipRoleType codes'''
  
 
{|width=100% cellspacing=0 cellpadding=2 border=1
 
{|width=100% cellspacing=0 cellpadding=2 border=1
Line 22: Line 22:
 
|| D
 
|| D
 
|| Concept Domains
 
|| Concept Domains
|| 3
+
|| 2
 
||
 
||
 
||
 
||
Line 34: Line 34:
 
|| C
 
|| C
 
|| Concept Codes in a Code System
 
|| Concept Codes in a Code System
|| 9
+
|| 3
 
||
 
||
 
|| 12
 
|| 12
Line 46: Line 46:
 
|| B
 
|| B
 
|| Context Binding
 
|| Context Binding
|| 2
+
|| 1
 
||
 
||
 
||
 
||
Line 53: Line 53:
  
 
== Summary Recommendation==
 
== Summary Recommendation==
Add additional concepts to the EducationLevel code system.
+
Add several concept domains related to PAFM content and add some new codes to personal relationship, while tweaking the hierarchy.
  
 
== Issue ==
 
== Issue ==
Needs to capture additional levels of education.
+
The AssignedRoleType and PersonalRelationshipRoleType concept domains are referenced in PAFM ballot material but don’t actually exist.
 +
 
 +
In addition, there’s a need for a “higher level” code to deal with extended family relationships that doesn’t involve fully qualifying them and a need to be able to identify son or daughter without distinguishing whether they’re natural, foster, adopted, etc.
 +
 
 +
As well, Roommate is currently captured as a family member, when there’s no familial relationship in the role or definition.  Domestic Partner is another type of significant other.  (If they weren’t a significant other, they wouldn’t be a domestic partner, just a roommate.)
  
 
== Current State ==
 
== Current State ==
 +
 +
AssignedRoleType value set description:
 +
 +
A role type that is used to further qualify an entity playing a role where the role class attribute is set to RoleClass AssignedEntity. The suggested values from V2.x include clinic receptionist, referral agent, staff physician, courtesy physician, resident, physician assistant, physical therapist, psychiatrist, psychologist, pharmacist, registered nurse, licensed practical nurse, licensed vocational nurse, nurse practitioner, etc.
 +
 +
Examples: Janitor, Chief of Staff, Referral Agent, Security Guard, ICU Runner,Visiting professor
 +
PersonalRelationshipRoleType value set description:
 +
 +
Types of personal relationships between two living subjects.
 +
 +
Example: Parent, sibling, unrelated friend, neighbor
 +
 +
RoleCode
 +
  FAMMEMB (Family Member)
 +
    AUNT* (aunt)
 +
    CHILD (Child)
 +
      SONC (Son)
 +
      SONADOPT (adopted son)
 +
      SONFOST (foster son)
 +
      SON (natural son)
 +
      STPSON (stepson)
 +
      DAUC (Daughter)
 +
      DAUADOPT (adopted daughter)
 +
      DAUFOST (foster daughter)
 +
      DAU (natural daughter)
 +
      STPDAU (stepdaughter)
 +
      CHLDADOPT (adopted child)
 +
      DAUADOPT (adopted daughter)
 +
      SONADOPT (adopted son)
 +
      CHLDFOST (foster child)
 +
      DAUFOST (foster daughter)
 +
      SONFOST (foster son)
 +
      CHLDINLAW (child in-law)
 +
      DAUINLAW (daughter in-law)
 +
      SONINLAW (son in-law)
 +
      NCHILD (natural child)
 +
      DAU (natural daughter)
 +
      SON (natural son)
 +
      STPCHLD (step child)
 +
      STPDAU (stepdaughter)
 +
      STPSON (stepson)
 +
    COUSN* (cousin)
 +
    DOMPART (domestic partner)
 +
    GGRPRN* (great grandparent)
 +
    GRNDCHILD* (grandchild)
 +
    GRPRN* (Grandparent)
 +
    NIENEPH* (niece/nephew)
 +
    PRN* (Parent)
 +
    ROOM (Roomate)
 +
    SIB* (Sibling)
 +
    SIGOTHR (significant other)
 +
      SPS (spouse)
 +
    UNCLE* (uncle)
 +
    FRND (unrelated friend)
 +
    NBOR (neighbor)
 +
 +
* Note: Some children have been excluded from the hierarchy because they’re not relevant to the current proposal.
  
 
== Rationale ==
 
== Rationale ==
Line 64: Line 125:
  
 
== Recommendation Details ==
 
== Recommendation Details ==
Need to add the following codes in bold to the EducationLevel code system:
+
1. Create a concept domain called AssignedRoleType under RoleCode with the definition currently found in the AssignedRoleType value set.  Delete the AssignedRoleType value set.  (The set of codes in the value set are not representative and do not provide even reasonable example coverage of the breadth of the concept domain.)
 +
 
 +
 
 +
2. Create a concept domain called PersonalRelationshipRoleType under RoleCode with the definition currently found in the PersonalRelationshipRoleType value set.  Create a representative binding from the new concept domain to the existing value set.
 +
 
 +
 
 +
3. Modify the ActRole table as follows:
 +
 
 +
ActRole
 +
  FAMMEMB (Family Member)
 +
  <strike>AUNT* (aunt)</strike>
 +
  CHILD (Child)
 +
    '''SONC (Son)'''
 +
    SONADOPT (adopted son)
 +
    SONFOST (foster son)
 +
    SON (natural son)
 +
    STPSON (stepson)
 +
    '''DAUC (Daughter)'''
 +
    DAUADOPT (adopted daughter)
 +
    DAUFOST (foster daughter)
 +
    DAU (natural daughter)
 +
    STPDAU (stepdaughter)
 +
    CHLDADOPT (adopted child)
 +
    DAUADOPT (adopted daughter)
 +
    SONADOPT (adopted son)
 +
    CHLDFOST (foster child)
 +
    DAUFOST (foster daughter)
 +
    SONFOST (foster son)
 +
    CHLDINLAW (child in-law)
 +
    DAUINLAW (daughter in-law)
 +
    SONINLAW (son in-law)
 +
    NCHILD (natural child)
 +
    DAU (natural daughter)
 +
    SON (natural son)
 +
    STPCHLD (step child)
 +
    STPDAU (stepdaughter)
 +
    STPSON (stepson)
 +
  '''EXT (extended family member)'''
 +
    AUNT* (aunt)
 +
    <strike>DOMPART (domestic partner)</strike>
 +
    COUSN* (cousin)
 +
    GGRPRN* (great grandparent)
 +
    GRNDCHILD* (grandchild)
 +
    GRPRN* (Grandparent)
 +
    NIENEPH* (niece/nephew)
 +
    UNCLE* (uncle)
 +
  PRN* (Parent)
 +
  <strike>ROOM (Roommate)</strike>
 +
  SIB* (Sibling)
 +
  SIGOTHR (significant other)
 +
    DOMPART (domestic partner)
 +
    SPS (spouse)
 +
  FRND (unrelated friend)
 +
  NBOR (neighbor)
 +
  ROOM (Roommate)
 +
 
 +
* Note: Some children have been excluded from the hierarchy because they’re not relevant to the current proposal.  Relationships with descendant codes not shown remain unchanged by this proposal.
 +
 
 +
Descriptions:
 +
SONC: The player of the role is a male child (of any type) of scoping entity (parent)
 +
DAUC: The player of the role is a female child (of any type) of scoping entity (parent)
 +
EXT: A family member outside the immediate family unit, not having a direct genetic or legal relationship e.g. Aunt, cousin, great grandparent, grandchild, grandparent, niece, nephew or uncle.
  
EducationLevel
+
This code system is used in the attribute is PersonalRelationship.code within the PersonalRelationship Role Class (Client Registry models).
      ASSOC (Associate's or technical degree complete)  
 
      BD (College or baccalaureate degree complete)
 
      ELEM (Elementary School)
 
      GD (Graduate or professional Degree complete)
 
      HS (High School or secondary school degree complete)
 
      '''JHS (Junior High School)'''
 
      PB (Some post-baccalaureate education)
 
      POSTG (Doctoral or post graduate education)
 
      SCOL (Some College education)
 
      SEC (Some secondary or high school education)
 
      '''SJHS (Some Junior High School)'''
 
      '''UNK (Unknown Education Level)'''
 
  
This code system is used in the Person.educationLevelCode attribute in the PRPA_RM201301UV model and the PRPA_IN201311UV02 (Patient Registry Add Request) and PRPA_MT201301UV02 is the message payload.
+
== Discussion==
 +
If we wanted to, we could group CHILD, PRN, SIB and SIGOTHR under a concept of “Immediate Family”.  We don’t have a use-case for that code, but have no problem amending the proposal to introduce the concept.
  
 
== Recommended Action Items ==
 
== Recommended Action Items ==

Latest revision as of 19:44, 19 March 2009

Return to Patient_Administration

Proposal Name: New PersonalRelationshipRoleType codes

Submitted by: Wendy Huang Revision date: March 18, 2009
Submitted date: March 18, 2009 Recommendation ID: CA-200904-24

Vocabulary Object Change Summary

Abbrev. Description: # to add: # to remove: # to change:
D Concept Domains 2
S Code Systems
C Concept Codes in a Code System 3 12
V Value Set 1
B Context Binding 1

Summary Recommendation

Add several concept domains related to PAFM content and add some new codes to personal relationship, while tweaking the hierarchy.

Issue

The AssignedRoleType and PersonalRelationshipRoleType concept domains are referenced in PAFM ballot material but don’t actually exist.

In addition, there’s a need for a “higher level” code to deal with extended family relationships that doesn’t involve fully qualifying them and a need to be able to identify son or daughter without distinguishing whether they’re natural, foster, adopted, etc.

As well, Roommate is currently captured as a family member, when there’s no familial relationship in the role or definition. Domestic Partner is another type of significant other. (If they weren’t a significant other, they wouldn’t be a domestic partner, just a roommate.)

Current State

AssignedRoleType value set description:

A role type that is used to further qualify an entity playing a role where the role class attribute is set to RoleClass AssignedEntity. The suggested values from V2.x include clinic receptionist, referral agent, staff physician, courtesy physician, resident, physician assistant, physical therapist, psychiatrist, psychologist, pharmacist, registered nurse, licensed practical nurse, licensed vocational nurse, nurse practitioner, etc.

Examples: Janitor, Chief of Staff, Referral Agent, Security Guard, ICU Runner,Visiting professor PersonalRelationshipRoleType value set description:

Types of personal relationships between two living subjects.

Example: Parent, sibling, unrelated friend, neighbor

RoleCode

 FAMMEMB (Family Member)
   AUNT* (aunt)
   CHILD (Child)
     SONC (Son)
      SONADOPT (adopted son)
      SONFOST (foster son)
      SON (natural son)
      STPSON (stepson)
     DAUC (Daughter)
      DAUADOPT (adopted daughter)
      DAUFOST (foster daughter)
      DAU (natural daughter)
      STPDAU (stepdaughter)
     CHLDADOPT (adopted child)
      DAUADOPT (adopted daughter)
      SONADOPT (adopted son)
     CHLDFOST (foster child)
      DAUFOST (foster daughter)
      SONFOST (foster son)
     CHLDINLAW (child in-law)
      DAUINLAW (daughter in-law)
      SONINLAW (son in-law)
     NCHILD (natural child)
      DAU (natural daughter)
      SON (natural son)
     STPCHLD (step child)
      STPDAU (stepdaughter)
      STPSON (stepson)
   COUSN* (cousin)
   DOMPART (domestic partner)
   GGRPRN* (great grandparent)
   GRNDCHILD* (grandchild)
   GRPRN* (Grandparent)
   NIENEPH* (niece/nephew)
   PRN* (Parent)
   ROOM (Roomate)
   SIB* (Sibling)
   SIGOTHR (significant other)
     SPS (spouse)
   UNCLE* (uncle)
   FRND (unrelated friend)
   NBOR (neighbor)
  • Note: Some children have been excluded from the hierarchy because they’re not relevant to the current proposal.

Rationale

See Issue

Recommendation Details

1. Create a concept domain called AssignedRoleType under RoleCode with the definition currently found in the AssignedRoleType value set. Delete the AssignedRoleType value set. (The set of codes in the value set are not representative and do not provide even reasonable example coverage of the breadth of the concept domain.)


2. Create a concept domain called PersonalRelationshipRoleType under RoleCode with the definition currently found in the PersonalRelationshipRoleType value set. Create a representative binding from the new concept domain to the existing value set.


3. Modify the ActRole table as follows:

ActRole

 FAMMEMB (Family Member)
  AUNT* (aunt)
  CHILD (Child)
   SONC (Son)
    SONADOPT (adopted son)
    SONFOST (foster son)
    SON (natural son)
    STPSON (stepson)
   DAUC (Daughter)
    DAUADOPT (adopted daughter)
    DAUFOST (foster daughter)
    DAU (natural daughter)
    STPDAU (stepdaughter)
   CHLDADOPT (adopted child)
    DAUADOPT (adopted daughter)
    SONADOPT (adopted son)
   CHLDFOST (foster child)
    DAUFOST (foster daughter)
    SONFOST (foster son)
   CHLDINLAW (child in-law)
    DAUINLAW (daughter in-law)
    SONINLAW (son in-law)
   NCHILD (natural child)
    DAU (natural daughter)
    SON (natural son)
   STPCHLD (step child)
    STPDAU (stepdaughter)
    STPSON (stepson)
  EXT (extended family member)
    AUNT* (aunt)
    DOMPART (domestic partner)
    COUSN* (cousin)
    GGRPRN* (great grandparent)
    GRNDCHILD* (grandchild)
    GRPRN* (Grandparent)
    NIENEPH* (niece/nephew)
    UNCLE* (uncle)
  PRN* (Parent)
  ROOM (Roommate)
  SIB* (Sibling)
  SIGOTHR (significant other)
    DOMPART (domestic partner)
    SPS (spouse)
 FRND (unrelated friend)
 NBOR (neighbor)
 ROOM (Roommate)
  • Note: Some children have been excluded from the hierarchy because they’re not relevant to the current proposal. Relationships with descendant codes not shown remain unchanged by this proposal.

Descriptions: SONC: The player of the role is a male child (of any type) of scoping entity (parent) DAUC: The player of the role is a female child (of any type) of scoping entity (parent) EXT: A family member outside the immediate family unit, not having a direct genetic or legal relationship e.g. Aunt, cousin, great grandparent, grandchild, grandparent, niece, nephew or uncle.

This code system is used in the attribute is PersonalRelationship.code within the PersonalRelationship Role Class (Client Registry models).

Discussion

If we wanted to, we could group CHILD, PRN, SIB and SIGOTHR under a concept of “Immediate Family”. We don’t have a use-case for that code, but have no problem amending the proposal to introduce the concept.

Recommended Action Items

MnM to implement recommendation

Resolution