第十三章 配置任务管理器电子邮件设置

可以将任务管理器设置为在任务完成时发送电子邮件通知，在任务管理器电子邮件设置页面（系统管理 > 配置 > 其他设置 > 任务管理器电子邮件），可以配置通知设置：

• SMTP 服务器和端口

发送 SMTP（简单邮件传输协议）邮件服务器的地址和端口

• SSL Config

如果要使用 SSL/TLS 加密电子邮件，则要使用的 SSL 配置。如果实例上没有 SSL 配置，或者想创建一个新配置，请参阅创建或编辑 配置。如果您不选择 配置，则不会使用 。

• SMTP 验证用户和密码

仅对 服务器的 身份验证需要。有关详细信息，请参阅 。如果不提供条目，则 用户名和密码将设置为 。

• Sender

仅对 服务器的 SMTP 身份验证需要。有关详细信息，请参阅 。

• Reply To

收件人应回复的电子邮件地址

• Success Subject

成功的任务消息的格式化主题行。请参阅下面的“主题和消息的参数”部分。

• Success Message

任务运行成功后发送的格式化消息

• Failure Subject

失败的任务消息的格式化主题行

• Failure Message

任务失败后发送的格式化消息

注意：还可以通过新选项卡类中的 以编程方式配置电子邮件设置。

主题和消息的参数

使用网页底部列出并在下表中定义的任务参数格式化主题和消息文本框中的信息。

第十二章 配置数据库（四）

重定位本地数据库

要将本地数据库的 IRIS.DAT 文件移动到不同的目录，必须执行以下操作：

1. 记下当前的数据库目录。可以从本地数据库页面（系统管理 > 配置 > 系统配置 > 本地数据库）查看此信息。
2. 彻底关闭实例，例如使用 iris stop 命令。
3. 将 IRIS.DAT 文件和流目录从当前数据库目录复制到所需位置

重要提示：如果数据库目录中有 iris.lck 文件，请不要移动数据库。这意味着数据库仍在使用中，移动它可能会导致无法预料的问题。

注意： 不支持在配置数据库目录时使用符号链接，并建议为新的数据库位置选择完全解析的物理路径。

4. 在文本编辑器中打开实例的 iris.cpf 文件。该文件通常位于安装目录中。

5. 在 [Databases] 部分下方找到数据库的名称。用新路径替换旧目录路径，然后保存 iris.cpf。

6. 启动 IRIS 实例，并查看本地数据库页面以确认目录已设置为新位置。如果数据库是镜像的，则需要激活并赶上它。

7. 删除旧的数据库目录。

重要提示：重定位本地数据库目录后，还必须更新任何远程访问数据库的系统（例如 ECP 应用程序服务器）。在每个远程系统上，将远程数据库目录更新到新位置，如远程数据库中所述。

删除本地数据库

要删除本地数据库，请单击相应行中的删除链接。

# 第十一章 配置数据库（三）

## 编辑本地数据库的属性

显示的信息取决于数据库是否被镜像。本节确定以下字段：

### 部分编辑非镜像本地数据库属性

单击非镜像数据库的名称可查看以下数据库属性并更改其中一些属性。 （“创建本地数据库”部分描述了其中的许多字段。）

- `Name `
- `Directory` 目录（此设置必须始终反映 `IRIS.DAT` 数据库文件的位置）
- `Encrypted`加密（无法更改）
- `Mirrored` 已镜像 — 单击添加到 `Mirrormirror_name` 链接以将数据库添加到其中 `IRIS` 实例是主要故障转移成员的镜像。 （仅当实例是镜像中的主实例时，此选项才可用。）
- `Block Size (Bytes)`块大小（字节）（无法更改）
- `Size` 大小 (MB) — 共有三种大小设置，如下所示：
  - `Change Current` 修改数据库的当前大小。
  - `Expansion` 扩展设置在需要时扩展数据库的数量；默认（和推荐）设置为零 (`0`) 表示当前大小的 `12%` 或 `10` MB，以较大者为准。使用当前大小的 `12%` 时，扩展大小不会大于 1GB。
  - `Maximum` 最大值指定数据库可以增长到的最大大小，以兆字节为单位；默认设置为零 (`0`) 表示没有最大值。

第十章 配置数据库（二）

本地数据库

“本地数据库”页面显示关于系统上的数据库的以下信息:

• Name—数据库名称。
• Mirror——如果数据库是镜像的，则镜像的名称;
• Directory - IRIS.DAT 文件的位置。
• Size 大小 (MB) — 以 为单位的数据库大小。
• Status 状态 — 指定数据库是挂载、卸载还是卸载；如果已挂载，则指定它是否具有只读或读写权限。
• 资源名称 — 控制对数据库的访问的数据库资源的名称；
• — 指定数据库是否加密；
• 指定数据库是否被记录；

创建本地数据库

要创建本地数据库，请导航到本地数据库页面（系统管理 > 配置 > 系统配置 > 本地数据库）。

1. 单击创建新数据库以打开数据库向导。

2. 在文本框中输入数据库名称。数据库名称必须：

• 尚未在 实例中使用
• 长度在 到 30 个字符之间
• 以字母字符或下划线开头；其余部分可以包括字母数字字符、破折号或下划线

3. 首次使用特定浏览器在 IRIS 实例中创建本地数据库时，必须

• 输入数据库目录的名称，在这种情况下，包含 文件的目录在确认后将在 中创建
• 单击文件夹图标浏览到现有目录，在这种情况下，将在该目录中创建 文件

此后，默认情况下，将在与先前数据库目录相同的位置创建一个与提供的数据库名称相同的目录，其中包含 IRIS.DAT 文件。

目前 cache 架构如上图所示，有部分 csp 接口查询速度不稳定，数据量并不大，每次查询返回也就几十个个病人数据，有时 1-4秒，有时十分慢差不多10几秒；在终端直接执行接口对应方法速度又很快。请问怎么逐步排查、定位问题出在哪一部分？有哪些工具、手段或者 cache 参数可以监控？

Hi,

我无法连接到本地网络浏览器.

我想打开(http://localhost:57772/csp/sys/UtilHome.csp) 现实：

Caché Server Pages Version 2018.1.6.717.0
Server Availability Error

Server is currently unavailable

如果我调用 CSP.log 得到以下报错:

Access Denied
    Diagnostic
    Failed to connect to 'LOCAL' - Reason: 0 (Connection successfully made but server not responding) (No Retry)

请帮帮我，谢谢！

我需要在当前命名空间下创建一系列的只读类，并限制除_system之外的所有用户都只有读取权限，无法在studio中编译，请问我应该如何操作呢？
我的目的是可以在工程的项目分支中管理这些类，并通过发布方式持续升级这部分类文件。
但是这些类的内部逻辑有可能会需要维护人员能够知晓其中的功能和实现方式，所以不能通过MakeDeployed来解决这个问题
我现在知道可以通过设置database的读写属性来解决这个问题，但是这样就需要额外新建一个database并maping到当前命名空间下。采取这种方式处理时有一个重大的缺点，即在执行代码发布过程中，需要停库，并且停库时间可能会在半个小时左右，这个我无法接受。

一致性检查的任务——integrity check在业务低峰期直接运行吗？A-B（mirror）环境中，运行这个任务来检查一致性是两边都要运行吗？在管理锁的时候，我直接将锁remove会有啥后果？

第九章 配置数据库（一）

数据库是使用数据库向导创建的 IRIS.DAT 文件。 IRIS数据库保存称为全局变量的多维数组中的数据和称为例程的可执行内容，以及类和表定义。 全局变量和例程包括方法、类、网页、SQL、BASIC和JavaScript文件

注意：在 Windows 系统上，不要对 IRIS.DAT 数据库文件使用文件压缩。 （通过右键单击 Windows 资源管理器中的文件或文件夹并选择属性，然后选择高级，然后压缩内容以节省磁盘空间来压缩文件；压缩后，文件夹名称或文件名在 资源管理器中呈现为蓝色。）如果压缩 文件，它所属的实例将无法启动，并出现误导性错误。

数据库根据需要动态扩展（假设有可用空间），但可以指定最大大小。如果使用默认的 8KB 块大小，数据库可以增长到 。

可以动态更改大多数数据库配置；可以在系统运行时创建和删除数据库以及修改数据库属性。

注意：这些主题描述了使用管理门户手动配置数据库的过程。 还包含可用于自动化数据库配置的编程工具。可以使用新选项卡类中的 来创建和配置数据库；还可以使用 命令行实用程序配置数据库。

配置数据库的另一种方法是将 、 或 操作与配置合并结合使用。配置合并允许通过应用声明性合并文件来自定义

第八章 配置命名空间（三）

Routine Mappings

可以在覆盖命名空间例程的默认数据库映射的例程级别向命名空间添加映射：

1. 导航到命名空间页面（系统管理 > 配置 > 系统配置 > 命名空间），然后单击要在其中映射全局的命名空间行中的常规映射。
2. 在常规映射页面中，单击新建。
3. 选择例程所在的 Routine database location 数据库。
4. 输入例程名称。映射时例程不必存在（也就是说，它可以是计划创建的例程的名称）。
5. 单击确定。

注意：新映射行的第一列中显示的 表示已打开映射进行编辑。

6. 要将映射保存在 cpf 文件中，请单击保存更改。

例如，使用前面的测试命名空间映射示例，如果计划在机场数据库（在 FlightSchedule 命名空间中）中创建一个计划例程（例如 BOSZZairline），并且希望它对 TravelAgent 命名空间中的用户可用，请导航到 页面（在 命名空间行中），然后单击 。输入如下例程映射对话框中所示的信息：

• Include files
• Other routines
• Classes

根据需要使用额外的例程、包和全局映射，以确保这些项目在目标命名空间中可用。

Package Mappings

第七章 配置命名空间（二）

将全局、例程和包映射添加到命名空间

除了可以访问映射数据库中的全局变量和例程之外，还可以映射来自相同或不同系统上的其他数据库的全局变量、例程和类包。这允许对可以存在于任何地方的数据进行简单引用，并且是命名空间的主要特征。可以映射整个全局变量或全局变量；此功能允许数据轻松跨磁盘。

注意：映射按字母顺序排序；如果指定了下标，则按名称和下标排序。

单击适当的选项开始映射：

• Global Mappings
• Routine Mappings
• Package Mappings

以下是映射如何在示例航空公司预订应用程序中工作的示意图：

数据和程序存储在数据库数据库中，即物理存储位置，并由名称空间引用，即逻辑引用。

重要提示：如果存在与本地内容具有相同标识符的映射内容（例如包、类、全局或例程名称），则映射内容将可见，而不是本地内容。因此，应该尽可能具体地使用映射，以防止映射远离现有内容。 在命名内容和创建映射时，请务必遵循标识符规则和准则，以避免任何不必要的冲突。

Mappings

可以在全局和全局下标级别将新全局映射添加到命名空间，以覆盖命名空间全局变量的默认数据库映射：

1. 导航到命名空间页面（系统管理 > 配置 > 系统配置 > 命名空间）并单击要在其中映射全局的命名空间行中的全局映射。

2. 从Global Mappings页面单击新建。

第六章 配置命名空间（一）

命名空间是虚拟工作空间中的数据和程序的集合。在命名空间中，可以定义各种组或人员需要的全局变量Global。例如，如果审计部门需要使用存在于不同系统或不同目录中的某些全局变量Global，可以设置一个单一的命名空间来引用网络上的所有会计全局变量和数据库。

IRIS 带有以下预定义的命名空间：

• %SYS — 系统管理信息和实用程序。 -USER — 安装时为空。通常用于应用程序开发。

可以在管理门户的命名空间页面上执行以下过程来配置命名空间，可以通过在主页上依次选择系统管理、配置、系统配置和命名空间来导航到该页面：

• 创建/修改命名空间
• 重命名命名空间或修改默认映射
• 将全局、例程和包映射添加到命名空间
• 删除命名空间

注意：上面列出的主题描述了使用管理门户手动配置命名空间的过程。 IRIS 还包含对自动化命名空间配置有用的编程工具。可以在新选项卡类中使用 来创建和配置命名空间。

配置命名空间的另一种方法是将 CreateNamespace、 或 操作与配置合并结合使用。配置合并允许通过应用声明性合并文件来自定义 IRIS 实例，该文件指定要应用于该实例的设置和操作。

单个 实例中命名空间数量的绝对限制为 。命名空间表的大小是自动的且不可配置。

创建/修改命名空间

可以随时创建新的命名空间，但是当第一次设置系统时，请创建用户需要的基本名称空间。

第五章 配置系统信息

IRIS 将系统范围的配置信息存储在称为配置参数文件 (CPF) 的文件中。该文件是一个重要工具，因为它包含IRIS 实例的大部分可配置设置。每个实例都部署了一个默认 ，它位于安装目录中。可以直接在文本编辑器中修改 ，也可以从管理门户或终端间接修改。在 和 上，还可以通过指定配置合并文件在部署期间自定义 使用该文件在实例首次启动之前更新默认 。

对于任何新安装的实例，必须更改几个启动设置，以及应该查看的其他设置。本节讨论最初要考虑的这些设置：

内存和启动设置

当第一次安装 时，应该查看和调整内存分配以及其他配置设置。在确定 实例使用内存的方式时，必须采取三个主要操作，如下所示：

• 使用内存和启动页面（系统管理 > 配置 > 系统配置 > 内存和启动）为数据库和例程缓存分配内存。

• 设置 IRIS 进程可以使用的最大内存

• 配置通用内存堆（也称为共享内存堆）的大小，这决定了 IRIS 可用于例程和数据库缓存之外的其他用途的内存；

重要提示：首次安装 时，数据库和例程缓存内存分配设置为自动，在此情况下， 为数据库缓存（全局缓冲区）分配总物理内存的 25%。

此设置不适用于生产用途。

除内存设置外，内存和启动页面还包括以下内容：

• 系统启动时自动启动 — 在

第四章 使用管理门户（四）

管理门户页面参考

管理门户由多个页面组成，分为以下功能区域：

• 主页Home — 管理门户主页
• 健康Health — 医疗保健页面。仅适用于 IRIS for Health™ 和 HealthShare® Health Connect。
• 分析 — 商业智能页面
• 互操作性Interoperability — 产品页面
• 系统操作 — 系统操作页面
• 系统资源管理器 — 数据库管理页面
• 系统管理 — 系统管理页面

Home

主页包含许多用于导航管理门户的选项。

Health

和 中的医疗保健特定功能显示在管理门户的 Health 部分的可用页面上。在访问这些健康页面之前，需要安装 命名空间。

Analytics

商业智能页面分为管理门户的分析部分中显示的类别。

Interoperability

产品页面分为管理门户的互操作性部分中显示的类别。

System Operations

系统操作员页面分为管理门户的系统操作部分中显示的类别。下表显示了每个类别和相关的文档来源。

第三章 使用管理门户（三）

浏览管理门户

管理门户有两种不同的视图模式可供选择以进行页面导航。可以通过单击管理门户功能区中所需的查看按钮随时在查看模式之间切换。视图模式有：

• 分栏视图 Columns view ——分栏显示页面；这是默认模式。此查看模式允许选择收藏夹并分配自定义资源。
• 列表视图 List view — 在下拉列表中显示页面名称。

注意：除了使用视图导航管理门户外，还可以通过位于功能区中的搜索工具直接进入页面；有关详细信息，请参阅本章中的管理门户功能区部分。

Columns view

“列视图”显示用于到达目标页面的子菜单。如果单击最终子菜单中的标题/名称，则会显示目标页面；如果在框内单击而不是在标题/名称本身上单击，则操作窗格将显示在右侧。

操作窗格

操作窗格解释了一个菜单选项，并允许执行与其相关的多项操作。要在“列”视图中显示操作窗格，请在最终子菜单中的选项周围的框内单击，而不是在选项本身上单击。可以在操作窗格中执行以下操作：

• 将目标页面添加到主页上的收藏夹列表中，如管理门户欢迎窗格中所述。
• 查看加载页面和分配自定义资源所需的系统资源，如在管理门户中使用自定义资源中所述。

注意：如果资源的名称在操作窗格中被截断，请将指针移到名称上以查看其全部内容。

• 单击 Go 转到目标页面。

操作窗格仅在“列”视图中可用。

第二章 使用管理门户（二）

管理门户概述

本节介绍管理门户页面的一些常见布局元素。

注意：在管理门户中的任何位置，将光标移到菜单项上都会显示该项目的描述。

管理门户主页

管理门户主页的标题是 Welcome, 。在标题旁边，功能区包含以下选项：

• 两个视图按钮，可让指定如何在菜单列中显示链接。
• 搜索栏，位于功能区的右侧。当指定一个词并按 Enter 键时，将显示包含该词的所有页面的列表；然后，可以单击要显示的目标页面，而无需浏览子菜单。

以下部分描述了主页的区域：

管理门户菜单栏

位于主页左边缘的菜单栏是导航门户的主要方法。

管理门户欢迎窗格

欢迎窗格位于主页的中心，包括经常访问的页面的快捷方式。它包含以下字段：

• 收藏夹Favorites — 列出选择为收藏夹的管理门户页面（请参阅操作窗格）；可以单击每个页面标题直接转到该页面。
• 最近Recent — 列出自上次启动 IRIS 以来最近显示的页面。
• Did you know? — 显示提示。
• 链接 Links - 指向可能想要访问的页面的链接。

管理门户消息窗格

位于主页右侧边缘的消息窗格显示一般系统信息并提供指向系统仪表板的链接。

如果实例是镜像成员，则消息窗格还显示它所属的镜像、其状态和成员类型以及指向镜像监视器的链接。

管理门户标题

页眉位于管理门户中每个页面的顶部，可用于快速导航门户。

标题包含以下链接：

• 主页 — 显示管理门户主页。
• 关于

测试环境为正式环境备份恢复，现在在测试环境尝试搭建mirror，重启了一下数据库，结果全部变为只读了，该怎么解决数据库的只读挂载呢？

[TOC]

第一章 使用管理门户（一）

IRIS数据平台使您能够通过 Web 应用程序Management Portal 执行系统管理和管理任务。这种方法的一个优点是 IRIS 不必安装在用来管理安装的系统上。现在，通过网络远程管理系统，受制于为站点建立的访问控制，变得更加容易。跨版本兼容性问题被最小化，因为数据及其格式信息都直接来自被管理的系统。

默认情况下，管理门户在安装了 的专用 Web 服务器上运行。可以选择禁用专用 Web 服务器（使用 设置）并配置不同的 Web 服务器来运行管理门户。

启动管理门户

可以通过以下方式启动管理门户：

• 在 Microsoft Windows 平台上，单击 IRIS 启动器菜单上的管理门户（Management Portal）。
• 在Web 浏览器中，直接转到管理门户 ，格式如下：

http://machine:port/csp/sys/UtilHome.csp

其中 是系统的 地址（例如 localhost）， 是 安装的 服务器()的端口号。例如，单个安装 IRIS 在本地服务器上的默认位置是 （其中 是默认的 IRIS Web 服务服务器端口号）。

根据系统的身份验证设置，必须先登录才能进入门户主页。有关登录要求的概述，请参阅管理门户登录页面小节。

第二十六章 源代码文件 REST API 参考（八）

GetEnsClassType

此方法返回用于创建产品的类的名称列表。可以指定要获取的类的类型，例如业务服务类。

URL

GET http://server:port/api/atelier/v1/namespace/ens/classes/type

type 是一个整数，并返回对应于该整数的类，如下所示：

• Adapters 1

• InboundAdapters 2

• OutboundAdapters 3

• Messages 4

• Requests 5

• Responses 6

• BusinessServices 7

• BusinessProcesses 8

• BusinessOperations 9

• DataTransformation 10

• Production 11

• BusinessHost 12

• Dashboard 13

• Rule 14

JSON Messages

以下返回的内容是一个类名数组：

{
  status: {
    errors: []
    summary: ""
  }
  console: []
  result: {
    content: [
        "Ens.Enterprise.MsgBank.BankTCPAdapter",
        "Ens.Enterprise.MsgBank.ClientTCPAdapter",
        "Ens.InboundAdapter",
        "Ens.OutboundAdapter"
    ]
  }
}

第二十五章 源代码文件 REST API 参考（七）

Query

此方法对 IRIS 表执行 SQL 查询并返回结果。请求正文是指定查询的 JSON 对象。它返回一个匹配查询条件的对象数组。每个返回的对象都包含与查询返回的一行相关的信息。

URL

查询在 URL 请求的正文中指定。查询必须在指定的命名空间中指定一个数据库。

此调用需要标头

JSON Messages

返回内容是一个对象数组。错误将出现在每个源代码文件对象的状态属性中：

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "content": [
      {
        "ID": "%all",
        "Description": "The Super-User Role"
      },
      {
        "ID": "%db_%default",
        "Description": "R/W access for this resource"
      },
      {
        "ID": "%db_irislocaldata",
        "Description": "R/W access for this resource"
      },
      ...
      {
        "ID": "%sqltunetable",
        "Description": "Role for use by tunetable to sample tables irrespective of row level security"
      }
    ]
  }
}

