# 第四章 C 开头的术语

#### 循环引用 (circular reference)

**对象（Objects）**

在不同类中的两个属性相互引用对方的集合。只要循环引用中的两个属性都不是必需属性，`IRIS` 完全支持循环引用。如果循环引用中的两个属性都是必需属性，你将无法保存这两个类的对象。

#### 类编译器 (class compiler)

**对象（Objects）**

类编译器用于编译`IRIS` 类。你可以在 `IDE` 中使用类编译器，或者通过 ` IRIS` 对象实用库中的编译调用来使用。

#### 类定义语言 (Class Definition Language)

**对象（Objects）**

`IRIS` 的类定义语言（`CDL`）是一种基于关键字的语言，用于定义 `IRIS` 中的类。

#### 类描述符 (class descriptor)

**对象（Objects）**

包含运行时信息（方法和属性列表）的特殊类型例程，用于使用对象。

#### 类字典 (class dictionary)

**对象（Objects）**

第七十七章 设备特殊变量

^%IS 的更多功能

^%IS 还可用于执行以下任务：

第七十五章 使用 ^%IS - OPEN 参数

OPEN 参数

默认情况下，OPEN 命令使用 ^%IS 全局中定义的设备的规范。在使用 ^%IS 时，可以通过指定其他设置来覆盖这些设置。

发出 USE 命令

运行 ^%IS 后，应用程序必须向 ^%IS 打开的设备发出 USE 命令。你可以使用变量 IO，只要你明白每次调用 ^%IS 时它的值都会发生变化。然后，后续的IRIS I/O 命令，例如 READ 和 WRITE，将引用该设备。

发出 CLOSE 命令

用户或应用程序开发人员必须关闭使用 ^%IS 实用程序打开的设备。

第七十三章 管理设备和助记词空间 - 设备的解释级别

与 ^%IS 或 OPEN 命令一起使用的设备标识符最多要经过三个级别的解释。因此，如果在 ^%ISDevice： 提示符处输入助记词 47，则使用的最终设备 ID 可能会有所不同。下面介绍了这三个级别。

级别 1：%IS 实用工具级别

如果使用 ^%IS 实用程序选择设备，则使用第一级。^%IS 全局中的助记词可以与设备编号相关联。然后，^%IS 实用程序向该设备编号发出 OPEN 命令。

级别 2：OPEN 命令级别

在 OPEN 命令中，IRIS 会检查此数字是否存在于 Device panel 表的 Alias 列中。如果是这样，它会将其转换为该设备的实际设备号或名称。

第七十一章 管理设备和助记词空间 - 设备 ID

可以通过数字或操作系统名称来识别设备。可以在 OPEN 命令中使用此标识符。

设备别名

可以为定义的每个 IRIS 设备定义一个或多个别名值。当用户在 OPEN 命令中指定别名时，IRIS 会将其转换为设备 ID。

IRIS 提供的默认设备 ID 适用于大多数用户。但是，某些用户可能希望覆盖这些默认值。可以通过在 Management Portal 中提供别名作为设备配置设置的一部分来实现此目的。

默认设备 ID 和助记词

当安装 IRIS 时，这些是每种设备类型的默认设备编号和助记符。

默认设备编号和助记词

第六十九章 打印机 - 使用助记词空间控制设备

助记词是执行设备控制操作（如光标移动和设备属性）的 IRIS 例程。每个操作都与一个标签相关联。这些标签是 WRITE /mnemonic 命令中使用的助记词。有关 WRITE /mnemonic 语法的更多信息，请参阅本文档其他页面中每种设备类型的 WRITE 命令说明。

预定义的助记词空间

IRIS 提供下表中描述的预定义助记词空间。

预定义的助记词空间

借助 InterSystems 行业标准认证考试，您和您的团队可以获得认证，以验证您的技能并证明您拥有 InterSystems 技术方面的专业知识。 查找适合您的角色的考试！

第六十五章 假脱机设备 - 列出假脱机文档

列出假脱机文档

%SPOOL 实用程序菜单 List documents 的选项 2 显示当前为运行 %SPOOL 的目录假脱机的文档列表。如果没有 Despool start-end 值，则文档尚未解散（打印）。

每个假脱机文档的描述显示在有关该文档的其余信息之后的一个或多个单独行上。

