搜索​​​​

本文档将帮助您使用 InterSystems IRIS®数据平台集成产品转换数据。 要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些， 请参见 InterSystems First Looks（《InterSystems 技术概要》）。 数据转换和互操作性 数据转换是 InterSystems IRIS 互操作性的核心。您可以改变从一个系统传入的数据的格式和内容，以满足下游系统的要求，从而允许系统之间进行通信。简单地说，从一个系统发送的信息可以转换为另一个应用程序可以理解的信息。使用 InterSystems IRIS，可以很容易地进行数据转换的创建、测试和维护。 假设您有两个包含产品价格的零售系统。当系统 A 向其他系统发送数据时，包含了不加税的产品基准价格。但是，系统 B 需要在价格中包含地区税。InterSystems IRIS 互操作性产品中的数据转换可以在将数据发送到系统 B 之前将从系统 A 收到的价格转换为加税价格。一旦定义，数据转换将自动处理修改。 常见的转换包括： 将值（value）从源信息复制到目标信息。 根据源信息的（value）执行计算，并将结果复制到目标信息。 为目标信息分配新的值（literal value）。 重新排列数据的顺序。 探索 DTL 编辑器 您可以编写 DTL（数据转换语言）代码来创建数据转换，也可以使用 DTL 编辑器（DTL Editor）来创建。DTL 编辑器（DTL Editor）允许非技术用户无需编写代码就可以创建数据转换。例如，它的图形用户界面允许您通过拖放操作快速地将值从源信息映射到目标信息。下面的 DTL 编辑器（DTL Editor）之旅将通过在产品中创建数据转换来指导您了解其主要功能。有关 InterSystems IRIS 产品的介绍，请参见 First Look：Connecting Systems Using Interoperability Productions（《技术概要：使用互操作性产品连接系统》）。 在这个演示中，必须转换班级里学生的期末成绩数据，以便不同的应用程序可以使用这些数据。 想试试 InterSystems IRIS 互操作性功能的在线视频演示吗？请查看 Interoperability QuickStart（互操作性快速入门）! 用前须知 在开始使用 DTL 编辑器（DTL Editor）之前，您需要完成以下工作： 选择一个 InterSystems IRIS 实例。 从 GitHub 下载 InterSystems IRIS 产品和示例文件。 创建一个支持互操作性的命名空间。 将下载的产品导入命名空间. 选择 InterSystems IRIS 实例 要使用该程序，您需要一个正在运行的 InterSystems IRIS 实例。您的选择包括多种类型的已授权的和免费的评估实例；该实例不需要由您正在工作的系统托管（尽管它们必须相互具有网络访问权限）。有关如何部署每种类型的实例的信息（如果您还没有可使用的实例） 请参见 InterSystems IRIS Basics: Connecting an IDE（InterSystems IRIS 基础：连接一个 IDE）中的 Deploying InterSystems IRIS（部署 InterSystems IRIS）。 从 GitHub 下载 从 https://github.com/intersystems/FirstLook-Data- Transformations 中下载本演示所使用的产品和数据文件。XML 文件是即将部署在系统上的 InterSystems IRIS 产品的载体，您可以通过XML文件导入或导出Production代码。 实例必须可以访问技术概要-数据转换（FirstLook-DataTransformations） 源。下载文件的程序取决于您所使用的实例类型，如下所示： 如果您使用的是 ICM 部署的实例： 使用带有-machine 和 -interactive 选项的 icm ssh 命令，在托管实例的节点上打开默认 shell，例如： icm ssh -machine MYIRIS-AM-TEST-0004 -interactive 在 Linux 命令行上，使用以下命令之一将 repo 克隆到实例的数据存储卷（data storage volume）。例如，对于部署在 Azure 上的配置，数据卷的默认挂载点（default mount point）是 /dev/sdd，因此您可以使用如下命令： $ git clone https://github.com/intersystems/FirstLook-DataTransformations /dev/sdd/FirstLook-DataTransformations OR $ wget -qO- https://github.com/intersystems/FirstLook-DataTransformations/archive/master.tar.gz | tar xvz -C /dev/sdd 这些文件现在对容器文件系统上 /irissys/data/FirstLook-DataTransformations 中的 InterSystems IRIS 可用。 如果您正在使用通过其他方式部署的容器化实例（授权版或社区版[Community Edition]）： 在主机上打开 Linux 命令行。(如果您在云节点上使用社区版[Community Edition]），请使用 SSH 连接该节点，如在 Deploy and Explore InterSystems IRIS[《部署和探索 InterSystems IRIS》] 中所述。) 在 Linux 命令行上，使用 git clone 或 wget 命令，如上所述，将 repo 克隆到容器中挂载为卷的存储位置。 - 对于社区版（Community Edition）实例，您可以克隆到实例的持久化 %SYS 目录 （存储特定于实例的配置数据的目录）。在 Linux 文件系统中，这个目录是 /opt/ISC/dur。这使得文件对容器文件系统上 /ISC/dur/FirstLook-DataTransformations 中的 InterSystems IRIS 可用。 - 对于已授权的容器化实例，选择容器中作为卷挂载的任何存储位置（如果使用它，包括持久化 %SYS 目录）。例如，如果您的 docker run 命令包含选项 -v /home/user1:/external， 并且您将 repo 克隆到 /home/user1，则文件对容器文件系统上 /external/FirstLook-DataTransformations 中的 InterSystems IRIS 可用。 如果您使用的是 InterSystems 学习实验室（Learning Labs）实例： 在集成 IDE 中打开命令行终端。 将目录更改为 /home/project/shared 并使用 git clone 命令克隆 repo： $ git clone https://github.com/intersystems/FirstLook-DataTransformations 该文件夹被添加到左边资源管理器（Explorer）面板的 Shared （共享）下，并且该目录对 /home/project/shared 中的 InterSystems IRIS 可用。 如果您使用的是已安装的实例： 如果实例的主机是安装了 GitHub 桌面（GitHub Desktop）和 GitHub 大文件存储（GitHub Large File Storage）的 Windows 系统： 在主机的 web 浏览器中进入 https://github.com/intersystems/FirstLook-DataTransformations。 选择 Clone or download（克隆或下载） 然后选择 Open in Desktop（在桌面上打开）。 这些文件对您的 GitHub 目录中的 InterSystems IRIS 可用，例如在 C:\Users\User1\Documents\GitHub\FirstLook-DataTransformations 中。 如果主机是 Linux 系统, 只需在 Linux 命令行上使用 git clone 命令或 wget 命令将 repo 克隆到您所选择的位置。 创建一个支持互操作性的命名空间 在导入从 GitHub 下载的产品之前，您必须创建一个支持互操作性的命名空间。如果您已经在实例上创建了一个支持互操作性的命名空间，您可以将它用于此产品。要创建一个新的支持互操作性的命名空间，请使用以下过程。(您首次安装 InterSystems IRIS 时创建的命名空间不支持互操作性)。 使用 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中URL described for your instance（实例适用的URL），在浏览器中打开您的实例的管理门户（Management Portal）。 选择 System Administration（系统管理） > Configuration（配置） > System Configuration（系统配置） > Namespaces（命名空间），进入 Namespaces（命名空间） 页面。 在 Namespaces （命名空间） 页面，选择 Create New Namespace（创建新的命名空间）。这将显示 New Namespace（新命名空间）页面； 按照 System Administration Guide（《系统管理指南》）中“Configuring InterSystems IRIS（配置 InterSystems IRIS）”章节中 “Create/Modify a Namespace（创建/修改命名空间）”该页的说明 , 确保选中了 Enable namespace for interoperability productions（为命名空间启用互操作性Production） 复选框。 选择靠近页面顶部的 Save（保存） ，然后在生成的日志末尾选择 Close（关闭）。 导入演示产品 要导入包含数据转换的演示Production，请使用此程序： 在管理门户（Management Portal）中，选择 Interoperability（互操作性） > Manage（管理） > Deployment Changes（部署变更） > Deploy（部署），进入 Deploy Production Changes（部署Production变更） 页面。 如果出现提示，请选择在完成此步骤之前创建的命名空间。 点击 Open Deployment（打开部署）。 进入您从 GitHub 下载文件的目录，选择 DTLStudentDemo.xml，然后点击 OK（确定）。 点击 Deploy（部署）。 点击 OK（確定）。 创建数据转换 InterSystems IRIS 提供了一个数据转换向导（Data Transformation Wizard），以加速和简化创建新数据转换的过程。在本演示中，您将创建一个数据转换，该数据转换连接与班级学生成绩相关的两个记录映射。要创建数据转换： 从管理门户（Management Portal）主页，选择 Interoperability（互操作性） > List（列表） > Data Transformations（数据转换）。 点击 New（新建）。数据转换向导（Data Transformation Wizard）打开。 在 Package（包）下拉列表中选择 Demo（演示）。 在 Name（名称） 字段中，输入一个独特的名称，如 DTLDemoTransform。 点击 Source Class（源类） 字段旁边的放大镜。 点击 Message Classes（信息类） > Demo（演示） > Complex Map（复杂映射） > StudentWCD > Record（记录）。 点击 Target Class（目标类） 字段旁边的放大镜。 点击 Message Classes（信息类） > Demo（演示） > Complex Map（复杂映射） > StudentPFFixed > Record（记录）。 点击 OK（确定）。新的数据转换会在 DTL 编辑器（DTL Editor）中打开。 转换数据 现在您已经创建了数据转换，使用 DTL编辑器（DTL Editor）： 将数据从源（source）复制到目标（target），根据需要重新排列数据的顺序。 在课程编号的开头添加学院专用代码。 将最终成绩四舍五入为整数。 使用期末成绩来确定学生是通过还是不通过，并在目标文件中指出这个结果。 忽略目标中不需要的源数据。 复制数据 DTL 编辑器（DTL Editor）最强大、最省时的功能之一是能够将值从源（source）拖放到目标（target）的相应属性。您只需点击并按住源属性上的圆圈，并将其拖动到目标信息的属性。 要将值从源（source）复制到目标（target）： 点击并按住源（source）的 ClassID 属性的圆圈（在编辑器[Editor]的左侧）。 将光标拖动到目标（target）的 ClassID 属性，直到它被高亮显示，然后释放鼠标按钮。 源（source）的 ClassID 的值将被复制到目标（target）的 ClassID 属性。 按照此程序，将下列源属性连接到相应的目标属性： 学生 ID（StudentID） 成绩（Grade） 姓氏（LastName） 名字（FirstName） 中间名（MiddleName） 编辑器（Editor）现在应该是这样的： 请注意，仅仅通过连接属性对（property pairs），您便已经更改了存储数据的顺序。 修改属性（Property）的值 在某些情况下，您希望在将源属性（source property）复制到相应的目标属性（target property）之前更改其值。在这个演示中，目标系统接受一个 ClassID，这个 ClassID 以两个字符的标识符开头，表示源（Source）的学院。源的信息不包括这个标识符，因此数据转换必须在将 ClassID 的值复制到目标信息之前修改它。 点击，连接源的 ClassID 属性和目标的 ClassID 属性的线上的圆圈。 请注意，编辑器（Editor）右侧的 Action（操作） 标签现在显示了连接两个 ClassID 属性时创建的 Assign 操作的信息。Property（属性） 字段被设置为 target.ClassID，Value（值）字段被设置为 source.ClassID。 将 Action（操作） 标签的 Value（值） 字段变更为： "UC."_source.ClassID。UC 是学院的标识符，它使用下划线添加到 ClassID 的开头，下划线是 InterSystems ObjectScript 编程语言中的连接操作符。这超出了本演示的范围，但它让您了解如何在转换中包含 ObjectScript 代码。 使用函数 在设置属性值时，您可以使用内置函数。在本演示中，使用 Round() 函数将最终成绩四舍五入为整数。 选择源的成绩（Grade）属性和目标的成绩（Grade）属性之间的连接器。 点击 Action（操作） 标签的 Value（值） 字段旁边的放大镜。 从 Function (函数) 下拉列表中选择 Round ( )。 点击 OK（确定定）。 将 Action（操作） 标签的 Value（值） 字段设置为：..Round(source.Grade) 使用操作表 请注意，当您将源属性（source property）映射到目标属性（target property）时，DTL 编辑器（DTL Editor）将 Set（设置）操作添加到图表下方的表格中。 虽然 DTL 编辑器（DTL Editor） 的图形化部分使可视化和快速执行操作变得容易，但有时使用图表下方的表格来进一步定义转换会更好。例如，在本演示中， 在源属性和目标属性之间单击图形连接是选择 Set（设置）操作的最快方法。然而，在更复杂的转换中，可能很难选择连接器。在这种情况下，从图表下方的表格中选择 Set（设置）操作会更容易些。 定义有条件的操作集 在转换数据时，只有在某些条件为真时，才能使用条件语句执行操作。在本演示中，您定义了一个转换，如果期末成绩大于或等于 65 分，则表示学生通过了该课程。要添加 If 语句来完成此操作： 确保最后一项是高亮显示的表格。If 语句位于高亮显示的操作之后。 从 Add Action（添加操作） 下拉列表中选择 If。 请注意，图表下方的表格中添加了一个 If 块。 在表格中选择 If 语句后， 在 Action（操作） 标签上定义 Condition（条件）字段为: target.Grade>=65。只有当目标的成绩（Grade） 属性值大于或等于 65 时，才会执行放在 If 块内的操作。 从 Add Action（添加操作）下拉列表中选择 Set（设置）。 在 Action（操作） 标签上，定义 Property（属性） 字段为：target.Pass。 定义 Value（值） 字段为 1。这是一个布尔值（boolean value），表示该学生通过了这门课程。 选择表格中的 else（其他） 操作。 从 Add Action（添加操作）下拉列表中选择 Set（设置）。 在 Action（操作） 标签上，定义 Property（属性） 字段为：target.Pass。 在 Action（操作） 标签上，定义 Value（值） 字段为 0。这是一个布尔值（boolean value），表示该学生没有通过这门课程。 if 块现在应该是这样的： 忽略来自源信息（Source Message）的数据 在演示中，请注意 Email、Phone 和 Phone1 属性没有连接到目标信息。不需要进一步的操作来防止源信息中的这些数据被复制到目标信息。 编译数据转换 您可以选择随时保存工作，但必须始终记住编译数据转换。在您点击 Compile（编译）之前，产品无法识别更改。 进行初步测试 DTL 编辑器（DTL Editor）使您能够快速测试数据转换，而不必在整个生产过程中运行信息。您只需输入测试信息，DTL 编辑器（DTL Editor）就会显示输出信息的样子。在本演示的这一点上，您将记录映射数据的 XML 表示（XML representation）粘贴到测试转换（Test Transform）工具中。 稍后，您将通过在产品中运行文本文件来测试这个转换。 记住在测试数据转换之前要编译它。 点击编辑器右侧的 Tools（工具） 标签。 点击 Test（测试）。 将以下数据复制并粘贴到 Input Message（输入信息）文本框中： <test> <Record> <ClassID>CS241</ClassID> <StudentID>930698</StudentID> <Grade>77.8</Grade> <LastName>Sutherland</LastName> <FirstName>David</FirstName> <MiddleName>Timothy</MiddleName> <Email>david.sutherland@mail.com</Email> <Phone>978-343-3940</Phone> <Phone1>978-343-0951</Phone1> </Record> </test> 点击 Test（测试）。 Output Message（输出信息）文本框现在应该是这样的： <Record> <StudentID>930698</StudentID> <ClassID>UC.CS241</ClassID> <Grade>78</Grade> <Pass>true</Pass> <FirstName>David</FirstName> <MiddleName>Timothy</MiddleName> <LastName>Sutherland</LastName> </Record> 提示： 在处理 HL7 或其他 EDI 信息时，您可以从示例信息中复制和粘贴原始文本来测试转换。您不需要信息的 XML 表示（XML representation）。 向产品添加转换 现在您已经创建并编译了数据转换，必须将其添加到产品中，以便将流经产品的源信息转换为发送到下游应用程序的信息。在本演示中，您将向与业务流程 DTLDemoRouter 关联的业务规则添加转换。 从管理门户（Management Portal）主页，进入 Interoperability（互操作性） > List（列表） > Productions（产品）。 选择 Demo.ComplexMap.SemesterProduction 并点击 Open（打开）。 选择 Processes（进程）下的 DTLDemoRouter。 在 Settings（设置）标签上，点击 Business Rule Name（业务规则名称）字段旁边的放大镜。 双击位于业务规则 send（发送）操作中的 transform（转换）形状。 在 Data Transform Selector（数据转换选择器） 对话框中，选择您为这个演示创建的数据转换。 点击 OK（確定）。 在业务规则编辑器（Business Rule Editor）中，点击 Save（保存）。 有关业务规则的更多信息，请参见 Developing Business Rules（《开发业务规则》）。 测试数据转换 现在您已经将数据转换添加到产品中，运行产品以查看您的演示如何运行。在这一步骤中： 创建产品接收和发送示例文件的目录。 启动产品。 将示例输入文件复制到正确的目录中。 比较目标文件和源文件的内容。 创建所需的目录 演示产品被定义为在实例的主机 c:\practice\in 中查找包含源数据的文件，并将目标文件编写到 c:\practice\out 中。如果您不能在主机的 c:\ drive 上创建目录，或者它不是 Windows 系统，您必须识别或创建替代目录，然后在继续之前修改产品的业务服务和业务操作。业务服务的 File Path（文件路径）设置定义了产品查找输入文件的位置，而业务操作的 File Path（文件路径）设置定义了发送目标文件的位置。 创建目录的方式这取决于使用的实例类型 ，如下所示： 对于由 ICM 部署的实例，可以使用带有 -machine 和 -interactive 选项的 icm exec 命令，在运行实例的容器中打开 bash shell，例如： icm exec -command bash -machine MYIRIS-AM-TEST-0004 -interactive 然后您可以在容器文件系统上创建目录。 对于任何容器化的实例, 无论是授权版还是社区版（Community Edition）, 使用命令 docker exec -it container_name bash 在容器中打开 bash shell (社区版[Community Edition]容器的名称是 try-iris)。然后在容器文件系统上创建目录。 对于 InterSystems 学习实验室（Learning Labs），使用集成 IDE 中的命令行终端，在共享（Shared）文件夹中创建新文件夹；您可以在 /home/project/shared 下的管理门户（Management Portal）中浏览到这些。 对于已安装的实例，在本地文件系统上创建目录。 本练习的其余部分假设目录路径为 c:\practice\in 和 c:\practice\out；如果不同，请替换为正确的路径。 启动产品 要启动包含演示数据转换的产品： 从管理门户（Management Portal）主页，进入 Interoperability（互操作性） > List（列表） > Productions（产品）。 选择 Demo.ComplexMap.SemesterProduction 并点击 Open（打开）。 点击 Start（开始）。 复制 .CSV 文件到目录 产品被定义为接受一个 .CSV 文件，其中包含来自 c:\practice\in 的学生信息。将 input.csv 文件从包含 GitHub 文件的目录复制到输入目录，或者 c:\practice\in ，或者您创建并指定的其他目录。 只要产品在运行，该文件就应该在几秒钟内从目录中消失，这表明产品已经开始成功地处理该文件。 验证输出数据 演示产品使用复制到产品的输入目录中的 .Csv 文件，并使用数据转换将数据转换为具有新内容的不同格式。这个传出文件被复制到产品的输出目录中，要么是 c:\practice\out ，要么是您创建并指定的另一个目录，文件名为时间戳。 打开 input.csv 和输出文件并比较两者。 其他重要功能 本演示提供了开发和测试数据转换的基础知识。其他重要的、常用的功能包括： for each 语句遍历一个集合，对集合的每个成员执行相同的操作序列。这个集合可以是一个数组，在 HL7 或其他 EDI 信息的情况下，也可以是一个重复段。更多信息，请参见 Adding a For Each Action（添加 For Each 操作）。 子转换，它允许您模块化数据转换。数据转换可以使用子转换操作在操作流的任何点上运行另一个转换。您可以创建可重用转换的库， 这些库可以从其他转换调用，从而避免重复转换逻辑。例如，您可以针对HL7 V2消息中的段创建段转换，只要这些段出现在 EDI 信息中就可以重复使用。 支持 X12 和 EDIFACT 标准。当使用数据转换向导创建新的转换时，您可以指定信息类型是 X12 还是 EDIFACT。这允许您选择使用正确的模式填充 DTL 编辑器（DTL Editor）的文档类型。这些模式段的可视化表示在 DTL 编辑器（DTL Editor）中展开和折叠。 了解有关数据转换的更多信息 有关数据转换的更多细节，请参见： Developing DTL Transformations（《开发 DTL 转换》） Advanced Data Transformations（高级数据转换） (在线课程) Business Process and Data Transformation Language Reference（《业务流程和数据转换语言参考》）

