跳到主要内容

3.4 落地实现


3.4.1 概述

在已有的项目解决方案之上,如果想更上一层,应用FHIR标准框架,除了需要了解前面两章介绍FHIR基础知识和设计理念,还需要更多关于FHIR标准更深层次、更加细节的知识储备,这些内容都会在后面章节逐一介绍。本章将会给出落地实施的路线指引,在哪一步应该了解哪些相关知识。把这些相关知识串联在一起,支撑项目落地实现的关键就是实施指南(Implementation Guide,IG)。

FHIR规范核心内容就是描述了一组资源、框架和API,这些资源、框架和API可以用于医疗保健的许多项目环境,然而,各级组织在项目实施过程中,都会根据自身需要进行本地化调整,从实践、要求、法规上都存在较大差异。如果把FHIR规范看作是一个基准的平台规范,它创建了一个通用的基础级平台,各级组织都可以基于该平台规范实施各种不同的解决方案。下图给出了一个FHIR实施指南建设参考:

实施指南通常需要进一步调整,以适应特定的使用环境。通常,这些调整包括:

  • 定义使用哪些资源以及不使用哪些资源
  • 定义为资源添加哪些关于元素的规则
  • 定义为资源添加哪些本地化扩展
  • 定义使用哪些RESTful服务、消息服务、文档服务,以及如何使用这些服务
  • 定义资源的特定元素该使用哪些值域(字典表)
  • 资源元素和API功能如何映射到本地需求和实现的说明
  • 其它以Markdown形式编写的文字资料

3.4.2 内容

FHIR规范本质上是一个平台性质的规范,有许多强大的功能将FHIR规范构建成一个平台解决方案,包括:

  • 领域模型:一组定义明确的资源,用于描述卫生信息领域。在领域模型中,会发现诸如患者、药物、过敏这些常见资源。
  • 结构定义:描述FHIR结构本身,FHIR资源的元模型。结构定义用于描述FHIR规范中定义的内容——资源、复合数据类型和位于底层的基础级简单数据类型。
  • 查询参数:定义当前实施指南中FHIR服务器支持的资源搜索参数。
  • 能力声明:FHIR服务器以这种形式向其他软件系统声明其能力范围的一种方式。客户端可以简单地通过检查FHIR服务器的能力声明以确定其提供哪些服务,例如,是否支持特定的FHIR资源,以及它是否可以读取或写入这些资源到服务器。
  • 扩展:一种针对资源模型的元素扩展机制。添加到资源中或者添加到资源特定元素中的一种内置方式。

这些资源及其关系如下所示:

因为FHIR是一个平台规范并且范围广泛,使用起来非常灵活,所以在实际的解决方案中经常需要指明要使用FHIR规范的哪些部分。使用实施指南这种定义方法,解决方案设计人员可以指定使用哪些资源、哪些元素,在哪些元素中使用哪些值域,以及如何调用这些API服务。

有了这样一套定义明确的平台架构,就有可能构建一个基于FHIR规范的全新医疗数据产品。这也是在构建基于FHIR的产品体系时遵循的设计路径。

3.4.3 实施指南发布

FHIR实施指南是指导FHIR规范如何在项目落地实现的,它既可以从业务层面指定业务流程、规则、管理制度等,又可以从技术角度定义非常全面的验证规则,以可量化的方式保障实施指南在项目上落地。下图给出了整个实施指南的工具链,可以对实施指南进行编辑、发布、验证等操作。

FHIR官方团队提供了一系列的实施指南编辑和发布工具,该系列工具可以将资源结构定义转换为一组三种不同类型格式的文件(xml、json、ttl)、一组资源对应的HTML文件和几个不同的zip压缩文件。这些文件可以发布到网络服务器上,最终形成一个网站形式的、完整的实施指南。

当然,很多的解决方案提供商也自行开发一些有关实施指南的工具,用于将描述资源的定义文件转换为可以提供给客户使用的Word格式或者Pdf格式的文档。实施指南发布详细定义参见6.2.4.1

3.4.3.1 资源模型编辑

资源模型编辑工具以可视化的方式编写FHIR实施指南。目前有:

  • Trifolia-on-FHIR:是Lantana公司提供的一个开源工具。可以利用该工具创建、修改和发布实施指南、定义文件、扩展、值域、问卷和其他组件。使复杂的、高度技术性的工作更易于管理,并提高了实施指南的一致性。
  • Forge:是一个用户友好的Windows桌面应用程序,允许轻松创建、编辑和验证 FHIR定义文件、扩展和实施指南。Forge可以与Simplifier快速集成,可以将编辑的实施指南直接发布到您的Simplifier项目中。

3.4.3.2 FSH和SUSHI

除了上面介绍的可视化编辑工具,还可以直接通过文本声明来编辑实施指南,当然文本声明必须是符合一定规则的,这种规则就是ShortHand规范,符合该规范的文件称之为FSH文件。这种文件可以通过SUSHI工具编译为可被IG Publisher工具直接使用的格式。这种文本声明方式生成实施指南的优点是简单和快捷,缺点就是有一定的技术门槛,需要非常熟悉FHIR规范和ShortHand规范。

3.4.3.3 IG Publisher

无论是可视化的编辑工具,还是文本声明式的编辑工具,最终编译后的输出物都应该成为IG Publisher工具的输入物。IG Publisher工具可以将实施指南发布为一个网站。该网站内容包括:

  • HTML静态页面:包括实施指南的说明性文本、资源定义页面、术语页面以及导航页面。
  • 实施指南使用资源的不同格式定义,包括:XML、JSON、TTL格式。
  • ZIP格式压缩文件:资源的定义文件、术语文件、示例文件等。

(撰写人:叶彦波)