#Ensemble

InterSystems 常见问题

如果您尝试从顶级节点删除在子脚本级别映射的全局变量，您将收到一个<SLMSPAN>错误，并且它不会被删除。这是因为用于子脚本级别映射全局变量的kill命令不能跨映射使用。

// Suppose subscript-mapped globals exist in different databases, as shown below:
^TEST(A*～K*) -> database A
^TEST(L*～Z*) -> database B

// Trying to kill from the top level will result in a <SLMSPAN> error.
NAMESPACE>Kill ^TEST
<SLMSPAN> <- This error is output.

要只删除当前命名空间（数据库）中的全局，请使用以下命令：

NAMESPACE>Kill ^["^^."]TEST

在子脚本级别映射的全局变量必须移动到数据库并直接删除。

要切换到数据库，请使用以下命令：

zn "^^c:\intersystems\iris\mgr\user"
or
set $namespace="^^c:\intersystems\iris\mgr\user"

使用 $System.OBJ.

InterSystems 常见问题

使用 TCP 适配器的业务主机保持连接和池大小的默认设置如下：

如果网络问题导致与业务主机的连接丢失，生产端将无法检测到这一情况，也不会接受新的连接。 在这种情况下，事件日志中不会记录任何事件。 如果将 StayConnected 设置为默认值（-1），连接将不会超时，您需要重启业务主机后才能接受新的连接。 我们建议将 StayConnected 设置为大于或等于 0 的值，以避免出现这种情况。

例如，如果将其设置为 300（秒），TCP 业务主机在 300 秒或更长时间内没有收到任何新信息，就会自动断开连接并重新连接。

对于繁忙的系统，通常会将 StayConnected（保持连接）值设为一个较小的值，如 5 秒。

在使用InterSystems 互操作性（Iris/Health Connect/Ensemble）时，配置数据通常分散在许多生产项目中：服务、流程、操作、适配器及其设置。

常见的操作或安全需求是回答以下问题：

• 哪些接口引用了文件系统路径？
• 目录、网络共享或绝对路径配置在哪里？
• 我能否在所有产品中快速审核或记录这些信息？

下面的 ObjectScript 工具正是通过将选定的配置设置导出到 CSV 文件来解决这个问题的。

该脚本

1. 循环浏览所有现有命名空间
2. 查询所有命名空间中的所有互操作性配置项(Ens_Config.Item)
3. 遍历每个项目的设置
4. 提取文件系统/URL 路径（包含 :、/ 或 \ 的值）
5. 将结果写入CSV 文件，按类别分组
6. 生成便于审计的输出，可在 Excel 中打开或与操作/安全团队共享

典型用例

当您需要时，应使用此实用程序：

• 🔍审计整个产品的文件系统使用情况
• 🛡审查安全风险（本地路径、网络共享、数据库连接）
• 📄记录迁移、升级或灾难恢复规划的配置
• 🔄比较环境（开发环境vs测试环境vs 生产环境）
• 🧹清理遗留或未使用的路径

这对使用许多接口和适配器的多个产品的大型实例尤其有用。

您可能知道这种情况：
前段时间，你发现了一个非常特殊的 $ZU 函数，可以解决一种非常特殊的问题。某种神秘的公式。它变得很流行，被许多开发人员在您的代码和所有安装中使用。

几个版本和更新之后，ISC 通知你，你的神秘 $ZU 已经过时，不再支持。建议您用新的 $something() 替换它。

那么，如何找到并记录这段神秘代码的用法呢？
它可能位于类、MAC、INT 或 INC 代码中。
它也可能分布在多个命名空间中。
在过去，Studio 还不够完善：它不适用、速度慢、不准确。

我在不同的安装中不止一次遇到过这种情况。
当时还没有源代码控制功能，即使最终引入了源代码控制功能，也很少有人使用。

