在本文中，我将分享我们在 2023 年全球峰会技术交流室中提出的主题。我和@Rochael Ribeiro

借此机会，我们就以下话题进行探讨：

• 用于快速 API 的开放交换工具
• 开放API规范
• 传统与快速 Api 开发
• 复合 API（互操作性）
• 规范优先或 API 优先方法
• API 治理和监控
• 演示（视频）

用于快速 API 的开放交换工具

当我们谈论快速现代 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 规范 (OAS)？

它是全球范围内用于定义、记录和使用 API 的标准。在大多数情况下，API 甚至在实现之前就已经设计好了。我将在下一个主题中详细讨论它。

1. 主机和备机为什么总是切换，会不会是与仲裁机连接的心跳检测出问题了
   
   • 查看镜像状态 打开管理门户 - ‘系统操作’ - ‘镜像监视器’
   • 如遇到主备切换，可以通过消息日志查看切换原因 打开管理门户 - ‘系统操作’ - ‘系统日志’ - ‘消息日志’      

2. 基础问题怎么查询
   
   • 通过管理门户查看日志 打开管理门户 - ‘系统操作’ - ‘系统日志’ - ‘消息日志’
   • 通过监控告警日志 告警日志文件：<intall-dir>/mgr/alerts.log文件      

3. Production所有组件设置重试间隔、故障超时是什么意思
   
   • 重试间隔：与回复代码操作配合使用，当发生回复代码操作中设置的回复发生时，按照重试间隔设置的时间对外部业务系统再次访问。
   • 故障超时：发生故障时继续传递消息的总秒数，可以与回复代码操作配合使用。      

4. 有队列出现怎么办
   
   • 查看队列的方式 打开管理门户 - ‘Interoperability’ - ‘监视器’ - ‘队列’ 首先，查看队列计数是否是在降低，及时有队列，但是队列在正常下降，此状态为正常情况。 但是，如果队列持续升高，没有任何下降趋势，查看产生队列的相应组件的日志，查看是否是平台内部有异常出现。如果平台内部没有异常，查看第三方下游业务系统是否能正常通信。

预测平台入场服务器配置

平台服务器入场配置预测应用，以java连接iris并使用其IntegratedML技术完成对医院门诊量，服务数，消息数，消息保存时间等数据分析，可以在医院集成平台入场前，对医院入场平台所需的服务器配置进行预测，为客户提供便利。

模拟数据

平台服务器入场配置预测应用 使用IntegratedML技术，通过JDBC连接IRIS，并可使用业务流程流转消息。先导入数据，然后初始化模型，对模型进行训练，然后输入相应的条件对服务器配置进行预测。

操作步骤

• 1. 在IRIS中导入代码并进行编译

• 2. 启动 Production

• 3.运行jar包（修改配置文件）

1. 输入正确的IP端口和命名空间名称

• 4. 访问 http://localhost:9097/swagger -Ui.html

1. 区块链

当我写这篇文章时，比特币的价格还不到其成功顶峰时期的五分之一。因此，当我开始向某人讲述我的区块链经历时，我听到的第一句话是毫不掩饰的怀疑：“现在谁需要这个区块链东西？”

没错，区块链炒作已经减弱。然而，它所基于的技术将继续存在并将继续在特定领域使用。互联网通常提供大量描述这些技术的一般用法的材料

医院管理者、信息中心、业务骨干，每个角色都有独特的业务诉求，InterSystems IRIS医疗版互联互通套件专为国内用户设计，可助力医院用户释放数据价值，推动应用创新！截至目前，InterSystems技术已助力150余家医院通过四级及以上医院信息互联互通标准化成熟度评测，其中，五级乙等用户近30家。

亲爱的开发者们，

向大家分享一个好消息！InterSystems开发者中文社区版主、InterSystems高级销售工程师祝麟 ( @Nicky Zhu ) 于近日顺利通过“HL7 FHIR R4 Proficiency Exam”并取得资格认证证书！

嗨社区！

想与您分享我在Telegram中使用GPT创建“我自己的”聊天的练习。

