第九章 ObjectScript - 多维数组

多维数组

在 ObjectScript 中，任何变量都可以是多维数组（也称为数组）。多维数组通常用于保存一组以某种方式相关的值。 ObjectScript 提供的命令和函数可以方便、快速地访问值。

可能会也可能不会直接使用多维数组，具体取决于使用的系统类和自己的偏好。当需要一个用于存储相关值集的容器时，IRIS 提供了一种基于类的替代方案。请参阅集合类。

Basics

多维数组由任意数量的节点组成，由下标定义。以下示例设置数组的几个节点，然后打印数组的内容：

 set myarray(1)="value A"
 set myarray(2)="value B"
 set myarray(3)="value C"
 zwrite myarray

此示例显示了一个典型的数组。

• 该数组有一个下标。在这种情况下，下标是整数 1、2 和 3。
• 不需要提前声明数组的结构。
• myarray 是数组本身的名称。
• ObjectScript 提供可作用于整个数组或特定节点的命令和函数。例如：

 kill myarray

还可以KILL特定节点及其子节点。

第八章 ObjectScript - 变量的可用性和范围

变量的可用性和范围

ObjectScript 支持以下程序流程，（在大多数方面）与其他编程语言支持的程序流程类似：

1. 用户可能从用户界面调用方法。
2. 该方法执行一些语句，然后调用另一个方法。
3. 该方法定义了局部变量 A、B 和 C。

变量 A、B 和 C 在此方法的范围内。它们对于该方法是私有的。

该方法还定义了Global ^D。

4. 第二个方法结束，控制返回到第一个方法。
5. 第一个方法恢复执行。此方法不能使用不再定义的变量 A、B 和 C。它可以使用^D，因为该变量立即保存到数据库中。

变量作用域总结

有几个因素控制变量在定义它的方法之外是否可用。在讨论这些之前，有必要指出以下环境细节：

• IRIS 实例包含多个命名空间，其中包括多个系统命名空间，可能还包括定义的多个命名空间。

命名空间是任何代码运行的环境。

• 可以在命名空间中同时运行多个进程。在典型的应用程序中，许多进程同时运行。

下表总结了可用变量的位置：

第七章 ObjectScript - Variables

Variables

在 ObjectScript 中，有两种变量，按它们保存数据的方式分类：

局部变量可以具有公共或私有范围。

• 局部变量，在内存中保存数据。

局部变量可以具有公共或私有范围。

• Global，在数据库中保存数据。这些也称为全局变量。与Global的所有交互都会立即影响数据库。例如，当设置Global值时，该更改会立即影响存储的内容；没有单独的步骤来存储值。同样，当删除Global时，数据会立即从数据库中删除。

变量名称

变量的命名遵循以下规则：

• 对于大多数局部变量，第一个字符是字母，其余字符是字母或数字。有效名称包括 myvar 和 i
• 对于大多数Global，第一个字符始终是脱字号 (^)。其余字符是字母、数字或句点。有效名称包括 ^myvar 和 ^my.var

IRIS 还支持一种特殊的变量，称为百分比变量；这些不太常见。百分比变量的名称以百分比字符 (%) 开头。百分比变量的特殊之处在于它们始终是公共的；也就是说，它们对进程中的所有代码都是可见的。这包括调用堆栈中的所有方法和所有过程。

定义百分比变量时，请使用以下规则：

• 对于局部百分比变量，名称以 %Z 或 %z 开头。其他名称保留供系统使用。
• 对于global百分比变量，名称以 ^%Z 或 ^%z 开头。其他名称保留供系统使用。

第六章 ObjectScript - Routine示例

Routine示例

下面显示了一个名为 demoroutine 的示例例程，它是用 ObjectScript 编写的。它包含的过程与上一节示例类中所示的方法执行完全相同的操作。

 ; this is demoroutine 
 write "Use one of the following entry points:"
 write !,"random"
 write !,"input"
 write !,"interesting"
 quit 
 
 //this procedure can be called from outside the routine
