目录

1. 导言
2. 版本控制
3. 导出类
4. 导出 BI 分析类
5. 导出globals

简介。

本文将介绍如何通过 InterSystems 开发人员社区快速入门 Git 开发，以及使用 IRIS InterSystems 时的版本控制实践。我们将介绍需要导出互操作性类、global和分析元素（如立方体和仪表盘）的情况。这些场景包括 IRIS 的关键版本控制实践。

要开始学习，您需要

1. 注册并登录GitHub
2. 成为 Git 上intersystems-community组织的成员

开始使用 IRIS InterSystems 非常简单！

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.

在上一篇文章中，我们介绍了IrisOASTestGen——一个基于OpenAPI 2.0规范为InterSystems IRIS生成REST API测试代码的工具。该文章展示了如何使用OpenAPI Generator附带的默认模板来搭建测试用例。本文将聚焦于接下来的自然步骤**：自定义生成的测试代码**。通过使用Mustache模板扩展代码生成逻辑，我们可以表达更丰富的语义、实现CRUD感知测试，并创建更有意义的测试套件。本文的示例将修改IrisOASTestGen，为createPerson操作生成测试，包括遍历所有预期响应。这将展示如何使用OpenAPI规范中的自定义字段来驱动Mustache模板内的条件渲染。

OpenAPI扩展以支持CRUD操作

为了使代码生成支持CRUD操作，OpenAPI规范可以在vendorExtensions中包含自定义字段。这些自定义字段作为标志，Mustache模板可以检测到它们。

大家好！ 👋
欢迎来到IRIS IO 工具系列的第二部分。这个扩展是我提交给InterSystems 2025 年 "将想法变为现实 "竞赛的作品，它为您提供了一个直观而强大的界面，可直接在 VS 代码中导入和导出数据。

• 您可以在我的 GitHub 页面找到该扩展：pietrodileo/iris_io_utility。
• 在 VSCode 上安装扩展的 VSIX 文件可在相关发布页面找到：releaseases: iris-io-utility

如果你觉得这个扩展有用，请考虑在竞赛中为我投票！

在上一篇文章中，我们介绍了

• 扩展概述
• ODBC 驱动程序配置
• 导出功能

现在是时候深入了解导入引擎(Import Engin)了_它旨在支持

• CSV
• TXT（任意分隔符）
• JSON
• XLSX

该扩展具有智能推理层，可分析输入文件并自动建议最佳的 IRIS 表格数据格式，提供有指导的辅助数据建模。

导入模式--两种不同的工作流程

该扩展支持两种不同的方案：

• 创建新表
• 加载到现有表格

选项 A - 导入新表

在以下情况下，这是理想的选择

• 加载新数据集
• 您希望从头开始，使用全新的表和模式
• 处于原型设计或探索阶段

会发生什么？

数据库表中索引的力量

在使用数据库时，大多数开发人员都了解索引的概念以及使用索引的原因：加快数据检索速度。但是，索引的真正影响往往只有在比较有索引和没有索引的情况时才会显现出来。

你知道没有索引会发生什么吗？
试想一个有三列的表：姓名、年龄和手机号码。

现在，考虑一下这个查询：

如果年龄列没有索引，数据库引擎会

• 检查 WHERE 条件字段是否有索引。
• 如果没有，它将扫描整个表（全表扫描）。
• 对于每一行，它会检查年龄值并返回匹配结果。

这意味着引擎会遍历整个数据结构，这对于大型表来说非常耗时。

索引会发生什么情况？
现在，如果年龄列有索引，流程就会发生巨大变化：

• 引擎会直接进入索引结构。
• 它会找到 Age = 26 的节点。
• 索引指向主表中相应的记录 ID。
• 结果几乎是瞬间获取的。

这就是为什么索引是如此强大的优化工具。

现实生活中的一课
最近，我们遇到了一个有趣的情况，凸显了索引的重要性。
我们的表有 5 条记录，而年龄列是有索引的。然后，我们错误地从索引结构（而不是主表）中删除了两个条目。这两个条目对应的是 ID X001 和 X005，它们的年龄都是 26 岁。

