在ensemble使用中遇到过重启组件失败需要强制更新的情况，报错为作业未在10秒内停止，此时需要手动停止报错的作业，或者重新启动production，强制更新是不能解决作业不能及时停止的问题，所以目前对强制更新的使用场景有疑问

In the use of ensemble, when the component fails to restart and needs to be forced to update, the error is that the job has not stopped within 10 seconds. At this time, the error reporting job needs to be stopped manually, or the production needs to be restarted. Forced update can not solve the problem that the job cannot stop in time. Therefore, there are so me questions about the use scenarios of forced update

    您可能已经听说，我们目前正在为所有正在使用 Caché 和 Ensemble 的客户提供限时免费迁移到我们的下一代数据平台 InterSystems IRIS 的机会。

    虽然我们依旧如往常一样全力支持那些正在使用 Caché 数据库和 Ensemble 集成引擎的客户，但我们还是认为 InterSystems IRIS 是未来的关键。它结合了 Caché 和 Ensemble 的所有功能，并添加了大量令人兴奋的强大功能，从机器学习到原生 Python。

    这也正是我们为现有客户提供迁移到 InterSystems IRIS 并使用这些新功能的原因。 我们也通过就地迁移支持轻松迁移，这意味着无需数据库转换、分步迁移指南、教程等。

    听起来挺有趣对吗？ 以下是我针对当前 Caché 和 Ensemble 应迁移到 InterSystems IRIS 的五个主要原因。

我想与您分享一些在 Caché 中同样存在但几乎不为人知且大多未使用的存储功能。 它们当然可以在 IRIS 中使用，并且在大型分布式存储架构中变得越来越重要。

Everyone

There is a setQueryTimeout method in the% Net.Remote.Java.JDBCGateway class of IRIS, how to use Ensemble2016 to achieve this function?

ensemble 如何调用socket服务

REF: https://docs.intersystems.com/healthconnectlatest/csp/docbook/Doc.View.cls?KEY=GREST

REF: https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=AFL_rest#AFL_C4838

开发REST服务有两个方式， 一个是生生的写代码， 定义接口的标准，被称为"Manually Coding"。第2个方式是目前越来越流行的"Sepcification-first"，也就是使用描述性的语言定义接口规范，然后通过这个规范生成接口代码。第2种方式更快捷，但这里我还是从第一种介绍起，对理解里面的代码层次更容易一些，而这是调试一个接口必须的。

从代码开发REST服务

不同于HTTP和SOAP, Ensemble里面没有REST的inbound Adaptor，也没有可用的BS组件。在Production里开发一个REST服务的步骤是：

在本文中，我將演示以下內容：

• 使用自定義實用程序函數從數據庫更新 ReferencesRange(OBX:7) 針對 ObservationIdentifier(OBX:3.1)[TestCode]
• 根據數據庫實用程序函數中的 ObservationIdentifier(OBX:3.1)[TestCode] 和 ObservationValue(OBX:5)[Result] 更新異常標誌 (OBX:8)
• 基於異常標誌的路由消息 (OBX:8)

以下是主要和轉換後的 HL7 2.5 ORU_R01 消息：
 

第 1 步：首先，我們需要在數據庫中保存參考範圍，為此我使用了 TestRanges 持久類：

第 2 步：我們需要創建一個自定義函數來獲取引用範圍，為此我在實用程序類中創建了 GetReferenceRange() ClassMethod 函數。 請注意這個類應該是來自 EnsRule.FunctionSet 的擴展

 

我們需要創建另一個函數來設置異常標誌，為此我在實用程序類中創建了 SetAbnormalFlag() ClassMethod 函數

分析

• 学习路径: 使用自适应分析建立数据模型
• 学习路径: 使用IRIS 商业智能BI建立数据模型
• 学习路径: 用InterSystems IRIS BI分析器BI Analyzer构建模型

其他

• 资源指南: 迁移资源指南
• 视频: 用交互式方式将应用从Cache迁移IRIS 演示Demo
• 学习路径: 实施合作伙伴起步 (金融行业) 和 所有行业
• 视频: 在Docker里运行InterSystems IRIS 社区版
• 视频: 开发和部署InterSystems Containers容器的工具

开发

• 视频: 什么是嵌入式 Embedded Python?
• 视频: 为多个ObjectScript 连接配置vs代码实现工作空间 Workspaces
• 视频: 在VS Code中用Objectscript 类进行客户端编辑
• 视频: 在InterSystems IRIS for Health 中将历史数据转化为HL7 FHIR R4 

服务

• 视频与练习: HealthShare 信息转化服务演示Demo与练习 exercise (S3 和 HealthLake 版本)

系统管理

• 课程 (更新): InterSystems 安全基础 (原Caché 安全概览)
• 视频: 配置 InterSystems Web Gateway 网关

<style type='text/css'>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;

本文解释了如何使用 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 简介

为什么要连接系统？

连接系统可以让一个系统处理来自非本系统的信息。例如，以下场景需要连接系统：

• 为了提高效率，最初设计为执行单一功能的系统需要集成。例如，您可以通过集成跟踪库存、订购材料、记录销售和控制运输的各个系统来提高效率。
• 系统合并后，在不同机构中执行相同功能的系统需要协同工作才能使统一的机构有效。

将系统连接在一起时，您可能会面临一些挑战，例如：

• 不同系统使用不同的通信协议：一个系统可能使用TCP，另一个系统使用SOAP，第三个系统使用REST。
• 不同系统使用不同格式或基于不同标准的不同消息。
• 需要保证消息成功传递到正确的系统，并能够检测和纠正故障。
• 必须监控传输消息的系统，如果一次消息过多，则为消息提供一个队列，并监控整体系统性能以确保没有任何障碍。

虽然可以编写自定义应用程序来连接系统，但开发一款InterSystems IRIS® 产品要容易得多，也快得多。

InterSystems IRIS 提供了一个框架，允许连接系统，并最大限度地减少或消除对自定义代码的需求。
 

Object Script(四)

面向脚本

• 类

类的主要类型

类成员

Object Script(三)

面向脚本

• Routine

可将routine看做全局可调用的函数，一个函数是一个执行程序(Roution)，它执行一个操作（例如，将一个字符串转换为其对应的ASCII码值）并且可以返回一个值。

语法结构：

Routine可以有一个标签，ObjectScript代码，以及结尾的注释，所有这些元素都是可选的。可以使用"；"或"//"来表示注释。对于多行注释，用"/*"标记注释的开头，用 "*/"标记注释的结尾。

结构示例:

标签

      ObjectScript代码

end

• 创建Routine示例

Studio创建:

打开Studio，点击左上角新建文件。选择General->ObjectScript Routine

将下段代码填写入建好的Routine。

hello ; hello world routinewrite !, "hello world"          write !, "bye"      endquit  ; end

Terminal调用：

打开Terminal，执行下段代码，即可检查结果。

    do ^hello

InterSystems IRIS/Caché的CDC

InterSystems IRIS/Caché未提供开箱即用的变更数据捕获（CDC）工具，而且由于其多模型建模能力和底层的多维存储模型，相对于关系型数据库的单一模型，针对于SQL的CDC在InterSystems IRIS/Caché上会更复杂一些。例如通过Journal日志记录的是底层持久化多维数组的数据变更，而不是SQL table的变更。

通常，在应用层面实现变更数据捕获是更灵活和简单的方式，例如通过设置触发器、类的DSTIME参数。但如果无法在应用层做CDC，可以考虑使用InterSystems IRIS/Caché的Journal和强大的开发能力获取数据变更。

这里介绍使用InterSystems IRIS/Caché的Reporting类型的异步镜像成员获取数据变更。

 <Ens>ErrRequestNotHandled: 请求消息 '8@Cenboomh.Soap.DT.request' 未被处理

ensemble提供的soap服务如何自定义URL地址

Java网关连接报错

查看消息列表报上图错误，希望看一下这种错误应该去那里看

2021 年 8 月的学习资料现在可以在learning.intersystems.com上独家获取！您可以：

• 先睹为快：2021 年虚拟峰会体验实验室
• 使用自适应分析（Adaptive Analytics）解决方案来组建你的第一个数据模型
• 免费试用 InterSystems IRIS 社区版
• 查看 InterSystems 文档中的分析
• 申请即将举行的线上技术课程

立刻报名！

 注意：老是错过最新消息？别担心，我们会在9月恢复正常的邮件发送。

Object Script(二)

• 特殊符号

ObjectScript没有定义任何保留字：你可以自由地使用任何字作为标识符（如变量名）。为了达到这个目的，ObjectScript使用了一组内置的命令以及特殊的字符（比如函数名的"$"前缀），以便将标识符与其他语言元素区分开来。

Object Script(一)

• 概况

ObjectScript是一种用于在InterSystems IRIS数据平台上快速开发编程语言，它是面向对象的弱类型脚本语言，非常适用于各种应用，包括业务逻辑、应用集成和数据处理。

在这里，我将主要介绍ObjectScript的命令脚本，类，方法和Routine等使用方式和语法规范。如有任何疑问，可在InterSystems开发者社区进行深入讨论。

• IDE选择

可以使用InterSystems IRIS内置的Studio或Visual Studio Code（需要安装Object Script扩展）来查看和编辑代码。这里我们使用InterSystems IRIS内置Studio来做示例。

如果你已安装InterSystems IRIS或者InterSystems HS 等任何InterSystems产品，找到右下角的图标 ，单击鼠标右键,点击Studio，如下图所示：

输入用户名和密码(用户名：superuser 密码：安装时自己设置的密码)，即可进入到Studio开发环境，如下图所示：

• Terminal

可以直接打开InterSystems IRIS的终端尝试执行ObjectScript的简单指令。通过右下角的图标 ，单击鼠标右键,点击Terminal，如下图所示：

• 命名空间

可以使用%SYS.Journal.File类中的ByTimeReverseOrder查询，以及%SYS.Journal.Record类中的List查询来实现。

下面是这两个查询的具体作用：

A) %SYS.Journal.File类中的ByTimeReverseOrder查询
这个查询会获取journal日志文件名并按降序排列

