第四十九章 开发Productions - ObjectScript Productions - 使用复杂记录映射器 - 复杂的记录映射类结构

复杂的记录映射类结构

有两个类以类似于描述记录映射的两个类的方式描述复杂的记录映射。描述复杂记录映射的两个类是：

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

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

InterSystems 已纠正了两个缺陷。

第一个缺陷可能导致 ECP 应用程序服务器挂起。此缺陷仅与 ARM 和 IBM Power 处理器相关；存在于 InterSystems IRIS®、InterSystems IRIS for Health™ 和 HealthShare® Health Connect 版本2022.1.2和2022.1.3中。该修复被标识为 DP-423661。该缺陷将在所有未来版本中得到解决。

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

定义单实例业务指标

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

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

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

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

定义简单的业务指标属性

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

第十二章 配置Production - 添加HL7序列管理器

添加HL7序列管理器

HL7消息可能由于各种原因而乱序，特别是在多个处理器处理它们时。在某些情况下，需要确保按照正确的顺序处理HL7消息。在这种情况下，可以将HL7序列管理器添加到production的适当部分。

HL7序列管理器是一个业务流程，它接受传入的HL7消息(可能来自多个源)，然后按照消息中的MSH:13 SequenceNumbers字段指定的顺序将消息转发到目标配置项。

序列管理器可以检测重复的消息和消息之间的时间间隔。它还确定顺序消息之间的时间间隔何时大到足以表明问题。它的灵敏度级别可以使用它的配置设置来调整。

要构建用于HL7消息路由生产的HL7序列管理器，必须创建并配置它，然后将其集成到生产中。本主题将解释每个步骤。

第五十八章 开发Productions - ObjectScript Productions - 测试和调试Production

本主题介绍可用于测试和调试产品的工具。该信息对于故障排除和调整企业已在使用的Production软件也很有用。

纠正Production问题状态

如果Production暂停或出现问题，请阅读本节。

暂停Production

当Production在队列中的所有异步消息可以被处理之前停止时，就会发生暂停Production。如果不手动清除这些异步消息，它们会在Production开始备份时自动处理。如果希望处理消息，则在开始暂停Production之前不需要其他步骤。

第五十章 开发Productions - ObjectScript Productions - 高效处理批量记录

高效处理批量记录

RecordMap 功能一次导入一条记录，但如果正在导入或导出大量记录，则可以通过使用 RecordMap Batch 获得显着的效率提升。 RecordMap Batch 功能处理同类记录并一次处理一批中的所有记录。可以选择在批次之前加上一个标题记录，然后跟一个尾部记录。

要创建 RecordMap 批处理，需要实现一个继承自中的 %Persistent 和 EnsLib.RecordMap.Batch的类。 Batch 类包含处理解析和写出与特定批次关联的任何标头和尾部的方法。必须提供解析和编写标头的代码。对于简单的表头和表尾，可以使用类中的 EnsLib.RecordMap.SimpleBatch，它继承自 Batch 类，并提供处理简单表头和表尾的代码。如果需要处理更复杂的标头和尾数据，可以扩展这两个批处理实现中的任何一个。

第三章 HL7 架构和可用工具 - 使用 HL7 架构结构页面

使用 HL7 架构结构页面

通过 HL7 架构页面，可以导入和查看 HL7 版本 2 架构规范。要显示此页面，请从主页中选择互操作性 > 互操作 > HL7 v2.x > HL7 v2.x 架构结构。有关使用此页面的一般信息，请参阅在产品中使用虚拟文档中的“使用架构结构页面”。

HL7 模式页面提供了一个附加选项卡：消息类型。此选项卡将两个消息结构标识为请求/响应对。

查看文档类型列表

要列出某个类别中的所有文档类型结构，请首先选择该类别，然后单击“DocType 结构”选项卡。

医院目前即将使用iris2023.1；里面包含了%External.Messaging.KafkaClient 类，需要设置kafka的链接，发送kafka消息，然后断开链接，能否跟springboot 一样；自动配置，kafka的链接交给iris来管理，保持长链接，不要断开；直接使用%External.Messaging.KafkaClient 发送消息；

第五十六章 开发Productions - ObjectScript Productions - 不常见的任务 - 在适配器类中包含凭据

在适配器类中包含凭据

要在适配器类中包含生产凭证，请在类定义中执行以下操作：

• 包括名为 Credentials 的设置。
• 定义一个名为 CredentialsSet() 的方法，该方法使用 Credentials 设置的值作为键来查找 Credentials 表中的用户名和密码。然后实例化一个包含用户名和密码的凭据对象。

覆盖Production凭证

虽然Production凭证系统集中管理并将登录数据保留在源代码之外，但有时需要编写代码以从其他来源获取凭证。例如，代码可能会从 Web 表单或 cookie 中检索用户名和密码，然后将它们与 HTTP 出站适配器一起使用以连接到其他站点。

第五十三章 开发Productions - ObjectScript Productions - 不常见的任务 - 使用 Ens.Director 访问设置

使用 Ens.Director 访问设置

即使production未运行，类中的以下 Ens.Director 方法也允许检索生产设置：

GetAdapterSettings()

返回一个数组，其中包含所标识的配置项（业务服务或业务操作）的所有适配器设置的值。该数组由设置名称下标。可以使用 IRIS $ORDER 函数来访问数组的元素。此方法的第一个参数是一个字符串，其中包含由两个竖线 (||) 分隔的产品名称和配置项名称。返回值是状态值。如果状态值不是 $$$OK，则无法找到指定的生产名称 (myProd) 和配置项名称 (myOp) 组合。

我们最近发布了 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) `

第三十一章 Classes - 继承规则

继承规则

与其他基于类的语言一样，可以通过继承组合多个类定义。 类定义可以扩展（或继承）多个其他类。这些类又可以扩展其他类。

请注意，类不能继承 Python 中定义的类（即 .py 文件中包含的类定义），反之亦然。

以下小节提供了中类继承的基本规则。

继承顺序

使用以下继承顺序规则：

1. 默认情况下，如果在多个超类中定义了给定名称的类成员，则子类将从超类列表中最左边的类中获取定义。
2. 如果类定义包含 Inheritance = right，则子类从超类列表中最右侧的类中获取定义。

由于历史原因，大多数类都包含 Inheritance = right。

主要的超类

任何扩展其他类的类都有一个主要超类。

无论类使用哪种继承顺序，主超类都是第一个，从左到右阅读。

对于任何类级编译器关键字，给定类使用其主超类中指定的值。

对于持久化类来说，主超类尤其重要。

第二十二章 Classes - 调用类方法的快捷方式

调用类方法的快捷方式

使用 ObjectScript 调用类方法时，在以下情况下可以省略包（或更高级别的包）：
- 引用是在一个类内，并且被引用的类在同一个包或子包中。
- 引用位于类内，并且该类使用 IMPORT 指令导入包含引用的类的包或子包。
- 该引用位于方法内，并且该方法使用 IMPORT 指令导入包含引用的类的包或子包。

从 ObjectScript 或 Python 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

第二十三章 Classes - 属性

形式上 IRIS 有两种属性：

• 属性，保存值。该值可以是以下任意值：

  • 单个文字值，通常基于数据类型。
  • 对象值（包括集合对象和流对象）。
  • 多维数组。这种情况不太常见。

  属性一词通常仅指作为properties的attributes，而不是指具有关联的属性。

• 关系，保持对象之间的关联。

可以在包含 ObjectScript 方法、Python 方法或两者组合的类中定义属性。但是，无法从 Python 方法访问关系。本节展示了一个示例类，其中包含显示以下一些变体的属性定义：