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

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

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

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

医疗行业的互操作性在改善病人护理、降低医疗服务提供者的成本以及为提供者提供更准确的情况方面发挥着重要作用。然而，由于有这么多不同的系统，数据的格式也有很多不同的方式。有许多标准被创造出来以试图解决这个问题，包括HL7v2、HL7v3和CDA，但每一种都有其缺点。

FHIR，即快速医疗互操作性资源，是一种新的医疗数据格式，旨在解决这些问题。它是由国际卫生级七组织（HL7）开发的，该组织还开发了HL7v2、HL7v3和CDA。

今天我们将探讨如何在VS代码中借助IntelliSense和自动完成功能，通过使用FHIR Schema 创建和验证FHIR资源。

第 1 步 :从FHIR 官方网站 https://www.hl7.org/fhir/下载 JSON schema file 文件用来做资源校验

第 2 步: 创建文件夹（在这个例子中，我使用病人文件夹和病人资源），并将提取的fhir.schema.json文件复制到同一文件夹，然后从VS Code中打开文件夹

第 3 步: 通过修改setting.json文件，设置VS代码以识别FHIR模式。
按CTRL+SHIFT+P并输入工作区设置JSON文件

第 4 步: 在同一文件夹中创建一个新文件patient.fhir.json。

如何在Ensemble中对字段类型为GlobalCharacterStream进行字符串搜索？String的可以搜索，但是Stream类型的就不行。

应用集成平台市场上产品众多，商家专家观点纷纭，莫衷一是。Gartner公司从用户角度出发，搭建了Peer Insight “大众点评”平台，让用户能够为自己使用的产品发声，对各个产品打分。以下是来自用户的声音，供参考。

第一款产品是微软的BizTalk，综合得分3.9。

第二款产品是InterSystems的Ensemble，综合得分4.6。

第三款产品是IBM的WebSphere Enterprise Service Bus，综合得分3.8。

BizTalk  by MicroSoft	Ensemble  by InterSystems	WebSphere Enterprise Services Bus by IBM
总体评价：57%的用户愿意推荐该产品	总体评价：88%的用户愿意推荐该产品	总体评价：55%的用户愿意推荐该产品
分项评分	分项评分	分项评分
综合能力得分	综合能力得分	综合能力得分
评估与签约     3.3 定价灵活性     4.0 理解需求的能力	评估与签约     4.2 定价灵活性     4.6 理解需求的能力	评估与签约     3.5 定价灵活性     4.0 理解需求的能力
集成与部署   3.4 部署便利性   3.

大家好，

我想知道是否有可能获取自身的值来运行查询。

我想创建一些查询以在％Persistent类中找到一个值，但是每个查询都使用不同的值。