在以下示例中，用户选择了选项 2。显示屏将显示存储在后台处理程序中的两个文档。第一份记录在 8 月 30 日下午 2：23 存储，并于当天下午 2：25 打印。第二份于 3 月 4 日上午 11：39 存储，并于当天上午 11：42 打印。

第六十二章 假脱机设备 - 查看 ^SPOOL 全局

查看 ^SPOOL 全局

与任何下标的全局变量一样，您可以通过发出 WRITE 命令来显示 spool 文件中的行，如下所示：

   WRITE "1st spool file node: ",^SPOOL(1,1),!

但是，要查看和编辑假脱机文件本身，请转到管理门户并选择 System Explorer 和 Globals。选择您当前的命名空间，找到 SPOOL 全局变量，然后单击 data。这将显示类似于以下示例的假脱机文件数据。

在下面的假脱机文件中，（！） 终止字符结束假脱机文件中的每个节点行。这些终止字符是假脱机文件的一部分，作为 $CHAR（13,10） 连接到文本字符串（Return 和 Line Feed）。

第六十章 假脱机设备 - WRITE 命令

WRITE 命令

要将一行写入 ^SPOOL 全局变量，请发出 WRITE 命令，以行终止符字符结尾。例如

   /* Writing to the ^SPOOL global */
   OPEN 2 
   USE 2 
     WRITE "First line of text",!
     WRITE "Second line of text",!
   CLOSE 2

   /* Displaying the ^SPOOL global */
   WRITE ^SPOOL(1,1),^SPOOL(1,2)

每行都以行终止符（感叹号）结尾，并存储在单独的全局节点中。

但是，在生成单个打印行时，可能需要使用多个 WRITE 命令;如果 WRITE 不包含行终止符，则下一个 WRITE 命令将附加到同一打印行。两者都写入同一个全局节点。此行保存在缓冲区中，在发出行终止字符或关闭后台处理程序设备之前，不会写入后台处理程序全局。

第五十八章 File 输入 输出 - WRITE 命令

WRITE 命令

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

WRITE 命令将数据（一次一条记录）写入作为当前设备的顺序文件。

语法

WRITE x

• x 变量 x 中的数据将作为一条记录写入顺序文件中。

CLOSE 命令

CLOSE 命令放弃对顺序文件的所有权。

如果指定的文件未打开或不存在，则 IRIS 将忽略 CLOSE 并返回而不发出错误。

IRIS 2024.2 版本包含一项变更（DP-432503），该变更要求Web Gateway最初连接到 IRIS 时所使用的用户（通常是 CSPSystem）必须对承载 REST web applicatioon 的dispatch类的数据库具备 READ 权限。

在不满足该条件的情况下，就会引发一个错误，这会向调用者返回一个 HTTP 404 状态码，而非预期的 HTTP 401 状态码。

显然，这个问题将在 2024.3 版本中修复，参考编号为 DP-432898 / ALI048：REST 登录端点将返回 401 HTTP 错误码而非 404，但作为持续交付（CD）版本，2024.2 不会获得维护版本修正。

解决方法是让 CSPSystem 用户对安装WebTerminal所在命名空间的数据库具备读权限。

下面是所需的步骤：

1. 创建一个新的资源 “%DB_WEBTERMINAL”，并设置 “WEBTERMINAL” 数据库使用该资源，而非 “%DB_% DEFAULT”。

2. 创建一个名为 “% DB_WEBTERMINAL” 的角色，该角色能让角色持有者对 “% DB_WEBTERMINAL” 资源具有读写（RW）访问权限。

现有一个数据表的数据像这样：

我们的需求是基于表中的Item列新增一个status字段，如果item的内容是第一次出现，那么status列就是New，反之显示Old,

比如，应该是下面的显示内容

在原文章的回复中， Robert Cemper给出了下面的建议

新建一个存储过程，并在SELECT查询语句中生效：

第五十六章 File 输入 输出 - USE 命令

US 命令

USE 命令使打开的顺序文件成为当前设备。可以打开多个顺序文件，但一次只能使用一个顺序文件。

语法

USE file:position

• file 文件

任何有效的文件规范，用引号括起来。指定的文件必须已打开。在 UNIX 路径名中，可以使用波形符 （~） 扩展来指示当前用户的主目录。例如：~myfile 或 ~/myfile。