第二十九章 开发Productions - ObjectScript Productions - 定义业务操作 - 定义消息处理程序方法

定义消息处理程序方法

当创建业务操作类时，通常最大的任务是编写用于此适配器的消息处理程序，即接收生产消息的方法，然后调用适配器的方法以便与生产之外的目标进行通信。

每个消息处理程序方法都应具有以下签名：

Method Sample(pReq As RequestClass, Output pResp As ResponseClass) As %Status

这里Sample是方法名，RequestClass是请求消息类名，ResponseClass是响应消息类名。

通常，该方法应执行以下部分或全部操作：

1. 可选地设置业务操作类的属性（在任何适当的时间）。请参阅业务运营属性。
2. 检查输入对象。
3. 创建响应类的实例。
4. 调用适配器的适用方法。这些方法可通过业务操作的 Adapter 属性使用。例如：

    Set tSc=..Adapter.SendMail(email,.pf)

在这些步骤之后讨论此方法。

或者，要将消息发送到Productions中的目标，请参阅将消息发送到Productions中的目标。

5. 检查响应。
6. 使用响应中的信息创建响应消息（Ens.Response 在的实例），该方法将其作为输出返回。
7. 确保设置输出参数 (pOutput

嗨社区！

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

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

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

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

嗨社区！

我们已经到了#GlobalSummit23 的尾声——最后一天！这是我们的一天——程序员的一天。今天的主题演讲都致力于开发人员、他们的成长、抱负和创新。

如果您已经使用%UnitTest 框架构建了单元测试，或者正在考虑这样做，请查看InterSystems 测试管理器Test Manager。

无需离开 VS Code，您现在可以浏览单元测试、运行或调试它们，并查看之前的运行结果。

InterSystems 测试管理器适用于 ObjectScript 扩展支持的两种源代码位置范例。您的单元测试类可以在 VS Code 的本地文件系统（“客户端编辑”范例）或服务器命名空间（“服务器端编辑”）中掌握。在这两种情况下，实际测试运行都发生在服务器命名空间中。

欢迎反馈。

你好社区！

今天我继续我的全球峰会活动，欢迎你们来到第二天。

上午的演讲专门针对 IRIS 数据平台（太棒了！）。

Scott Gnau 首先解释了为什么 IRIS 被称为 IRIS。我居然才知道！

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

第二十七章 开发Productions - ObjectScript Productions - 定义业务流程 - 关键原则

关键原则

在开发业务流程时，请考虑以下关键原则：

• 有时希望使响应对象成为传入请求对象的修改版本，分阶段进行修改可能很有用。但是，不要修改传入的请求对象。而是将其复制到上下文变量（或者，对于自定义业务流程，将数据复制到局部变量）。然后修改副本。
• 同步发送消息时要小心（只能在自定义业务流程中或 BPL 中的 中执行）。

当业务流程A同步调用业务流程B时，流程A不会继续，直到收到响应。如果进程 A 需要完成对其他进程 (B) 的调用才能完成自身，并且如果这些进程共享参与者作业池，则如果没有空闲的参与者作业来处理被调用的业务流程，则参与者池可能会陷入死锁（ B).

发生这种情况是因为在被调用业务流程返回之前，调用业务流程无法完成并释放参与者作业，但被调用业务流程无法执行，因为没有空闲的参与者作业来执行它。

另请注意， IRIS 无法在真正的同步调用期间关闭。

最好使用 SendRequestAsync() 并在 OnResponse() 方法中处理响应消息。如果需要同步调用，可以通过配置被调用的业务流程（B）使用自己的作业池来避免这个问题。

• 如果单一作业业务流程发出请求并等待响应，则该流程将失去 FIFO 功能。

大家好！

我相信很多人都希望出席 2023 年全球峰会，但出于某种原因无法出席。以下是对 6 月 4 日和 5 日发生的事情的简要回顾。

