前言

  生产环境下我们部署和使用IRiS引擎，往往采用其主备镜像模式，虽然此架构简单但是往往我们需要持续在电脑前点击或者操作1到2小时，如果中间有个环节出现了问题有时我们可能需要部署一天.

  接下来我分享的是IRIS自带的一个功能帮助我们部署---manifest-安装清单。他的主要使用方式是提前通过配置约定好我们期望的安装设置，在安装的过程中由IRIS程序直接执行脚本，简化IRIS集群的部署，减少运维人员的操作步骤，让我们有更多的精力放在实际项目和业务上。

1 简介

  %Installer 实用程序允许您定义描述和配置特定 InterSystems IRIS 配置的安装清单，而不是分步安装过程。为此，我们需要创建一个类，其中包含描述所需配置的 XData 块，使用包含通常在安装期间提供的信息（超级服务器端口、操作系统等）的变量。我们还可以在类中包含一个使用 XData 块生成代码以配置实例的方法。本文提供了安装清单的示例，您可以复制和粘贴这个示例尝试使用。

定义清单后，可以在安装期间、从终端会话或代码调用它。注意：清单必须在 %SYS 命名空间中运行。

2 Manifest的最终成品

此成品展示的是一个一键安装主、备、仲裁的机器命令，此方法的使用可以便捷快速的安装主备环境,其基本每一行都有注释其说明：

iris 是数据平台，更是一种数据库。对于熟悉SQL语句的人来说，会认为“既然是数据库，数据应该就能使用sql语句来查询”。这是对的，但是因为有global这个概念，保存的数据可能在global里面，而没有对应的表，也可能保存在类的参数定义里面。这些数据，不能使用sql直接查询。要查询iris数据库的数据，通常有几种方式：1.直接查询表的数据。2.查询视图。3.调用存储过程(call 命令)。其中要查询“只存于global里面或者类参数里定义的数据”，只有使用存储过程。但是存储过程有个问题，就是程序如果迁移到低版本的cache数据库后，数据类型的定义会有问题，且不再支持使用select的方式，只能使用call。这对于第三方熟悉sql的人员来说很不友好。因此结合global和表的关系，介绍一种我称为“进程表”的表。进程表，指数据只存于该进程中，global的样式为"^||global名“。通常按照默认存储新加一个持久类(对应会生成一个表)，然后手动的把global改成进程global，也就是加上”||“。然后写个方法，把需要查询出来的数据写入进程global。这样就能查询出来 了。调用形式为 SELECT * FROM People WHERE People_GLB()=1。

示例如下：

卫生信息和其它信息化一样，经历了数码化、数字化到当今的数字化转型，卫生信息互操作一直伴随左右。

数码化(digitization)：国内90年代开始，HIS全面铺开，卫生信息进入数码化时代。数码化初期业务集中在HIS上，互操作需求不高，点对点接口可以满足绝大多数需求。

数字化(digitalization)：在2000年之后，各种专科系统、尤其是电子病历的诞生，医保和新农合的实施，要求卫生信息共享交换，以提高流程自动化水平。互操作需求爆发，2007年集成平台开始进入市场，卫生信息化进入数字化时代。

数字化转型(digital transformation)：2014年，国内正式进入移动互联网时代；次年《全国医疗卫生服务体系规划纲要（2015—2020年）》发布，卫生信息化的服务对象（服务于医护技到服务于患者）和业务形态（临床管理到患者服务）都发生了翻天覆地的变化，开始步入数字化转型的时代。它对互操作提出了更高的要求 - 利用互操作，增强全员参与，为卫生服务创造新价值、发展新业务，推动医疗机构持续数字化转型。

可以说，卫生信息互操作在整个的卫生信息产业中愈发重要。

国际卫生信息互操作发展了30年，国内也发展了20年，但卫生信息互操作依然是一个挑战。

知史而明鉴，识古而知今。我们看看国际卫生信息互操作发展的历程，对未来的卫生信息互操作有什么借鉴。

卫生信息互操作标准的要素

What is the reason for this error?
 

