前言

生产环境下我们部署和使用IRiS引擎，往往采用其主备镜像模式，虽然此架构简单但是往往我们需要持续在电脑前点击或者操作1到2小时，如果中间有个环节出现了问题有时我们可能需要部署一天.

接下来我分享的是IRIS自带的一个功能帮助我们部署---manifest-安装清单。他的主要使用方式是提前通过配置约定好我们期望的安装设置，在安装的过程中由IRIS程序直接执行脚本，简化IRIS集群的部署，减少运维人员的操作步骤，让我们有更多的精力放在实际项目和业务上。

这是在 IRIS 中完全运行向量搜索演示的尝试。
没有外部工具，您需要的只是终端/控制台和管理门户。
特别感谢Alvin Ryanputra作为他的软件包iris-vector-search的基础
灵感和测试数据的来源。
我的软件包基于 IRIS 2024.1 版本，需要注意您的处理器功能。

我尝试用纯 ObjectScript 编写演示。
仅描述向量的计算是在嵌入式Python中完成的

计算 2247 个记录的 384 维向量需要时间。
在我的 Docker 容器中，它正在运行 01:53:14 来完全生成它们。

浅谈一下个人基于IRIS后端业务开发框架的理解

现状

由于国内使用基于M语言IRIS平台几乎都在医疗行业。医疗系统又非常的庞大和复杂。前期由于快速占领市场，系统数量越来越多，到了临界点后就产生了质变，所以前期基于功能的线性开发注重效率，所以导致大量的产品业务代码有如下集中情况：
- 系统交互乱如麻，各系统的交互关系变成了网状。
- 系统规模庞大，内部耦合严重，牵一发而动全身，后续修改和扩展困难，开发效率低。
- 关键功能逻辑复杂，容易出现问题，出现问题后很难排查和修复，开发成本高。
- 功能越来越多，导致系统复杂度指数级上升。

- 重复造轮子，相似的功能不断重复开发。

如上图所示，这仅仅是展示了五个模块之前的交互，在此基础上继续增加模块则复杂度成指数级上升，并且如果每个模块之间如果没有做好接口管理，维护起来也是地狱级别。

在上一篇文章中，我们看到了如何捕获位于我们服务器上一个文件夹中的DICOM类型的文件，以及如何将它们发送到PACS软件（在我们的案例中是ORTHANC开源解决方案）进行存储和咨询。那么，在这篇文章中，我们要处理的是相反的动作。

在我们的例子中，我们将配置我们的IRIS for Health Prodcution，以接收从我们的PACS通过TCP/IP发送的图像。要做到这一点，我们必须包括一个标准EnsLib.DICOM.Service.TCP类的业务服务，它将允许我们配置接收端。让我们来看看这个配置：

如您所见，我们已经声明了将监听的端口，通过该端口将接收从 PACS 发送的图像。我们还配置了本地 AET （Application Entity Title，应用实体名称）(IRIS) 和将向我们发送 DICOM (ORTHANC) 的 PACS，请记住这些字段是强制性的，并且将用于检查发送和接收 DICOM 消息的有效性。不要忘记必须从 DICOM 设置菜单配置和关联两个 AET：

亲爱的开发者们，

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

第五十九章 开发Productions - ObjectScript Productions - 测试和调试Production - 从管理门户进行测试

从管理门户进行测试

可以使用管理门户在开发、测试和调试Production时执行多项任务：

• 能够查看和修改系统配置。
• 能够启动和停止Production。
• 能够查看队列及其内容；消息及其详细信息；适配器和参与者及其状态；业务流程及其状态；配置项的代码和图形表示。
• 能够查看、排序和有选择地清除事件日志条目。
• 能够暂停（并稍后重新发送）连接暂时被阻止的消息。
• 能够使用图形用户界面或通过输入 SQL SELECT 命令，按类别或消息内容过滤和搜索消息仓库中的特定消息。
• 能够使用图形用户界面直观地跟踪消息活动。
• 能够创建和查看统计报告。

