大家好！ 👋
欢迎来到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 - 导入新表

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

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

会发生什么？

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

此外，在以前的版本中，您可以定义您的 FHIR 服务器接受通过 OAuth 2.0 发送的请求（例如，用于 FHIR 客户端上的 SMART），但在前不久发布的 v2024.3 中，有一项新功能可以更轻松地实现这一点，即OAuth FHIR 客户端快速启动（OAuth FHIR Client QuickStart）。

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 错误页面？

如果要从 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.

在上一篇文章中，我们谈到了 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 驱动程序）。

导言

InterSystems IRIS 数据平台一直以其性能、互操作性和跨编程语言的灵活性而著称。多年来，开发人员可以将 IRIS 与 Python、Java、JavaScript 和 .NET 结合使用，但 Go（或Golang）开发人员却只能望洋兴叹。

这种等待终于结束了。

新的go-irisnative驱动程序为 InterSystems IRIS 带来了GoLang 支持，实现了标准的 database/sql API。这意味着 Go 开发人员现在可以使用熟悉的数据库工具、连接池和查询接口来构建由 IRIS 支持的应用程序。

为什么要支持 GoLang

GoLang 是一种专为简单性、并发性和性能而设计的语言，是云原生和基于微服务架构的理想选择。它为 Kubernetes、Docker 和 Terraform 等一些世界上最具可扩展性的系统提供了支持。

将 IRIS 引入 Go 生态系统可实现以下目标

• 使用 IRIS 作为后台的轻量级高性能服务。
• 并行查询执行或后台处理的本机并发性。
• 与容器化和分布式系统无缝集成。
• 通过 Go 的 database/sql 界面进行自动化数据库访问。

这种集成使 IRIS 成为现代云就绪 Go 应用程序的完美选择。

如果你觉得 IRIS 对 Go 的原生支持令人兴奋，那就等着看 GORM 加入后会发生什么吧。

就在最近，随着go-irisnative 的发布，我们迎来了 InterSystems IRIS 的本地 GoLang 支持。这仅仅是个开始。现在，我们又推出了gorm-iris ——一个 GORM 驱动程序，旨在为您的 IRIS + Go 堆栈带来对象关系映射 (ORM) 的强大功能。

为什么选择 GORM？

GORM 是 Go 生态系统中最流行的 ORM 库之一。它使使用 Go 结构而不是编写原始 SQL 与数据库交互变得简单。通过自动迁移、关联和查询构建等功能，GORM 极大地简化了后端开发。

因此，在实现 Go 与 IRIS 的本地对话后，下一步自然是让 GORM 与 IRIS 无缝协作。这正是 gorm-iris 所要做的。

对于使用 InterSystems IRIS 的 Go 开发人员来说，我们已经达到了两个重要的里程碑：

• 终于等到你：欢迎了解 InterSystems IRIS对GoLang 的支持——我们发布了新的go-irisnative驱动程序，为 Go 提供了本地 database/sql 接口。
• GORM 与 InterSystems IRIS 的相遇：介绍一下 gorm-iris—— 我们在这里展示了如何将 IRIS 与GORM 集成，GORM 是最流行的 Go ORM 库之一。

现在是时候看看一切如何协同工作了。

为了演示 Go 开发人员可以如何轻松地采用 InterSystems IRIS，我使用了一个现有的生产级开源项目——RealWorld 示例应用程序——它展示了使用Go Fiber、GORM 和SQLite 实现的 Medium.com 式全栈克隆。

只需稍作配置调整，我就将 SQLite 换成了gorm-iris，其他一切保持不变。结果如何？
一个由 InterSystems IRIS 支持的功能齐全的 Go + Fiber 应用程序——不需要重写代码，不需要 ORM 体操，只需要一个不同的数据库后端。

您可以在这里找到完整的工作演示：github.com/caretdev/golang-fiber-iris-realworld-example-app

概述

快捷式医疗服务互操作资源 (FHIR) 是一个由 HL7 International 开发的标准化框架，旨在以灵活、对开发者友好且现代的方式促进医疗数据的交换。 它利用现代网络技术来确保在医疗保健系统间实现无缝集成与通信。

