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

Difference between revisions of "CSCR-069 Rename various ActClassContainer codes"

From HL7Wiki
Jump to navigation Jump to search
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
''('''This is a template. Do not edit!''' Copy and paste source into to a new page)''
 
−
 
−
''('''An announcement of this Change Request must be submitted to the Clinical Statement list to be formally submitted.''')''
 
−
 
 
Editing of Change Requests is restricted to the submitter and the co-chairs of the Clinical Statement Project. Other changes will be undone. Please add comments to the "discussion" page associated with this Change Request.
 
Editing of Change Requests is restricted to the submitter and the co-chairs of the Clinical Statement Project. Other changes will be undone. Please add comments to the "discussion" page associated with this Change Request.
  
 
Back to [[Clinical Statement Change Requests]] page.
 
Back to [[Clinical Statement Change Requests]] page.
 
{|width=100% cellspacing=0 cellpadding=2 border=1
 
{|width=100% cellspacing=0 cellpadding=2 border=1
−
|| '''Submitted by:''' <<Name>>
+
|| '''Submitted by:''' Bob Dolin
−
|| '''Revision date:''' <<Revision Date>>
+
|| '''Revision date:''' Sept 30, 2006
 
|-
 
|-
−
|| '''Submitted date:''' <<Submit Date>>
+
|| '''Submitted date:''' Sept 30, 2006
−
|| '''Change request ID:''' <<Change Request ID>>
+
|| '''Change request ID:''' CSCR-069
 
|-
 
|-
 
|}
 
|}
Line 17: Line 13:
 
== Issue ==
 
== Issue ==
  
 +
The use and meaning of “entry” and “organizer” is not consistent across CDA, Clinical Statement, and the ActClassContainer hierarchy. The intent of this proposal is to realign the various usages. No changes are needed to definitions or to the ActClass hierarchy itself.
 +
 +
 +
CDA uses the notion of “entry” to describe any clinical statement within a document section, and uses “organizer” to name one of the clones in the clinical statement choice box whose ActClass values are limited to either “BATTERY” or “CLUSTER”. CDA never talks about “containers”.
 +
 +
[[Image:CDAOrganizer.jpg]]
 +
 +
 +
Clinical Statement uses “organizer” to name one of the clones in the clinical statement choice box whose ActClass values are anything in the ActClassContainer hierarchy. Clinical Statement doesn’t talk about “entries” or “containers”.
 +
 +
[[Image:ClinicalStatementOrganizer.jpg]]
 +
 +
The current ActClassContainer hierarchy looks like this:
 +
 +
  - ActClassContainer
 +
      - COMPOSITION
 +
        - DOC
 +
      - ENTRY
 +
        - BATTERY
 +
        - CLUSTER
 +
      - EXTRACT
 +
        - EHR
 +
      - FOLDER
 +
      - ORGANIZER
 +
        - CATEGORY
 +
        - DOCBODY
 +
        - DOCSECT
 +
        - TOPIC
  
 
== Recommendation ==
 
== Recommendation ==
−
*  
+
* Submit a RIM Harmonization proposal to rename ActClassContainer codes as shown:
 +
 
 +
  - ActClassContainer --> ActClassOrganizer
 +
      - COMPOSITION
 +
        - DOC
 +
      - ENTRY --> GROUPER
 +
        - BATTERY
 +
        - CLUSTER
 +
      - EXTRACT
 +
        - EHR
 +
      - FOLDER
 +
      - ORGANIZER --> CONTAINER
 +
        - CATEGORY
 +
        - DOCBODY
 +
        - DOCSECT
 +
        - TOPIC
 +
 
 +
* The RIM Harmonization proposal would also change definitions accordingly
  
 
== Rationale ==
 
== Rationale ==
Line 26: Line 67:
 
== Discussion ==
 
== Discussion ==
  
 +
:A code is a meaningless mnemonic of a concept, and in itself has no semantics. Assigning a new code for an existing concept that lready has a code is (from a standardization standpoint) an unnecessary exercise. At most the description of the codes needs to be improved. [[User:Rene spronk|Rene spronk]] 00:04, 2 October 2006 (CDT)
 +
 +