各位老师好！

         如下两图，是HL7信息体，在形成消息之前，我们一般会先制定文档，包括消息题、消息段、阈值；但是最终在Ensemble中形成的消息是怎么一个过程？

第二十四章 开发Productions - ObjectScript Productions - 定义业务服务

本页介绍如何定义业务服务类。

提示： IRIS® 提供使用特定入站适配器的专用业务服务类，其中之一可能适合需要。如果是这样，则不需要编程。有关部分列表，请参阅 Introducing Interoperability Productions 中的连接选项。

介绍

业务服务负责接受来自外部应用程序的请求到 IRIS。下图显示了它是如何工作的：

请注意，此图仅显示数据的输入流，而不是可选响应。

业务服务负责以下活动：

• 等待特定的外部事件（例如来自应用程序的通知、收到 TCP 消息等）。
• 读取、解析和验证伴随此类事件的数据，
• 如果需要，返回对外部应用程序的确认，表明已收到事件。
• 创建请求消息的实例并将其转发到适当的业务流程或业务操作以进行处理。

业务服务的目的通常是接收数据输入。在大多数情况下，业务服务有一个与之关联的入站适配器。但是，在某些情况下不需要适配器，因为应用程序能够将请求消息发送到服务中，或者因为业务服务已被编写为处理特定类型的外部调用，例如来自复合应用程序的调用。这种类型的业务服务称为无适配器业务服务。

当业务服务具有入站适配器时，它处于数据拉取（而不是推送）模式。在这种模式下，业务服务会定期轮询适配器，看它是否有数据。

InterSystems 支持的硬件OS平台更新 2023年2季度

我们经常收到有关 InterSystems IRIS 数据平台支持的平台和框架列表最近和即将发生的变化的问题。此更新旨在分享最近的更改以及我们对即将发生的更改的已知的情况，但预测未来是一项棘手的工作，不应将其视为承诺的路线图。

话虽如此，关于更新……

IRIS 生产操作系统和 CPU 架构

红帽企业 Linux

• 近期变动
  
  • RHEL 9.2 和 RHEL 8.8 于 2023 年 5 月发布。Red Hat 计划为这些版本提供 4 年的支持。 InterSystems 计划通过我们称为“次要操作系统版本认证”的新流程对 RHEL 9.2 上的 IRIS 进行额外测试，该流程旨在提供额外的安全性，即次要操作系统更新不会破坏任何明显的内容。
  • 随着 RHEL 9.2 的发布，Red Hat 终止了对 RHEL 9.1 的支持。这与 Red Hat 自 RHEL 8.0 以来一直使用的“奇数/偶数”支持周期一致。
  • RHEL 8.4 扩展维护将于 2023 年 5 月 31 日结束，这意味着 IRIS 也将在那时停止支持此次要版本。

• 即将发生的变化
  
  • RHEL 9.3 计划在今年晚些时候推出。这将是 Red Hat 的短期支持版本，因此 InterSystems 不会推荐将其用于生产部署。

Hi 开发者们！一年一度的 InterSystems IRIS 开发者大奖赛已启动！

我们非常高兴地邀请大家参加此次编程大赛——使用 InterSystems IRIS 数据平台构建开源解决方案！

🏆 InterSystems 2023 年度编程大奖赛🏆

时间： 2023年6月12日-7月9日（美国东部时间）

奖金池： 26,000 美元

第二十一章 开发Productions - ObjectScript Productions - 延迟发送

延迟发送

除了同步（等待）和异步（不等待）的直接选择之外，还可以使用称为延迟响应的机制在 IRIS 之外发送消息。

假设一个业务流程希望在 IRIS 之外调用一个动作。它向业务操作发送请求，业务操作执行调用并返回响应。业务流程是任何响应的预期接收者；业务操作只是请求发出和响应进来的方式。如果业务流程同步发出请求，或者如果它发出请求并请求异步响应，业务操作将中继回响应。下图总结了这种机制。

