利用clinFHIR客户端来创建医疗文书

利用clinFHIR客户端来创建医疗文书

Creating documents in clinFHIR

原文作者：David Hay原文日期：2017年9月8日

关于David Hay

Orion Health产品战略官，HL7新西兰委员会名誉主席以及FHIR管理工作组共同组长。对医疗健康信息技术有着浓厚的兴趣，尤其是运用HL7标准和新生FHIR标准来实现医疗健康互操作性。

Clinicians on FHIR小组（临床医务人员与FHIR小组） 将在下周工作组会议上会面。最近，我为这个小组做了次clinFHIR的演示 。不过，我彻底忘了在其中说说，在之中利用场景构建程序（Scenario Builder）来创建/查看文档（医疗文书）的事情。这项功能已经有了一段时间，可用于创建FHIR文档，而大体的方法就是，在相应的场景当中添加一个组合式文书资源Composition实例 ，然后再将其余的资源实例链接到它上面来。

所以，觉得应该为此发篇博文！

首先，加载clinFHIR，将服务器设置到公共HAPI STU3服务器（Public HAPI STU3 server）之上，并选择场景构建程序Scenario Builder。采用通常的方法 来创建一个场景。此处要记住，最好始终首先添加相应的患者资源Patient实例，因为这样才会自动地将后续的资源实例与之联系起来。接着，则是添加一个组合式文书资源Composition实例。这样，就会自动调用文档功能，而且，您会注意到，中间面板上因此出现了一个新的选项卡。

如下快照展示的仅仅是一个组合式文书资源Composition实例和一个患者资源Patient实例。其中，请注意中间面板上的文档选项卡Document（紧靠图形选项卡Graph的右侧）。

接着，按照常规的方法添加其他的资源实例，并根据需要将它们链接起来。这里，我们要处理的例子则是，我们在之前一篇博文 中所谈到过的，不良药物反应（Adverse Drug Reaction，ADR）报告场景。其中，所要采集的元素之一就是，患者的当前用药，因此，我们这里要添加两个药物使用情况陈述资源MedicationStatement实例和一个列表资源List实例，并按如下所示的方式，将它们链接起来：

药品不良反应/事件报告表

快照来源：国家食品药品监督管理总局药品评价中心

HL7 FHIR 组合式文书资源Composition的UML类图

小节选项卡（Sections）：用于为组合式文书资源Composition实例添加新的小节。

自动生成式文本选项卡（Generated Text）：依据FHIR之中的文档呈现规则，利用文档内容来自动生成人工可读型文本。

文档捆束选项卡（Document Bundle）：其中容纳着文档内容（即相应的组合式文书资源Composition实例以及所有的引用关系资源实例）的捆束资源Bundle实例。

树状结构选项卡（Tree view）：关于当前文档层级结构的呈现形式。

HL7 FHIR 文档清单资源DocumentManifest的UML类图

HL7 FHIR 取值集合：文档小节代码

Document Section Codes（CCDA小节LOINC代码）

要为当前的文档添加新的小节，点击小节选项卡Sections上的添加小节链接“Add Section”即可。在所显示的对话框中，选择代表相应小节的代码和标题（小节代码取值集合SectionCodes之中所定义的LOINC代码） ，并保存该小节。这时，就会得到如下快照所示的情况：左侧为当前的小节，而右侧则为相应的那些资源。在右侧这一列中，上方的是那些已附加到当前小节的资源，而下方的则是尚未如此的资源。我们可以通过点击那些加号图标，自上而下地将所需的资源添加到当前的小节当中。在如下快照中，我已经将上述的列表资源List实例添加到了当前小节之中。

这时，如果查看一下图形选项卡Graph的话，我们就会看到，现在就有了一条从组合式文书资源Composition实例到列表资源List实例的引用关系。请注意，往往实用的一个方法就是，在图形视图当中将患者资源Patient实例隐藏起来，因为大多数资源都会有条指向患者的引用关系，这样会把显示内容搞得凌乱不堪。

实际上，这就是我们所需做的所有事情啦。当然，其中还会有若干的功能选项，用于小节的重新排序和删除，以及同一小节之内资源的重新排序和删除。在我们操作的同时，这些各种各样的显示内容都会自动更新。其中，最为实用的视图之一就是树状结构视图。如下快照显示的就是一个比较复杂的树状结构视图。实际上，它正是我们上面所提到的不良药物反应报告。

注释：截至撰写本文之时，还需要点击自动生成树状结构链接“Generate tree”来实际创建相应的树状结构以及对其加以更新——我很快会让这项功能实现自动化。

请注意，其中对于文档的层级结构式布局的显示方式（顺序在文档之中还是挺重要的！）。如果单击树状结构之中的特定资源实例，则会在右侧面板之中显示该资源的详情。很方便的一点就是，可以选择自己所喜欢的视图，然后选择不同的资源，即可查看其相应的内容。同时，还要注意的一点就是，树状结构视图为只读型，且显示的仅仅是那些直接链接到组合式文书资源小节元素Composition.section之上的资源实例；当然，还有那些链接到任何附属列表资源List实例之上的资源实例。树状结构视图并不会显示全部的引用关系，而要查看所有这些引用关系的话，请采用图形视图Graph。这里，还记得为了获得更好看的布局视图而要隐藏患者资源实例的事情吗？这时的情况正好就是个例子。

总的来说，文档构建程序“Document Builder”功能是个很棒的手段，可用于形象直观地展示FHIR之中文档[框架]的作用机制。通过添加一个组合式文书资源，并设置相应的小节引用关系，来处理已有的场景，原来也可以是个挺有意思的事情！