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

第八十二章 SQL函数 $LISTDATA

列表函数，指示指定元素是否存在并具有数据值。

大纲

$LISTDATA(list[,position])

参数

• list - 计算结果为有效列表的表达式。列表是包含一个或多个元素的编码字符串。您可以使用 SQL 或 ObjectScript 的 $LISTBUILD 或 $LISTFROMSTRING 函数创建列表。您可以使用 SQL 或 ObjectScript $LIST 函数从现有列表中提取列表。
• position - 可选 — 指定列表中元素的整数表达式。

描述

$LISTDATA 检查列表中请求元素中的数据。如果位置参数指示的元素在列表中并且具有数据值，则 $LISTDATA 返回值 1。如果元素不在列表中或没有数据值，则 $LISTDATA 返回值 0。

第四十一章 创建安全对话 - 使用

在 Web 服务使用 <SecurityContextToken>, 做出响应后，客户端实例和服务实例可以访问相同的对称密钥。有关此密钥的信息包含在两个实例的 SecurityContextToken 属性中。建议的程序如下：

1. 在客户端中，将 SecurityOut 属性设置为 null，以删除请求消息中使用的安全标头。

在 Web 服务中不需要这样做，因为 Web 服务会在每次调用后自动清除安全标头。

第七章 设置和其他常见活动 - 从入站消息中检索证书

从入站消息中检索证书

如果收到已进行数字签名的 SOAP 消息，则相关证书可在 %SYS.X509Credentials 的实例中找到。可以检索该证书。操作方法如下：

第七章 创建Callout Library - 创建 ZFEntry 表

创建 ZFEntry 表

每个 Callout 库必须定义一个 ZFEntry 表，该表允许 IRIS 加载和访问 Callout 函数。 ZFEntry 表由以 ZFBEGIN 开头、以 ZFEND 结尾的宏代码块生成。在这两个宏之间，必须为要公开的每个函数调用一次 ZFENTRY 宏。

每个 ZFENTRY 调用都采用三个参数：

   ZFENTRY(zfname,linkage,entrypoint)

其中 zfname 是用于在 $ZF 调用中指定函数的字符串，linkage 是指定如何传递参数的字符串，entrypoint 是 C 函数的入口点名称。

第七十七章 SQL函数 LENGTH

返回字符串表达式中字符数的字符串函数。

大纲

LENGTH(string-expression)

{fn LENGTH(string-expression)}

参数

• string-expression - 字符串表达式，可以是列名、字符串文字或另一个标量函数的结果，其中基础数据类型可以表示为任何字符类型（例如 CHAR 或 VARCHAR）。

LENGTH 返回 INTEGER 数据类型。

描述

LENGTH 返回一个整数，表示给定字符串表达式的字符数，而不是字节数。字符串表达式可以是字符串（从中删除尾随空格）或数字（ IRIS 将其转换为规范形式）。

请注意，LENGTH 可用作 ODBC 标量函数（使用花括号语法）或 SQL 通用函数。

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

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

大纲

$ZEOF

描述

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

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

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

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

第五十七章 File 输入 输出 - READ 命令

在定位的 READ 或 WRITE 之后，后续的 READ 或 WRITE 操作将按顺序进行，直到下一个带有 position 参数的 USE 命令。

READ 命令从当前设备读取数据，一次读取一条记录。读取超过文件末尾会导致错误。

在使用 InterSystems ObjectScript 进行编程时，当你定义了属性property、查询query或者索引index，系统会在编译的过程中自动创建与之相关的一些方法，这篇文章对这些方法做了些总结：

属性Properties

1. 假设你定义了一个属性 Property， 下面的方法会被自动创建

ClassMethod PropertyGetStored(id)

对于数据类型属性，这个函数将返回其逻辑值，对于对象属性，返回id。这是一个对类global数据的封装，也是获取单例属性值(singular property value)最快的方法。此方法仅适用于已持久化存储的属性。

第十七章 维护本地数据库（二）

数据库详细信息页面显示有关任何数据库的详细信息。要从管理门户访问此信息：

1. 显示数据库页面（系统操作 > 数据库）。
2. 单击要查看更多详细信息的数据库的名称。

数据库详细信息页面的顶部是一排按钮，可让执行各种数据库操作：

• Mount / Dismount — 安装或卸载数据库。新状态一直有效，直到明确更改它或重新启动/停止 IRIS；要永久卸载数据库，必须将其从配置中删除。
• Compact - 将分布在整个数据库中的可用空间移动到其末端。
• Truncate截断 — 将数据库末尾的可用空间返回到底层文件系统。
• 碎片整理 — 重新定位全局块，使代表给定全局的块处于连续序列中。

该页面还包括特定于所选数据库的信息，这些信息被组织成一个 General Information 表和一个 Database Size 表：

第四十章 SQL函数 DATALENGTH

返回表达式中字符数的函数。

大纲

DATALENGTH(expression)

参数

• expression - 表达式，可以是列的名称、字符串字面值或另一个标量函数的结果。
  基础数据类型可以是字符类型(如CHAR或VARCHAR)、数字或数据流。

DATALENGTH返回INTEGER数据类型。

描述

注意:DATALENGTH、CHAR_LENGTH和CHARACTER_LENGTH函数是相同的。
对于新代码，建议使用CHAR_LENGTH函数。
DATALENGTH是为TSQL兼容性而提供的。

VSCode中安装InterSystems Language Server后，EXPLORER资源树使用Ctrl+F可以打开文件检索框，快速检索文件。 不知是VSCode版本更新不支持了，还是InterSystems Language Server更新，导致在EXPLORER资源树无法快速检索文件

[toc]

第九章 D - E 开头的术语

显示格式 (display format)

对象（Objects）

属性的显示格式是用于显示和输入数据的格式。

分布式数据库 (distributed database)

系统

存储在网络中多台计算机上的数据库。当在分布式数据库环境中使用IRIS 时，位于一台计算机上的 ObjectScript 例程可以在网络中其他计算机的文件保护限制内访问全局。

DMNNET

系统

处理来自网络的传入全局请求的IRIS 进程。它是在系统状态（%SS）显示或系统操作实用工具中的进程面板上表示网络守护进程的名称。

点语法 (dot syntax)

对象（Objects）

点语法允许获取和设置属性值以及执行方法。它还允许从引用对象访问被引用和嵌入对象的属性和方法。

第四章 设置和其他常见活动

作为参考，本主题介绍了用于保护 Web 服务的常见活动。

执行设置任务

对于大多数与 SOAP 安全相关的任务，必须首先执行以下任务：

• 提供可信证书供 IRIS 使用
• 创建 IRIS 凭证集

这些任务也是使用 XML 工具中描述的某些任务的先决条件。

可能还需要创建 SSL/TLS 配置。有关信息，请参阅 TLS 指南。