第五章 修改实现（IMPL）类

本章讨论如何修改 REST 服务的实现类。

初始方法定义

实现类最初包含存根方法，如下例所示：

ObjectScriptt至少有三种处理错误的方法（状态代码status codes、异常 exceptions, SQLCODE等）。大多数系统代码使用状态码，但由于一些原因，异常更容易处理。在处理遗留代码时，你要花一些时间在不同的技术之间进行转换。我经常使用这些片段作为参考。希望它们对其他人也是有用的。

第六章 配置命名空间（一）

命名空间是虚拟工作空间中的数据和程序的集合。在命名空间中，可以定义各种组或人员需要的全局变量Global。例如，如果审计部门需要使用存在于不同系统或不同目录中的某些全局变量Global，可以设置一个单一的命名空间来引用网络上的所有会计全局变量和数据库。

IRIS 带有以下预定义的命名空间：

• %SYS — 系统管理信息和实用程序。
  -USER — 安装时为空。通常用于应用程序开发。

可以在管理门户的命名空间页面上执行以下过程来配置命名空间，可以通过在主页上依次选择系统管理、配置、系统配置和命名空间来导航到该页面：

第二十章 控制进程（一）

IRIS 系统运行多个进程。应用程序代码以及 IRIS 系统代码在这些进程中执行。 IRIS 进程分为三类：
- 用户进程，在用户连接到 IRIS 时创建。
- 后台进程，在用户发出 ObjectScript Job命令时创建，或者由管理门户或实用程序创建。
- IRIS 系统进程。

在本文中，“进程”一词本身指的是用户进程和后台进程。

可以使用管理门户管理和控制进程：

开发者社区的同学们，大家好！

我们一直以来都有一个想法——改进收集、分析和回应开发者社区成员们的产品改进请求的过程。我们知道，我们需要一个良好的用户体验，甚至更好的内部流程，来确保收集、听取和响应最好的想法。现在，这个想法终于实现了！

我们在此向您介绍 InterSystems官方反馈门户

💡 >> InterSystems Ideas << 💡

在Cache数据库建表的时候，在定义字段长度的时候，长度设置为1000和长度设置为2000在存储一个长度为1000的值的时候占用的存储空间是否一致。是否在建表的时候建议把字段长度设置为MAXLEN=""

第二十三章 使用系统监视器 - 通知规则

通知规则

如果一段时间内传感器的三个连续读数大于传感器最大阈值，Health Monitor 将生成警报（严重性 2 的通知），如果一段时间内传感器的五个连续读数大于传感器最大阈值，则健康监视器将生成警告（严重性 1 的通知）大于传感器警告阈值。最大值和警告阈值取决于传感器对象中的设置以及适用的图表是由 Health Monitor 生成还是由用户创建，如下表所示。

另请注意：
- 当传感器对象设置了最大值和警告值时，不需要图表，因此不会生成图表，即使禁用 Health Monitor 也会生成通知。
- 当传感器对象设置了最大乘数和警告乘数，或者只有基数时，需要图表；在分析模式下收集到足够的样本以生成图表之前，不会生成任何通知。
- 当存在用户创建的图表时，传感器对象设置是什么并不重要。

以下是 2023 年 InterSystems 开发者工具大赛的技术红利，您可以在投票中获得额外加分：

• 嵌入式 Python的使用
• Docker容器的使用
• ZPM 包部署
• 在线演示
• 代码质量通过
• 开发者社区文章
• 开发者社区第二篇文章
• 上传 YouTube 视频
• 第一次贡献

请参阅下面的额外加分项详细信息：

嵌入式 Python的使用 - 3 分

在您的应用程序中使用嵌入式 Python，可以获得 3 分加分。您至少需要 InterSystems IRIS 2021.2及以上版本。

正式名称为Class Query 的意思可以追溯到 Caché 的早期。
使用CLASS是因为它嵌入在 COS 类中。
尽管官方文档中有精确的描述，但它仍然相当抽象。
我的教程应该通过 COS 中的一个简单示例逐步指导您，使您有直观的体会

第三十一章 配置镜像 - 删除镜像成员时删除镜像数据库属性

删除镜像成员时删除镜像数据库属性

当从镜像中删除成员时，始终可以选择从属于该镜像的镜像数据库中删除镜像属性。后果如下：

• 如果保留镜像属性并稍后将 IRIS 实例恢复到镜像，数据库将自动添加到镜像，但必须先激活它们，然后才能赶上并同步（请参阅激活和赶上镜像数据库）。

但是，如果保留镜像属性，则除非先执行以下操作之一，否则无法删除该数据库：

将成员恢复到从中删除它的同一个镜像。 （如果该成员是主故障转移成员，这不是一个选项，因为镜像不再存在。）然后可以从镜像中删除一个或多个数据库（请参阅从镜像中删除镜像数据库）并在以下情况下删除它们你希望。

• 使用 ^MIRROR 例程的删除一个或多个镜像数据库选项（请参阅使用 ^MIRROR 例程）从一个或多个数据库中删除镜像属性，然后根据需要删除它们。

第五十三章 管理镜像 - Production自动启动如何在镜像环境中工作

当镜像系统启动时（此时还没有成员成为主故障转移成员）：

1. IRIS 不会启动任何访问镜像数据的生产，即使在 ^Ens.AutoStart 中指定了生产。如果成员成为主实例，则这些产品将在那时开始。
2. IRIS 确定实例上是否存在不访问镜像数据的命名空间。如前所述， 建议只在镜像成员上安装镜像产品。但是，如果安装了任何带有非镜像数据库的产品， IRIS 将启动 ^Ens.AutoStart 中指定的产品。 （此逻辑确保如果在镜像成员上安装了非镜像命名空间，它会在 IRIS 启动时启动。）

稍后，当该成员成为主要故障转移成员时， IRIS 会找到引用镜像数据的名称空间，以便它可以在这些名称空间中启动生产。如果遵循 的建议，则在实例成为主镜像成员之前，不应运行任何生产访问镜像数据。 IRIS 在开始生产之前首先检查生产是否已经在运行，特别是：

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

关键原则

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

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

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

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

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

在适配器类中包含凭据

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

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

覆盖Production凭证

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

第十三章 配置Production - 添加HL7业务操作

添加HL7业务操作

要从production中发送HL7消息，必须添加HL7业务操作。要将HL7业务操作添加到production品中，必须创建它，将其集成到production中，并根据需要对其进行配置。以下小节提供详细信息。

创建HL7业务操作

将HL7业务操作添加到production中: