InterSystems API 管理器（IAM）是 InterSystems IRIS 数据平台的核心组件，提供集中式 API 管理，重点强调安全性。IAM 简化了从创建到退出的整个 API 生命周期，并提供了一个开发人员门户，便于发现和集成 API。访问控制功能允许管理员定义精确的权限，IAM 与 IRIS 数据平台无缝集成，增强了数据管理和集成能力。

IAM 的功能包括

• API 网关：集中式 API 管理和安全中心。
• API 生命周期管理：从创建到退出的完整生命周期控制。
• 安全性：身份验证、授权和数据加密。
• 监控和分析：使用监控和模式分析工具。
• 开发人员门户网站：具有文档和测试功能的 API 发现门户。
• 访问控制：对 API 访问和操作进行细粒度控制。
• 与 InterSystems IRIS 集成：与 IRIS 数据平台无缝集成。

使用案例： 本报告中的用例是身份和访问管理。

符合 OAuth 2.0 标准的身份验证和授权，使用 IAM 确保 FHIR 服务器的安全。

在本文档中，您将了解如何使用 InterSystems API Manager 通过 OAuth 2.0 确保 FHIR 服务器的安全。OAuth 2.0 是一种广泛使用的授权标准，可使应用程序访问 FHIR 服务器上受保护的资源。

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

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

在过去的一年中，CCR 开发团队优先考虑对 CCR 应用程序进行更改，以更好地展示和鼓励使用 CCR 的最佳实践。本文将重点介绍我们关注的一些领域：

• 组织控制面板
• 系统警报
• 分支机构卫生

在上述每个领域，我们都提高了潜在 CCR 使用问题的可见性，并为用户提供了主动解决这些问题的工具。

组织控制面板

我们继续在 "组织 "详细信息页面上添加可用信息

概览（OverView）是全面了解组织 CCR 使用情况的好地方。现在，它包含了更多的关键绩效指标，突出显示了各种问题，并链接到 CCR 应用程序中您可以解决这些问题的页面。

系统选项卡包括有关所有环境中客户端工具状态的详细信息以及系统架构师信息。这里的警报会突出显示丢失的信息、不活动和过时的客户端工具，并链接到相应的系统。

组织详细信息页面上的其他选项卡也增加了更多详细信息，使组织的 CCR 使用情况一目了然。

系统警报

系统详情页是另一个提高可见性的区域，我们现在为许多 CCR 使用问题提供了警报。

新增了未设置 URL、不安全 URLS 和检测到的客户端工具问题的环境警报。悬停时会显示详细信息：

当 CCR 检测到系统的客户端工具已过期时，会出现提示，鼓励使用更新按钮。

6 个月内没有活动的系统现在会显示一个警告，如果不再使用该系统，可将其废弃，或点击此处的 "打盹 "按钮，将其视为下一年的活动系统。这适用于某些很少需要接收更新的系统。

Hi开发者们，

我们很高兴邀请大家参加即将举行的 InterSystems 全栈竞赛线上启动会！

在此次线上研讨会上，您将发现本次竞赛中等待开发人员的激动人心的挑战和机遇。我们还将讨论希望参赛者涉及的主题，并向您展示如何使用 InterSystems IRIS 数据平台开发、构建和部署应用程序。

日期和时间：美国东部时间 2 月 2 日星期一下午 12:00 | 欧洲中部时间下午 6:00

我曾多次遇到一种模式，即我需要使用临时文件/文件夹，并在稍后的某个时候将其清理掉。

在这种情况下，自然是遵循"Robust Error Handling and Cleanup in ObjectScript "中的模式，使用 try/catch/pseudo-finally 或注册对象来管理析构函数中的清理工作。%Stream.File*也有一个 "RemoveOnClose "属性，您可以对其进行设置，但要小心使用，因为您可能会不小心删除一个重要文件，而且这个标志会在调用%Save()时被重置，因此您需要在重置后将其设回 1。

不过，有一个棘手的情况——假设你需要临时文件在外部堆栈级别中继续存在。例如：

InterSystems EHR 社区的朋友们，大家好、

InterSystems Certification目前正在为 InterSystems EHR 集成专家开发认证考试，如果您符合下面的考试候选人描述，我们希望您能参与考试的测试！考试将于 2025 年 11 月 10 日开始接受测试。

测试版测试将于 2026 年 3 月 15 日结束。

