第十章 发现和记录 REST API

本章讨论如何发现实例上可用的 REST 服务以及如何为 REST 服务生成文档。

使用 /api/mgmnt 服务发现 REST 服务

/api/mgmnt 服务包括可用于发现 REST 服务类和启用 REST 的 Web 应用程序的调用。

发现 REST 服务

要使用 /api/mgmnt 服务来发现实例上可用的 REST 服务，请使用以下 REST 调用：

第七章 在 REST 服务中支持 CORS

概述

本节提供 CORS 的概述以及如何在 IRIS REST 服务中启用 CORS 的概述。

CORS 简介

跨域资源共享 (CORS) 允许在另一个域中运行的脚本访问服务。

通常，当浏览器从一个域运行脚本时，它允许对同一个域进行 XMLHttpRequest 调用，但在对另一个域进行调用时不允许它们。此浏览器行为限制某人创建可滥用机密数据的恶意脚本。恶意脚本可能允许用户使用授予用户的权限访问另一个域中的信息，但随后在用户不知道的情况下，将机密信息用于其他用途。为了避免这种安全问题，浏览器一般不允许这种跨域调用。

在不使用跨域资源共享 (CORS) 的情况下，具有访问 REST 服务的脚本的网页通常必须与提供 REST 服务的服务器位于同一域中。在某些环境中，将带有脚本的网页与提供 REST 服务的服务器放在不同的域中是很有用的。 CORS 支持这种安排。

第五章 修改实现（IMPL）类

本章讨论如何修改 REST 服务的实现类。

初始方法定义

实现类最初包含存根方法，如下例所示：

第三章 使用 ^%REST 例程创建 REST 服务

本章介绍如何使用 ^%REST 例程创建和删除 REST 服务。

提示：还可以使用此例程更新REST服务；只需删除REST服务，然后重新创建它。

使用^%REST例程

^%REST例程是一个简单的命令行界面。在任何提示下，可以输入以下答案：

• ^ - 使例程跳回上一个问题。
• ? - 使例程显示一条列出所有当前选项的消息。
• q或quit - 结束例程。

此外，每个问题都会在括号中显示该问题的默认答案。

第一章 创建 REST 服务简介

本文介绍 IRIS® 中的 REST 和 REST 服务。

我想安装Windows版本的管理门户引擎来创建Cache InterSystems数据库
我想为Cache InterSystems创建一个样本数据库，并想通过Cache Entity Framework Provider访问它。但是，我无法找到一个特定的管理门户引擎来创建数据库。

你能指导一下如何在Windows中安装管理门户吗？

I want to install Management Portal Engine for Windows to create Cache InterSystems DB

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.

大家好，

我需要根据用户请求删除Ensemble接口。我想为此编写一个程序，执行的时候将通过代码删除接口组件。
能否提供以下操作的代码示例？

• 从规则类中删除单个规则
• 从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 ?

我可以从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。有人可以帮忙吗？

谢谢你。

答案见文档：https://docs.intersystems.com/latest/csp/documatic/%25CSP.Documatic.cls?...

第七章 使用嵌入式 Python （四）

弥合 ObjectScript 和嵌入式 Python 之间的差距

由于 ObjectScript 和 Python 语言之间的差异，将需要了解一些有助于弥合语言之间差距的信息。

在 ObjectScript 方面，%SYS.Python 类允许从 ObjectScript 使用 Python。

在 Python 方面，iris 模块允许使用 Python 中的 ObjectScript。在 Python 中，键入 help(iris) 以获取其方法和函数的列表。

使用 Python 内置函数

builtins 包在 Python 解释器启动时自动加载，它包含语言的所有内置标识符，例如基对象类和所有内置数据类型类、异常类、函数和常量。

第五章 使用嵌入式 Python （二）

在 Python 脚本文件 (.py) 中

还可以使用 irispython 命令执行 Python 脚本。

考虑 Windows 系统上的文件 C:\python\test.py，其中包含以下代码：

第三章 嵌入式Python概述（三）

使用 SQL

IRIS 中的类被投影到 SQL，除了使用类方法或直接全局访问之外，还允许使用查询访问数据。 iris 模块为提供了两种从 Python 运行 SQL 语句的不同方式。

以下示例使用 iris.sql.exec() 运行 SQL SELECT 语句以查找类名称以“%Net.LDAP”开头的所有类定义，返回一个包含每个名称和超类的结果集每个班级。在这里，系统类 %Dictionary.ClassDefinition 将 SQL 投影为同名表。

第二章 嵌入式Python概述（二）

从 Python 调用 IRIS API

如果使用的是嵌入式 Python 并且需要与 IRIS 交互，可以使用 Python shell 中的 iris 模块，或者使用 Python 编写的 IRIS 类中的方法。要遵循本节中的示例，可以使用 ObjectScript 命令 do ##class(%SYS.Python).Shell() 从终端会话启动 Python shell。

当启动终端会话时，将被放置在 IRIS 的 USER 命名空间中，将看到提示 USER>。但是，如果从 GitHub 加载了示例类，则需要在 SAMPLES 命名空间中才能访问它们。

第二十三章 使用 %Status 值

许多类使用 %Status 数据类型类来表示状态信息，并且它们的方法返回表示成功或错误的 %Status 值（状态）。如果状态表示一个错误（或多个错误），则状态值还包括有关错误的信息。

还可以返回自己的状态值。

本文讨论状态值以及如何使用它们。

使用状态值的基础知识

如上所述，许多 类中的方法返回一个状态以指示成功或错误。例如，%Library.Persistent中的%Save()方法返回一个状态。对于任何此类方法，请务必获取返回值。然后检查状态，然后适当地继续。基本工具如下：
- 要检查状态是表示成功还是错误，请使用以下任一方法：
-$$$ISOK和$$$ISERR宏，在包含文件%occStatus.inc中定义。此包含文件在所有对象类中自动可用。
-$SYSTEM.Status.IsOK()和$SYSTEM.Status.IsError()` 方法，它们在终端（不能使用宏）中特别方便。