第二十四章 源代码文件 REST API 参考（六）

Compile

此方法编译源代码文件。它允许一次编译多个源代码文件。它返回一个对应源代码文件对象的数组。

要编译的文件列表作为 JSON 数组在 http 请求的正文中传递。例如，[ "%Api.DocDB.cls", ... ]。

有关示例和其他详细信息，请参阅本手册教程章节中的编译文件。

URL

此调用需要标头 。

URL Parameters

• 可以传递 URL 参数“flags”（默认为“cuk”），该参数将传递给编译器。

• 如果不希望返回已编译的源代码文件的源，则可以使用值 传递 参数 'source'。

JSON Messages

以下是编译 Atelier.NewClass1 时返回的内容：

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [
    "Compilation started on 01/12/2016 17:44:00 with qualifiers 'cuk'",
    "Compiling class Atelier.NewClass1",
    "Compiling table Atelier.NewClass1",
    "Compiling routine Atelier.NewClass1.1",
    "Compilation finished successfully in 0.067s.",
    ""
  ],
  "result": {
    "content": [
      {
        "name": "Atelier.NewClass1.cls",
        "status": "",
        "content": [
          "Storage Default",
          "{",
          "<Data name=\"NewClass1DefaultData\">",
          "<Value name=\"1\">",
          "<Value>%%CLASSNAME</Value>",
          "</Value>",
          "</Data>",
          "<DataLocation>^Atelier.NewClass1D</DataLocation>",
          "<DefaultData>NewClass1DefaultData</DefaultData>",
          "<IdLocation>^Atelier.NewClass1D</IdLocation>",
          "<IndexLocation>^Atelier.NewClass1I</IndexLocation>",
          "<StreamLocation>^Atelier.NewClass1S</StreamLocation>",
          "<Type>%Storage.Persistent</Type>",
          "}",
          ""
        ],
        "db": "IRISSYS",
        "ts": "2016-01-12 17:44:00.053",
        "enc": false,
        "flags": 1
      }
    ]
  }
}

第二十三章 源代码文件 REST API 参考（五）

DeleteDoc

此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。

与源代码文件有关的错误将在源代码文件对象的状态属性中。

有关示例和其他详细信息，请参阅本手册教程章节中的删除文件。

URL

DELETE http://server:port/api/atelier/v1/namespace/doc/doc-name

注意：如果要删除 CSP 文件 ，则 doc-name 的值包括 /（斜杠）字符。这就是定义 的 包含此参数名称的 () 而不是 的原因。有关详细信息，请参阅创建 服务中的“为 创建 URL 映射”。

JSON Messages

以下是源代码文件 的 的返回内容：

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "name": "xyz.mac",
    "db": "INVENTORYR",
    "ts": "",
    "cat": "RTN",
    "status": "",
    "enc": false,
    "flags": 0,
    "content": []
  }
}

创建只读账号，分配资源新建角色，资源限制只读，但新建的用户还是可以修改。。。

分配的是所有以%DB和%service开始的资源，但部分是Use的权限，搞不明白。。。

我该怎么创建一个sql 的只读账号呢？

第二十二章 源代码文件 REST API 参考（四）

PutDoc

此方法保存提供的源代码文件。如果文件不存在，此方法将创建它，如果文件存在，此方法将现有文件替换为指定的文件。为确保覆盖文件的正确版本，请指定 If-None-Match 标头以及先前 PutDoc 或 GetDoc 的 标头中返回的时间戳值。如果要覆盖文件而不检查版本，请指定 参数。该方法返回一个对应的源代码文件对象。如果要保存二进制文件，请将传入 消息的 元素设置为 ，并将文件内容包含为 块数组。如果在保存过程中更改了服务器上的文本（例如通过源代码管理挂钩），则更新后的文本将在返回的源代码文件的内容数组中返回。

与源代码文件有关的错误将在返回的源代码文件对象的状态属性中。

版本 能够接受三种格式的文件内容：默认 格式、XML 格式和旧 导出实用程序使用的格式。 自动识别文件内容的格式。

有关示例和其他详细信息，请参阅本手册教程章节中的在命名空间中创建新文件或更新现有文件。

URL and Input JSON Message

以下是源代码文件 xyz.mac 的 的输入 JSON 消息示例：

{
 "enc": false,
 "content": [
   "ROUTINE xyz",
   "xyz ;",
   "   w \"hello\""
   ]
}

下面是一个ObjectScript片段，它允许为InterSystems IRIS创建数据库、命名空间和Web应用程序:

	set currentNS = $namespace
	
	zn "%SYS"
	
	write "Create DB ...",!
	set dbName="testDB"
 	set dbProperties("Directory") = "/InterSystems/IRIS/mgr/testDB"
 	set status=##Class(Config.Databases).Create(dbName,.dbProperties)
	write:'status $system.Status.DisplayError(status)
	write "DB """_dbName_""" was created!",!!
	
	
	write "Create namespace ...",!
	set nsName="testNS"
	//DB for globals
	set nsProperties("Globals") = dbName
	//DB for routines
	set nsProperties("Routines") = dbName
	set status=##Class(Config.Namespaces).Create(nsName,.nsProperties)
	write:'status $system.Status.DisplayError(status)
	write "Namespace """_nsName_""" was created!",!!
	
	
	write "Create web application ...",!
	set webName = "/csp/testApplication"
	set webProperties("NameSpace") = nsName
	set webProperties("Enabled") = $$$YES
	set webProperties("IsNameSpaceDefault") = $$$YES
	set webProperties("CSPZENEnabled") = $$$YES
	set webProperties("DeepSeeEnabled") = $$$YES
	set webProperties("AutheEnabled") = $$$AutheCache
	set status = ##class(Security.Applications).Create(webName, .webProperties)
	write:'status $system.Status.DisplayError(status)
	write "Web application """webName""" was created!",!
	
	zn currentNS

在Caché基础课程中，同学们同时学习了Caché开发和ObjectScript语法。为了帮助大家完成练习，我们提供了ObjectScript快速参考（俗称 "小抄"）。

它不是所有ObjectScript的参考资料! 它是学生在课程中使用的ObjectScript命令和函数的列表，以及对象、集合等的常用语法。它还包含一些有用的宏。

我们正在为开发者社区提供一个pdf版本。

在测试你的代码时，你经常会遇到需要检查对象的实际内容。无论是使用 ZWRITE 还是 $system.OBJ.Dump()，

你会得到一个简单的属性图片，"--- 属性值---"

而 "--- swizzled references ---" 更容易让人混淆 

用“--- calculated references ---" 你只是被留在了后面。

ObjectScriptt至少有三种处理错误的方法（状态代码status codes、异常 exceptions, SQLCODE等）。大多数系统代码使用状态码，但由于一些原因，异常更容易处理。在处理遗留代码时，你要花一些时间在不同的技术之间进行转换。我经常使用这些片段作为参考。希望它们对其他人也是有用的。

///Status from SQLCODE:set st $$$ERRORClass Extends