搜索​​​​

本文解释了如何使用 InterSystems IRIS Native 从 .NET 应用程序访问 InterSystems IRIS®数据平台 globals。IRIS Native 还允许您运行ObjectScript 方法、函数和Routine。在本文中，您首先将连接到 InterSystems IRIS。然后您将在 InterSystems IRIS 中设置和检索一个global 节点的值，并在另一个 global 节点上进行迭代。您还将调用 InterSystems IRIS 类方法。所有这些活动都将在 .NET 应用程序中执行。 为了让您体验 IRIS Native，而又不陷入细节困境，本次探索特意设计得很简洁。这些活动被设计成只使用默认设置和功能，这样您就可以熟悉功能的基本原理，而不必处理那些离题或过于复杂的细节。当您把 IRIS Native 引入您的生产系统时，您可能需要做一些不同的事情。请确保不要把这种对 IRIS Native 的探索与真实的情况相混淆! Globals 简介 InterSystems IRIS 提供了一种易于使用的方法来将数据存储在持久的多维数组中。global 是存储在 InterSystems IRIS 物理数据库中的多维数组。在应用程序中，globals 到物理数据库的映射基于当前命名空间，命名空间提供一个或多个物理数据库的逻辑统一视图。例如，要使用一个名为 ^Settings 的 global 将值 "Red "与键 "Color "关联起来，打开 InterSystems 终端并输入以下代码： set ^Settings("Color")="Red" 您可以利用 globals 的多维特性来定义一个更复杂的结构： set ^Settings("Auto1","Properties","Color") = "Red" set ^Settings("Auto1","Properties","Model") = "SUV" set ^Settings("Auto2","Owner") = "Mo" set ^Settings("Auto2","Properties","Color") = "Green" 探索 IRIS Native 现在，您已经准备好实验 IRIS Native 了。下面的简短演示将向您演示如何在 .NET 应用程序中使用 IRIS Native。(想试试 InterSystems IRIS .NET 开发和互操作性功能的在线视频演示？请看.NET 快速入门！ 用前须知 要使用该程序，您需要一个安装了 .NET 框架和 Visual Studio 的 Windows 系统，以及一个运行中的 InterSystems IRIS 实例来连接。您对InterSystems IRIS 的选择包括多种类型的已授权的和免费的评估实例；实例不需要由您正在工作的系统托管（尽管它们必须相互具有网络访问权限）。关于如何部署每种类型的实例的信息（如果您还没有可使用的实例），请参见InterSystems IRIS 基础：连接一个 IDE中的部署InterSystems IRIS 。使用同一文档中的InterSystems IRIS 连接信息和 .Net IDE 中的信息将 Visual Studio 连接到您的 InterSystems IRIS 实例。 配置 Visual Studio 项目 首先，打开 Visual Studio 并创建一个新的控制台应用程序项目，选择 Visual C# 和 Console App (.NET Framework)（控制台应用程序（.NET 框架））选项。对于 Name（名称）字段，输入 netnative。 添加程序集引用 InterSystems.Data.IRISClient.dll 程序集必须存在于您的本地系统中；您可以从 https://github.com/intersystems/quickstarts-dotnet/tree/master/EFPlay/bin/Debug 下载它。如果 InterSystems IRIS 安装在您的本地系统或您可以访问的另一个系统上，则该程序集已经安装在子目录 install-dir\dotnet\bin\v4.5 中，其中 install-dir 是该实例的安装目录。 要将 InterSystems.Data.IRISClient.dll 的程序集引用添加到项目： 从 Visual Studio 主菜单中，选择 Project（项目） > Add Reference（添加引用）... 在出现的窗口中，点击 Browse（浏览）.... 浏览到 InterSystems.Data.IRISClient.dll 文件的位置。 选择文件并点击 Add（添加）。 点击 OK（確定）。 在 Visual Studio Solution Explorer 中， InterSystems.Data.IRISClient.dll 程序集现在应该列在 Reference（引用）下。 使用 IRIS Native 现在，您已经准备好实验 IRIS Native 了。打开在创建 Visual Studio 项目时创建的文件（例如，Program.cs）。删除文件的默认内容并粘贴以下代码，用您的 InterSystems IRIS 实例的连接信息替换 conn.ConnectionString 中的值。(logfile 的值必须是本地系统上的可写路径）。您可以指定所示的 USER命名空间，也可以选择在实例上创建另一个命名空间。 using System; using InterSystems.Data.IRISClient; using InterSystems.Data.IRISClient.ADO; public class IRISNative { public static void Main(String[] args) { try { // open connection to InterSystems IRIS instance using connection string IRISConnection conn = new IRISConnection(); // edit this ConnectionString to match your environment conn.ConnectionString = "Server=localhost; Port=1972; Namespace=User; Password=SYS; User ID=_system; logfile=c:\\sandbox\\dbnative.log"; conn.Open(); // create IRIS Native object IRIS iris = IRIS.CreateIRIS(conn); Console.WriteLine("[1. Setting and getting a global]"); // setting and getting a global // ObjectScript equivalent: set ^testglobal("1") = 8888 iris.Set(8888, "^testglobal", "1"); // ObjectScript equivalent: set globalValue = $get(^testglobal("1")) Int16? globalValue = iris.GetInt16("^testglobal", "1"); Console.WriteLine("The value of ^testglobal(1) is " + globalValue); Console.WriteLine(); Console.WriteLine("[2. Iterating over a global]"); // modify global to iterate over // ObjectScript equivalent: set ^testglobal("1") = 8888 // ObjectScript equivalent: set ^testglobal("2") = 9999 iris.Set(8888, "^testglobal", "1"); iris.Set(9999, "^testglobal", "2"); // iterate over all nodes forwards Console.WriteLine("walk forwards"); IRISIterator subscriptIter = iris.GetIRISIterator("^testglobal"); foreach (var node in subscriptIter) { Console.WriteLine("subscript=" + subscriptIter.CurrentSubscript + ", value=" + node); } Console.WriteLine(); Console.WriteLine("[3. Calling a class method]"); // calling a class method // ObjectScript equivalent: set returnValue = ##class(%Library.Utility).Date(5) String returnValue = iris.ClassMethodString("%Library.Utility", "Date", 5); Console.WriteLine(returnValue); Console.WriteLine(); // close IRIS object and connection iris.Close(); conn.Close(); } catch (Exception ex) { Console.WriteLine(ex.Message); }}} 示例代码分为三个部分： 第一部分展示了如何设置一个 global 的值以及稍后如何检索它。这部分里面执行的命令等同于 ObjectScript 的 SET 和 GET 命令。 第二部分展示了如何迭代 global 的子节点，类似于ObjectScript中的 $ORDER函数。 第三部分展示了如何使用 IRIS Native 从您的 .NET 应用程序调用 ObjectScript 类方法。 如果您使用的是本地安装的实例，并且因此连接使用 localhost 作为服务器地址，那么程序可能使用本地共享内存连接，这比标准的 TCP/IP 连接还要快。 注意： ObjectScript 中的 Globals 以插入符号（^）开头。在使用 InterSystems IRIS Native API 的 .NET 应用程序中，这不是必需的。 运行练习 现在可以按 Ctrl+F5 运行演示应用程序了。如果示例执行成功，您应该会看到带有示例代码结果的打印输出： [1. Setting and getting a global] The value of ^testglobal(1) is 8888 [2. Iterating over a global] walk forwards subscript=1, value=8888 subscript=2, value=9999 [3. Calling a class method] Oct 30, 2018 在管理门户（Management Portal）中确认变更 接下来，使用以下程序在管理门户（Management Portal）中确认您的结果： 使用InterSystems IRIS 基础：连接一个 IDE中为您的实例描述的 URL，在浏览器中打开您的实例的管理门户（Management Portal）。 如果您不在代码指定的命名空间中，请切换到该命名空间。 导航到 Globals 页面(System Explorer（系统资源管理器） > Global)。您应该会看到在示例代码中创建的 testglobal。点击 VIEW 来查看其内容。 您应该会看到 global 的两个节点：^testglobal(1) = 8888 和 ^testglobal(2) = 9999。 了解有关 IRIS Native 的更多信息 有关 IRIS Native、globals 和 InterSystems IRIS 的更多信息，请参见： 用于.Net的 Native API 技术概要:用于Java的 InterSystems IRIS Native API 使用 Globals 用于.NET 的 InterSystems Managed Provider

照顾好我们的客户并打造伟大的产品。这是我们InterSystems自从1978年成立以来的座右铭。40多年很快过去，这始终驱动着我们前进。过去是，未来也将一直是我们的基因。 追求卓越和持续提升的价值观是我们的“客户至上”方法取得成功的关键。这也是过去三年我们一直积极参与Gartner及其Peer Insights项目的原因，该项目主要征求最终用户的反馈意见和对厂商的打分。InterSystems连续两年荣膺Peer Insights运营数据库管理系统（ODBMS）客户选择奖，而且是该类别评分最高的供应商之一。 此外，InterSystems还入选Gartner目前推出的Gartner“客户至上”计划，并获得相应标识（上图），这一计划认可了我们为客户提供的坦诚分享、公正反馈的环境，根据用户反馈，我们不断改善产品和服务，从而最大程度地满足不断变化的客户需求。简言之，我们没有人为影响客户在Gartner网站上对我们的评价。这体现了我们对客户的承诺以及开放沟通渠道的重要性。InterSystems IRIS®数据平台是Gartner最新的云数据库管理系统魔力象限（Cloud Database Management Systems Magic Quadrant）中唯一获得此标识的产品，我们对此深感自豪。 以客户为中心的基因DNA 在我尚未加入InterSystems前，作为一家医学实验室的IT人员，我曾体验到InterSystems的“客户至上”。当时，我们还与另一家供应商合作，但他们的支持服务并不理想——我们需要等待很长时间；需要向很多人重复说明问题，而这些人并不能解决问题；我们还需要不断进行身份验证。他们的服务与其说是提供帮助，不如说是让人筋疲力尽，我认为他们从未将我的利益放在心上。 而InterSystems提供了天壤之别的客户体验。我第一次遇到问题呼叫InterSystems支持中心时，一位名叫Terry的人立刻接通了电话。他没有让我验证身份，而是让我解释了一下问题，并一直在线提供支持直到问题得到解决。当时我并不知道这位Terry居然就是InterSystems的创始人兼首席执行官（现在仍是）。显然，对InterSystems来说，最重要的事情是解决问题、让客户满意。尽管现在许多事情已经发生了改变（我们现在有不同人员负责处理服务请求了），但我们依然坚持这一理念。（注明：作者在1984年加入Intersystems 公司，这段故事发生在将近40年前公司刚刚成立的时候） 每周一上午，InterSystems总部都会召开高管例会，然而会议重点并非是公司的销售指标或收入，而是探讨如何通过改善产品、业务模式和支持服务来增强客户的成功。会议至少有一半的时间是在讨论客户支持服务——哪位客户提出了问题、我们是如何解决的、客户是否满意等等。 我们将客户支持作为我们的一大亮点，因为它能够彰显我们帮助客户成功的热情。如果我们能够助力客户实现自身目标，这比签署了一笔大单更有价值。这能够培育不可复制的客户信任。我们现在的客户留存率在99%以上，结果不言自明。 “如果你不清楚应该帮助客户还是帮助公司，那么请选择帮助客户。”——Terry Ragon，InterSystems CEO 未来之路 我们对获得Gartner的“客户至上”标识深感自豪。对我们而言，这不仅是又一次的认可，更是一个信号——我们正沿着正确的方向为用户提供卓越客户服务，其结果和客户口碑能说明一切。 借助Gartner的帮助，我们希望继续努力提供尽可能最佳的客户支持，我们的员工配备也反映了这一目标。我们授予支持团队与工程师和开发人员同等重要的权利，这样他们就可以为客户做出重要决定，而不必来回请示。对InterSystems而言，这不仅是客户支持的未来之路，也是我们提供最佳产品和服务的前进方向。 注：作者John Paladino是InterSystems负责客户服务的全球副总裁。自1984年加入InterSystems以来，他帮助开发了自动化支持跟踪系统和针对所有InterSystems软件产品的客户培训项目，制定并实施了旨在改善响应性、提高客户满意度的服务标准，并主导多个国内外团队建设计划。在加入InterSystems之前，他曾在New England Pathology担任三年的系统工程经理，负责获取、实施和管理各类信息技术。Paladino曾在伍斯特理工学院和马萨诸塞大学卢维尔分校攻读电机工程专业。 博客原文：How Can Putting the Customer First Drive Excellence and Innovation? 微信公众号原文：深深植根于InterSystems的DNA中，客户至上理念如何推动卓越与创新？ 欢迎大家参与评审给我们提供宝贵意见：参与gartner-peer-insights同业评审，赢取价值25美元的礼品卡

InterSystems IRIS数据平台深度支持Python，令您随心所愿！

目录 技术概要： 基于角色的访问控制 1 基于角色的访问控制：为什么它很重要？ 1 基于角色的访问控制：如何在 InterSystems IRIS 中工作 1 简要概念概述 1 示例用例 2 基于角色的访问控制：探索它 3 用前须知 3 发现管理门户（Management Portal）页面访问所需的资源 3 创建和分配您自己的管理者角色 4 创建用户并分配新角色 5 尝试管理门户（Management Portal）中的角色 6 了解有关基于角色的访问控制的更多信息 7 技术概要：基于角色的访问控制 本文档向您介绍基于角色的访问控制，解释它在 InterSystems IRIS®数据平台中的工作原理，并帮助您亲自探索。 要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些，请参见 InterSystems First Looks（《InterSystems 技术概要》）。 基于角色的访问控制：为什么它很重要？ 当您首次开始使用一个新的数据库平台时，有件事情可能很快就会变得清晰起来：您可能不希望企业中的所有用户都查看和更改系统上的所有内容。 InterSystems IRIS 和所有的数据库平台一样，允许您精细指定 InterSystems IRIS 的每个用户可以执行的操作。我们用来控制用户授权（authorization）执行操作的机制被称为基于角色的访问控制（role-based access control）。 如果您已经熟悉了基于角色的访问控制，InterSystems IRIS 方案很可能与您以前使用过的一些方案相似。您会在下一节找到有关我们如何处理它的更多细节。 如果您是基于角色的访问控制的新手，这意味着比旧的访问控制方法节省时间，因为旧的访问控制方法没有提供执行系统操作的权限分组。 如果没有基于角色的访问控制，为每个用户逐个分配使用 InterSystems IRIS 的各个方面的权限可能需要数小时甚至数天。然后，如果有新员工需要访问，您将不得不重复这个过程。 基于角色的访问控制允许您在初始配置 InterSystems IRIS 时将权限分组到角色中。然后，您可以为每个系统用户分配一个或多个现成的角色。您还可以使用或修改一组预定义的角色<span id="2_Role-Based_Access_Control:_How_It_Work" class="anchor"></span>。 此外，通过基于角色的访问控制，如果用户需要使用一组新的权限，则可以将该组权限分组为一个角色，并将该角色分配给用户。而且您可以随时改变角色内的权限列表。 基于角色的访问控制: 如何在 InterSystems IRIS 中工作 InterSystems IRIS 为基于角色的访问控制提供了一个完整的解决方案，我们将在本节中对此进行描述。InterSystems IRIS 支持的每一种认证机制，包括 LDAP、Kerberos 和 OS-based，都可以使用本地 InterSystems 基于角色的访问控制。如果您愿意，您可以使用 LDAP 而不是 InterSystems IRIS 进行角色分配。 简要概念概述 把 InterSystems IRIS 中的信息和功能视为您要保护的资产 ，就像您为属于您的资产投保一样。 基于角色的访问控制：如何在 InterSystems IRIS 内部工作 在 InterSystems IRIS 中被视为资产的项目包括： 数据库，将数据和代码作为对象存储。 服务，控制用户连接到 InterSystems IRIS 的能力。 某些管理权限。 InterSystems IRIS 应用程序，包括管理门户（Management Portal）中的各个页面，它是 InterSystems IRIS 的系统管理用户界面。 在 InterSystems IRIS 中，每项资产（asset）都由一个资源**（resource）来表示，一个资源（resource）可以表示多个资产（asset）。 资源（resource）充当它所代表的资产（asset）的看门人：根据资源类型，它与 "读取"、"写入"（包括读取），和在某些情况下的 "使用"（执行）权限（permission） 配对。例如，数据库只存在两种类型的权限：读取，允许查看数据和执行例程；写入，允许修改数据。 资源与权限的配对被称为权限（privilege），权限按角色（role）分组。 最后，角色（role）被分配给 InterSystems IRIS 中的用户（user） 。每个用户（user）在首次使用 InterSystems IRIS 进行认证时，都会有一个或多个角色（role）分配给他们。可以在会话期间向用户添加或删除角色（role）。 基于角色（role）的访问控制的具体授权方式取决于您所选择的认证机制。在线文档中完全涵盖了授权的这方面内容。 提示：对于内部测试和暂存系统，您可能不希望设置基于密码的认证或基于角色（role）的不同级别的访问控制。如果您使用 "最低（minimal）" 安全性来安装您的实例，这个选项是可用的，默认情况下，它给拥有实例的管理门户（Management Portal） URL 的任何人提供完全管理权限。 示例用例 如上所述，管理门户（Management Portal）中的各个页面是 InterSystems IRIS 中您可以保护的资产（asset）。管理门户（ Management Portal）允许用户（user）查看和执行 InterSystems IRIS 基本方面的操作，如 globals、命名空间，甚至资源（resource）和角色（role）本身。 下面的屏幕截图显示了当实例的管理员使用安装时创建的 _SYSTEM 帐户登录时，管理门户（Management Portal）的外观和行为。 _SYSTEM 用户可以访问 System Administration（系统管理） > Security（安全）> Users（用户） ，让他们可以查看和修改任何用户（user）及其角色（role）。 您可能想限制某些管理门户（Management Portal）用户的角色（role）分配，使他们不能查看或修改用户（user）帐户或任何其他对安全至关重要的信息。在下一节，我们将告诉您如何做到这一点。 基于角色的访问控制: 探索它 下面的示例向您展示了如何设置两种类型的"管理者"角色，以便在管理门户（Management Portal）中使用。第一个角色将能够访问允许修改用户和角色定义等安全相关项的页面。第二个角色将没有这个访问权限。 然后您会看到拥有这些角色的用户如何与管理门户（Management Portal）交互。 重要提示： 为了让您体验 InterSystems IRIS，而又不陷入细节的困境，我们保持了简单的探索。例如，我们让您尽可能多地使用默认设置。 但是，当您把 InterSystems IRIS 引入您的生产系统时，您需要做很多不同的事情，特别是（但不限于）安全方面。 所以请确保不要把这种对 InterSystems IRIS 的探索与真实的情况相混淆！本文档末尾提供的参考资料将使您对在生产中使用 InterSystems IRIS 的情况有一个很好的了解。 用前须知 要使用该程序，您需要一个正在运行的 InterSystems IRIS 实例。您的选择包括多种类型的已授权的和免费的评估实例；该实例不需要由您正在工作的系统托管（尽管它们必须相互具有网络访问权限）。关于如何部署每种类型的实例的信息（如果您还没有可使用的实例），请参见 InterSystems IRIS Basics: Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中的 Deploying InterSystems IRIS（部署 InterSystems IRIS）。使用同一文档中的 InterSystems IRIS Connection Information（InterSystems IRIS 连接信息）和 .Net IDE 中的信息将 Visual Studio 连接到您的 InterSystems IRIS 实例。 发现管理门户（Management Portal）页面访问所需的资源 对管理门户（Management Portal）中的每个页面的访问都受到至少一种资源的保护。您可以通过以下方式发现所需的资源： 使用 InterSystems IRIS Basics:Connecting an IDE（《InterSystems IRIS 基础：连接一个 IDE》）中URL described for your instance（为您的实例描述的 URL），在浏览器中打开您的实例的管理门户（Management Portal）。 通过点击相应菜单项中的每一个单词，导航至 System Administration（系统管理） > Security（安全）。 基于角色的访问控制：探索它 提示： 在管理门户（Management Portal）中，带有子页面的菜单项在其名称旁边包含 >>。页面没有这样的标记。 在 Users（用户） 菜单项中，点击"用户（Users）"一词右侧的任何位置。这个操作显示查看 Users（用户）页面所需的资源，即 %Admin_Secure。(Security（安全） 和 Encryption（加密） 子菜单中的所有页面都需要 %Admin_Secure 资源上的使用权限（"U"）。) 导航至 System Administration（系统管理） > Configuration（配置） > System Configuration（系统配置）。 点击"内存和启动（Memory and Startup）"右侧的任何位置。您会看到，查看该页面所需的资源是 %Admin_Manage。 创建和分配您自己的管理者角色 对于管理门户（Management Portal）的 System Administration（系统管理）菜单内的页面，您需要具有 %Admin_Secure 和 %Admin_Manage 资源权限的角色。 鉴于这种结构，您可能希望创建两个反映管理级别的角色，一个是可以访问除安全相关页面以外的所有页面，另一个是可以执行所有操作，包括安全相关的操作。您可以使用预定义的 %Managerrole 作为模板。 使用 _SYSTEM 帐户登录管理门户（Management Portal）。 导航至 System Administration（系统管理） > Security（安全） > Roles（角色） ，并点击 Go。您将看到安装了 InterSystems IRIS 的角色列表，包括 %Manager 角色。 点击 %Manager 链接。 General（常规） 标签显示具有此角色的用户可用的权限（与权限配对的资源）。 在权限中，您会看到 %Admin_Secure 和 %Admin_Manage 上的使用权限。 您也会看到许多其他的权限。这是因为您需要访问许多不同的资源，才能够查看和修改 InterSystems IRIS 设置。既然我们知道只有一种关键资源 %Admin_Secure，在 System Administration（系统管理）的安全相关页面的访问方面，对该资源的访问将是我们两个自定义角色之间的唯一区别。 点击 Cancel（取消） (在 Edit %Manager 下面)，返回到主 Roles（角色）页面。 创建 "标准管理者"角色 在 Roles（角色）页面上，点击 Create New Role（创建新角色）。将出现一个角色定义页面。 基于角色的访问控制：探索它 在 Name（名称） 字段中，输入"Standard_Mgr"。 在 Copy from（复制自） 下拉菜单中，选择 %Manager。这将复制所有信息，包括权限，从预定义 %Manager 角色到新角色。 将描述更改为您所选择的描述，例如："Role for System Administration without security access（不具有安全访问权限的系统管理角色）"。 点击 Save（保存）。将出现一条 Role saved（保存角色） 信息，您将在 General（常规）标签中看到新角色的权限列表。 在 %Admin_Secure 行中，点击 Delete（删除）。这就从角色中删除了权限。 再次点击 Save（保存） 来保存更改。 创建"安全管理员"角色 在 Roles（角色）页面上，点击 Create New Role（创建新角色）。将出现一个角色定义页面。 在 Name（名称） 字段中，输入"Security_Mgr"。 在 Copy from（复制自）下拉菜单中，选择 %Manager。这将复制所有信息，包括权限，从预定义 %Manager 角色到新角色。 将描述更改为您所选择的描述，例如："Role for System Administration with securityaccess（具有安全访问权限的系统管理角色）" 点击 Save（保存）。将出现一条 Role saved 信息，您将在 General（常规）标签中看到新角色的权限列表。 创建用户并分配新角色 要查看角色的运行情况，需要创建两个用户，每个用户对应一个新角色。 使用 _SYSTEM 帐户登录管理门户（Management Portal）。 导航至 System Administration（系统管理） > Security（安全） > Users（用户），并点击 Go。您将看到安装了 InterSystems IRIS 的用户定义列表。 创建"标准管理员"用户 在主 Users（用户） 页面上，点击 Create New User（创建新用户）。将出现一个用户定义页面。 在 Name（名称） 字段中，输入"Std_Mgr"。(用户的名称不能与角色的名称一致)。 在 Password（密码） 和 Password (confirm)（确认密码） 字段中，输入您选择的密码。 点击 Save（保存）。将出现一条 User saved 信息。 点击 Roles（角色）标签。滚动左侧的 Available 列表，并高亮显示 Standard_Mgr（标准管理员）。 点击右箭头 ，将该角色添加到 Selected（已选）列表中。然后点击"Assign（分配）"。 7. 点击 Cancel（取消） 以返回到主 Users（用户）页面。 创建"安全管理员"用户 在主 Users（用户） 页面上，点击 Create New User（创建新用户）。将出现一个用户定义页面。 在 Name（名称） 字段中，输入"Sec_Mgr"。 在 Password（密码） 和 Password (confirm)（确认密码） 字段中，输入您选择的密码。 基于角色的访问控制：探索它 点击 Save（保存）。将出现一条 User saved 信息。 点击 Roles（角色）标签。滚动左侧的 Available 列表，并高亮显示 Security_Mgr（安全管理员）。 点击右箭头，将该角色添加到 Selected（已选）列表中。然后点击 Assign（分配）。 点击 Cancel（取消） 以返回到主 Users（用户）页面。 尝试管理门户（Management Portal）中的角色 以 Std_Mgr 用户（标准管理员用户）登录管理门户（Management Portal）。您将看到，与安全有关的菜单选项是灰色的，正如预期的那样。Interoperability（互操作性）菜单选项也是灰色的，因为从其中复制两个自定义角色的预定义 %Manager 没有访问这些页面所需的权限。 退出，然后以 Sec_Mgr 用户（安全管理员用户）重新登录。 正如您所看到的，这个用户具有对 System Administration（系统管理） > Security（安全）和 System Administration（系统管理） > Encryption（加密） 子菜单中的页面的完全访问权限。 了解有关基于角色的访问控制的更多信息 要了解有关基于角色的访问控制和 InterSystems IRIS 安全模型的更多信息，请参见： About InterSystems Security（《有关 InterSystems 安全》）中的 "Authorization:Controlling User Access（授权：控制用户访问）"一节 InterSystems IRIS Programming Orientation Guide（《InterSystems IRIS 编程指南》）中的 "InterSystems IRIS Security（InterSystems IRIS 安全）"和 "Namespaces and Databases（命名空间和数据库）"部分 --- 为应用程序开发人员提供有关基于角色的访问控制的信息。 Security Tutorial（《安全教程 》）中的 "Authorization（授权）"部分 --- 创建用户、角色和权限的逐步说明。

这是InterSystems 2022年全球峰会上来自客户 Cognetivity Neuroscience 的分享。InterSystems IRIS 数据平台助力 Cognetivity Neurosciences 打造脑健康管理评估工具CognlCA。CognlCA 能够在正确的时间将数据提供给正确的人，推动脑健康评估、筛查和管理的节点前置，从而促进脑健康管理的普惠化。

# 第四十三章 使用多个 IRIS 实例（三） # `Windows` 上的 `iris` 命令 在 `Windows` 上，必须从 `install-dir\bin` 目录运行 `iris` 命令（或在命令中包含完整路径）。 - `iris all` 列出所有已安装实例的摘要信息，每行一个实例，如下所述。 注意：如果需要完整的信息，例如用于解析或报告目的，请使用 `iris list`。 ```java C:\InterSystems\IRISHealth\bin>iris all Instance Version ID Port Directory ------------- ---------- ---- --------- up irishealth 2022.1.0.114.0 51773 c:\intersystems\irishealth ``` - `iris allw` 为每个实例列出与 `iris all` 相同的信息，而不包含长字段值。可能会产生超过 `80` 个字符的行。 ```java C:\InterSystems\IRISHealth\bin>iris allw Instance Name Version ID Port Directory ------------------------------- ---------------------------- ----- -------------------------------- up irishealth 2022.1.0.114.0 51773 c:\intersystems\irishealth ``` - `iris console instname [arguments]` 在操作系统命令窗口而不是终端窗口中打开 `Terminal` 。  - `iris force instname` 强制关闭实例。 - `iris help` 显示有关 `iris` 命令的最新信息。 ```java C:\InterSystems\IRISHealth\bin>iris help usage: iris start [] to start instance , optionally using the specified .cpf file. An optional /EmergencyId=Username,Password can be used to start InterSystems IRIS in emergency mode. When the EmergencyId argument is supplied, the system starts up in emergency mode in which only the baseline databases are mounted and access to InterSystems IRIS is governed by InterSystems IRIS login using that username and password. Emergency mode is supplied to give access in the event that privileged users are not available or their password is forgotten. Emergency startup is only available from an administrator account. When InterSystems IRIS is started in emergency mode, the IRIS control service is not used. This means that if you log out of Windows, all the InterSystems IRIS processes will immediately exit. or: iris startnostu to start instance without running ^STU. or: iris stop to shut down instance . or: iris stopnoshut to shut down instance without running user shutdown routines. or: iris stopstart to shut down and restart instance . Note: An optional /nofailover argument can be specified for stop, stopnoshut, or stopstart to not trigger a mirror failover. or: iris force to force down instance . or: iris [ run OR console OR terminal ] to run InterSystems IRIS in programmer mode with [ no-device OR console OR terminal ] for $Principal. or: iris [ run OR console OR terminal ] to run InterSystems IRIS routine in application mode with [ no-device OR console OR terminal ] for $Principal. or: iris [ run OR console OR terminal ] to run InterSystems IRIS routine in in application mode with [ no-device OR console OR terminal ] for $Principal. or: iris runw [] to run InterSystems IRIS routine in application mode with no input/output device for $Principal using the optional namespace. When run from a batch script, iris will wait for the InterSystems IRIS process to terminate before returning. The exit code from the InterSystems IRIS process will be returned by iris. Note: An optional /Title="Title string" can specify the console or terminal title bar text. or: iris iristraystart to start IRISTray for instance . or: iris iristraystop to stop IRISTray for instance . or: iris licmanagerstop to stop licmanager running in instance . or: iris all [> outputfile] to list all installed instances. or: iris allw [> outputfile] to list (wide format) all installed instances. or: iris list [] [> outputfile] to list information about all installed instances or the specified instance. or: iris qlist [] [> outputfile] to display a quick list of information about all installed instances or the specified instance, in a format suitable for parsing in command scripts. The record for an instance contains fields separated by "^" (carats): Field 1: instance name Field 2: instance directory Field 3: version identifier Field 4: current status for the instance Field 5: configuration file name last used Field 6: SuperServer port number Field 7: WebServer port number Field 8: JDBC Gateway port number Field 9: Instance status (e.g., ok, warn, alert) Field 10: Product name of the instance Field 11: Mirror Member Type (e.g., Failover, Disaster Recovery) Field 12: Mirror Status (e.g., Primary, Backup, Connected) or: iris serverlist [> outputfile] to list information about all defined servers. Note: When [> outputfile] is present, output is redirected to the file instead of being displayed on the terminal. or: iris telnetstop to stop the InterSystems IRIS TELNET daemon. or: iris telnettrace to toggle the TELNET trace state. or: iris iristrmdstop to stop the InterSystems IRIS terminal daemon. Note: iris often displays error information in a message box. You can suppress the message box containing error information by adding "quietly" (without the quotation marks) as the final argument to the iris command. or: iris help [display] to show this help. If display is specified the help is displayed in a browser window. ``` - `iris list [arguments]` 显示有关已安装 `IRIS` 实例的信息，如下所述。 ```java C:\InterSystems\IRISHealth\bin>iris list irishealth Instance 'irishealth' (Custom installation) directory: 'C:\InterSystems\IRISHealth' versionid: '2022.1.0.114.0' conf file: 'c:\intersystems\irishealth\iris.cpf' (SuperServer port = 51773, WebServer port = 52773) status : 'running, since Mon Sep 12 08:08:58 2022' Product : InterSystems IRISHealth ``` `instname` — 可以选择指定 `IRIS` 实例名称以仅显示有关该实例的信息。例如，`iris list MyIRIS` 仅显示有关 `MyIRIS` 实例的信息。 - `iris qlist [参数]` 与 `iris list` 类似，但有附加信息。每个实例的输出（如下所述）在一行中给出，字段由插入符号 (`^`) 分隔。 `instname` — 可以选择指定 `IRIS` 实例名称以仅显示有关该实例的信息。例如，`iris qlist MyIRIS` 仅显示有关 `MyIRIS` 实例的信息。 ```java C:\InterSystems\IRISHealth\bin>iris qlist irishealth irishealth^C:\InterSystems\IRISHealth^2022.1.0.114.0^running, since Mon Sep 12 08:08:58 2022^c:\intersystems\irishealth\iris.cpf^51773^52773^^^IRISHealth^^ ``` - `iris run instname [arguments]` 在没有 `$Principal` 的输入/输出设备的程序员模式下运行 IRIS。 - `iris runw instname 例程 [参数]` 在应用程序模式下运行命名的 `IRIS` 例程，没有 `$Principal` 的输入/输出设备。从批处理脚本运行时，该命令会等待 `IRIS` 进程终止，然后再从进程返回退出代码。 `namespace` — 在指定的命名空间中运行例程。 注意：如果使用指定了启动命名空间的用户帐户启动 `IRIS`，则命名空间参数无效（请参阅用户帐户属性）。 - `iris start instname [参数]` 启动实例。 注意：系统可能会提示以“紧急模式”启动。 完整的 `CPF` 路径 — 默认情况下， `IRIS` 从位于 `<install-dir>/mgr` 目录中的 `iris.cpf` 文件中读取某些设置。可以提供另一个 `.cpf` 文件的完整路径以供使用。 - `iris startnostu instname` 启动指定的实例而不运行`^STU`。 - `iris stop instname [参数]` 关闭实例。 `/nofailover` — 指定此可选参数以防止触发镜像故障转移。 - `iris stopnoshut instname [参数]` 使用 `INTNOSHUT^SHUTDOWN` 关闭命名实例。 **注意：只有实例所有者和 `irisusr` 可以在不登录终端的情况下运行 `INTNOSHUT^SHUTDOWN`。** `/nofailover` — 指定此可选参数以防止触发镜像故障转移。 - `iris stopstart instname [参数]` 关闭实例后启动它。 `/nofailover` — 指定此可选参数以防止触发镜像故障转移。 - `iris terminal instname [参数]` 打开实例的 `Terminal` 。 `routine` — 在终端中以应用程序模式为 `$Principal` 运行命名的 `IRIS` 例程。 `"[label[+offset]]^routine"` — 指定要在用户模式下运行的 `ObjectScript` 程序的名称。除了指定的格式之外，还可以传递由字符串和`/`或数字文字组成的参数列表，以及省略的 (`void`) 参数，如下所示： - `"routine[([parameter-list])]"` - `"[label]^routine[([parameter-list])]"` - `"##CLASS(package.class).method[([parameter-list])]"` 其中，例如，参数列表以“`string literal`”的形式指定，`-+-000123.45600E+07`，省略的参数作为 `$Data(parameter)=0` 传递给目标。 注意：空格和 `shell` 元字符必须以依赖于操作系统的形式引用。 命名空间 — 与例程一起使用，在指定的命名空间中运行例程。 注意：如果您用指定了启动命名空间的用户帐户启动 `IRIS`，则命名空间无效（请参阅用户帐户属性）。 ## iris list, qlist, and all #### `iris all` 列出有关一个或多个 `IRIS` 实例的以下信息： - 实例状态，如下 - ``（状态不可用，登录已禁用） - `dn`（关闭或已崩溃） - `up` (running) - `st` (starting or stopping) - 实例名称 - `IRIS` 版本 - 超级服务器端口号 - 安装目录 #### `iris list` 列出有关一个或多个 `IRIS` 实例的以下信息： - 实例名称（和安装类型） - 安装目录 - `IRIS` 版本 - `IRIS` 参数 (`.cpf`) 文件的路径名 - 超级服务器和网络服务器端口号 - 实例状态，如下 - `running` - `down` - `starting or stopping` - 不完整的启动或停止，登录被禁用 - 实例的系统健康状态，如果正在运行（不包括在 `Windows` 中） - 镜像成员类型和状态（如果是镜像成员） #### iris qlist 为一个或多个 `IRIS` 实例在单行上输出以下信息，以插入符号 (`^`) 分隔： 1. 实例名称（和安装类型） 2. 安装目录 3. `IRIS`版本 4. 实例状态 5. 当前配置参数文件的路径名，相对于安装目录。 `Windows` 系统改为显示完整路径。 6. 超级服务器端口号 7. 网络服务器端口号 8. `JDBC` 网关端口号 9. 实例的系统健康状态，如果正在运行（在 `Windows` 上总是空白） 10. 产品名称 11. 镜像成员类型（如果是镜像成员） 12. 镜像状态（如果是镜像成员） 13. 数据目录（如果适用）

InterSystems 已修复了一个缺陷，该缺陷可能会导致使用 IBM POWER8 或更高版本的 POWER 处理器的 AIX 系统上的数据库和Journal日志文件损坏。只有在使用数据库或Journal日志加密时才会触发此缺陷。 当满足以下条件时，会触发此缺陷： 该环境使用数据库或Journal日志加密 该环境还使用数据元素加密 用于数据元素加密的加密密钥已停用 如果环境满足所有这些条件，则用于数据库或Journal日志加密的密钥计划可能会被损坏。 该缺陷存在于以下产品和基于这些产品的任何 InterSystems 产品中： InterSystems IRIS ® –除 2022.1.3 和 2023.1 之外的所有版本 InterSystems IRIS for Health ™ ——除 2022.1.3 和 2023.1 之外的所有版本 HealthShare ® Health Connect –除 2022.1.3 和 2023.1 之外的所有版本 HealthShare ®解决方案——所有版本 请注意，此缺陷不会直接影响 HealthShare 解决方案，因为它们不使用数据元素加密功能。但是，如果 HealthShare 环境有一个使用上述数据元素加密功能的客户化定制，则它们必须遵循此警报中提供的补救措施。 InterSystems Caché® 和 InterSystems Ensemble® –从 2015.1 开始的所有版本 此缺陷的修复被标识为 RJF540，并将包含在所有未来版本中。 该修复也可以通过补丁Ad hoc 分发获得。 如果您对此警报有任何疑问，请联系全球响应中心。

开发者您好！ 这里向介绍@Lorenzo Scalese的OpenAPI-Suite （一个用于从OpenAPI 3.0生成 ObjectScript 代码的工具集）。这个工具集在 2023 年 InterSystems 开发工具大赛的21 个参赛作品中获得专家提名第三名。 目前 IRIS 最高支持OpenAPI 2.0 ，但是这个工具支持 OpenAPI 3.0 ！ 提供的功能如下。 在服务器端创建类（与 OpenAPI 2.0相同，首先创建使用 API First理念创建的 REST 调度类所需的类。） 创建客户端 HTTP 类 创建客户端Production（业务服务、业务流程、业务操作、Ens.Request、Ens.Response） 一个 Web 界面，允许您指定要从此工具生成哪些功能 从 OpenAPI 1.x、2.x 到 3.0 版的转换工具 关于各个功能的详细介绍，请参考@Lorenzo Scales撰写的文章《 OpenAPI Suite - Part 1 》和《 OpenAPI Suite - Part 2 》。 在本文中，我尝试了 1 个功能。其中，以下的应对方案非常好。 根据OpenAPI 3.0新增的Components对象的内容自动生成类的定义（在指定包下创建一个模型包，在那里创建可以实例化的类） 在POST或PUT的情况下，为了较为轻松地使用实施类（impl.cls）处理HTTP请求中传递的信息，我将Body中接收到的JSON数据设为了1中生成的类的实例， 目前，虽然需要进行一些手动更改，但是仅使用按原样创建的实例在 impl.cls 中叫 %Save() 方法也可以保存成功。 ) IRIS 提供了一种根据 OpenAPI 2.0 规范创建 REST 调度类的方法，但实际使用中它只创建要使用的类和根URL。 仅作为参考，这里是使用 IRIS 支持的 OpenAPI 2.0 创建的内容。 （以下示例使用了根据 OpenAPI2.0 规范创建的 JSON 示例。） 在下面的示例中，/crud 是根 URL，类是在 crud 包下创建的。​​​​​​ 生成的类如下（左：impl.cls，右：spec.cls） 由于调度类（disp.cls）是一个不需要改动的类，所以这里展示了studio的这部分代码。 接下来介绍一下@Lorenzo Scalese的OpenAPI-Suite的成果。 使用它的过程非常简单。 从管理门户或Studio导入IPM （InterSystems Package Manager，以前称为 ZPM）客户端工具后，您只需运行以下命令，工具就可以使用了。 客户端工具导入可以导入到任意命名空间中。 从管理门户导入时，使用以下菜单： 管理门户 -> 系统资源管理器 -> 类 -> 选择要导入的命名空间 -> 单击导入按钮 转到您希望 REST 调度类存在的命名空间，并使用 ZPM 命令安装工具。 zpm "install openapi-suite" 安装过程中的画面显示 USER>zpm “安装 openapi-suite” [USER|sslclient] 重新加载开始 (/usr/irissys/mgr/.modules/USER/sslclient/1.0.4/)[用户|sslclient] 重新加载成功[sslclient] 模块对象已刷新。[USER|sslclient] 验证开始[USER|sslclient] 验证成功[USER|sslclient] 编译开始[用户|sslclient] 编译成功[USER|sslclient] 激活开始[USER|sslclient] 配置开始[用户|sslclient] 配置成功[USER|sslclient] 激活成功[USER|yaml-utils] 重新加载开始 (/usr/irissys/mgr/.modules/USER/yaml-utils/0.1.2/)[USER|yaml-utils] 重新加载成功[yaml-utils] 模块对象已刷新。[USER|yaml-utils] 验证开始[USER|yaml-utils] 验证成功[USER|yaml-utils] 编译开始[USER|yaml-utils] 编译成功[USER|yaml-utils] 激活开始[USER|yaml-utils] 配置开始[USER|yaml-utils] 配置成功[USER|yaml-utils] 激活成功[USER|swagger-validator-cli] 重新加载开始 (/usr/irissys/mgr/.modules/USER/swagger-validator-cli/0.0.1/)[USER|swagger-validator-cli] 重新加载成功[swagger-validator-cli] 模块对象已刷新。[USER | swagger-validator-cli] 验证开始[USER|swagger-validator-cli] 验证成功[USER|swagger-validator-cli] 编译开始[USER|swagger-validator-cli] 编译成功[USER|swagger-validator-cli] 激活 START[USER|swagger-validator-cli] 配置开始[USER|swagger-validator-cli] 配置成功[USER|swagger-validator-cli] 激活成功[USER|swagger-converter-cli] 重新加载开始 (/usr/irissys/mgr/.modules/USER/swagger-converter-cli/0.0.2/)[USER|swagger-converter-cli] 重新加载成功[swagger-converter-cli] 模块对象已刷新。[USER | swagger-converter-cli] 验证开始[USER|swagger-converter-cli] 验证成功[USER|swagger-converter-cli] 编译开始[USER|swagger-converter-cli] 编译成功[USER|swagger-converter-cli] 激活开始[USER|swagger-converter-cli] 配置开始[USER|swagger-converter-cli] 配置成功[USER|swagger-converter-cli] 激活成功[USER|objectscript-openapi-definition] 重新加载开始 (/usr/irissys/mgr/.modules/USER/objectscript-openapi-definition/1.3.1/)[USER|objectscript-openapi-definition] 重新加载成功[objectscript-openapi-definition] 模块对象已刷新。[USER|objectscript-openapi-definition] 验证开始[USER|objectscript-openapi-definition] 验证成功[USER|objectscript-openapi-definition] 编译开始[USER|objectscript-openapi-definition] 编译成功[USER|objectscript-openapi-definition] 激活开始[USER|objectscript-openapi-definition] 配置开始[USER|objectscript-openapi-definition] 配置成功[USER|objectscript-openapi-definition] 激活成功[USER|io-redirect] 重新加载开始 (/usr/irissys/mgr/.modules/USER/io-redirect/1.0.2/)[USER|io-redirect] 重新加载成功[io-redirect] 模块对象已刷新。[USER|io-redirect] 验证开始[USER|io-redirect] 验证成功[USER|io-redirect] 编译开始[USER|io-redirect] 编译成功[USER|io-redirect] 激活开始[USER|io-redirect] 配置开始[USER|io-redirect] 配置成功[USER|io-redirect] 激活成功[USER|openapi-common-lib] 重新加载开始 (/usr/irissys/mgr/.modules/USER/openapi-common-lib/1.0.0/)[用户|openapi-common-lib] 重新加载成功[openapi-common-lib] 模块对象已刷新。[USER|openapi-common-lib] 验证开始[USER|openapi-common-lib] 验证成功[USER|openapi-common-lib] 编译开始[USER|openapi-common-lib] 编译成功[USER|openapi-common-lib] 激活开始[USER|openapi-common-lib] 配置开始[USER|openapi-common-lib] 配置成功[USER|openapi-common-lib] 激活成功[USER|openapi-server-gen] 重新加载开始 (/usr/irissys/mgr/.modules/USER/openapi-server-gen/1.0.0/)[USER|openapi-server-gen] 重新加载成功[openapi-server-gen] 模块对象已刷新。[USER|openapi-server-gen] 验证开始[USER|openapi-server-gen] 验证成功[USER|openapi-server-gen] 开始编译[USER|openapi-server-gen] 编译成功[USER|openapi-server-gen] 激活开始[USER|openapi-server-gen] 配置开始[USER|openapi-server-gen] 配置成功[USER|openapi-server-gen] 激活成功[USER|openapi-client-gen] 重新加载开始 (/usr/irissys/mgr/.modules/USER/openapi-client-gen/2.1.0/)[USER|openapi-client-gen] 重新加载成功[openapi-client-gen] 模块对象已刷新。[USER|openapi-client-gen] 验证开始[USER|openapi-client-gen] 验证成功[USER|openapi-client-gen] 编译开始[USER|openapi-client-gen] 编译成功[USER|openapi-client-gen] 激活开始[USER|openapi-client-gen] 配置开始[USER|openapi-client-gen] 配置成功[USER|openapi-client-gen] 激活成功[USER|openapi-suite] 重新加载开始 (/usr/irissys/mgr/.modules/USER/openapi-suite/1.0.0/)[用户|openapi-suite] 重新加载成功[openapi-suite] 模块对象已刷新。[USER | openapi-suite] 验证开始[USER|openapi-suite] 验证成功[USER|openapi-suite] 编译开始[USER|openapi-suite] 编译成功[USER | openapi-suite] 激活开始[USER|openapi-suite] 配置开始[USER|openapi-suite] 配置成功[USER|openapi-suite] 激活成功用户> 安装后，您可以通过以下 URL 访问该工具的相关信息。 http://localhost:端口号/openapisuite/ui/index.csp 示例）http://localhost:52773/openapisuite/ui/index.csp 在初始阶段，屏幕右下方的“Install On Server”按钮无法按下。似乎可以通过将值设置为以下全局变量来按下按钮。 （请在你安装工具的命名空间中用ZPM命令设置） Set ^openapisuite .config( "web" , "enable-install-onserver" ) = 1 准备工作完成后，进行以下设置。 对于“Application package name”，选择类定义的包名称（示例中的 PetStore）；对于“What do you want to generate?”问题，选择“REST Server”；对于“NameSpace”，选择要注册 REST 调度类的命名空间；对于“Web 应用程序名称”，指定已定义的根 URL（Web 应用程序路径）（示例中的 /pet1）。 之后，只需指定根据OpenAPI规范创建的JSON文件即可。示例中默认指定https://petstore3.swagger.io/api/v3/openapi.json ，我们可以直接使用这个文件路径。 最后，单击 Install On Server 按钮。 日志如下图所示，确认正常结束后点击关闭按钮。 通过该工具，将创建一个 Web 应用程序路径：/pet1。 从管理门户 -> 系统管理 -> 安全 -> 应用程序 -> Web 应用程序检查 /pet1 是否存在。 定义完成！ 现在，让我们检查是否已经创建了记载输入路径对应的方法的disp（调度类）和实施代码的impl类。 类定义已经在 PetStore 包下创建完成！ 与IRIS提供的OpenAPI 2.0的类不同的是，这里包含了model包和requests包。 在这个工具中，OpenAPI 3.0的Components对象中指定的信息被创建为可以生成实例的类定义。 （它继承了 %RegisteredObject 类） Components对象Pet的信息可以在下方展开查看。 Components：Pet的规格 "Pet":{ "required":[ "name", "photoUrls" ], "type":"object", "properties":{ "id":{ "type":"integer", "format":"int64", "example":10 }, "name":{ "type":"string", "example":"doggie" }, "category":{ "$ref":"#/components/schemas/Category" }, "photoUrls":{ "type":"array", "xml":{ "wrapped":true }, "items":{ "type":"string", "xml":{ "name":"photoUrl" } } }, "tags":{ "type":"array", "xml":{ "wrapped":true }, "items":{ "$ref":"#/components/schemas/Tag" } }, "status":{ "type":"string", "description":"pet status in the store", "enum":[ "available", "pending", "sold" ] } }, "xml":{ "name":"pet" } }, 根据此信息创建的类如下： 它在可以实例化的类中。 如果将super class从 %RegisteredObject 更改为 %Persistent 并编译，则可以将其用作可以在数据库中持久化储存的类。 此外，POST 请求将发送以下格式的 JSON 对象。 { "id": 0, "category": { "id": 0, "name": "Dog" }, "name": "Hachi", "photoUrls": [ "https://x.gd/1pbYK" ], "tags": [ { "id": 0, "name": "Middle" } ], "status": "available" } 能够将此 JSON 直接作为 Pet、Tag 和 Category 类下的实例会很好，因此又追加继承了 %JSON.Adaptor 。 另外，如果我要修改 Pet、Tag 和 Category，最好将super class的配置从 %RegisteredObject 更改为 %Persistent 和 %JSON.Adaptor 的多重继承。 在此之后，需要将接收到的Body信息更新到数据库中。 Request包下的类描述了这个过程的概要。以下示例显示了在向 /pet 发出 POST 请求时运行的类 (PetStore.requests.addPet.cls) 的内容。 如果你注意LoadFromRequest()方法，你会发现它在把可以处理HTTP请求的%request传递给参数request（在IRIS的REST调度类内部处理时，HTTP请求存储在%CSP.Request的一个实例中）。 request.Content 上面的执行可以得到Body中指定的JSON对象。 Do ..PetNewObject (). %JSONImport (request.Content) 这个类中虽然调用了以上方法，但由于该类中实际上并没有PetNewObject()方法，所以做了如下修改（生成一个Pet实例，将其设置为属性Pet，然后将接收到的JSON分配给实例处理）。 set ..Pet = ##class (PetStore.model.Pet). %New () do ..Pet . %JSONImport (request.Content) 这样就完成了接收到 HTTP 请求时的处理。剩下的就是impl.cls的实现了。 在初始状态下，以下方法没有任何描述。 ClassMethod addPet(messageRequest As PetStore.requests.addPet) As %Status { ; Implement your service here. ; Return {} $$$ThrowStatus ( $$$ERROR ( $$$NotImplemented )) } 参数 messageRequest 指定了 PetStore.requests.addPet 类的一个实例，该实例在之前的流程中得到确认（根据 HTTP 请求中收到的 JSON 对象创建的实例在该实例的 Pet 属性中设置。） 改写如下，编译，大功告成！ ClassMethod addPet(messageRequest As PetStore.requests.addPet) As %Status { ;Implement your service here. ; Return {} //$$$ThrowStatus($$$ERROR($$$NotImplemented)) set status= $$$OK set status=messageRequest.Pet. %Save () return status } 让我们来测试 POST 请求。 Pet、Category、和Tag都注册并添加数据成功了！ 这个用例还是需要一些手动修改，但当我发现类定义是通过 OpenAPI 3.0 Components 对象自动生成的，让我觉得很便利！ 大家也请试用一下。

