本节提供 CORS 的概述以及如何在 IRIS REST 服务中启用 CORS 的概述。
跨域资源共享 (CORS) 允许在另一个域中运行的脚本访问服务。
通常，当浏览器从一个域运行脚本时，它允许对同一个域进行 XMLHttpRequest 调用，但在对另一个域进行调用时不允许它们。此浏览器行为限制某人创建可滥用机密数据的恶意脚本。恶意脚本可能允许用户使用授予用户的权限访问另一个域中的信息，但随后在用户不知道的情况下，将机密信息用于其他用途。为了避免这种安全问题，浏览器一般不允许这种跨域调用。
在不使用跨域资源共享 (CORS) 的情况下，具有访问 REST 服务的脚本的网页通常必须与提供 REST 服务的服务器位于同一域中。在某些环境中，将带有脚本的网页与提供 REST 服务的服务器放在不同的域中是很有用的。 CORS 支持这种安排。
下面提供了浏览器如何使用 CORS 处理 XMLHttpRequest 的简化描述：
下表列出了修改规范类的原因并简要总结了所需的更改：
| 原因 | 改变 |
|---|---|
| 更新或替换规范 | 手动修改 OpenAPI XData 块或通过重新生成规范类。 |
启用 REST 服务以支持 CORS | 手动修改 OpenAPI XData 块；还添加一个类参数并创建一个自定义调度超类。 |
启用 REST 服务以支持 Web 会话 | 添加类参数。 |
| 指定使用端点所需的权限 | 手动修改 OpenAPI XData 块。 |
| 覆盖默认内容类型、响应字符集或输入流处理 | 添加类参数。 |
| 为服务方法指定一个非默认名称 | 手动修改 OpenAPI XData 块。 |
无论何时编译规范类，编译器都会在同一个包中重新生成调度类并更新实现类。
只需将类参数添加到规范类并重新编译，就可以覆盖 REST 服务的几个关键方面。
REST 服务需要 application/json 内容类型。要覆盖它，请将以下内容添加到规范类：Parameter CONTENTTYPE = "some-content-type";
其中 some-content-type 是 MIME 内容类型。
REST 服务的响应消息采用 UTF-8 格式。要覆盖它，请将以下内容添加到规范类：本章讨论如何修改 REST 服务的实现类。
实现类最初包含存根方法，如下例所示：
/// Returns all pets from the system that the user has access to<br/>
/// The method arguments hold values for:<br/>
/// tags, tags to filter by<br/>
/// limit, maximum number of results to return<br/>
ClassMethod findPets(tags As %ListOfDataTypes(ELEMENTTYPE="%String"), limit As %Integer) As %Stream.Object
{
//(Place business logic here)
//Do ..%SetStatusCode(<HTTP_status_code>)
//Do ..%SetHeader(<name>,<value>)
//Quit (Place response here) ; response may be a string, stream or dynamic object
}
本章介绍如何使用 %REST.API 类来创建、更新和删除 REST 服务。
创建 REST 服务的推荐方法是从 REST 服务的 OpenAPI 2.0 规范开始，并使用它来生成 REST 服务类。要使用 %REST.API 类执行此操作：
REST 服务的 OpenAPI 2.0 规范，采用 JSON 格式，并将规范保存为文件。该文件必须是 UTF-8 编码的。REST 服务的命名空间中，使用该文件创建 %DynamicObject 的实例。%REST.API 类的 CreateApplication() 方法。此方法具有以下签名：本章介绍如何使用 ^%REST 例程创建和删除 REST 服务。
提示：还可以使用此例程更新REST服务；只需删除REST服务，然后重新创建它。
^%REST例程是一个简单的命令行界面。在任何提示下，可以输入以下答案：
^ - 使例程跳回上一个问题。? - 使例程显示一条列出所有当前选项的消息。q或quit - 结束例程。此外，每个问题都会在括号中显示该问题的默认答案。
^%REST例程创建REST服务创建REST服务的推荐方法是从REST服务的OpenAPI2.0规范开始，并使用该规范生成REST服务类。要使用^%REST例程执行此操作：
JSON格式的REST服务的OpenAPI 2.0规范。将规范另存为文件或记下可访问规范的URL。REST服务的名称空间。^%REST例程：do ^%REST
REST 服务的名称。该名称用作生成类的包名；使用有效的包名。如果想使用名称列表、l、quit 或 q（在任何情况下都是变体），请将名称用双引号括起来。例如："list"Y（不区分大小写）以确认您要创建此服务。然后，该例程会提示输入要使用的 OpenAPI 2.0 规范的位置。输入完整路径名或 URL。
本章介绍如何使用 /api/mgmnt 服务来创建、更新和删除 REST 服务。
/api/mgmnt 服务还提供了可用于发现和记录 Web 服务的选项，如本书后面所述。
创建 REST 服务的推荐方法是为 REST 服务创建 OpenAPI 2.0（也称为 Swagger）描述，并使用它来生成 REST 服务类。如果您正在实现由第三方定义的 REST 服务，他们可能会提供此 OpenAPI 2.0 描述。有关 OpenAPI 2.0 描述格式的详细信息，请参阅 OpenAPI 2.0 规范。以下主题描述了如何使用 /api/mgmnt 服务来执行此操作。
第一步，生成 REST 服务类，如下所示：
JSON 格式创建或获取 REST 服务的 OpenAPI 2.0 描述。REST 测试工具，例如 PostMan (https://www.getpostman.com/)。HTTP 请求消息：HTTP 操作，选择或指定 POST。URL，请指定以下形式的 URL：http://localhost:52773/api/mgmnt/v2/namespace/myapp
本文介绍 IRIS® 中的 REST 和 REST 服务。
REST 命名自“Representational State Transfer”，具有以下属性：
REST 是一种架构风格，而不是一种格式。尽管 REST 经常使用 HTTP 来传输消息并使用 JSON 来传递数据，但也可以将数据作为 XML 或纯文本传递。 REST 利用现有的 Web 标准，例如 HTTP、URL、XML 和 JSON。REST 是面向资源的。通常，资源由 URL 标识并使用基于 HTTP 方法的操作，例如 GET、POST、PUT 和 DELETE。REST 通常有少量开销。虽然它可以使用 XML 来描述数据，但它更常用的是 JSON，它是一种轻量级的数据包装器。 JSON 使用标签标识数据，但标签没有在正式的模式定义中指定，也没有明确的数据类型。在 IRIS 2019.2 及更高版本中定义 REST 接口有两种方法：
OpenAPI 2.0 规范，然后使用 API 管理工具生成 REST 接口的代码。REST 接口。使用规范优先的定义，REST 服务正式由以下组件组成：
大家好，
我想知道是否有可能获取自身的值来运行查询。
我想创建一些查询以在％Persistent类中找到一个值，但是每个查询都使用不同的值。
我想安装Windows版本的管理门户引擎来创建Cache InterSystems数据库
我想为Cache InterSystems创建一个样本数据库，并想通过Cache Entity Framework Provider访问它。但是，我无法找到一个特定的管理门户引擎来创建数据库。
你能指导一下如何在Windows中安装管理门户吗？
I want to create a Sample Database for Cache InterSystems and want to access it via Cache Entity Framework Provider. But, I cannot find a particular engine of Management Portal to create a database.
Can you guide how to install Management Portal in Windows?
大家好，我可以在RSA和DSA之间进行选择。 ECC似乎不受支持。有没有不使用外部二进制（例如curl）的解决方法？
RY
大家好，
我需要根据用户请求删除Ensemble接口。我想为此编写一个程序，执行的时候将通过代码删除接口组件。
能否提供以下操作的代码示例？
感谢帮助。
谢谢，
普鲁索他曼
Ensemble Delete Individual Rules and Ensemble classes programmatically
Hi Team,
I have a requirement to delete the Ensemble interfaces , as per User request. I would like to write a routine for that and once I execute, it should remove the interface components through code.
Could you please provide code samples for the following actions ?
大家好，
我目前正在开发TCP入站服务，以读取从使用EnsLib.TCP.CountedOutboundAdapter的TCP操作发送的一些XML。
1）我尝试过EnsLib.TCP.Inbound适配器，但是会出现此错误：
错误<Ens> ErrException：<METHOD不存在> zinitConfig + 7 ^ Ens.Host.1 *％New，EnsLib.TCP.InboundAdapter-登录为'-'
数字 - @'
设置..Adapter = $ classmethod（..＃ADAPTER，“％New”）'
因此，适配器无法开始侦听传入的连接。
2）当我改用EnsLib.TCP.CountedXMLInboundAdapter或EnsLib.TCP.CountedInboundAdapter时，适配器开始侦听给定的端口，但OnProcessinput（）方法未在pInput流中接收任何数据。流始终为空，并在事件日志中引发此错误。
错误<Ens> ErrTCPReadBlockSize：超时时间为（5）的TCP Read（32000）失败，错误如下：（1144）：l version =“ 1.0” encoding =“ UTF-8”？> Wsma2Message xmlns：ns1 =“ urn：hl7-org ：v3“ ......
我可以从AIX命令行提示符运行以下命令，而不会出现任何问题
-bash-2.05b$ echo t t -bash-2.05b$ echo œ œ
当我从内部Cache调用时，我遇到了问题。
USER>D $ZF(-1,"echo t") t USER>D $ZF(-1,"echo œ") D $ZF(-1,"echo œ") ^ <TRANSLATE>
我正在使用Cache 2017.2。有人可以帮忙吗？
谢谢你。
我想知道是否有更好的方法来使用动态SQL对数据集进行分页，而不是我下面使用的方法。问题是，当潜在的数据池变大时，这段代码就会变慢，以至于无法使用。在分析下面的每一行代码时，似乎速度变慢与最初的rset.%Next()迭代有关。 有没有什么不需要子查询/%VID的可用方法，比如简单的LIMIT/OFFSET？
我的代码类似于:
s sql=##class(%SQL.Statement).%New()
s query="SELECT *,%VID FROM (SELECT prop FROM table WHERE prop=x) WHERE %VID BETWEEN 1 AND 100"
s sc=sql.%Prepare(query)
s rset=sql.%Execute()
while rset.%Next() {.....
用 ObjectScript 编写的方法中的参数可以通过值或引用传递。在下面的方法中，签名中第二个和第三个参数前面的 ByRef 关键字表示它们打算通过引用传递。
ClassMethod SandwichSwitch(bread As %String, ByRef filling1 As %String, ByRef filling2 As %String)
{
set bread = "whole wheat"
set filling1 = "almond butter"
set filling2 = "cherry preserves"
}
从 ObjectScript 调用方法时，在参数前放置一个句点以通过引用传递它，如下所示：
由于 ObjectScript 和 Python 语言之间的差异，将需要了解一些有助于弥合语言之间差距的信息。
在 ObjectScript 方面，%SYS.Python 类允许从 ObjectScript 使用 Python。
在 Python 方面，iris 模块允许使用 Python 中的 ObjectScript。在 Python 中，键入 help(iris) 以获取其方法和函数的列表。
builtins 包在 Python 解释器启动时自动加载，它包含语言的所有内置标识符，例如基对象类和所有内置数据类型类、异常类、函数和常量。
可以将此包导入 ObjectScript 以访问所有这些标识符，如下所示：
set builtins = ##class(%SYS.Python).Import("builtins")
Python print() 函数实际上是内置模块的一个方法，因此现在可以在 ObjectScript 中使用此函数：
USER>do builtins.print("hello world!")
hello world!
嵌入式 Python 让可以轻松访问数以千计的有用库。通常称为“包”，它们需要从 Python 包索引 (PyPI) 安装到 <installdir>/mgr/python 目录中，然后才能使用。
例如，ReportLab Toolkit 是一个用于生成 PDF 和图形的开源库。以下命令使用软件包安装程序 irispip 在 Windows 系统上安装 ReportLab：
C:\InterSystems\IRIS\bin>irispip install --target C:\InterSystems\IRIS\mgr\python reportlab
在基于 UNIX 的系统上，使用：
$ pip3 install --target /InterSystems/IRIS/mgr/python reportlab
安装包后，可以使用 %SYS.Python 类的 Import() 方法在 ObjectScript 代码中使用它。
给定一个文件位置，以下 ObjectScript 方法 CreateSamplePDF() 创建一个示例 PDF 文件并将其保存到该位置。
还可以使用 irispython 命令执行 Python 脚本。
考虑 Windows 系统上的文件 C:\python\test.py，其中包含以下代码：
# print the members of the Fibonacci series that are less than 10
print('Fibonacci series:')
a, b = 0, 1
while a < 10:
print(a, end=' ')
a, b = b, a + b
# import the iris module and show the classes in this namespace
import iris
print('\nInterSystems IRIS classes in this namespace:')
status = iris.cls('%SYSTEM.OBJ').ShowClasses()
print(status)
可以从命令行运行 test.py，如下所示：
嵌入式 Python 允许使用 Python 作为编程 IRIS 应用程序的本机选项。
使用嵌入式 Python 所需的 Python 版本取决于运行的平台。
在 Microsoft Windows 上，IRIS 安装工具包安装正确版本的 Python（当前为 3.9.5），仅用于嵌入式 Python。如果在开发机器上并希望将 Python 用于一般用途，建议从 https://www.python.org/downloads/ 下载并安装相同的版本。
许多基于 UNIX 的操作系统都安装了 Python。如果需要安装，请使用包管理器为操作系统推荐的版本，例如：
macOS：使用 Homebrew 安装 Python 3.9(https://formulae.brew.sh/formula/python@3.9)Ubuntu: apt-get install python3Red Hat Enterprise Linux or Oracle Linux: yum install python3SUSE: zypper install python3如果收到“无法加载 python”的错误，这意味着没有安装 Python，或者系统上安装了意外版本的 Python。使用上述方法之一安装或重新安装。
IRIS 中的类被投影到 SQL，除了使用类方法或直接全局访问之外，还允许使用查询访问数据。 iris 模块为提供了两种从 Python 运行 SQL 语句的不同方式。
以下示例使用 iris.sql.exec() 运行 SQL SELECT 语句以查找类名称以“%Net.LDAP”开头的所有类定义，返回一个包含每个名称和超类的结果集每个班级。在这里，系统类 %Dictionary.ClassDefinition 将 SQL 投影为同名表。
>>> rs = iris.sql.exec("SELECT Name, Super FROM %Dictionary.ClassDefinition WHERE Name %STARTSWITH '%Net.LDAP'")
以下示例使用 iris.sql.prepare() 准备 SQL 查询对象，然后执行查询，将“%Net.LDAP”作为参数传入：
>>> stmt = iris.sql.prepare("SELECT Name, Super FROM %Dictionary.ClassDefinition WHERE Name %STARTSWITH ?")
>>> rs = stmt.execute("%Net.LDAP")
无论哪种情况，都可以按如下方式遍历结果集，并且输出相同：
开始 - 请拉到页面底部查看该系列文章第一部分 .
3. 使用globals时结构的变体
一个结构，比如说一个有序排列的“树”，有各种特殊的情况。让我们来看看那些对使用globals有实际价值的情况。
如果使用的是嵌入式 Python 并且需要与 IRIS 交互，可以使用 Python shell 中的 iris 模块，或者使用 Python 编写的 IRIS 类中的方法。要遵循本节中的示例，可以使用 ObjectScript 命令 do ##class(%SYS.Python).Shell() 从终端会话启动 Python shell。
当启动终端会话时，将被放置在 IRIS 的 USER 命名空间中，将看到提示 USER>。但是，如果从 GitHub 加载了示例类，则需要在 SAMPLES 命名空间中才能访问它们。
在终端中，更改为 SAMPLES 命名空间，然后启动 Python shell，如下所示：
USER>set $namespace = "SAMPLES"
SAMPLES>do ##class(%SYS.Python).Shell()
Python 3.9.5 (default, Jul 19 2021, 17:50:44) [MSC v.1927 64 bit (AMD64)] on win32
Type quit() or Ctrl-D to exit this shell.
>>>
嵌入式 Python 允许将 Python 与 IRIS 数据平台的本地编程语言 ObjectScript 一起使用。当使用嵌入式 Python 在 IRIS 类中编写方法时，Python 源代码与编译后的 ObjectScript 代码一起编译为在服务器上运行的目标代码。与使用网关或 Python的 Native SDK 相比，这允许更紧密的集成。还可以导入 Python 包，无论它们是自定义的还是公开的，并在ObjectScript 代码中使用它们。 Python 对象是 ObjectScript 中的一等公民，反之亦然。
ObjectScript 的 Python 库 - 此方案假设 ObjectScript 开发人员，并且希望利用 Python 开发人员社区可用的众多 Python 库的强大功能。Python 调用 IRIS API — 此方案假定您是一名 Python 开发人员，对 IRIS 不熟悉，并且想知道如何访问 API。ObjectScript 和 Python — 这个场景假设在一个由 ObjectScript 和 Python 开发人员组成的混合团队中，并且想知道如何一起使用这两种语言。许多类使用 %Status 数据类型类来表示状态信息，并且它们的方法返回表示成功或错误的 %Status 值（状态）。如果状态表示一个错误（或多个错误），则状态值还包括有关错误的信息。
还可以返回自己的状态值。
本文讨论状态值以及如何使用它们。
如上所述，许多 类中的方法返回一个状态以指示成功或错误。例如，%Library.Persistent中的%Save()` 方法返回一个状态。对于任何此类方法，请务必获取返回值。然后检查状态，然后适当地继续。基本工具如下：
要检查状态是表示成功还是错误，请使用以下任一方法：
$$$ISOK 和 $$$ISERR 宏，在包含文件 %occStatus.inc 中定义。此包含文件在所有对象类中自动可用。$SYSTEM.Status.IsOK() 和 $SYSTEM.Status.IsError() 方法，它们在终端（不能使用宏）中特别方便。要显示错误详细信息，请使用 $SYSTEM.OBJ.DisplayError() 或 $SYSTEM.Status.DisplayError()。这些方法彼此等效。他们将输出写入当前设备。
要获取包含错误详细信息的字符串，请使用 $SYSTEM.Status.GetErrorText()。
除了推荐的 REST 应用程序支持之外，产品还支持两种类型的传统 Web 应用程序：CSP 和 Zen。在配置使用 CSP 和 Zen 的自定义登录页面时，遵循推荐的协议很重要。这些协议提供了更高的安全性，并最大限度地减少了升级到新产品或版本时的不兼容性。
创建自定义 CSP 登录页面：
%CSP.Login 页面的子类。Draw 方法，以便页面看起来像想要的那样。其中包括修改登录页面外观的方法和修改安全令牌页面外观的方法（如果使用双因素身份验证）：DrawCSS3STYLE、DrawHEAD、DrawSTYLE、DrawTitleDrawSTHEAD、DrawSTTitle请注意，DrawTitle 和 DrawSTTitle 方法调用 DrawTitleSection 方法。
我现在在使用object script。如果把代码从 objectscript转成 Java 我需要做些什么?
亲爱的女士们和先生们，在上个月，我改进了我的工具Caché监视器......但首先：名字
选择Caché Monitor这个名字是为了反映该工具与Caché数据库的紧密结合。我想，在可预见的未来，Intersystems Caché这个既定名称很可能会被InterSystems IRIS数据平台完全取代。因此，重塑品牌的步骤成为必要。为了在未来不那么紧密地与一个产品名称联系在一起，我们选择了一个更加中立的新名字: SQL Data Lens
不管叫什么名字，实现与Intersystems产品最紧密的整合仍然是我们的目标。持续的发展也反映在版本号的延续上。上一个版本是Caché Monitor 2.96，下一个版本是SQL Data Lens 3.0。
但这不仅仅是重新命名，而且还集成了许多新的功能，例如
第二十一章 使用工作队列管理器（四）
分离和附加工作队列
通常，初始化一组工作程序，将工作项排队，然后等待工作程序完成工作项。但是，可能会遇到工作人员作业完成工作项所需的时间比预期更长的情况，或者无法将单个进程专门用于等待。因此，工作队列管理器使能够将工作队列与进程分离，然后将工作队列附加到同一进程或不同的进程。
例如，假设队列引用了初始化的工作队列。还假设向工作队列中添加了几个工作项。在调用 Wait() 或 WaitForComplete() 来确定正在处理的工作的状态之前，可以使用以下方法：
Detach()
method Detach(ByRef token As %String, timeout As %Integer=86400) as Status 从初始化工作队列时创建的对象引用中分离工作队列对象。 Detach() 方法使任何正在进行的工作能够继续并保留工作队列的当前状态。
token 参数表示一个安全令牌，可以使用它随后将工作队列附加到另一个进程。 timeout 参数是可选的，它指示系统保留分离的工作队列对象的时间量（以秒为单位）。超时期限过后，系统会删除与工作队列关联的所有工作人员作业和信息。超时的默认值为 1 天。
一个类别是一个独立的worker jobs池。当初始化一组worker jobs时，可以指定提供worker的类别。如果集合中的任何worker jobs在执行work项时请求额外的worker jobs，则新的worker jobs来自同一类别。
例如，假设系统提供的 SQL 类别分配了最多 8 个worker。然后，假设与BusinessIntelligence相关的流程创建了一个类别，并将最多四个worker分配给该类别。如果 SQL 池中的所有worker在给定时间都参与了工作，则 BusinessIntelligence 类别中的worker可能仍然可以立即处理工作项。
系统包括两个不能删除的类别：SQL 和 Default。 SQL 类别适用于系统执行的任何 SQL 处理，包括查询的并行处理。当在未指定类别的情况下初始化一组worker jobs时，默认类别提worker jobs。
每个类别都具有影响该类别中每个工作队列的行为的属性。这些属性是：
当创建此类别中的工作队列且未指定worker job 计数时，这将成为工作队列中worker job 的数量。此属性的默认值是核心数。