表述性状态传递 (REST) 是一种软件架构风格，它定义了一组用于创建 Web 服务的约束。符合 REST 架构风格的 Web 服务（称为 RESTful Web 服务 (RWS)）提供了互联网上计算机系统之间的互操作性。RESTful Web 服务允许请求系统通过使用统一预定义的无状态操作集来访问和操作 Web 资源的文本表示。其他类型的 Web 服务（如 SOAP Web 服务）需要公开它们自己的专有操作集。
本演示程序用于展示如何采用自定义FHIR profile来验证数据合规性。自定义FHIR实施指南基于FHIR R4版本开发，在本例中实现了对Organization资源的扩展并用于验证数据的合规性。
1.我在java中发布了一个服务提供给调用,postman中可以请求解析出数据
请求信息如下：
POST /uploadPersonExcel HTTP/1.1
Host: localhost:8017
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
cache-control: no-cache
Postman-Token: 1c23edfe-1e83-44c6-8f91-e06bccfd4af3
Content-Disposition: form-data; name="file"; filename="C:\Users\elite\Desktop\personinfo.xlsx
------WebKitFormBoundary7MA4YWxkTrZu0gW--
2.Ensemble中请求代码如下：
通过 REST API 将前端 React 应用程序与 IRIS 数据库等后端服务集成，是构建健壮网络应用程序的强大方法。但是，开发人员经常遇到的一个障碍是跨源资源共享（CORS）问题，由于网络浏览器强制执行的安全限制，该问题可能会阻止前端访问后端的资源。在本文中，我们将探讨在将 React Web 应用程序与 IRIS 后端服务集成时如何解决 CORS 问题。
我们首先定义一个名为 Patients 的简单Schema：
Class Prototype.DB.Patients Extends %Persistent [ DdlAllowed ]
{
Property Name As %String;
Property Title As %String;
Property Gender As %String;
Property DOB As %String;
Property Ethnicity As %String;
}
您可以在表中插入一些虚假数据进行测试。我个人认为 Mockaroo 在创建假数据时非常方便。它可以让你把虚拟数据下载为 .csv 文件，直接导入管理门户。
然后，我们定义几个 REST 服务
想象一下那个场景。您正在 Widgets Direct 愉快地工作，这是互联网上首屈一指的小部件和小部件配件零售商。您的老板有一些毁灭性的消息，一些客户可能对他们的小部件不太满意，我们需要一个帮助台应用程序来跟踪这些投诉。为了让事情变得有趣，他希望代码占用非常小，并挑战您使用 InterSystems IRIS 以少于 150 行代码交付应用程序。这可能吗？
免责声明：本文记录了一个非常基本的应用程序的构建，为了简洁起见，省略了安全性和错误处理等细节。该应用程序仅供参考，不得用于任何生产应用。本文使用IRIS 2023.1作为数据平台，并非所描述的所有功能在早期版本中都可用
我们首先定义一个新的干净的命名空间 - 带有代码和数据数据库。虽然所有内容都可以位于 1 个数据库中，但将它们拆分以便于数据刷新。
我们的帮助台系统需要 3 个基本类：一个 Ticket 对象，它可以包含用于记录员工顾问 UserAccount 和客户联系人 UserAccount 之间交互的操作。让我们用一些基本属性来定义它们：
对于即将到来的Python 竞赛，我想制作一个小型演示，介绍如何使用 Python 创建一个简单的 REST 应用程序，该应用程序将使用 IRIS 作为数据库。使用这个工具
JWT 是一种结构紧凑、URL 安全的身份验证、授权或信息交换方式。在身份验证的情况下，服务器会向已通过身份验证的客户端提供一个 JWT，这样客户端在 JWT 过期之前就无需再提供密码来访问服务器上受保护的资源。
在InterSystems IRIS中，可以使用/api/mgmnt自动创建REST的 .disp .impl 和 .spec 类，本篇文章不介绍具体创建REST服务的流程，具体内容请参考社区文章创建REST 服务。
IRIS管理门户：系统管理 -> 安全 -> 应用程序 -> Web 应用程序
在本文中，我将分享我们在 2023 年全球峰会技术交流室中提出的主题。我和@Rochael Ribeiro
借此机会，我们就以下话题进行探讨：
当我们谈论快速现代 API 开发（Rest / json）时，我们将使用两个 Intersystems Open Exchange 工具：
第一个是用于快速开发 API 的框架，我们将在本文中详细介绍。
https://openexchange.intersystems.com/package/IRIS-apiPub
第二种是使用 Swagger 作为用户界面，用于 IRIS 平台上开发的 Rest API 的规范和文档，以及它们的使用/执行。其运行的基础是开放 API 规范 (OAS) 标准，如下所述：
https://openexchange.intersystems.com/package/iris-web-swagger-ui
它是全球范围内用于定义、记录和使用 API 的标准。在大多数情况下，API 甚至在实现之前就已经设计好了。我将在下一个主题中详细讨论它。
FHIR 通过提供标准化数据模型来构建医疗保健应用程序并促进不同医疗保健系统之间的数据交换，彻底改变了医疗保健行业。由于 FHIR 标准基于现代 API 驱动的方法，因此移动和 Web 开发人员更容易使用它。然而，与 FHIR API 交互仍然具有挑战性，尤其是在使用自然语言查询数据时。
隆重推出FHIR - AI 和 OpenAPI 链应用程序，该解决方案允许用户使用自然语言查询与 FHIR API 进行交互。该应用程序使用OpenAI 、 LangChain和Streamlit构建，简化了查询 FHIR API 的过程并使其更加用户友好。
OpenAPI 规范（以前称为 Swagger，目前是OpenAPI Initiative的一部分）已成为软件开发领域的重要工具，使开发人员能够更有效地设计、记录 API 并与 API 交互。 OpenAPI 规范定义了一种标准的机器可读格式来描述 RESTful API，提供了一种清晰一致的方式来理解其功能并有效地使用它们。
在医疗保健领域，FHIR 成为数据交换和互操作性的领先标准。为了增强FHIR的互操作能力， HL7正式记录了FHIR OpenAPI规范，使开发人员能够将FHIR资源和操作无缝集成到他们的软件解决方案中。
这是在 Ensemble 中实现“微服务”设计的初学者指南。 “微服务”是当今流行的一个词，具有广泛的解释。我的解释是：“微服务”是一种“NoSQL 服务”。一个什么？答案在文章中。
我们了解了 SQL 和 NoSQL 数据库之间的区别。对我来说，SOA Web 服务和“微服务”之间的区别几乎相同。我将通过一个例子来解释它。
请注意，虽然这是一本初学者指南，但我假定我对数据建模、RESTful 服务和 Ensemble 有深入的技术知识。
我的例子很简单。我想为我的家人订一张机票。我使用www.skyscanner.hu ，但它可以是任何预订网站。那我该怎么办？在着陆页上，我输入了航班信息：我需要从布达佩斯到布拉格并返回的机票，10 月29日起飞，11 月 1日返回，直飞航班，经济舱四人。提交搜索表单后，我会返回可用选项。我选择一个并输入乘客详细信息、折扣计划，最后通过 PayPal 付款。直截了当。
在更详细的版本中：后台发生了什么。
n 开始预订
n 输入选择条件
n 生成匹配航班列表
n 选择航班
n 临时封号
n 输入乘客详细信息
n 根据标价应用一些折扣程序计算机票
n 切换到 PayPal 支付
n 完成预订，释放临时块
当任务是使用 SOAP Web 服务开发后端时，最常见的架构如下：
n 将有支持预订的 SOAP 服务。假设它称为 FlightBookingService。
- 设置 HTTP 服务
- 输入 FHIR 服务器的路径
- 输入 FHIR 服务的 URL
- 使用配置的凭证
测试 FHIR 客户端
跟踪测试结果
开发者您好！
这里向介绍@Lorenzo Scalese的OpenAPI-Suite （一个用于从OpenAPI 3.0生成 ObjectScript 代码的工具集）。这个工具集在 2023 年 InterSystems 开发工具大赛的21 个参赛作品中获得专家提名第三名。
目前 IRIS 最高支持OpenAPI 2.0 ，但是这个工具支持 OpenAPI 3.0 ！
提供的功能如下。
关于各个功能的详细介绍，请参考@Lorenzo Scales撰写的文章《 OpenAPI Suite - Part 1 》和《 OpenAPI Suite - Part 2 》。
在本文中，我尝试了 1 个功能。其中，以下的应对方案非常好。
Intersystems IRIS for Health 对 FHIR 行业标准提供了出色的支持。主要特点是：
1.FHIR 服务器
2. FHIR数据库
3. REST 和 ObjectScript API 用于 FHIR 资源（患者、问卷、疫苗等）的 CRUD 操作
本文演示了如何使用这些功能，并展示了用于创建和查看表单类型的 FHIR 资源的Angula前端。
要创建 FHIR 服务器，您必须将以下说明添加到 iris.script 文件中（来自：https://openexchange.intersystems.com/package/iris-fhir-template）
“池大小”（PoolSize）设置的值决定了一个组件的作业的量和启动方式。在这篇文章中我们将具体讨论对于不同类型的组件来说“池大小”设置的可能值和这些值所代表的含义。
Pool Size = 1
对于所有的组件来说，运行池大小为1的含义都是一样的: 该组件有且只有一个作业，单独运行该组件的代码，顺序处理发送到该组件的消息（FIFO）。
Pool Size > 1
对于业务进程（BP）和业务操作（BO）来说，当运行池大小大于1时，该组件将运行多个作业（作业数=运行池大小设置数）。每个作业都只运行该组件的代码，但消息处理的顺序将被打乱。将运行池的大小设为大于1的值可以在一定程度上提升组件处理消息的性能，但是每个作业的性能还是受限于系统资源的，所以并不是说组件的性能可以随着运行池的大小增加而无限提升。
对于轮询类业务服务（Polling BS）来说，当运行池大小大于1时，该服务也将运行多个作业（作业数=运行池大小设置数）。但这种配置会导致多个进程对轮询结果产生竞争（race condition），所以一般情况下轮询服务不应将运行池大小设为大于1的数值。
在生产环境中IRIS通常以故障转移集群的形态被部署，而集群中各故障转移成员的镜像状态将决定该集群在故障发生时是否能够顺利切换保障业务不中断。因此，成员状态通常也是运维团队需要巡检或监控的目标。
尽管IRIS内部API提供了丰富的集群配置、成员状态监控等一系列接口，但除Portal上的镜像监视器外，并没有特定的接口便于从外部系统访问（如进行企业级监控集成时），也没有整合好的监控接口可用与获取镜像的健康状态。但在IRIS上开发一个REST接口暴露镜像状态数据并不困难，如下所示：
这是一篇笔记:
说明
Restful是一种基于Http的网络应用程序的设计风格和开发方式，可以使用xml格式或者Json格式定义。
RESTFUL特点包括：
1、每一个URI代表1种资源；
2、客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源；
3、通过操作资源的表现形式来操作资源；
4、资源的表现形式是XML或者HTML；
5、客户端与服务端之间的交互在请求之间是无状态的，从客户端到服务端的每个请求都必须包含理解请求所必需的信息。
IRIS中实现
GET：
关于微服务架构（MSA）的IRIS定位的初学者指南。MSA在企业级Java世界中的能见度越来越高，因此，了解这股热潮背后的内容是至关重要的。我尝试着写下我的观点并与大家分享。
首先，我必须承认。今年初夏，我的同事要求我收集一些关于匈牙利开发的医疗产品的信息。当我从相关公司得到反馈时，发现该产品是一个模块化系统，基于微服务架构（MSA）。好的。什么是MSA？在网上做了简短的研究，阅读了一些WIKI网页后，我得出结论：啊哈，又是一个 "架构"。我们可以用IRIS在 "架构层面 "遵守 "任何架构"--至少 "在某种程度上"。但也有一些恼人的地方。这让我对MSA有了更多的了解。到目前为止还不错，但是REST不是这篇文章的主要话题吗？MSA和REST之间的关系是什么？我访问的几乎每个网站都在例子中使用了RESTful网络服务。这让我有点怀疑。但总的来说，我赞同对MSA的一般总结：它是SOAP但做得很好。特别是因为有一些关于 "内聚 "和 "耦合 "的句子，我完全不明白。那么，如果MSA只是 "SOAP做得好"，为什么我没有看到SOAP的例子？为什么这些例子（几乎）都是RESTful？
Hi 我在线部署了一个demo演示:
我更新了几个设置（文件路径和URL），并将调度类切换到dc.rest.GenericService。
我从文件服务重新发送了消息。我看到授权Auth和API服务都收到了消息。
API进程（还）没有返回所需的响应。更多内容请继续关注...
GetEnsClassType此方法返回用于创建产品的类的名称列表。可以指定要获取的类的类型，例如业务服务类。
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
DataTransformation 10
Production 11
BusinessHost 12
Dashboard 13
Rule 14
以下返回的内容是一个类名数组：
此方法对 IRIS 表执行 SQL 查询并返回结果。请求正文是指定查询的 JSON 对象。它返回一个匹配查询条件的对象数组。每个返回的对象都包含与查询返回的一行相关的信息。
POST http://server:port/api/atelier/v1/namespace/action/query
SQL 查询在 URL 请求的正文中指定。查询必须在指定的命名空间中指定一个数据库。
此调用需要标头 Content-Type application/json。
返回内容是一个对象数组。错误将出现在每个源代码文件对象的状态属性中：
此方法编译源代码文件。它允许一次编译多个源代码文件。它返回一个对应源代码文件对象的数组。
要编译的文件列表作为 JSON 数组在 http 请求的正文中传递。例如，[ "%Api.DocDB.cls", ... ]。
有关示例和其他详细信息，请参阅本手册教程章节中的编译文件。
POST http://server:port/api/atelier/v1/namespace/action/compile
此调用需要标头 Content-Type application/json。
URL Parameters可以传递 URL 参数“flags”（默认为“cuk”），该参数将传递给编译器。
如果不希望返回已编译的源代码文件的源，则可以使用值 0 传递 URL 参数 'source'。
以下是编译 Atelier.NewClass1 时返回的内容：
嗨社区，
这篇文章公开介绍我的 iris-fhir-client 客户端应用。
iris-fhir-client 可以可以借助嵌入式 python 连接到任何开放的 FHIR 服务器 fhirpy 图书馆.
通过终端和使用 CSP Web 应用程序获取资源信息。
此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。
与源代码文件有关的错误将在源代码文件对象的状态属性中。
有关示例和其他详细信息，请参阅本手册教程章节中的删除文件。
DELETE http://server:port/api/atelier/v1/namespace/doc/doc-name
注意：如果要删除 CSP 文件 ，则 doc-name 的值包括 /（斜杠）字符。这就是定义 DeleteDoc 的 URLMap 包含此参数名称的 (.*) 而不是 :docname 的原因。有关详细信息，请参阅创建 REST 服务中的“为 REST 创建 URL 映射”。
以下是源代码文件 xyz.mac 的 DELETE 的返回内容：
在这篇文章中，你可以访问InterSystems开发者社区中与学习InterSystems IRIS最相关主题的文章库。找到按机器学习、嵌入式Python、JSON、API和REST应用、管理和配置InterSystems环境、Docker和云、VSCode、SQL、分析/BI、全局、安全、DevOps、互操作性、Native API排列的顶级发表的文章。快来享受学习的乐趣吧!
机器学习是建立先进的数据分析和自动化人工活动的一种必要的技术，具有很好的效率。它可以创建认知模型，从现有的数据中学习，并根据其自我调整的算法进行预测、概率计算、分类、识别和 "非创造性 "的人类活动的自动化。
在所有情况下，InterSystems IRIS作为一个数据平台和环境来创建、执行、提供和使用这些机器学习模型。IRIS能够从SQL命令（IntegratedML）中使用ML，使用嵌入式Python和PMML（预测模型标记语言）来执行ML。你可以在以下文章中查看它的功能:
此方法返回源代码文件名列表。可选的 cat 和 type 约束源代码文件的类型。
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
其中
cat 指定类别代码：CLS = class; RTN = routine； CSP = CSP 文件； OTH = other。默认为 *。type 指定源代码文件类型。可以是 * 通配符或文件类型。对于 CLS，类型必须是 *。对于 RTN，类型可以是 mac、int、inc、bas 、mvi 或 mvb。对于 CSP，type 可以是 js 或 css 等文件类型的列表，以逗号分隔。默认为 *。URL 参数 'generated=1' 指定应包含生成的源代码文件。URL 参数 'filter' 提供了一个可用于匹配名称的 SQL 过滤器。以下是返回的内容，源代码文件描述符数组：
医疗行业的互操作性在改善病人护理、降低医疗服务提供者的成本以及为提供者提供更准确的情况方面发挥着重要作用。然而，由于有这么多不同的系统，数据的格式也有很多不同的方式。有许多标准被创造出来以试图解决这个问题，包括HL7v2、HL7v3和CDA，但每一种都有其缺点。
FHIR，即快速医疗互操作性资源，是一种新的医疗数据格式，旨在解决这些问题。它是由国际卫生级七组织（HL7）开发的，该组织还开发了HL7v2、HL7v3和CDA。
今天我们将探讨如何在VS代码中借助IntelliSense和自动完成功能，通过使用FHIR Schema 创建和验证FHIR资源。
第 1 步 :从FHIR 官方网站 https://www.hl7.org/fhir/下载 JSON schema file 文件用来做资源校验
第 2 步: 创建文件夹（在这个例子中，我使用病人文件夹和病人资源），并将提取的fhir.schema.json文件复制到同一文件夹，然后从VS Code中打开文件夹.png)
第 3 步: 通过修改setting.json文件，设置VS代码以识别FHIR模式。
按CTRL+SHIFT+P并输入工作区设置JSON文件.png)
第 4 步: 在同一文件夹中创建一个新文件patient.fhir.json。
按Ctrl+Space，你将通过IntelliSense获得FHIR资源的所有属性
此方法返回命名数据库的 METADATA.zip 文件的二进制内容。 Atelier 使用此文件来存储索引信息，以便为将来的会话保留此信息。
GET http://server:port/api/atelier/v1/%25SYS/metadata/database
注意：因为 % 是 URL 特殊字符，所以要指定文字 %，必须在其后跟 25（百分号字符的十六进制代码）。因此，必须使用 %25SYS 来指定文字 %SYS。
HTTP 200 如果正常。HTTP 404。HTTP 500 如果发生意外错误（详细信息将在状态错误数组中）。此方法返回在服务器上定义或为服务器上指定命名空间定义的 Web 应用程序列表。
GET http://server:port/api/atelier/v1/%25SYS/cspapps
GET http://server:port/api/atelier/v1/%25SYS/cspapps/namespace
其中：
namespace
指定命名空间的名称。如果未指定命名空间，则此方法返回所有命名空间的 Web 应用程序。
源代码文件 REST 接口支持以下方法：
要获取有关命名空间中源代码文件的信息：
GetDocNames 方法获取文件的名称。GetDoc 方法获取一个文件的内容，也可以用GetDocs 方法获取多个文件的内容。GetModifiedDocNames 方法仅获取内容发生变化的源代码文件的名称或使用带有 If-None-Match HTTP 标头的 GetDoc 方法。GetDocNames 方法返回映射到命名空间的所有数据库中的所有源代码文件的名称。
本章提供了一个简短的教程，通过一系列示例演示如何使用源代码文件 REST API。它包含以下部分：
API 基础Atelier 用于访问 IRIS 源代码文件的 API 使用 REST 架构风格。 REST 的名字来源于“Representational State Transfer”。与许多 REST API 一样 IRIS 源代码文件 REST API 使用 HTTP GET、POST、PUT、DELETE 和 HEAD 方法，并将 JSON 用于传入和传出消息体。
要调用 API 方法，需要了解以下内容：
可以定义 REST 服务以处理不同格式的数据，例如 JSON、XML、文本或 CSV。 REST 调用可以通过在 HTTP 请求中指定 ContentType 元素来指定它期望发送的数据的形式，并且可以通过在 HTTP 请求中指定 Accept 元素来请求返回数据格式。
在 DocServer 示例中，GetNamespaces() 方法检查 REST 调用是否使用以下内容请求 JSON 数据：
If $Get(%request.CgiEnvs("HTTP_ACCEPT"))="application/json"
REST 服务REST 服务返回的任何字符串值都可以本地化，以便服务器以不同语言存储多个版本的字符串。然后，当服务接收到包含 HTTPAccept-Language 标头的 HTTP 请求时，服务会使用相应版本的字符串进行响应。
本地化 REST 服务：
$$$Text 宏的实例，为宏参数提供如下值：例如，而不是这个：
set returnvalue="Hello world"