USER>set rs=##class(%ResultSet).%New("%SYS.Journal.File:ByTimeReverseOrder")
 
USER>do rs.Execute()
 
USER>while rs.Next() { write rs.Name,! }
c:\intersystems\cache\mgr\journal\20190620.003
c:\intersystems\cache\mgr\journal\20190620.002
c:\intersystems\cache\mgr\journal\20190620.001
c:\intersystems\cache\mgr\journal\20190610.001

B) %SYS.Journal.Record类中的List查询
这个查询可以从指定journal日志文件中获取日志记录

第十七章 类关键字 - DependsOn

指定此类应在编译器使其他(指定的)类可运行后编译。

用法

要指示类编译器应该在其他类可运行后编译此类，请使用以下语法:

Class MyApp.MyClass [ DependsOn = classlist ]  
{ //class members }

其中classlist是下列之一:

• 类名

[ DependsOn = MyApp.Class1 ]

• 用逗号分隔的类名列表，用括号括起来。

[ DependsOn = (MyApp.Class1,MyApp.Class2,...) ]

详情

此关键字指定类编译器应该在使指定的类可运行后编译此类。

如果此类的编译使用方法生成器逻辑中的这些其他类，则此关键字非常有用。如果类包含调用其他类的初始表达式，这也很有用。

此关键字仅影响编译顺序，不影响运行时行为。

注意:DependsOn关键字只影响具有System关键字的公共值的类。

此外，如果一个类有DependsOn=ClassA，那么它也有CompileAfter = ClassA也是多余的。

对子类的影响

这个关键字继承自所有超类。如果子类为关键字指定了一个值，该值指定了在子类被编译之前必须运行的附加类。

默认

默认情况下，不指定该关键字。

第十八章 类关键字 - Deprecated

指定不推荐使用此类。该关键字被类编译器忽略，只是提供了一个人类可读的指示，表明该类已被弃用。

用法

大家好，我想请教一个问题，如何在Health Connect实现访问共享文件夹的文件 （对文件进行读取或者写入操作，非本地文件）

[toc]

第二十八章 定制SAX解析器创建自定义内容处理程序

创建自定义内容处理程序

如果直接调用InterSystems IRIS SAX解析器，则可以根据自己的需要创建自定义内容处理程序。本节讨论以下主题：

• Overview
• 要在内容处理程序中自定义的方法的描述
• %XML.SAX.Parser类中解析方法的参数列表摘要
• 示例

创建自定义内容处理程序概述

要定制InterSystems IRIS SAX解析器导入和处理XML的方式，请创建并使用定制的SAX内容处理程序。具体地说，创建%XML.SAX.ContentHandler的子类。然后，在新类中，重写任何默认方法以执行所需的操作。在解析XML文档时使用新的内容处理程序作为参数；为此，需要使用%XML.SAX.Parser类的解析方法。

此操作如下图所示：

创建和使用自定义导入机制的过程如下：

1. 创建扩展%XML.SAX.ContentHandler的类。
2. 在该类中，包括希望覆盖的方法，并根据需要提供新定义。
3. 在使用%XML.SAX.Parser的分析方法之一(即ParseFile()、ParseStream()、ParseString()或ParseURL())编写读取XML文档的类方法。

调用分析方法时，请将自定义内容处理程序指定为参数。

SAX内容处理程序的可定制方法

第六章 Caché JSON 使用JSON适配器

JSON适配器是一种将ObjectScript对象(registered, serial or persistent)映射到JSON文本或动态实体的方法。本章涵盖以下主题：

• 导出和导入-介绍启用JSON的对象并演示%JSON.Adaptor导入和导出方法
• 带参数映射-描述控制如何将对象属性转换为JSON字段的属性参数。
• 使用扩展数据映射块-介绍将多个参数映射应用到单个类的方法。
• 格式化JSON-演示如何使用%JSON.ForMatter格式化JSON字符串。
• %JSON快速参考-提供本章中讨论的每个%JSON类成员的简要说明。

Exporting and Importing

从JSON序列化或序列化到JSON的任何类都需要子类%JSON.Adaptor，它包括以下方法：

• %JSONExport()将启用JSON的类序列化为JSON文档，并将其写入当前设备。
• %JSONExportToStream()将启用JSON的类序列化为JSON文档并将其写入流。
• %JSONExportToString()将启用JSON的类序列化为JSON文档并将其作为字符串返回。
• %JSONImport()将JSON作为字符串或流导入，或者作为%DynamicAbstractObject的子类导入，并返回启用JSON的类的实例。

HealthConnect中创建HTTP服务端

这里我说说怎么在HealthConnect上开发HTTP服务。

作为消息引擎，HealthConnect会需要从一个接口接收HTTP请求发送到另一个接口，中间做消息转换，路由等等，目的的接口可能是HTTP，或者SOAP，REST等等。这里只介绍HTTP服务的内容，也就是最简单的两种实现：

第一种：实现客户定制的HTTP服务业务服务组件(Business Servie)

创建Business Service类，继承EnsLib.HTTP.Service， 如下面的示例: