医疗行业的互操作性在改善病人护理、降低医疗服务提供者的成本以及为提供者提供更准确的情况方面发挥着重要作用。然而，由于有这么多不同的系统，数据的格式也有很多不同的方式。有许多标准被创造出来以试图解决这个问题，包括HL7v2、HL7v3和CDA，但每一种都有其缺点。

FHIR，即快速医疗互操作性资源，是一种新的医疗数据格式，旨在解决这些问题。它是由国际卫生级七组织（HL7）开发的，该组织还开发了HL7v2、HL7v3和CDA。

今天我们将探讨如何在VS代码中借助IntelliSense和自动完成功能，通过使用FHIR Schema 创建和验证FHIR资源。

第 1 步 :从FHIR 官方网站 https://www.hl7.org/fhir/下载 JSON schema file 文件用来做资源校验

回过头来，业务场景都是千人千面的， FHIR怎么能够用一个标准涵盖尽可能多的用例？HL7吸收了V3的教训，在V3里面不成功的、或者说采纳度比较低的一个原因就V3试图穷举所有用例，由HL7组织自己来规范这些用例。这个是蛮沉重的教训，这也是V3的方法论虽然好，但是这套实施的路线在国际上有很大障碍的原因。

在本文中，我想谈一谈规范优先的 REST API 开发方式。

传统的代码优先 REST API 开发是这样的：

• 编写代码
• 使其支持 REST
• 形成文档（成为 REST API）

规范优先遵循同样的步骤，不过是反过来的。 我们先制定规范（同时兼做文档），然后根据它生成一个样板 REST 应用，最后编写一些业务逻辑。

这是有好处的，因为：

• 对于想要使用你的 REST API 的外部或前端开发者，你总是有相关且有用的文档
• 使用 OAS (Swagger) 创建的规范可以导入各种工具，从而进行编辑、客户端生成、API 管理、单元测试和自动化，或者许多其他任务的简化
• 改进了 API 架构。 在代码优先的方式中，API 是逐个方法开发的，因此开发者很容易失去对整体 API 架构的跟踪，但在规范优先的方式中，开发者被强制从 API 使用者的角度与 API 进行交互，这通常有助于设计出更简洁的 API 架构
• 更快的开发速度 - 由于所有样板代码都是自动生成的，你无需编写代码，只需开发业务逻辑。
• 更快的反馈循环 - 使用者可以立即查看 API，并且只需修改规范即可轻松提供建议
  让我们以规范优先的方式开发 API 吧！

在国际上有很多互操作标准的开发组织，在我们医院信息化、医疗信息化领域有40多个标准开发组织，最广为人知的就是HL7国际、IHE，当然SNOMED也是，它开发的是行业术语跟语义的标准。

实现互通的方式方法有很多种，我们通常会见到4种：消息交换、文档交换、服务和 API。

开发者您好！

这里向介绍@Lorenzo Scalese的OpenAPI-Suite （一个用于从OpenAPI 3.0生成 ObjectScript 代码的工具集）。这个工具集在 2023 年 InterSystems 开发工具大赛的21 个参赛作品中获得专家提名第三名。

国际互联互通的需求是在不断增长，这跟咱们国内的情况是非常类似的。这些年美国在互联互通领域的政策跟实践还是不少的，比如大家可能听到过包括“有意义的使用（Meaningful Use）”，“21世纪治愈法案（21st Century Cures Act）”，还有更多的政策上的驱动。这里先介绍一下“有意义的使用（Meaningful Use）”。

第十九章 源代码文件 REST API 参考（一）

源代码文件 REST 接口支持以下方法：
- GetServer：返回有关服务器的信息。
- HeadServer：返回服务器的 HttpHeader。
- GetJobs：返回正在运行的jobs列表。
- GetMetaData：返回命名数据库的 METADATA.zip 文件的内容。
- GetCSPApps：返回 Web 应用程序列表。
- GetNamespace：返回有关特定命名空间的信息。
- GetDocNames：返回源代码文件名列表。
- GetModifiedDocNames：返回自数据库具有指定哈希值以来已修改的源代码文件列表。
- PutDoc：保存提供的源代码文件。

大家可能已经听说过，我们近期推出了InterSystems API管理器 (以下简称IAM)。InterSystems IRIS数据平台™新增了一项功能，支持用户监视、控制和管理IT基础架构中基于Web的API间通信。

在本文中，我将向大家展示如何设置IAM，并重点介绍IAM中可用的一些功能。InterSystems API管理器可提供你所需的一切功能。

可以使用内嵌REST API用描述文件生成REST服务

请求消息如下：

POST： http://[YourServer]/api/mgmnt/v2/INTEROP/cmAPI

Body： API 描述文件，例如下面的Json文件

Basic Authorization Username: 用户名

Basic Authorization Password: 密码

Content-Type Header: application/json

第二十三章 源代码文件 REST API 参考（五）

DeleteDoc

此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。

与源代码文件有关的错误将在源代码文件对象的状态属性中。

有关示例和其他详细信息，请参阅本手册教程章节中的删除文件。

URL

DELETE http://server:port/api/atelier/v1/namespace/doc/doc-name

注意：如果要删除 CSP 文件 ，则 doc-name 的值包括 /（斜杠）字符。这就是定义 DeleteDoc 的 URLMap 包含此参数名称的 (.*) 而不是 :docname 的原因。有关详细信息，请参阅创建 REST 服务中的“为 REST 创建 URL 映射”。

第二十一章 源代码文件 REST API 参考（三）

GetDocNames

此方法返回源代码文件名列表。可选的 cat 和 type 约束源代码文件的类型。

URL

GET http://server:port/api/atelier/v1/namespace/docnames

GET http://server:port/api/atelier/v1/namespace/docnames/cat

GET http://server:port/api/atelier/v1/namespace/docnames/cat/type

其中

第二十六章 源代码文件 REST API 参考（八）

GetEnsClassType

此方法返回用于创建产品的类的名称列表。可以指定要获取的类的类型，例如业务服务类。

URL

GET http://server:port/api/atelier/v1/namespace/ens/classes/type

type 是一个整数，并返回对应于该整数的类，如下所示：
- Adapters 1

• InboundAdapters 2

• OutboundAdapters 3

• Messages 4

• Requests 5

• Responses 6

• BusinessServices 7

• BusinessProcesses 8

• BusinessOperations 9

“池大小”（PoolSize）设置的值决定了一个组件的作业的量和启动方式。在这篇文章中我们将具体讨论对于不同类型的组件来说“池大小”设置的可能值和这些值所代表的含义。

Pool Size = 1

对于所有的组件来说，运行池大小为1的含义都是一样的: 该组件有且只有一个作业，单独运行该组件的代码，顺序处理发送到该组件的消息（FIFO）。

Pool Size > 1

对于业务进程（BP）和业务操作（BO）来说，当运行池大小大于1时，该组件将运行多个作业（作业数=运行池大小设置数）。每个作业都只运行该组件的代码，但消息处理的顺序将被打乱。将运行池的大小设为大于1的值可以在一定程度上提升组件处理消息的性能，但是每个作业的性能还是受限于系统资源的，所以并不是说组件的性能可以随着运行池的大小增加而无限提升。

对于轮询类业务服务（Polling BS）来说，当运行池大小大于1时，该服务也将运行多个作业（作业数=运行池大小设置数）。但这种配置会导致多个进程对轮询结果产生竞争（race condition），所以一般情况下轮询服务不应将运行池大小设为大于1的数值。