Hi 亲爱的社区开发者们，福利来了！ 在Global Masters，我们为 Expert, Ambassador and VIP levels（专家级、大使级和VIP级）的用户提供了更多奖励！ Apple AirPods 希望你们喜欢新奖品！ 此外，你可以在奖励列表中看到"解锁获奖" 项目，根据提示完成相应目标后，便可解锁并申请奖品。 社区奖励兑换近期更新啦，有帽子，Amzon Echo Dot 等众多新礼品，欢迎大家多赚积分多兑换！！！更多更新还在路上，敬请期待！ 关于Global Masters: 如何加入InterSystems Global Masters倡导中心？ Global Masters等级及徽章说明（英文） 如果您还没有加入InterSystems Global Masters倡导中心 , 现在就加入吧！ 如果您有任何疑问，欢迎跟帖回复！ 👍👍 努力攒积分中 问问题，回答问题，发表文章，看帖子，做小测试。。。都可以获得点数，欢迎大家踊跃参与完成挑战！ 详情请访问：https://globalmasters.intersystems.com/challenges

html {overflow-x: initial !important;}:root { --bg-color: #ffffff; --text-color: #333333; --select-text-bg-color: #B5D6FC; --select-text-font-color: auto; --monospace: "Lucida Console",Consolas,"Courier",monospace; --title-bar-height: 20px; } .mac-os-11 { --title-bar-height: 28px; } html { font-size: 14px; background-color: var(--bg-color); color: var(--text-color); font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; -webkit-font-smoothing: antialiased; } body { margin: 0px; padding: 0px; height: auto; inset: 0px; font-size: 1rem; line-height: 1.42857143; overflow-x: hidden; background-image: inherit; background-size: inherit; background-attachment: inherit; background-origin: inherit; background-clip: inherit; background-color: inherit; tab-size: 4; background-position: inherit; background-repeat: inherit; } iframe { margin: auto; } a.url { word-break: break-all; } a:active, a:hover { outline: 0px; } .in-text-selection, ::selection { text-shadow: none; background: var(--select-text-bg-color); color: var(--select-text-font-color); } #write { margin: 0px auto; height: auto; width: inherit; word-break: normal; word-wrap: break-word; position: relative; white-space: normal; overflow-x: visible; padding-top: 36px; } #write.first-line-indent p { text-indent: 2em; } #write.first-line-indent li p, #write.first-line-indent p * { text-indent: 0px; } #write.first-line-indent li { margin-left: 2em; } .for-image #write { padding-left: 8px; padding-right: 8px; } body.typora-export { padding-left: 30px; padding-right: 30px; } .typora-export .footnote-line, .typora-export li, .typora-export p { white-space: pre-wrap; } .typora-export .task-list-item input { pointer-events: none; } @media screen and (max-width: 500px) { body.typora-export { padding-left: 0px; padding-right: 0px; } #write { padding-left: 20px; padding-right: 20px; } .CodeMirror-sizer { margin-left: 0px !important; } .CodeMirror-gutters { display: none !important; } } #write li > figure:last-child { margin-bottom: 0.5rem; } #write ol, #write ul { position: relative; } img { max-width: 100%; vertical-align: middle; image-orientation: from-image; } button, input, select, textarea { color: inherit; font-family: inherit; font-size: inherit; font-style: inherit; font-variant-caps: inherit; font-weight: inherit; font-stretch: inherit; line-height: inherit; } input[type="checkbox"], input[type="radio"] { line-height: normal; padding: 0px; } *, ::after, ::before { box-sizing: border-box; } #write h1, #write h2, #write h3, #write h4, #write h5, #write h6, #write p, #write pre { width: inherit; } #write h1, #write h2, #write h3, #write h4, #write h5, #write h6, #write p { position: relative; } p { line-height: inherit; } h1, h2, h3, h4, h5, h6 { break-after: avoid-page; break-inside: avoid; orphans: 4; } p { orphans: 4; } h1 { font-size: 2rem; } h2 { font-size: 1.8rem; } h3 { font-size: 1.6rem; } h4 { font-size: 1.4rem; } h5 { font-size: 1.2rem; } h6 { font-size: 1rem; } .md-math-block, .md-rawblock, h1, h2, h3, h4, h5, h6, p { margin-top: 1rem; margin-bottom: 1rem; } .hidden { display: none; } .md-blockmeta { color: rgb(204, 204, 204); font-weight: 700; font-style: italic; } a { cursor: pointer; } sup.md-footnote { padding: 2px 4px; background-color: rgba(238, 238, 238, 0.7); color: rgb(85, 85, 85); border-top-left-radius: 4px; border-top-right-radius: 4px; border-bottom-right-radius: 4px; border-bottom-left-radius: 4px; cursor: pointer; } sup.md-footnote a, sup.md-footnote a:hover { color: inherit; text-transform: inherit; text-decoration: inherit; } #write input[type="checkbox"] { cursor: pointer; width: inherit; height: inherit; } figure { overflow-x: auto; margin: 1.2em 0px; max-width: calc(100% + 16px); padding: 0px; } figure > table { margin: 0px; } tr { break-inside: avoid; break-after: auto; } thead { display: table-header-group; } table { border-collapse: collapse; border-spacing: 0px; width: 100%; overflow: auto; break-inside: auto; text-align: left; } table.md-table td { min-width: 32px; } .CodeMirror-gutters { border-right-width: 0px; background-color: inherit; } .CodeMirror-linenumber { } .CodeMirror { text-align: left; } .CodeMirror-placeholder { opacity: 0.3; } .CodeMirror pre { padding: 0px 4px; } .CodeMirror-lines { padding: 0px; } div.hr:focus { cursor: none; } #write pre { white-space: pre-wrap; } #write.fences-no-line-wrapping pre { white-space: pre; } #write pre.ty-contain-cm { white-space: normal; } .CodeMirror-gutters { margin-right: 4px; } .md-fences { font-size: 0.9rem; display: block; break-inside: avoid; text-align: left; overflow: visible; white-space: pre; background-image: inherit; background-size: inherit; background-attachment: inherit; background-origin: inherit; background-clip: inherit; background-color: inherit; position: relative !important; background-position: inherit; background-repeat: inherit; } .md-fences-adv-panel { width: 100%; margin-top: 10px; text-align: center; padding-top: 0px; padding-bottom: 8px; overflow-x: auto; } #write .md-fences.mock-cm { white-space: pre-wrap; } .md-fences.md-fences-with-lineno { padding-left: 0px; } #write.fences-no-line-wrapping .md-fences.mock-cm { white-space: pre; overflow-x: auto; } .md-fences.mock-cm.md-fences-with-lineno { padding-left: 8px; } .CodeMirror-line, twitterwidget { break-inside: avoid; } .footnotes { opacity: 0.8; font-size: 0.9rem; margin-top: 1em; margin-bottom: 1em; } .footnotes + .footnotes { margin-top: 0px; } .md-reset { margin: 0px; padding: 0px; border: 0px; outline: 0px; vertical-align: top; text-decoration: none; text-shadow: none; float: none; position: static; width: auto; height: auto; white-space: nowrap; cursor: inherit; line-height: normal; font-weight: 400; text-align: left; box-sizing: content-box; direction: ltr; background-position: 0px 0px; } li div { padding-top: 0px; } blockquote { margin: 1rem 0px; } li .mathjax-block, li p { margin: 0.5rem 0px; } li blockquote { margin: 1rem 0px; } li { margin: 0px; position: relative; } blockquote > :last-child { margin-bottom: 0px; } blockquote > :first-child, li > :first-child { margin-top: 0px; } .footnotes-area { color: rgb(136, 136, 136); margin-top: 0.714rem; padding-bottom: 0.143rem; white-space: normal; } #write .footnote-line { white-space: pre-wrap; } @media print { body, html { border: 1px solid transparent; height: 99%; break-after: avoid; break-before: avoid; font-variant-ligatures: no-common-ligatures; } #write { margin-top: 0px; padding-top: 0px; border-color: transparent !important; } .typora-export * { -webkit-print-color-adjust: exact; } .typora-export #write { break-after: avoid; } .typora-export #write::after { height: 0px; } .is-mac table { break-inside: avoid; } .typora-export-show-outline .typora-export-sidebar { display: none; } } .footnote-line { margin-top: 0.714em; font-size: 0.7em; } a img, img a { cursor: pointer; } pre.md-meta-block { font-size: 0.8rem; min-height: 0.8rem; white-space: pre-wrap; background-color: rgb(204, 204, 204); display: block; overflow-x: hidden; } p > .md-image:only-child:not(.md-img-error) img, p > img:only-child { display: block; margin: auto; } #write.first-line-indent p > .md-image:only-child:not(.md-img-error) img { left: -2em; position: relative; } p > .md-image:only-child { display: inline-block; width: 100%; } #write .MathJax_Display { margin: 0.8em 0px 0px; } .md-math-block { width: 100%; } .md-math-block:not(:empty)::after { display: none; } .MathJax_ref { fill: currentcolor; } [contenteditable="true"]:active, [contenteditable="true"]:focus, [contenteditable="false"]:active, [contenteditable="false"]:focus { outline: 0px; box-shadow: none; } .md-task-list-item { position: relative; list-style-type: none; } .task-list-item.md-task-list-item { padding-left: 0px; } .md-task-list-item > input { position: absolute; top: 0px; left: 0px; margin-left: -1.2em; margin-top: calc(1em - 10px); border: none; } .math { font-size: 1rem; } .md-toc { min-height: 3.58rem; position: relative; font-size: 0.9rem; border-top-left-radius: 10px; border-top-right-radius: 10px; border-bottom-right-radius: 10px; border-bottom-left-radius: 10px; } .md-toc-content { position: relative; margin-left: 0px; } .md-toc-content::after, .md-toc::after { display: none; } .md-toc-item { display: block; color: rgb(65, 131, 196); } .md-toc-item a { text-decoration: none; } .md-toc-inner:hover { text-decoration: underline; } .md-toc-inner { display: inline-block; cursor: pointer; } .md-toc-h1 .md-toc-inner { margin-left: 0px; font-weight: 700; } .md-toc-h2 .md-toc-inner { margin-left: 2em; } .md-toc-h3 .md-toc-inner { margin-left: 4em; } .md-toc-h4 .md-toc-inner { margin-left: 6em; } .md-toc-h5 .md-toc-inner { margin-left: 8em; } .md-toc-h6 .md-toc-inner { margin-left: 10em; } @media screen and (max-width: 48em) { .md-toc-h3 .md-toc-inner { margin-left: 3.5em; } .md-toc-h4 .md-toc-inner { margin-left: 5em; } .md-toc-h5 .md-toc-inner { margin-left: 6.5em; } .md-toc-h6 .md-toc-inner { margin-left: 8em; } } a.md-toc-inner { font-size: inherit; font-style: inherit; font-weight: inherit; line-height: inherit; } .footnote-line a:not(.reversefootnote) { color: inherit; } .md-attr { display: none; } .md-fn-count::after { content: "."; } code, pre, samp, tt { font-family: var(--monospace); } kbd { margin: 0px 0.1em; padding: 0.1em 0.6em; font-size: 0.8em; color: rgb(36, 39, 41); background-color: rgb(255, 255, 255); border: 1px solid rgb(173, 179, 185); border-top-left-radius: 3px; border-top-right-radius: 3px; border-bottom-right-radius: 3px; border-bottom-left-radius: 3px; box-shadow: rgba(12, 13, 14, 0.2) 0px 1px 0px, rgb(255, 255, 255) 0px 0px 0px 2px inset; white-space: nowrap; vertical-align: middle; } .md-comment { color: rgb(162, 127, 3); opacity: 0.8; font-family: var(--monospace); } code { text-align: left; } a.md-print-anchor { white-space: pre !important; border: none !important; display: inline-block !important; position: absolute !important; width: 1px !important; right: 0px !important; outline: 0px !important; text-shadow: initial !important; background-position: 0px 0px !important; } .os-windows.monocolor-emoji .md-emoji { font-family: "Segoe UI Symbol", sans-serif; } .md-diagram-panel > svg { max-width: 100%; } [lang="flow"] svg, [lang="mermaid"] svg { max-width: 100%; height: auto; } [lang="mermaid"] .node text { font-size: 1rem; } table tr th { border-bottom-width: 0px; } video { max-width: 100%; display: block; margin: 0px auto; } iframe { max-width: 100%; width: 100%; border: none; } .highlight td, .highlight tr { border: 0px; } mark { background-color: rgb(255, 255, 0); color: rgb(0, 0, 0); } .md-html-inline .md-plain, .md-html-inline strong, mark .md-inline-math, mark strong { color: inherit; } .md-expand mark .md-meta { opacity: 0.3 !important; } mark .md-meta { color: rgb(0, 0, 0); } @media print { .typora-export h1, .typora-export h2, .typora-export h3, .typora-export h4, .typora-export h5, .typora-export h6 { break-inside: avoid; } } .md-diagram-panel .messageText { stroke: none !important; } .md-diagram-panel .start-state { fill: var(--node-fill); } .md-diagram-panel .edgeLabel rect { opacity: 1 !important; } .md-require-zoom-fix { height: auto; margin-top: 16px; margin-bottom: 16px; } .md-require-zoom-fix foreignObject { font-size: var(--mermaid-font-zoom); } .md-fences.md-fences-math { font-size: 1em; } .md-fences-advanced:not(.md-focus) { padding: 0px; white-space: nowrap; border: 0px; } .md-fences-advanced:not(.md-focus) { background-image: inherit; background-size: inherit; background-attachment: inherit; background-origin: inherit; background-clip: inherit; background-color: inherit; background-position: inherit; background-repeat: inherit; } .typora-export-show-outline .typora-export-content { max-width: 1440px; margin: auto; display: flex; flex-direction: row; } .typora-export-sidebar { width: 300px; font-size: 0.8rem; margin-top: 80px; margin-right: 18px; } .typora-export-show-outline #write { --webkit-flex: 2; flex: 2 1 0%; } .typora-export-sidebar .outline-content { position: fixed; top: 0px; max-height: 100%; overflow: hidden auto; padding-bottom: 30px; padding-top: 60px; width: 300px; } @media screen and (max-width: 1024px) { .typora-export-sidebar, .typora-export-sidebar .outline-content { width: 240px; } } @media screen and (max-width: 800px) { .typora-export-sidebar { display: none; } } .outline-content li, .outline-content ul { margin-left: 0px; margin-right: 0px; padding-left: 0px; padding-right: 0px; list-style: none; } .outline-content ul { margin-top: 0px; margin-bottom: 0px; } .outline-content strong { font-weight: 400; } .outline-expander { width: 1rem; height: 1.428571429rem; position: relative; display: table-cell; vertical-align: middle; cursor: pointer; padding-left: 4px; } .outline-expander::before { content: ''; position: relative; font-family: Ionicons; display: inline-block; font-size: 8px; vertical-align: middle; } .outline-item { padding-top: 3px; padding-bottom: 3px; cursor: pointer; } .outline-expander:hover::before { content: ''; } .outline-h1 > .outline-item { padding-left: 0px; } .outline-h2 > .outline-item { padding-left: 1em; } .outline-h3 > .outline-item { padding-left: 2em; } .outline-h4 > .outline-item { padding-left: 3em; } .outline-h5 > .outline-item { padding-left: 4em; } .outline-h6 > .outline-item { padding-left: 5em; } .outline-label { cursor: pointer; display: table-cell; vertical-align: middle; text-decoration: none; color: inherit; } .outline-label:hover { text-decoration: underline; } .outline-item:hover { border-color: rgb(245, 245, 245); background-color: var(--item-hover-bg-color); } .outline-item:hover { margin-left: -28px; margin-right: -28px; border-left-width: 28px; border-left-style: solid; border-left-color: transparent; border-right-width: 28px; border-right-style: solid; border-right-color: transparent; } .outline-item-single .outline-expander::before, .outline-item-single .outline-expander:hover::before { display: none; } .outline-item-open > .outline-item > .outline-expander::before { content: ''; } .outline-children { display: none; } .info-panel-tab-wrapper { display: none; } .outline-item-open > .outline-children { display: block; } .typora-export .outline-item { padding-top: 1px; padding-bottom: 1px; } .typora-export .outline-item:hover { margin-right: -8px; border-right-width: 8px; border-right-style: solid; border-right-color: transparent; } .typora-export .outline-expander::before { content: "+"; font-family: inherit; top: -1px; } .typora-export .outline-expander:hover::before, .typora-export .outline-item-open > .outline-item > .outline-expander::before { content: '−'; } .typora-export-collapse-outline .outline-children { display: none; } .typora-export-collapse-outline .outline-item-open > .outline-children, .typora-export-no-collapse-outline .outline-children { display: block; } .typora-export-no-collapse-outline .outline-expander::before { content: "" !important; } .typora-export-show-outline .outline-item-active > .outline-item .outline-label { font-weight: 700; } .md-inline-math-container mjx-container { zoom: 0.95; } :root { --side-bar-bg-color: #fafafa; --control-text-color: #777; } @include-when-export url(https://fonts.loli.net/css?family=Open+Sans:400italic,700italic,700,400&subset=latin,latin-ext); /* open-sans-regular - latin-ext_latin */ /* open-sans-italic - latin-ext_latin */ /* open-sans-700 - latin-ext_latin */ /* open-sans-700italic - latin-ext_latin */ html { font-size: 16px; -webkit-font-smoothing: antialiased; } body { font-family: "Open Sans","Clear Sans", "Helvetica Neue", Helvetica, Arial, 'Segoe UI Emoji', sans-serif; color: rgb(51, 51, 51); line-height: 1.6; } #write { max-width: 860px; margin: 0 auto; padding: 30px; padding-bottom: 100px; } @media only screen and (min-width: 1400px) { #write { max-width: 1024px; } } @media only screen and (min-width: 1800px) { #write { max-width: 1200px; } } #write > ul:first-child, #write > ol:first-child{ margin-top: 30px; } a { color: #4183C4; } h1, h2, h3, h4, h5, h6 { position: relative; margin-top: 1rem; margin-bottom: 1rem; font-weight: bold; line-height: 1.4; cursor: text; } h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor { text-decoration: none; } h1 tt, h1 code { font-size: inherit; } h2 tt, h2 code { font-size: inherit; } h3 tt, h3 code { font-size: inherit; } h4 tt, h4 code { font-size: inherit; } h5 tt, h5 code { font-size: inherit; } h6 tt, h6 code { font-size: inherit; } h1 { font-size: 2.25em; line-height: 1.2; border-bottom: 1px solid #eee; } h2 { font-size: 1.75em; line-height: 1.225; border-bottom: 1px solid #eee; } /*@media print { .typora-export h1, .typora-export h2 { border-bottom: none; padding-bottom: initial; } .typora-export h1::after, .typora-export h2::after { content: ""; display: block; height: 100px; margin-top: -96px; border-top: 1px solid #eee; } }*/ h3 { font-size: 1.5em; line-height: 1.43; } h4 { font-size: 1.25em; } h5 { font-size: 1em; } h6 { font-size: 1em; color: #777; } p, blockquote, ul, ol, dl, table{ margin: 0.8em 0; } li>ol, li>ul { margin: 0 0; } hr { height: 2px; padding: 0; margin: 16px 0; background-color: #e7e7e7; border: 0 none; overflow: hidden; box-sizing: content-box; } li p.first { display: inline-block; } ul, ol { padding-left: 30px; } ul:first-child, ol:first-child { margin-top: 0; } ul:last-child, ol:last-child { margin-bottom: 0; } blockquote { border-left: 4px solid #dfe2e5; padding: 0 15px; color: #777777; } blockquote blockquote { padding-right: 0; } table { padding: 0; word-break: initial; } table tr { border: 1px solid #dfe2e5; margin: 0; padding: 0; } table tr:nth-child(2n), thead { background-color: #f8f8f8; } table th { font-weight: bold; border: 1px solid #dfe2e5; border-bottom: 0; margin: 0; padding: 6px 13px; } table td { border: 1px solid #dfe2e5; margin: 0; padding: 6px 13px; } table th:first-child, table td:first-child { margin-top: 0; } table th:last-child, table td:last-child { margin-bottom: 0; } .CodeMirror-lines { padding-left: 4px; } .code-tooltip { box-shadow: 0 1px 1px 0 rgba(0,28,36,.3); border-top: 1px solid #eef2f2; } .md-fences, code, tt { border: 1px solid #e7eaed; background-color: #f8f8f8; border-radius: 3px; padding: 0; padding: 2px 4px 0px 4px; font-size: 0.9em; } code { background-color: #f3f4f4; padding: 0 2px 0 2px; } .md-fences { margin-bottom: 15px; margin-top: 15px; padding-top: 8px; padding-bottom: 6px; } .md-task-list-item > input { margin-left: -1.3em; } @media print { html { font-size: 13px; } table, pre { page-break-inside: avoid; } pre { word-wrap: break-word; } } .md-fences { background-color: #f8f8f8; } #write pre.md-meta-block { padding: 1rem; font-size: 85%; line-height: 1.45; background-color: #f7f7f7; border: 0; border-radius: 3px; color: #777777; margin-top: 0 !important; } .mathjax-block>.code-tooltip { bottom: .375rem; } .md-mathjax-midline { background: #fafafa; } #write>h3.md-focus:before{ left: -1.5625rem; top: .375rem; } #write>h4.md-focus:before{ left: -1.5625rem; top: .285714286rem; } #write>h5.md-focus:before{ left: -1.5625rem; top: .285714286rem; } #write>h6.md-focus:before{ left: -1.5625rem; top: .285714286rem; } .md-image>.md-meta { /*border: 1px solid #ddd;*/ border-radius: 3px; padding: 2px 0px 0px 4px; font-size: 0.9em; color: inherit; } .md-tag { color: #a7a7a7; opacity: 1; } .md-toc { margin-top:20px; padding-bottom:20px; } .sidebar-tabs { border-bottom: none; } #typora-quick-open { border: 1px solid #ddd; background-color: #f8f8f8; } #typora-quick-open-item { background-color: #FAFAFA; border-color: #FEFEFE #e5e5e5 #e5e5e5 #eee; border-style: solid; border-width: 1px; } /** focus mode */ .on-focus-mode blockquote { border-left-color: rgba(85, 85, 85, 0.12); } header, .context-menu, .megamenu-content, footer{ font-family: "Segoe UI", "Arial", sans-serif; } .file-node-content:hover .file-node-icon, .file-node-content:hover .file-node-open-state{ visibility: visible; } .mac-seamless-mode #typora-sidebar { background-color: #fafafa; background-color: var(--side-bar-bg-color); } .md-lang { color: #b4654d; } /*.html-for-mac { --item-hover-bg-color: #E6F0FE; }*/ #md-notification .btn { border: 0; } .dropdown-menu .divider { border-color: #e5e5e5; opacity: 0.4; } .ty-preferences .window-content { background-color: #fafafa; } .ty-preferences .nav-group-item.active { color: white; background: #999; } .menu-item-container a.menu-style-btn { background-color: #f5f8fa; background-image: linear-gradient( 180deg , hsla(0, 0%, 100%, 0.8), hsla(0, 0%, 100%, 0)); } :root {--mermaid-font-zoom:1em ;} @media print { @page {margin: 0 0 0 0;} body.typora-export {padding-left: 0; padding-right: 0;} #write {padding:0;}} 目录 技术概要： Globals 1 什么是 Globals？ 1 为什么要学习 Globals？ 1 试一试： 访问 Globals 的三种方式 2 用前须知 2 导入和检查类定义 2 导入示例数据并检查 Globals 3 关系访问 Globals（Accessing Globals Relationaly） 5 将 Globals 作为对象访问（Accessing Globals as Objects） 6 直接访问 Globals（Accessing Globals Directly） 7 有关 Globals 的更多信息 8 使用 InterSystems IRIS API 访问 Globals 9 了解有关 Globals 的更多信息 10 Globals 及其结构 10 多模型开发 10 InterSystems Native API 10 技术概要: Globals 本文档向您介绍了 globals 的概念，globals是 InterSystems IRIS®数据平台的底层存储结构。我们将向您展示如何使用关系模型和对象模型访问 globals，以及如何直接访问 globals。 要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些 ，请参见 InterSystems First Looks（《InterSystems 技术概要》）。 什么是 Globals？ InterSystems IRIS 数据平台的特点之一是它能够一次性存储数据，并允许您使用多个范式（paradigm）来访问它。例如，您可以使用 InterSystems SQL 将数据可视化为行和列，或者您可以使用 ObjectScript 将数据视为具有属性和方法的对象。您的应用程序甚至可以混合使用这两种数据模型，对于给定的任务使用最简单和更有效的模型。但是无论您如何访问数据，InterSystems IRIS 都将其存储在被称为 globals 的底层数据结构中。 Globals 可以被认为是持久化多维稀疏数组（persistent multidimensional sparse arrays）： 持久化（Persistent）------Globals 存储在数据库中，可以在任何时候被任何可以访问该数据库的进程（process）检索到。 多维（Multidimensional）------global 节点可以有任意数量的下标。这些下标可以是整数、小数，或字符串。 稀疏（Sparse）------节点下标不必是连续的，这意味着没有存储值的下标不会使用任何存储。 Global 节点可以存储多种类型的数据，包括： 字符串 数字数据 字符或二进制数据流 数据集合，如列表或数组 对其他存储位置的引用 即使是您编写的服务器端代码，最终也存储在 globals 中! 为什么要学习 Globals？ 在了解很少或几乎不了解 globals 的情况下，虽然也可以在 InterSystems IRIS 平台上编写应用程序，但出于以下几个原因，您可能想了解有关它们的更多信息： 如果您直接访问 globals，有些操作可能会更容易或更有效。 您可能希望为不符合关系或对象数据模型的数据创建自定义数据结构。 试一试: 访问 Globals 的三种方式 有些系统管理任务是在 global 层面完成的，了解 globals 将使这些任务对您更有意义。 试一试：访问 Globals 的三种方式 在本文档中，您将检查用于存储 U.S. 州类对象的数据的 globals。该类的属性包括州名、双字母邮政缩写、首府、建州年份和面积（单位：平方英里）。然后，您将使用关系和对象技术，以及直接操作 globals 来访问和存储这个类的对象。 用前须知 要使用这个技术概要（First Look），您需要一个正在运行的 InterSystems IRIS 实例。您的选择包括几种类型的已授权的和免费的评估实例；该实例不需要由您正在工作的系统托管（尽管您的系统必须能够通过网络访问该实例）。关于如何部署每种类型的实例的信息（如果您还没有可使用的实例），请参见 InterSystems IRIS Basics: Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中的 Deploying InterSystems IRIS（部署 InterSystems IRIS）。 您也需要知道： 实例的基于 web 的管理门户（Management Portal）的 URL，这是 InterSystems IRIS 的系统管理用户界面。 如何访问终端（Terminal），InterSystems IRIS 命令行工具。 实例的用户名和密码（InterSystems Labs 上的 web 实例不需要）。 您还需要从 InterSystems GitHub repo ：https://github.com/intersystems/First- Look-Globals 下载两个示例文件。 FirstLookGlobals.xml 包含 State 类的类定义。 FirstLookGlobals.gof 包含了 U.S. 最初 13 个州的一些 global 示例数据。 关于如何访问管理门户（Management Portal ）或终端（Terminal）的更多信息，请参见 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中的"InterSystems IRIS Connection Information（InterSystems IRIS 连接信息）"。您实际上并不需要一个 IDE 来做这些练习。 导入和检查类（Class）定义 首先，将 State 类定义导入 InterSystems IRIS： 从管理门户（Management Portal）的主页，选择 System Explorer（系统资源管理器） > Classes（类）。 在 Classes 页面上，查看左栏，确保您在 USER 命名空间。您可以把命名空间看作是工作空间或目录。 点击 Import（导入）。 在 Import Classes 的对话框中： a. 如果您的 InterSystems IRIS 实例在远程服务器上运行，请指定是将示例文件下载到远程服务器还是下载到您的本地计算机。 b. 在 File 或 Directory 的 Import（导入）区域，点击 File（文件）。 c. 浏览您从 GitHub 下载的 FirstLookGlobals.xml 文件。 试一试: 访问 Globals 的三种方式 d. 选择 Compile Imported Items（编译导入项）。 e. 对于 Compile Flags（编译标志），指定 cuk。 f. 点击 Next（下一步）。 g. 点击 Import（导入）。 h. 当出现加载成功的消息时，点击 Done（完成）。 现在，在 Classes 页面，您应该看到 FirstLook.State.cls 在类的列表中。在 InterSystems IRIS 中，包含类的包名称（FirstLook）附加有类的名称（State）。扩展名 .cls 用来表示类文件。 注意： 如果您的命名空间包含大量的类，可以在页面左栏的 Class Name（类名） 框中输入 F*.cls 来过滤列表。 在 FirstLook.State.cls 类的右侧，点击 Documentation（文档） 来查看为该类生成的文档。 您会注意到的第一件事是 FirstLook.State 类扩展了 %Persistent 类，这意味着该类的数据将存储在数据库中 (系统定义的类和方法通常以 % 开头) 。 persistent class FirstLook.State extends %Persistent 扩展 %Persistent 还提供了一些方法，您可以使用这些方法在该类上执行操作。例如，它允许您创建该类的新对象或从数据库访问对象并将其加载到内存中。 再往下看，您可以看到这个类有五个属性：Area、Capital、Established、Name 和 PostalAbbr。 property Area as %Integer; property Capital as %String; property Established as %Integer; property Name as %String [ Required ]; property PostalAbbr as %String; 这个类还有两个索引，CapitalIndex 和 PostalAbbrIndex，这两个索引可以加快 SQL 查询的速度，并允许您通过首府和邮政缩写快速查找州。 index (CapitalIndex on Capital) [Unique]; index (PostalAbbrIndex on PostalAbbr) [Unique]; 导入示例数据并检查 Globals 要了解存储 State 类对象的 globals，首先要导入一些数据： 从管理门户（Management Portal）的主页，选择 System Explorer（系统资源管理器） > Globals。(或从 Classes 页面，点击 Globals 按钮。) 在 Globals 页面上，查看左栏，确保您在 USER 命名空间。 点击 Import（导入）。 在 Import Globals 对话框中： a. 如果您的 InterSystems IRIS 实例在远程服务器上运行，请指定是将示例文件下载到远程服务器还是下载到您的本地计算机。 b. 浏览您从 GitHub 下载的 FirstLookGlobals.gof 文件。 c. 点击 Next（下一步）。 d. 点击 Import（导入）。 试一试: 访问 Globals 的三种方式 e. 当出现加载成功的消息时，点击 Done（完成）。 现在，在 Globals 页面上，您应该看到 FirstLook.StateD 和 FirstLook.StateI 这两个 globals 在列表中。默认情况下，类（class）的数据存储在名称后面加 Dappended 的 global 中，索引存储在名称后面加 Iappended 的 global 中。最常见的情况是，您会看到 globals 名称前有一个插入符号（\^）。 注意： 如果您的命名空间包含大量的 globals，可以在页面左栏的 Global Name（Global 名称） 框中输入 F* 来过滤这个列表。 在 FirstLook.StateD global 的右边，点击 View（查看） 来显示 global 内容的列表。 \^FirstLook.StateD = 13 \^FirstLook.StateD(1) = $lb("","Delaware","DE","Dover",1787,2489) \^FirstLook.StateD(2) = $lb("","Pennsylvania","PA","Harrisburg",1787,46054) \^FirstLook.StateD(3) = $lb("","New Jersey","NJ","Trenton",1787,8723) \^FirstLook.StateD(4) = $lb("","Georgia","GA","Atlanta",1788,59425) \^FirstLook.StateD(5) = $lb("","Connecticut","CT","Hartford",1788,5543) \^FirstLook.StateD(6) = $lb("","Massachusetts","MA","Boston",1788,10554) \^FirstLook.StateD(7) = $lb("","Maryland","MD","Annapolis",1788,12406) \^FirstLook.StateD(8) = $lb("","South Carolina","SC","Columbia",1788,32020) \^FirstLook.StateD(9) = $lb("","New Hampshire","NH","Concord",1788,9349) \^FirstLook.StateD(10) = $lb("","Virginia","VA","Richmond",1788,42775) \^FirstLook.StateD(11) = $lb("","New York","NY","Albany",1788,54555) \^FirstLook.StateD(12) = $lb("","North Carolina","NC","Raleigh",1789,53819) \^FirstLook.StateD(13) = $lb("","Rhode Island","RI","Providence",1790,1545) 您可以看到，每个状态的节点都有一个整数的下标，称为对象 ID（或简称 ID），它是在您存储这个类的新对象时由系统生成的。Global 的根节点，没有下标，包含一个计数器，该计数器递增以生成下一个 ID。 每个节点的数据按照在类定义中指定的顺序存储为属性列表。如果查看 \^FirstLook.StateD(3)，您可以看到州名是新泽西州（New Jersey），邮政缩写是 NJ，首府是特伦顿（Trenton），该州于 1787 年加入联邦（Union），面积为 8723 平方英里。 点击 Cancel（取消） 返回 globals 列表，然后点击 global FirstLook.StateI 旁边的 View（查看） 查看 State 类的索引。 \^FirstLook.StateI("CapitalIndex"," ALBANY",11) = "" \^FirstLook.StateI("CapitalIndex"," ANNAPOLIS",7) = "" \^FirstLook.StateI("CapitalIndex"," ATLANTA",4) = "" \^FirstLook.StateI("CapitalIndex"," BOSTON",6) = "" \^FirstLook.StateI("CapitalIndex"," COLUMBIA",8) = "" \^FirstLook.StateI("CapitalIndex"," CONCORD",9) = "" \^FirstLook.StateI("CapitalIndex"," DOVER",1) = "" \^FirstLook.StateI("CapitalIndex"," HARRISBURG",2) = "" \^FirstLook.StateI("CapitalIndex"," HARTFORD",5) = "" \^FirstLook.StateI("CapitalIndex"," PROVIDENCE",13) = "" \^FirstLook.StateI("CapitalIndex"," RALEIGH",12) = "" \^FirstLook.StateI("CapitalIndex"," RICHMOND",10) = "" \^FirstLook.StateI("CapitalIndex"," TRENTON",3) = "" \^FirstLook.StateI("PostalAbbrIndex"," CT",5) = "" \^FirstLook.StateI("PostalAbbrIndex"," DE",1) = "" \^FirstLook.StateI("PostalAbbrIndex"," GA",4) = "" \^FirstLook.StateI("PostalAbbrIndex"," MA",6) = "" \^FirstLook.StateI("PostalAbbrIndex"," MD",7) = "" \^FirstLook.StateI("PostalAbbrIndex"," NC",12) = "" \^FirstLook.StateI("PostalAbbrIndex"," NH",9) = "" \^FirstLook.StateI("PostalAbbrIndex"," NJ",3) = "" \^FirstLook.StateI("PostalAbbrIndex"," NY",11) = "" \^FirstLook.StateI("PostalAbbrIndex"," PA",2) = "" \^FirstLook.StateI("PostalAbbrIndex"," RI",13) = "" \^FirstLook.StateI("PostalAbbrIndex"," SC",8) = "" \^FirstLook.StateI("PostalAbbrIndex"," VA",10) = "" 仔细看看 global \^FirstLook.StateI 中的第一个节点。这里，第一个下标（"CapitalIndex"）是索引的名称，第二个下标是被索引的属性的值（"ALBANY"），第三个下标是以奥尔巴尼（Albany）为首府的州的 ID（11）。如果您回顾一下 global 数据，您会发现 \^FirstLook.StateD(11) 是纽约州（New York）。 Globals 使用数组下标自动按排序顺序存储。 试一试: 访问 Globals 的三种方式 关系访问 Globals （Accessing Globals Relationally） 现在，看看为 State 类生成的 InterSystems IRIS 表： 从管理门户（Management Portal）的主页，选择 System Explorer（系统资源管理器） > SQL。 在 SQL 页面上，查看页面的顶部，确保您在 USER 名称空间。 如果不是，请点击 Switch（切换）来改更改命名空间。 在左栏中，展开 Tables（表）部分来查看命名空间中的表。 在 Tables 下，点击 FirstLook.State 表。 在 Catalog Details（目录详情） 标签上，点击 Fields（字段），您将看到为 State 类的每个属性生成的字段，以及称为 ID（有时称为 RowID） 的额外字段。 这个字段类似于您在类的 globals 中看到的对象 ID。 注意： 如果您的命名空间包含大量的表，可以在页面左栏的 Filter（过滤） 框中输入 F* 来过滤列表。 点击 Execute Query（执行查询） 标签，打开一个文本区，您可以在这里编写针对 FirstLook.State 表运行的查询。 输入以下查询： SELECT * FROM FirstLook.State WHERE ID = 6 并点击 Execute（执行）。该查询返回您请求的马萨诸塞州（Massachusetts ）的行。 输入以下查询： INSERT INTO FirstLook.State(Area, Capital, Established, Name, PostalAbbr) VALUES (9616, 'Montpelier', 1791, 'Vermont', 'VT') 并点击 Execute（执行），将一行插入第 14 个州佛蒙特州（Vermont ）的表中。 要查看在 FirstLook.State 表中插入一行的效果，请返回到命名空间 USER 的 Globals 页面，并再次查看 globals。 从管理门户（Management Portal）的主页，选择 System Explorer（系统资源管理器） > Globals。 在 Globals 页面上，查看左栏，确保您在 USER 命名空间。 查看数据 global，\^FirstLook.StateD，您可以看到 ID 计数器已经增加： \^FirstLook.StateD = 14 并且一个新的节点被添加到 global： \^FirstLook.StateD(14) = $lb("","Vermont","VT","Montpelier",1791,9616) 查看索引 global，\^FirstLook.StateI，可以看到索引已经被更新为两个新节点： \^FirstLook.StateI("CapitalIndex"," MONTPELIER",14) = "" 和 \^FirstLook.StateI("PostalAbbrIndex"," VT",14) = "" 试一试: 访问 Globals 的三种方式 将 Globals 作为对象访问（Accesing Globals as Objects） 请记住，当您创建 State 类时，扩展了类 %Persistent，这使您可以访问一些有用的方法，这些方法使您可以在类的 globals 中存储数据并再次检索它。接下来，通过在 InterSystems 终端（Terminal）中编写一些 ObjectScript 来测试其中一些方法。如果您以前没有使用过终端（Terminal），请参见 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中的"InterSystems IRIS Connection Information（InterSystems IRIS 连接信息"。 在您启动 Terminal session （终端会话）后，您应该看到一个提示符，指示您所处的名称空间。如果您不在 USER 命名空间，执行以下命令： set $namespace = "USER" 首先，将您刚刚用 SQL 查询添加的佛蒙特州（Vermont）的数据加载到内存中。调用 FirstLook.State 类的 %OpenId() 方法，并将返回值赋给变量 vt。%OpenId() 返回对象的"句柄（handle）"，更正式地称为对象引用或 OREF。 USER>set vt = ##class(FirstLook.State).%OpenId(14) 您可以通过访问对象的 Name 属性来查看刚刚加载的状态的名称： USER>write vt.Name Vermont 您可以使用 zwrite 命令获取所有对象属性的摘要。该命令提供的其他信息超出了本文档的范围。 USER>zwrite vt vt=2@FirstLook.State ; <OREF> +----------------- general information --------------- | oref value: 2 | class name: FirstLook.State | %%OID: $lb("14","FirstLook.State") | reference count: 2 +----------------- attribute values ------------------ | %Concurrency = 1 <Set> | Area = 9616 | Capital = "Montpelier" | Established = 1791 | Name = "Vermont" | PostalAbbr = "VT" +----------------------------------------------------- 要创建一个新的 State 对象，请使用 %New() 方法，该方法将一个 OREF 返回给新对象。 USER>set newstate = ##class(FirstLook.State).%New() 现在，设置第 15 个州肯塔基州（Kentucky）的属性。USER>set newstate.Name = "Kentucky" USER>set newstate.PostalAbbr = "KY" USER>set newstate.Capital = "Frankfort" USER>set newstate.Established = 1792 USER>set newstate.Area = 40408 检查所有属性。 试一试: 访问 Globals 的三种方式 USER>zwrite newstate newstate=4@FirstLook.State ; <OREF> +----------------- general information --------------- | oref value: 4 | class name: FirstLook.State | reference count: 2 +----------------- attribute values ------------------ | %Concurrency = 1 <Set> | Area = 40408 | Capital = "Frankfort" | Established = 1792 | Name = "Kentucky" | PostalAbbr = "KY" +----------------------------------------------------- 如果您对一切看起来很满意，通过调用新对象的 %Save() 方法将对象保存到磁盘。%Save() 方法返回一个状态，如果保存成功，该状态的值为 1。 USER>set status = newstate.%Save() USER>write status 1 再一次，通过进入管理门户（Management Portal）中的 Globals 页面来检查您的工作。查看数据 global， \^FirstLook.StateD，您可以看到 ID 计数器再次增加： \^FirstLook.StateD = 15 并且一个新的节点被添加到 global： \^FirstLook.StateD(15) = $lb("","Kentucky","KY","Frankfort",1792,40408) 查看索引 global，\^FirstLook.StateI，可以看到索引已经被更新为两个新节点： \^FirstLook.StateI("CapitalIndex"," FRANKFORT",15) = "" 和 \^FirstLook.StateI("PostalAbbrIndex"," KY",15) = "" 直接访问 Globals（Accessing Globals Directly） 虽然 InterSystems IRIS 中的数据最常见的是通过 SQL 或使用对象层来访问，但您也可以直接访问扩展 %Persistent 的类的 globals。这种方法比较棘手，因为您需要知道 global 的结构。 首先，找到 ID 为 15 的州名称。 在终端（Terminal）中，用下标 15 将变量 ky 赋给数据 global 中的节点。 USER>set ky = \^FirstLook.StateD(15) 您可以使用 zwrite 检查存储在这个节点上的值： USER>zwrite ky ky=$lb("","Kentucky","KY","Frankfort",1792,40408) 接下来，使用 $list() 函数来获取列表中的第二项： USER>write $list(ky, 2) Kentucky 根据您在使用 SQL 或对象方法添加状态后检查 globals 所学到的内容，编写一些代码来添加新状态。 首先，准备数据，将每个属性（从对象的角度考虑）或字段（从 SQL 的角度考虑）放入不同的变量。 试一试: 访问 Globals 的三种方式 USER>set name = "Tennessee" USER>set postalabbr = "TN" USER>set capital = "Nashville" USER>set established = 1796 USER>set area = 42144 然后使用 $listbuild() 函数构建可以存储的属性列表。 USER>set properties = $listbuild("", name, postalabbr, capital, established, area) USER>zwrite properties properties=$lb("","Tennessee","TN","Nashville",1796,42144) 使用一个 ObjectScript 语句，增加 \^FirstLook.StateD global 的 ID 计数器，并将新值赋给变量 id。 USER>set id = $increment(\^FirstLook.StateD) USER>write \^FirstLook.StateD 16 USER>write id 16 现在，将数据存储在数据 global 中。 USER>set \^FirstLook.StateD(id) = properties USER>zwrite \^FirstLook.StateD(id) \^FirstLook.StateD(16)=$lb("","Tennessee","TN","Nashville",1796,42144) 现在我们需要手动更新索引，否则在首府（Capital ）或邮政缩写（PostalAbbr）上，带有 WHERE 子句的 SQL 查询将不包括田纳西州（Tennessee）。这个过程比存储数据要复杂一些。 对于字符串值（string value）的索引，InterSystems IRIS 将字符串转换为大写字母，并在前面添加一个空格字符，以便于排序。使用 _运算符将一个空格连接到大写字母的前面，然后使用 $zconvert() 函数将其转换为大写字母。然后对邮政缩写执行相同操作。 USER>set capital = $zconvert(" "_capital, "U") USER>set postalabbr = $zconvert(" "_postalabbr, "U") 最后，将索引条目存储在索引 global 中。 USER>set \^FirstLook.StateI("CapitalIndex", capital, id) = "" USER>set \^FirstLook.StateI("PostalAbbrIndex", postalabbr, id) = "" 为确保您正确完成工作，请进入管理门户（Management Portal）中的 Globals 页面，并查看 \^FirstLook.StateD 和 \^FirstLook.StateI globals。您也可以使用 zwrite \^FirstLook.StateD 和 zwrite \^FirstLook.StateI 从终端（Terminal）显示每个 global 的完整内容。 有关 Globals 的更多信息 使用 SQL 创建 Globals 在本文档中，您所看到的 globals 是通过存储使用类定义（class definition）指定的类的对象（object）创建的。您可以通过使用 SQL 创建表和表的索引来创建结构非常相似的 globals。然后，InterSystems IRIS 将根据您创建的表为您生成一个类。 作为练习，进入管理门户（Management Portal）中 USER 命名空间的 SQL 页面，并使用 Execute Query（执行查询）标签执行下列语句。 使用 InterSystems IRIS API 访问 Globals CREATE TABLE FirstLook.SQL (%CLASSPARAMETER USEEXTENTSET 0, %CLASSPARAMETER DEFAULTGLOBAL = '\^FirstLook.SQL', Name CHAR(30) NOT NULL, PostalAbbr CHAR(2), Capital CHAR(30), Established INT, Area INT) CREATE UNIQUE INDEX CapitalIndex ON FirstLook.SQL (Capital) CREATE UNIQUE INDEX PostalAbbrIndex ON FirstLook.SQL (PostalAbbr) INSERT INTO FirstLook.SQL (Name, PostalAbbr, Capital, Established, Area) VALUES ('Maine', 'ME', 'Augusta', 1820, 35380) 在 SQL 页面的左栏中，您现在应该看到 FirstLook.SQL 表。 进入 Classes 页面，找到类 FirstLook.SQL.cls 并查看其文档。您注意到有什么不同吗？这个类有一个额外的索引，称为位图扩展索引（Bitmap Extent Index）。然后进入 Globals 页面，找到 \^FirstLook.SQLD 和 \^FirstLook.SQLI globals。看看 \^FirstLook.SQLI，并看看您是否能找到额外的索引。 创建自定义 Globals 到目前为止，您已经看到了扩展 %Persistent 类时创建的 globals。但是，globals 可用于存储无模式的数据，这些数据可能不适合类或关系范式。例如，使用终端（Terminal）或管理门户（Management Portal），切换到 %SYS 命名空间，并检查 \^CONFIGglobal，它存储了一些 InterSystems IRIS 配置设置。下面是 \^CONFIGglobal 示例的一部分： \^CONFIG("Cluster","CommIPAddress") = "" \^CONFIG("Cluster","JoinCluster") = 0 \^CONFIG("ConfigFile","Version") = "2018.20" \^CONFIG("Conversions","LastConvertTime") = "2019-03-13 08:39:45" \^CONFIG("Databases","ENSLIB") = "/usr/irissys/mgr/enslib/" \^CONFIG("Databases","IRISAUDIT") = "/usr/irissys/mgr/irisaudit/" \^CONFIG("Databases","IRISLIB") = "/usr/irissys/mgr/irislib/" \^CONFIG("Databases","IRISLOCALDATA") = "/usr/irissys/mgr/irislocaldata/" \^CONFIG("Databases","IRISSYS") = "/usr/irissys/mgr/" \^CONFIG("Databases","IRISTEMP") = "/usr/irissys/mgr/iristemp/" \^CONFIG("Databases","USER") = "/usr/irissys/mgr/user/" 如果您想创建和存储自己的自定义数据结构，您可以使用 ObjectScript 轻松做到。使用下面的示例，您可以编写几行代码定义一个有向图来存储机场之间的机票价格： USER>set \^Fares("BOS", "ORD") = 87 USER>set \^Fares("ORD", "BOS") = 63 USER>set \^Fares("BOS", "LAX") = 143 USER>set \^Fares("LAX", "BOS") = 143 USER>set \^Fares("ORD", "LAX") = 57 USER>set \^Fares("LAX", "ORD") = 94 USER>zwrite \^Fares \^Fares("BOS","LAX")=143 \^Fares("BOS","ORD")=87 \^Fares("LAX","BOS")=143 \^Fares("LAX","ORD")=94 \^Fares("ORD","BOS")=63 \^Fares("ORD","LAX")=57 使用 InterSystems IRIS API 访问 Globals 如果您正在用 Java、.NET、Node.js 或 Python 编写应用程序，InterSystems IRIS 提供的 API 允许您使用本文中讨论的三种模型来操作您的数据库： 通过 JDBC、ADO.NET 或 PyODBC API 进行关系访问 通过 InterSystems XEP API 访问对象 通过 InterSystems Native API 直接访问 globals 了解有关 Globals 的更多信息 现在您知道了，无论您决定如何存储或访问数据，您所做的就是使用 globals。 注意： 并非所有语言都支持所有形式的访问。 了解有关 Globals 的更多信息 使用下面列出的参考资料来了解更多有关 globals 和如何访问它们的信息。 Globals 及其结构 Globals QuickStart（Globals 快速入门）------提供 global 结构的可视化视图，并给出在自定义 global 结构中存储数据的示例。 Using Globals（《使用 Globals》）------讨论 Globals 的结构、如何管理它们以及如何使用 SQL 或 ObjectScript 访问它们。 Globals------Defining and Using Classes（定义和使用类）这部分解释了为扩展 %Persistent 类的类创建的 globals 的命名约定。 多模型开发 Multi-Model QuickStart（多模型快速入门）------描述了 InterSystems IRIS 如何允许您用各种不同的语言（包括 Java、.NET 和 ObjectScript）使用您选择的数据模型。 Java QuickStart（Java 快速入门）------向您展示如何使用 Java API 对 InterSystems IRIS 数据库进行关系、对象和直接访问。 .NET QuickStart（.NET 快速入门）------向您展示如何使用 .NET API 对 InterSystems IRIS 数据库进行关系、对象和直接访问。 Python QuickStart（Python 快速入门）------向您展示如何使用 Python API 对 InterSystems IRIS 数据库进行关系、对象和直接访问。 InterSystems Native API Using the Native API for Java（《使用 Native API for Java》） （交互式课程）------向您展示如何使用 Native API for Java 访问 globals 以及调用类方法（call class method）和例程。 Using the Native API for Java（《使用 Native API for Java 》）（书籍）------向您展示如何使用 Native API for Java 访问 globals 以及调用类方法（call class method）和例程。 First Look: InterSystems IRIS Native API for Java（《技术概要：InterSystems IRIS Native API for Java》） --- 展示如何从 Java 应用程序访问 InterSystems IRIS globals。 Using the Native API for .NET（《使用 Native API for .NET》 ）（交互式课程）------向您展示如何使用 Native API for .NET 访问 globals 以及调用类方法（call class method）和例程。 Using the InterSystems Native API for .NET（《使用 InterSystems Native API for .NET》）（书籍）------向您展示如何使用 Native API for .NET 访问 globals 以及调用类方法（call class method）和例程。 First Look: InterSystems IRIS Native API for .NET（《技术概要：InterSystems IRIS Native API for .NET》） ------展示如何从 .NET 应用程序访问 InterSystems IRIS globals。 了解有关 Globals 的更多信息 Node.js QuickStart（Node.js 快速入门）------向您展示如何使用 Native API for Node.js 访问 globals 以及调用类方法（call class method）和例程。 Using the Native API for Node.js（《使用 Native API for Node.js》）------向您展示如何使用 Native API for Python 访问 globals 以及调用类方法（call class method）和例程。 First Look: InterSystems IRIS Native API for Node.js（《技术概要：InterSystems IRIS Native API for Node.js》）-展示如何从 Node.js 应用程序访问 InterSystems IRIS globals。 Using the Native API for Python（《使用 Native API for Python》） （交互式课程）------向您展示如何使用 Native API for Python 访问 globals 以及调用类方法（call class method）和例程。 Using the Native API for Python（《使用 Native API for Python》） （书籍）------向您展示如何使用 Native API for Python 访问 globals 以及调用类方法（call class method）和例程。 First Look: InterSystems IRIS Native API for Python（《技术概要：InterSystems IRIS Native API for Python》）------展示如何从 Python 应用程序访问 InterSystems IRIS globals。

在美国各地，当需要实现大规模的应用集成时，医疗行业的领导者会使用InterSystems HealthShare Health Connect®。无论是为了连接电子病历，还是为了提升床边护理决策能力，无论是为了创新远程医疗和远程护理，还是为了业务增长，亦或是为未来做准备，InterSystems和Health Connect随时准备好帮助您和您的组织实现目标。我们在此提供几个InterSystems医疗行业的集成实例以作示范。 案例一：大规模的互操作性有助于成功部署Epic 美国东北部的一个主要综合交付网络（IDN）的IT系统每年为13家医院、数千名临床医生和150万名患者提供服务。当该机构将其内部开发的临床和财务应用程序替换为Epic时，Health Connect的集成功能通过以下管理帮助其实现顺利过渡： •连接5000个医疗设备 •得益于基因组学、新的影像技术和互联设备，在Epic之外的数据量增长了225%（从20TB增长到65TB） •Epic与其他IT系统的接口数量增加了34% •Epic部署完成后，消息量增加了近330%（每天7300万） Epic和Health Connect共同将该机构的医疗护理协同和标准化提升到一个新的水平，并将成为未来创新的平台。 案例二：从15个集成引擎减少到1个，节省2100万美元 如果没有收购很多不同的软件系统，你就不可能成为美国前三的综合交付网络（IDNs）之一。这包括集成引擎，它可以通过数千个遗留接口连接所有东西。 当这个IDN决定在一个集成平台上进行整合时，团队意识到他们投资的不只是软件，而是大规模的项目迁移。在仅有4名开发人员的情况下，该机构在21个月内将2000多个接口转换和部署到InterSystems HealthShare Health Connect上，实现了替换7000个接口的目标。更重要的是，IDN有望为每个接口节省3000美元的开发成本，预计总成本为2100万美元。通过支持世界上最大的集中式集成项目之一，Health Connect正在确保该机构能够继续发展和扩大互联医疗业务。 IDN对竞争解决方案的评估突出了HealthShare Health Connect的一个主要优势——可快速转换为新的产品质量接口。 案例三：零停机部署HealthShare Health Connect，提前1年完成计划 当COVID-19大流行来袭时，美国东南部的某大学医疗中心正在用InterSystems HealthShare Health Connect替换其使用了30年的本土数据集成引擎。在这个过程中不允许出现停机或任何切断临床医生和研究人员获取患者重要数据的风险。 该医疗中心与InterSystems公司合作，提前一年完成了集成引擎的更换。IT团队将来自60个医疗机构的临床医生和来自300个数据接口的信息连接了起来，与此同时，临床医护人员却没有感知到他们每天使用的应用程序底层发生的任何变化。由于没有发生停机，在疫情日益严重的情况下所有医疗护理资源得到了充分应用。 案例四：规模化集成，实现业务增长和护理创新 在美国西部，一家大型IDN已经发展到包括23家实体医院、1家线上医院、215家诊所、6个州的远程医疗操作、1个保险计划和4万名护理人员。该机构使用InterSystems集成技术来实现和管理这种增长，同时保持其敏捷和创新。自2014年以来，InterSystems技术通过以下方式服务于IDN的使命和目标： •每月处理2.25 - 2.5亿笔交易，绝对可靠 •集成220个独立应用的数据 •在线上医院中，将电子病历与家庭设备连接，并应用于远程医疗 •使用FHIR标准与外部合作伙伴共享数据 •利用FHIR简化消费者门户网站的数据披露 •规模化

# 第六章 使用嵌入式 Python （三） # 从 ObjectScript 调用嵌入式 Python 代码 ## 使用 Python 库 嵌入式 `Python` 让可以轻松访问数以千计的有用库。通常称为“包”，它们需要从 `Python` 包索引 `(PyPI)` 安装到 `/mgr/python` 目录中，然后才能使用。 例如，`ReportLab Toolkit` 是一个用于生成 `PDF` 和图形的开源库。以下命令使用软件包安装程序 `irispip` 在 `Windows` 系统上安装 `ReportLab`： ```java C:\InterSystems\IRIS\bin>irispip install --target C:\InterSystems\IRIS\mgr\python reportlab ``` 在基于 `UNIX` 的系统上，使用： ```java $ pip3 install --target /InterSystems/IRIS/mgr/python reportlab ``` 安装包后，可以使用 `%SYS.Python` 类的 `Import()` 方法在` ObjectScript` 代码中使用它。 给定一个文件位置，以下 `ObjectScript` 方法 `CreateSamplePDF()` 创建一个示例 `PDF` 文件并将其保存到该位置。 ```java Class Demo.PDF { ClassMethod CreateSamplePDF(fileloc As %String) As %Status { set canvaslib = ##class(%SYS.Python).Import("reportlab.pdfgen.canvas") set canvas = canvaslib.Canvas(fileloc) do canvas.drawImage("C:\Sample\isc.png", 150, 600) do canvas.drawImage("C:\Sample\python.png", 150, 200) do canvas.setFont("Helvetica-Bold", 24) do canvas.drawString(25, 450, "InterSystems IRIS & Python. Perfect Together.") do canvas.save() } } ``` 该方法的第一行从 `ReportLab` 的 `pdfgen` 子包中导入 `canvas.py` 文件。第二行代码实例化一个 `Canvas` 对象，然后继续调用它的方法，这与调用任何 `IRIS` 对象的方法很相似。 然后，可以以通常的方式调用该方法： ```java do ##class(Demo.PDF).CreateSamplePDF("C:\Sample\hello.pdf") ``` ## 调用用 `Python` 编写的 `IRIS` 类的方法 可以使用嵌入式 `Python` 在 `IRIS` 类中编写方法，然后从 `ObjectScript` 调用它，就像调用用 `ObjectScript` 编写的方法一样。 下一个示例使用 `usaddress-scourgify` 库，可以从 `Windows` 上的命令行安装，如下所示： ```java C:\InterSystems\IRIS\bin>irispip install --target C:\InterSystems\IRIS\mgr\python usaddress-scourgify ``` 在基于 `UNIX` 的系统上，使用： ```java $ pip3 install --target /InterSystems/IRIS/mgr/python usaddress-scourgify ``` 下面的演示类包含美国地址部分的属性和一个用 `Python` 编写的方法，该方法使用 `usaddress-scourgify` 根据美国邮政服务标准对地址进行规范化。 ```java Class Demo.Address Extends %Library.Persistent { Property AddressLine1 As %String; Property AddressLine2 As %String; Property City As %String; Property State As %String; Property PostalCode As %String; Method Normalize(addr As %String) [ Language = python ] { from scourgify import normalize_address_record normalized = normalize_address_record(addr) self.AddressLine1 = normalized['address_line_1'] self.AddressLine2 = normalized['address_line_2'] self.City = normalized['city'] self.State = normalized['state'] self.PostalCode = normalized['postal_code'] } } ``` 给定地址字符串作为输入，类的 `Normalize()` 实例方法规范化地址并将每个部分存储在 `Demo.Address` 对象的各种属性中。 可以按如下方式调用该方法： ```java USER>set a = ##class(Demo.Address).%New() USER>do a.Normalize("One Memorial Drive, 8th Floor, Cambridge, Massachusetts 02142") USER>zwrite a a=3@Demo.Address +----------------- general information --------------- | oref value: 3 | class name: Demo.Address | reference count: 2 +----------------- attribute values ------------------ | %Concurrency = 1 | AddressLine1 = "ONE MEMORIAL DR" | AddressLine2 = "FL 8TH" | City = "CAMBRIDGE" | PostalCode = "02142" | State = "MA" +----------------------------------------------------- ``` ## 运行用 `Python` 编写的 `SQL` 函数或存储过程 当使用嵌入式 `Python` 创建 `SQL` 函数或存储过程时， `IRIS` 会投影一个具有可从 `ObjectScript` 调用的方法的类，就像使用任何其他方法一样。 例如，本文档前面示例中的 `SQL` 函数会生成一个类 `User.functzconvert`，它有一个 `tzconvert()` 方法。从 `ObjectScript` 调用它，如下所示： ```java USER>zwrite ##class(User.functzconvert).tzconvert($zdatetime($h,3),"US/Eastern","UTC") "2021-10-20 15:09:26" ``` 这里，`$zdatetime($h,3)` 用于将当前日期和时间从 `$HOROLOG` 格式转换为 `ODBC` 日期格式。 ## 运行任意 Python 命令 有时，当开发或测试嵌入式 `Python` 代码时，从 `ObjectScript` 运行任意 `Python` 命令会很有帮助。可以使用 `%SYS.Python` 类的 `Run()` 方法来执行此操作。 也许想测试本文档前面使用的 `usaddress_scourgify` 包中的 `normalize_address_record()` 函数，但不记得它是如何工作的。可以使用 `%SYS.Python.Run()` 方法从终端输出函数的帮助，如下所示： ```java USER>set rslt = ##class(%SYS.Python).Run("from scourgify import normalize_address_record") USER>set rslt = ##class(%SYS.Python).Run("help(normalize_address_record)") Help on function normalize_address_record in module scourgify.normalize: normalize_address_record(address, addr_map=None, addtl_funcs=None, strict=True) Normalize an address according to USPS pub. 28 standards. Takes an address string, or a dict-like with standard address fields (address_line_1, address_line_2, city, state, postal_code), removes unacceptable special characters, extra spaces, predictable abnormal character sub-strings and phrases, abbreviates directional indicators and street types. If applicable, line 2 address elements (ie: Apt, Unit) are separated from line 1 inputs. . . . ``` `%SYS.Python.Run()` 方法在成功时返回 `0`，在失败时返回 `-1`。

我很高兴与大家分享我第一次使用docker容器版本的IRIS for Health的经验，以探索你对使用或试用的兴趣，利用docker容器的优势，它是轻量级的，易于部署。本文将通过使用Renan Lourenco编写的名为ENSDEMO的GitHub仓库的实施步骤。 设置IRIS for Health社区版docker容器环境的步骤： 启动运行Docker 下载docker 镜像image docker pull containers.intersystems.com/intersystems/irishealth-community:2022.2.0.304.0 从GitHub 克隆源repository git clone https://github.com/OneLastTry/irishealth-ensdemo 改一下文件目录. 从docker-compose.yml建立容器镜像 docker-compose build 运行你的容器 docker-compose up -d 在我最初的尝试中，我无法下载irishealth community:2022.2.0.304.0的确切版本，因为它在ENSDEMO的最初发布中已经发生了变化。修复方法是，当试图从InterSystems容器注册表拉出docker镜像时，在注册表中拉出最新的可用标签。 我遇到的另一个错误是在执行docker-compose build命令后显示"=>ERROR[internal]load metadata for docker pull containers.intersystems.com/intersystems/irishealth-community:2022.2.0.293.0" 。这是因为我下载的docker镜像的版本和Dockerfile中指定的容器镜像版本之间有冲突。 登录IRIS医疗版: 管理门户: http://localhost:9092/csp/sys/%25CSP.Portal.Home.zen 用户名: SuperUser 密码: SYS SuperServer 端口: 9091 Web 端口： 9092 命名空间: ENSDEMO 启动 IRIS 终端 session: docker exec -it ensdemo iris session iris 启动 bash session: docker exec -it ensdemo /bin/bash 视频: https://www.loom.com/share/36bd8c63db724eebae65debf0d89c821 参考: https://github.com/OneLastTry/irishealth-ensdemo by Renan Lourenco (Renan.Lourenco@intersystems.com) https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=ACLOUD 咨询下，启动出现下边错误，是什么原因呢？ [root@elite ~]# docker logs irishealth[INFO] Executing command /home/irisowner/irissys/startISCAgent.sh 2188...[INFO] Writing status to file: /home/irisowner/irissys/iscagent.statusReading configuration from file: /home/irisowner/irissys/iscagent.confISCAgent[18]: StartingISCAgent[19]: Starting ApplicationServer on *:2188[INFO] ...executed command /home/irisowner/irissys/startISCAgent.sh 2188[ERROR] Required Linux capability cap_setuid is missing.[ERROR] Required Linux capability cap_dac_override is missing.[ERROR] Required Linux capability cap_fowner is missing.[ERROR] Required Linux capability cap_setgid is missing.[ERROR] Required Linux capability cap_kill is missing.[FATAL] Your IRIS container is missing one or more required Linux capabilities.[INFO] Executing command /home/irisowner/irissys/startISCAgent.sh 2188... 最新docker引擎做了变化，运行IRIS的2022.2之前的版本，要增加一个参数--check-caps false，例如： docker run --name test2 --publish 1972:1972 --publish 52773:52773 docker.iscinternal.com/intersystems/irishealth:2021.1.0.215.0 --check-caps false --key <keyfile-path>

InterSystems IRIS 2021.1 的发布引入了自适应分析(Adaptive Analytics)的介绍。 为了开始使用和熟悉 InterSystems IRIS BI cube示例，我们创建了一个用于自适应分析的 HoleFoods 应用程序示例模版。 此示例应用程序可在 Open Exchange 上获得， 还有一个学习服务课程learning services course 可用于了解有关自适应分析的更多信息。 首先，前往 Open Exchange 并点击下载按钮。您将会被引至发布页面，该页面包含最新版本的应用程序示例， 下载 ZIP 文件开始创建示例样本。 加载示例样本前准备 IRIS 确保你已经在IRIS 命名空间中已经有要导入的样本MySample 模式被定义 如果未定义上述1模式，请在 SMP 中运行以下 SQL 创建表 MySample.Dummy (P1 INT NOT NULL) 如果您还想设置一些 global mappings, 请至少插入 1 行，以便找出需要映射的global hash 插入MySample.Dummy (P1) 值 (1) 在 AtScale 中，登录并转到 PROJECTS 选项卡 点击 hamburger 菜单 并选择 "Use a sample" 选择您的DWH，the MySample 模式，和zip 文件 可以使用默认权限 您现在该期待IRIS中的新Table和AtScale中的新Project了！ 安装示例应用程序后，您可以开始使用 Excel、Tableau 或 Power BI 等第三方工具发现和探索数据功能。 查看已发布的多维数据集时，您可以查看有关如何连接到不同第三方工具的详细信息。 相比发现和探索数据功能，您可能首先会探索这个模式与现有的 HoleFoods InterSystems IRIS BI Cube做比较。

从数据上看，2022年Epic的市场份额遥遥领先，而Cerner的市场却在不断被蚕食。 非常骄傲的是Epic电子病历是基于InterSystems数据平台构建，早在2020年Epic就将其数据库从Cache升级到InterSystems IRIS。 关于KLASKLAS是一家全球性数据驱动型公司，旨在通过提升医疗机构和保险公司的话语权来改善医疗服务水平和质量。KLAS与数以千计的医疗领域专业人员携手合作，收集对软件、服务和医疗设备的相关见解与反馈，并发布相应的行业报告、发展趋势和统计概况。KLAS如实提供准确且公正的数据，这种调研直接反映了医疗领域专家的声音，并帮助医疗行业的供应商提高业绩。更多详情，请登录：https://klasresearch.com/ 报告原文也可以从网上获取。 V总第一篇！

我们刚刚结束了第二天的专题会议，会议内容精彩纷呈！虽然大家无法同时观看多个平行会议，但是线上会议有一个优势，那就是您可以根据自己的需要回看错过的内容！ 在昨天的博客文章（第一天会议亮点）中，我介绍了大部分值得关注的公告，如 InterSystems IRIS Adaptive Analytics 和FHIR加速器服务等。所以，今天我想更宽泛地讨论一些战略主题。 运营和系统管理 现在，越来越多的客户业务已经运行在云端，也有越来越多的人开始在本地部署现代部署策略。Mark Bolinsky今天主持了两场背靠背会议：CL003 云存储策略和CL004 云备份策略，为使用云端生产工作的用户带来了很多技术细节。我们新推出的系统警报和监控（SAM）模块也得到了不错的反馈。相关内容请查看DEV007 系统警报和监控和CL005 分布式部署。另一个另广大开发者兴奋的消息是，集群监控现在可以轻松实现。在此感谢所有参与并提出问题的与会者！ 安全性 在安全性方面，InterSystems一直受到客户和分析师的高度好评，不过大多数人会认为这样做是为了保持自身产品的安全。这当然是我们的一个目标，但是我们还添加了许多新的安全特性。今天的SEC000 OCSP装订就是一个典型的例子。虽然OCSP（在线证书状态协议）可提供更强的安全性，但也会影响浏览器性能。使用OCSP装订功能后，服务器会检查X.509证书的有效性，并将状态进行装订响应给浏览器，从而大幅缩短响应时间，并增强安全性。 机器学习 去年，我们发布了一款纯SQL的嵌入式机器学习工具——IntegratedML。现在，这一工具已被广泛应用。今天，Tom Dyar向大家介绍了这款工具的入门教程，并深入探讨了H2O和DataRobot的合作。昨天的内容还包括我们的早期采用者Baystate的用例。更多关于机器学习平台的最佳实践的内容将在明天为大家揭晓！ 数据仓库和商业智能 为了让InterSystems IRIS能够更加成功地应用于分析用例中，我们做了大量投资，新的自适应分析产品只是其中的一项。Benjamin De Boe在会上概述了公司在数据仓库技术方面所做出的努力，并向大家介绍了我们SQL引擎的一些内部结构。在终端用户方面，Mark Massias介绍了我们为用户提供的自由选择——用户可以自由选择商业智能和报告工具，以便将数据仓库中的数据可视化。最后，Carmen Logue介绍了我们的合作伙伴——来自BioReference Labs的Mike Senatore，他们采用了我们新的“Selective Cube Build”功能，以最大限度地提高其InterSystems IRIS BI环境的可用性。明天会介绍关于我们与新技术合作伙伴Altheryx在该领域的更多合作内容！ 开发人员对话 在今天的几个会议中，我们的开发人员介绍了几款将数据和应用程序导入IRIS数据平台的强大工具。Harry介绍了如何使用Change Data Capture这一现代技术在数据库之间进行数据迁移。如果您想要构建客户端应用程序，请查看Bob Kuszewki的指南：对象、关系和本机客户端Java API。说到应用程序开发，如果您想要构建和部署IRIS应用程序，那么Tim Leavitt主持的ZPM软件包管理器专题会议不容错过。 互操作性和FHIR Matt Spielman在FHIR展望专题会议中回顾了自2014年开始的InterSystems对FHIR技术的研究历史。他概述了未来两年的FHIR路线图，包括bulk FHIR和FHIR分析。随着FHIR的发展，FHIR的需求增长越来越多地来自客户，而InterSystems工程师的推动作用越来越小。 InterSystems在增强X12支持方面将继续投入大量资金。IP004：新的X12增强功能展示专题会议简短介绍了X12的新功能，并演示了一些值得关注的功能，包括SNIP Level 1和2验证以及专门针对X12的合并DTL支持功能。 Stefan Wittmann在IP003：HL7 Feeds助力高效运行专题会议中提前展示了HL7生产力工具包的最新功能。InterSystems IRIS现在能够根据入站和出站HL7v2消息生成DTL存根，支持接口开发人员采用迭代模式改进DTL和重新测试。我们希望此功能可以进一步提高生产力。另一个功能是将用户跨命名空间或安装实例对production进行修改成为可能，从而显着降低升级成本。 自InterSystems API Manager（IAM）问世一年多以来，许多合作伙伴已经使用了InterSystems IRIS数据库平台的这一新功能。所以今天的会议对IAM进行了更深入的介绍。IP002：快速入门InterSystems API Manager 为尚未探索IAM的人士提供了一次快速了解IAM主要功能的机会，并介绍了下一版本IAM 1.5.0.3将包含的新特性。Stefan还在IP001：IAM的最佳实践专题会议中探讨了实现高可用性并对API流量提供最佳粒度控制的方法。 未来活动 专题会议将于明天结束，我们期待会议取得圆满成功。会后大家仍然可以通过多种方式与我们互动。欢迎通过VS2020questions@InterSystems.com发送您的问题和反馈。您还可以在当天结束时参与现场问答环节，充分利用下周的学习和工作时间。 如果想深入了解您感兴趣的话题，最好的途径是参与我们的咨询专家活动。欢迎提前预约10月30日或11月2日由专家或培训师主持的相关会议！ 今天的线上峰会上您最喜欢的内容是什么？请在下方的评论中告诉我们。 祝明天的会议顺利！ Jeff

当我在 Intersystems Studio 中编写代码时，代码完成与在 VS Code 中不同。如果 VS Code 在代码完成时以相同的方式做出反应，那就太好了。Studio是这样的： 在 VS Code 中执行此操作时，它不显示对象但显示 “所有可能的项目”吗？ 欢迎大家参与讨论，也欢迎大家参考英文社区的讨论内容：https://community.intersystems.com/node/531651

圆满结束！ 所有的专题会议都已经播出了。当然，我们全部102部预录制的专题会议现在可以点播了，您可以随意观看，即使您错过了现场问答的机会。 说到现场问答，我们已经举办了6次现场会议，您也可以观看。我之前写过一篇单独的博客文章，题目是如何让您的问题会帮助我们做得更好。 智能工厂启动包 今天备受关注的亮点之一是Intersystems IRIS智能工厂启动包在OpenExchange上发布。为此，我们的合作伙伴ITVisors和他们的客户Vlisco与我们的Joe Lichtenberg一起举办了一场精彩的会议“MFG001：介绍适用于制造业的InterSystems IRIS智能工厂启动包”。 容器和Kubernetes平台 今天我们宣布了一个高度安全的新版IRIS容器，名为“iris-lockeddown”，这个容器非常适合在Kubernetes中使用加固型pod安全策略的团队。说到Kubernetes，Steve Lubars演示了我们新的InterSystems Kubernetes Operator，它让您可以很轻松地在Kubernetes 中部署IRIS集群。而Luca Ravazzolo则演示了如何用CPF合并文件配置您的IRIS实例，特别是如何自动化进行镜像配置。还有其他一些有趣的问题。 以上精彩内容尽在对话Ontario Systems公司企业架构师Jim Howell中，讲述了他们从庞大的旧系统迁移到Kubernetes现代化微服务架构的经历。 更多分析： 如果您觉得我们在分析领域没什么可谈论和宣布的了，再想想！Sergey在“DA014平台内AI的最佳实践”中分享了我们对平台内AI的观点，以及如何通过IRIS协调机器学习操作从而实现持续集成和交付(CI & CD)。作为“分析”板块的压轴，Benjamin展示了我们采用Alteryx的新协作项目，其允许业务分析师和主题专家不需要编程就可以构建分析工作流，并且可以轻松地将他们的工作融合到IRIS中。观看“DA011使用Alteryx搭配IRIS打造您的分析工作流”，了解更多关于这项合作的详情。 更多VS Code - ObjectScript https://intersystems.6connex.com/event/virtual-summit/en-us/contents/434914/share?rid=FocusSessions&nid=851040 我在第1天的博客中谈过这个，今天我们再次更深入地探讨了最热门的话题之一：源代码控制，观看“DEE006使用Visual Studio Code进行ObjectScript开发：选择IDE/源代码控制组合”和“DEE005使用Visual Studio Code进行ObjectScript开发：服务器端源代码控制”。我还注意到人们深入探讨了实战实验室并给与了高度评价——值得一试！ 让我感到特别兴奋的是，我们在保持这一社区作为真正的开源社区的同时，还能提供大量InterSystems核心开发周期和InterSystems的深度支持。请加入社区并将您的建议反馈给我们！ 是的，更多关于FHIR的内容 我们的FHIR板块一直很棒，第3天也不例外。 Russ Leftwich展示了一部很棒的动画，这部动画描绘了FHIR从起源到如今的整个发展历程，其中包括了所有最新的InterSystems FHIR技术。“FH008 FHIR：为未来设计的医疗数据标准”20分钟的总结，是我见过的最棒的关于FHIR的总结。 Kurt Dawn介绍了InterSystems客户非常关注的热门话题FHIR Profiles。他展示了如何将用于实现规范的FHIR包轻松导入IRIS医疗版。Jeff Morgan的IRIS医疗版中的FHIR实现模式演示了如何使用带生产和定制逻辑的FHIR服务器——高级开发者肯定想了解一下。 持续学习 还有很多其他的会议我没有提到；我建议大家去会议网站搜索自己感兴趣的话题——您可以看到所有板块的专题会议，演示区的各种演示，以及资源区的各种内容。 如果您先想看看亮点，然后再选择观看其他内容，您可以查看我的第1天和第2天总结，我们的紧密合作伙伴J2也一直在发布每日精彩回顾（查看J2第1天专题会议的精彩回顾和第2天专题会议的精彩回顾） 请教专家是深入了解任何您感兴趣的主题的好方法。现在预约10月30日或11月2日与专家或培训师会面也不迟！而且下周是实验室周——可以尝试实战实验室！您可以选择Office Hours以及On-Demand和Live Labs。 感谢参与我们的首次线上峰会！ 您可以在下面评论或通过任何您喜欢的方式告诉我们您的想法。 查看原帖 由 @Jeff Fried 撰写

正如之前在 2022 年全球峰会上宣布的那样，InterSystems 将停止交付或安装基于 Apache 的web服务器（通常称为私有web服务器或 PWS）；此更改目前计划用于 InterSystems IRIS 2023.2。 使用这种新方法，您可以完全控制选择最适合您目的的 Web 服务器，以及如何配置、维护和更新它。这一变化的一个主要好处是您将不再需要等待 InterSystems 的更新套件来获得最新版本，这在安全漏洞情况下尤其重要。 InterSystems 将提供可用于帮助配置 Apache 或 IIS 的工具。 （请注意，InterSystems IRIS Community Edition 将继续安装 PWS。） 安装 Web 服务器是一个常见的过程，通常很容易 - 各个 Web 服务器供应商都有详细的文档记录。 以下是适用于 Ubuntu、Windows 和 macOS 的示例。它们演示了快速安装，因此您可以看到当 InterSystems 产品不包含或安装 Web 服务器时的新行为。 （请注意，此代码按原样提供，不受支持，也不足以托管关键任务或数据敏感的应用程序。） 提供了常见问题解答，其中提供了更多信息并可访问用于尝试此新过程的工具包。请参阅本文末尾链接的 PDF 以获取常见问题解答，或者如果您想添加到讨论中，请访问https://community.intersystems.com/post/discontinue-apache-web-server-installations-faq 。 安装 Web 服务器通常有多种方法，请选择您熟悉且最适合您的方法。 已为希望试用不包含 PWS 的新安装程序的客户创建了一个新的抢先体验计划 (EAP)。如果您希望成为此 EAP 的一部分并访问这些工具包，请发送电子邮件至 nopws@InterSystems.com 。 如需反馈或疑虑，请通过nopws@InterSystems.com联系我们。 以下是 Microsoft Windows 的示例： 使用 Microsoft Windows 安装 IIS。 安装后，您可以安装 InterSystems IRIS，它将询问用户是否应配置 IIS。 下面是一个使用 Ubuntu 的例子： 先决条件：允许用户使用 sudo，Ubuntu 操作系统，未安装 PWS 对于 Ubuntu，Apache 的官方存储库可以与 apt-get 命令一起使用。 更新存储库 $ sudo apt-get update 安装Apache $ sudo apt-get install apache2 验证是否已安装 $apache2 -v 安装 InterSystems IRIS 使用 SMP 进行测试 ( http://localhost/iris/csp/sys/UtilHome.csp ) 如果您只是出于测试目的安装了 apache2，您可以使用以下命令删除 apache2： $ sudo apt-get remove apache2 这是一个使用 macOS 的示例： 安装 $ brew install apache-httpd 在升级或安装后重新启动 httpd： $ brew services restart httpd 通过使用启动它 sudo apachectl -k start 或使用重新启动它 $ sudo apachectl -k restart 测试它是否通过将您的浏览器定位到 http://localhost:8080 它应该显示："It works" 安装 IRIS（请注意新的安装对话框，因为它是新的） 重新启动web服务器 $ sudo apachectl -k restart 使用 SMP 进行测试 ( http://localhost:8080/iris/csp/sys/UtilHome.csp ) 如果您只是出于测试目的安装了 apache-http，您可以使用以下命令删除 apache-http： $ brew remove apache-httpd 删除 Apache 相关设置或安装 请小心删除设置或配置，并自行承担使用风险。 删除单个实例的 apache httpd 配置。 找到 Apache httpd.conf 文件。它的位置取决于平台： macOS：/usr/local/etc/httpd/httpd.conf SuSE Linux: /etc/apache2/httpd.conf 红帽 Linux：/etc/httpd/conf/httpd.conf Ubuntu Linux: /etc/apache2/apache2.conf AIX：/opt/freeware/etc/httpd/conf/httpd.conf_64（如果使用 64 位 httpd） /opt/freeware/etc/httpd/conf/httpd.conf（如果使用 32 位 httpd） 以 root 身份编辑 httpd.conf 并在文件末尾删除以下部分，从 #### 开始-ApacheCSP-SECTION-<INSTANCENAME> #### 开始结束于 #### 开始-ApacheCSP-SECTION-<INSTANCENAME> ####。 使用命令“sudo apachectl -k restart”重新启动 Apache 要删除单个实例的 Web Gateway 配置： 如果更改了 WebGateway 安装目录的默认目录，请使用以下说明中的适当路径。 以 root 身份编辑 /opt/webgateway/conf/CSP.ini 并删除以下行： 在“[SYSTEM_INDEX]”部分中删除行 <INSTANCENAME>=Enabled 在“[APP_PATH_INDEX]”部分中删除行“/<nstancename>=Enabled” 删除部分“[APP_PATH:/<instancemame>]” 从所有 IRIS 实例中清除 Apache httpd： Apache配置 找到 Apache httpd.conf 文件。它的位置取决于平台： macOS：/usr/local/etc/httpd/httpd.conf SuSE Linux: /etc/apache2/httpd.conf 红帽 Linux：/etc/httpd/conf/httpd.conf Ubuntu Linux: /etc/apache2/apache2.conf AIX：/opt/freeware/etc/httpd/conf/httpd.conf_64（如果使用 64 位 httpd） /opt/freeware/etc/httpd/conf/httpd.conf（如果使用 32 位 httpd） 以 root 身份编辑 httpd.conf 并在文件末尾删除以下所有部分，以 #### 开始-ApacheCSP- 开始并结束于 #### 结束 ApacheCSP 使用命令“sudo apachectl -k restart”重新启动 Apache 要从所有 IRIS 实例中清除 Web Gateway： 要删除单个实例的 Web Gateway 配置： 如果更改了 WebGateway 安装目录的默认目录，请使用以下说明中的适当路径。 sudo rm -rf /opt/webgateway sudo rm -f /usr/local/etc/irissys/CSP_options PWS Removal FAQ

5月27日，CHIMA大讲堂第十九期邀请医院信息化专家和InterSystems技术专家，共同探讨集成平台赋能智慧医院建设这一话题。欢迎大家围观参会！InterSystems专家演讲概要如下： 演讲人 李岩 ( @Li.Yan )，InterSystems中国业务拓展经理演讲主题构建更智慧的医院信息平台演讲概要在需求的拉动下和政策、标准的推动下，为了给患者提供更好的就医体验，给医务人员提供更好的临床服务，给管理者提供更好参考和手段，智慧医院的建设如火如荼地发展起来了。智慧医院的建设并不是某一应用、某一系统的点状建设，而是打通各个环节、各个系统的全面的建设。 作为医院系统互通的核心的医院信息平台，如何更加“智慧”，如何更好地赋能智慧医院建设？希望本期分享能为您带来一些启发。 演讲人 乔鹏 (@Qiao.Peng) ，InterSystems中国技术总监演讲主题从集成平台到医院信息平台演讲概要当前医院信息化建设是否需要一个集成平台？是不是仅仅因为互联互通才需要集成平台？ 集成平台是否只是一个过渡性的产品？医院信息平台是集成平台的发展方向吗？ 此次分享将和大家一起讨论这些问题，探究集成平台出现的原因、它的价值和不足，以及目前医疗信息化建设对集成平台的挑战。探讨医院信息平台作为集成平台的未来，它的核心价值、能力、设计思路和实施路径。 完整日程如下： 手机端请扫描图片中二维码，电脑端请复制下方链接观看。https://djt.chima.org.cn/ 欢迎大家报名、围观、参会！ 陆主任会从目前平台建设存在的问题、平台框架选择、平台建设注意事项等全方位，多角度的介绍广医二院的医疗信息平台建设

[toc] # 第三十一章 管理许可（四） ## 显示本地许可证信息的方法 下面列出的子例程转储实例共享内存中本地包含的许可证表的内容。一般来说，他们识别客户： `$System.License.DumpLocalAll` 将所有本地许可证表条目转储到当前目录中的 `all.dmp` 文件中： ```java USER> Do $System.License.DumpLocalAll() 25 条目转储到 c:\intersystems\irishealth\mgr\user\all.dmp ``` `all.dmp` 文件的内容示例：  `$System.License.DumpLocalInUse` 将所有正在使用的本地许可证表条目转储到当前目录中的 `inuse.dmp` 文件： ```java USER> Do $System.License.DumpLocalInUse() 2 条目转储到 c:\intersystems\irishealth\mgr\user\inuse.dmp ``` `inuse.dmp` 文件内容示例：  `$System.License.DumpLocalPID` 将进程 `ID` 使用的本地许可证表转储到当前目录中的 `piduse.dmp` 文件中： ```java USER> Do $System.License.DumpLocalPID() 33 条目转储到 c:\intersystems\irishealth\mgr\user\piduse.dmp ```  ## 显示许可证服务器信息的方法 以下子例程转储许可证服务器维护的许可证表的内容。输出文件位于运行活动许可证服务器的主机上的指定目录中。 `$System.License.ShowSummary` 显示许可证服务器上的许可证信息摘要。分布式许可证使用部分提供许可证服务器当前支持的所有 `IRIS` 实例的许可证使用的集体视图。本地许可证使用部分展示了运行程序的单个 `IRIS` 实例的许可证使用视图： ```java USER> Do $System.License.ShowSummary() 软件许可服务器活动密钥摘要视图. 分布式软件许可使用: 当前使用的软件许可单元 = 2 使用的最大软件许可单元数 = 2 授权的软件许可单元 = 25 本地软件许可使用: 当前连接 = 2 最大连接数 = 6 当前用户 = 2 最大用户数 = 3 ``` `$System.License.DumpServer` 将与运行此例程的服务器相关的许可服务器数据库信息转储到运行许可服务器的主机上的文件 `dumpserver.txt` 中： ```java USER> Do $System.License.DumpServer() License server database dumped to: c:\intersystems\irishealth\mgr\dumpserver.txt at LAPTOP-ARLL3DSO ```  `$System.License.DumpServers` 将所有已知服务器的许可证服务器数据库信息转储到运行许可证服务器的主机上的文件 `dumpservers.txt` 中： ```java USER> Do $System.License.DumpServers() 1 server database[s] dumped to: c:\intersystems\irishealth\mgr\dumpservers.txt at LAPTOP-ARLL3DSO ```  `$System.License.DumpKey` 将此实例和共享它的实例使用的密钥转储到运行许可证服务器的主机上的文件 `dumpkey.txt` 中： ```java USER> Do $System.License.DumpKey() License server Client data dumped to: c:\intersystems\irishealth\mgr\dumpkey.txt at LAPTOP-ARLL3DSO ```  `$System.License.DumpKeys` 转储所有密钥，将使用它们的实例和客户端显示到运行许可证服务器的主机上的文件 `dumpkeys.txt` 中： ```java USER> Do $System.License.DumpKeys() License server Client data (1 key[s]) dumped to: c:\intersystems\irishealth\mgr\dumpkeys.txt at LAPTOP-ARLL3DSO ```  注意：请注意，本地许可方法显示的信息比许可服务器方法显示的信息更新；许可证服务器只定期更新，而本地数据是实时的。 可能会暂时超出许可限制，因为登录是在本地控制的，但许可服务器会强制执行该限制。每个实例根据其在实例共享内存中维护的本地许可证表允许或拒绝登录。每个实例都会定期向许可证服务器发送更新，描述本地许可证表的更改。如果所有实例的组合许可证使用超过限制，则许可证服务器将发送否定确认以更新来自每个实例的消息。 这种否定确认会导致每个实例拒绝新的登录，因为没有额外的许可单元可用。当尝试启动的 `IRIS` 进程的许可用户 `ID` 与任何当前进程的许可用户 `` 不匹配时，登录被视为新登录。这种状态一直持续到所有实例的组合使用量低于授权限制，此时许可证服务器开始发送肯定确认以响应实例更新。然后各个实例允许新的登录。

本文是上一篇关于如何从流行数据库（如 PostgreSQL 和 MySQL）迁移到 IRIS 的后续文章。 我们将使用与从 PostgreSQL 迁移相同的过程。 但是，您会发现它更容易，因为 MySQL 中的数据类型与 IRIS 非常相似。 这就是为什么我们不需要在列中创建转换规则。 获取示例数据到迁移过程 在 GitHub 中，可以下载 docker-compose 项目来构建和运行 2 个数据库： 源数据库：带有示例数据库的 MySQL 数据库 Docker 实例。 目标数据库：InterSystems IRIS 数据平台 Docker 实例，具有用于接收源数据库的现成模式。 要获取示例并运行它，请执行以下步骤： 转到 git 存储库 https://github.com/yurimarx/migration-mysql-iris。 克隆项目：https://github.com/yurimarx/migration-mysql-iris.git。 转到项目文件夹migration-mysql-iris。 进行构建：docker-compose build。 执行容器：docker-compose up -d。 如果一切正常，请使用实例检查您的 docker 桌面： 关于要迁移的数据 要迁移的数据与第一部分中使用的数据模型相同，在这里表示： 所以，从 MySQL 到 IRIS 的迁移过程会迁移： 8张表 5000行销售数据。 2500 行用户数据。 200 行产品数据。 50行商店数据。 100行国家数据。 30行城市数据。 5 行 status_name。 迁移目标将是 InterSystems IRIS 数据库中 USER 命名空间内的 dc_test 模式。 从 MySQL 迁移到 IRIS 的开源工具：DBeaver 在第一部分中，我们使用 DBeaver 社区版进行迁移。 我们将再次使用它。 DBeaver 是一个数据库工具，用于连接、创建、删除、选择、更新和删除市场上主要数据库产品中的数据对象。 从以下网址下载：https://openexchange. intersystems.com/package/DBeaver。 现在按照安装说明将这款出色的产品安装到您的笔记本电脑或台式机中。 DBeaver 可用于在数据库连接之间迁移数据，即使它们来自不同的制造商和版本。 使用 DBeaver 连接源数据库和目标数据库 现在我们将设置要迁移的数据库连接。 设置 MySQL 到 DBeaver 的连接： 1. 在 DBeaver 中，转到文件 > 新建。 2. 选择数据库连接并单击下一步： 3. 选择 SQL 选项卡 > MySQL，然后单击下一步： 4. 填写 Main 选项卡中的 MySQL 连接字段，如下图所示： 主机：本地主机 端口：3306 数据库：db 用户名：user 密码：密码 5. 转到驱动程序属性选项卡并将 allowPublicKeyRetrieval 设置为值 TRUE： 6. 在驱动程序属性选项卡中继续，并将 useSSL 设置为值 FALSE： 7. 如果 DBeaver 请求下载 MySQL 驱动程序，请按 Yes 或 OK。 8. 单击完成。 设置 InterSystems IRIS 与 DBeaver 的连接： 在第一部分中，您配置了 IRIS 连接，但如果您没有保存它，请执行以下操作： 1. 在 DBeaver 中，转到文件 > 新建。 2. 选择数据库连接并单击下一步： 3. 选择 SQL 选项卡 > InterSystems IRIS 并单击下一步： 4. 如果 DBeaver 请求下载 InterSystems IRIS 驱动程序，请按 Yes 或 OK。 5. 设置 InterSystems IRIS 连接字段，如下图所示： 主机：本地主机 数据库/架构：用户 用户名：_SYSTEM 密码：SYS 单击文本连接并完成。 连接（db 和 user）在 Database Navigator 中可用： 进行迁移 迁移过程与第一部分中描述的非常相似。只需按照以下步骤操作： 1. 展开 db connection > Databases > db > Tables 并选择所有表。 在选定的表上单击鼠标右键，然后选择导出数据，如下图所示： 2. 选择数据库，如图所示，然后单击下一步： 3. 单击选择按钮： 4. 选择 dc_test 并点击 OK（注：如果您需要在目标和源列之间创建高级转换，请点击 Columns 按钮）。 5. 现在，单击下一步。 6. 将 Fetch size 设置为 1000000，然后单击下一步。 7. 接受数据加载设置中的默认值，然后单击下一步。 8. 在确认中单击继续。 9. 现在，如果您打开 Database Navigator，您将能够看到 InterSystems IRIS dc_test 模式中的所有 MySQL 表。 就像 PostgreSQL 迁移一样，MySQL 迁移过程对于表来说非常简单。 但是，对于视图、函数、触发器和存储过程，您需要使用 ObjectScript 或 SQL 重写 SQL 源代码。 请跟第一篇连起来形成系列，谢谢！