关键 FHIR 技术

• 用于资源交互的 RESTful API
• 用于数据表示的 JSON 和 XML
• 用于安全授权和身份验证的 OAuth2

FHIR 围绕着称为资源的模块化组件构建，每个组件代表特定的医疗保健概念，包括：

• 患者 – 受众特征和标识符
• 观察数据 – 临床测量数据（例如，生命体征、实验室检测结果）
• 诊疗 – 患者与医疗服务提供者的互动
• 药物、过敏不耐受、健康状况等

资源单独定义，并且可以引用其他资源，以构成一个完善的数据模型。

InterSystems IRIS for Health：FHIR 支持

InterSystems IRIS for Health 是一个专为医疗保健行业设计的统一数据平台。 它包含对 HL7 FHIR 的原生支持。 它提供内置工具与服务，能够实现 FHIR 资源的存储、检索、转换和交换。IRIS 通过三大 FHIR 处理组件提升系统的互操作性：

1.

在本节中，我们将探讨如何在 IRIS 中使用 Python 作为主要编程语言，在使用 Python 编写应用程序逻辑的同时仍能利用 IRIS 的强大功能。

• IRIS 中的 Python 优先方式简介
  • 使用方法 (irispython)
    • 什么是 irispython？
    • irispython 使用示例
    • 优点
    • 缺点
    • 结论
  • 使用 WSGI
    • 使用方法
    • WSGI 使用示例
    • 优点
    • 缺点
    • 结论
  • DB-API
    • 使用方法
    • DB-API 使用示例
    • 优点
    • 缺点
    • 备选方案
    • 结论
  • Notebook
    • 使用方法
    • Notebook 使用示例
    • 优点
    • 缺点
    • 结论
• 补充部分
  • 使用原生解释器（无 irispython）
    • 使用方法
    • 优点
    • 缺点
  • DB-API 社区版
    • 使用方法
    • DB-API 使用示例
    • 优点
    • 缺点
  • 在 IRIS 中调试 Python 代码
    • 使用方法
    • 优点
    • 缺点
    • 结论
  • IoP（基于 Python 的互操作性）
• 结论

在过去的几个月里，我一直在从事 SMART on FHIR EHR Launch 的工作，使用 CSIRO 的两个开源应用程序：SMART-EHR-Launcher 和 SMART 表单应用程序来测试 IRIS for Health 的功能。这段旅程非常有趣，我非常感谢能有机会参与这项任务并探索 IRIS for Health 的更多潜力。

在 HL7 AU FHIR Connectathon 上成功演示了多个外部 SMART 应用程序的无缝启动后，我很高兴能与社区分享我的心得。我希望我的见解能帮助其他人更快地开始类似的项目。

这项任务涉及使用 SMART-EHR-Launcher 作为 EHR 来启动 SMART 表单应用程序。同时，IRIS for Health 被用作 EHR 的 FHIR 资源库，其 OAuth2 服务器被用作授权服务器。

在进入激动人心的时刻之前，让我们先仔细了解一下 SMART on FHIR 和 SMART on FHIR EHR 启动仪式。让我们问问我们的好朋友 ChatGPT 和 豆包。

什么是 SMART on FHIR?

SMART on FHIR 是一种用于开发医疗保健应用程序的平台，旨在实现医疗保健系统之间的互操作性、安全性和可扩展性。

大家好。

在上一篇文章中，我们了解了如何配置 EMPI 来接收 FHIR 消息。为此，我们安装了 InterSystems 提供的 FHIR 适配器，该适配器配置了一个可以向其发送 FHIR 消息的 REST 端点。然后，我们将获取消息并将其转换为 %String，我们将通过 TCP 将其发送到 HSPIDATA 命名空间中配置的 EMPI 的输出。

好吧，是时候看看我们如何检索消息、将其转换回 %DynamicObject 并将其解析为 EMPI 用来存储信息的类。

TCP消息接收

正如我们所指出的，从配置了 FHIR 资源接收的生产中，我们已将消息发送到我们有业务服务侦听的特定 TCP 端口，在我们的例子中，该业务服务将是一个简单的EnsLib.TCP。 PassthroughService的目标是捕获消息并将其转发到业务流程，我们将在其中执行所需的数据转换。

