如果您正打算学习FHIR、或者正在基于FHIR开发，最佳的学习和开发环境需要一个完备的FHIR 服务器，帮助您理解FHIR标准和调试FHIR应用。使用InterSystems IRIS医疗行业版可以快速配置出FHIR服务器和FHIR资源仓库。这篇文章介绍如何在5分钟内在InterSystems IRIS医疗行业版上配置FHIR服务器和FHIR资源仓库；同时对初学者介绍FHIR测试数据生成与加载的方法，和基本的FHIR REST API操作。
软件准备
1. InterSystems IRIS医疗行业版
您可以使用已有的2020.1及以上的InterSystems IRIS医疗行业版。如果您还没有，那么就在社区里下载一个最新的、免费的社区版吧。
2. 测试用的FHIR数据
如果您正在做FHIR开发，应该有很多FHIR测试数据。如果您正在学习FHIR，那么Synthea是一个不错的FHIR测试数据生成器选项。
3. REST测试工具
您或许已经有趁手的REST测试工具了。如果还没有，POSTMAN是个不错的选择。我的例子里用到的就是POSTMAN。
FHIR服务器配置
1. 安装InterSystems IRIS医疗行业版或社区版
如果您还没有安装过InterSystems IRIS医疗行业版或社区版，社区里有很多很好的介绍文章。
2. 配置FHIR服务器
2.1 创建一个FHIR 服务器命名空间
在InterSystems IRIS医疗行业版或社区版上，需要创建一个FHIR服务器命名空间。HS.HC.Util.Installer类的方法InstallFoundation可以创建这样的命名空间，例如，我们创建一个名为FHIRSERVER的命名空间：
HSLIB>D ##class(HS.HC.Util.Installer).InstallFoundation("FHIRSERVER")
2.2 为这个命名空间配置FHIR访问端点 （FHIR endpoint）
进入管理门户，切换到FHIRSERVER命名空间，然后Health > FHIR Configuration， 然后点击“Server Configuration”。这里会列出已有的FHIR服务器的访问端点，并可以配置新的端点。
.png)
这里点击+号，在弹出的配置页面中进行设置，其配置项是：
选中支持的FHIR版本 (Select a metadata set): 如果要支持最新的FHIR版本4，选中HL7V40，就是FHIR R4；
选中交换策略 (Select an interaction strategy): 默认情况下只会有一个选项 - HS.FHIRServer.Storage.Json.InteractionsStrategy，它会将InterSystems IRIS同时配置为FHIR资源仓库。
设置FHIR服务器REST服务端点 (Enter a name(URL)): 例如/csp/healthshare/fhirserver/fhir/r4
.png)
然后点击Finish，让它完成后台的配置，这可能会花费1分钟。
2.3 修改这个FHIR服务端点
因为我们是想利用它来学习和测试FHIR，所以我们先跳过访问认证部分。在端点列表中选中刚才创建的/csp/healthshare/fhirserver/fhir/r4，滚动到最下方，找到Edit按钮，并选中“Debugging”下的“Allow Unauthenticated Access”，让FHIR服务器接受匿名访问。然后点击Update进行更新。
.png)
如果您按上述步骤执行完成，并且没有错误，那么FHIR服务器和FHIR资源仓库已经就绪了。看看表，您用了多久完成FHIR服务器的创建。
下面测试一下FHIR服务器是否工作正常。
测试FHIR服务器
即便您还没有任何FHIR测试数据，也可以先看看这个FHIR服务器的能力声明。
通过POSTMAN，使用GET方法，进行REST调用：http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/metadata。这里localhost:52776是我的测试InterSystems IRIS的服务器地址和Web服务端口号，您换成自己的就行。如果您不知道，那么用您访问InterSystems IRIS管理门户的地址和端口号。
因为我们在上一步配置时，允许匿名访问REST API，所以POSTMAN无需设置任何登陆账户，非常方便测试。正常情况下，您应该看到和我一样的结果：
.png)
您的FHIR服务器已经正常工作了，如果还没有测试数据，是时候加载一些FHIR数据进来了。
产生FHIR数据
如果您有自己的FHIR测试数据，请跳过此步，查看“加载FHIR数据”。
如果您还没有自己的FHIR数据，试试Synthea，它能方便的产生大量FHIR测试数据。Synthea有清晰的文档，告诉我们如何产生测试数据。（注：如果您是FHIR初学者，建议先少量创建FHIR测试数据文件，例如先创建5个）
通常它会产生3类JSON文件：
医院信息：hospitalInformation******.json， 每批次只会产生一个医院信息文件。
医生信息：practitionerInformation******.json， 每批次只会产生一个医生信息文件。
患者信息：<患者姓名>******.json， 每批次会根据设置产生一个或多个患者信息文件。
这些FHIR文件都是Bundle资源，Bundle里面会有很多FHIR资源数据。其中医院信息文件和医生信息文件的Bundle类型为batch，而患者信息的Bundle是transaction。
而Synthea产生的患者信息Bundle中的资源使用literal reference来引用医院/地点和医生信息，但它产生的literal reference信息不完整，例如：
"serviceProvider": {
"reference": "Organization?identifier=https://github.com/synthetichealth/synthea|731e0f3a-075d-37ab-9ba7-fbf1ab2f45e9",
"display": "THE GENERAL HOSPITAL CORPORATION"
}
需要将reference改为完整的地址，例如：
"serviceProvider": {
"display": "THE GENERAL HOSPITAL CORPORATION"
}
也就是增加FHIR服务器的端点。
需要替换/补齐的引用分别是：Location、Organization和Practitioner。
您可以通过文本编辑器进行全局替换，将FHIR服务器的端点信息补充到reference里。如果您产生了很多FHIR数据文件，当然可以用您熟悉的语言写几行代码做这个补充替换。
这里我也附上使用IRIS的Object Script做补充替换的代码示例，它会对指定目录下的所有json文件进行扫描和补充替换，供您参考：
Class Demo.FHIRTools Extends %RegisteredObject
{
/// 修正FHIR文件的引用
/// pFilePath为FHIR json文件目录
/// pFHIREndpoint为FHIR REST的服务端点
ClassMethod CorrectSyntheaFiles(
pFilePath As %String = "C:\Temp\Synthea\output\fhir",
pFHIREndpoint As %String = "http://localhost:52776/csp/healthshare/fhirserver/fhir/r4") As %Status
{
Set tSC = $$$OK
// 遍历目录下的json文件
Set tSM = ##class(%SQL.Statement).%New()
Set tSC = tSM.%PrepareClassQuery("%File", "FileSet")
If $$$ISERR(tSC)
{
Do $system.OBJ.DisplayError(tSC)
Return tSC
}
Set tRS = tSM.%Execute(pFilePath, "*.json", "Name")
While tRS.%Next()
{
// 创建临时文件
Set tFileName = tRS.%Get("Name"),tTempFileName=$Replace(tFileName,".json","temp.json")
Set tFile=##class(%Stream.FileCharacter).%New()
Set tTempFile = ##class(%Stream.FileCharacter).%New()
Set tSC=tTempFile.LinkToFile(tTempFileName)
Set tSC=tFile.LinkToFile(tFileName)
// 从源文件逐行读取，替换后写入临时文件
While 'tFile.AtEnd
{
Set tLine=tFile.ReadLine()
// 执行替换
For tKeyword="Location?identifier=","Organization?identifier=","Practitioner?identifier="
{
Set tLine = $Replace(tLine,tKeyword,pFHIREndpoint_"/"_tKeyword)
}
Set tSC = tTempFile.WriteLine(tLine)
}
Do tTempFile.%Save()
Do tFile.%Close(), tTempFile.%Close()
Kill tFile,tTempFile
// 删除源文件，并将临时文件改名为源文件名
Set tSC = ##class(%File).Delete(tFileName,.tRtn)
Set tSC = ##class(%File).Rename(tTempFileName, tFileName, .tRtn)
}
Return tSC
}
}
加载FHIR数据
当然可以通过FHIR REST API来加载数据，不过，InterSystems IRIS提供了后台的API，可以快速加载特定目录下的大量的FHIR数据文件。
这里我们用后台API：HS.FHIRServer.Tools.DataLoader的SubmitResourceFiles方法进行大量FHIR文件加载：
FHIRSERVER>Set sc=##class(HS.FHIRServer.Tools.DataLoader).SubmitResourceFiles("C:\Temp\Synthea\upload","FHIRSERVER","/csp/healthshare/fhirserver/fhir/r4")
其中第一个入参是需要加载的文件目录；第二个参数是加载的FHIR服务器类型，这里用FHIRSERVER；第三个参数是FHIR REST服务端点。
这个方法同样适用于加载NDJSON格式的FHIR数据文件。
如果您是通过Synthea产生的测试FHIR JSON文件，那么应该先加载 医院信息文件(hospitalInformation******.json)和医生信息文件(practitionerInformation******.json)，以确保患者数据加载时，Location、Organization和Practitioner的引用能正确关联到FHIR资源仓库中已保存的对应资源上。
注意：2020.* 版本中有一个bug，需要将医院信息文件(hospitalInformation******.json)和医生信息文件(practitionerInformation******.json)里的"type": "batch"改为"type": "transaction"。这个bug在2021.1版本中已经得到修复，我已经验证过，但如果您在使用2020的版本，请记得提前修改。
加载完医院信息文件(hospitalInformation******.json)和医生信息文件(practitionerInformation******.json)后，再执行相同的方法加载所有患者数据json文件。
使用FHIR 服务器
有了测试数据，现在您可以使用FHIR服务器进行学习或开发测试了。使用POSTMAN，您可以调用FHIR服务器的REST API，查询、更改、提交FHIR资源数据。
如果您是初学者，对FHIR的REST API不熟悉，建议您从FHIR Cheat Sheet开始，它是一个FHIR标准的汇总单页，里面告诉大家如何使用REST API进行操作。
例如：
1. 查询已经加载到FHIR资源仓库中的患者：
使用GET 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Patient2. 使用查询参数，查询名为Pedro316的患者：
使用GET 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Patient?given=Pedro316或使用POST 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Patient/_search?given=Pedro3163. 更复杂的查询参数用例，查询拥有观察项目编码为8302-2（体重）的患者：
使用GET 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Patient?_has:Observation:patient:code=8302-24. 使用operation： $everything 来获取特定患者的所有相关FHIR资源（示例是id为95的患者）：
使用GET 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Patient/95/$everything5. 加载FHIR Bundle资源：
使用POST 方法调用REST：
http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/，并在Body中直接贴入FHIR资源数据到raw，或选择FHIR资源数据文件到binary。
注意：如果您是想让FHIR服务器解析Bundle中的FHIR资源，应该用http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/，而不是http://localhost:52776/csp/healthshare/fhirserver/fhir/r4/Bundle。后者把POST的FHIR数据按Bundle进行处理，并不会解析其中包含的FHIR资源内容并逐一保存！
.png)
注意：记得根据FHIR数据的格式设置Content-Type为application/json+fhir 或 application/xml+fhir，然后将数据贴在Body里：
.png)
好了，开启您的FHIR之旅吧 :)
后续我还会更新InterSystems IRIS医疗版作为FHIR服务器和FHIR资源仓库的更多内容，欢迎关注。
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