一般情况下，我们根据iris的portal向导创建数据库，然后创建命名空间。这个过程比较花时间，如果是已经存在的数据库，还需要再装载。翻阅portal调用的方法后，我整合了这几个方法。把这几个方法拷贝到任意已经存在的命名空间，通过执行CNNS（路径，命名空间），就可以快速创建好命名空间。方法的大概过程是，进入到%sys命名空间，然后依次创建数据库，创建命名空间，创建web应用。创建完成后，回到当前命名空间。

前言

对于第三方接口进行交互的时候，往往需要大量的进行参数合法性校验。以前的方法就是对每个参数进行验证。如下截图：

上图的会存在大量的if else if else..,如果字段很多，那导致一个方法存在大量的验证的代码，那我们考虑是否可以进行统一的验证参数的合法性。

思路

平时建立类的时候我们可以写参数MAXLEN=100，TRUNCATE=1 是否截取等，那找找这些参数的定义地方。如截图：

那我们想要定义自己的参数，该如何定义呢？根据面向对象设计原则之一：

里氏替换原则(Liskov Substitution Principle，LSP)：子类型必须能够替换掉他们的基类型。即，在任何父类可以出现的地方，都可以用子类的实例来赋值给父类型的引用。当一个子类的实例应该能够替换任何其超类的实例时，它们之间才具有是一个 (is-a) 关系

那我们可以自定义数据类型，继承%Library.String，这样子类继续使用父类的参数，还可以自定义自己的参数。此处以字符串为例，其他的数据类型一样的原理。 自定义类型就为String.

实现

1. 自定义数据类型