Class Kurro.MyClass Extends %Persistent
{

/// Key of process
Property KeyProcess As %String(MAXLEN = "");

/// Specialist
Property CodeSpecialist As %String;

/// Provider
Property CodeProvider As %String;

/// Center
Property CodeCenter As %String;

/// Date
Property Date As %TimeStamp;

/// IdList
Property IdList As %String;

/// IdProcess
Property IdProcess As %String;

/// Duration
Property Duration As %String;

Query GetInfo(pObject AS Kurro.

大家好，

我需要根据用户请求删除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 ?

大家好，

我目前正在开发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”？

在Ensemble中使用SQL进行批量插入
你好，社区。

我试图在一个表中插入多个值。下面是简单的SQL语句。

插入到表X中

values ('Name', 'Address', 'Phone')

我怎样才能在一条语句中进行多次插入（行）？

数值不在另一个表中，所以我不能使用选择进入。

谢谢。

吉米-克里斯蒂安

Hello Community,

I am trying to insert multiple values in a table. Below is the simple sql statement.

Insert Into TableX

values ('Name', 'Address', 'Phone')

How can i do multiple inserts(rows) in one single statement?

Values are not in another table, so i cannot use Select into.

Thanks,

Jimmy Christian.

从Terminal 访问 global 内容，答案见英文社区：

https://community.intersystems.com/post/view-globals-terminal
 

大家好!

我正在创建一个脚本，从Ensemble Production中删除一个项目（Component），我知道有手动的方法，但由于有几个Component，我想用一个脚本来更快。

我试着用%Delete()并在Ens.Config.Item上做选择，但这最终在生产中产生了几个错误。有谁知道我怎样才能简单地做到这一点？

答案参见：https://community.intersystems.com/post/delete-item-production

Hi, 请问如何更改表（有数据）上的主键？谢谢！

答：

如果数据已经存在，那么这是一项必须重视的任务，特别是如果存在继承或父/子关系，因为这将导致你的数据存储方案的改变。

最简单的方法是通过一个中间（临时）表来实现。

创建一个具有相同结构的新类，但有一个新的主键。
使用SQL（不是合并命令）将数据从旧的类中移到它里面。
删除旧类中的数据/索引，然后改变其中的主键。
使用合并命令，将数据从新类移到旧类中。
删除带有数据的新类。
重建索引（如果有的话）。

几个有用的链接：
        MERGE

        持久性对象和InterSystems IRIS SQL

        持久性对象的介绍

如果仍然有问题，最好向WRC寻求帮助。

本片文章主要介绍两种Production debug的方式，

• 使用管理门户测试Production 组件
• 使用VS Code来对远程production代码进行debug

%XML.XPATH.Document中CreateFromFile方法，pSource入参传https开头的webService地址，解析报错“错误 #6901: XSLT XML转换器错误: unsupported protocol in URL in at line 0 offset 0”

如： zw ##class(%XML.XPATH.Document).CreateFromFile("https://localhost/services/MessageNotify?wsdl",.tDoc,,,,,"http://schemas.xmlsoap.org/wsdl/")

InterSystems许可证是指InterSystems发放的电子或纸质版的产品许可证，内容包括许可证订购日期、产品描述等。

激活码/License Key是InterSystems随许可证发放的许可软件激活码。通常情况下，客户收到的是电子许可证。

以下是一些许可证，激活码/License key常见咨询问题参考：

1. 收到电子许可证后，如何获取纸质版许可证？

纸质版许可证或是安装介质盘，可通过合作伙伴或是致电原厂核验许可证信息后获取。

2. 如需申请WRC支持，需要

申请准备：

• WRC账号，如无请通过WRC联络信息申请WRC账号
• 故障问题描述
• 许可证或激活码/License key
• 最终客户名称 

WRC全球响应中心联络信息：

• 电话: +86 400-601-9890
• 邮件: support@intersystems.com
• 网站1（国内用户）: https://wrc.intersystems.cn/
• 网站2:https://wrc.intersystems.com

3. 如何查询您的授权文件客户名和授权密钥？

在检查我们的^pButtons（在IRIS中改名为^SystemPerformance）性能监控工具的文档时，一位客户告诉我。"我理解所有内容，但我希望它能更简单......更容易定义配置文件，管理它们等等"。

在这次会议之后，我认为尝试为其提供一些更简单的人机界面是一个不错的试验。

这方面的第一步是在现有的pButtons例程上包裹一个基于类的API。

我还能够添加一些更多的 "功能"，比如显示当前正在运行的配置文件，它们剩余的运行时间，以前运行的进程等等。

下一步是在这个API的基础上添加一个REST API类。

有了这个工件（pButtons REST API），人们就可以在上面建立一个比较时髦的用户界面。

举个🌰： -

业务服务Business Service/BS是能够支持我们从外部数据来源获取数据强大的组件，在在大多数情况下，内置的现成组件就已经可以完成这项工作，但有时候我们还是需要写编码来自定义业务服务。在这样做的时候，有一些最佳实践供大家参考。

1. 精益求精--业务服务的代码应该是最小化处理。这是由于如果在业务服务中发生任何错误，将不发送任何消息，从而将不创建任何跟踪。这使得它很难进行故障排除。相反，要尽可能快地完成Ensemble消息，并将其传递给适当的目标。有些人认为，如果有一个流进来，Ensemble消息应该包括一个流属性，然后由一个业务流程来解析这个流。(见文档中的例子3）还有人说，只要包括良好的错误检查，最小的处理就可以了。在这两种情况下，请记住，数据转换是存在的，可以在业务流程中使用，以便对该数据做进一步的翻译。这些转换不应该被从业务服务中调用。(参见文档中的示例1）。
2. 可配置的目标：--在大多数情况下，业务服务的代码应该是一个可配置的目标，而不是将其硬编码到业务服务中。要做到这一点，你可以在业务服务类中创建一个名为TargetConfigNames的属性，其类型为Ens.DataType.ConfigName，使用SETTINGS参数并将此设置放在配置页上。

本文档介绍了如何在 InterSystems IRIS®数据平台中使用 Java 网关（Gateway）与 Java 组件进行互操作。在本文中，您将首先创建一个示例 JAR 文件。然后，您将在 InterSystems IRIS 管理门户（Management Portal）中创建并启动 Java  网关（Gateway）。您将以编程方式导入创建的示例 JAR 文件。最后，您将在 ObjectScript 中创建并操作一些代理类（proxy class）和对象（object）。

为了让您体验 Java 网关（Gateway ），而又不陷入细节困境，我们保持了简单的探索。这些活动被设计成只使用默认设置和功能，这样您就可以熟悉功能的基本原理，而不必处理那些离题或过于复杂的细节。当您把 Java 网关（Gateway）引入您的生产系统时，您可能需要做一些不同的事情。请确保不要把这种对 Java 网关（Gateway ）的探索与真实的情况相混淆！本文档末尾提供的参考资料将使您对在生产中使用 Java 网关（Gateway）的情况有一个很好的了解。

要浏览所有的技术概要（First Look），包括下面描述的可以在免费的社区版（Community Edition）实例上执行的那些，请参见 InterSystems 技术概要。

各位老师，你们好

我在浏览器地址中输入HealtConnect发布的webService地址报 CSP应用程序错误，并记录了此错误,不过该地址还是能正常访问。

我想知道怎么解决这种报错问题，谢谢！

以下图片为HealthConnect的版本，以及具体出现的错误

Object Script(六)

• 
  

  变量的类型

ObjectScript中的变量是没有类型的，也就是说，它们没有一个指定的数据类型，可以接受任何数据值。

ObjectScript支持以下几种类型的变量：

1. 本地变量 ：只有创建它的进程可以访问的变量，当该进程终止时，改变量将自动删除。一个本地变量可以从任何命名空间访问。

示例:

     SET str = "A string"

2. 进程私有的全局变量 ： 只有创建它的进程可以访问的变量，并且在进程结束时不再存在。一个进程专用的全局变量可以从任何命名空间访问，因为它与命名空间无关。进程私有的全局变量对于临时存储大数据值特别有用。在许多情况下，它们可以替代Mgr/Temp目录的使用，在进程终止时提供自动清理。

示例：

       SET ^||flintstones(1)="Fred"

       SET ^||flintstones(2)="Wilma"

3. 全局变量 ： 一个存储在InterSystems IRIS数据库中的持久性变量。一个全局变量可以从任何进程中访问，并且在创建它的进程终止后仍然存在。全局变量是针对个别命名空间的。

示例：

SET ^myglobal = "This is a global stored in the current namespace"

4.

Object Script(五)

• 
  

  在类中定义属性

Property PropName as Classname(PARAM1=value,PARAM2=value) [ Keywords ] ;

Property SSN As %String(PATTERN = "3N1""-""2N1""-""4N") [ Required ];

• 
  

  创建函数示例

Studio创建:

将下段代码填写入建好的类中：

ClassMethod FindPatient(id As %String) As HIS.Patient
{ 
 Set patient= ##class(HIS.Patien).%OpenId(id)       
 Quit patient
}

Terminal 调用：

set p = ##class(HIS.Patient).

IRIS Interoperability互操作性/HealthConnect（前身是Ensemble）有许多内置的适配器。但是没有一个接收邮件的服务或适配器。我洗的了一个电子邮件服务，通过SMTP接收邮件，这些邮件可以被传递到电子邮件操作。

现在我想对一个使用电子邮件操作向外部邮件服务器发送邮件的Production进行负载测试。邮件服务器团队不希望我向他们发送成千上万的信息。

我创建了iris-mail应用程序来替代邮件服务器。我更新了电子邮件操作中的服务器和端口设置。外发的邮件被发送到替代的邮件服务器，我能够计算出iris-mail中收到的邮件数量，并将其与邮件操作发送的邮件数量进行比较。

应用程序的源代码：https://openexchange.intersystems.com/package/iris-mail

InterSystems Production 监控是管理门户中的一个页面，用于显示当前运行的Production监控信息。我喜欢这个页面的样子，但这并不适合所有人。

2022年5月13日，我在开发者社区上看到这个帖子。

https://community.intersystems.com/post/creating-custom-monitoring-page

我同意马克的观点，Production监控很复杂。我想创建一个更漂亮干净的监控页面。

我开始着手制作一个利用类方法提供Production数据的 CSP（Cache Server Page）页面。

我与马克分享了我的第一次尝试。他根据自己的想法定制了这个页面。我喜欢他对页面的布局，使其在视觉上更有吸引力。我把他的设计整合到我的应用程序Production监控中。

我看到马克对业务服务的显示进行了过滤，只显示需要注意的服务。他在页面的底部添加了服务器的名称和它的镜像状态。

你可以在Open Exchange和当前的竞赛中找到我的Production监控器的应用。

https://openexchange.intersystems.com/package/production-monitor

#Open Exchange

您可能已经看到邀请分享您的 Open Exchange 应用程序的演示：Share a Demo of Your Open Exchange Application
它背后的服务——InterSystems Online Demo Server (ODS)——这不是什么新事物

作为奖励积分，我在 21 年 3 月的 InterSystems 开发者工具大赛：InterSystems Developer Tools Contest 中第一次看到它。
在后来的比赛中成为一个固定的奖励项目。实际是#24。
到今天，我们已经看到 OEX 中列出了 80 个可在 ODS 上使用的软件包：80 packages listed in OEX as available on ODS 

对我来说，开发人员的优势是显而易见的：

• 给予您的“客户”直接访问您产品的渠道。
  • 视频也是一个很好的推广工具。
  • 但是您知道使用自己的产品并没有那么令人印象深刻。

• 您的 Docker 容器是在“规范”安装中构建的。
  • 毫无疑问，Docker 是一个令人印象深刻的工具。
  • 在 Win、MAC 和 Linux 上有各种可能会让人头疼的版本。
  • 我跳过关于特殊功能和设置的个人赘述。
  • 您的“客户”可以节省时间来快速查看您提供的方案。
  • 您可以确定他会看到您计划让他看到的内容。

在使用xDBC连接到字符集为US7ASCII的Oracle数据库时，大家可能遇到过中文的乱码问题，尤其是使用Oracle自己的xDBC驱动的时候。

字符集为US7ASCII的Oracle数据库虽然可以保存中文数据，但给客户端带来了很多麻烦，需要对获取和提交的数据进行转码。

在Ensemble/Health Connect/InterSystems IRIS 中使用SQL适配器连接到这样的Oracle数据库时，可以使用$ZCVT函数进行转码。

1. $ZCVT函数

$ZCVT函数是广泛使用的字符串转换函数，可以做大小写转换、编码转换、URL 和 URI 转换等。我们用其编码转换能力来解决字符集转码问题。

2. 获取的SQL结果集数据有中文时

这时，Oracle的驱动返回的中文数据通常是GB码，而不是Unicode或UTF码。可以通过$ZCVT函数对GB码的数据进行转码，转换为Unicode：

Set tCorrectData = $ZCVT(tOriginalData,"I","GB18030")

其中$ZCVT函数的第一个参数tOriginalData是获取到到结果集字段值；第二个参数“I”说明tOriginalData是输入字符串；第三个参数“GB18030”是说明输入字符串的字符集编码是GB18030。

     在软件开发和业务集成中，规则无处不在：会员折扣的计算规则、根据消息类型和内容将其路由到不同目标系统的路由规则。还有一个规则发挥重要作用的地方-  辅助决策规则，例如临床知识库和医疗质量指标规则。

规则经常需要随业务调整和知识积累进行调整，而规则的调整是业务和行业专家定的。如果规则是以代码硬编码的，这些调整需要程序员改动，一来不直观、需要业务专家与程序员大量的沟通成本，二来硬编码改动会对应用伤筋动骨，甚至带来风险，三来没法控制新规则生效的时间 – 总不能让程序员在新规则生效的那一刻去编译和部署吧。

InterSystems规则引擎可以帮助我们解决这些问题，于构建、执行和记录消息路由规则和普通的业务规则，带给应用和集成方案充分的灵活性和可用性。甚至业务专家和临床信息学家都可以通过低代码的、图形化的规则编辑器修改规则和指定规则生效和失效时间。

InterSystems规则引擎是InterSystems IRIS数据平台和Health Connect与Ensemble集成平台的组件。创建的规则可以被单独调用，也可以被业务流程调用。

本篇介绍规则的如何使用InterSystems规则编辑器创建规则和规则引擎执行规则的逻辑。

1. 规则基本概念

    在设计规则前，先了解一下规则的基本概念。

1.1 上下文

上下文是用于规则定义的数据模型。

在一次重大的版本升级中，建议重新编译你所有命名空间的类和例程。 (主要版本的安装后任务).

do $system.OBJ.CompileAllNamespaces("u")

do ##Class(%Routine).CompileAllNamespaces()

为了自动完成这项管理任务并记录任何错误，下面是一个导入并编译到USER命名空间的类的例子，你可以在每次升级后使用它 : admin.utils.cls

Class admin.utils
{
ClassMethod upgrade(verbose As %Boolean = 0) As %Status
{
set ns=$Namespace
// Stopping all productions
do .stopAllProductions(verbose)
zn "%sys"
kill ^[ns]upgradeLog
// UpgradeAll
set ^[ns]upgradeLog("UpgradeAll")=$zdt($now(),3,,6)
set start=$zh
do $system.OBJ.UpgradeAll(,.errorLogUpgrade)
do ##class(%SYSTEM.

InterSystems流程自动化与工作流引擎

InterSystems工作流程引擎的主要功能    2

使用InterSystems工作流程引擎    3

场景描述    3

环境配置与测试    5

任务管理    15

任务API和自定义任务用户界面    16

展望    17

15

集成平台除了集成业务系统，打通数据与业务流程外，另一个核心的功能就是流程自动化(BPA)。

流程自动化涉及几个重要的特性：

1. 流程建模
2. 流程协同
3. 决策自动化
4. 低代码工作流程自动化
5. 任务协同与任务管理

其中第4和5点都是和工作流程相关的。

什么是工作流程(Workflow)？它和业务流程(Business Process)有何区别？为何集成平台要涉及对工作流程的管理？

8. 应用安全

InterSystems数据平台上可能运行着多种应用，例如Web网页应用、SOAP服务、REST API、HL7 接口、SQL服务等等。这些应用种类繁多，面临的安全风险也是巨大的，例如代码注入攻击和HTTP的跨站请求伪造攻击等。

这其中代码注入攻击和针对Web应用的攻击尤其需要重视。

8.1 代码注入攻击

代码注入攻击通常和我们编写的程序相关，需要在程序编写时注意避免。

8.1.1 SQL注入攻击

SQL注入攻击是典型的代码注入攻击，通过从外部注入恶意SQL语句获得数据权限并获得敏感数据。关系型访问方式都是通过客户端SQL语句传入执行的，因此它是数据库重点需要防范的。

InterSystems数据平台并不支持以分号分割的多条SQL语句作为一个SQL命令执行，因此它本身免疫了主要的SQL注入攻击手段。

InterSystems数据平台支持动态SQL，即允许SQL命令作为方法的字符串参数传入，这会给SQL注入攻击留有隐患。在编程时，应避免开放服务用于接受完整的SQL语句作为参数，而是通过SQL动态传参来构建运行时SQL。

InterSystems数据平台支持行级安全，这有助于避免在SQL注入攻击时，将所有数据返回给攻击请求。

8.1.2 $ZF

InterSystems数据平台提供了系统函数$ZF，用以调用外部命令。其中$ZF(-1)和$ZF(-2)用以调用服务器操作系统的命令。

6. 用户与角色

InterSystems 数据平台对用户和角色提供全面的管理和安全配置功能。加强数据平台的安全，需要加强对于用户和角色的管理。

6.1 用户管理

系统提供了一系列预置的用户账户，这些账户管理对应特殊的系统功能：

6.1.1 系统级用户安全配置

InterSystems数据平台有一些系统级别的用户安全配置，例如密码模式、密码有效天数、无效登录限制（多少次登录失败后要禁用用户账户）、非活动限制（多少天未登录后禁用用户账户）等。这些系统级配置通过管理门户>系统>安全管理>系统范围的安全参数：

三级等保对于用户的密码强度是有要求的。弱密码只需要0.19毫秒就能被破解，而8位强密码破解需要上百年。

      数据平台不仅要安全，还要合规，三级等保是我们要符合的主要安全规范。InterSystems的数据平台和集成平台产品都和三级等保有关。如果没有正确配置它们的安全选项，就会影响到整个系统的安全，影响到合规性。

在生产环境上，如何配置安全的InterSystems的数据平台，并达到三级等保的要求？

这个系列文章，针对InterSystems 数据平台的安全架构，围绕对三级等保的合规性展开，介绍如何配置出一个安全、合规的数据平台。

注：本文提到的InterSystems的数据平台，包括Caché数据库、Ensemble集成平台、HealthConnect医疗版集成平台和InterSystems IRIS数据平台。

三级等保的要求