ObjectScript是一种面向对象的编程语言，它是InterSystems公司的Caché和Ensemble数据库的核心语言之一。ObjectScript语言的语法类似于MUMPS语言，它支持面向对象编程、过程式编程、函数式编程等多种编程范式。ObjectScript语言主要用于开发Caché和Ensemble数据库应用程序，它可以访问数据库中的数据、调用数据库中的存储过程、触发器和事件，还可以与其他编程语言进行交互。
Cache使用的语言是ObjectScript简称COS，下面展示的是其基本语法，也是我个人的COS字典：
SET 缩写 s ，赋值命令，样例 - s hello ="Hello World"；
WRITE 缩写 w ，向当前设备输出，样例 - w hello （特殊用法：w ! 换行、w # 清屏 ）
DO 缩写 d ，执行函数，样例 – d ##class(%SYSTEM.License).ShowSummary();
Kill 缩写 k ，从堆栈中清楚变量 x，慎用（不加参数调用时候将清楚内存中的所有变量!
前言
本人因技术需要，了解到了IRIS Health产品，在听了产品介绍会之后，感觉该产品是否有趣，并且比较符合自己目前的需求，因此大概了解了下IRIS的架构。以下是本人的浅显理解，如有错误之处欢迎讨论。
本人从产品介绍和社区的文档中，了解到IRIS的大概功能分类
其中结合到自己想要研究的领域，想要探索是否可以利用该产品并结合其他工具开发一套通用的专病数据库构建及应用方法。
我目前对该产品的初步定位是对自行提供的数据集合的存储和处理，其中提供包括编码规范、高效存储架构、编程接口、算法在内的辅助工具。针对数据的处理和应用，该产品做的很完善，但是对于数据的获取，例如是否支持extract-transformation-load功能，或者能否利用自定义编程接口实现流批一体化数据抽取。
在美国各地，当需要实现大规模的应用集成时，医疗行业的领导者会使用InterSystems HealthShare Health Connect®。无论是为了连接电子病历，还是为了提升床边护理决策能力，无论是为了创新远程医疗和远程护理，还是为了业务增长，亦或是为未来做准备，InterSystems和Health Connect随时准备好帮助您和您的组织实现目标。我们在此提供几个InterSystems医疗行业的集成实例以作示范。
对象中的 %CSP.Session 包含有关当前Session的信息以及以编程方式控制会话各个方面的方法。
.png)
User Session Data — 可以使用其 Data 属性将 中的应用程序特定信息存储在对象中。数据是一种多维数组属性，可让关联多维数组中的特定信息。该数组的内容会在会话的整个生命周期内自动维护。
可以像使用任何其他 ObjectScript 多维数组一样在对象 属性中使用 %CSP.Session。
例如，如果在 方法中执行以下代码：
Set %session.Data("MyData") = 22
然后对同一会话的后续请求（无论哪个类处理请求）在对象中的 中看到此值：
注意：理解为全局变量。
在 中存储应用程序特定数据的能力是一项非常强大的功能，但应该正确使用。进一步讨论请参阅“状态管理”部分。
要在对象的 %CSP.Session 中存储数据（仅文字数据 — 不是对象引用），请使用 数组中的每个节点都可以包含最多 个字符的字符串。
Set %session.Data("MyData") = "hello"
Set %session.Data("MyData",1) = 42
`` 是一种无状态协议；每个请求都不知道以前的请求。虽然这适用于为用户提供简单静态内容的网站，但它使得开发交互式动态 Web 应用程序变得困难。为了解决这个问题，CSP 提供了所谓的Session 管理。
Session 话表示在特定时间段内从特定客户端到特定应用程序的一系列请求。
CSP 自动提供会话跟踪；无需执行任何特殊操作即可启用它。 CSP 应用程序可以通过对象中的 %CSP.Session 查询和修改其会话的各个方面。 服务器通过 变量使该对象可用。
当 客户端向 CSP 应用程序发出第一个请求时，会话开始。
创建新session时， 服务器会执行以下操作：
OnStartSession 方法。对于的第一个请求，对象中的 的 属性设置为 。对于所有后续请求，它设置为 ：
可以使用对象中的 %CSP.Response 控制将哪些响应标头发送回 HTTP 客户端。 CSP 服务器自动创建此类的一个实例，并将对它的引用放在变量 中。
由于 对象控制 标头，因此通常在类中的 %CSP.Page 的 方法中设置其属性。例如，要重定向传入的 请求，请定义以下 方法：
Class MyApp.Page Extends %CSP.Page
{
// ...
ClassMethod OnPreHTTP() As %Boolean
{
Set %response.ServerSideRedirect = "C:\CacheSys\csp\samples\redirect.csp"
Quit 1
}
}
如果使用 CSP 类创建 CSP 页面，请使用以下代码设置标题值：
Class MyPage Extends %CSP.Page
{
ClassMethod OnPreHTTP() As %Boolean
{
Do %response.SetCookie("name","value")
Quit 1
}
当 CSP 服务器响应 HTTP 请求时，它将有关传入请求的信息打包到对象中的 %CSP.Request 实例中。可以使用变量 来引用此对象。
要查找传入 请求的 （不包括查询字符串），对象中使用 %CSP.Request 的 属性：
Write "URL: ", %request.URL
可能包含参数列表（也称为 查询）对象中的 通过其 属性使这些可用。
例如，假设传入的 URL 包含：
/csp/user/MyPage.csp?A=10&a=20&B=30&B=40
可以使用以下命令在服务器上检索这些参数：
Write %request.Data("A",1) // this is 10
Write %request.Data("a",1) // this is 20
Write %request.Data("B",1) // this is 30
Write %request.Data("B",2) // this is 40
%CSP.Error是默认的 CSP 错误页面。将其用作创建的任何错误页面的超类。可以使用 %CSP.Error中提供的功能从错误中提取信息。
如果已经有一个现有会话并且用户尝试转到一个未找到的页面， 将显示标准错误页面，因为该会话已经有一个许可证。
如果 CSP 应用程序还没有许可证，并且发生以下任何错误，则 CSP 默认显示标准 Web HTTP/1.1 404 Page Not Found 错误消息。可以通过在错误页面（通常是 %CSP.Error的子类）上为应用程序设置以下参数来更改在授予许可之前遇到错误时显示的页面。
如果生成以下错误，CSP 会查看 参数的值：
Cannot grant license.
可以有以下两个值：
"" — 返回 HTTP/1.1 404 Page Not Found 错误（默认）
静态 HTML 页面的路径 — 显示命名的静态页面，例如 /csp/samples/static.html。
如果生成以下任何错误， 会查看 参数的值：
可以有以下三个值：
1在 CSP 服务器上，所有 HTTP 请求都通过调用由类中的 %CSP.Page 定义的方法来处理。类中的 从不直接处理请求本身；它只是定义了处理 请求所需的接口。实际的事件处理的 的子类完成（手动创建或作为处理 源文件的结果）。
%CSP.Page 的子类永远不会被实例化；也就是说，不会在对象中创建 %CSP.Page。 %CSP.Page 定义的方法都是类方法，不需要对象即可调用。正如我们将看到的，这些方法所需的任何状态信息都由 服务器管理的其他对象（例如 和对象中的 ）提供。
在 服务器确定类中的哪个 %CSP.Page 应该处理请求后，它会设置适当的处理上下文，然后调用该类的 Page 方法。设置处理上下文包括重定向标准输出设备 ()，以便将所有输出（使用 命令）发送回 客户端并创建任何所需对象的实例（例如 、 和 对象）或局部变量。
方法处理对 请求的完整响应。它通过按顺序调用回调方法 、 和 来做到这一点。这些被称为回调方法，因为子类可以覆盖它们以提供自定义行为。
方法负责写出 响应的标头。这包括内容类型和 等信息。默认行为是将内容类型设置为 。在需要更直接地控制响应标头的情况下，通常只需要覆盖 方法。
方法执行响应 请求的大部分工作。
CSP 服务器收到来自 CSP 网关的请求时，它会确定该请求是针对静态页面还是针对 CSP 类的。如果是静态页面，它会立即将页面发回。如果是针对 类，它会执行以下操作：Caché 命名空间中处理请求。%CSP.Session可用，并根据 请求中包含的信息在对象中创建 %CSP.Request 的实例。如果需要任何解密，它也会这样做。 服务器通过解释其 来确定将 HTTP 请求分派到哪个类。 将 分解为以下组件：
| Component | Purpose |
|---|---|
http:// |
协议 |
localhost |
网络服务器地址 |
[ |
可选， 服务器正在运行的端口号；默认为端口 |
/csp/samples/ |
目录 |
| 文件名和扩展名 | |
| 查询 |
协议和服务器地址由 服务器处理，与 CSP 服务器无关。该目录用于确定 URL 引用的 应用程序。每个 配置都可以定义多个 应用程序，这些应用程序由 的目录部分标识。每个
鉴于国内医疗市场上，还有一些遗留系统使用PB9，Delphi7等开发技术，为加快开发进度，使第三方能尽快调用由Ensemble提供的标准HL7 V2的webservice服务，先提供几种常见语言调用Ensemble的HL7 V2 webservice接口例子。请大家根据实际情况测试并使用
假设在Production中加入了EnsLib.HL7.Service.SOAPService.CLS这个预制的Business Service并将其命名为PeiXunHl7SoapIn，那么，外部系统可以通过如下endpoint访问HL7 V2 Webservice
http://localhost:57772/csp/peixunpro/EnsLib.HL7.Service.SOAPService.CLS?CfgItem=PeiXunHl7SoapInCfgItem=PeiXunHl7SoapIn这是一个重要的参数，CfgItem是固定写法，PeiXunHl7SoapIn是你的BS的名称。
其中，通过参数CfgItem，可以访问由同一个Business Service类开放，但以不同的名称暴露出来的SOAP接口。
简单分享下在医院实际业务过程中%Dictionary.CompiledClass的一些应用。
一，Query查询出来的数据直接存表。
我们经常会遇到一些突如其来的检查，如：飞行检查，审计检查等等，往往一下子要查询几年的各种数据，每种数据涉及字段还非常多，数据之间还要求对上，查询耗时长，数据对比难度大，此时，我们需要把查询出来的数据直接存到临时表，数据核对和修改直接在临时表中完成，核对好的数据直接在sqldbx或者水滴等查询工具中整表导出，效率会高一些。
具体实现：按照数据要求，把表建好，Query输出字段和表字段顺序一致，按日期每天调用Query查询和插入，记录异常数据，后续单独处理。
优点：效率明显提高，数据核对和修改、导出很方便，避免了数据量大，多次查询耗时长问题。
缺点：数据量大会占用存储，记得删。
// W ##CLASS(lizw.CloseCycleData).insertDayByDay("2022-01-01","2022-06-30")
ClassMethod insertDayByDay(sd, ed)
{
k ^tmplzw("insertFromQyeryTestpara",$j)
S classOBJ=##class(%Dictionary.CompiledClass).%OpenId("lizw.
Cache起源于没有SQL的1970时代，当时各种高级计算机语言才刚刚诞生，其中M语言较为独特，它的诞生就是为了在没有操作系统的机器上，进行数据存储。别忘了，Unix在1971年才发布。M语言别具一格地采用了Global多维数组，统一了复杂的内存操作和文件读写，使之成为了1970年代数据库的事实标准，特别是在医疗行业。而后Intersystems在1978年接过M语言的旗帜，在M语言上添加了SQL兼容层和ObjectScript层，前者顺应了时代的潮流，后者不仅为M语言提供了强大的OOP和各种便捷的语法糖，还让数据能以对象形式进行访问，让数据和代码更加紧密。
本文将简述多维数组、SQL、对象这3种数据操作方式，提供实例代码片段，并在运行效率、开发效率、管理效率、实用性方面讨论它们的优缺点。 为方便讨论，以学校与学生为例。对每种操作方法，都列举3种典型的用例，分别为，访问某特定ID的学生（即数据库ID索引）、访问某特定studentID的学生（即遍历唯一索引）、和访问某学校的所有人（即遍历非唯一索引）。
HTTP 请求 - CSP 运行时环境CSP 的主要任务是提供动态内容以响应传入的 （超文本传输协议）请求。本节介绍 CSP 如何处理 请求的基础知识。
是一种简单的协议，其中客户端向服务器发出请求。 是一种无状态协议；客户端和服务器之间的连接只持续为服务请求所需的时间。每个 HTTP 请求都包含一个请求标头，该标头指定请求类型（例如 或 ）、一个 和一个版本号。请求还可能包含附加信息。 自动确定它应该处理哪些 请求，将它们分派到运行在 服务器上的适当类，并将请求信息打包成易于使用的对象（例如对象中的 ）。
下图显示了 和 请求的架构：
应用程序的运行时环境包括以下内容：
HTTP 客户端（例如 Web 浏览器）HTTP 服务器（ 服务器，例如 或 ）Caché 插件）下图说明了 处理 请求时的事件流：
在生产环境中IRIS通常以故障转移集群的形态被部署，而集群中各故障转移成员的镜像状态将决定该集群在故障发生时是否能够顺利切换保障业务不中断。因此，成员状态通常也是运维团队需要巡检或监控的目标。
尽管IRIS内部API提供了丰富的集群配置、成员状态监控等一系列接口，但除Portal上的镜像监视器外，并没有特定的接口便于从外部系统访问（如进行企业级监控集成时），也没有整合好的监控接口可用与获取镜像的健康状态。但在IRIS上开发一个REST接口暴露镜像状态数据并不困难，如下所示：
Include %syMirrorClassParameter在该实现中，由于需要调用%SYS下的API，因此需要在执行过程中切换到%SYS命名空间，并在执行完毕后切换回原命名空间。
Kong提供了一个开源的配置管理工具（用Go语言编写），称为decK（即声明式Kong，declarative Kong）。
deck ping
Successfully connected to Kong!
Kong version: 2.3.3.2-enterprise-editiondeck dumpdeck diff
updating service alerts {
"connect_timeout": 60000,
- "host": "172.24.156.176",
+ "host": "192.10.10.18",
"id": "3bdd7db4-0b75-4148-93b3-2ff11e961f64",
"name": "alerts",
"path": "/alerts",
"port": 50200,
"protocol": "http",
"read_timeout": 60000,
"retries": 5,
"write_timeout": 60000
}
Summary:
Created: 0
Updated: 1
Deleted: 0Hi 大家好，
我最近开始学习InterSystems IRIS 的互操作性，我发现官方文档对理解它的工作原理很有帮助，尽管我自己在实现它时仍有一些困难。在我的同事的帮助下，我成功地创建了一个系统的Demo，并从实践中学习。因此，我决定写一下文章，分享我得到的帮助，来帮助更多的其他人。
首先，让我们掌握一些基本概念:
从简单的开始比较容易--让我们先想想服务和操作--比如说你有一个接收一种信息的服务，它很容易被我们唯一的操作所识别。
当生产的目的和它的部分非常清楚时，开发就比较容易。如果你愿意，画一张图或写下你希望它完成的步骤可能会有帮助。
Cache软件自带数据服务和应用服务。在实际使用中会将Cache数据服务和应用服务分别安装在不同的服务器上面，作为数据库服务器和应用服务器。数据库服务器和应用服务器通过ECP（企业缓存协议）进行数据交换。在应用服务器部署上web服务，让数据交换和应用处理分开，实现瘦数据和胖应用的系统模式。
这种早已存在于互联网行业的基础级模式，虽然解决计算资源和存储资源的合理分配的问题，但也常用来扩展了用户许可数。毕竟将数据服务和应用服务装在一台服务器上面只能满足百级的用户需求，而将数据服务和应用服务分开的二层模式，就可以满足千级的用户需求。
在二层模式下，大量用户必须访问同一个应用源地址，才能在日常繁杂的应用维护中，减少维护的成本。这样，就在所有的应用服务器和客户端之间，加上了负载均衡，这种网络服务器。它通过SNAT发布的虚拟地址，满足了上面的需求。
但同时，也将客户与应用服务器的直接对话，替换成了，负载均衡服务器与客户端，和负载均衡服务器与应用服务器段的通话。
在客户端访问负载均衡的虚拟地址的时候，通过网络的三次握手协议建立连接。
在负载均衡确认了客户端的真实性后，负载均衡再与应用服务器，也是通过网络的三次握手协议，建立连接，将应用服务器作为负载均衡的服务器池成员。再将客户端的数据转发到应用服务器。
这个看似满足解决了当下所有应用需求的方案，也存在的些不确定。
2022年9月5日-10月24日（北京时间），我们正在举办🏆InterSystems开发者社区中文版首届技术征文大赛🏆（←点击链接进入参赛页面，浏览所有参赛文章）！投票截止至10月23日，你的支持与喜爱，是作者获得“开发者社区奖”的关键！如何为你喜欢的作品投票呢？
对于使用 DeepSee 的 Web 应用程序，它需要访问 %DeepSee 包中的所有类。要使特定应用程序能够使用 ，请在 命名空间中使用以下命令：
Do EnableDeepSee^%SYS.cspServer("/csp/webapp/")
其中 是带有斜杠的 应用程序名称。前面的命令等价于以下命令：
Set ^SYS("Security","CSP","AllowClass","web-app-name","%DeepSee.") = 1
Set ^SYS("Security","CSP","AllowClass","web-app-name","%CSP.UI.Portal.About")=1
其中 是带有尾随冲突的 Web 应用程序的名称。请注意，第一行使用 。有一个尾随句点。
或者，要使所有应用程序都能使用 ，请使用以下变体：
Do EnableDeepSee^%SYS.cspServer(0)
例如，要启用 /csp/webapp Web 应用程序以使用 ，请使用以下命令：
要禁止特定 应用程序使用 DeepSee，请使用以下命令：
可以在管理门户的编辑 应用程序页面上创建或修改 如何处理特定
Category: AllowPrefix如果应用程序依赖于调用以同一组字符开头的多个类或包，请使用AllowPrefix选项。
重要提示：如果应用程序依赖于调用上面列出的以外的任何类，则使用它可能是不安全的。建议确定是否需要调用此类，并为部署执行风险评估，以便了解使类可用的含义。
要使给定的Web应用程序能够调用以相同字符集开头的类或程序包，请在命名空间中使用以下命令：
Set ^SYS("Security", "CSP", "AllowPrefix", "web-app-name", "prefix") = value
其中
Web-app-name是Web应用程序的名称，后跟一个尾随斜杠。要使所有Web应用程序都能使用给定的类或包，请将web-app-name指定为；在这种情况下，可以省略括起来的引号。
前缀是名称的前几个字符。
值为1或0。
如果将其指定为1，则Web应用程序可以调用这些类(或包)。
如果将其指定为，则此Web应用程序无法调用这些类(或包)。
例如，要使应用程序能够调用整个包，请使用以下命令：
请注意，前缀是 ，前缀中的句点表示应用程序无法访问等包。但是，应用程序可以访问包和。
再举一个例子，要使所有应用程序都能够访问以开头的所有包，请使用以下命令：
再举一个例子，假设 应用程序应该能够访问 % 包中除类
本篇文章使用的InterSystems IRIS for Windows (x86-64) 2021.1 (Build 215U) Wed Jun 9 2021 09:39:22 EDT
Mysql ODBC 和 JDBC 驱动版本：8.0.28
可能会写成这样：
/// w ##class(PHA.YX.Design.Program).GetResult()
ClassMethod GetResult()
{
READ "输入第一个数字：", numberA,!
READ "输入操作符：", operate,!
READ "输入第二个数字：", numberB,!
s result = ""
i operate = "+" d
.s result = numberA + numberB
i operate = "-" d
.s result = numberA - numberB
i operate = "*" d
.s result = numberA * numberB
i operate = "/" d
.s result = numberA / numberB
q result
}
当 CSP 服务器接收到传入的 HTTP 请求时，它使用本地 CSP 应用程序设置来确定如何处理请求。本节介绍 如何使用 应用程序设置处理 应用程序请求。
以下规则管理对页面和类的访问：
/csp/sys/ 应用程序及其所有子应用程序的页面isc/studio/templates/ 和 /isc/studio/usertemplates/ 应用程序的页面%CSP.Broker, , %CSP.Login, , 被允许%ZEN.* 类%Z* 类除了检查 应用程序中的设置外，还会检查允许的类。可以通过导航到管理门户上的系统管理 > 安全 > 应用程序 > Web 应用程序来查看和更改应用程序设置。因此，类引用必须通过两组测试才能被允许。
要允许访问其他类，请在 命名空间中配置 ，其中 是 、 或 。以下部分描述了这些选项
重要提示：首先应用默认规则，然后按列出的顺序应用类别来完成检查。此外，每个关键字都可以被多次调用。
在Cache 2018之前的版本中，数据库的高可用是通过第三方HA软件保障的，Cache数据库在2018以后及IRIS支持MIRROR技术，通过MIRROR可以保障数据库的高可用及数据的冗余，那么在新版本中，第三方HA软件与MIRROR是否可以同时使用以实现更高的数据库可用性？使用起来有哪些需要注意的？本文重点介绍探讨上述两个问题。
为得出正确结论，我们搭建了如下实验环境：
我们采用3个服务器节点A、B、C分别部署IRIS 2021.1数据库，其中A节点、B节点部署第三方HA软件组成数据库高可用主备集群（本例中，采用的是基于POWER平台的PowerHA），该集群中定义A节点为主节点，B节点为备用节点，HA集群的共享资源组存放在共享SAN存储上，通过HA，生成HA集群的对外服务IP，即我们通常说的Service ip，保证在生产节点发生网络故障、主机故障、以及操作系统故障、手动切换等情况下，IRIS服务、共享资源组、以及HA的Service IP可自动切换至另外一台服务器，保障IRIS高可用，经测试，HA集群内部节点间服务切换时间约为30秒。
CSP 网关是安装在 Web 服务器上并由其加载的 DLL 或共享库。 网关检测对扩展名为 或 的文件的任何请求，并将它们发送到定义的 服务器进行处理。
可以使用 网关管理器（ 网关管理页面）或直接编辑其配置文件 csp.ini 来配置 网关。
网关管理器是一个小型 应用程序，可以在浏览器中使用它。您可以通过导航到系统管理 > 配置 > CSP 网关管理来访问 网关管理器。默认情况下，它会访问专用 服务器的 网关管理器。
要访问生产 服务器的 网关管理器，请根据需要通过替换 或 localhost:<port_no> 来更改 。
有关配置 网关的信息，请导航至系统管理 > 配置 > CSP 网关管理，然后单击帮助。有关更多详细信息，请参阅 网关配置指南。
注意：CSP Web 网关管理页面的本地化仅基于安装的 的内容（如果有）。如果不存在本地化文件，则 管理页面默认使用嵌入的英文文本。浏览器的语言设置对此机制没有影响。
注意：为防止运行时错误，对于通过 运行的高可用性配置， 建议使用启用了粘性会话支持的硬件负载平衡器。
可以定义此 网关可以访问的服务器列表（可能运行 CSP 应用程序的
访问了一个API，得到的返回结果里面有个时间字段，现在返回的格式是这样的 “2022-09-30T07:24:57.899Z”， 怎么样能转换成 YYYY/MM/DD hh:MM:ss的格式
最近一些用户问到监控集成平台业务行为查询的问题，例如如何查询服务的平均耗时、发生错误的服务数量...
业务行为监控对于集成平台来说非常重要，可以帮助我们：
仅提供这些查询是很容易的，但要更好地监控集成平台的业务行为，需要更深入的了解InterSystems集成架构。
无论Ensemble、Health Connect还是InterSystems IRIS，它们都具有下面的集成架构：
通过业务服务向外发布服务、通过业务操作连接第三方接口、通过业务流程协同业务操作，它们统称为集成业务组件。可以简单理解为业务行为是由这些业务组件完成的：
URL 的 Web 服务器配置提供了一个默认的 /csp 虚拟目录来运行 应用程序。如果正在运行多个 Caché 实例，它还提供了一个默认虚拟目录 以供使用。如果正在运行多个 实例并使用虚拟目录 访问 应用程序，而之前没有 /，它将访问最后安装的 版本。如果计划允许使用以 http://localhost/csp 或 http//localhost/cacheinstance/csp 开头的应用程序路径调用所有 应用程序，则无需在 Web 服务器中进行任何更改配置。
如果要创建一个应用程序路径不是以 或 /cacheinstance/csp 开头的 CSP 应用程序，则需要在 服务器配置文件条目中进行更改，别名 。
下表显示了需要更改的配置文件。
| 网络服务器 | 配置文件 |
|---|---|
Apache、HP 安全网络服务器 |
UNIX®: Windows: |
| 如“在 服务器上配置新 ”中所述定义虚拟目录。 |
下表显示了使用 服务器和 实例的组合访问 页面的示例：
| URL | web server | Instance |
|---|---|---|
| http://localhost/cache20071/csp/samples/menu.csp |
