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

延迟发送

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

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

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

第三十五章 开发Productions - ObjectScript Productions - Defining Business Metrics - 定义单实例业务指标

定义单实例业务指标

要定义单实例业务指标，请定义一个满足以下要求的类：

• 它必须是 Ens.BusinessMetric的子类。

对于此类，ADAPTER 参数是 Ens.InboundAdapter，它提供了 CallInterval 设置。这确保定期调用业务指标。

• 它必须定义一个或多个业务度量属性。简单属性和具有自动历史的属性的细节不同。
• 它可以选择性地为属性参数指定值，例如，以控制值的范围。
• 它必须为业务度量属性分配值。为此，它必须实施 OnCalculateMetrics() 方法。

定义简单的业务指标属性

要定义一个简单的业务指标属性，请将一个属性添加到业务指标类，如下所示：

第十一章 配置Production - 集成和配置 HL7 业务服务

集成和配置 HL7 业务服务

要将新的 HL7 业务服务集成到production中，必须将其与其中继消息的路由流程或业务操作相关联。此外，如果希望业务服务接收非标准消息结构，将需要创建自定义 HL7 架构定义来解析和验证这些消息。去做这个：

我们最近发布了 IRIS 2023.2版本。
此版本从此类“HS.HC.Util.Installer”中删除了“InstallFoundation”。
这是一个没有记录在官方文档中的私有的方法，但它被社区广泛用来安装 FHIR 服务器。
所以如果你遇到这个错误：<METHOD DOES NOT EXIST> *InstallFoundation,HS.HC.Util.Installer
在构建我们自己的 FHIR 服务器的演示时，您可以通过替换此行来修复它：
把do ##class(HS.HC.Util.Installer).InstallFoundation (namespace) 替换成 Do ##class(HS.Util.Installer.Foundation).Install(namespace) `

第三章 使用$ZF(-100)运行程序或系统命令

$ZF(-100)函数允许 IRIS 进程调用可执行程序或主机操作系统的命令。这是唯一可以在没有特殊的Callout共享库的情况下使用的$ZF函数。

• $ZF(-100)的语法和功能概述。
• 程序执行-程序可以选择异步运行或在操作系统外壳中运行。
• 记录命令和重定向输出——可选设置可以记录命令或重定向I/O。
• 添加%System_Callout:USE特权—使用$ZF(-100)需要此特权。

注意:$ZF(-100)取代了已弃用的函数$ZF(-1)和$ZF(-2)，在所有情况下都应优先使用。

SQL Performance Analysis Toolkit，或者叫SQL性能分析工具，并不是给维护人员使用的。

在RIS文档里是这么说的： 这个工具包里的工具收集SQL执行的详细信息，用来找出一个查询计划的特殊问题。 使用这些信息，开发人员改善这个查询的效率。 它可以非常大的增加服务器的开销。..., 它不应该被持续执行。

要做分析，首先您需要打开一个采集“SQL runtime Statistics"的开关来收集详细信息，这个开关默认的状态是OFF。 文档里说： The SQL Performance Analysis Toolkit offers support specialists the ability to profile specific SQL statements or groups of statements.

这里的"support specialists"指的是厂家的技术支持人员。

因此，总结如下：

第三十八章 开发Productions - ObjectScript Productions - Defining Business Metrics - 业务指标中的其他选项

业务指标中的其他选项

本节介绍业务指标类中的其他选项。

定义在仪表板中使用的操作

业务指标类可以定义操作，可以将这些操作公开为仪表板中的用户选项。一个操作可以执行客户端活动（例如过滤和刷新仪表板）和服务器端活动（例如调用您自己的 API）的组合。作用机制很一般。

要定义操作，请实施业务指标类的 %OnGetActionList() 和 %OnDashboardAction() 方法。有关这些方法的信息，请参阅实施 商业智能中的定义自定义操作。

在之前的文章中，我们已经了解了如何配置和自定义我们的 EMPI，我们已经了解了如何通过 HL7 消息传递将新患者纳入我们的系统中，但当然，并不是所有的东西都是 HL7 v.2！我们如何配置 EMPI 实例以使用 FHIR 消息传递？

什么是FHIR？

对于那些不太熟悉 FHIR 这个术语的人，只需指出它们是Fast Healthcare Interoperability Resource的首字母缩写即可。 FHIR是HL7制定的医疗保健互操作性标准，基于JSON格式和REST通信，建立了一系列不同类型信息（患者数据、医院中心、诊断、医疗预约......）的“资源”。您可以在他们的官方页面上查看所有这些资源

第四章 IRIS 编程简介 - Macros

Macros

ObjectScript 还支持定义替换的宏。定义可以是一个值、整行代码或（使用 ##continue 指令）多行。使用宏来确保一致性。例如：

#define StringMacro "Hello, World!"

write $$$StringMacro

Include Files

可以在例程中定义宏，并稍后在同一例程中使用它们。更常见的是，在中心位置定义它们。为此，需要创建并使用包含文件。包含文件定义宏并且可以包含其他包含文件。

第二十七章 Classes - 引用其他类成员

引用其他类成员

在方法中，使用下面的语法来引用其他类成员:

• 要引用ObjectScript中的参数，使用如下表达式:

 ..#PARAMETERNAME

只能使用ObjectScript直接访问参数。要从Python访问参数，请使用ObjectScript包装器方法返回参数，并在需要时调用此方法。例如:

索引分析器工具用来分析索引的使用情况，对DBA和开发者非常有用。 他们需要知道那些查询进行了全表扫描，那些查询缺失了索引， 而那些索引从来又从来没有被用过。多余的索引降低系统性能，浪费了磁盘空间。

索引使用情况

到“管理门户”的" 系统 > SQL 性能工具 > SQL 索引分析器", 点击“索引使用情况”， 您将看到这样的图

执行SQL语句查询会带来更多的灵活性。上面的查询可以写成下面这个SQL,

SELECT TableName, indexname, UsageCount
FROM %SYS_PTools.UtilSQLAnalysisDB order by usagecount desc

2016年以后的Caché版本就已经有了'索引使用情况'的查询。使用管理门户没有区别， 但SQL语句不同，使用的是比较老的类和表名，各位请参考文档。

第六十三章 开发Productions - ObjectScript Productions - 部署Production - 在目标系统上部署Production

管理门户自动执行将Productions从开发系统部署到实时系统的过程。本节介绍当在实时系统上加载Productions的新版本时，IRIS 会执行哪些操作。

获得部署包 XML 文件后，可以将其加载到目标系统上。在管理门户中，选择正确的命名空间并单击互操作性、管理、部署更改、部署，然后单击打开部署或打开本地部署按钮，具体取决于 XML 部署包位于服务器上还是本地计算机上。如果位于服务器计算机上，则“打开本地部署”按钮不处于活动状态。选择 XML 部署包文件后，表单会列出部署包中的新项和更改项，显示创建包时指定的部署说明，并允许指定以下部署设置：

第五章 ObjectScript

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

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

示例类

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

昨天，我在一个客户网站提供从 Studio 迁移到 VS Code 的定制咨询时，就遇到了这种情况。

该站点的服务器已配置为使用delegated authentication，但尚未针对 /api/atelier Web 应用程序设置“delegated”复选框，而 InterSystems ObjectScript 扩展包的成员正是使用该复选框进行连接的。

一旦我们的应用程序设置了其复选框并单击了服务器管理器刷新按钮，就可以在服务器上枚举命名空间。