Convert your FHIR JSON -> XML and back here. The CDA Book is sometimes listed for Kindle here and it is also SHIPPING from Amazon! See here for Errata.

Wednesday, November 10, 2010

A best practice for data element descriptions

Once again someone has given me a spreadsheet with two and three word phrases to explain a set of data elements (more than 400 this time).  Yet there is no explanation of each of these items in lay terms.  I can understand them in a general way.  But the challenge for me is when the terms have specific meanings according to the way care is practiced at the institution.  It requires a great deal of back and forth to refine these definitions in ways that implementers will understand.

The C154 HITSP Data Dictionary document executes what I consider to be best practice in this arena.  Each row in the data dictionary includes four items, which are described below1:
    Each data element has an identifier that uniquely identifies it. The first part of the identifier is assigned based upon the module where it is found. The second part of the identifier uniquely identifies the element within the module. As new data elements are created, they are added to the end of the data module. The data element identifiers are persistent and will not be changed or reused between versions of HITSP specifications.
    Each data element has a name that briefly describes the content and purpose of the data element. Data element names may be changed between versions of HITSP specifications to better describe the content and purpose.
    Each HITSP data element has a definition that is intended to precisely describe the purpose and structure of the data element independent from the standards that it may be mapped to. This independence allows HITSP data elements to be mapped to data elements using a variety of standards. The concise definition and mapping to the standards data element also supports harmonization of data across exchanges using different standards. The definition should describe the data element with sufficient enough detail to clearly indicate the purpose and content of the data element.
    In some cases, the data element will have additional restrictions limiting the values that can be communicated within it. HITSP may apply restrictions to a data element when it is communicated. These restrictions could be with regard to its precision, the units, and the range of legal values that may be transmitted or other restrictions as necessary. These will be described in or referred to by this column.

    This column defines universal constraints that apply to data elements regardless of the Base Standard (i.e. HL7 CDA, HL7 V2 messages, NCPDP, etc.) allowing for harmonized constraints across the various Base Standards. Additional data element constraints may also be defined in the CDA-specific sections of this document (2.2.x), or in HITSP Components, Transactions, Transaction Packages or Interoperability Specifications.
I'm sending the spreadsheet back to ask for column 3 and where necessary column 4 to be completed.  I hope that eventually this becomes a recognized practice in the industry.

  -- Keith

1 © 2010 ANSI. This material may be copied without permission from ANSI only if and to the extent that the text is not altered in any fashion and ANSI's copyright is clearly noted.