`

Hi 开发者们，

是时候公布2023  InterSystems Python 编程大赛的获奖者了！

感谢所有提交15 份申请的出色参与者  🔥

 IRIS老是断网是什么原因呢？网络没问题。

根据剑桥词典的解释，令牌化数据是“用令牌（=代表第一个数据的不同数据）替换隐私数据，以防止隐私信息被不被允许做的人看到”（https://dictionary.cambridge.org/pt/dicionario/ingles/tokenize）。如今，一些公司，尤其是金融和医疗保健领域的公司，正在将其数据令牌/代币化作为满足网络安全和数据隐私（GDPR、CCPA、HIPAA 和 LGPD）要求的重要策略。但是，为什么不使用加密呢？保护敏感数据的令牌化过程比数据加密更常用，原因如下：

1. 更好的性能：在密集的操作处理中动态加密和解密数据会提高性能并需要更多的处理器能力。
2. 测试：可以标记生产数据库并复制到测试数据库，并维护适合更真实的单元和功能测试的测试数据。
3. 更好的安全性：如果黑客破解或获得密钥，所有加密数据都将可用，因为加密是一个可逆过程。令牌化过程是不可逆的。如果您需要从令牌化数据中获取原始数据，则需要维护一个安全且独立的数据库来链接到原始数据和令牌化数据。

令牌化架构

[toc]

第三十三章 Objects - OREFs

OREFs

对象类的 %New() 方法创建一个内部内存结构来包含对象的数据，并返回指向该结构的 OREF（对象引用）。 OREF 是 IRIS 中的一种特殊值。应该记住以下几点：

• 在终端中，OREF 的内容取决于所使用的语言：
  • 在 ObjectScript 中，会看到一个由数字、@ 符号和类名称组成的字符串。
  • 在 Python 中，会看到一个包含类名和内存中 18 个字符的唯一位置的字符串。

例如：

TESTNAMESPACE>set myobj=##class(Sample.Person).%New()
 
TESTNAMESPACE>w myobj
3@Sample.Person 

>>> myobj=iris.cls("Sample.Person")._New()
>>> print(myobj)
<iris.Sample.Person object at 0x000001A1E52FFD20>

• 如果没有使用预期的 OREF 或者使用了错误类型的 OREF，IRIS 将返回错误。此错误与 ObjectScript 终端和 Python 终端不同：

第三十一章 Classes - 继承规则

继承规则

与其他基于类的语言一样，可以通过继承组合多个类定义。 类定义可以扩展（或继承）多个其他类。这些类又可以扩展其他类。

请注意，类不能继承 Python 中定义的类（即 .py 文件中包含的类定义），反之亦然。

以下小节提供了中类继承的基本规则。

继承顺序

使用以下继承顺序规则：

1. 默认情况下，如果在多个超类中定义了给定名称的类成员，则子类将从超类列表中最左边的类中获取定义。
2. 如果类定义包含 Inheritance = right，则子类从超类列表中最右侧的类中获取定义。

由于历史原因，大多数类都包含 Inheritance = right。

主要的超类

任何扩展其他类的类都有一个主要超类。

无论类使用哪种继承顺序，主超类都是第一个，从左到右阅读。

对于任何类级编译器关键字，给定类使用其主超类中指定的值。

对于持久化类来说，主超类尤其重要。

最具体的类型类Most-Specific Type Class

尽管一个对象可以是属于多个类extent的实例（例如各种超类的extent），但它始终具有最特定的类型类 (MSTC)。当该对象是该类的实例但不是该类的任何子类的实例时，类是该对象的最具体类型。

重写方法

如今，关于大语言模型、人工智能等的消息不绝于耳。向量数据库是其中的一部分，并且已经有非IRIS的技术实现了向量数据库。

为什么是向量？

• 相似性搜索：向量可以进行高效的相似性搜索，例如在数据集中查找最相似的项目或文档。传统的关系数据库是为精确匹配搜索而设计的，不适合图像或文本相似性搜索等任务。
• 灵活性：向量表示形式用途广泛，可以从各种数据类型派生，例如文本（通过 Word2Vec、BERT 等嵌入）、图像（通过深度学习模型）等。
• 跨模态搜索：向量可以跨不同数据模态进行搜索。例如，给定图像的向量表示，人们可以在多模式数据库中搜索相似的图像或相关文本。

还有许多其他原因。

因此，对于这次 pyhon 竞赛，我决定尝试实现这种支持。不幸的是我没能及时完成它，下面我将解释原因。

增强的密码管理：无缝编辑密码

在不断发展的数字安全领域，强大的密码管理工具已变得不可或缺。我们的密码管理应用程序旨在简化和保护您的在线生活，现在提供了一项增强功能 - 轻松编辑密码的能力。

为什么这个功能会改变游戏规则？

1. 灵活性：生活是动态的，我们的在线帐户也是如此。借助新的编辑密码功能，您可以在需要时灵活地修改已保存的密码。无论您是出于安全考虑想要更改密码还是只是更新密码，此功能都可以让您轻松适应。
2. 简化的体验：编辑密码是无缝且用户友好的。不再需要繁琐的过程或从头开始创建新条目。只需点击几下，您的密码就会更新，从而使您的记录保持井然有序且最新。
3. 增强安全性：我们将安全性放在首位。编辑密码功能可确保使用现有加密密钥对更新后的密码进行加密。这意味着即使修改密码，您的数据仍然受到保护。
4. 个性化：您的密码，您做主。根据需要自定义标题、登录名和密码。此功能使您能够使您的密码管理器真正个性化，适合您独特的偏好和组织风格。

怎么运行的：

• 登录到您的帐户。
• 导航到您要编辑的密码。
• 单击“编辑”图标。
• 修改密码标题、登录名或密码本身。
• 保存您的更改。
• 您更新的密码现已安全存储并可供使用。

保持安全，保持井井有条：

凭借增强的编辑密码功能，我们的密码管理器为您的安全需求提供了更全面的解决方案。确保安全、井井有条并放心地管理您的密码。

下一步是什么：

第三十章 Classes - 方法生成器

方法生成器

方法生成器是类编译器在类编译期间调用的程序。它的输出是该方法的实际运行时实现。方法生成器提供了一种继承方法的方法，可以生成根据继承类或属性的需要定制的高性能、专用代码。在 IRIS 库中，方法生成器广泛用于数据类型和存储类。

Class Queries

类可以包含类查询。类查询定义可由该类使用的 SQL 查询，并指定用作查询容器的类。下面显示了一个示例：

Query QueryName(Parameter As %String) As %SQLQuery
{
SELECT MyProperty, MyOtherProperty FROM MyClass
 WHERE (MyProperty = "Hello" AND MyOtherProperty = :Parameter)
 ORDER BY MyProperty
}

定义类查询以提供预定义的查找以供在应用程序中使用。例如，可以按某些属性（例如按名称）查找实例，或提供满足一组特定条件的实例列表，例如从巴黎到马德里的所有航班。此处显示的示例使用参数，这是提供灵活查询的常用方法。请注意，可以在任何类中定义类查询；不需要在持久类中包含类查询。

扩展数据块 XData Blocks

执行SQL语句查询数据时，提示unexpected status code, unable to process HyperEvent:Gateway timeout（504）

有时，InterSystems 必须重新发布版本以纠正 1-2 个问题。此过程会生成称为“小数点版本”的新套件。

小数点版本与维护或功能版本不同。其目标是快速、像做外科手术地纠正该领域的紧急问题。

如何识别小数点发布

InterSystems 数据平台产品遵循以下发布约定：

<系统间产品> <年份>.<专业>.<维护>.<构建号>.<点>

例如：InterSystems IRIS 2022.1.4.204.1

识别小数点版本很简单：如果产品套件的最后一位数字非零，则您正在使用小数点版本。

我如何知道是否应该更换当前的软件？

每次推出小数点版本时，InterSystems 都会向我们的客户宣布并解释其解决的问题。公告是通过我们的开发者社区 (https://community.intersystems.com/tags/intersystems-official) 和产品警报发布的。

每个公告都会解释该版本解决的问题和相应的修复，并提供有关是否更换套件和容器的说明。因此，请阅读公告，如果您有任何疑问，请联系我们！

注意：如果您没有收到产品警报电子邮件，请访问我们的页面并注册： https: //www.intersystems.com/support/product-alerts-advisories/

第二十八章 Classes - 引用其他类的方法

引用其他类的方法

在方法(或例程)中，使用下面的语法来引用其他类中的方法:

要调用类方法并访问其返回值，请使用如下表达式:

 ##class(Package.Class).MethodName(arguments)

iris.cls("Package.Class").MethodName(arguments)

例如：

 Set x=##class(Util.Utils).GetToday()

x=iris.cls("Util.Utils").GetToday()

也可以调用一个类方法而不访问它的返回值，如下所示:

 Do ##class(Util.Utils).DumpValues()

iris.cls("Util.Utils").DumpValues()

注意:##class不区分大小写。

• 要调用实例方法，创建一个实例，然后在ObjectScript或Python中使用如下表达式来调用该方法并访问其返回值:

instance.MethodName(arguments)

例如：

 Set x=instance.GetName()

x=instance.GetName()

你也可以在不访问返回值的情况下调用实例方法，方法如下:

 Do instance.InsertItem("abc")

instance.InsertItem("abc")

是时候宣布八月份的获奖者了！请欢迎我们出色的Global Masters英雄！

热烈的掌声归于这些开发者以及他们在 8 月份为我们全球开发者社区做出的巨大贡献：

🥇@Sylvain Guilbaud
🥈@Ashok Kumar T   
🥉 @罗伯特·森珀

请在下面了解有关比赛和我们的优秀获奖者的更多信息。

InterSystems 还发布了容器化部署的IRIS。这篇文章旨在演示 InterSystems IRIS 和依赖 IRIS 后端的应用程序如何打包到镜像中并在容器中的其他计算机中运行，以及这样做有多么简单。

容器运行包含所有必需的可执行文件、二进制代码、库和配置文件的镜像。镜像可以从一台机器移动到另一台机器，像 Docker Hub 这样的镜像存储库可以简化这个过程。

我在本演示中使用了 Open Exchange 的应用程序。

演示视频：https://www.loom.com/share/93f9a760b5f54c0a8811b7a212387b9d

IRIS 数据平台社区版的镜像（image)可以在 InterSystems 容器注册表中找到：

https: //containers.intersystems.com/contents

为了在主机中使用 IRIS 的容器化实例，应在运行时拉取它。

为此，Dockerfile 需要具有以下命令，如下所示：

Dockerfile：

Dockerfile

昨天，我在一个客户网站提供从 Studio 迁移到 VS Code 的定制咨询时，就遇到了这种情况。

该站点的服务器已配置为使用delegated authentication，但尚未针对 /api/atelier Web 应用程序设置“delegated”复选框，而 InterSystems ObjectScript 扩展包的成员正是使用该复选框进行连接的。

一旦我们的应用程序设置了其复选框并单击了服务器管理器刷新按钮，就可以在服务器上枚举命名空间。

如题，我根据日志发现并没有snmpext.dat文件

第二十七章 Classes - 引用其他类成员

引用其他类成员

在方法中，使用下面的语法来引用其他类成员:

• 要引用ObjectScript中的参数，使用如下表达式:

 ..#PARAMETERNAME

只能使用ObjectScript直接访问参数。要从Python访问参数，请使用ObjectScript包装器方法返回参数，并在需要时调用此方法。例如:

InterSystems 团队本周末将前往麻省理工学院最大的黑客马拉松，届时我们将为黑客们带来一项技术挑战。
我们为黑客们提供在他们的项目中使用 IntegratedML 或 InterSystems Supply Chain Orchestrator 的机会，以便争夺一些非常酷的奖品！

如果您在波士顿并且有兴趣成为活动中的 InterSystems 导师，请给我们写信。

我们最近发布了 IRIS 2023.2版本。 此版本从此类“HS.HC.Util.Installer”中删除了“InstallFoundation”。 这是一个没有记录在官方文档中的私有的方法，但它被社区广泛用来安装 FHIR 服务器。 所以如果你遇到这个错误：<METHOD DOES NOT EXIST> *InstallFoundation,HS.HC.Util.Installer 在构建我们自己的 FHIR 服务器的演示时，您可以通过替换此行来修复它： 把do ##class(HS.HC.Util.Installer).InstallFoundation (namespace) 替换成 Do ##class(HS.Util.Installer.Foundation).Install(namespace) `

