InterSystems ObjectScript 是一种脚本语言，可使用 InterSystems 数据平台的任何数据模型（对象、关系、键值、文档、全局变量/Global）处理数据，并在 InterSystems 数据平台上为服务器端应用程序开发业务逻辑。
文档。
在 ObjectScript 代码中，ClassMethods 的使用似乎很普遍。我希望我自己的经历不具有代表性，但我打赌它们确实具有代表性。请原谅我泄露了本文的结尾，但简而言之：不要使用它们。除非你能提出令人信服的理由证明你必须这样做，否则就永远不要使用它们1。
什么是ClassMethod？在 ObjectScript 类中，您可以通过两种不同的方式定义方法：在 Method 中，您必须实例化类的实例才能调用方法；而在 ClassMethod 中，您可以调用方法而无需实例化类。当然，在 ClassMethod 中，你无法访问对象的任何属性（因为没有对象），但你可以访问 globals（毕竟它们是全局的）和 Parameters（即类常量）。
大家好、
请观看在线学习中的这些新视频，熟悉 InterSystems® 产品最新版本中的新功能和界面。学习服务 YouTube 频道也提供所有视频。
此外，您还可以观看面向ObjectScript 新开发人员的视频，以及面向HealthShare® 用户的部署升级指南。
如果您曾经在一个大型的IRIS命名空间中查找某个字符串、方法调用或模式的使用位置，您就会知道其中的痛苦：没有内置的方法可以在VS代码中对服务器端的ObjectScript代码进行grep式搜索--至少不需要跳过一些障碍。
这就是ObjectScript搜索要解决的问题。今天就从VS代码市场中简单安装一下试试吧。
如果不喜欢，卸载也很简单。但我认为你会喜欢它的--对于任何在 VS Code 中进行 ObjectScript 开发的人来说，它都是生活质量的巨大提升。
官方的 vscode-objectscript 扩展确实包含搜索功能。不过，要启用该功能，目前需要等待拟议中的 VS Code API 最终确定，或者手动安装扩展的自定义构建并启用拟议中的 VS Code API。这两种方法对于希望开箱即用的开发人员来说都不理想。
ObjectScript Search 是一个临时、独立的扩展，目前弥补了这一缺陷。它通过 InterSystems 活动栏中的专用面板提供全文服务器端搜索，无需特殊构建或拟议的 API。一旦官方扩展将搜索作为头等功能发布，该扩展将达到其目的，但在此之前，它在这里，它可以工作。
ObjectScript Search 的作用 ObjectScript Search 在 InterSystems 侧边栏中直接添加了搜索视图。
嘿，社区的朋友们大家好！
是的，我知道我们有很多技巧和窍门类的文章-——我们甚至为此专门设置了一个标签（Tips & Tricks），不是吗？但我不能分享我自己的收藏。在这个合集中，您可以找到适合初学者的代码片段，以及一些日常的 ObjectScript 结构。事实上，这也是一种学习我最喜欢的编程语言的新方法。所以，如果你们有什么要补充的，欢迎提出！
我们一开始并没有大的人工智能战略。
我们有一个传统的 InterSystems Caché 2018 应用程序、大量老旧的业务逻辑和一个实际需求：构建一个新的用户界面并改进已运行多年的代码。起初，我认为人工智能编码代理只能帮助完成一小部分工作。也许是一些模板、系统周围的一些 REST 工作，以及帮助阅读旧的 ObjectScript。
但实际上，它的作用远不止这些。
当我们开始认真使用它时，我们意识到它可以跨越庞大的代码库，理解模式，提出重构建议，并帮助我们以比我预期快得多的速度实现 Caché 的现代化。但这只是在开始时经历了一段令人沮丧的时期之后才发生的。
真正的挑战不是获得代码建议。而是教会代理我们的 Caché 环境如何实际运行。
在进行任何技术工作之前，我们必须回答一个安全问题。
我们不能将企业资源规划代码和内部业务逻辑直接发送给公共人工智能服务，并寄希望于最好的结果。这样做永远无法通过严格的安全审查。
亚马逊 Bedrock 改变了我们的想法。我们的服务器、数据和开发环境已经在 AWS 中，因此 Bedrock 可以很自然地融入我们已经信任和管理的云环境。我们可以使用该模型，同时将流量、访问控制和周边安全控制保持在我们已经在使用的 AWS 框架内。
大家好，我是姚鑫。
最近一段时间，我把自己过去几年在 InterSystems IRIS 项目中的开发经验，系统整理成了一本书—— 📕 《IRIS(数据平台)编程技术指南》 现已由 北京航空航天大学出版社 正式出版发行。
说实话，写书的过程比我想象中要难很多。 如果说写博客是“随手记录”，那么写书就是一次真正的“工程项目”：要保证结构完整、逻辑严谨、内容能从入门一路带到实战。
本书围绕 InterSystems IRIS 的核心开发语言 ObjectScript 展开，内容不仅讲语法，更注重“工程实践”。
主要包括：
✅ IRIS 平台介绍与开发环境搭建 ✅ ObjectScript 语法规则、变量体系、全局变量机制 ✅ 常用数据类型、表达式、系统命令、系统函数 ✅ 函数与方法、面向对象编程基础 ✅ %Persistent 持久类（ORM 与 SQL 映射） ✅ Storage 存储策略、懒加载机制、并发分析 ✅ 嵌入式数据结构、常见性能问题与技术难点解析
整体内容更偏向“项目实战型”，不是纯概念堆砌。
急诊医疗服务（EMS）团队到达急诊科时，常常会遇到人口统计数据不完整或未知的病人——没有病历号（MRN），没有确认的姓名，有时甚至没有出生日期。然而，急救医疗运送记录仍然需要准确无误地记录在病历中。
为了支持安全可靠的记录，急救医疗机构、第三方集成服务和医院集成团队建立了安全接口，用于交换识别码和临床信息。当这些标识符不一致时，下游系统就无法自动发布转运记录，从而产生可避免的人工操作，并延误记录的完整性。本文概述了如何使用 FHIR Patient.Search (R4) 来填补最常见的人口统计空白并改进自动发布。
在许多 EMS 到医院的集成中，患者最初是以通用或临时标识符注册的。最终登记和任何记录合并可能要到稍后才会发生，有时是在出院后。在这些更新传播之前，EMS 患者标识符和电子病历 (EMR) 标识符可能一直不同步。
当转运记录因不匹配而无法发布时，集成通常会生成一个错误，并转到 EMR 工作队列进行人工审核。在 EMS 处理量大的情况下，队列会迅速增长。
在我年轻的时候（具体有多年轻不在本文讨论范围之内），"token"这个词意味着乐趣。你看，每年我都会有几次机会去街机厅，和朋友们一起玩一些有趣的电子游戏。
如今，token意味着安全。JSON 网络令牌（JWT）身份验证已成为确保 REST API 安全的最流行标准之一。幸运的是，对于 IRIS 用户来说，我们有一种直接的方法来设置应用程序，使其受到这种方式的保护。然而，这种想法仍与我以前玩街机时的想法相似。如果你想玩游戏，就需要获取一些token！
设置
我们的首要任务是为 IRIS 做好准备，使用户能够获取token。首先，我们要在全系统范围内允许使用 JWT 身份验证。为此，我们将打开系统管理门户并登录。然后，我们将进入System Administration > Security > System Security > Authentication\Web Session选项。在同一区域，我们还可以授权其他身份验证替代方案，如 LDAP 和双因素身份验证。在变体列表的底部附近，我们会发现一个名为 "JWT Issuer Field "的字段，在这里我们必须键入一些值来标识token发行者。它可以是任何唯一的字符串，但通常是一个 URL 或域。这应该由应用程序接口和前端开发人员事先商定。您可以选择用户访问 API 时发送请求的 URL。在我的示例中，我将选择 www.myurl.
InterSystems 常见问题
如果您尝试从顶级节点删除在子脚本级别映射的全局变量，您将收到一个<SLMSPAN>错误，并且它不会被删除。这是因为用于子脚本级别映射全局变量的kill命令不能跨映射使用。
// Suppose subscript-mapped globals exist in different databases, as shown below:^TESTK要只删除当前命名空间（数据库）中的全局，请使用以下命令：
NAMESPACE>在子脚本级别映射的全局变量必须移动到数据库并直接删除。
要切换到数据库，请使用以下命令：
set使用 导入全局时，默认行为是在导入之前删除全局变量。因此，如果目标全局变量是子脚本级别映射的，则会发生<SLMSPAN>错误。在这种情况下，指定/mergeglobal标志作为system.OBJ.Load的第二个参数以防止预先删除，如下所示：
[参考资料］
无法导出映射全局。
如何编译映射的类和例程？
在上一篇文章中，我们介绍了IrisOASTestGen——一个基于OpenAPI 2.0规范为InterSystems IRIS生成REST API测试代码的工具。该文章展示了如何使用OpenAPI Generator附带的默认模板来搭建测试用例。本文将聚焦于接下来的自然步骤**：自定义生成的测试代码**。通过使用Mustache模板扩展代码生成逻辑，我们可以表达更丰富的语义、实现CRUD感知测试，并创建更有意义的测试套件。本文的示例将修改IrisOASTestGen，为createPerson操作生成测试，包括遍历所有预期响应。这将展示如何使用OpenAPI规范中的自定义字段来驱动Mustache模板内的条件渲染。
为了使代码生成支持CRUD操作，OpenAPI规范可以在vendorExtensions中包含自定义字段。这些自定义字段作为标志，Mustache模板可以检测到它们。
该演示基于原始类描述。
使用的数据类包括地址、人员、雇员和公司。
为使演示更具吸引力，添加了按 ID 命名的 JSONtoString 方法。
本文将讨论 Microsoft Visual Studio Code IDE中包含的所有调试工具 。
内容包括
让我们从了解调试要求开始！
前提条件
有两个插件（扩展）可用于调试 ObjectScript：
第一个是 InterSystems ObjectScript 扩展包的一部分 。第二个是 Serenji，它是一个独立的插件，提供编辑器、文件管理器和调试功能。这两个插件都可以从插件商店安装。要激活关键功能，Serenji 需要许可证。在本文中，我们将使用 InterSystems ObjectScript 扩展包来降低学习难度。在掌握基础知识后，您可以考虑购买 Serenji 的付费许可证。
概述
嵌入式 Python改变了 InterSystems IRIS 的游戏规则，可直接在数据库中访问庞大的 Python 生态系统。但是，在 ObjectScript 和 Python 之间架起桥梁有时会让人感觉像是在两个不同的世界之间转换。
为了实现这种无缝过渡，请使用embeddedpy-bridge。
该软件包是一个以开发人员为中心的实用工具包，旨在为嵌入式 Python 提供高级 ObjectScript 封装、熟悉的语法和强大的错误处理功能。它允许开发人员使用他们已经熟悉的本地 IRIS 模式与 Python 数据结构交互。
虽然 %SYS.Python 库功能强大，但开发人员经常面临一些障碍：
While 循环无法与 Python 迭代器进行本地 "对话"。embeddedpy-bridge我的目标是创建一个 "桥梁"，让 Python 感觉像是 ObjectScript 中的一等公民。
py 前缀约定：%ZPython.Utils你好
数据迁移通常听起来像是一个简单的 "将数据从 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 时会让您恼火。
我有一个新项目，要将 REST 响应中的信息存储到 IRIS 数据库中。我需要同步来自至少二十几个不同 REST 端点的信息，这意味着需要创建将近这么多的 ObjectScript 类来存储来自这些端点的结果。
我能否使用 ChatGPT 来创建这些类？答案是 "可以"，这非常好，因为这是我第一次尝试使用生成式人工智能来做一些有用的事情。生成长颈鹿喝汤的图片有点老....。
我是这么做的：
我在 "Message ChatGPT "提示符中输入了以下请求：
我：Generate an ObjectScript class that will hold data from the following JSON（生成一个 ObjectScript 类，用于保存以下 JSON 中的数据）：
在输入 JSON 之前，我点击了 "Return"，因此 ChatGPT 给我的提示如下：
ChatGPT：
在使用InterSystems 互操作性（Iris/Health Connect/Ensemble）时，配置数据通常分散在许多生产项目中：服务、流程、操作、适配器及其设置。
常见的操作或安全需求是回答以下问题：
下面的 ObjectScript 工具正是通过将选定的配置设置导出到 CSV 文件来解决这个问题的。
该脚本
Ens_Config.Item):、/ 或 \ 的值）当您需要时，应使用此实用程序：
这对使用许多接口和适配器的多个产品的大型实例尤其有用。
您可能知道这种情况：
前段时间，你发现了一个非常特殊的 $ZU 函数，可以解决一种非常特殊的问题。某种神秘的公式。它变得很流行，被许多开发人员在您的代码和所有安装中使用。
几个版本和更新之后，ISC 通知你，你的神秘 $ZU 已经过时，不再支持。建议您用新的 $something() 替换它。
那么，如何找到并记录这段神秘代码的用法呢？
它可能位于类、MAC、INT 或 INC 代码中。
它也可能分布在多个命名空间中。
在过去，Studio 还不够完善：它不适用、速度慢、不准确。
我在不同的安装中不止一次遇到过这种情况。
当时还没有源代码控制功能，即使最终引入了源代码控制功能，也很少有人使用。
由于 ObjectScript 是应对这一挑战的唯一可能选择，我编写了自己的实用程序。
我的解决方案经过了多年的发展，一旦计划迁移到 IRIS，我就会再次检查它的实用性。
由于它是用纯 ObjectScript 编写的，因此在 IRIS 中无需修改任何字符即可运行。
如您所知，在 ObjectScript 中搜索特定文本的问题一直没有改变。
大家好！
我们诚挚邀请您参与塑造下一代 ObjectScript 开发工具。我们正致力于打造一款专为 IRIS 开发者设计的、由人工智能驱动的 ObjectScript 编程助手。它并非仅是套用通用 AI 来适配 ObjectScript，而是从零起步、量身构筑的系统，能够深谙 ObjectScript 的行话精髓、IRIS API、互操作生产环境（interoperability productions），以及开发者在真实场景中的工作流。
为了确保我们打造出真正有用的产品，我们需要您的意见。
👉 ObjectScript Coder Agent 开发者调查👈
.jpg)
我曾多次遇到一种模式，即我需要使用临时文件/文件夹，并在稍后的某个时候将其清理掉。
在这种情况下，自然是遵循"Robust Error Handling and Cleanup in ObjectScript "中的模式，使用 try/catch/pseudo-finally 或注册对象来管理析构函数中的清理工作。%Stream.File*也有一个 "RemoveOnClose "属性，您可以对其进行设置，但要小心使用，因为您可能会不小心删除一个重要文件，而且这个标志会在调用%Save()时被重置，因此您需要在重置后将其设回 1。
不过，有一个棘手的情况——假设你需要临时文件在外部堆栈级别中继续存在。例如：
InterSystems IRIS 提供广泛的可配置安全选项，但许多开发人员主要使用角色和资源来保护整个表或例程。今天，我们将深入探讨。我们也可以分别确保单个列和行的安全，但这两种机制的操作方式截然不同。让我们从列开始。
列安全
为便于测试和演示，我们将保持表结构简洁明了。我们在 USER 名称空间中有一个名为 "Person "的表，其中包含 ID 列、出生日期列 (DOB)、名和姓。
.png)
大家好！
在本文中，我们将在 InterSystems IRIS 的背景下探讨动态 SQL（Dynamic SQL）和嵌入式 SQL（Embedded SQL ） 的概念，提供实际示例， 并 研究 它们的区别 ，以帮助您了解如何在应用程序中利用它们。
InterSystems SQL 提供全套标准关系功能，包括定义表模式、执行查询、定义和执行存储过程。您可以通过管理门户交互式地执行 InterSystems SQL，也可以使用 SQL shell 界面以编程方式执行 InterSystems SQL。嵌入式 SQL 使您可以在 ObjectScript 代码中嵌入 SQL 语句，而动态 SQL 使您可以在运行时从 ObjectScript 执行动态 SQL 语句。 静态 SQL 查询提供可预测的性能，而动态和嵌入式 SQL 则分别提供灵活性和集成性。
什么是 XML？
XML（可扩展标记语言）是一种灵活的、基于文本的、独立于平台的格式，用于以结构合理 、人机可读的方式存储和传输数据 。XML 允许用户定义自定义标签来描述数据的含义和组织结构。例如：<book><title>The Hitchhiker's Guide</title></book>.
XML 文档具有自描述性，其结构是一棵分层的元素树。每个文档都有一个封装所有其他内容的根元素。元素可以包含文本、子元素和属性（提供补充信息的名-值对）。这些文档通常用 .xml 文件存储
这种结构的完整性可以通过以下方式实现：
这部分内容介绍如下：
在这些实施过程中，两种格式都会首先转换为 InterSystems IRIS SDA（标准化数据架构）格式。这被认为是一种标准、高效、不易出错的方法，因为它有效地利用了平台的 预置类。数据采用 SDA 格式后，可无缝转换为任何目标标准，如 HL7 v2、 FHIR 或 CCDA。
InterSystems 常见问题解答标题
^%GCMP 实用工具可用于比较两个全局变量的内容。
例如，要比较 USER 和 SAMPLES 命名空间中的 ^test 和 ^test，过程将与下面类似：
*以下示例在这两个命名空间中创建了 700 个相同的全局变量，并更改了其中一个的内容，使其成为检测目标。
USER>kill^testUSER>zn"samples"
SAMPLES>
如果要在不同服务器上的实例之间进行比较，而不是在同一实例中，请使用 ^DATACHECK 实用工具。 有关如何使用 ^DATACHECK 实用工具的说明，请参阅以下相关文章：
在本节中，我们将探讨如何在 IRIS 中使用 Python 作为主要编程语言，在使用 Python 编写应用程序逻辑的同时仍能利用 IRIS 的强大功能。
尽管IRIS和HealthConnect拥有全面的互操作特性，但在实际工作中，还是有可能遇到需要使用遗留类库，dll SDK等方式与外部应用通信的情况。例如IRIS中并没有内嵌国密算法SM2、SM3和SM4，而开源社区中不乏通过Java、Python和C++等语言完成的具体实现。本文就将以调用SM4的Java实现为例展示ObjectScript程序与第三方语言通信的过程。
Github地址：https://github.com/LinZhuISC/javademo.SM4
在开始实际操作之前，希望读者先针对整个调用过程中的主调方和被调方思考两个现象：
针对这两个现象，开发者需要思考，在哪一侧需要做什么样的一些工作以便调用过程能够顺畅进行。
首先，祝开发者社区的各位成员新年快乐！ 我们希望今年为大家带来更多好东西，今天我想介绍 VS Code的最新版 Intersystems Language Server 扩展程序。 大多数 Language Server 改进都可以通过 ObjectScript 扩展 UI 体验到，因此您可能不知道 2024 年我们发布了 Intellisense 和鼠标悬停等方面的许多改进。 请快速浏览 Language Server 更新日志 看看您错过了什么。 最近发布的2.7.0 版本带来了对 Windows ARM 平台的支持，因此，如果您使用 Surface Pro 11 这类设备（我正在用这台设备愉快地写这篇帖子），那么您现在可以在您的设备上获得出色的 ObjectScript 开发体验。 赶快试用一下，并在下方评论区中分享您的使用心得。
InterSystems SQL
表是一种由表示特定实体的行和表示每个实体特定数据点的列组成的数据结构。
系统
在受保护的 IRIS 应用中，由应用程序授予给已经是其他角色（称为匹配角色）成员的用户的角色。如果用户拥有匹配角色，则在使用应用程序时，用户还可以被授予一个或多个额外的目标角色。
系统
试图认证到 LDAP 服务器的用户。IRIS 通过在特定 LDAP 配置的“编辑 配置”页面上的 唯一搜索属性字段中使用提供的值，尝试在 数据库中查找该用户。可以从 配置页面（系统管理 > 安全 > 系统安全 > 配置）访问“编辑 配置”页面。（请注意，如果启用了 ，页面名称和菜单选项中会包含 。）
通用
传输控制协议/互联网协议（），是可以管理关系客户端和关系服务器之间连接的通信协议之一。也称为 TCP。
系统
存储在临时数据库 中的全局。请参见临时全局和 数据库。
系统
正式而言，该术语指的是 终端应用程序。非正式而言，该术语也可以指 ObjectScript shell，即 的交互式命令行接口。终端应用程序包括 ，但也提供菜单和其他选项。
对象（Objects）
使用自定义存储或编写自己的存储类时必须实现的一组方法。
对象（Objects）
类使用的存储策略在编译时评估为存储定义，决定数据的存储方式。
SQL
存储过程允许你从 ODBC 或 JDBC 执行查询或类方法。
对象（Objects）
流接口用于在 ObjectScript、SQL 和 中操作流。
对象（Objects）
流提供了一个接口，用于操作和存储大量数据。 流接口可在 ObjectScript、SQL 和 中用于操作流。
系统
监听指定端口的服务器，用于接收对 的传入连接并将其分发到适当的子系统。默认的超级服务器端口是 ；如果 1972 不可用，超级服务器将从 开始监听下一个可用端口。要设置超级服务器端口号，请使用管理门户（系统管理 > 配置 > 系统配置 > 内存和启动）中的内存和启动页面的超级服务器端口号字段。
对象（Objects）
当嵌入和持久对象被引用时，自动将其拉入内存的过程。也称为懒加载。
对象（Objects）
系统
IRIS 内部的表，存储所有由进程发出的 LOCK 命令。你可以使用系统查看器查看此表。
系统
系统管理员目录中的文件，包含关于系统操作、错误和指标的消息。这些包括消息日志（）、系统监视器日志（SystemMonitor.log）、警报日志（alerts.log）、初始化日志（）和日志历史记录日志（）。有关这些日志文件的信息，请参见“监控日志文件”。
对象（Objects）
对象属性的逻辑格式是在内存中使用的格式。所有的比较和计算都是基于这种格式进行的。
系统
通过认证到IRIS 时与用户关联的任何角色（而不是之后关联的角色）。
ObjectScript
ObjectScript 编译器的一部分，将宏代码转换为可用的 代码。
ObjectScript
编写例程和方法的最高、最灵活和最宽松的代码级别。宏源代码允许使用 语法、特殊宏预处理器命令和 标准 的组合来定义宏和嵌入式 语句。
系统
在
系统
在通用引用 IRIS 安装目录时，文档使用术语 install-dir。在示例中，文档使用 C:\MyIRIS\。章节“默认安装目录”描述了 在所有受支持操作系统上的安装位置。
对象（Objects）
表示特定实体的类的实现。术语“实例”和“对象”可以互换使用。
系统
本地认证系统：用户会被提示输入密码，输入的密码的哈希值会传递到 IRIS 服务器，并与服务器中存储的现有密码的哈希值进行比较。如果两个值相同， 将授予用户对其有权限的资源的访问权限。
此机制在管理门户中列为“密码认证”。
对象（Objects）
从类的特定实例调用的方法，并执行与该实例相关的某些操作。
对象（Objects）
将对象实例放入内存中，以便程序可以对其进行操作。
ObjectScript
IRIS 中可用的标准三代语言（） 源代码。中间代码由 编译器从宏源生成。在这个阶段，所有预处理器语法（包括嵌入式 ）都已解析，例程仅包含纯源代码。可以在这个级别编写 例程，但无法使用嵌入式