医院管理者、信息中心、业务骨干，每个角色都有独特的业务诉求，InterSystems IRIS医疗版互联互通套件专为国内用户设计，截至2021年，InterSystems技术已助力一百余家医院通过四级及以上医院信息互联互通标准化成熟度评级，其中，五乙用户占全国30%以上。

4月12日，新一期“极客俱乐部”在线分享即将推出，InterSystems中国技术总监乔鹏将分享“InterSystems数据平台与三级等保”这一主题，聊聊数据平台如何保护信息安全，以及如何配置、管理数据平台，以满足三级等保要求。点击链接报名参会，或扫描下方二维码参会。

各位开发者社区的同学们，大家好！ 经过一个多月的赛期，我们举办的🏆InterSystems开发者社区中文版首届技术征文大赛🏆（←点击链接进入参赛页面，浏览所有参赛文章）即将步入尾声！ InterSystems开发者社区（中文版）首届技术征文大赛的“征文&投票”环节将于12小时后结束（截至10月23日24:00）！抓住最后的时间为你喜欢的作品投票吧！ 10月24日19:30开始，我们将通过“InterSystems首届技术征文大赛线上分享会”发布获奖名单、进行征文作品分享&点评、探讨热门话题，同期还将举办多轮抽奖！ 欢迎参会，锁定#腾讯会议 会议主题：InterSystems首届技术征文大赛线上分享会会议时间：2022/10/24 19:30-21:00 (GMT+08:00) 中国标准时间 - 北京 点击链接入会，或添加至会议列表：https://meeting.tencent.com/dm/nVHWgZcY5NfZ #腾讯会议：372-615-324