第二十六章 Classes - Methods

Methods

方法有两种：实例方法和类方法（在其他语言中称为静态方法）。

指定方法关键字

在方法定义中，可以包含影响方法行为的可选编译器关键字。以下列表显示了一些最常见的方法关键字：

Language

在 IRIS 中，可以用 ObjectScript 或 Python 编写方法。要指定编写方法所用的语言，请使用以下语法：

Method MyMethod() [ Language = objectscript ]
{
    // implementation details written in ObjectScript
}

Method MyMethod() [ Language = python ]
{
    # implementation details written in Python
}

如果方法不使用 Language 关键字，编译器将默认该方法是用 ObjectScript 编写的。

必须以全部小写字母编写方法的语言，如示例中所示。

Private

该关键字指定该方法是私有的，并且只能与 ObjectScript 方法一起使用。子类继承 Private 关键字的值并且不能覆盖它。

默认情况下，方法是公共的并且可以在任何地方访问。可以将方法标记为私有（通过 Private 关键字）。如果你这样做：

第二十五章 Classes - 基于数据类型的属性

基于数据类型的属性

当定义属性并将其类型指定为数据类型类时，可以使用特殊选项来定义和使用该属性，如本节中所述。

数据类型类

数据类型类使能够强制执行有关属性值的规则集。