由于 ObjectScript 是应对这一挑战的唯一可能选择，我编写了自己的实用程序。
我的解决方案经过了多年的发展，一旦计划迁移到 IRIS，我就会再次检查它的实用性。
由于它是用纯 ObjectScript 编写的，因此在 IRIS 中无需修改任何字符即可运行。
如您所知，在 ObjectScript 中搜索特定文本的问题一直没有改变。

您发送了一个 HTTP 请求，但得到了一个 HTTP 错误，而且是一个您意想不到的 HTML 错误页面......这是怎么回事？

具体举例来说，也许您尝试读取 FHIR 资源（例如 /Patient/123），但得到的是 404 错误页面，尽管使用其他患者 ID 时，您得到的是资源有效载荷，因此 "页面 "肯定存在......为什么会得到 404 错误页面？

InterSystems 常见问题

使用 %Library.Global 类的 Export() 方法导出时，如果导出格式（第四个参数：OutputFormat）设置为 7，即 "块格式（Block format）/Caché 块格式 (%GOF)"，则无法导出映射的Global项（只能导出命名空间默认Global数据库中的Global项）。要导出 "块格式/Caché 块格式 (%GOF) "的映射Global项，请在 %Library.Global.Export() 的第一个参数中指定要映射Global项的数据库目录。

执行示例如下。

如果将导出格式指定为 5（默认），即 "ISM/ObjectScript 格式（ISM/缓存格式）(*)"，则也可以导出映射Global，但输出文件会比将导出格式（第四个参数：OutputFormat）设置为 7（即 "块格式/Caché 块格式（%GOF）"）时大。

此外，如果在Global中记录了二进制数据，也无法正确输出。

更多信息，请参阅以下文档。

InterSystems 常见问题解答标题

^%GCMP 实用工具可用于比较两个全局变量的内容。

例如，要比较 USER 和 SAMPLES 命名空间中的 ^test 和 ^test，过程将与下面类似：
*以下示例在这两个命名空间中创建了 700 个相同的全局变量，并更改了其中一个的内容，使其成为检测目标。

USER>kill ^test
USER>for i=1:1:100 { for j=1:1:7 { set ^test(i,j)="Test"_i } }
USER>zn "samples"                  // change namespace to SAMPLES
SAMPLES>kill ^test
SAMPLES>for i=1:1:100 { for j=1:1:7 { set ^test(i,j)="Test"_i } }
SAMPLES>set ^test(50,5,1)=1        // Change one of the globals created in the SAMPLES namespace.
SAMPLES>do ^%GCMP
Compare global ^test               // Global to compare.

互操作性用户界面现在包括可以在所有互操作性产品中使用的 DTL 编辑器和生产配置应用程序的现代化用户体验。您可以在现代化视图与标准视图之间切换。所有其他互操作性屏幕仍采用标准用户界面。请注意，仅对这两个应用程序进行了更改，我们在下面确定了当前可用的功能。

要在升级前试用新屏幕，您可以点击这里，从我们的社区工具包网页中下载 2025.1 版：https://evaluation.intersystems.com/Eval/。请观看“学习服务”中的简短教程构建集成：一种新的用户体验，了解对这些屏幕进行的用户增强！

• 生产配置：在以下版本的生产配置中受支持：
  • 创建/编辑/复制/删除主机
  • 停止/启动主机
  • 编辑生产设置
  • 停止/启动生产
• 源代码控制集成：支持上述配置功能的源代码控制集成。
• 分屏 视图：用户可以直接从“生产配置”屏幕打开“规则编辑器”和“DTL 编辑器”，在分屏视图中查看和编辑产品中包含的规则和转换。
• 增强的筛选功能：使用顶部的搜索框，您可以搜索和筛选各种业务组件，包括多种类别、DTL 和子转换。 使用左侧边栏可以独立于主面板进行搜索，查看各种主机和类别中的搜索结果。
• 批量编辑主机类别：通过从生产配置中添加主机，您可以为生产添加新类别或编辑现有类别。
• 可展开路由器：可以展开路由器，内联查看所有规则、转换和连接。