这是InterSystems 2022年全球峰会上InterSystems 医疗行业负责人 Don Wooklock 的分享，他认为，在数字医疗发展如火如荼的当下，经济、消费主义和技术三股力量正在推动医疗行业快速变革。我们面临着压力，但更多的是机遇，利用好市场能量，在具备变革精神的医疗卫生行业中，全力以赴！

医疗科技市场正处于强劲的演变之中。Gartner的医疗科技的波浪图展示了这些技术是什么，非常好地反映了医疗行业的数字化趋势。 其中很多技术都可以使用InterSystems的技术（ISC Health Tech）来实现: 知情同意管理使用InterSystems Healthshare Stack来做患者主索引和知情同意管理。

Hi 开发者们, New video is already on InterSystems Developers YouTube: ⏯ Embedded Python for ObjectScript Developers: Working with Python and ObjectScript Side-By-Side 深入指导如何将Python与ObjectScript并排使用，包括： 在ObjectScript中使用Python库 将参数传入 Python 在 ObjectScript 和 Python 之间转换类型 从Python中使用ObjectScript类 🗣 主讲人: @Robert.Kuszewski Product Manаger, Developer Experience, InterSystems 祝您观看愉快，并请继续关注 可以把Youtube 链接换成B站链接？谢谢

系统实用类：SYS.Database中的查询FreeSpace可以用来在任何时候检查磁盘上的自由空间。 下面是在IRIS终端中的尝试方法（进入%SYS命名空间，然后运行它）。 zn "%SYS" set stmt=##class(%SQL.Statement).%New() set st=stmt.%PrepareClassQuery("SYS.Database","FreeSpace") set rset=stmt.%Execute() // 一次性显示所有 do rset.%Display() 输出结果示例如下。 *在命令执行的例子中，所有的数据库都放在同一个磁盘上，所以所有的磁盘空闲空间（DiskFreeSpace）返回相同的值。 Dumping result #1 DatabaseName Directory MaxSize Size ExpansionSize AvailableFreeDiskFreeSpace Status SizeInt AvailableNum DiskFreeSpaceNum ReadOnly IRISSYS c:\intersystems\irishealth3\mgr\ 無制限 159MB 系统默认 ト 18MB 11.32 245.81GB マウント/RW 159 18 2517050 ENSLIB c:\intersystems\irishealth3\mgr\enslib\ 無制限 226MB システムデフォル ト 19MB 8.4 245.81GB マウント/R 226 19 2517051 　　　＜一部省略＞ IRISTEMP c:\intersystems\irishealth3\mgr\iristemp\ 無制限 51MBシス テムデフォルト 49MB 96.07 245.81GB マウント/RW 51 49251705 0 USER c:\intersystems\irishealth3\mgr\user\ 無制限 31MB システムデフォル ト 8.5MB 27.41 245.81GB マウント/RW 31 8.5 2517050 如果你想指定你要参考的数据库目录，请执行以下操作。 // 使用$LISTBUILD()函数准备好要引用的数据库目录的完整路径。 set dbdir=$LISTBUILD("c:\intersystems\irishealth3\mgr","c:\intersystems\irishealth3\mgr\user") set rset=stmt.%Execute(dbdir) do rset.%Display() 如果你只想获得指定数据库目录的数据库名称（DatabaseName）、当前大小（Size）MB、可用自由空间（Available）MB、自由大小（Free）%、自由磁盘空间大小（DiskFreeSpace）GB，你可以执行以下流程（在VSCode或Studio中连接到%SYS命名空间时创建例程/类并编写代码）。 Class ZMyClass.Utils { ClassMethod GetDiskFreeSpace() { set dbdir=$LISTBUILD("c:\intersystems\irishealth3\mgr","c:\intersystems\irishealth3\mgr\user") set stmt=##class(%SQL.Statement).%New() set st=stmt.%PrepareClassQuery("SYS.Database","FreeSpace") set rset=stmt.%Execute(dbdir) while(rset.%Next()) { write rset.%Get("DatabaseName")," - ", rset.%Get("Size")," - ",rset.%Get("Available")," - ", rset.%Get("Free"),"% - ",rset.%Get("DiskFreeSpace"),! } } } 注意：如果你把用户定义的例程或类放在%SYS名称空间中，创建它们的名称以Z开头，这样用户定义的源代码就会在升级安装后保留下来。 下面是一个运行的例子。 USER>zn "%SYS" %SYS>do ##class(ZMyClass.Utils).GetDiskFreeSpace() IRISSYS - 159MB - 18MB - 11.32% - 245.81GB USER - 31MB - 8.5MB - 27.41% - 245.81GB %SYS>