IRIS 提供的数据类型类包括 %Library.String、 %Library.Integer、 %Library.Numeric、%Library.Date等等。因为 %Library 包的类名可以缩写，所以可以缩写其中的许多类；例如， %Date 是 %Library.Date的缩写。

每个数据类型类都具有以下特征：

• 它指定编译器关键字的值。对于属性，编译器关键字可以执行以下操作：

  • 使属性成为必需的
  • 指定属性的初始值
  • 控制如何将属性映射到 SQL、ODBC 和 Java 客户端

• 它指定影响细节的参数值，如下所示：

  • 数据类型允许的最大和最小逻辑值
  • 字符串可以包含的最大和最小字符数
  • 小数点后的位数
  • 如果字符串超过最大字符数是否截断
  • 显示格式
  • 如何转义任何特殊的 XML 或 HTML 字符
  • 可在任何用户界面中使用的逻辑值和显示值的枚举列表
  • 字符串必须匹配的模式（自动使用模式匹配运算符）
  • 导入或导出到 XML 时是否尊重或忽略 UTC 时区

• 它提供了一组方法来在存储（磁盘上）、逻辑（内存中）和显示格式之间转换文字数据。

InterSystems 很高兴地宣布InterSystems Supply Chain Orchestrator™的核心组件，即 InterSystems IRIS for Supply Chain 2023.1 版，现已正式发布 (GA)。