当我们运行
SELECT ID, Age, EmpId, Mobile, NameFROM Company.Employee WHERE Age = 26
我们预计会有 3 条记录（因为主表中仍有这些记录），但只出现了 2 条记录。

为什么呢？

InterSystems 常见问题

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

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

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

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

本文将讨论 Microsoft Visual Studio Code IDE中包含的所有调试工具 。

内容包括

• 断点
• 观察窗口
• 调用堆栈

让我们从了解调试要求开始！

前提条件

有两个插件（扩展）可用于调试 ObjectScript：

第一个是 InterSystems ObjectScript 扩展包的一部分 。第二个是 Serenji，它是一个独立的插件，提供编辑器、文件管理器和调试功能。这两个插件都可以从插件商店安装。要激活关键功能，Serenji 需要许可证。在本文中，我们将使用 InterSystems ObjectScript 扩展包来降低学习难度。在掌握基础知识后，您可以考虑购买 Serenji 的付费许可证。

什么是 FHIR Profile?？

FHIRProfile是规则和约束的集合，用于定制和完善基础快速医疗互操作性资源 (FHIR) 资源（resource）。Profiling是一个重要的过程，它可以调整基础 FHIR 资源标准，以满足特定用例、地理区域、医疗机构或临床工作流程的独特要求。

基础 FHIR 规范为资源（如病人、观察或药物）提供了通用、灵活的定义，而Profiling则将这些通用资源转化为更精确的资源。这就确保了为特定社区或实施量身定制的数据交换的一致性和互操作性。

FHIR 旨在覆盖全球各种医疗保健场景。配置文件允许实施者在不丧失标准化优势的情况下调整这一通用平台。

Embeddedpy-bridge：嵌入式 Python 工具包

概述

嵌入式 Python改变了 InterSystems IRIS 的游戏规则，可直接在数据库中访问庞大的 Python 生态系统。但是，在 ObjectScript 和 Python 之间架起桥梁有时会让人感觉像是在两个不同的世界之间转换。

为了实现这种无缝过渡，请使用embeddedpy-bridge。

该软件包是一个以开发人员为中心的实用工具包，旨在为嵌入式 Python 提供高级 ObjectScript 封装、熟悉的语法和强大的错误处理功能。它允许开发人员使用他们已经熟悉的本地 IRIS 模式与 Python 数据结构交互。

挑战

虽然 %SYS.Python 库功能强大，但开发人员经常面临一些障碍：

1. 处理代理：使用原始代理浏览 Python 列表和字典对于 ObjectScript 来说并不 "原生"。
2. 迭代：标准 ObjectScript While 循环无法与 Python 迭代器进行本地 "对话"。
3. 命名空间管理：确保 Python 实用程序在整个系统中可用。

解决方案：embeddedpy-bridge

我的目标是创建一个 "桥梁"，让 Python 感觉像是 ObjectScript 中的一等公民。

主要功能

• py 前缀约定：%ZPython.

你好

数据迁移通常听起来像是一个简单的 "将数据从 A 转移到 B 的任务"，直到你真正去做。实际上，这是一个融合了规划、验证、测试和技术精度的复杂过程。

我曾在多个项目中负责将数据迁移到在 IRIS（TrakCare）上运行的 HIS 中，在这些项目中，我认识到成功来自于纪律和自动化的结合。

以下是我想强调的几个要点。

1.从定义好的数据格式开始。

在打开第一个文件之前，确保每个人，尤其是数据提供者，都清楚地了解您所期望的确切数据格式。尽早定义模板可以避免不必要的来回奔波和返工。

虽然 Excel 或 CSV 格式很常见，但我个人认为使用制表符分隔的文本文件（.txt）上传数据是最好的。它既轻便又一致，还能避免文本字段内的逗号问题。

PatID   DOB Gender  AdmDate
10001   2000-01-02  M   2025-10-01
10002   1998-01-05  F   2025-10-05
10005   1980-08-23  M   2025-10-15