这个应用需要用到 Open Exchange 上的两个组件：@Nikolay Solovyev 的Telegram Adapter和@Francisco.López1549的IRIS Open-AI

因此，通过此示例，您可以在 Telegram 中使用 ChatGPT 设置自己的聊天。

让我们看看如何让它发挥作用！

当数据资产已经成为医院的核心资产，如何有效利用数据核心资产，持续挖掘互联互通平台和各种数据中心的价值，成为医疗信息化工作的重中之重。欢迎扫码注册（或点击链接注册）观看多位大咖针对这一话题的解读。

您对FHIR了解多少？点击【此处】，或扫描下方图片中的二维码回答问卷，即可获赠《FHIR白皮书》。

实现医疗系统之间的互操作性是一项艰巨的挑战。随着FHIR日渐普及，对FHIR标准的兼容如今已成为许多国家医疗信息系统的全国性强制性要求。FHIR标准最有价值的一方面就是所有内容可被机器读取，使得FHIR应用跨机构使用成为可能，帮助您距离“语义互操作性”更近一步。

不同系统在“对话”时候，如何让它们明白“带黑色条纹的白马”和“带白色条纹的黑马”是同一种动物（斑马）呢？FHIR是HL7国际（HL7 International）为满足当前医疗数据环境中的互操作性需求而创建的医疗数据标准，如今已成为许多国家医疗信息系统的全国性强制性要求。本视频介绍了FHIR的设计理念和关键构成，包括FHIR资源、FHIR Profile、FHIR扩展等。

视频文字版。点击查看视频。

“数据二十条”体现了怎样的制度创新和政策智慧？FHIR将如何发挥作用？来看InterSystems亚太区总经理老卢（Luciano Brustia）与CHIMA主任委员王才有的精彩探讨！

添加凭据以登录 FHIR REST 接口 - 在这例子仅考虑基本身份验证

添加服务注册表 - 在这例子仅考虑基本身份验证

- 设置 HTTP 服务

- 输入 FHIR 服务器的路径

- 输入 FHIR 服务的 URL

- 使用配置的凭证

添加 "HS.FHIRServer.Interop.HTTPOperation"

选择服务名称

测试 FHIR 客户端

跟踪测试结果

自定义更多的Production组件的设置

本示例会在Production的组件BO（业务操作）中增加自定义的配置信息，例如添加目标系统信息，当然此类信息也可以放在已有的配置”注释“中。

为production组件新增设置信息

1. 为组件创建”目标服务器“设置信息。 现在想要为一个组件SoapDemo.BO.Operation.MyWebServiceSoap新增一个名为”目标服务器“的设置信息。
2. 在SoapDemo.BO.Operation.MyWebServiceSoap类中增加以下代码，然后编译此类。其中Info为，您想将此设置放在哪一种设置中，Info代表”信息设置“，Basic代表”基本设置“，详细信息请参考设置类型
   

   Property 目标服务器 As %String(MAXLEN = 2000, XMLPROJECTION = "ATTRIBUTE");
   Parameter SETTINGS = "目标服务器:Info";

3. 进入Production页面，刷新改页面，如下图所示，此时已经成功为组件增加 ”目标服务器“ 设置。 

获取组件设置信息

1. 使用代码从终端获取组件设置信息 使用如下代码其中”SoapDemo.BO.Operation.MyWebServiceSoap“为组件名称，”目标服务器“为设置名称。
   

   write ##class(Ens.

一个简单的生产配置，使 FHIR 交易捆绑包能够通过 Box 和 Dropbox 加载到 InterSystems® FHIR® 服务器中。使用包含的 MFT 连接组件和 14 行自定义业务流程，此生产配置会将您的交易捆绑包处理到 FHIR 资源，以便立即使用，就像哈利·波特的魔法一样。

我首先会展示该生产配置的短视频导览、MFT 连接以及 IRIS 上 Box 和 Dropbox 的 Oauth2 应用配置，接下来循序渐进地展示一些步骤，让您使用您喜欢的任何 MFT 供应商以及您选择的任何工作流程、桌面、API 或 Web 控制台拖放操作。