这里有我们的商业服务：

这是它的基本配置：

FHIR 消息的转变

正如你所看到的，我们只配置了通过 TCP 接收消息的端口以及我们将向其发送消息的组件，在我们的例子中我们将其称为 Local.BP.FHIRProcess，让我们看一下说类来看看我们如何从 FHIR 资源中检索信息：

 Class Local.BP.FHIRProcess Extends Ens.

对于即将到来的Python 竞赛，我想制作一个小型演示，介绍如何使用 Python 创建一个简单的 REST 应用程序，该应用程序将使用 IRIS 作为数据库。使用这个工具

• FastAPI框架，高性能，易学，快速编码，可用于生产
• SQLAlchemy 是 Python SQL 工具包和对象关系映射器，为应用程序开发人员提供 SQL 的全部功能和灵活性
• Alembic 是一个轻量级数据库迁移工具，可与 SQLAlchemy Database Toolkit for Python 一起使用。
• Uvicorn 是 Python 的 ASGI Web 服务器实现。

这是一个使用 IKO 在 k3d 上部署  iris-oauth-fhir  的示例。

*  iris-oauth-fhir 是一个示例，用于部署带有 OAuth2 身份验证功能的 FHIR 服务器，InterSystems IRIS for Health 作为资源服务器，Google OpenId 则作为授权服务器。

* k3d 作为一个轻量级封装器，用于在 docker 中运行 k3s （Rancher Lab 的最小 Kubernetes 发行版）

* IKO 是一个在 Kubernetes 上部署 InterSystems IRIS for Health 的工具。

2. 目录表

• 1. K3D + iris-operator + iris-oauth-fhir
• 2. Table of Contents
  • 2.1. Prerequisites
  • 2.2. Installation
  • 2.2.1. Warning
  • 2.2.2. Build iris-oauth-fhir image
  • 2.2.3. Download k3d
  • 2.2.4. Create a registry
    • 2.2.4.1. add registry to hosts
    • 2.2.4.1.1. mac
    • 2.2.4.1.2. windows

  • 2.3. Start the culster
  • 2.3.1.

在之前的文章中，我们已经了解了如何配置和自定义我们的 EMPI，我们已经了解了如何通过 HL7 消息传递将新患者纳入我们的系统中，但当然，并不是所有的东西都是 HL7 v.2！我们如何配置 EMPI 实例以使用 FHIR 消息传递？

什么是FHIR？

对于那些不太熟悉 FHIR 这个术语的人，只需指出它们是Fast Healthcare Interoperability Resource的首字母缩写即可。 FHIR是HL7制定的医疗保健互操作性标准，基于JSON格式和REST通信，建立了一系列不同类型信息（患者数据、医院中心、诊断、医疗预约......）的“资源”。您可以在他们的官方页面上查看所有这些资源

InterSystems 和 FHIR

从 InterSystems 中，我们了解到 FHIR 为医疗保健互操作性领域提供的实用程序，因此我们拥有广泛的产品和功能，使我们能够充分利用并发挥其全部潜力：

• InterSystems FHIR 服务器允许存储和管理 FHIR 资源。
• InterSystems FHIR SQL Builder使用户可以通过 SQL 查询使用 FHIR 存储库中存储的所有信息。
• InterSystems FHIR 适配器允许在我们的产品中发送和接收 FHIR 消息。

好吧，在我们的文章中，我们将利用适配器提供的功能来接收

在本文中，我将分享我们在 2023 年全球峰会技术交流室中提出的主题。我和@Rochael Ribeiro  

借此机会，我们就以下话题进行探讨：

• 用于快速 API 的开放交换工具
• 开放API规范
• 传统与快速 Api 开发
• 复合 API（互操作性）
• 规范优先或 API 优先方法
• API 治理和监控
• 演示（视频）

用于快速 API 的开放交换工具

当我们谈论快速现代 API 开发（Rest / json）时，我们将使用两个 Intersystems Open Exchange 工具：

第一个是用于快速开发 API 的框架，我们将在本文中详细介绍。

https://openexchange.intersystems.com/package/IRIS-apiPub

第二种是使用 Swagger 作为用户界面，用于 IRIS 平台上开发的 Rest API 的规范和文档，以及它们的使用/执行。其运行的基础是开放 API 规范 (OAS) 标准，如下所述：

https://openexchange.intersystems.com/package/iris-web-swagger-ui

什么是开放 API 规范 (OAS)？

它是全球范围内用于定义、记录和使用 API 的标准。在大多数情况下，API 甚至在实现之前就已经设计好了。我将在下一个主题中详细讨论它。

FHIR 通过提供标准化数据模型来构建医疗保健应用程序并促进不同医疗保健系统之间的数据交换，彻底改变了医疗保健行业。由于 FHIR 标准基于现代 API 驱动的方法，因此移动和 Web 开发人员更容易使用它。然而，与 FHIR API 交互仍然具有挑战性，尤其是在使用自然语言查询数据时。

隆重推出FHIR - AI 和 OpenAPI 链应用程序，该解决方案允许用户使用自然语言查询与 FHIR API 进行交互。该应用程序使用OpenAI 、 LangChain和Streamlit构建，简化了查询 FHIR API 的过程并使其更加用户友好。

FHIR OpenAPI 规范是什么？

OpenAPI 规范（以前称为 Swagger，目前是OpenAPI Initiative的一部分）已成为软件开发领域的重要工具，使开发人员能够更有效地设计、记录 API 并与 API 交互。 OpenAPI 规范定义了一种标准的机器可读格式来描述 RESTful API，提供了一种清晰一致的方式来理解其功能并有效地使用它们。

在医疗保健领域，FHIR 成为数据交换和互操作性的领先标准。为了增强FHIR的互操作能力， HL7正式记录了FHIR OpenAPI规范，使开发人员能够将FHIR资源和操作无缝集成到他们的软件解决方案中。

嗨大家好！

最近我需要使用 IRIS For Health 设置本地 FHIR 服务器，我认为我找到了有史以来最简单的方法！

只需在终端中运行以下两行：

 docker run --rm --name my-iris -d --publish 9091:1972 --publish 9092:52773 intersystemsdc/irishealth-community

和

docker exec -it my-iris iris session iris -U "USER" '##class(%ZPM.PackageManager).Shell("install fhir-server")'

您将在 http://localhost:9092/fhir/r4 本地运行 FHIR 服务器。

就是这么简单！

FHIR 服务器将使用最新版本的 InterSystems IRIS for Health Community Edition，并将通过 FHIRSERVER 命名空间中的 IPM 包从该应用程序部署 FHIR 服务器。

这是针对 Mac OS的，所以请在评论中添加它在 Windows 中的工作方式。

这是一篇非常短的文章，因为使用 InterSystems IRIS for Health 和IPM Package Manager 设置本地 FHIR 服务器真的很容易。

物联网（ IoT ，Internet of things ）即“万物相连的互联网”，是互联网基础上的延伸和扩展的网络，将各种信息传感设备与网络结合起来而形成的一个巨大网络，实现任何时间、任何地点，人、机、物的互联互通 

物联网是新一代信息技术的重要组成部分，IT行业又叫：泛互联，意指物物相连，万物万联。由此，“物联网就是物物相连的互联网”。这有两层意思：第一，物联网的核心和基础仍然是互联网，是在互联网基础上的延伸和扩展的网络；第二，其用户端延伸和扩展到了任何物品与物品之间，进行信息交换和通信。因此，物联网（Internet of Things，简称IoT）是指通过各种信息传感器、射频识别技术、全球定位系统、红外感应器、激光扫描器等各种装置与技术，实时采集任何需要监控、 连接、互动的物体或过程，采集其声、光、热、电、力学、化学、生物、位置等各种需要的信息，通过各类可能的网络接入，实现物与物、物与人的泛在连接，实现对物品和过程的智能化感知、识别和管理。物联网是一个基于互联网、传统电信网等的信息承载体，它让所有能够被独立寻址的普通物理对象形成互联互通的网络在https://baike.baidu.com/item/物联网/7306589?