如何创建可导入Apple Health的HL7标准CDA文件及获取有效示例

常规体检CDA核心结构示例 #

Apple Health对CDA导入有特定合规要求，以下是简化的常规体检CDA片段，确保核心字段符合Apple解析规则：

<?xml version="1.0" encoding="UTF-8"?>
<ClinicalDocument xmlns="urn:hl7-org:v3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hl7-org:v3 CDA.xsd">
  <realmCode code="US"/>
  <typeId root="2.16.840.1.113883.1.3" extension="POCD_HD000040"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.1"/> <!-- 体检摘要模板ID -->
  <id root="unique-id-here" extension="12345"/>
  <code code="30954-2" codeSystem="2.16.840.1.113883.6.1" displayName="General adult medical examination"/>
  <title>常规体检报告</title>
  <effectiveTime value="20240520"/>
  <recordTarget>
    <patientRole>
      <patient>
        <name>
          <given>张三</given>
          <family>张</family>
        </name>
        <administrativeGenderCode code="M" codeSystem="2.16.840.1.113883.5.1"/>
        <birthTime value="19800101"/>
      </patient>
    </patientRole>
  </recordTarget>
  <component>
    <structuredBody>
      <component>
        <section>
          <templateId root="2.16.840.1.113883.10.20.22.2.1"/> <!-- 生命体征模板ID -->
          <code code="8716-3" codeSystem="2.16.840.1.113883.6.1" displayName="Vital signs"/>
          <title>生命体征</title>
          <entry>
            <observation classCode="OBS" moodCode="EVN">
              <code code="8302-2" codeSystem="2.16.840.1.113883.6.1" displayName="Body temperature"/>
              <effectiveTime value="202405201030"/>
              <value unit="°C" value="36.5" xsi:type="PQ"/>
            </observation>
          </entry>
        </section>
      </component>
    </structuredBody>
  </component>
</ClinicalDocument>

• 关键注意事项：
  • 必须使用urn:hl7-org:v3命名空间
  • 模板ID需匹配HL7官方体检相关模板（如示例中的2.16.840.1.113883.10.20.22.1.1）
  • 患者姓名、性别、生日信息必须完整，Apple Health依赖这些匹配用户账户
  • 所有医学代码需使用LOINC等标准编码系统

晚间用药计划CDA核心结构示例 #

<?xml version="1.0" encoding="UTF-8"?>
<ClinicalDocument xmlns="urn:hl7-org:v3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:hl7-org:v3 CDA.xsd">
  <realmCode code="US"/>
  <typeId root="2.16.840.1.113883.1.3" extension="POCD_HD000040"/>
  <templateId root="2.16.840.1.113883.10.20.22.1.2"/> <!-- 用药计划模板ID -->
  <id root="unique-med-plan-id" extension="67890"/>
  <code code="10160-0" codeSystem="2.16.840.1.113883.6.1" displayName="Medication list"/>
  <title>晚间用药计划</title>
  <effectiveTime value="20240520"/>
  <recordTarget>
    <patientRole>
      <patient>
        <name>
          <given>张三</given>
          <family>张</family>
        </name>
        <administrativeGenderCode code="M" codeSystem="2.16.840.1.113883.5.1"/>
        <birthTime value="19800101"/>
      </patient>
    </patientRole>
  </recordTarget>
  <component>
    <structuredBody>
      <component>
        <section>
          <templateId root="2.16.840.1.113883.10.20.22.2.1.1"/> <!-- 用药条目模板ID -->
          <code code="10160-0" codeSystem="2.16.840.1.113883.6.1" displayName="Medication list"/>
          <title>晚间用药明细</title>
          <entry>
            <substanceAdministration classCode="SBADM" moodCode="INT">
              <templateId root="2.16.840.1.113883.10.20.22.4.16"/> <!-- 口服药物模板ID -->
              <code code="386661001" codeSystem="2.16.840.1.113883.6.96" displayName="Oral administration of medication"/>
              <statusCode code="active"/>
              <effectiveTime>
                <period value="1" unit="d"/>
                <repeatNumber value="1"/>
                <time value="2000"/> <!-- 晚间20:00 -->
              </effectiveTime>
              <consumable>
                <manufacturedProduct>
                  <manufacturedMaterial>
                    <code code="317208" codeSystem="2.16.840.1.113883.6.88" displayName="Lisinopril 10 MG Oral Tablet"/>
                  </manufacturedMaterial>
                </manufacturedProduct>
              </consumable>
              <doseQuantity value="1" unit="TAB"/>
            </substanceAdministration>
          </entry>
        </section>
      </component>
    </structuredBody>
  </component>
</ClinicalDocument>

• 关键注意事项：
  • 用药计划需使用SBADM类代码和INT mood代码（表示意向性用药）
  • 药物编码需使用RxNorm编码系统（2.16.840.1.113883.6.88）
  • 需明确用药时间（如示例中的2000表示晚间8点）和频次

导入前验证步骤 #

• 使用HL7官方CDA验证工具检查XML结构合法性
• 确保文件保存为UTF-8编码的.xml文件
• 导入时确认Apple Health中患者信息与CDA内信息完全匹配

内容的提问来源于stack exchange，提问作者Schwenk