一些陷阱：

• OAUTH2 回调需要使用 IRIS 的 SSL 端点来提供重定向… 最好在 Health Connect Cloud 上尝试一下！
• Dropbox for Business 在基于团队的令牌方面面临挑战，个人 Dropbox 则运行良好。 这不是无法忍受的情形，但需要一些耐心。
• 配置 MFT 连接时，注意 Dropbox 的 baseurl 上的“/”（确保它存在）。
• 对于 Box 和 DropBox 的路径，MFT 出站适配器都需要具有结尾“/”。

现在，鉴于以上获奖的 OBS 支持的内容可能有不足之处，如果 InterSytems 文档还不够，下面是需要遵循的步骤。

血糖控制不佳与流产、入住 NICU、手术分娩和妊娠期较短的风险增加有关。尤其危险的是那些先前患有糖尿病的人，他们将受益于在受孕前维持接近正常的血糖。所有 DIP 患者都将从早期转诊到糖尿病服务中受益。如果要降低相关并发症、围产期死亡率和孕产妇发病率，重点将放在 DIP 的早期发现和有效治疗上，以实现血糖正常。糖尿病的早期诊断、生活方式管理和治疗将降低高血糖并发症的发生率和严重程度。

妊娠期糖尿病患者的血糖控制和妊娠结局：一项回顾性研究

连续血糖监测(CGM) 是一种全天候自我监测血糖水平的方法，这意味着用户可以在高血糖和低血糖发生时捕捉（并采取行动）。

与标准护理相比，CGM 改善了产妇糖化血红蛋白水平，降低了剖宫产率和新生儿出生体重。然而，不仅要监测血糖水平，还要跟踪异常症状并及时预约医生，这样才能提高生下健康婴儿的机会。

我们希望引入全新的医疗保健解决方案，让糖尿病诊断变得更简单、更复杂。我们相信，我们在实施 FHIR 和 IRIS 系统以处理和存储医疗数据方面的创新方法可以防止患者患上与妊娠糖尿病相关的许多进一步病症。 DiaBro将使医生能够更加关注追踪妊娠糖尿病的危险因素，并在患者病情发生致命变化时迅速采取行动。

我们已经连接了来自 FHIR 和 IRIS 的数据。主要数据（医生、预约）来自 FHIR，其他数据（应医生的要求）来自 IRIS。

1. 新的系统SQL业务服务/业务操作

接连SQL数据源和操作SQL数据目标是常见的集成业务场景。使用SQL适配器监控SQL数据源和操作SQL目标库时，我们需要开发自定义BS或BO，写不少代码。例如开发自定义SQL服务需要：

1. 开发响应消息类，用于承接SQL快照数据；

2. 开发自定义业务服务BS类，用于将SQL快照按字段赋值给对应的消息，并将消息发送给目标（业务流程或业务操作）。

而要开发自定义SQL操作，更麻烦些：

1. 开发请求和响应消息类，用于向BO传输数据和接收返回数据；

2. 开发自定义业务服务BO类，设置消息响应表，根据不同请求消息类型编写方法；

3. 在方法中根据请求消息数据拼写SQL语句；

4. 在方法中将SQL执行结果存入响应消息。

虽然很简单，但编程过程枯燥乏味。而且当修改SQL语句时，还要修改对应的消息类和BS/BO类。

从2021.2开始，InterSystems IRIS增加了2套系统通用SQL业务服务和SQL业务操作：

Hi 大家好，

我最近开始学习InterSystems IRIS 的互操作性，我发现官方文档对理解它的工作原理很有帮助，尽管我自己在实现它时仍有一些困难。在我的同事的帮助下，我成功地创建了一个系统的Demo，并从实践中学习。因此，我决定写一下文章，分享我得到的帮助，来帮助更多的其他人。

介绍

首先，让我们掌握一些基本概念:

• 互操作性 - 这个词的含义并不像它的发音那样复杂--它基本上是把各种信息从一个系统带到另一个系统的“魔术”。
• 业务主机 - 如果把互操作性比作是魔术，那么业务主机Business Host就是魔术师的魔法帽--业务主机里有能够识别和接收信息的业务服务Business Service/BS，并将其作为消息发送给业务流程BP或业务操作BO。业务操作执行所需的操作（顾名思义）并传递信息。业务流程控制着消息的流动：它们定义了消息的去向（基于你所选择的任何东西）以及它是如何被传递的。
• 适配器 - 适配器是一些我们可以用来识别和操作我们可能要处理的各种信息的类。在实践中，我们把它们作为参数和（可选）属性来访问其方法和属性

准备搭建Production

从简单的开始比较容易--让我们先想想服务和操作--比如说你有一个接收一种信息的服务，它很容易被我们唯一的操作所识别。

当生产的目的和它的部分非常清楚时，开发就比较容易。如果你愿意，画一张图或写下你希望它完成的步骤可能会有帮助。

InterSystems IRIS是一个伟大的数据平台，它满足了当前市场所需的功能。在这篇文章中，你可以看到我心目中的前10大功能:

当使用集成平台传递异步消息时，在消息查看器查看消息状态的时候会出现 ‘已放弃’（Discarded） 的消息状态。

‘已放弃’ 的消息状态出现主要有以下原因：

• 当响应的消息在响应请求超时后才到达你要发送的目的地，这条消息就成为了 ’已放弃‘ 的消息。
• 因某种原因，消息无法交付，手动将消息标记为 ‘已放弃’。
• 异步传递的消息，无需等待返回消息，这时如果配置了返回消息，这条消息也会成为 ’已放弃‘ 的消息。

注意：被标记为 ‘已放弃’的消息任然会被永久储存，只有但你明确删除它们时，消息才会被删除

如图所示，业务流程 HCC.SVR.Prod.BPMainControl 向 业务流程 HCC.SVR.Prod.BP.SubscribeAndPublish发送异步消息，如果在HCC.SVR.Prod.BPMainControl调用HCC.SVR.Prod.BP.SubscribeAndPublish，而HCC.SVR.Prod.BP.SubscribeAndPublish设置了响应消息，那么从HCC.SVR.Prod.BP.SubscribeAndPublish设置的响应消息就会成为 ’已放弃‘ 的消息

如图所示，如果在HCC.SVR.Prod.BP.SubscribeAndPublish不设置响应消息，那么就不会从HCC.SVR.Prod.BP.

亲爱的开发者们！

到了展示互操作性技术的时候了！来参加我们最新的竞赛吧！

🏆 InterSystems开发者大赛：以互操作性技术为可持续发展构建解决方案 🏆

时间: 8月29日-9月19日（北京时间）

奖金更高: $13,500 – 请留意，奖金分配跟以往有所不同！

2022年8月22日，中国 北京 —— 致力于帮助客户解决最关键的可扩展性、互操作性和速度问题的创新数据技术提供商InterSystems今日宣布在中国推出InterSystems IRIS医疗版互联互通套件2.0版，更好地满足用户对数据利用的需求。

问：

我有一个专有的JSON，需要转换为SDA并保存到一个SDA文件。

如何将json转化为SDA并写入文件？

谢谢

你好，我很高兴地宣布向OpenExchange和目前的比赛提交的一个作品，即FHIR匿名化代理。FHIR匿名化代理为任何现有的FHIR服务器增加了一个透明的匿名化层，使客户能够在FHIR服务器上进行查询--其中可能包含个人识别信息--并收到一个即时的匿名化数据版本。

代理机制是通过互操作性Production、BPLs和DTLs以及FHIR互操作性适配器在IRIS for Health平台上实现的。匿名化包括所有身份ID和个人数据，并可通过DTLs进行配置。

OpenExchange的演示应用程序带有一个内置的FHIR endpoint，并以会填充一些示例数据。试一下，或者将你自己的FHIR服务器配置为代理目标亲自测试一下 

Hi，大家好！

您曾经实施过DICOM集成吗？也许您已经百度了一些样例，甚至是模拟器。希望本文的例子能给您带来帮助。

