第七十四章 使用 ^%IS

^%IS 是一个通用的设备选择实用程序，用于基于字符的应用程序。可以使用内置的 ^%IS 实用程序来允许用户选择要将 I/O 操作定向到的设备。每当要选择设备时，应用程序都应该调用 ^%IS 实用程序。此实用程序允许用户指定要使用的设备和相应的 OPEN 命令参数，打开所选设备，然后将特定于设备的信息返回给调用程序。用户输入已在 ^%IS 全局中定义的助记词。^%IS 依赖于 Management Portal 中建立的 IO 配置默认值。

第七十二章 管理设备和助记词空间 - 定义设备

定义设备

可以在 Management Portal 的 Devices （设备） 配置设置中定义、编辑和删除设备。您输入的信息存储在 ^%IS 全局变量中。有关此全局的更多信息，请参阅 ^%IS 全局的结构。

如果在 IRIS 运行时进行设备更改，系统会提示是否要在不重新启动 IRIS 的情况下激活更改。如果同意激活更改，则新定义将立即提供给用户。

访问设备

在 Windows 系统上，必须将设备编号用于作业间通信设备和常规联锁设备。对于终端和打印机，可以使用您分配的设备助记词或设备编号。

在 UNIX 系统上，可以使用 UNIX 文件规范来引用文件，也可以设置设备编号来引用文件。

2024 年 12 月 4 日，系统警报和监视 (SAM) 已从 InterSystems 下载网站、容器注册表和文档网站移除。

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

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

预定义的助记词空间

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

预定义的助记词空间

我们已经有一段时间没有在开发者社区上发表关于嵌入式 Git 的文章了，我想借此机会更新一下今年我们完成的大量工作以及未来的工作计划。

背景信息

如果您要在 IRIS 上构建解决方案，并想要使用 Git，那就太棒了！ 只需将 VSCode 与本地 Git 仓库结合使用，并将更改推送到服务器上即可，就是这么简单。

但在以下使用场景中该怎么办：

第六十六章 打印机

打印机

本页讨论了如何在 IRIS 数据平台中配置和使用打印设备。打印机是仅物理输出设备。打印机可以是字符打印机，也可以是非字符设备，例如传真或绘图仪。

在大多数情况下，输出不会直接发送到打印机。通常，要打印的输出首先发送到逻辑假脱机设备（^SPOOL 全局）。然后，可以将 ^SPOOL 全局的内容发送到物理打印机。有关假脱机的更多详细信息，请参阅 假脱机设备。

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

列出假脱机文档

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

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

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

InterSystems IRIS^® 数据平台、InterSystems IRIS^® for Health 和 HealthShare^® Health Connect 2025.1 的首个开发者预览版已发布到 WRC 开发者预览网站。

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

查看 ^SPOOL 全局

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

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

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

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

第六十一章 假脱机设备 - 假脱机和特殊变量

写入 ^SPOOL 时，IRIS 会不断更新 $X 并$Y特殊变量。$X 表示写入当前索引行的字符数，$Y 包含当前 OPEN 期间写入的行数。请注意，$Y 的值不一定与 node 索引相同。例如：

第五十九章 假脱机设备

介绍

IRIS数据平台使能够将打印输出直接发送到您的打印机或屏幕，或将其保留在后台打印中以供以后打印。IRIS 假脱机独立于您的操作系统执行的假脱机。

IRIS 中的假脱机是一种技术，可让自动将程序的输出保存在 ^SPOOL 下标全局中，而不是立即打印。可以通过将 ^SPOOL 全局的内容发送到打印机来稍后打印输出。本页介绍使用此假脱机工具的两种方法：使用 ObjectScript 命令（OPEN、USE、WRITE、CLOSE）或使用 %IS 和 %SPOOL 实用程序。

打开和使用假脱机设备

要将输出发送到当前命名空间中的 spool 全局变量，请打开 spooler 并将其指定为输出设备。

第五十八章 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）访问权限。