InterSystems Supply Chain Orchestrator （InterSystems 供应链协调器）基于 InterSystems IRIS® 构建，InterSystems IRIS® 是我们完整的云优先数据平台，支持智能数据编织（smart data fabric）架构，使构建和部署连接数据和应用程序孤岛的高性能、支持机器学习的应用程序变得更加容易。它将 InterSystems IRIS 的强大功能与供应链特定的加速器和框架结合在一起，为供应链编排、需求感知和预测、履行以及快速消费品重新包装提供优化的解决方案。

InterSystems Supply Chain Orchestrator 的一个关键组件是 InterSystems IRIS for Supply Chain，它使 InterSystems IRIS 提供的智能数据编织（smart data fabric）架构更接近供应链用例，并有助于加速实现价值。

*：需要 InterSystems IRIS 高级服务器

第二十四章 Classes - 指定属性关键字

指定属性关键字

在属性定义中，可以包含影响属性使用方式的可选属性关键字。以下列表显示了一些最常见的关键字：

Required

指定可以将此类实例之前设置的属性值存储到磁盘。默认情况下，属性不是必需的。在子类中，可以将可选属性标记为必需，但不能执行相反的操作。

InitialExpression

指定属性的初始值。默认情况下，属性没有初始值。子类继承InitialExpression关键字的值并且可以覆盖它。指定的值必须是有效的 ObjectScript 表达式。

Transient

指定该属性不存储在数据库中。默认情况下，属性不是瞬态的。子类继承 Transient 关键字的值并且不能覆盖它。

Private

指定该属性是私有的。子类继承 Private 关键字的值并且不能覆盖它。

默认情况下，属性是公共的并且可以在任何地方访问。可以将属性标记为私有（通过 Private 关键字）。如果是这样，则只能通过其所属对象的方法来访问它

在 IRIS 中，私有属性始终是继承的，并且对定义该属性的类的子类可见。

在其他编程语言中，这些通常称为受保护的属性。

Calculated

指定在实例化包含该属性的对象时，没有为其分配内存存储。默认情况下，不计算属性。子类继承了Calculated关键字并且不能重写它。

MultiDimensional

第二十三章 Classes - 属性

形式上 IRIS 有两种属性：

• 属性，保存值。该值可以是以下任意值：

  • 单个文字值，通常基于数据类型。
  • 对象值（包括集合对象和流对象）。
  • 多维数组。这种情况不太常见。

  属性一词通常仅指作为properties的attributes，而不是指具有关联的属性。

• 关系，保持对象之间的关联。

可以在包含 ObjectScript 方法、Python 方法或两者组合的类中定义属性。但是，无法从 Python 方法访问关系。本节展示了一个示例类，其中包含显示以下一些变体的属性定义：

第二十二章 Classes - 调用类方法的快捷方式

调用类方法的快捷方式

使用 ObjectScript 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 引用是在一个类内，并且被引用的类在同一个包或子包中。
• 引用位于类内，并且该类使用 IMPORT 指令导入包含引用的类的包或子包。
• 该引用位于方法内，并且该方法使用 IMPORT 指令导入包含引用的类的包或子包。

从 ObjectScript 或 Python 调用类方法时，在以下情况下可以省略包（或更高级别的包）：

• 指的是 %Library 包中的一个类，该类是经过特殊处理的。可以将类 %Library.ClassName 引用为 %ClassName。例如，可以将 %Library.String引用为 %String。
• 指的是 User 包中的一个类，该类是经过特殊处理的。例如，可以将 User.MyClass 引用为 MyClass。

在 User 包中不提供任何类，这些类是保留给使用的。

在所有其他情况下，必须始终使用完整的包和类名称来调用类方法。

类参数

类参数定义一个对于给定类的所有对象都相同的值。除了极少数例外，该值是在编译类时确定的，并且不能在运行时更改。将类参数用于以下目的：