确保文件中提供的日期格式正确且在整个文件中保持不变，因为所有这些文件通常都是从 Excel 文件转换而来，而 Basic excel 用户可能会在提供错误的日期格式时犯错。错误的日期格式在转换为 horolog 时会让您恼火。

在最近的竞赛中，看到更多的人在创建 VS Code 扩展程序，这令人鼓舞。不过我注意到，在三个需要使用凭据进行连接的扩展中，只有我的gj :: dataLoader 利用了历史悠久、官方支持的InterSystems Server Manager扩展来获取连接定义并安全地处理凭据。

开发人员，你们好！

请注意，开发者社区将于 2026 年 2 月 21-22 日进行定期维护。

🐎🐎🐎🐎骏马迎新春！

🎉🎉🎉🎉🎉祝大家在新的一年里代码疾驰无阻，项目推进势如破竹，上线部署稳如泰山！

🚀🚀🚀🚀🚀新的一年里，我们一起加油！

🎉🎉🎉🎉🎉祝大家除夕快乐，阖家安康！🎉🎉🎉🎉🎉  

我有一个新项目，要将 REST 响应中的信息存储到 IRIS 数据库中。我需要同步来自至少二十几个不同 REST 端点的信息，这意味着需要创建将近这么多的 ObjectScript 类来存储来自这些端点的结果。

我能否使用 ChatGPT 来创建这些类？答案是 "可以"，这非常好，因为这是我第一次尝试使用生成式人工智能来做一些有用的事情。生成长颈鹿喝汤的图片有点老....。

我是这么做的：

• 使用 "curl "查询端点，获取一些 JSON REST 调用输出示例。
• 访问 ChatGPT（InterSystems 为员工提供全公司范围的许可证）
• 与 ChatGPT 进行以下对话。

我在 "Message ChatGPT "提示符中输入了以下请求：

我：Generate an ObjectScript class that will hold data from the following JSON（生成一个 ObjectScript 类，用于保存以下 JSON 中的数据）：

在输入 JSON 之前，我点击了 "Return"，因此 ChatGPT 给我的提示如下：

ChatGPT：Please provide the JSON structure you'd like me to generate the ObjectScript class

InterSystems IRIS的嵌入式向量搜索功能使我们能够搜索非结构化和半结构化数据。数据被转换为向量（也称为 "嵌入"），然后存储在 InterSystems IRIS 中并编制索引，用于语义搜索、检索增强生成（RAG）、文本分析、推荐引擎和其他用例。

这是一个将 IRIS 用作向量数据库和在 IRIS 上进行相似性搜索的简单演示。

先决条件：

1. Python
2. InterSystems IRIS for Health - 因为它将用作向量数据库

存储库： https://github.com/piyushisc/vectorsearchusingiris

操作步骤

1. clone软件仓库。
2. 打开 VS Code，连接到所需的 IRIS 实例和命名空间并编译类。
3. 打开 IRIS 终端，调用 do ##class(vectors.vectorstore).InsertEmbeddings() 命令，从文件 text.txt 中读取文本，生成嵌入并将其存储在 IRIS 中。
4. 调用 do ##class(vectors.vectorstore).VectorSearch("search_terms") 命令，输入所需的单词以执行相似性搜索。IRIS 将返回最匹配的前三个词：

InterSystems IRIS 的架构将数据的逻辑组织（命名空间）与其物理存储位置（数据库）分开。理解这种分离以及命名空间和数据库之间的区别对于有效的数据管理、安全性，尤其是高性能数据共享至关重要。

在本文中，我将讨论这些基础组件，并提供利用全局映射跨不同逻辑环境共享本地数据结构（全局）的实用指南。

数据库：物理现实

数据库代表了数据存储在磁盘上的物理现实。首先，它是文件系统中名为 IRIS.dat 的文件（例如，<安装文件夹>\mgr\user\IRIS.DAT ）。该文件的最大容量为 32TB。它是所有实际数据和代码的容器。数据库由 IRIS 内核管理，它在物理文件级别处理缓存、日志和事务日志。

