[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内容处理程序的可定制方法

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

第六章 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， 如下面的示例:

那些已经与ECP合作过的人可能知道它不仅在操作系统，处理器技术（big-little-endian），但在C / E的各个版本中也有限制。
此交叉版本功能还包括IRIS（针对2020.1进行了验证）和C / E（2018.3）

在ensemble使用$SYSTEM.Encryption.SHA1Hash()加密“ensmble”得到“t????????????m??Afù????÷??%í”，但使用网络的SHA1加密方法得到”74ba9a06cbbc92f06d9b4166f9c5b4f7f8251aed“，如何使用ensemble得到与网络上一样的加密结果

m 里面如何获取cpu的序列号？

最近尝试使用 Set Ciphertext=##class(%SYSTEM.Encryption).RSAEncrypt(Plaintext,PublicKeyStr)来加密数据，但是加密失败，参考了以下资料https://community.intersystems.com/post/format-public-key-when-using-rs…

https://blog.ndpar.com/2017/04/17/p1-p8/

生成的公钥为

-----BEGIN PUBLIC KEY-----
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCvl8YRMOJMUOyK5NzWo+8FD8dG
R3DuPwn7M13If+rwYp18TEL58NneFdCL+Jjytx4axq+uhPuup5HtmEm22+PQTzFl
XuAhXf3oUm4LQl4zgSb14D6gfqac9DqbVhm+aUjDfItFapM35/DH2cvc+rbBhu4Q
5Y6kJwcUK0UbRv3swQIDAQAB
-----END PUBLIC KEY-----

转换为pkcs1后的内容为

我需要能修改xml 文件里面某个节点的值，目前 使用的方法是EnsLib.EDI.XML.Document 里面的SetValueAt，但是导入的字符串或者流有中文的话，或者设置新值包含中文的话，使用 OutputToString输出字符串，中文是乱码的，怎么处理呢

服务器操作系统频繁产生错误日志“生成了一个严重警告并将其发送到远程终结点。这会导致连接终止。TLS 协议所定义的严重错误代码是 10。Windows SChannel 错误状态是 10。” 想请问一下，这个错误信息是我们产品导致产生的问题吗？

大家好，

我正在创建WS做服务器用，但是当我要求WSDL时，提示错误因为找不到类。
我添加了以下说明：

set ^SYS("Security","CSP","AllowClass","MiProyecto.MiClaseWS","%SOAP.WebServiceInfo")=1 
set ^SYS("Security","CSP","AllowClass","MiProyecto.MiClaseWS","%SOAP.WebServiceInvoke")=1

我已经在WS安全配置中创建了一个入口

在“应用程序角色”选项卡中，我配置了％All权限

（图像中的命名空间“Samples”是出于安全原因）

如果我以以下方式调用服务，则http：// localhost：57772 / myproject / ws / MyProject.MiClassWS.cls？ WSDL提示以下错误：

Not Found
The requested URL /miproyecto/ws/MiProyecto.MiClaseWS.cls was not found on this server.

但是，另一方面，如果我执行以下命令，它可以正常工作： https：// localhost：57772 / csp / sample / MiProyecto.MiClaseWS.cls？wsdl 。

关于WebService接口采用适配器为

Parameter ADAPTER;

有方式可以获取到调用方的IP地址等信息吗？

如图  dll放在 

我调用的方式如下 

期待能够在ensemble里面能便捷的调用dll，各种语言开发的dll，至少能支持c#生成的dll，

在使用过程中，碰到对接一些国内编码例如：GBK2312等系列的编码格式，碰到这类情况，应该如何处理？各位有没有好的解决方式？期待解答交流！

2021年3月23日 – 提醒：镜像Dejournaling的潜在数据完整性问

InterSystems 已经纠正了一个缺陷，该缺陷在极少数情况下会导致非主镜像成员的数据不一致问题。此缺陷影响到InterSystems产品的所有发布版本。

如果发生该缺陷，则会在镜像系统的正常运行中悄然发生。该缺陷的结果是，镜像成员未能删除数据库日志的子集，然后导致镜像成员之间的数据不一致。这对故障转移和异步成员都有影响。虽然这个缺陷遇到的可能性非常小，但InterSystems建议所有使用镜像的客户都要获得修正，并使用DataCheck验证镜像数据库的一致性。有关可能触发该缺陷的具体情况以及将遇到该缺陷的风险降至最低的步骤的更多详细信息，请联系全球响应中心（WRC）。

该缺陷的更正被确定为 SML2898、HYY2434 和 HYY2435，并将包含在所有未来的产品版本中，包括 Caché 和 Ensemble 2018.1.5 以及 InterSystems IRIS 和 InterSystems IRIS for Health 2019.1.2 和 2020.1.1。这些更正也可通过InterSystems全球响应中心（WRC）的Ad hoc分发版本获得。

如果您对这个提醒有任何疑问，请联系 Worldwide Response Center。

前面介绍了通过mirroring或shadow，使用journal日志过滤器的方式，在不改动数据模型的情况下实现InterSystems IRIS/Caché上的CDC能力。
但如果你可以修改InterSystems IRIS/Caché上的数据模型，也可以考虑使用DSTIME特性实现变更数据捕获。

DSTIME特性

DSTIME特性是InterSystems IRIS/Caché的嵌入式实时BI工具DeepSee用于跟踪数据变更的。
InterSystems IRIS和2011版之后的Caché，都支持DSTIME特性。它会自动记录数据库中SQL表记录或持久化对象的变更，并将变更记录写入持久化的多维数组^OBJ.DSTIME中。

DSTIME特性是针对于SQL表/持久化类的，因此需要为每个需要记录变化的表/持久化类开启。
当开启了DSTIME的表/持久化类，有记录插入、更新、删除时，InterSystems IRIS/Caché引擎会自动在^OBJ.DSTIME中记录这些操作。其格式为：
^OBJ.DSTIME(类名,DSTIME,对象ID) = 执行的操作代码

DSTIME:
当SQL表/持久化类的参数DSINTERVAL未被设置时，DSTIME=0；
当SQL表/持久化类的参数DSINTERVAL被设置时，DSTIME=1840/12/31午夜12点到记录发生时的秒数。

执行的操作代码：

一些熟悉SQL的用户希望用SQL表的方式获取InterSystems IRIS/Caché的变更数据。知道了Global和SQL表的对应关系，就可以知道是哪一张SQL表数据变化了，甚至通过SQL查询获取变更的数据。
下面介绍如何实现这种方式，和注意事项。

获取Global和SQL表的对应关系

通常InterSystems IRIS/Caché的持久化的对象模型（类）和SQL表之间有一一对应的关系；而持久化的对象模型和Global之间也有一一对应关系。建立Global和SQL表的对应关系，通常可以使用以下的SQL查询特定SQL schema下所有表对应的Global：

SELECT CC.SqlQualifiedNameQ SQLTable, CS.parent Class, CS.DataLocation 
FROM %Dictionary.CompiledStorage CS, %Dictionary.CompiledClass CC
WHERE CS.parent = CC.ID 
AND CC.SqlSchemaName= <schemaname>

其中<schemaname>是SQL的Schema名称; 返回字段SQLTable是SQL表名、Class是对象类名、DataLocation是保存数据的Global名称。

多种建模方式Global和SQL表的对应关系的影响

Caché Shadow

上次介绍了使用InterSystems IRIS/Caché的Reporting类型的异步镜像成员获取数据变更。但早期的Caché并不支持镜像，例如Caché 2008，它只支持Shadow。

在这些早期版本上是否也可以实利用Journal实现类似CDC的功能呢？答案是肯定的，就是利用Shadow服务器的Dejournaling filter routine (Dejournaling过滤器routine)。

Dejournaling filter routine

InterSystems Caché的 Dejournaling过滤器routine是一个用户自定义的routine，用于在Shadow服务器上过滤Journal记录。当配置了Dejournaling 过滤器后，Shadow服务器在redo journal前会自动调用Dejournaling过滤器routine。该routine传入参数以下：

1. pid：记录进程ID；
2. dir：源数据库目录；
3. glo：Global节点（包括下标）；
4. type： 操作类型，为S (Set)、K (Kill)、s (BITSET)、k (ZKILL)；
5. addr：Journal记录在Journal文件中的偏移量；
6. time：记录的时间戳。

JDBC 兼容性状态 **这是一篇  [InterSystems 常见问题解答网站](https://faq.intersystems.co.jp/)文章。   

版本 2009.1 及更高版本与 JDBC 4.0 API 兼容。 有关详细信息，请查阅以下文档。 [关于 JDBC 支持](First Look: JDBC and InterSystems Databases - InterSystems IRIS Data Platform 2020.3
)

大家好！

InterSystems IRIS 有一个名为 Interoperability（互操作性）的菜单。

它提供了轻松创建系统集成（适配器、记录映射、BPM、数据转换等）的机制，因此可以轻松连接不同的系统。

数据中继过程中可以包括各种操作，例如：为了连接没有正常连接的系统，可以根据目标系统的规范来接收（或发送）数据。 此外，在发送数据之前，可以从其他系统获取和添加信息。 还可以从数据库（IRIS 等）获取和更新信息。

在本系列文章中，我们将讨论以下主题，同时查看 示例代码 以帮助您了解工作原理以及在系统中集成互操作性时需要进行哪种开发。

• 工作原理
• 什么是Production
• 消息
• 组件创建
  • 业务操作
  • 业务流程
  • 业务服务

首先，我介绍一下我们将在本系列文章中使用的案例研究。

某公司运营着一个购物网站，他们正在更改产品信息的显示顺序以配合季节变化。
但是，有些商品无论季节如何都能卖得很好，而有些商品在意料之外的时间卖出，这不符合当前的显示顺序更改规则，
因此，我们研究了按照当天的温度而不是季节来更改显示顺序的可能性。 调查购买产品时的温度变得非常必要。
由于可以使用外部 Web API 来查询天气信息，因此我们计划收集购买时的天气信息，并将其记录在后面的审核数据库中。

案例非常简单，但您需要使用“外部 Web API”来收集信息，并且需要将获得的信息和购买信息结合起来记录在数据库中。

这是一个第三方写的在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 支持提供的服务！     

Caché/Ensemble/IRIS 中的 Global 通常在 SQL 访问中是不可见的  
本示例将展示如何克服此限制。

Global 扫描和切片

这是一个在 IRIS 2020.1 和 Caché 2018.1.3 上工作的代码示例
不会与新版本保持同步
也不会获得 InterSystems 提供的支持服务！   

大多数情况下，默认存储使用的 global 只有 1 个表示 IDKEY 的下标级别。 对于索引 global，可能有 2 个或更多下标级别。

数组、父子关系或扩展了基础数据类的持久化类 是具有更多下标级别的示例。 但所有这些 global 都非常统一。

在本文中，我们将讨论一个我每天都会使用的应用程序，当监控 InterSystems IRIS 平台上的应用程序和集成解决方案并查找所发生的错误时，我就会用到它。

在查找用来记录 InterSystems IRIS、Ensemble 和 Caché DBMS 中对象变化的解决方案时，我发现了一篇关于使用宏进行日志记录的好文章。 受到该文章的启发，我对其介绍的项目进行了分叉，并做了相应调整以满足一些特定需求。 生成的解决方案以面板子类 %CSP.Util.Pane 的形式实现，它具有主命令窗口、“Run”（运行）按钮和已启用的命令配置。

该应用程序允许查看和编辑 global 数组、执行查询（包括 JDBC 和 ODBC）、通过电子邮件发送搜索结果（压缩的 XLS 文件）、查看和编辑对象，以及用几个简单图表来表示系统协议。

该 apptools-admin 应用程序基于 jQuery-UI、UiKit、chart.js 和 jsgrid.js。 欢迎查看源代码。

安装

仓库中详细介绍了所有安装方法。 但是，最简单的方法是使用包管理器命令：

大家好！

如您所知，我们发布了 InterSystems Open Exchange — 面向 InterSystems 数据平台上的解决方案和工具的市场！

但是如何在 OE 上发布应用程序？

在开始前，我先回答几个基本问题。

在数据库中，第一个模拟考试空间用作双引号，并且返回消息被转换为单引号。

当您首次使用InterSystems IRIS时，通常只需安装最低安全级别的系统。您输入密码的次数会比较少，这样有利于快速了解和操作开发服务和Web应用程序。而且，最低的安全性有时更便于部署开发项目或解决方案。

然而，有时需要将项目移出开发环境，迁移到一个可能很不友好的互联网环境中。在部署到生产环境之前，需要使用最大的安全设置（即，完全锁定）对其进行测试。这就是我们在本文中将要讨论的内容。

如果想更全面地了解InterSystems Caché、Ensemble和IRIS中的DBMS安全性问题，请阅读我的另一篇文章《在生产环境中安装InterSystems Caché DBMS的相关建议》。

InterSystems IRIS中安全系统的设计概念是针对不同的类别（用户、角色、服务、资源、特权和应用程序）应用不同的安全设置。

可以为用户分配角色。用户和角色可以对资源（数据库、服务和应用程序）拥有不同的读、写和使用权限。用户和角色还可以对数据库中的SQL表拥有SQL权限。

RESTful 应用程序编程接口 (API) 设计和文档编制初学者指南。 通过示例，您将学习一些常见的 RESTful API 模式。

在阅读之前

您需要知道

• 如何在 Ensemble 中创建 RESTful Web 服务
• 如何在 Ensemble 中使用 RESTful Web 服务
• 如何传递服务参数
• 如何返回服务结果

什么是服务 API？

什么是应用程序编程接口？ 是具体化的东西吗？ 是单一编程单元吗？ API 的作用是什么？ 在我看来，API 是由程序代码以间接方式决定的。 但完全定义的 API 是由运行可执行程序的容器（由部署设置控制）提供的。 因此，我宁愿将 API 定义为服务的公共描述。 该描述可以是人类可读的，也可以仅机器可读， 或者两者均可。 API 用于与将要使用服务的人员共享有关服务的基本信息。 API 说明了服务的作用、使用环境、功能以及管理的数据结构等。

在过去的好时光，“编制程序文档”或多或少是一种“必要之恶”。 现代编程语言通过在程序源码中引入声明来强制编制文档。 虽然声明是“机器人”可读的文档，但通过使用工具（runoff、Java doc...），可以提取信息并将其格式化成人类可读的格式。 即使没有在源码中添加任何一行真正的文档，这些工具仍然能够生成少量文本。

你好！

本文简单介绍一款工具，帮您理解InterSystems产品（从IRIS到Caché、Ensemble以及HealthShare）中的类及其结构。

简言之，它将类或整个包可视化，显示类之间的关系，并向开发人员和团队领导提供各种信息，而无需到 Studio 中检查代码。

如果您正在学习InterSystems产品，经常查看项目，或只对InterSystems技术解决方案中的新内容感兴趣，欢迎阅读ObjectScript类浏览器概述！

InterSystems 产品简介

IRIS（之前称为Caché) 是一个多模型DBMS。您可以使用SQL查询来访问它，也可以通过各种编程语言可用的接口与存储的对象和过程进行交互。但最多的还是使用DBMS原生内置语言--ObjectScript (COS) 开发应用程序。

Caché支持DBMS级别的类。有两种主要的类类型：Persistent（可以存储在数据库中）和 Registered（不存储在数据库中，扮演程序和处理程序的角色）。还有几种特殊的类类型：Serial（可集成到持久类中用于创建复杂数据类型（如：地址）的类），DataType（用于创建用户定义的数据类型）、Index、View 和 Stream。

进入类浏览器

调用 Web 服务的过程中，在期望的时间内未返回响应时，后续发生的情况由业务操作的几个设置来控制。

在本文中，我们将讨论孤立消息。

什么是孤立消息

每个消息正文都与一个保存元数据的消息标头相关联。 标头保存源配置名称、目标配置名称、创建时间、处理时间、关联的消息正文引用、会话信息、消息正文类名、消息状态等信息。 当有消息正文记录没有相应的标头记录时，这些消息正文称为孤立消息正文。 我们将讨论可能导致孤立消息正文产生的原因。

仅清除标头

在清除任务设置中，BodiesToo 设置用于指定是否将消息正文与消息标头一起清除。 如果关闭此设置，清除任务将只删除消息标头，而保留消息正文。 这些消息正文将成为孤立记录，因为所引用的标头已被删除。 如果清除消息标头但保留消息正文，则管理门户将无法清除孤立消息正文。 在这种情况下，必须以编程方式清除消息正文。

请参阅有关清除任务的文档

http://docs.intersystems.com/latest/csp/docbook/DocBook.UI.Page.cls?KEY=EGMG_purge#EGMG_purge_basic

复杂的消息正文类（对象值属性）

当 Ensemble 清除某条消息正文时，不一定删除该消息正文的对象值属性。 具体来说，只有当其他对象是序列对象或子对象（由关系定义）时，才会删除这些对象。 对于其他对象，必须通过在消息正文类中定义删除触发器或实现 %OnDelete() 方法来适当地处理删除。

OnDelete 实现的示例代码