Jan 11, 2007 - While there is general support to change Entry to Grouper, there is concern with flipping Container and Organizer.  The sense is that Container is more generic.  We could consider changing the class name instead from Organizer to Container.
  
 
== Recommended Action Items ==
 
== Recommended Action Items ==
Line 31: Line 75:
  
 
== Resolution ==
 
== Resolution ==
 +
Motion: Prepare a harmonization proposal moving the recommended list to Harmonization: Changes to the labels, only changes to definitions to adjust to the new labels but not the semantic definition of the concepts.  Bob, Patrick
 +
Richard Dixon-Hughes: Concern with 13606 nomenclature that is now not exactly in sync.
 +
<br>
 +
Abstain: 5, Against: 0, In Favor: 30
 +
 +
[Updated during September Meeting as the wiki was out-of-sync with the minutes]

Latest revision as of 19:33, 20 September 2007

Editing of Change Requests is restricted to the submitter and the co-chairs of the Clinical Statement Project. Other changes will be undone. Please add comments to the "discussion" page associated with this Change Request.

Back to Clinical Statement Change Requests page.

Submitted by: Bob Dolin Revision date: Sept 30, 2006
Submitted date: Sept 30, 2006 Change request ID: CSCR-069

Issue

The use and meaning of “entry” and “organizer” is not consistent across CDA, Clinical Statement, and the ActClassContainer hierarchy. The intent of this proposal is to realign the various usages. No changes are needed to definitions or to the ActClass hierarchy itself.


CDA uses the notion of “entry” to describe any clinical statement within a document section, and uses “organizer” to name one of the clones in the clinical statement choice box whose ActClass values are limited to either “BATTERY” or “CLUSTER”. CDA never talks about “containers”.

CDAOrganizer.jpg


Clinical Statement uses “organizer” to name one of the clones in the clinical statement choice box whose ActClass values are anything in the ActClassContainer hierarchy. Clinical Statement doesn’t talk about “entries” or “containers”.

ClinicalStatementOrganizer.jpg

The current ActClassContainer hierarchy looks like this: 

  - ActClassContainer
     - COMPOSITION
        - DOC
     - ENTRY
        - BATTERY
        - CLUSTER
     - EXTRACT
        - EHR
     - FOLDER
     - ORGANIZER
        - CATEGORY
        - DOCBODY
        - DOCSECT
        - TOPIC

Recommendation

  • Submit a RIM Harmonization proposal to rename ActClassContainer codes as shown:
  - ActClassContainer --> ActClassOrganizer
     - COMPOSITION
        - DOC
     - ENTRY --> GROUPER
        - BATTERY
        - CLUSTER
     - EXTRACT
        - EHR
     - FOLDER
     - ORGANIZER --> CONTAINER
        - CATEGORY
        - DOCBODY
        - DOCSECT
        - TOPIC
  • The RIM Harmonization proposal would also change definitions accordingly

Rationale

Discussion

A code is a meaningless mnemonic of a concept, and in itself has no semantics. Assigning a new code for an existing concept that lready has a code is (from a standardization standpoint) an unnecessary exercise. At most the description of the codes needs to be improved. Rene spronk 00:04, 2 October 2006 (CDT)

Jan 11, 2007 - While there is general support to change Entry to Grouper, there is concern with flipping Container and Organizer. The sense is that Container is more generic. We could consider changing the class name instead from Organizer to Container.

Recommended Action Items

Resolution

Motion: Prepare a harmonization proposal moving the recommended list to Harmonization: Changes to the labels, only changes to definitions to adjust to the new labels but not the semantic definition of the concepts. Bob, Patrick Richard Dixon-Hughes: Concern with 13606 nomenclature that is now not exactly in sync.
Abstain: 5, Against: 0, In Favor: 30

[Updated during September Meeting as the wiki was out-of-sync with the minutes]

Retrieved from "https://wiki.hl7.org/w/index.php?title=CSCR-069_Rename_various_ActClassContainer_codes&oldid=14075"