现在假设从业务流程接收请求的业务操作已被编写为使用延迟响应功能。原始发件人不知道响应将被业务操作延迟这一事实。延迟响应是业务运营开发人员做出的设计决策。如果业务操作确实延迟了响应，那么当原始发送者在延迟期结束时收到响应时，它不知道响应曾经被延迟过。

业务操作通过调用其 DeferResponse() 方法来生成表示原始发送者和原始请求的令牌来延迟响应。业务运营还必须找到一种方法将此令牌传达给外部实体，然后外部实体负责将此令牌包含在对 IRIS 的任何后续响应中。例如，如果外部目的地是电子邮件，业务操作可以在外发电子邮件的主题行中包含令牌字符串。接收此电子邮件的实体可以从请求主题行中提取此令牌，并在响应主题行中使用它。在下图中，项目 t 代表此令牌。

第二十章 开发Productions - ObjectScript Productions - 指定设置的默认值

当定义业务主机类（可能还有适配器类）时，应该考虑如何控制这些项目的任何设置的默认值。 IRIS 可以从三个来源之一获取设置的默认值：

• production定义。
• 为 IRIS 实例定义的值，但存储在production定义之外。有关信息，请参阅配置制作中的定义制作默认值。
• 主机类中定义的属性的默认值。在这种情况下，默认值由 InitialExpression 属性关键字确定。

某些设置取决于环境，例如 TCP/IP 地址或文件路径；通常，将这些设置配置为在生产之外提供它们的源，而其他设置（例如 ReplyCodeActions）是设计决策，并且很可能开发应用程序以从生产定义中检索这些设置。

可以开发作品，使配置设置来自不同的来源。主要目的是更轻松地将制作从一个 IRIS 实例转移到另一个实例，例如从测试转移到现场。

定义生产后，可以在管理门户的生产配置页面上更改生产和业务主机设置的来源。有关详细信息，请参阅配置制作。

默认设置的使用允许在Productions定义之外定义Productions和业务主机设置，可以在生产升级期间保留它们。为了便于更新产品或将产品从一个系统移动到另一个系统，可以省略设置并从系统上安装的结构中获取它们的值。

使用sql访问数据库时，如何对sql语句进行加密？

我在官网上提供的java方式访问cache下载了一个示例代码 下载地址为：https://gettingstarted.intersystems.com/language-quickstarts/java-quick…

我在示例代码中看到有这样一种调用 irisNative.functionString("functionName", "routineName") ，请问functionName和routineName主要指什么东西，我在studio中创建了routine，但是也不需要通过functionName来访问呀。

各位老师好，安装IRIS测试版时出现以下问题：

cache数据库如何收集慢SQL？

问题如标题。尝试过改变java网关端口，还是会经常出现报错，错误如下图：

在使用jdbc 查询过程中 出现报错 [Cache Error: <<WIDE CHAR>Fetch2+4^%sqlcq.DHCdAPP.3726>]，这个可能原因是什么

Manifest也许应该被翻译成“清单”， 字典上是这么解释的： 提供船舶及其货物和其他物品、乘客和船员的全面细节的文件，供海关官员使用，比如：飞机上的乘客或货物清单； 一辆货运列车的车厢清单。

在计算机语言中， Manifest可以是各种格式，用的最多的是xml和json，在IRIS中，manifest是xml格式的， 放在objectscript类的XDATA块里。

编写mainfest

IRIS用manifest来做配置。内部工具*%install*, 会读取manifest, 生成真正的objectscript代码来配置IRIS。我们来看个基本的例子。

基本用法

