第二十五章 添加数字签名

本主题介绍如何向 IRIS Web 服务和 Web 客户端发送的 SOAP 消息添加数字签名。

通常，会同时执行加密和签名。为简单起见，本主题仅介绍签名。有关结合加密和签名的信息，请参阅主题结合加密和签名。

主题使用派生密钥令牌进行加密和签名描述了向 SOAP 消息添加数字签名的另一种方法。

数字签名概述

可以使用数字签名来检测消息是否被篡改，或者简单地验证消息的某一部分是否确实由所列实体生成。与传统的手工签名一样，数字签名是对文档的附加，只有文档的创建者才能创建，并且不容易伪造。

IRIS 对 SOAP 消息的数字签名的支持基于 WS-Security 1.1。反过来，WS-Security 遵循 XML 签名规范。根据后者的规范，要对 XML 文档进行签名：

//player.bilibili.com/player.html?aid=344796232&bvid=BV1cd4y1A7Fo&cid=812332080&page=1
[这是一个嵌入式链接，但由于您拒绝了访问嵌入式内容所需的 Cookie，您无法直接在网站上进行查看。要查看嵌入式内容，您需要在 Cookie 设置中接受所有 Cookie。]

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

记录映射类结构

有两个类描述记录映射：

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

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

第六十六章 SQL函数 ISNULL

测试NULL并返回相应表达式的函数。

大纲

ISNULL(check-expression,replace-expression)

参数

• check-expression - 要计算的表达式。
• replace-expression - Check-Expression为NULL时返回的表达式。

ISNULL返回与Check-Expression相同的数据类型。

第103章 SQL函数 %ODBCIN

以逻辑格式返回表达式的格式转换函数。

大纲

%ODBCIN(expression)

%ODBCIN expression

参数

• expression - 要转换的表达式。

描述

%ODBCIN 在通过字段或数据类型的 OdbcToLogical 方法传递值后以逻辑格式返回表达式。逻辑格式是数据的内存格式（执行操作的格式）。

%ODBCIN 是一个 SQL 扩展。

示例

以下示例显示了同一字段的默认显示格式、%ODBCIN 和 %ODBCOUT 格式。

InterSystems 常见问题解答

如果系统24小时没有停止，旧的日志文件将根据“日志文件删除设置”在0:30删除。

导致日志文件保留的时间早于“日志文件删除设置”的一个可能原因是存在仍处于开放状态的事务。

在这种情况下，您将能够通过搜索执行事务的进程并完成事务来删除日志文件。

下面的示例检查是否存在未完成的事务，如果存在，则输出目标文件名和日志记录信息。

（示例可以从这里下载

*注意*如果要检查的日志文件较大或日志文件较多，则执行需要时间，因此请联系我们的支持中心。

InterSystems IRIS数据平台、InterSystems IRIS for Health和HealthShare Health Connect 2024.2版本现已正式发布(GA)。

发布亮点

第二十二章 源代码文件 REST API 参考（四）

PutDoc

此方法保存提供的源代码文件。如果文件不存在，此方法将创建它，如果文件存在，此方法将现有文件替换为指定的文件。为确保覆盖文件的正确版本，请指定 If-None-Match 标头以及先前 PutDoc 或 GetDoc 的 ETAG 标头中返回的时间戳值。如果要覆盖文件而不检查版本，请指定 ?ignoreConflict=1 URL 参数。该方法返回一个对应的源代码文件对象。如果要保存二进制文件，请将传入 JSON 消息的 enc 元素设置为 true，并将文件内容包含为 base64 块数组。如果在保存过程中更改了服务器上的文本（例如通过源代码管理挂钩），则更新后的文本将在返回的源代码文件的内容数组中返回。

与源代码文件有关的错误将在返回的源代码文件对象的状态属性中。

//player.bilibili.com/player.html?aid=302358945&bvid=BV1UP41157BG&cid=812331965&page=1
[这是一个嵌入式链接，但由于您拒绝了访问嵌入式内容所需的 Cookie，您无法直接在网站上进行查看。要查看嵌入式内容，您需要在 Cookie 设置中接受所有 Cookie。]

第二十七章 Caché 变量大全 $ZEOF 变量

包含指示是否已到达文件末尾的标志。

大纲

$ZEOF

描述

在每次顺序文件读取之后，Caché设置$ZEOF特殊变量以指示是否已到达文件末尾。提供此特殊变量是为了与使用$ZC设备状态检查的MSM例程兼容。

Caché将$ZEOF设置为上次使用的设备的文件状态。例如，如果从顺序文件读取，然后写入主设备，则Caché会将$ZEOF从顺序文件的文件结束状态重置为主设备状态。因此，应该在顺序文件读取之后立即检查$ZEOF值(如果需要，将其复制到变量)。

Caché将$ZEOF设置为下列值：
- –1 文件结束
- 0 不在文件末尾

要使用此功能，必须对顺序文件禁用<ENDOFFILE>错误。

第二章 锁定和并发控制（二）

关于零超时的说明

如上所述，如果您将 timeout 指定为 0， 会添加锁。但是，如果使用零超时锁定父节点，并且已经在子节点上锁定，则忽略零超时并使用内部 1 秒超时。

删除锁

要删除默认类型的锁，请使用 LOCK 命令，如下所示：

LOCK -lockname

如果执行此命令的进程拥有具有给定名称的锁（默认类型），则此命令将删除该锁。或者，如果进程拥有多个锁（默认类型），此命令将删除其中一个。

或者删除另一种类型的锁：

LOCK -lockname#locktype

其中 locktype 是一串锁类型代码。

LOCK 命令的其他基本变体

为了完整起见，本节讨论 LOCK 命令的其他基本变体：使用它来创建简单的锁并使用它来删除所有锁。这些变化在实践中并不常见。

第七章 使用 SQL Search - 同义词表

同义词表

要实现同义词表，请将该表定义为扩展 iFind.Synonym 抽象类的持久类。

此类定义了两个属性：FromTerm 和 ToTerm。一对 FromTerm 和 ToTerm 属性将 ToTerm 定义为 FromTerm 的同义词。如果查询包含 FromTerm，SQL 搜索将使用 ToTerm 来扩展查询。

该查询使用此类的 GetMatch() 方法根据查询词在同义词表中搜索同义词。

第三章 使用 ^%REST 例程创建 REST 服务

本章介绍如何使用 ^%REST 例程创建和删除 REST 服务。

提示：还可以使用此例程更新REST服务；只需删除REST服务，然后重新创建它。

使用^%REST例程

^%REST例程是一个简单的命令行界面。在任何提示下，可以输入以下答案：

• ^ - 使例程跳回上一个问题。
• ? - 使例程显示一条列出所有当前选项的消息。
• q或quit - 结束例程。

此外，每个问题都会在括号中显示该问题的默认答案。

第十六章 调用Callout Library函数

Callout 库是一个共享库（DLL 或 SO 文件），其中包含 $ZF Callout 接口的挂钩，允许各种 $ZF 函数在运行时加载它并调用其函数。 $ZF Callout 接口提供了四种不同的接口，可用于在运行时加载 Callout 库并从该库调用函数。这些接口的主要区别在于如何识别库并将其加载到内存中：