第五章 向邮件添加附件

向邮件添加附件

可以将附件添加到电子邮件或消息部分(具体地说，是添加到%Net.MailMessagePart或%Net.MailMessage的实例)。要执行此操作，请使用以下方法：

这些方法中的每一种都会将附件添加到原始邮件(或邮件部分)的Parts数组中，并自动将IsMultiPart属性设置为1。

AttachFile()

method AttachFile(Dir As %String, 
                  File As %String, 
                  isBinary As %Boolean = 1, 
                  charset As %String = "", 
                  ByRef count As %Integer) as %Status

将给定文件附加到电子邮件。默认情况下，文件以二进制附件的形式发送，但您可以将其指定为文本。如果文件是文本，还可以指定该文件使用的字符集。

具体地说，此方法创建%Net.MailMessagePart的实例，并根据需要将文件内容放在BinaryData或TextData属性中，并根据需要设置CharSet属性和TextData.TranslateTable属性。

cache2016开始提供了支持JSON的系统类，%DynamicAbstractObject %DynamicArray %DynamicObject， 不知是否可将这些系统类导入到之前的版本（如cache2012）， 从而实现支持JSON操作，或者是有何其他简单的解决办法

问题背景

目前不论开发和项目的数据库版本大部分是2016+，且广泛使用JSON，但当偶尔向低版本用户部署程序时，会遇到对JSON支持的问题

新安装的cache,本地可以连接terminal,远程主机连接失败，telnet 23端口失败

本帖的目的是回答一个问题。 在本系列的第二篇帖子中，我包括了从 pButtons 提取的性能数据的图表。 有人在线下问我，有没有比剪切/粘贴更快的方法从 pButtons .html文件中提取 mgstat 等指标，以便在 Excel 中绘图。

参见：- 第 2 部分 - 研究收集的指标

pButtons 将其收集的数据编译成一个 html 文件，以便发送给 WRC 和查看整理的数据。 不过，尤其是对于长时间（如 24 小时）进行收集的 pButtons 来说，一些基于时间的数据（如 mgstat、vmstat 等）以图形方式查看更容易查找趋势或模式。

我本人和其他技术架构师经常需要向客户和供应商说明 Caché IO 要求以及 Caché 应用程序使用存储系统的方式。 在向客户和供应商说明典型的 Caché IO 配置文件和事务性数据库应用程序的要求时，下面的表格很有用。  原始表格由 Mark Bolinsky 创建。

在以后的帖子中，我将讨论更多关于存储 IO 的内容，所以现在贴上这些表格也作为将来文章的参考。 

。之前我展示了如何运行 pButtons 来收集我们在下列帖子中研究的性能指标。

• 第 1 部分 - 入门：收集指标。
• 第 2 部分 - 研究收集的指标。

更新：2020 年 5 月。

您的应用程序已部署，一切运行正常。 很好，击个掌！ 然后电话突然响个不停 – 用户投诉应用程序有时很“慢”。 这是什么意思？ 有时？ 您有哪些工具，查找和解决这个缓慢问题应查看哪些统计数据？ 您的系统基础架构是否能承担用户负载的任务？ 在投入生产之前，应该询问哪些基础架构设计问题？ 如何自信地为新硬件规划容量，而不会过度规定？ 如何停止电话铃声？ 如何一开始就不让它响？

InterSystems API Manager (IAM)的2.3版本的正式版本已经发布。

IAM的容器，包括从IAM早期版本升级的所有相关工件，可以从。WRC软件分发站点 的组件区下载.

这个版本的构建号是IAM 2.3.3.2-1。

这个版本是基于Kong企业版2.3.3.2。

InterSystems API Manager 2.3使其更容易以安全的方式和高可用性的场景进行部署 它有许多新的功能，包括:

• 引入了混合模式
• 更广泛地支持Docker Secrets

