采用编码格式，任何对象值属性都作为引用包含在内，并且引用的对象作为单独的元素写在 SOAP 消息中。
要以内联方式写入编码对象，请在 Web 客户端中将 REFERENCESINLINE 参数或 ReferencesInline 属性指定为 `1。属性优先于参数。
默认情况下， Web 客户端在其发送的 SOAP 消息的信封中使用前缀 SOAP-ENV。可以指定不同的前缀。为此，请设置 Web 客户端类的 SOAPPREFIX 参数。例如，如果将此参数设置为 MYENV，则 Web 客户端会在其消息中包含此前缀，而不是 SOAP-ENV。
SOAP 信封要将命名空间声明添加到给定 Web 客户端返回的 SOAP 响应的 SOAP 信封（Web 方法之前调用 Web 客户端的 %AddEnvelopeNamespace() 方法。
Hi 开发者们，
2024年7月，我们开启了💡“中文社区最佳贡献奖”💡活动，截至目前，社区共有成员1900余人，7月新增成员46人。
在这里，我们将说明如何以图形方式显示数据收集的结果。 项目的输出将如下所示：
我使用的是本地计算机。 如果你在服务器上，注意使用正确的 IP 地址。
首先，导入需要的三个类（注意，我们将晚些时候编辑它们）：
你可以使用 xml 并将其导入系统。
规范将创建调度类和实现模板。 如果你想详细了解此过程，可以读一读我同事 Eduard Lebedyuk 写的文章。
注意，在此演示中我们将使用 Basic Authorization。 我们还假设 Sample_DBExpansion_Data.DBAnalysisInfo 和 Sample_DBExpansion_Data.GlobalAnalysisInfo 表中已经有数据。 如果没有，返回数据收集获取数据。
填写相同的名称，除非你打算为 react 应用自行定制代码。
这是数据收集的续集。 如果你还没有安装，请先完成安装。
这里提供的是对先前收集的数据的分析。
你需要导入构成此仓库的 xml，与先前仓库中的操作大致相同。
最顶层有一个任务：
这个任务将允许我们设置将要监控的参数， 如下所示：
GrowthPercentageWarning：对于Global增长来说，“可接受的”百分比增长。
PeriodWarning：Global在多少天内实现增长是合理的？
HistoryLength：回溯 Sample_DBExpansion_Data.GlobalAnalysisInfo 表的时长。
默认设置为 7 天内增长 5%，回溯过去 30 天。 设置参数后，即使任务已经运行一次或多次，你仍然可以再次编辑。 转到任务详细信息，点击 Edit，然后根据需要更改。
该任务会调用 Sample.DBExpansion.DBSizeAnalysis.InvestigateInfo 类的 CreateReport 方法。
CreateReport 将填充两个表，如下所述：
xsi:type 属性的使用默认情况下， SOAP 消息仅包含顶级类型的 xsi:type属性。例如：
<?xml version="1.0" encoding="UTF-8" ?>
...
<types:GetPersonResponse>
<GetPersonResult href="#id1" />
</types:GetPersonResponse>
<types:Person id="id1" xsi:type="types:Person">
<Name>Yeats,Clint C.</Name>
<DOB>1944-12-04</DOB>
</types:Person>
...
在这些示例中，已添加换行符以提高可读性。要将此属性用于 SOAP 消息中的所有类型，请执行以下操作之一：
Web 客户端实例中将 OutputTypeAttribute 属性设置为等于 1。Web 客户端类中将 OUTPUTTYPEATTRIBUTE 参数设置为等于 1。相同的输出将如下所示：
<?xml version="1..png)
默认情况下，在容器内创建的所有文件都存储在可写的容器层上。 这意味着：
开发新的互操作性Production时，最初在Production中添加设置是很自然的做法。
不过，一旦要将Production从开发环境移动到测试或其他环境，你就会发现 HTTP 服务器、IP 地址和/或端口之类的设置都需要更改。 为了避免这些设置在后续重新部署时被覆盖，必须将这些设置从Production得设置中移动到系统默认设置(System Default Settings)。
虽然系统默认设置可以手动创建，但是当生产中有大量业务组件时会难以处理。 因此，@Wietze Drost 让我开发一个工具自动执行此流程，通过筛选表达式指定哪些设置必须创建为系统默认设置。
Web 客户端可以通过代理服务器与 Web 服务通信。要进行设置，请指定 Web 客户端实例的属性以指示要使用的代理服务器。这些属性如下：
HttpProxyServer指定要使用的代理服务器的主机名。如果此属性不为空，则 HTTP 请求将定向到此计算机。
HttpProxyPort指定代理服务器上要连接的端口。
HttpProxyHTTPS如果使用代理服务器并且该代理服务器支持 HTTPS，则将其指定为 true。
请注意，如果使用 HTTPS，则还必须将客户端的 SSLConfiguration 属性设置为 SSL/TLS 配置的名称；有关更多详细信息，请参阅配置客户端以使用 SSL。
HttpProxyAuthorization如果 Web 客户端需要向代理服务器验证自身身份，请将其指定为所需的 Proxy-Authorization 标头字段。
HttpProxyTunnel如果 Web 客户端应通过代理建立到目标 HTTP 服务器的隧道，请将其指定为 true。如果为 true，请求将使用 HTTP CONNECT 命令建立隧道。代理服务器的地址取自 HttpProxyServer 和 HttpProxyPort 属性。如果端点 URL 具有 https: 协议，则一旦建立隧道， IRIS 就会协商 SSL 连接。
在使用 InterSystems ObjectScript 进行编程时，当你定义了属性property、查询query或者索引index，系统会在编译的过程中自动创建与之相关的一些方法，这篇文章对这些方法做了些总结：
1. 假设你定义了一个属性 Property， 下面的方法会被自动创建
ClassMethod PropertyGetStored(id)对于数据类型属性，这个函数将返回其逻辑值，对于对象属性，返回id。这是一个对类global数据的封装，也是获取单例属性值(singular property value)最快的方法。此方法仅适用于已持久化存储的属性。
这里是一段采用多种方法读取数据的对比代码，用于测试各种访问数据方式的时间差异，其结果是：
Iterations: 10000
Object access: .130111
GetStored access: .014388
SQL access: .020268
Global access: .007717
Object access takes 904.30% of GetStored time
Object access takes 641.95% of SQL time
Object access takes 1686.Web 客户端生成 Web 客户端类后，通常不需要编辑该类。相反，需要编写代码来创建该类的实例并提供客户端错误处理。本主题讨论了微调 Web 客户端的各种方法，可以通过修改 Web 客户端实例或（不太常见）修改生成的类来实现。
注意：不要创建生成的 Web 客户端类的子类。编译器不会生成正常运行所需的支持类，因此子类将无法使用。
Web 客户端的 Keep-Alive默认情况下，如果重复使用 Web 客户端实例来发送多条请求消息，IRIS 会在一次 HTTP 传输中发送所有消息（使用 HTTP 1.1 保持活动连接）。具体来说，IRIS 保持 TCP/IP 套接字打开，这样 IRIS 就无需关闭并重新打开它。要禁用此保持活动行为，请执行以下操作之一：
Web 客户端实例并创建并使用一个新的。HttpRequest.SocketTimeout 属性设置为 0。例如：Set client.HttpRequest.SocketTimeout=0
注意：如果正在使用 WS-ReliableMessaging 并使用 SSL/TLS 与 Web 服务通信，请不要禁用保持活动。有关 WS-ReliableMessaging 的信息，请参阅保护 Web 服务。
XML 片段，而不是完整的 XML 文档。
responseBody，是序列化为 %Library.CharacterStream 实例的响应主体。此流通过引用传递，最初为空。如果在 Web 服务中实现此方法，则该方法应执行以下操作：
if action["action1" {
//details
}
requestBody 的 Read() 方法获取 SOAP 。例如： set request=requestBody.Read()
$EXTRACT 等工具解析此流。随着 IRIS 中向量数据类型和向量搜索功能的引入，应用程序的开发正在开启一个充满各种可能性的全新世界，其中一个应用程序示例是我最近在巴伦西亚卫生局的一次公开竞赛中看到的应用程序，他们要求提供一种工具，能够使用 AI 模型协助进行 ICD-10 编码。
我们如何实现与所要求的应用程序类似的应用程序？ 我们来看看需要什么：
IRIS 为我们提供哪些功能来满足上述需求？
我们只需要看看开发的示例：
在本文中，您可以访问开发的应用程序，在后续文章中，我们将详细了解如何实现每个功能，包括模型的使用、向量的存储和向量搜索的使用。
针对 InterSystems IRIS 数据库的一些基本概念。
InterSystems IRIS 是基于 Caché/M 语言开发的一个数据库，这个数据库被大量使用在医疗系统中，也是北美地区医疗系统病历和文件管理中默认使用的事实标准。
Caché/M 是 MUMPS 程序语言 开发的数据库，Caché/M 提供了代码接口，可以直接使用 Caché/M 对数据库来进行操作。
Caché 是一个法语单词，但是又非常容易和英语使用的 Cache 搞混，所以大部分时候使用的是 Caché/M 来表达。
M 表达的意思是 Mumps 程序语言，简称 M 语言，Caché 使用 M 语言构建了不少函数。
因为涉及到医疗系统数据的使用，所以 InterSystems IRIS 并不是一个开源的数据库，你可以使用下面的链接：Evaluate InterSystems Products 8 来下载评估版本。
本文就是根据下载的链接来进行 Windows 安装的教程。
上面的页面在下载之前，你需要进行注册，并且提供你的信息。
当下载完成后，可以双击运行安装程序。
我们会看到下面的安装界面：
同意许可协议后，单击下一步继续安装。
我们在这里使用默认的就可以，通常使用的 IRIS。
✓ 七月共有 49 位新成员加入
✓ 截至目前共发布了 2,149 篇帖子
✓ 截至目前共有 1,926 位成员加入
发布亮点
2024.2是持续交付版本。在这个版本中增加了许多更新和增强：
持续提升开发者体验
默认情况下、 Web 服务在解析请求或响应时通常使用本地数组内存。可以强制它改用进程私有全局变量；这使 Web 服务能够处理非常大的消息。
为此，请指定 Web 服务类的 USEPPGHANDLER 参数，如下所示：
Parameter USEPPGHANDLER = 1;
如果此参数为 1，则 Web 服务在解析请求或响应时始终使用进程私有全局变量。如果此参数为 0，则 Web 服务始终使用本地数组内存来实现这些目的。如果未设置此参数，则 Web 服务使用默认值，通常是本地数组内存。
Web 服务的回调可以通过覆盖其回调方法来定制 Web 服务的行为：
OnRequestMessage()如果没有安全错误，则在 Web 服务收到请求消息时调用；如果出现安全错误，则不会调用此回调。系统在执行安全处理、检查信封是否有错误以及处理 WS-Addressing 标头中指定的操作（如果有）后调用此回调。此回调对于记录原始 SOAP 请求等任务很有用。
此方法具有以下签名：
Method OnRequestMessage(mode As %String, action As %String, request As %Stream.Object)
其中：
mode 指定 SOAP 请求的类型。转发自Eduard Lebedyu的原文
在本系列文章中，我将介绍并讨论使用 InterSystems 技术和 GitLab 进行软件开发的几种可行方法。我将涉及以下主题：
Implement a function, write a program, and convert any XML-formatted string into a %XML.Adaptor object without having to create a Moudle class. This makes it easier to work with XML data. How to write it；
xsi:type 属性的使用默认情况下， SOAP 消息仅包含顶级类型的 xsi:type 属性。例如：
<?xml version="1.0" encoding="UTF-8" ?>
...
<types:GetPersonResponse>
<GetPersonResult href="#id1" />
</types:GetPersonResponse>
<types:Person id="id1" xsi:type="types:Person">
<Name>Yeats,Clint C.</Name>
<DOB>1944-12-04</DOB>
</types:Person>
...
在这些示例中，已添加换行符以提高可读性。要将此属性用于 SOAP 消息中的所有类型，请将 OUTPUTTYPEATTRIBUTE 参数或 OutputTypeAttribute 属性设置为 1。相同的输出将如下所示：
<?xml version="1.HTTP SOAP 操作和请求消息名称当通过 HTTP 调用 Web 方法时，HTTP 标头必须包含 SOAP 操作，该操作是指示 SOAP HTTP 请求意图的 URI。对于 SOAP 1.1，SOAP 操作作为 SOAPAction HTTP 标头包含在内。对于 SOAP 1.2，它包含在 Content-Type HTTP 标头中。
SOAP 操作指示 SOAP HTTP 请求的意图。该值是一个标识意图的 URI；它通常用于路由入站 SOAP 消息。例如，防火墙可以使用此标头适当地过滤 HTTP 中的 SOAP 请求消息。
对于 Web 服务中的 Web 方法，SOAPAction HTTP 标头默认具有以下形式（对于 SOAP 1.1）：
SOAPAction: NAMESPACE/Package.Class.Method
其中 NAMESPACE 是 Web 服务的 NAMESPACE 参数的值，Package.Class.Method 是用作 Web 方法的方法的名称。例如：
SOAPAction: http://www.myapp.org/GSOAP.WebService.GetPerson
要覆盖此设置，请在 Web 方法的定义中为 SoapAction 方法关键字指定一个值。
Hi社区成员们！
你可能已经知道了，, 我们的 Developer Community AI（开发者社区AI） 已经运行一个多月了 🎉 我们希望你能够出于好奇来尝试一下 😁 如果你还没试过，那就试试吧！无论如何，由于它仍在测试阶段，我们非常有兴趣了解你对它的看法，也很期待听到你的想法和经验。
我们重视你为此付出的时间和精力，所以将随机赠送一个可爱的奖品给愿意分享自己想法的社区成员。要参加此抽奖活动，你需要遵循以下准则:
要编译包含映射修饰符的类rountine，请指定编译器修饰符“/mapped=1”或“/mapped”。例如，执行以下操作：
[示例 1] 获取类列表并编译
do $System.OBJ.GetClassList(.list,"/mapped")
// build your classes starting from .list
do $System.OBJ.Compile(.list) [示例 2] 编译所有类
do $system.OBJ.CompileAll("/mapped") 
ISC 开发者们，我向你们致敬 👑。
FHIR是标准，是规范，使用FHIR使大家可以使用同一种语言、语义进行交流，名称、API都是统一的，只要符合FHIR标准，任何系统都可交互。对业务开发者来说，大部分接口交互的定义交给FHIR来处理，效率大大提高。
使用 ErrorList 查询 SYS.ApplicationError 类.
执行命令的例子如下.
USER>set $namespace="%SYS" //equal to zn "%SYS"
%SYS>set rset=##class(%ResultSet).%New()
%SYS>set rset.ClassName="SYS.ApplicationError"
%SYS>set rset.QueryName="ErrorList"
// The first argument of the query is the namespace name, the second argument is the date (in MM/DD/YYYY format).
%SYS>do rset.Execute("USER","08/17/2020")
// To display the results on the screen, execute the %Display() method.
%SYS>do rset.可以通过 TRY-CATCH 来完成:
#dim ex As %Exception.AbstractException
TRY {
//Code that causes an error
}
CATCH ex {
do ex.Log()
}如果用了 ^%ETN, 从BACK 接入点 (BACK^%ETN)处调用.
请参考另外一篇文章: 如何使用命令获得应用错误 (^ERRORS)
IRIS通过JDBC连接第三方数据库汉字查询乱码，第三方反馈需要设置字符集，不知字符集该如何设置
关键字：PyODBC，unixODBC，IRIS，IntegratedML，Jupyter Notebook，Python 3
几个月前，我简单谈到了关于“将 Python JDBC 连接到 IRIS”的话题。我后来频繁提起它， 因此决定再写一篇 5 分钟的笔记，说明如何“将 Python ODBC 连接到 IRIS”。
在 Windows 客户端中通常很容易设置 ODBC 和 PyODBC，不过我每次在 Linux/Unix 风格的服务器中设置 unixODBC 和 PyODBC 客户端时，都会遇到一些麻烦。
有没有一种简单连贯的方法，可以不安装任何 IRIS，在原版 Linux 客户端中让 PyODBC/unixODBC 针对远程 IRIS 服务器运行？
最近，我花了点时间研究如何在 Linux Docker 环境的 Jupyter Notebook 中从头开始让一个 PyODBC 演示运行起来， 记录下这篇稍微有些繁琐的笔记，以供日后快速参考。
这篇笔记将涉及以下组件：
InterSystems IRIS 允许从任何符合DB-API的Python应用程序对InterSystems IRIS 进行快速、无缝地访问。Python DB-API驱动是对PEP 249 v2.0（Python数据库API规范 v2.0）的完整兼容。
# Embedded Python examples from summer 2022
import iris as dbapi
mytable = "mypydbapi.test_things"
conn = dbapi.connect(hostname='localhost', port=1972, namespace='IRISAPP', username='superuser', password='iris')
# Create table
cursor = conn.cursor()
try:
cursor.ubuntu系统中，查询到的数据都是空字符串
python3 httpTest2.py
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
('', '', '', '', None, '')
代码如下
import pyodbc
import requests
driver = '/usr/irisodbc/bin/libirisodbc35.so'
server = 'xx'
database = 'xx'
username = 'xx'
password = 'xx'
port = 'xx'
cnxn = pyodbc.connect(driver=driver, server=server,port='51773', database=database, uid=username, pwd=password,charset='UTF-8')
cursor = cnxn.