安装 InterSystems IRIS DBMS 时，会自动安装以下数据库：

有时，根据预先定义的资源 "列表（List）"限制 FHIR 搜索会更方便、更高效、更安全。

自 2025.1 版起，我们的 FHIR 服务器支持多个与列表相关的功能。

我将在此重点介绍这些功能，并提供一些示例。

InterSystems凭借其在亚洲、大洋洲及欧洲地区急性护理电子病历（Acute Care EHR）和共享护理记录领域（Shared Care Records）的卓越表现，荣获高度认可。

如何使用 LangGraph 构建应用程序：分步指南

标签#LangGraph#LangChain#AI#代理#Python#LLM#状态管理#工作流

大家好，我想向大家介绍一下我正在研究和开发的工具 LangGraph。

基本上，传统的人工智能应用程序在处理复杂的工作流和动态状态时经常面临挑战。LangGraph提供了一个强大的解决方案，可以创建有状态的代理，管理复杂的对话，做出基于上下文的决策，并执行复杂的工作流。

本文提供了使用LangGraph 构建应用程序的分步指南，LangGraph 是一个用于创建具有状态图的多步骤代理的框架。

实施步骤：

1. 设置环境和安装依赖项
2. 定义应用程序状态
3. 创建图节点
4. 配置状态图
5. 运行代理

1.设置环境并安装依赖项

第一步是设置 Python 环境并安装必要的库：

pip install langgraph langchain langchain-openai

配置 API 凭据：

import os
from langchain_openai import ChatOpenAI

# Configure your API Key
os.

 InterSystems IRIS^® data platform, InterSystems IRIS^® for Health, and HealthShare^® Health Connect 2026.1 的第三个开发者预览版已发布到 WRC 开发人员预览版网站。 容器镜像可在我们的容器注册表中找到，其标签为latest-preview。

这些开发者预览版包括从 2026.1.0 开始不再支持 Mac Intel，以及为 2026.1.0 重新添加对 Windows Server 2019 的支持。

初始文档可在以下链接中找到：

• InterSystems IRIS Data Platform 2026.1 | 文档主页
• HealthShare Health Connect 2026.1 | 文档主页

这些文档链接目前只是占位符，随着最终版本的推出和更多细节的分享，这些链接将不断更新。以下是 2026.1 文档的一些显著新增内容：

• 扩展数据库大小
• DataMove.API.Finish(Name As %String) As %Status

由于这是早期的开发者预览版，一些内容仍在开发中，我们将在功能最终完成后提供完整的文档。我们感谢您在此阶段的耐心等待和反馈！

可用性和软件包信息

该版本为所有支持的平台提供了经典安装包，如需完整列表，请参阅 "支持的平台 "文档。

各位 InterSystems EHR 社区成员，大家好，

InterSystems 认证部目前正在开发针对 CCR Tier 2 用户的认证考试。如果您符合下方的考生描述，我们需要您来参与考试的 Beta 测试！该考试将于 2026年1月27日 开始进行 Beta 测试。

Beta 测试将于 2026年3月28日 结束。

作为 Beta 测试员，我的职责是什么？

作为 Beta 测试员，我们需要您在 2026年3月28日 之前安排并参加考试。考试将在免费的在线监考环境中进行（所有 Beta 测试员均免除每门考试 150 美元的标准费用）。

随后，InterSystems 认证团队将对所有 Beta 测试数据进行仔细的统计分析，以设定考试的通过分数。Beta 测试结果的分析通常需要 6-8 周的时间。一旦确定通过分数，您将收到来自 InterSystems 认证部的电子邮件通知，告知您结果。如果您的考试分数达到或超过通过分数，您将获得该认证！

Beta 测试分数完全保密。

有兴趣参加吗？请阅读下方的考试详情。

考试详情

考试标题： InterSystems CCR EHR 应用专家

InterSystems 现在提供两种由同一团队构建并基于相同系统和流程的 EHR 产品。TrakCare 作为基础平台，而 IntelliCare 在此基础上扩展了更多功能。

在使用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 中搜索特定文本的问题一直没有改变。