下面的User.Manifest.cls` ,它配置了IRIS的global buff, bbsize等等, 然后还创建了一个命名空间。

Include %occInclude
Class User.Manifest
{

ClassMethod setup(ByRef pVars, pLogLevel As %Integer = 3, pInstaller As %Installer.Installer, pLogger As %Installer.

开发者们可以让轻松让全世界了解他们如何与Epic软件进行连接

2022年12月，全球排名第一的电子病历厂商Epic宣布发布Connection Hub供应商服务平台，供全球供应商来分享他们与Epic软件实现互操作能力的平台。

这个新网站于2023年1月9日开放，将允许所有与Epic有连接的供应商列出他们的应用，并自我报告他们是否已经实现了成功的数据交换。网站访问者，包括Epic客户，可以看到供应商提供的信息，如应用描述和网站链接。

Connection Hub将对所有供应商开放，目的是使供应商更容易加入其在线产品目录。希望被列入名录的供应商可以通过提供他们的信息和完成一个可选填的问卷来加入。除了Connection Hub，Epic还将推出供应商服务--提供Epic的新闻通讯、详细的教程、扩大的测试沙盒和技术支持的访问。

EPIC现有应用市场将进行更新并计划在今年晚些时候重新启动。 目前在应用市场的供应商将自动迁移到Connection Hub供应商服务平台。所有连接将不会受到影响，在应用市场中接受服务、API和测试工具的供应商将继续通过Connection Hub进行。对于那些目前在应用市场中列有实时连接的供应商，EPIC将为他们提供一个简单的方法，将其现有信息转移到Connection Hub。

Connection Hub代表了Epic对开放标准持续支持的又一步骤。

运行池的机制和组件运行池的建议配置大小

题外话：我刚刚翻译了InterSystems专家Bob Binstock的Caché Mirroring 101：简要指南和常见问题解答。 尽管题目是Caché Mirror 101, 而且是写于2016年，但因为讲解的都是Mirror的基本原理，所以在大量使用IRIS的今天也完全适用。

前面的3篇文章，包括了配置Mirror的各个方面。如果您照着操作，现在已经有了一个工作的mirror环境，并加入了您的数据库。然而，还没完，这篇我来讨论一下后面的工作，首先的问题是：

Mirror不复制什么

简单说，Caché/IRIS镜像是数据库复制(Database Replication)。在Caché/IRIS里什么是数据库？也就是Cache.dat和iris.dat文件。数据库的修改日志，也就是journal，从主机被传送到其他镜像成员。而除此之外的内容，需要维护人员来分别的个个处理， 解决这些内容在各个镜像成员间的拷贝。需要很多的计划和细心。

系统数据库, 包括IRISSYS, IRISTEMP, IRISLIB等等, 这些Caché/IRIS本身的数据库不应该被加入Mirror，在大多数Caché/IRIS版本里也都设置成不可以加入入MIRROR。

第十五章 开发Productions - ObjectScript Productions - 开发Productions介绍

互操作性产品允许连接可能使用不同通信协议和不同消息格式的系统。可以使用 Java、.NET、ObjectScript、SQL 或业务流程、数据转换和业务规则的图形编辑器来开发产品。

文档

• 互操作性生产概述
• 在 ObjectScript 中开发
• 使用 PEX 在 Java 或 .NET 中开发
• 使用 SQL
• 业务流程 (BPL)
• 数据转换 (DTL)
• 业务规则
• 配置生产
• 使用推送通知定义工作流

在线内容

• ObjectScript：开发系统集成
• ObjectScript：构建自定义业务组件
• 创建数据转换

开发Productions介绍

本页介绍产品开发的过程。

环境考虑

只能在具有特定 Web 应用程序的支持互操作性的名称空间内使用 IRIS 互操作性。创建类时，应避免使用保留的包名称。以下小节提供了详细信息。

支持Production的命名空间

支持互操作性的名称空间是具有全局映射、例程映射和包映射的名称空间，这些映射使支持产品的类、数据和菜单对其可用。有关映射的一般信息，请参阅系统管理指南中的配置命名空间。

安装 IRIS 时创建的系统提供的名称空间不支持互操作性，但在社区版中，USER 名称空间是支持互操作性的名称空间。

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

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

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