random() public {
    set rand=$RANDOM(10)+1        ; rand is an integer in the range 1-10
    write "Your random number: "_rand
    set name=$$getnumbername(rand)
    write !

第五章 ObjectScript

方法和例程都可以用 ObjectScript 编写，但大多数现代代码都是使用方法编写的。方法包含在类中，这允许将类似的方法分组在一起，在类参考中自动生成文档，以及使用 IRIS 的面向对象功能。

这并不意味着routines 不重要。许多有用的系统实用程序都是作为例程编写的，并且在编译类时会生成例程。

示例类

下面显示了一个名为 User.DemoClass 的示例类，其中包含用 ObjectScript 编写的方法。此示例使我们有机会了解一些常见的 ObjectScript 命令、运算符和函数，并了解代码在方法内的组织方式。

Class User.DemoClass
{

/// Generate a random number.
/// This method can be called from outside the class.
ClassMethod Random() [ Language = objectscript ]
{
    set rand=$RANDOM(10)+1        ; rand is an integer in the range 1-10
    write "Your random number: "_rand
    set name=.

第四章 IRIS 编程简介 - Macros

Macros

ObjectScript 还支持定义替换的宏。定义可以是一个值、整行代码或（使用 ##continue 指令）多行。使用宏来确保一致性。例如：

#define StringMacro "Hello, World!"

write $$$StringMacro

Include Files

可以在例程中定义宏，并稍后在同一例程中使用它们。更常见的是，在中心位置定义它们。为此，需要创建并使用包含文件。包含文件定义宏并且可以包含其他包含文件。

这些代码元素如何协同工作

可以混合使用 ObjectScript、Python、 SQL、类定义、宏、例程等的原因是 IRIS 不直接使用编写的代码。相反，当编译代码时，系统会生成它使用的较低级别的代码。这是由 ObjectScript 引擎使用的 ObjectScript 的 OBJ 代码，以及由 Python 引擎使用的 Python 的 PYC 代码。

有多个步骤。无需详细了解这些步骤，但最好记住以下几点：

• 对于除 Python 方法之外的所有元素，类编译器将类定义和 ObjectScript 代码处理为 INT 代码。 Python代码被处理成PY代码。

在某些情况下，编译器会生成并保存您不应编辑的其他类。例如，当编译定义 Web 服务和 Web 客户端的类时，就会发生这种情况。

第三章 IRIS 编程简介 - SQL

SQL

IRIS 提供了 SQL 的实现，称为 SQL。可以在方法和例程中使用 SQL。

从 ObjectScript 使用 SQL

可以使用以下一种或两种方式从 ObjectScript 执行 SQL：

• 动态 SQL（ %SQL.Statement和 %SQL.StatementResult 类），如下例所示：

 SET myquery = "SELECT TOP 5 Name, Title FROM Sample.Employee ORDER BY Salary"
 SET tStatement = ##class(%SQL.Statement).%New()
 SET tStatus = tStatement.%Prepare(myquery)
 SET rset = tStatement.%Execute()
 DO rset.%Display()
 WRITE !,"End of data"

可以在 ObjectScript 方法和例程中使用动态 SQL。

• 嵌入式SQL，如下例所示：

 &sql(SELECT COUNT(*) INTO :myvar FROM Sample.

第二章 IRIS 编程简介 - 同时使用类和例程

同时使用类和例程

在 IRIS 中，可以使用例程中的类。例如，下面显示了例程的一部分，其中我们引用了 Sample.Employee 类：

 //get details of random employee and print them
showemployee() public {
    set rand=$RANDOM(10)+1        ; rand is an integer in the range 1-10
    write "Your random number: "_rand
    set employee=##class(Sample.Employee).%OpenId(rand)  
    do employee.PrintEmployee()
    write !,"This employee's salary: "_employee.Salary
      
    }

类似地，方法可以调用例程中的标签。例如，以下代码调用例程employeeutils中的标签ComputeRaise：

Method RaiseSalary() As %Numeric
{
    set newsalary=$$ComputeRaise^employeeutils(.

我们经常收到有关 InterSystems IRIS 数据平台支持的平台和框架列表最近和即将发生的更改的问题。此更新旨在分享最近的变化以及我们对即将发生的变化的当前最佳知识，但预测未来是一件棘手的事情，这不应被视为承诺的路线图。

话虽如此，接下来是更新……

IRIS 生产环境操作系统和 CPU 架构

红帽Linux企业版RHEL

• 近期变动
  
  • RHEL 9.2 和 RHEL 8.8 于 2023 年 5 月发布。红帽计划为这些版本提供 4 年支持。 InterSystems 已通过我们称为“次要操作系统版本认证”的新流程完成了对 RHEL 9.2 和 RHEL 8.8 上的 IRIS 的额外测试，该流程旨在提供额外的安全性，确保次要操作系统更新不会破坏任何明显的功能。 RHEL 8.8 和 9.2 都成功通过了我们的测试。
  • 随着 RHEL 9.2 的发布，红帽终止了对 RHEL 9.1 的公开支持。这与 Red Hat 自 RHEL 8.3 以来一直使用的“奇/偶”支持周期一致。

• 即将发生的变化
  
  • RHEL 9.3 计划于今年晚些时候推出。这将是 Red Hat 的短期支持版本，因此 InterSystems 不会执行次要操作系统认证或推荐将其用于生产部署。

• 之前的更新
  
  • IRIS 2022.1.2 添加了对RHEL 9.0的支持。 9.

第一章 IRIS 编程简介

简介

IRIS 是一个高性能多模型数据平台，具有内置的通用编程语言 ObjectScript，以及对 Python 的内置支持。

IRIS 支持多进程并提供并发控制。每个进程都可以直接、高效地访问数据。

在 IRIS 中，可以根据喜好编写类、例程或它们的组合。在所有情况下，存储的数据最终都包含在称为全局变量的结构中。 IRIS 编程具有以下特点：

• 类和例程可以互换使用。
• 类和例程可以互相调用。
• 类提供面向对象的功能。
• 数据库存储已集成到 ObjectScript 和 Python 中。
• 类可以以简化编程的方式保存数据。如果使用持久类，数据可以同时作为对象、SQL 表和全局变量使用。
• 可以直接从类或例程访问全局变量，这意味着可以灵活地按照想要的方式存储和访问数据。

可以选择适合需求的方法。

Classes

IRIS 支持类。可以使用系统类，也可以定义自己的类。

在 IRIS 中，类可以包含熟悉的类元素，例如属性、方法和参数（在其他类语言中称为常量）。它还可以包含通常不在类中定义的项目，包括触发器、查询和索引。

IRIS 类定义使用类定义语言 (CDL) 来指定类及其成员，例如属性、方法和参数。可以使用 Python 或 ObjectScript 在方法内部编写可执行代码。对于每个方法，使用 Language 关键字指定将使用哪种语言编写该方法，如下例所示。

受到@Evgeny Shvarov 的问题和@Ashok Kumar T 的回复的启发
我已经创建了一个用于把Global下载成 XML 文件的基础

如何使用：
只需调用 http://<your_server>/csp/samples2/dc.Gdown.cls ?GBL=global_name之类的页面
gbl-name 不带首字母 ^（插入符号）
输出具有默认名称 <global_name>.XML 您可以选择。

已知限制：

• 你必须将它安装在你的源服务器上
• 它没有经过测试/跨命名空间工作
• 没有部分下载
• 错误处理只是基本或缺失

个人还有提升空间。
就是这样：

 Class dc.Gdown Extends %CSP.Page { ClassMethod OnPreHTTP() As %Boolean [ ServerOnly = 1 ] { #dim %response as %CSP.Response set %rcc = $Get ( %request.Data ( "GBL" , 1 ), "" ) if %rcc ] "" { set %rcd = $D (@( "^" _ %rcc )) if %rcd { set %response.ContentType = "application/xml" set %response.

第二十四章 参考 - HL7业务服务的设置- 忽略入站 ACK

忽略入站 ACK

如果为 True，业务服务将忽略任何入站 ACK 消息，以避免创建 ACK 反馈循环。

Local Facility Application

以冒号分隔的 LocalFacility:LocalApplication 代码，表示通过此业务服务接收 HL7 消息的设施和应用程序。如果此业务服务创建自己的 ACK，则本地设施应用程序会为 ACK 消息提供 SendingFacility:SendingApplication 代码；否则，该设置将被忽略。

Message Schema Category

应用于传入消息类型以生成完整的 DocType 规范的类别。与文档类型名称 (MSH:9) 结合生成 MessageType 规范，然后使用该规范在给定 HL7 模式类别的 MessageTypes 部分中查找 MessageStructure / DocType。

此设置还可以包含多个以逗号分隔的类型名称，后跟 =，然后是 DocTypeCategory 或完整的 DocType 值，以应用于包含该类型名称的 HL7 消息。给定部分类型名称末尾的尾随星号 (*) 与以该条目开头的任何类型匹配。

HL7 消息对象的 DocType 属性

例如：MessageSchemaCategory='2.3.1, ADT_*=2.

嗨，开发者，

我们很高兴邀请大家参加新的以 Python 为主题的 InterSystems 在线编程竞赛！

🏆 InterSystems Python 编程大赛🏆

时间： 2023年9月4日至24日（美国东部时间）

奖金池： 14,000 美元

第二十三章 参考 - HL7业务服务的设置- DocTypeResolution

DocTypeResolution

指定如何根据 MSH:9 中的消息类型解析 DocType。选择以下选项之一：

• Standard标准 — 将有效消息架构类别值与在相应架构类别中查找 MSH:9 消息类型值的消息结构名称相结合。这是默认设置。
• Ignore 9.3 — 与“标准”类似，但如果 MSH:9 有三个或更多部分，则忽略其他部分。标准行为是使用第 3 部分作为类型名称的一部分（如果它没有子部分），因为某些模式包含三部分类型名称。
• Use 9.3 — 与“标准”类似，但如果 MSH:9 具有三个或更多部分，则使用附加部分作为适用模式类别中文档结构的文字名称。请谨慎使用，因为消息到达时可能带有 MSH:9.3 值，而所选架构类别中不存在其结构。
• Literal 文字 — 将有效消息架构类别值与解释为消息结构名称的文字 MSH:9 消息类型值相结合。仅与每个消息类型都有相应的结构定义的自定义架构一起使用。

Override Segment Terminator

（仅限 FTP）用作段终止符的以逗号分隔的 ASCII 控制字符列表。这些值可以是十进制格式或十六进制格式，前面带有 x。例如，要将换行符指定为段终止符，请输入 10 或 x0A。默认值为回车符，十进制值为 13，十六进制值为 x0D。

第二十二章 参考 - HL7业务服务的设置

提供HL7业务服务设置的参考信息。

HL7最重要的设置如下:

• 池大小-默认值为1，可以支持FIFO(先进先出)处理。在许多情况下，必须按顺序接收多个患者的人口统计更新。例如，许多应用程序在处理订单消息之前需要接收ADT注册消息，在收到结果消息之前必须接收订单消息，等等。
• 类别—此文本标签允许在配置图中对配置项进行排序。
• 追加时间戳-(仅限文件)在存档路径中的文件名追加时间戳。
• 归档路径-(仅限文件和FTP)指定HL7消息归档的位置。
• 呼叫间隔-在寻找更多输入之前等待的秒数。缺省值是5秒。最小值是0.1秒。

Ack Mode

帮助建立发布 HL7 确认消息以响应收到的 HL7 消息的格式和约定。对于业务服务，此设置可以具有下表中显示的值之一。

在提交的 WRC case中(Intersystems 全球技术支持响应中心），我们经常看到客户提出有关新 Web 网关设置的问题，其中管理门户加载一半，但不显示图像。本文将解释为什么会出现此错误，以及如何修复它。本说明主要针对服务 InterSystems IRIS 实例的 Web 网关，但相同的说明也应适用于服务 Caché 实例的 CSP 网关。

问题：

您刚刚在独立的 Web 服务器上安装了 Web Gateway。当你去加载管理门户时，你发现它无法显示或加载图像，如下所示：

为什么会发生这种情况：

问题是，为了完整加载管理门户，InterSystems IRIS 必须加载许多 .js、.css 和 .png 文件（静态文件）。如果您看到像上面这样的管理门户页面，请随时打开浏览器的开发人员工具小程序，导航到“网络”选项卡，并确认未提供各种 .js、.css 和 .png 组件：

最初安装 Web Gateway 时，我们仅为以下扩展设置映射：

.csp .cls .zen .cxw

这些是客户在自己的自定义应用程序中最常使用的文件扩展名类型，以及用于为 Web Gateway 管理门户提供服务的 .cxw 扩展名。如果您想要加载其他管理门户组件，则必须注册其他文件类型以由 Web 网关提供服务。

如何解决该问题：

要使管理门户完全显示，您必须配置 Web 网关以提供其他文件类型。

InterSystems 常见问题解答

※如果您想比较使用Mirror、Shadow或其他机制复制的数据库，请使用此方法。

您可以使用 DATACHECK 实用程序来比较Global。请参阅下面的文档。
DataCheck 概述 [IRIS]

***

Routines比较使用系统例程 %RCMP 或管理门户。

以下是如何在管理门户中使用它。

第十八章 定义 HL7 搜索表

HL7 搜索表类 EnsLib.HL7.SearchTable，自动索引填充的 HL7 属性。

如果需要搜索更多的项，可以创建一个子类。子类继承Identifier属性，以及使搜索表工作的基础结构。具体操作请参见在产品中使用虚拟文档中的“定义搜索表类”。

对于HL7, 支持PropType的附加值。除了在产品中使用虚拟文档中列出的类型之外，还可以使用DateTime:HL7。

创建搜索表时，不要使用保留的包名;参见开发产品中的“保留包名”。

默认索引的属性

当选择EnsLib.HL7。searchtable作为搜索表类，使能够在HL7消息中搜索以下虚拟属性。

• MSHTypeName

消息结构名称。为了创建这个字符串，将HL7消息中的以下值连接起来: - MSH消息头段

字段`9`(消息类型)

子字段`1`(消息类型`:ADT`, `ORM`等)

- 文字字符_
- `MSH`消息头段

字段`9`(消息类型)

子字段`2`(触发事件:`A01、A12、O01_2`等)

结果是一个格式为ADT_A01, ADT_A12, ORM_O01_2等的消息结构名称。

• MSHControlID

此消息的唯一标识号。production程序从:

- `MSH`消息头段
- 字段10(消息控制ID)

将此值解释为区分大小写的字符串。

• PatientID

此消息的患者标识符。

第十六章 定义 HL7 的 DTL 数据转换 - 转换长段字段

转换长段字段

DTL 转换使用的 ObjectScript 方法 GetValueAt 将 HL7 段字段截断为 3.6MB。因此，当转换长度超过 3.6MB 的字段时，无法在 DTL 编辑器中使用从左到右的拖动操作。例如，如果 OBX:5 字段超过 3.6MB，则无法使用 DTL 编辑器将源字段拖动到目标，因为它将被截断。同样，如果要转换的字段长度超过 3.6MB，则自定义代码不应调用 GetValueAt。

要转换长度超过 3.6MB 的字段，需要使用代码操作将自定义代码添加到转换中。此自定义代码必须在的 EnsLib.HL7.Segment 中包含以下方法之一，以将字段的值从源读取到流中：GetFieldStreamRaw()、GetFieldStreamUnescaped() 或 GetFieldStreamBase64()

这些 Get 方法采用 3 个参数：流输出参数、字段的 VDoc 路径和 pRemainder 输出参数。 ``pRemainder` 参数将填充被提取的字段之后的所有字段。例如：

/// Segment:  OBX|1|2|3|4|5|6|7
do GetFieldStreamRaw(.stream, "OBX:5", .

InterSystems 常见问题解答标题

您可以为以下 Web Gateway 错误消息/系统响应设置单独的错误页面：

• 服务器错误
• 服务器繁忙
• 服务器无法使用
• 服务器超时
• 连接关闭

在 Web Gateway 管理界面上进行设置（[Management Portal] > [System Administration] > [Configuration] > [Web Gateway Management] > [Configuration] > [Default Parameters]）。

在“默认参数”（Default Parameters ）菜单的“错误页面”部分中，设置要显示的 html 页面的文件名或发生错误时要重定向到的 URL。

大家好，

与我们一起参加 8 月 31 日上午 10 点（美国东部时间）在线开发者圆桌会议，讨论医疗保健中的生成式 AI 使用案例。
学习医疗保健领域的用例+参考架构，并观看关于大语言模型的Demo演示。我们将像往常一样有时间进行问答和公开讨论。

通过开发者社区Global Masters报名。

演讲者： @Nicholai Mitchko ，InterSystems 解决方案合作伙伴销售工程师经理

背景： Nicholai 在 InterSystems 管理着一支由 10 名解决方案工程师组成的团队，帮助医疗保健公司大规模设计、开发和交付解决方案。在业余时间，Nicholai 致力于大型语言模型的研究，包括开发自己的模型，这些模型出现在Huggingface OpenLLM 排行榜上。

第十四章 配置Production - 定义 HL7 的路由规则集

为 HL7 接口创建路由规则集时，目标是根据源消息中找到的段告诉production如何处理源消息。有时找到哪些片段很重要；有时，在这些细分中找到哪些值很重要。

在普通规则集中，每个规则都会向调用该规则集的业务流程返回一个值。在路由规则集中，规则通常将 HL7 消息定向到目的地，并可能在发送之前转换 HL7 消息。

创建规则集时，不要使用保留的包名称

1. 当使用业务规则向导创建新的 HL7 路由流程时， 会创建一个新的空路由规则集来伴随新的路由流程。其信息表包含以下值：

• Package Name 包名称 - 包含production类的包。例如，如果使用向导将路由进程添加到名为 TestRule.MyTest 的产品中，则关联的路由规则的包名称为：TestRule
• Rule Name规则名称 - 在向导中选择的简单路由规则名称，例如：MyRule

包名称和规则名称的组合在命名空间内唯一标识规则。任何规则定义的全名是由点 (.) 连接的包名称和规则名称，如下所示：TestRule.MyRule

配置 HL7 路由流程时，该全名（而不是规则名称）是 BusinessRuleName 字段中使用的正确值。业务流程向导会自动进行设置。

第十二章 配置Production - 添加HL7序列管理器

添加HL7序列管理器

HL7消息可能由于各种原因而乱序，特别是在多个处理器处理它们时。在某些情况下，需要确保按照正确的顺序处理HL7消息。在这种情况下，可以将HL7序列管理器添加到production的适当部分。

HL7序列管理器是一个业务流程，它接受传入的HL7消息(可能来自多个源)，然后按照消息中的MSH:13 SequenceNumbers字段指定的顺序将消息转发到目标配置项。

序列管理器可以检测重复的消息和消息之间的时间间隔。它还确定顺序消息之间的时间间隔何时大到足以表明问题。它的灵敏度级别可以使用它的配置设置来调整。

要构建用于HL7消息路由生产的HL7序列管理器，必须创建并配置它，然后将其集成到生产中。本主题将解释每个步骤。

重要:HL7序列管理器是HL7兼容的存储转发应用程序，不支持HL7标准第2章2.10.1节中定义的HL7序列号协议。

创建HL7序列管理器

将HL7序列管理器添加到production中:

1. 在Management Portal的“production Configuration”页面(在“Home”页面选择“Interoperability > Configure > production”)中显示production结果。
2. 在Processes列中，单击Add按钮(加号)。

InterSystems IRIS 目前将类限制为 999 个属性。

但是，如果您需要为每个对象存储更多数据该怎么办？

本文将回答这个问题（附加了社区 Python 网关的客串以及如何将广泛的数据集传输到 Python 中）。

答案其实很简单 - InterSystems IRIS 目前将类限制为 999 个属性，但不限制 999 个基元(primitives)。 InterSystems IRIS 中的属性可以是具有 999 个属性的对象等等 - 该限制很容易被忽略。

InterSystems 已纠正了两个缺陷。

第一个缺陷可能导致 ECP 应用程序服务器挂起。此缺陷仅与 ARM 和 IBM Power 处理器相关；存在于 InterSystems IRIS®、InterSystems IRIS for Health™ 和 HealthShare® Health Connect 版本2022.1.2和2022.1.3中。该修复被标识为 DP-423661。该缺陷将在所有未来版本中得到解决。

在极少数情况下，第二个缺陷可能会导致dejournaling挂起。此缺陷存在于 InterSystems IRIS®、InterSystems IRIS for Health™ 和 HealthShare® Health Connect 版本2020.4 、 2021.x 、 2022.x和2023.1中。该修复被标识为 DP-423505。该缺陷将在所有未来版本中得到解决，并已在2023.1.1中得到纠正。

InterSystems 已发布版本2022.1.3的更新发行版，以便快速提供这些修复。相关的版本标识符是：

• 原发布：2022.1.3.668.0
• 更新发布：2022.1.3.670.1

这些修复也可以通过 Ad hoc 分发获得。

如果您对此警报有任何疑问，请联系 全球响应中心。

第十一章 配置Production - 集成和配置 HL7 业务服务

集成和配置 HL7 业务服务

要将新的 HL7 业务服务集成到production中，必须将其与其中继消息的路由流程或业务操作相关联。此外，如果希望业务服务接收非标准消息结构，将需要创建自定义 HL7 架构定义来解析和验证这些消息。去做这个：

1. 完成创建 HL7 业务服务所需的任何目标配置名称或消息架构类别项的说明。这些项目可能是：

• HL7 路由进程（针对路由接口）。请参阅下一节。
• HL7 业务操作（如果设计绕过此接口的路由过程，只是将消息从传入业务服务中继到传出业务操作）。请参阅本章后面的“添加 HL7 业务操作”。
• 自定义 HL7 架构定义，用于解析传入的 HL7 消息。

2. 返回生产配置页面上的图表。选择新的 HL7 业务服务。如果“目标配置名称”和“消息架构类别”字段之前为空，请立即配置它们，然后单击“应用”。
3. 根据需要配置业务服务的其他设置。详细信息请参见“参考”中的“HL7业务服务设置”。

添加 HL7 路由进程

要将 HL7 路由流程添加到production中，必须创建它，将其集成到产品中，并根据需要对其进行配置。以下小节提供了详细信息。

创建 HL7 路由流程

要将 HL7 路由流程添加到production：

1. 在管理门户的生产配置页面中显示生产（从主页选择互操作性 > 配置 > Production）。

vscode通过插件：intersystems Server Manager 连接测试开发环境，配置连接后无法使用

配置参数：

    "intersystems.servers": {

        "local": {

            "webServer": {

                "scheme": "http",

                "host": "127.0.0.1",

                "port": 52773

            },

        "test": {

            "webServer": {

                "scheme": "https",

                "host": "xxx.xxx.xxx.xxx",

                "port": 2443

            },

            "description": "test",

            "username": "_system"

        }

错误信息：

Server Could not be accessed by ‘“_system”

第十章 配置Production

本章介绍如何配置产品以包含 HL7 路由接口。它还描述了如何创建新的 HL7 路由制作。

创建新的 HL7 路由Produtcion

可以创建一个新的HL7路由产品，如下所示:

1. 在Management Portal中，切换到适当的名称空间。

为此，请在标题栏中选择Switch，单击名称空间，然后单击OK。

2. 选择互操作性>列表>产品。
3. 选择New以调用Production Wizard。
4. 输入“Package Name”、“Production Name”和“Description”。
5. 选择HL7 Messaging production类型并选择OK。

starter production有一个接口，其元素为:

• HL7FileService — 一个禁用的HL7文件服务，具有默认设置
• MsgRouter — HL7路由进程，带有空路由规则集
• HL7FileOperation - 一个禁用的HL7文件操作，具有默认设置

在构建HL7路由产品时，需要创建和配置许多这样的接口。可以从启用这些起始元素、复制它们、重命名它们并修改它们以满足需要开始。在构建接口时，经常会出现这样的情况:在配置一个项目时，必须输入尚未创建的另一个项目的名称。明确的命名约定对于避免混淆至关重要。

这是一个使用 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.