对于开发人员来说，最有用的门户功能是不断收集运行时数据的监视服务、可用于向正在开发的产品发出模拟请求的测试服务以及记录业务主机发出的状态消息的事件日志。同时使用这些功能来生成测试数据并研究结果。

第五章 ObjectScript

方法和例程都可以用 ObjectScript 编写，但大多数现代代码都是使用方法编写的。方法包含在类中，这允许将类似的方法分组在一起，在类参考中自动生成文档，以及使用 IRIS 的面向对象功能。

这并不意味着routines 不重要。许多有用的系统实用程序都是作为例程编写的，并且在编译类时会生成例程。

示例类

下面显示了一个名为 User.DemoClass 的示例类，其中包含用 ObjectScript 编写的方法。此示例使我们有机会了解一些常见的 ObjectScript 命令、运算符和函数，并了解代码在方法内的组织方式。

2023年6月底，世卫组织(WHO)和HL7签署了合作协议，利用HL7 FHIR提供互操作性，来支撑WHO的SMART指南(SMART Guideline)愿景 - 使用数智化的方式推动并加速一致化的健康干预措施建议，让

第十五章 创建Callout Library - 处理 UNIX 信号处理错误

处理 UNIX 信号处理错误

在 UNIX 及相关操作系统下运行时，如果进程收到信号，某些系统调用可能会失败，最常见的是打开、读取、写入、关闭、ioctl 和暂停。如果函数使用任何这些系统调用，代码必须能够区分真正的错误、Ctrl-C 和应重新启动的调用。

以下函数允许检查异步事件并在 $ZF 中设置新的警报处理程序。函数声明包含在 iris-cdzf.h 中：

sigrtclr()

int sigrtclr(); — 清除重试标志。应在使用 sigrtchk() 之前调用一次。

dzfalarm()

int dzfalarm(); — 建立新的 `SIGALRM 处理程序。

进入 $ZF 时，会自动保存先前的处理程序。退出时会自动恢复。用户程序不应改变任何其他信号的处理。

第四十五章 开发Productions - ObjectScript Productions - 使用记录映射器 - 记录映射类结构

记录映射类结构

有两个类描述记录映射：

• RecordMap 描述了记录的外部结构，实现了记录解析器和记录编写器。
• 生成的记录类定义了包含数据的对象的结构。该对象允许在数据转换和路由规则条件中引用数据。

记录映射业务服务读取并解析传入数据并创建一条消息，该消息是生成的记录类的一个实例。业务流程可以读取、修改或生成生成的记录类的实例。最后，记录映射业务操作使用实例中的数据将 RecordMap 用作格式化模板来写入传出数据。 RecordMap 类和生成的记录类都具有描述数据的层次结构，但生成的对象结构不必与 RecordMap 结构相同。

第十章 配置Production

本章介绍如何配置产品以包含 HL7 路由接口。它还描述了如何创建新的 HL7 路由制作。

创建新的 HL7 路由Produtcion

可以创建一个新的HL7路由产品，如下所示:

1. 在Management Portal中，切换到适当的名称空间。

为此，请在标题栏中选择Switch，单击名称空间，然后单击OK。

第十九章 ObjectScript - 执行例程

执行例程

执行例程时，使用DO命令，如下所示:

 do ^routinename

要执行一个过程、函数或子程序(不访问其返回值)，可以使用以下命令:

 do label^routinename

或

 do label^routinename(arguments)

要执行过程、函数或子例程并引用其返回值，可以使用$$label^routinename或$$label^routinename(参数)形式的表达式。例如:

 set myvariable=$$label^routinename(arguments)

在所有情况下，如果标签位于同一个例程中，则可以省略插入符号和例程名称。例如:

第三十五章 XML 模式的高级选项 - 创建子类型的选择列表

创建子类型的选择列表

根据 XML Schema 规范，复杂类型可以由类型（特别是相关类型）的选择列表组成。假设我们希望架构允许使用 <Person>, <Patient>, or <Employee> 元素，而不是 <Person> 元素。要定义这样的架构，我们会将 Person 属性的 XMLTYPECONSTRAINT 属性参数设置为等于“CHOICE”，如下所示：