火花塞

来自HL7ChinaWiki
跳转至： 导航、 搜索
FHIR火花塞

吃苹果总要找个地方啃上第一口，去旅行也总要有个地方作为起点。尽管FHIR技术规范备有出色的配套文档（FHIR技术规范官方网站和HL7维基FHIR专栏），且这些资料彼此链接并始终是最新状态，但对于新手来说，仍然有些让人不知所措。下列信息最初是为了帮助临床基因组学工作组迎头赶上而搜集整理出来的，之后家族史工作组也进行了参考引用，而对于任何希望了解和熟悉FHIR技术规范的人们来说，这些资料也应当有所裨益。

FHIR 培训教程

如果有机会能够亲自参加HL7工作组会议（Working Group Meeting，WGM）上的FHIR培训课程，当然值得。不过，如果无法参加即将召开的WGM，或者说已经迫不及待，则可以自己下载和学习一下HL7 GForge 站点上所发布的，遵循知识共享许可协议（Creative Commons）的FHIR培训讲义。简单地说，对于这些讲义，只要尊重其作者并给予明确致谢，您就可以自由使用和传播分发它们。

获得这些培训教程的方法如下：

  1. 访问HL7 GForge 站点
  2. 在快速下载（Quick Downloads）栏目当中单击 FHIR
  3. 在左侧导航栏当中单击 SVN
  4. 在右侧表格当中单击 trunk
  5. 在右侧表格当中单击 Presentations
  6. 在右侧表格当中单击最新的培训讲义 Tutorials（文件夹名称之中带有发布日期）
  7. 依次下载和阅读下列讲义幻灯片：
  • Introduction：入门简介
  • FHIR for Developers：供开发人员学习
  • Profiling：供概貌（Profile，集成规范）编制人员学习
  • FHIR for Architects：供架构设计人员学习
  • ……

是不是有些繁琐？不过，这样倒是可以知道那里有些什么资源可用（除了培训讲义之外）。日后可能会需要HL7 GForge账户才能获得讲义，但目前还是任何人都可以自由获取的。

  1. 这是代替上述诸多步骤的一键式链接

FHIR 技术规范

FHIR技术规范的临时徽标

且慢！咱们接着还要说说FHIR技术规范本身。这里，我们不打算长篇大论地展开讲。FHIR官方网站与FHIR技术规范实际上是一回事儿，即同一个东西。该网站的构建材料包括不同FHIR资源的规范说明及其文档记录和资源示例（如FHIR核心内容、家族史资源、药物资源、患者资源等等等等）。事实上，任何资源示例与所声称的资源或概貌相比，如果是无效（违背了FHIR资源的已有规范）的话，这个网站的构造也会出现问题。如果要确定您在此网站上所阅读的东西（包括与其他资源、数据类型和代码集等等之类的交叉链接在内）实际上是否准确，要花费很多很多的时间和精力。如果您喜欢看纸质打印版本或者是带宽有限的话，FHIR网站上还备有包含整个站点内容的zip压缩包（请参见这里）。

例如，下面我们说说如何找到FHIR家族史资源FamilyHistory及其补充概貌（supplementary profile，经过了与HL7 V3家族史消息的第一轮映射）：

  1. 首先转到 http://hl7.org/fhir
  2. 在顶部红色导航条上的资源链接 Resources
  3. 要么在通用临床资源集合（3 Resource Index --> Clinical --> General）当中单击家族史资源的链接FamilyHistory，要么在该页面下部的字顺列表当中找到并单击单击家族史资源的链接（Alphabetical: D-M）
  4. 分别浏览阅读一下家族史资源页面的下列选项卡：
  • Content－资源内容
  • Examples－资源示例
  • Formal Definitions－资源正式定义/资源形式化定义
  • Mappings－资源映射关系
  • Profiles－资源概貌/资源集成概貌（与HL7 V3家族史消息的第一轮映射）
  • 单击该页面上唯一的资源概貌，即遗传谱系概貌GeneticPedigree

上述简单说明了找到特定资源的方法，但与之前所说的那些培训教程一样，在啰啰嗦嗦一步步找到最终URL的过程中，每一步的页面上都会出现许多在必要时可以选择的岔路链接。

FHIR 测试服务器

Grahame Grieve 的测试服务器和Ewout Kramer 所提供的服务器二者远远不止是FHIR端点（end point），实际上还是友好易用的网络服务器。对于开发人员或者任何对FHIR感到好奇的人来说，与示例FHIR资源进行交互，都是件绝妙的事情。这两个网站都能够显示其中现成可用的资源及其数据元、依据您的选择所组装而成的RESTful查询，并且还能够下载所找到资源的XML和JSON表达形式，甚至是用于验证您自己所创建的资源。

如下是关于Grahame的服务器的快速指南：

  1. 转到 http://fhir.healthintersections.com.au/ （目前，该服务器的页面上的中文翻译并不完整，且还可能有些乱码）
  2. 这里，请选择不安全访问（"Unsecured access at /open - direct access with no security considerations"） ，即不考虑安全问题，直接访问该服务器；与此相对的是另一个链接，可用于身份验证和授权（"Secured access at /closed - Login required"），但需要登录
  3. 单击家族史资源FamilyHistory的规范链接，并选择采用XML或JSON所定义的家族史资源的概貌
  4. 返回前一页，单击家族史资源FamilyHistory的搜索链接
  5. 这时，页面上呈现的是该资源的所有特征属性（attribute）；当前，该服务器上仅仅提供了三个家族史资源示例，因此不要指望任何的搜索条件都会有结果。此时，单击页面底部的“提交查询”按钮，则可以获得相应的搜索结果。
  6. 位于搜索结果页面顶部的是相应的搜索URL。如果您是开发人员，则可以将其作为示例来使用。同时，接下来还为您提供了一个SQL插入语句。目前，并不完全清楚它的可移植性如何。另外，在该页面上，还为您提供了所有三个匹配的资源，并且分别都备有不同格式的表达形式（XML或JSON）供您选择下载。

在考虑编写客户端代码之前，不妨先花些时间和精力探索一下或者说摆弄摆弄这两个站点以及其他公开可用的FHIR测试服务器。

原文链接

参阅

外部链接

取自“http://wiki.hl7.org.cn:81/index.php?title=火花塞&oldid=169”