作为测试版测试员，我有哪些责任？

作为测试员，我们要求您在 2026 年 1 月 15 日之前安排并参加考试。考试将在在线监考环境中免费进行（所有测试版测试者均免交每次考试 150 美元的标准费用）。然后，InterSystems 认证团队将对所有测试数据进行仔细的统计分析，以确定考试的合格分数。测试结果的分析通常需要 6-8 周的时间，一旦及格分数确定，您将收到 InterSystems Certification 通知您结果的电子邮件。如果您的考试成绩达到或超过及格分数，您将获得认证！

注意：测试分数是完全保密的。

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

大家好，现在我想继续我们之前讨论过的话题

使用 Postman 测试 InterSystems FHIR 存储库的 OAuth2.0 - 第一部分

问题1：我的client_id和client_secret是从哪里来的？

简短回答：身份验证服务器（Authentication Server）。

如果没有身份验证服务器，可按以下方法设置一个

提供主机名（主机必须支持 Https）、至少 1 种大类型（这里我们选择客户端凭证）和 SSL/TSL 配置

输入作用域（这里我们输入user/*.read和user/ *. write，这是基于 FHIR 服务器（资源服务器）支持的作用域）。万一我们遗漏了某些作用域，请检查 "允许不支持的作用域（Allow unsupported scope）"。

JWT 设置选择 RS256（这只是一个示例，您可以选择适合您架构的设置）

将生成令牌类（Generate token class）更改为%OAuth2.Server.JWT。如果需要，还可以更新命名空间。

保存（Save）设置

问题 2：如何查看身份验证服务器的 client_id 和 client_secret？

简短回答： 设置 OAuth2.0 客户端（如果没有）并创建一个客户端

以下是设置 OAuth2.0 客户端的步骤。

如果要从 x509 证书/密钥生成JWT，对%SYS.X509Credentials的任何操作（包括读取）都需要 %Admin_Secure 资源上的 U。之所以需要 %Admin_Secure，是因为 %SYS.X509Credentials 是持久的，这样做是为了防止所有用户访问私钥。

如果 %Admin_Secure 资源在运行时不可用，可以使用以下变通方法。

在查看 JWT 生成代码时，我发现 JWT 代码仅利用 %SYS.X509Credentials 作为 PrivateKey、PrivateKeyPassword 和 Certificate 的运行时数据源。作为一种变通方法，您可以使用 X.509 接口的运行时非持久化实现，只公开这些属性。如果要使用互操作性，证书/PK 可以存储在凭证中，以便安全访问：

Class User.

CCR 现在包括一个人工智能驱动的 "CCR 助手"，可供测试人员使用。CCR 助手可帮助您快速获得有关常见 CCR 工作流程、术语或最佳实践的答案。每个回复都包含相关 ICC 培训课程的参考资料，方便您深入了解任何主题。作为未来的改进，这些链接将直接指向用于生成回复的 ICC 培训 PDF 的特定页面。

要访问该助手，请点击 CCR 应用程序右下方的蓝色 "打开 CCR 助手 "图标。对话会在浏览器会话中保存，但会在注销时清除。

您可以通过点击 "竖起大拇指 "或 "摁下大拇指 "按钮并输入可选评论来提交对任何回复的反馈意见。我们非常感谢您的反馈，这将有助于我们继续提高回复质量！

要试用 CCR 助手，请导航到侧边栏的用户菜单，选中您的个人资料下的测试版测试员复选框，然后单击保存。您可以随时取消选中该复选框。

有关 CCR 助手的快速操作演示，请观看下面的视频。

大家好，又是我来分享我最近的学习心得了。

最近，我正在学习如何为 InterSystems FHIR 资源库设置 OAuth2 身份验证。我发现以下文章非常好，而且很容易理解。

使用 IRIS for Health 启动 FHIR EHR 的 SMART

在 IRIS for Health 上构建 FHIR 资源库 + OAuth2 授权服务器/资源服务器配置》第 2 部分

对我来说，作为一个对 OAuth2.0 没有太多了解的用户。我认为，在了解整个 OAuth2.0 环境之前，从纯粹的用户角度来看（它是什么、我需要哪些参数、预期输出是什么），理解如何设置整个 OAuth2.0 环境是相当困难的。在这里，我们使用 Postman 作为客户端。

如果你想有一个 OAuth 的测试环境，可以试试下面的 dockers

workshop-iris-oauth2 或本文中的 docker在 IRIS for Health 上构建 FHIR 资源库 + OAuth2 授权服务器/资源服务器配置 第 1 部分

在本文中，我在本地计算机上设置了一个支持 HTTPS 的 InterSystems FHIR 资源库 。(根据我的观察，要使 InterSystems OAuth 正常工作，资源服务器必须支持 HTTPS😑😐。）

因此，让我们从简单的开始。

InterSystems IRIS 数据平台是所有 InterSystems 应用程序以及医疗保健、金融服务、供应链和其他生态系统中数以千计的客户和合作伙伴应用程序的基础。它是一个融合平台，提供交易分析数据管理、集成互操作性和数据集成，以及集成分析和人工智能。它支持 InterSystems Smart Data Fabric 方法，用于管理多样化的分布式数据。

IPM 0.10.5 版已于 2026 年 1 月 15 日发布。新版本包含大量改进和错误修复，请务必直接从GitHub 页面或社区注册中心查看！

主要变化如下

• 重写了依赖关系解析，大大提高了性能，包括在非常复杂的情况下速度提高了 200 倍
• 跟踪 IPM 安装、加载、更新和卸载的历史日志，可使用zpm "log "查看
• 系统表达式（如${namespace} 和 $$$ 宏）现在可在 CPF 合并文件中进行评估，使初始配置更具灵活性
• 模块.xml 中的 <Invoke> 将更直观地表现为始终检查 %Status 返回值，前提是且仅当方法签名声明返回 %Status。这意味着如果没有返回任何值、返回值不是 %Status 或不是 $$$OK，就会产生错误。

以下是完整的变更列表：

已添加

• #938:为软件包命令添加了 -export-python-deps 标志
• #462:用于版本库配置的 repo 命令现在支持使用 -password-stdin 标志的密码秘密输入终端模式。
• #935:添加通用的 JFrog Artifactory tarball 资源处理器，用于将工件与软件包捆绑，并在安装时部署到最终位置。

InterSystems IRIS 提供广泛的可配置安全选项，但许多开发人员主要使用角色和资源来保护整个表或例程。今天，我们将深入探讨。我们也可以分别确保单个列和行的安全，但这两种机制的操作方式截然不同。让我们从列开始。

列安全

为便于测试和演示，我们将保持表结构简洁明了。我们在 USER 名称空间中有一个名为 "Person "的表，其中包含 ID 列、出生日期列 (DOB)、名和姓。

在上一篇文章中，我们谈到了 ODBC 和 C# 连接，现在让我们看看 JDBC 和 Java。InterSystems JDBC 驱动程序是集成 Java 应用程序的高性能推荐方式。

以下是使用 JDBC 驱动程序将 Java 应用程序连接到 IRIS 实例的分步指南。

第 1 步：获取并包含 InterSystems IRIS JDBC 驱动程序

JDBC 驱动程序与 ODBC 驱动程序不同，后者通常安装在整个系统中，而 JDBC 驱动程序通常以JAR 文件的形式发布，必须包含在 Java 项目的类路径中。

如果 InterSystems IRIS 安装在本地计算机或您可以访问的其他计算机上，您可以在 install-dir/dev/java/lib/ 或类似位置找到该文件，其中 install-dir 是实例的安装目录。反之，您也可以从驱动程序软件包页面下载 jar 文件。

或者按照 @Dmitry Maslennikov 在评论中的建议 ，使用 Maven 的maven 中央仓库：

<dependency>
    <groupId>com.intersystems</groupId>
    <artifactId>intersystems-jdbc</artifactId>
    <version>3.10.5</version>
</dependency>

或 Gradle：

implementation("com.intersystems:intersystems-jdbc:3.10.5")

在项目中包含 jar 文件：

• Maven/Gradle：如果使用构建工具，最简单的方法是将 InterSystems JDBC 驱动程序作为依赖项添加到 pom.xml 或 build.gradle 文件中。这会自动下载并管理 JAR。
• 手册：对于简单的项目，必须将 JAR 文件放在项目目录（如 /lib）中，并在编译和运行时将其明确添加到 classpath 中。

对于构建外部应用程序的开发人员，尤其是使用C# 等熟悉技术的开发人员来说，ODBC（开放数据库连接）是连接任何关系数据库（包括 InterSystems IRIS）的重要标准化桥梁。虽然 InterSystems 提供了自己的本地 ADO.NET 提供商，但 ODBC 驱动程序通常是与通用数据库工具和框架集成的最直接途径。

以下是使用 ODBC 驱动程序将 C# 应用程序连接到 IRIS 实例的分步指南，重点是无 DSN 连接字符串。

第 1 步：安装 InterSystems IRIS ODBC 驱动程序

在 Windows 机器上安装 InterSystems IRIS 时，默认会安装 InterSystems ODBC 驱动程序。

• 如果 IRIS 位于同一台计算机上：驱动程序已经存在。
• 如果 IRIS 位于远程服务器上：如果您是客户机，则必须从 WRC 网站下载并安装适用于客户机操作系统（Windows、Linux 或 macOS）和位元（32 位或 64 位）的独立 ODBC 客户机驱动程序包，或者安装客户机组件并复制 ODBC 驱动程序。

安装完成后，可在 Windows 的ODBC 数据源管理员（ODBC Data Source Administrator）工具中验证其是否存在（查找 InterSystems IRIS ODBC35 驱动程序）。

不可避免的是，您最终需要将您的代码从一个版本的 IRIS 或 Cache 升级到最新版本的 IRIS。在这一过程中，您可以采取一些好的步骤来为自己的成功做好准备。

仔细阅读文档

在迁移任何代码之前，你应该先查看IRIS 文档页面，其中包含许多关于IRIS不同版本变更的有用资源。如果你需要跨多个版本升级，请查阅所有相关版本的文档，而不仅仅是目标升级版本。对于每个版本，点击“维护版本变更”（Maintenance Release Changes）链接，你将看到一份开发人员升级清单，对指导你需要进行的修改非常有帮助。你还应查看“发布说明”（Release Notes），其中列出了可能对你有用的新功能，以及已被弃用的功能。此外，建议访问“产品新闻与警报”（Product News and Alerts）页面，以获取最新的紧急事项。事实上，即使不进行升级，定期查看该页面或订阅警报通知也是个好主意，以便及时了解变更。

了解你的替代方案

根据你在文档中阅读到的内容，你可能会看到一堆问题。不过，在开始处理这些问题之前，您应该花些时间了解一下有哪些替代方案。如果您喜欢使用的特定 ObjectScript 类已被弃用或移除，那么如果您打算使用集成的 Python，就不要只寻找 ObjectScript 的替代品。如果您是 Zen 报表的用户，InterSystems Reports 就是该工具的替代品。

互操作性用户界面项目从 2025.1 版继续 进行，并纳入了许多我们的客户和合作伙伴建议和观察到的项目。 我们将继续投资于反馈和更新这一重要的用户体验。在最新发布的 2025.3 版（适用于 IRIS、 IRIS for Health、 HealthConnect 和 Health Connect Cloud） 中 ， DTL 编辑器 和 生产配置 应用程序可选择
NOTE：

• 您可以在现代化和标准体验之间切换。
• 所有其他互操作性屏幕仍保留在标准用户界面中。
• 由于新的用户界面将提供新的工作流程，我们希望在这项工作继续进行的同时提供两种体验。

• 现在每个生产配置主机上都会显示池大小 数量。
• 现在可以在主机的类别字段中直接输入命名约定来创建新类别。
• 生产配置中现在支持浏览器级控制查找。
• 生产配置主机项目现在具有测试主机功能。
• 在新的 "设置面板 "中，出现了 X 取消图标以取消操作。
• 较长的类工具提示 说明根据类文档格式化。
  • 
    
    • 增强了配置项描述的显示，以尊重较长结构化描述的标记。

• 如果不在主机项目或生产的上下文中，操作项目会显示为灰色 。
• 创建主机时可自动创建路由器和角色。
• 在支持的情况下，现在可以选择更新和恢复生产。
• 现在可以 通过新的用户界面创建产品 。
• 编辑主机类别时，允许查看连接。

大家好，社区成员们：

对于刚接触InterSystems IRIS的开发者而言，这有个好消息！我们现已在Instruqt平台上推出了实操互动教程！这些教程非常适合希望快速上手、在真实环境中演练，并建立对基于IRIS的开发信心的开发者。（译者注：国内需要🪜）

以下是可用教程列表：

• Full Stack Tutorial  - 体验 IRIS 如何支持全栈系统架构。
• InterSystems Interoperability  - 探索用于连接和集成系统的 IRIS 互操作性工具。
• IRIS for Health Interoperability学习如何使用 IRIS for Health 功能与 EHR（电子病历）数据进行应用程序集成。
• REST + Angular Application- 练习使用 IRIS REST 服务构建应用程序。
• RAG using IRIS Vector Search- 探索 IRIS 向量搜索在人工智能驱动的应用程序中的功能。

大家好！

以下是在 InterSystems 开发者社区的帖子中使用 GIF 的一些基本规则：

cache是否支持部署多活架构，就像是Oracle那样通过共享存储实现RAC

概述

25.24.1 版对 DNS 功能、平台可靠性、升级工作流和开发人员体验进行了重大增强。该版本还包括关键修复和平台限制的增加，以更好地支持现代工作负载。

新功能和增强功能

概述

25.23.2 版对高级安全用户界面进行了有针对性的改进，并进一步简化了 InterSystems 云产品的升级和更新工作流程。这些更改重点关注清晰度、效率和卓越运营。

新功能和增强功能

建议采取的行动

• 查看更新后的高级安全用户界面，让您的团队熟悉改进后的应用程序表示方法。

支持

有关此版本的更多信息或帮助，请通过 iService 或云服务门户联系 InterSystems 云服务支持。

概述

本版本对存储的可扩展性和性能进行了重大改进，对所有产品的操作系统进行了重大升级，并推出了新的 FHIR 服务器默认版本。这些更新共同增强了系统的可靠性、灵活性和安全性，同时确保了平台的长期可支持性。

新功能和增强功能

概述

25.20.2 版扩展了全球可用性，提高了高级安全灵活性，并扩大了网络连接集成。该版本引入了对更多地区的支持、新的应用程序感知安全规则，以及针对关键 InterSystems 服务的更多连接选项。

新功能和增强功能

InterSystems Ideas 门户网站上得票最多的想法-——获得 74 票——要求提供一个轻量级版本的 IRIS。虽然该平台已发展成为一个强大的数据引擎，但许多项目只需要其 SQL 数据库功能。本文演示了如何构建一个非官方的、紧凑的 IRIS 社区版镜像，该镜像只关注核心数据库功能，将镜像大小缩小了 80% 以上。

⚠️ 免责声明

本项目生成的是 InterSystems IRIS Community Edition 的非官方实验镜像。

• 不受InterSystems支持或认可。
• 使用风险自负。这些修改删除了核心平台功能，可能会破坏与工具、API 和预期行为的兼容性。
• 不提供任何担保或保证，包括对生产使用的适用性。
• 仅供高级用户用于教育和实验目的。

为什么选择轻量级 IRIS？

虽然 IRIS 目前包含丰富的互操作性、分析、机器学习、系统管理等功能，但许多项目只需要其核心 SQL 功能。官方社区版 Docker 镜像约为

• 磁盘使用量3.5-3.8 GB
• 压缩后大小：~1.1 GB

IRIS Light 可将其减少到

• 磁盘使用量~575-583 MB
• 压缩后大小：~144-148 MB

因此适用于

• 微服务或容器化 SQL 使用
• 具有更快启动和拉动速度的 CI 管道
• 无需完整功能的横向扩展

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 IRIS 的背景下探讨动态 SQL（Dynamic SQL）和嵌入式 SQL（Embedded SQL ） 的概念，提供实际示例， 并 研究 它们的区别 ，以帮助您了解如何在应用程序中利用它们。

InterSystems SQL 提供全套标准关系功能，包括定义表模式、执行查询、定义和执行存储过程。您可以通过管理门户交互式地执行 InterSystems SQL，也可以使用 SQL shell 界面以编程方式执行 InterSystems SQL。嵌入式 SQL 使您可以在 ObjectScript 代码中嵌入 SQL 语句，而动态 SQL 使您可以在运行时从 ObjectScript 执行动态 SQL 语句。 静态 SQL 查询提供可预测的性能，而动态和嵌入式 SQL 则分别提供灵活性和集成性。

当我开始使用 InterSystems IRIS，尤其是在互操作性方面时，我最初遇到的一个常见问题是：如何在间隔时间或计划内运行某项功能？在本专题中，我想分享两个简单的类来解决这个问题。我很惊讶在 EnsLib 的某个地方没有找到类似的类。也许是我搜索得不好？总之，这个主题并不意味着是复杂的工作，只是为初学者提供了几个片段。