混合模式允许你在数据面和控制面部署IAM节点。当数据平面处理API流量时，控制平面用于配置数据平面节点并观察来自数据平面的遥测数据。这赋予了部署更多的灵活性，减轻了部署HA场景的工作量。关于混合模式的更多信息可以在[这里](https://docs.konghq.com/enterprise/2.3.x/deployment/hybrid-mode/)找到。在接下来的日子里，InterSystems开发者社区也将更详细地介绍这一功能。

IAM 2.3的文档可以在 这里找到。该文档只涉及IAM特有的元素。产品中的文档链接将用户直接带到Kong Enterprise的文档。

从IAM 1.5.0.9升级需要通过两个中间版本进行增量升级，这在文档中会有更详细的描述。

第四章 收发电子邮件

本主题描述如何使用InterSystems IRIS发送和接收MIME电子邮件消息。

注意:本主题中的示例是经过组织的，因此管理电子邮件的方法可以用于不同的电子邮件服务器，这在测试和演示期间非常有用。这不一定是最适合生产需要的代码组织。

支持电子邮件协议

电子邮件使用标准协议通过Internet发送消息。 InterSystems IRIS支持以下三种协议:

• InterSystems IRIS提供MIME电子邮件的对象表示形式。它支持文本和非文本附件、单部分或多部分邮件正文，以及ASCII和非ASCII字符集的标题。
• 可以通过SMTP服务器发送电子邮件。SMTP(简单邮件传输协议)是发送电子邮件的Internet标准。
• 还可以通过POP3从电子邮件服务器检索电子邮件，POP3是从远程服务器检索电子邮件的最常用标准。

注意：InterSystems IRIS不提供邮件服务器。相反，它提供了连接到邮件服务器并与之交互的功能。

InterSystems IRIS如何表示MIME电子邮件

首先，了解InterSystems IRIS如何表示MIME电子邮件非常有用。

通常，多部分MIME邮件由以下部分组成：

• 一组邮件标头，每个标头都包含邮件发送到的地址等信息。这还包括整个消息的Mime-Type标头和Content-Type标头。

第三章 发送HTTP请求

发送HTTP请求

创建HTTP请求后，使用以下方法之一发送该请求：

Delete()

method Delete(location As %String = "", 
              test As %Integer = 0, 
              reset As %Boolean = 1) as %Status

发出HTTP DELETE请求。

Get()

method Get(location As %String = "", 
           test As %Integer = 0, 
           reset As %Boolean = 1) as %Status

发出HTTP GET请求。此方法使Web服务器返回请求的页面。

Head()

method Head(location As %String, 
            test As %Integer = 0, 
            reset As %Boolean = 1) as %Status

发出HTTP Head请求。此方法使Web服务器仅返回响应头，而不返回正文。

第二章 设置和获取HTTP标头

设置和获取HTTP标头

可以设置和获取HTTP标头的值。

%Net.HttpRequest的以下每个属性都包含具有相应名称的HTTP标头的值。如果不设置这些属性，则会自动计算它们：

• Authorization
• ContentEncoding
• ContentLength(此属性为只读。)
• ContentType (指定Content-Type标头的Internet媒体类型(MIME类型)。)
• ContentCharset (指定Content-Type标题的字符集部分。如果设置此属性，则必须首先设置ContentType属性。)
• Date
• From
• IfModifiedSince
• Pragma
• ProxyAuthorization
• Referer
• UserAgent

%Net.HttpRequest类提供可用于设置和获取主HTTP标头的常规方法。这些方法忽略Content-Type和其他实体标头。

ReturnHeaders()

返回包含此请求中的主HTTP标头的字符串。

OutputHeaders()

将主HTTP标头写入当前设备。

GetHeader()

返回此请求中设置的任何主HTTP标头的当前值。此方法接受一个参数，即头的名称(不区分大小写)；这是一个字符串，如Host或Date

SetHeader()

设置标题的值。

随着InterSystems IRIS 2020.1和InterSystems IRIS for Health 2020.1中PEX的发布，客户有了比Java Business Host更好的方式来构建Java的产品。PEX为构建互操作性组件提供了一套完整的API，并有Java和.NET两种版本。

从InterSystems IRIS和InterSystems IRIS for Health的2020.4版本开始，Java Business Host已经被删除。 我们鼓励使用Java商业主机的客户迁移到PEX。

PEX的优势

• 允许开发人员在Java或.NET中创建任何生产组件

• 组件之间可以传递更复杂的消息结构

• 简化设置

• S简化了开发工作流程，无需使用ObjectScript。

关于迁移到PEX的更多信息，请参见从Java Business Host迁移到PEX。

由于这是一个预览版，我们渴望在下个月的通用版发布之前了解您对这个新版本的经验。请通过开发者社区分享您的反馈，以便我们能够共同打造一个更好的产品。

InterSystems IRIS数据平台2021.1是一个扩展维护（EM）版本。自2020.1（上一个EM版本）以来，在持续交付（CD）版本中增加了许多重要的新功能和改进。请参考2020.2、2020.3和2020.4的发布说明，了解这些内容的概况。

这个版本的增强功能为开发人员提供了更大的自由度，可以用他们选择的语言构建快速和强大的应用程序，并使用户能够通过新的和更快的分析功能更有效地消费大量的信息。

通过InterSystems IRIS 2021.1，客户可以部署**InterSystems IRIS Adaptive Analytics**，这是一个附加产品，它扩展了InterSystems IRIS，为分析终端用户提供了更大的易用性、灵活性、可扩展性和效率，而不管他们选择何种商业智能（BI）工具。它能够定义一个有利于分析的业务模型，并通过在后台自主构建和维护临时数据结构，透明地加速针对该模型运行的分析查询工作负载。

亲爱的社区开发者们，大家好！

InterSystems开发者竞赛：FHIR加速器 已于5月10日开启！ 我们邀请所有FHIR开发者们在AWS上使用InterSystems IRIS FHIR加速器服务 (FHIRaaS)上开发或测试您的应用。

现在，我们为您提供绝佳机会，您可以在AWS上免费访问FHIRaaS！ 那么，掌握FHIRaaS的第一步，是使用URL的特殊code在ISC Dev FHIR Portal 门户注册，链接如下：👉🏼 https://portal.trial.isccloud.io/account/signup

点击上面的链接，遵循相应步骤，即可掌控InterSystems FHIRaaS！

关于此次竞赛的任何疑问，请随时跟帖提问，或在 discord-contests channel 中提问。

再次欢迎大家加入此次竞赛，成为InterSystems FHIRaaS 大师！ ✌🏼

Happy coding! ：）

在上一篇文章《互操作消息统一管理系列：Message Bank》中，我们了解到在Message Bank中，消息均以半结构化（XML）或非结构化（Stream）的形式保存，因此无法与客户端的结构化消息一样，直接支持基于索引的检索。为此，需要在Message Bank中定义Search Table以支持查询。关于Search Table的定义和作用，请查阅https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=EEDI_search_tables。

一. 在Message Bank中查询消息的特殊之处

大家如果使用过消息查看器，则能够了解IRIS自动持久化消息并提供界面让大家能够根据消息头中（如发生事件、来源、目标等）或消息体中（如患者姓名、诊断名称等消息的具体属性）来查询消息。 而在Message Bank上进行查询时，如果直接使用消息查看器，能够查询的是Message Bank的Production中传输的消息，而若不是在源系统中出现的消息，这一点一定不要混淆。

一. 企业信息库简介

企业信息库（MessageBank）是一个可选的远程归档设施，可以从多个来自不同实例的互操作性Production中收集信息、事件日志项目和搜索表项。如下图所示：

这套环境由两种角色的实例构成： 企业信息库服务器，它本身也是一个Production，完全由Message Bank服务组成，接收来自任何数量的客户Production提交的消息、日志等。

客户端Operation（Message Bank Operation），将其添加到一个正在运行的Production中，并用企业信息库服务器的地址进行配置。如连接通畅，消息和日志即可自动转发到Message Bank并在其中存储。

为了使你能方便地看到信息库中的信息，InterSystems IRIS®提供了以下附加选项。

对于企业信息库实例，管理门户自动包括企业监控器页面，在那里你可以监控客户端Production的状态，浏览消息库，并对被监控客户的消息进行检索。

对于每个客户端实例，你在消息库实例中配置一个到企业监控器的链接。

如下所示：

二. 常见应用场景

消息归档

在使用IRIS互操作性时，对于生产环境，为保障其有充足的磁盘空间和即时查询的效率，通常会采用消息和日志过期策略。在生产环境中只保留近期（如一个月）的信息以备回溯，过期数据将定期被清除。

IRIS 单元测试

第一章 单元测试概述☆☆☆☆

第二章 使用%UnitTest进行单元测试☆☆☆☆

第三章 执行测试☆☆☆

第四章 使用Setup和tear Down方法执行测试☆☆☆

前言

IRIS提供了用于对应用程序进行单元测试的类的%UnitTest包。该包为快速开发单元测试类、执行测试和创建报告提供了便利。可以直接使用该包，也可以扩展其类来自定义单元测试工具。%UnitTest在结构上与用于单元测试的xUnit框架非常相似。熟悉这些框架的开发人员使用%UnitTest会特别容易。

本教程提供对%UnitTest包的快速实践介绍。本教程的第一部分和第二部分是相互独立的，可以按任何顺序完成。

• 完成本教程的第一部分，了解单元测试和集成测试之间的区别、xUnit框架和%UnitTest之间的结构相似性，以及单元测试在敏捷应用程序开发方法中的作用。
• 完成本教程的第二部分，学习如何使用%UnitTest中的类为InterSystems IRIS应用程序创建和执行单元测试。

注意：本教程假定基本熟悉ObjectScript和InterSystems IRIS的面向对象开发。

预告

下一期系列将用一个月的时间连载，《Caché 网络实用工具》，敬请期待。

交流群

• QQ群号：410039091
• 笔者QQ：454115408
• 公众号：技术理科直男
• intersys版主：姚鑫

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

我面临着同时在IRIS和CACHÉ上开设一堆课程的挑战
直到所有系统都迁移到IRIS。

在Caché开发环境中应用更改并迁移到IRIS没问题

但是，如果我必须对IRIS进行修复，似乎没有干净的方法可以返回Caché。

第四章 使用Setup和tear Down方法执行测试

示例：使用Setup和tear Down方法执行测试

以通常的方式执行新的单元测试。

1. 在一直在使用的命名空间中打开终端。
2. 将^UnitTestRoot的值设置为包含测试类的目录的父级：

USER> Set ^UnitTestRoot="c:\unittests"

3. 使用%UnitTest.Manager执行测试：

USER> Do ##class(%UnitTest.Manager).RunTest("mytests")

4. IRIS加载测试类、编译类、执行测试并向终端发送报告。

===============================================================================
Directory: C:\unittests\mytests\cls\MyPackage\
===============================================================================
mytests\cls\MyPackage begins .
Load of directory started on 01/09/2018 14:36:57 '*.xml;*.XML;*.cls;*.mac;*.int;*.

webservice服务，在浏览器中调用成功，在soapui工具中调用失败“wsse:FailedAuthentication”

我创建了 iris-fhir-portal 来参加当前竞赛 **InterSystems IRIS for Health FHIR，**本篇快速概述旨在介绍我的应用程序提供的功能。

iris-fhir-portal 的目标是说明使用 IRIS for Health 中的 FHIR 功能创建患者图表并让用户拥有自己的数据有多么简单。

第三章 执行测试

示例：执行测试

现在使用%UnitTest.Manager.RunTest执行单元测试。以下是方法：

1. 在包含单元测试的名称空间中打开终端；在本例中为用户。如果终端未在正确的命名空间中打开，请使用ZN更改命名空间。
2. 将^UnitTestRoot全局值设置为包含导出的测试类的目录的父级。

DHC-APP>Set ^UnitTestRoot="d:\Temp"

3. 使用方法%UnitTest.Manager.RunTest执行测试。

DHC-APP>do ##class(%UnitTest.Manager).RunTest("test")

4. IRIS从XML文件加载测试类，编译类，执行测试，从服务器删除测试代码，并向终端发送报告。

HC-APP>do ##class(%UnitTest.Manager).RunTest("test")
 
===============================================================================
Directory: D:\Temp\test\
===============================================================================
  test begins .

FHIR 术语服务规范描述了一组对 CodeSystem、ValueSet 和 ConceptMap 资源的操作。 在这些操作中，以下四种操作似乎是最为广泛采用的：

开发该规范的部分实现一直是探索 IRIS for Health 2020.1 中引入的全新 FHIR 框架的有效途径。 本实现包括上述四种操作，并支持与 CodeSystem 和 ValueSet 资源的读取和搜索交互。

需要注意的是，本实现使用普通 ObjectScript 持久化类作为源术语表。

第二章 使用%UnitTest进行单元测试

本教程的第二部分介绍了如何使用%UnitTest包对InterSystems IRIS代码进行单元测试。完成本教程的这一部分后，将能够：

• 解释%UnitTest包中三个主要类的角色。
• 列出基于%UnitTest包的单元测试类和方法的要求。
• 创建并执行方法的单元测试。
• 浏览%UnitTest.Manager创建的测试报告。
• 执行单元测试时，使用%UnitTest.TestCase方法初始化和还原数据库数据。

什么是%UnitTest？

%UnitTest包是一组为IRIS提供测试框架的类。在结构上，它类似于xUnit测试框架。%UnitTest为创建和执行以下各项的单元测试提供类和工具：

• 类和方法
• ObjectScript例程(routines)
• InterSystems SQL脚本
• Productions

创建和执行单元测试套件

以下是创建和执行一套单元测试的基本步骤：

1. 创建一个(或多个)包含要测试的方法的类。
2. 创建扩展%UnitTest.TestCase的测试类(或多个测试类)。
3. 将方法添加到将测试方法输出的测试类。在每个方法中至少使用一个断言(AssertX宏)。每个测试方法名称都以Test开头。
4. 将测试类导出到文件。
5. 打开终端并切换到包含要测试的类的名称空间。

第一章 单元测试概述

本教程的第一部分概述了单元测试。完成本教程的这一部分后，将能够：

• 定义单元测试并区分单元测试和集成测试
• 列出单元测试的几个好处
• 描述InterSystems IRIS %UnitTest包和xUnit测试框架之间的相似性。
• 列出软件开发中测试优先方法经常声称的几个好处。

什么是单元测试?

单元测试是对单个代码模块的正确性的测试，例如，方法或类的测试。通常，开发人员在开发代码时为其代码创建单元测试。典型的单元测试是一种执行方法的方法，该方法测试并验证该方法是否为给定的一组输入生成了正确的输出。

单元测试不同于集成测试。集成测试验证了一组代码模块交互的正确性。单元测试仅单独验证代码模块的正确性。一组代码模块的集成测试可能会失败，即使每个模块都通过了单元测试。

为什么要进行单元测试？

单元测试提供了许多好处，包括：

• 提供代码模块是否正确的验证。这是单元测试的主要原因。
• 提供自动回归测试。更改代码模块后，应重新运行单元测试，以确保代码模块仍然正确。也就是说，应该使用单元测试来确保更改没有破坏代码模块。理想情况下，所有代码模块的单元测试都应该在更改任何一个模块之后运行。
• 提供文档。通常，代码模块的单元测试与代码模块一起交付。检查单元测试提供了大量有关代码模块如何工作的信息。

XUnit测试框架

单元测试框架是为开发和执行单元测试提供支持的类包。

Caché Global

第一章 简介global☆☆☆☆☆

第二章 全局变量结构（一）☆☆☆☆☆

第二章 全局变量结构（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（一）☆☆☆☆☆

第三章 使用多维存储(全局变量)（二）☆☆☆☆☆

第三章 使用多维存储(全局变量)（三）☆☆☆☆☆

第三章 使用多维存储(全局变量)（四）☆☆☆☆☆

第四章 多维存储的SQL和对象使用（一）☆☆☆☆☆

第四章 多维存储的SQL和对象使用（二）☆☆☆☆☆

第五章 管理全局变量（一）☆☆☆☆☆

第五章 管理全局变量（二）☆☆☆☆☆

第六章 临时全局变量和IRISTEMP数据库☆☆☆☆☆

前言

经过快一个月的连载 《Caché Global》 共12篇。对于刚接触M的语言的同学，由浅入深帮助你快速进步，对于老手，丰富更多的细节

涵盖以下主题：

• “简介”概述了全局变量的功能和用途。
• “全局变量结构”描述了全局变量是如何存储在磁盘上的，它们是如何命名和引用的，以及它们的结构。
• “使用多维存储(全局)”介绍如何以编程方式使用全局变量。
• “多维存储的SQL和对象使用”描述了对象和SQL引擎如何使用全局变量存储数据。
• “管理全局变量”介绍了主要从管理门户管理全局的工具。
• “临时全局变量和TEMP数据库”描述了如何使用临时全局变量来帮助进行复杂的处理。

第六章 临时全局变量和IRISTEMP数据库

对于某些操作，可能需要全局变量的功能，而不需要无限期保存数据。例如，可能希望使用全局对某些不需要存储到磁盘的数据进行排序。对于这些操作，InterSystems IRIS提供了临时全局机制。该机制的工作方式如下：

• 对于应用程序名称空间，可以定义一个全局映射，以便将具有特定命名约定的全局变量映射到IRISTEMP数据库，该数据库是一个特殊的数据库，如下所述。

例如，可以定义一个全局映射，以便将名称为^AcmeTemp*的所有全局变量映射到IRISTEMP数据库。

• 当代码需要临时存储数据并再次读取它时，代码将向使用该命名约定的全局变量写入数据，并从全局变量读取数据。

例如，要保存值，代码可能会执行以下操作：

 set ^AcmeTempOrderApp("sortedarray")=some value

然后，稍后代码可能会执行以下操作：

 set somevariable = ^AcmeTempOrderApp("sortedarray")

通过使用临时全局变量，可以利用IRISTEMP数据库没有日志记录这一事实。因为数据库没有日记记录，所以使用该数据库的操作不会产生日记文件。日志文件可能会变得很大，并可能导致空间问题。但是，请注意以下几点：

不能回滚修改IRISTEMP数据库中的全局变量的任何事务；此行为特定于IRISTEMP

Intersystems RIS 机器学习工具包, 包括Python/R/Julia, 支持协调管理基于云的高级分析服务，如微软Azure数据工厂和机器学习。

我找不到在Internet上连接到InterSystems Iris的spark或Kafka的情况。是否可以共享任何相关资源？