[toc]

第十二章 在 Web 服务中定义自定义处理 - 实现 ProcessBody()

实现 ProcessBody()

ProcessBody() 方法具有以下签名：

method ProcessBody(action As %String, requestBody As %CharacterStream, 
                   ByRef responseBody As %CharacterStream) as %Boolean

其中：

• action 是入站消息中指定的 SOAP 操作。
• requestBody 是 的一个实例，包含 元素。该流包含 XMLXML
• responseBody%Library.CharacterStream

Web

 if action["action1" { 
  //details
 }

2. 使用 requestBodyRead()

 set in1="<echoString xmlns=""http://soapinterop.org/xsd""><inputString>"
 set in2="</inputString></echoString>"  
 set contents=$extract(request,$length(in1)+1,*-$length(in2))

6. 1

随着 IRIS 中向量数据类型和向量搜索功能的引入，应用程序的开发正在开启一个充满各种可能性的全新世界，其中一个应用程序示例是我最近在巴伦西亚卫生局的一次公开竞赛中看到的应用程序，他们要求提供一种工具，能够使用 AI 模型协助进行 ICD-10 编码。

我们如何实现与所要求的应用程序类似的应用程序？ 我们来看看需要什么：

1. ICD-10 代码列表，我们将使用它作为 RAG 应用程序的上下文，在纯文本中搜索诊断结果。
2. 经过训练的模型，它会将文本向量化，我们将在其中查找 ICD-10 代码中的对应项。
3. Python 库，用于对 ICD-10 代码和文本进行摄取和向量化。
4. 一个支持文本的友好前端，我们会在其中查找可能的诊断结果。
5. 从前端接收的请求的编排。

IRIS 为我们提供哪些功能来满足上述需求？

1. CSV 导入，可以使用 RecordMapper 功能，也可以直接使用嵌入式 Python。
2. 嵌入式 Python 使我们能够实现使用所选模型生成向量所需的 Python 代码。
3. 发布将从前端应用程序调用的 REST API。
4. 互操作性生产，以允许在 IRIS 中跟踪信息。

我们只需要看看开发的示例：

d[IA]gnosis

在本文中，您可以访问开发的应用程序，在后续文章中，我们将详细了解如何实现每个功能，包括模型的使用、向量的存储和向量搜索的使用。

针对 InterSystems IRIS 数据库的一些基本概念。

InterSystems IRIS 是什么

InterSystems IRIS 是基于 Caché/M 语言开发的一个数据库，这个数据库被大量使用在医疗系统中，也是北美地区医疗系统病历和文件管理中默认使用的事实标准。

Caché/M 是什么

Caché/M 是 MUMPS 程序语言 开发的数据库，Caché/M 提供了代码接口，可以直接使用 Caché/M 对数据库来进行操作。

Caché 是一个法语单词，但是又非常容易和英语使用的 Cache 搞混，所以大部分时候使用的是 Caché/M 来表达。

M 表达的意思是 Mumps 程序语言，简称 M 语言，Caché 使用 M 语言构建了不少函数。

InterSystems IRIS 不是开源数据库

因为涉及到医疗系统数据的使用，所以 InterSystems IRIS 并不是一个开源的数据库，你可以使用下面的链接：Evaluate InterSystems Products 8 来下载评估版本。

本文就是根据下载的链接来进行 Windows 安装的教程。

上面的页面在下载之前，你需要进行注册，并且提供你的信息。

双击运行

当下载完成后，可以双击运行安装程序。

我们会看到下面的安装界面：

同意许可协议后，单击下一步继续安装。

配置实例名

我们在这里使用默认的就可以，通常使用的 IRIS。

InterSystems IRIS数据平台、InterSystems IRIS for Health和HealthShare Health Connect 2024.2版本现已正式发布(GA)。

发布亮点

2024.2是持续交付版本。在这个版本中增加了许多更新和增强：

持续提升开发者体验

• Studio移除——2024.2 Windows安装不包括Studio IDE，升级现有实例会从实例的bin目录中移除Studio。希望继续使用Studio的开发人员应该从WRC component distribution page 下载2024.1 Studio独立组件。
• Foreign Tables 得到了完全的支持——在2024.2版本中，我们解决了来自早期访问用户的反馈，包括更好的元数据管理，改进的谓词下推，以及进一步与LOAD DATA命令保持一致，LOAD DATA命令可以获取外部数据，而不是将外部数据投射到IRIS SQL表中。
• 在微软Windows中运行Python运行时保持灵活——运行微软Windows的客户现在可以选择用于嵌入式Python的Python运行环境。

第九章 使用进程私有全局变量来支持非常大的消息

使用进程私有全局变量来支持非常大的消息

默认情况下、 Web 服务在解析请求或响应时通常使用本地数组内存。可以强制它改用进程私有全局变量；这使 Web 服务能够处理非常大的消息。

为此，请指定 Web 服务类的 参数，如下所示：

Parameter USEPPGHANDLER = 1;

如果此参数为 ，则 Web 服务在解析请求或响应时始终使用进程私有全局变量。如果此参数为 0，则 服务始终使用本地数组内存来实现这些目的。如果未设置此参数，则 Web 服务使用默认值，通常是本地数组内存。

自定义 服务的回调

可以通过覆盖其回调方法来定制 服务的行为：

如果没有安全错误，则在 服务收到请求消息时调用；如果出现安全错误，则不会调用此回调。系统在执行安全处理、检查信封是否有错误以及处理 标头中指定的操作（如果有）后调用此回调。此回调对于记录原始 请求等任务很有用。

此方法具有以下签名：

其中：

• mode 指定 SOAP 请求的类型。该类型为“SOAP”或。
• 包含 标头的值。
• 请求以流的形式包含 请求消息。

此方法可以使用对象 ，它是 实例。在此对象中：

• 属性包含原始请求消息。
• 实例方法使能够检索单个 部分（如果这是一个 请求）。

此方法还可以使用 服务实例的属性。初始化期间设置以下属性：

转发自Eduard Lebedyu的原文

在本系列文章中，我将介绍并讨论使用 InterSystems 技术和 GitLab 进行软件开发的几种可行方法。我将涉及以下主题：

• 第 1 部分：Git 
  • Git 基础知识，为什么对 Git 概念的高层次理解对现代软件开发很重要、
  • 如何使用 Git 开发软件（Git 流程）
• 第 2 部分：GitLab 工作流 
  • GitLab 工作流--从创意到用户反馈的完整软件生命周期流程
  • 持续交付（Continuous Delivery）--团队在短周期内生产软件的软件工程方法，确保软件可随时可靠发布。它旨在更快、更频繁地构建、测试和发布软件。
• 第 3 部分：GitLab 安装和配置
  • GitLab 的安装和配置
  • 将环境连接到 GitLab
• 第 4 部分：CD 配置
  • 持续交付配置
• 第 5 部分：为何使用容器
  • 容器及其使用方法和原因。
• 第 6 部分：容器基础架构 
  • 使用容器的持续交付管道的主要组件
  • 它们如何协同工作。

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 属性的使用

控制 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>  
...

在这些示例中，已添加换行符以提高可读性。要将此属性用于 消息中的所有类型，请将 OUTPUTTYPEATTRIBUTE 参数或 OutputTypeAttribute 属性设置为 。相同的输出将如下所示：

<?xml version="1.0" encoding="UTF-8" ?>
...
<types:GetPersonResponse>
<GetPersonResult href="#id1" />
</types:GetPersonResponse>
<types:Person id="id1" xsi:type="types:Person">
<Name xsi:type="s:string">Yeats,Clint C.</Name>
<DOB xsi:type="s:date">1944-12-04</DOB>
</types:Person> 
...

第四章 覆盖 HTTP SOAP 操作和请求消息名称

覆盖 HTTP SOAP 操作和请求消息名称

当通过 HTTP 调用 Web 方法时，HTTP 标头必须包含 操作，该操作是指示 请求意图的 。对于 ， 操作作为 标头包含在内。对于 ，它包含在 标头中。

操作指示 请求的意图。该值是一个标识意图的 URI；它通常用于路由入站 消息。例如，防火墙可以使用此标头适当地过滤 中的 请求消息。

对于 服务中的 方法，SOAPAction HTTP 标头默认具有以下形式（对于 ）：

SOAPAction: NAMESPACE/Package.Class.Method

其中 是 服务的 参数的值， 是用作 方法的方法的名称。例如：

SOAPAction: http://www.myapp.org/GSOAP.WebService.GetPerson

要覆盖此设置，请在 方法的定义中为 方法关键字指定一个值。指定一个带引号的字符串，表示 请求的意图。在典型情况下， 服务中的每个 方法都会为 指定一个唯一值（如果有）。

如果 在该 服务中不唯一，则每个方法都必须具有唯一的 方法关键字值。此关键字指定请求消息的 主体中的顶部元素的名称。请注意， 仅对包装的文档/文字消息有效。

指定元素是否符合条件

Hi社区成员们！

你可能已经知道了，, 我们的 Developer Community AI（开发者社区AI） 已经运行一个多月了 🎉 我们希望你能够出于好奇来尝试一下 😁 如果你还没试过，那就试试吧！无论如何，由于它仍在测试阶段，我们非常有兴趣了解你对它的看法，也很期待听到你的想法和经验。

我们重视你为此付出的时间和精力，所以将随机赠送一个可爱的奖品给愿意分享自己想法的社区成员。要参加此抽奖活动，你需要遵循以下准则:

InterSystems 常见问题FAQ 

要编译包含映射修饰符的类rountine，请指定编译器修饰符“/mapped=1”或“/mapped”。例如，执行以下操作：

[示例 1] 获取类列表并编译

 do$System

[示例 2] 编译所有类 

ISC 开发者们，我向你们致敬 👑。

FHIR是标准，是规范，使用FHIR使大家可以使用同一种语言、语义进行交流，名称、API都是统一的，只要符合FHIR标准，任何系统都可交互。对业务开发者来说，大部分接口交互的定义交给FHIR来处理，效率大大提高。

InterSystems 常见问题系列

使用 ErrorList 查询 SYS.ApplicationError 类.

• 注 1: 在 %SYS 命名空间中运行.
• 注 2: 这是个非存储的utility, 所以我们用 %ResultSet 类而不用 %SQL.Statement.

执行命令的例子如下.

USER>set$namespace

以下显示如何获得在浏览行时获取SELECT的列值The following shows how to get column values ​​of a SELECT while navigating through rows.

使用Next()方法来移动到一行（如果行存在的话返回1）

获取一列的话使用 Get("column name"). 具体列名，请参考类文档里面的ErrorList 查询描述。

关于ErrorList 查询的列名.

"USER"

For terminal viewing, you can also use the ^%ER routine.

Execute the following while in the namespace you want to reference (the example is executed in the USER namespace).

InterSystems 常见问题系列

可以通过 TRY-CATCH 来完成:

 #dimAs

如果用了 ^%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）的完整兼容。

步骤

1. 前提是要有一个Python的开发环境。
   本示例使用vs code 如下所示创建一个dbapi.py文件。
   dbapi.py :

   # 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.execute(f"CREATE TABLE {mytable} (myvarchar VARCHAR(255), myint INTEGER, myfloat FLOAT)")
   except Exception as inst:
    pass
   cursor.close()
   conn.commit()
   ​
   # Create some data to fill in
   chunks = []
   paramSequence = []
   for row in range(10):
    paramSequence.append(["This is a non-selective string every row is the same data", row%10, row * 4.57292])
    if (row>0 and ((row % 10) == 0)):
      chunks.append(paramSequence)
      paramSequence = []
   chunks.append(paramSequence)
   ​
   query = f"INSERT INTO {mytable} (myvarchar, myint, myfloat) VALUES (?, ?, ?)"
   ​
   for chunk in chunks:
    cursor = conn.cursor()
    cursor.executemany(query, chunk)
    cursor.close()
    conn.commit()
   # conn.close()
   ​
   sql = f"select * from {mytable}"
   rowsRead = 0
   cursor = conn.cursor()
   cursor.arraysize = 20
   ​
   cursor.execute(sql)
   rc = cursor.rowcount
   rows = cursor.fetchall()
   for row in rows:
    print(row)
   rowsRead += len(rows)
   ​
   cursor.close()
   conn.close()

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.

        IRISHealth以其完备且系统化的安全特性在医疗行业的数据库中独树一帜，这些特性包括安全认证、安全授权、安全审计、数据加密以及安全配置。其中数据传输无疑是其中最重要的一环。为此，IRISHealth采用了SSL/TLS技术来对传输的数据进行加密，有效保障了从IRIS数据平台的超级服务数据传输、Telnet服务数据传输、java/.net/Studio客户端的访问数据传输、MIRROR与DB的数据传输，到DBServer和ECPApp之间的数据传输的安全性。

        本文是在两个IRISHealth2021实例之间进行ECP服务通信的示例，一个作为DBServer，一个作为ECPApp，两个实例之间通过使用SSL/TLS的ECP协议进行TCP的加密传输通信。

1.IRIS的DB和ECP环境：

2. CA证书的环境：

问题：锁管理里边包含很多WorkQueueMgr的锁，我想批量去移除，比较多，一个一个移除比较慢

解决：查询所有的进程，过滤routine不包含某个routine的进程，进行终止

代码：

ClassMethod BatchTerminalProcessQuery()
{     Set Rset = ##class(%ResultSet).%New("%SYS.ProcessQuery:ListPids")
d Rset.Execute()
While Rset.Next() {
   s CurrentLineAndRoutine=""
   &sql(SELECT CurrentLineAndRoutine INTO :CurrentLineAndRoutine FROM %SYS.ProcessQuery WHERE Pid = :Rset.GetData(1))
   continue:CurrentLineAndRoutine'[".WorkQueueMgr"
   w CurrentLineAndRoutine,!
   s pid=Rset.GetData(1)
   s sc= $System.Process.Terminate(pid)
   w sc,!
   ;w $ZU(4,pid,1)
}
d Rset.Close()
}

在当今充满活力的医疗保健行业，获取全面、精简的医疗记录对于做出明智的决策至关重要。人工智能驱动的健康图表应用程序是一个开创性的解决方案，旨在为医生提供一种获取和理解健康数据的有效方式。

主要功能

- 全面的数据检索： 健康图表应用程序通过提取各种健康数据，包括过敏症、病情、手术、免疫接种、药物、家族史、社会史、生命体征和化验结果，超越了传统记录。这种全面的视角可以让人们深入了解患者的健康历程。

- 通过人工智能增强洞察力：通过利用人工智能的力量，Health Chart 应用程序可以智能处理数据。人工智能引擎将原始信息转化为可操作的洞察，生成健康摘要和风险评估。这不仅节省了医生的宝贵时间，还提高了患者护理质量。

公司介绍：https://www.prairiebyte.com

软件试用

目标使用者--临床医生

类别--护理协调, 数据可视化, 疾病管理/基层医疗

应用程序类型--SMART ON FHIR应用程序

FHIR 版本--R4

支持的电子病历系统--Cerner、Epic等支持FHIR API的软件系统

Abstractive Health是一款医生人工智能助手，可帮助医生创建最佳病历。我们直接与国家 HIE 和 EHR 集成。我们的医疗摘要可用于门诊、住院和急诊护理，实现临床笔记的自动化，如 SOAP 笔记、进展笔记、护理过渡、ED Provider 笔记和出院摘要。我们使用生成式人工智能和 LLM 来压缩数百页的医疗笔记，从而节省您的时间，让您可以专注于病人护理。

公司介绍：https://www.abstractivehealth.com

软件试用

目标使用者--临床医生

类别--护理协调, 数据可视化, 人口健康

应用程序类型--SMART ON FHIR应用程序

FHIR 版本--R4

支持的电子病历系统--Allscripts、Athena Health、Cerner、Epic等支持FHIR API的软件系统

安全和隐私政策: https://www.abstractivehealth.com/security-and-privacy

社区版下载不了，是需要vpn吗

csp.log日志是这个

嗨，开发者，

我们很高兴邀请大家参加新的以 Python 为主题的 InterSystems 在线编程竞赛！

🏆 InterSystems 2024 Python 编程大赛 🏆

时间: 2024年7月15日-8月4日（美国东部时间）

奖金池: 14,000美元

InterSystems 常见问题系列FAQ

如果要让超时功能失效, 在DSN设置查询超时为disabled:

Windows Control Panel > Administrative Tools > Data Sources (ODBC) > System DSN configuration

如果勾选了Disable query timeout , 超时就会失效.

如果想在应用侧修改，你可以在ODBC API 层设置：在连接数据源之前，调用ODBC SQLSetStmtAttr功能设置SQL_ATTR_QUERY_TIMEOUT 属性 

InterSystems 常见问题FAQ

如果您想在InterSystems 产品启动时执行一个操作系统可执行文件，命令或者程序，可以在SYSTEM^%ZSTART routine里面写明流程 ( %ZSTART routine在 %SYS 命名空间里面创建).

在 SYSTEM^%ZSTART 里面写代码之前, 请确保他可以在任何情况下能正常工作

如果 ^%ZSTART routine 写的不对，或者没有响应或者发生错误，InterSystems 产品可能会无法启动。

更多信息，请参考一下文档。

About writing %ZSTART and %ZSTOP routines [IRIS]
About writing %ZSTART and %ZSTOP routines

InterSystems  常见问题系列FAQ

InterSystems 产品里数据 (表、对象、实例数据) 是存在global 变量里的。
每个global 的数据大小可以从管理门户中中点击属性查看Management Portal > System > Configuration > Local Database > Globals page, 然后在global 属性页点击计算大小Calculate Size 按钮。
你可以在终端上调用^%GSIZE 来在命名空间里显示数据大小，方法如下.