DICOM 是一个广泛用于医疗诊断影像的消息标准。您可以使用IRIS For Health或者Health Connect在互操作性Production中使用DICOM标准，在这里您可以找到文档.

在很多情况下，当您开发一个DICOM集成时，您可以运行一个模拟器来扮演一些外部系统（如PACS），可以在连接到一个真正的系统之前充分测试您想要实现的流程，这一点真的很有用。

在这里您可以找到一个使用IRIS For Health的DICOM整合例子，还有一个叫做dcm4che的模拟器

在这个例子里, 实现了两个不同的场景:

接收嵌入PDF的DICOM消息

从PACS中查询或抽取 DICOM 影像

查询流程:

检索流程:

欢迎多提宝贵意见，谢谢！:)

在使用xDBC连接到字符集为US7ASCII的Oracle数据库时，大家可能遇到过中文的乱码问题，尤其是使用Oracle自己的xDBC驱动的时候。

字符集为US7ASCII的Oracle数据库虽然可以保存中文数据，但给客户端带来了很多麻烦，需要对获取和提交的数据进行转码。

在Ensemble/Health Connect/InterSystems IRIS 中使用SQL适配器连接到这样的Oracle数据库时，可以使用$ZCVT函数进行转码。

1. $ZCVT函数

$ZCVT函数是广泛使用的字符串转换函数，可以做大小写转换、编码转换、URL 和 URI 转换等。我们用其编码转换能力来解决字符集转码问题。

2. 获取的SQL结果集数据有中文时

这时，Oracle的驱动返回的中文数据通常是GB码，而不是Unicode或UTF码。可以通过$ZCVT函数对GB码的数据进行转码，转换为Unicode：

Set tCorrectData = $ZCVT(tOriginalData,"I","GB18030")

其中$ZCVT函数的第一个参数tOriginalData是获取到到结果集字段值；第二个参数“I”说明tOriginalData是输入字符串；第三个参数“GB18030”是说明输入字符串的字符集编码是GB18030。

InterSystems流程自动化与工作流引擎

InterSystems工作流程引擎的主要功能    2

使用InterSystems工作流程引擎    3

场景描述    3

环境配置与测试    5

任务管理    15

任务API和自定义任务用户界面    16

展望    17

15

集成平台除了集成业务系统，打通数据与业务流程外，另一个核心的功能就是流程自动化(BPA)。

流程自动化涉及几个重要的特性：

1. 流程建模
2. 流程协同
3. 决策自动化
4. 低代码工作流程自动化
5. 任务协同与任务管理

其中第4和5点都是和工作流程相关的。

什么是工作流程(Workflow)？它和业务流程(Business Process)有何区别？为何集成平台要涉及对工作流程的管理？

程序化访问 Production

要用程序编辑Production（界面），你可以使用互操作性API和SQL查询的组合。

现有的命名空间

从顶层了解你目前正在工作的命名空间和生产是很重要的。

// Object script 
// The active namespace is stored in this variable
$$$NAMESPACE 
// Print namespace
Write $$$NAMESPACE

# Python
import iris
# The active namespace is returned from this method
iris.utils._OriginalNamespace()
# Print namespace
print(iris.utils._OriginalNamespace())
>>> DEMONSTRATION

现有Production (正在或者最后一次运行的Production)

另外，知道你的Production名称是很重要的，你可以使用以下API获得名称空间中正在运行的Production。

// ObjectScript
USER>ZN "DEMONSTRATION"
// Get current or last run production
DEMONSTRATION>W ##class(Ens.

众所周知，InterSystems IRIS的产品设计理念源于互操作性（Interoperable）、稳定性（Reliable）、直观（Intuitive）、可扩展性（Scalable），在云时代，InterSystems IRIS的云上操作与本地一样便捷，令用户体验有了明显提升，除此之外，为了更高效地对InterSystems IRIS进行配置，我们还提供了哪些新特性？为了便捷地进行数据迁移，InterSystems IRIS最新版本提供了哪些解决方案？