搜索​​​​

清除过滤器
文章
Louis Lu · 十二月 24, 2023

接收POST请求的Base64 文件

在此文章中将分享,当使用InterSystems IRIS 做后端时如何接收并保存通过POST方式发送过来的 Base64文件。 前后端之间传输文件,我认为较简单的方式是:前端将文件转为Base64格式,调用POST方法并将Base64内容附加在JSON消息中的一个参数中,在JSON消息中的另一个参数可以是文件名,比如消息定义如下: { "fileData": "JVBERi0xLjQKJdPr6eEKMSAwIG...", "fileName": "example.pdf" } 在IRIS中,可以定义一个web application用于处理POST请求,同时定义一个分派类继承于%CSP.REST,在类中定义一个方法,具体保存文件。 代码示例: ClassMethod SaveFile() As %Status { Try { Do ##class(%REST.Impl).%SetContentType("application/json") If '##class(%REST.Impl).%CheckAccepts("application/json") Do ##class(%REST.Impl).%ReportRESTError(..#HTTP406NOTACCEPTABLE,$$$ERROR($$$RESTBadAccepts)) Quit // Reading the body of the http call with the file data set dynamicBody = {}.%FromJSON(%request.Content) set dynamicStream = dynamicBody.%Get("fileData",,"stream<base64") set stream=##class(%Stream.FileBinary).%New() set sc=stream.LinkToFile("/shared/durable/"_dynamicBody.fileName) set sc=stream.CopyFromAndSave(dynamicStream) } Catch (ex) { Do ##class(%REST.Impl).%SetStatusCode("400") Do ##class(%REST.Impl).%WriteResponse(ex.DisplayString()) return {"errormessage": "Client error"} } Quit $$$OK } 下面具体解释下其中较重要的部分: 获取到请求的消息内容,并将其转化为%Library.DynamicAbstractObject对象,这样我们可以后面通过对象的方式进行处理 set dynamicBody = {}.%FromJSON(%request.Content) 下面是比较重要的一步,我们将Base64 转化为 %Stream 类型,我们可以直接通过%Library.DynamicObject类下面的%Get方法实现 set dynamicStream = dynamicBody.%Get("fileData",,"stream<base64") 要注意的一点是,这里我们完全可以绕过了string 常常遇到的MAXSTRING 错误,因为我们直接将Base64转化为stream. 最后,我们在服务器上创建了一个文件,内容来自传进的Base64,文件名也来自于传入的JSON消息 set stream=##class(%Stream.FileBinary).%New() set sc=stream.LinkToFile("/shared/durable/"_dynamicBody.fileName) set sc=stream.CopyFromAndSave(dynamicStream)
公告
Claire Zheng · 五月 20

【精彩会议回放】区域医疗信息互联互通新发展研讨会在深圳举办

为推动《“十四五”全民健康信息化规划》全面实施,充分发挥国家医疗健康信息互联互通标准化成熟度评测工作对区域医疗信息交换促进作用,为医疗数据合规高效流通使用奠定坚实基础。《中国卫生信息管理杂志》社主办、深圳市卫生健康信息协会协办、InterSystems中国承办的区域信息互联互通新发展研讨会于5月11日在深圳举办。 国家卫生健康委统计信息中心胡建平副主任线上参会并致辞、广东省卫生健康委员会事务中心傅承主副主任、深圳市卫生健康信息协会林德南会长参加会议并致辞。胡建平副主任在视频致辞中强调了医疗健康信息互联互通标准化成熟度测评对区域全民健康信息化和智慧医院建设起到的重要作用,总结了互联互通标准化成熟度测评主要开展的四方面工作,指出下一步工作要从网络通、应用通、数据通等三个维度持续发力,通过叠加区块链等信息技术,实现互联互通从1.0阶段向2.0阶段跃迁,赋能卫生健康事业高质量发展。 查看精彩内容回放:欢迎扫描下图中的二维码或点击此处(如果您已报名过此次会议,使用报名时的手机号码即可登录查看,如首次登录,需填写报名信息后查看)
文章
Michael Lei · 七月 4, 2021

Gartner DBMS 魔力象限中的主要领先数据库产品功能对比

大家好, 在本文中,我比较了 Gartner 最新DBMS 魔力象限中的主要领先数据库产品的功能。 请见按现有功能数量排序的列表。 1. InterSystems IRIS 2020.3 - 60 个功能 (https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls) 2. Oracle Database 21c - 54 个功能 (https://docs.oracle.com/en/database/oracle/oracle-database/index.html) 3. Microsoft SQL Server - 45 个功能 (https://docs.microsoft.com/en-us/sql/sql-server/?view=sql-server-ver15) 4. AWS Aurora - PostgreSQL - 34 个功能 (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) 我只比较了功能,未进行任何性能比较(关于此内容,请参见性能测试:https://cn.community.intersystems.com/post/intersystems-iris%E6%95%B0%E6%8D%AE%E5%B9%B3%E5%8F%B0%EF%BC%9A%E6%95%B0%E6%8D%AE%E6%8E%A5%E6%94%B6%E9%80%9F%E5%BA%A6%E6%B5%8B%E8%AF%95)。 我使用了上面的产品官方文档链接。 请见比较表格: <colgroup><col style="width:245pt" width="327"><col style="width:88pt" width="118"><col style="width:122pt" width="162"><col style="width:150pt" width="200"><col style="width:146pt" width="195"></colgroup> 功能 InterSystemsIRIS 2020.3 OracleDatabase 21c MicrosoftSQL Server 2020 AWS Aurora -PostgreSQL 故障转移集群 有 有 有 有 镜像/数据复制 有 有 有 有 分布式缓存/内存中支持 有 有 有 有 备份/恢复 - 增量和完整 有 有 有 有 纵向缩放 有 有 有 有 针对 Insert、Update 和 Delete 进行横向缩放 有 有 无 无 针对 Select 进行横向缩放 有 有 有 有 分片集群 有 有 无 有 云支持和云管理器 有 有 有 有 Kubernetes 支持和 Kubernetes 管理器 有 有 有 有 Docker 支持 有 有 有 无 AWS 托管 有 有 有 有 Azure 托管 有 有 有 无 Google Cloud 托管 有 有 有 无 托管云 有 有 有 有 内部部署支持 有 有 有 无 多模型 - OO 有 无 无 无 多模型 - 文档 - JSON 有 有 有 有 多模型 - XML 有 有 有 有 多模型 - 键/值 有 无 无 无 多模型 - SQL 有 有 有 有 多模型 - 空间 无 有 有 有 多模型 - 图表 无 有 有 无 多模型 - OLAP 多维数据集 有 有 有 无 GIS 平台 无 有 无 无 本机 OO 编程语言 有 有 无 无 Java、.Net、Python、C/C++ 和 PHP 支持 有 有 有 有 Node.js 支持 有 有 有 有 ODBC/JDBC 支持 有 有 有 有 后端应用程序开发 有 有 无 无 前端应用程序开发 有 有 无 无 低代码 Web 应用程序开发 无 有 有 无 数据库应用程序开发 有 有 有 有 OData 支持 无 有 有 无 REST 服务 有 有 有 有 SOAP 服务 有 无 无 无 终端工具 有 有 有 有 IDE 支持 有 有 有 有 Web 管理/IDE 支持 有 有 有 有 嵌入 NLP 有 无 无 无 嵌入 AutoML 有 无 无 无 R/机器学习支持 有 有 有 有 PMML 有 无 无 无 业务报表服务器/开发 有 有 有 无 自主 AI 操作 无 有 无 无 非结构化文本注释/类似 Apache UIMA 有 有 无 无 Spark 支持 有 有 有 有 BI 工具 有 无 有 无 MDX 支持 有 有 有 无 互操作性连接器 有 无 无 无 BPEL/集成编排/工作流 有 无 无 无 ETL - 提取、转换和加载数据 有 无 无 无 IoT/MQTT 支持 有 无 无 无 EDI 支持 有 无 无 无 ESB 有 无 无 无 CDC - 变更数据捕获 有 有 有 有 RBAC 模型 有 有 有 有 LDAP 支持 有 有 有 有 双因素授权/身份验证支持 有 有 有 有 加密 有 有 有 有 标记 有 有 有 无 审计和跟踪 有 有 有 有 SAM 有 有 有 有 多操作系统支持 有 有 有 有 SAML/Oauth/OpenID 支持 有 有 有 有 性能调整 IDE/包 无 有 无 无 特权用户访问管理 无 有 无 无 API 管理 有 无 无 无 功能总数 61 54 45 34
文章
Michael Lei · 九月 15, 2022

示例:使用 Java + SpringBoot + Hibernate 和 IRIS 数据库创建 REST API

Spring Boot 是最常用来创建 REST API 和微服务的 Java 框架。 它可用于部署 Web 应用程序、可执行 Web 应用程序或桌面自包含应用程序,其中应用程序和其他依赖项打包在一起。 Spring Boot 允许执行许多功能,请参见: 注:要了解有关 SpringBoot 的信息,请参见官方网站 - https://spring.io/quickstart 要创建具有一个或多个微服务的 Web api 应用程序,可以使用 Spring IDE for Eclipse/VSCode,并使用向导配置上述将在应用程序中使用的技术,请参见: ![](/sites/default/files/inline/images/images/image(1388).png) 您可以选择技术并创建项目。 所有技术都将通过 maven 导入。 它就像一个可视化的 zpm。 所创建的项目有一个类用于为应用程序提供支持,其中包含所有所需内容(Web 和应用程序服务器,以及所有依赖项、微服务概念)。 此项目的完整源代码在以下 open exchange 项目中: https://openexchange.intersystems.com/package/springboot-iris-crud。 首先要配置 IRIS JDBC 驱动程序和 IRIS Hibernate 支持,为此,请将 jar 文件复制到 resources 文件夹,请参见: ![](/sites/default/files/inline/images/images/image(1390).png) 打开 pom.xml 以配置这些 jar 文件的依赖项,请参见: <dependency> <groupId>com.intersystems</groupId> <artifactId>intersystems-jdbc</artifactId> <version>3.2.0</version> <scope>system</scope> <systemPath>${project.basedir}/src/main/resources/intersystems-jdbc-3.2.0.jar</systemPath> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-iris</artifactId> <version>1.0.0</version> <scope>system</scope> <systemPath>${project.basedir}/src/main/resources/hibernate-iris-1.0.0.jar</systemPath> </dependency>   现在可以在 application.properties 中配置与 IRIS 数据库的连接,请参见: spring.datasource.username=_SYSTEM spring.datasource.url=jdbc:IRIS://iris:1972/USER spring.datasource.password=SYS spring.jpa.properties.hibernate.default_schema=dc_Sample #spring.jpa.hibernate.ddl-auto=update spring.datasource.driver-class-name=com.intersystems.jdbc.IRISDriver spring.jpa.properties.hibernate.temp.use_jdbc_metadata_defaults = false spring.jpa.database-platform=org.hibernate.dialect.InterSystemsIRISDialect spring.datasource.sql-script-encoding=utf-8 server.tomcat.relaxed-query-chars=|,{,},[,] spring.jpa.show-sql=false spring.jpa.properties.hibernate.format_sql=true 下一步是创建一个映射到 IRIS 表的持久化 Java 类,请参见: package community.intersystems.springboot.app.model; import java.io.Serializable; import java.util.Date; import javax.persistence.Column; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.GenerationType; import javax.persistence.Id; import javax.persistence.Table; import javax.persistence.Temporal; import javax.persistence.TemporalType; import com.fasterxml.jackson.annotation.JsonFormat; @Entity @Table(name = "Product") public class Product implements Serializable { private static final long serialVersionUID = 1L; @Id @GeneratedValue (strategy = GenerationType.IDENTITY) private Long id; private String name; private String description; private Double height; private Double width; private Double weight; @Column(name="releasedate") @Temporal(TemporalType.DATE) @JsonFormat(pattern = "dd/MM/yyyy") private Date releaseDate; public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getDescription() { return description; } public void setDescription(String description) { this.description = description; } public Double getHeight() { return height; } public void setHeight(Double height) { this.height = height; } public Double getWidth() { return width; } public void setWidth(Double width) { this.width = width; } public Double getWeight() { return weight; } public void setWeight(Double weight) { this.weight = weight; } public Date getReleaseDate() { return releaseDate; } public void setReleaseDate(Date releaseDate) { this.releaseDate = releaseDate; } } 最后一步是创建一个仓库接口,以将您的持久化类作为 REST 服务公开(以 HATEOAS 模式),您无需执​​行 crud 操作,只需编写以下代码: package community.intersystems.springboot.app.repository; import org.springframework.data.jpa.repository.JpaRepository; import community.intersystems.springboot.app.model.Product; public interface ProductRepository extends JpaRepository<Product, Long> { } 现在,将您的应用程序作为 Spring Boot 应用程序运行: ![](/sites/default/files/inline/images/images/image(1389).png) 等待内部服务器启动,然后打开 localhost:8080。 Spring boot 将打开一个 API REST HAL 浏览器。 请参见以下图像记录: ![IRIS 与 Hibernate 配合运行](https://github.com/yurimarx/springboot-iris-crud/raw/master/iris-hibernate.gif) 更多详细信息,请参见我的应用程序示例。 我将所有内容一起打包成一个 Docker 项目,其中包含 2 个服务:IRIS 和 SpringBoot。 HATEOAS 模式非常适合 api url、路径和导航,更多详细信息,请自行百度。 祝使用愉快!
文章
Hao Ma · 十一月 22, 2022

ObjectScript的命名规范

命名规范,英文叫"name convention", 是对写代码取名字的一些”共识“。也就是说, 你可以不遵守,但大家都选择了遵守,照者一个规范来。为什么呢?因为有社区,大家要共享代码, 你不照着规矩来, 别人会鄙视你, 懒的用你的代码。 ObjectScript以前没什么社区,大家各写各的, 使用ObjectScript的大公司也没谁把自己的代码拿出来共享。因此,个人开发者基本就是参考官方InterSystems的命名规范。举个例子, 比如以下的代码: ```java Class Ens.Util.ResponseBodyMethods { property NoFailWhileDisconnected as %Boolean; property FirstName as %String; parameter SETTINGS = "ReplyCodeActions"; method OnKeepalive(pAdapterStatus As %Status) as %String { return "okay" } } ``` 我来简单总结一下: - **包名和类名**:Pascal格式,也就是首字母大写。其中%开头的是官方独占, - **Property名字**:首字母大写 - **method Name**:同上。但出入参用的是驼峰格式,也就是第一个单词小写,后面单词大写开头。 - **Parameter Name**:常量。 官方的代码都是这个规范吗? 大体上是,但也有例外, 比如%xsd包,包名类名全小写, 像这样: %xsd.string。这个从Caché年代就这样,我是不明白为什么这个包这么特殊。 到了IRIS上,更多瞎写了, 比如这个: [%SYSTEM.external.SQL](https://docs.intersystems.com/iris20222/csp/documatic/%25CSP.Documatic.cls?LIBRARY=%25SYS&CLASSNAME=%25SYSTEM.external.SQL)。不光是它,我发现很多和“external“相关的包名,都开始用小写了,写在代码里是这样的: %system.external.help(), %system.dotnet.SQL.addPath()。后面一个为什么SQL大小,dotnet小写,我也是没想明白。 然后,重要的来了。 InterSystems Developer Community贴出了这样的[community代码命名规范](https://community.intersystems.com/post/objectscript-package-manager-naming-convention)。它是怎么被推广的呢? 通过zpm,也就是社区里的代码ObjectScript的包管理工具。曾经一度你要参加社区的代码比赛,就必须使用zpm打包,而zpm对使用这个代码规范有硬要求,所以这个convention得到了一定程度的接受,能看到越来越多的开发者这么写代码了。 原文上面有链接,这里说最重要的: **package名字全小写,class名字用首字母大写**。比如class会定义成: ```java class company.project.subpackage.TheClass{ ... } ``` 这基本上是借鉴Java。作者也说了:*The approach borrowed from the naming convention for java classes.* 作者还做了个解释:全小写的Package名字避免了和class或者interface的名字冲突。这句话我不是很明白。 我觉得网友只所以接受它,纯粹就是java和python用惯了,烦大写的类名。 如果都是c++, c#的程序员,估计这个命名规范还得有得吵。 我这里只说了包名类名, 其他的method, property, 变量的命名什么的,还包括github上repo起名字的规范, 有兴趣去原文看看吧。 我是挺喜欢这个规范的。 唯一有点不满意的是:Java中定义Package name 和class name不是连着写在一起的,比如下面: ```java package org.springframework.asm; public abstract class AnnotationVisitor { ... } ``` 所以你很少能看到包名和类名连写在一起的情况,所以小写的小写, 大写的大写,都不挨着。而ObjectScript的类定义一定要写全了, 上面的定义如果在ObjectScript里就是: ```java public class org.springframework.asm.AnnotationVisitor { ... } ``` 因此这样的写法会有个视觉上的大小写的落差。 我属于没事找事的。 结论: 社区有了命名规范,矮骡子们纷纷表示支持。 按这个convention,Tony老师如果去写一个示例代码贡献给社区的话,可能是这样的 ```java class com.dhc.tony.demo.xml.TestUtils { property noFailWhileDisconnected as %Boolean; property firstname as %String; parameter SETTINGS = "ReplyCodeActions"; method onKeepalive(pAdapterStatus As %Status) as %String { return "okay" } } ``` 我们目前还都是首字母大写的驼峰 之后是要统一改用zpm的命名规范吗。。。
文章
Michael Lei · 八月 26, 2021

SAM - 设置和添加非 IRIS 目标指标的技巧和提示

# SAM - 设置和添加非 IRIS 目标指标的技巧和提示 SAM(系统警报和监视)以“功能齐全”的 docker-compose 容器集的形式提供,只要启动就可以开始以默认的仪表板监视 IRIS 实例。 使用初始配置就可以很好地了解 SAM 功能并开始对 IRIS 系统进行基本监视。 但是,当开始监视多个系统并收集大量指标数据时,需要更改一些默认设置。 为了从 SAM 获取更多价值,您还会想要添加来自其他数据源(目标)的指标。 以下技巧将帮助您在生产环境中部署 SAM,从多个目标收集指标并将这些指标组合到您自己的仪表板和图表中。 此外,您还将看到一些可能有助于探索 SAM 容器和应用程序的命令。 > *注意:*我应该指出,其中一些技巧和提示可能不是最佳做法;这更像是一个日志,记录了我第一次如何配置 SAM 来监视相同系统上的多个服务器和非 IRIS 目标的基准。 如果您有建议,请在评论中指教 ;) 所以,记住本帖可能会随着时间的推移而有所变化,让我们开始吧; --- 在下面的技巧中,有重启 docker 以及启动和停止 SAM 的操作。 请通读这些技巧,确定哪些适合您,然后按照下面的相同顺序执行。 ## 1. 确保有足够的空间用于 SAM 数据库 默认情况下,docker 容器将文件存储在根 (/) 文件系统。 SAM 不需要很多 CPU 或内存资源;但是,指标收集将占用空间。 > 指标需要的存储容量“视情况而定”。 虽然在开始监视之前可能无法明确数据库大小,但大致上,在抓取周期为 15 秒的情况下,监视 10 个 IRIS 虚拟机以及操作系统指标大约消耗 50GB 存储。 策略包括:增加监视实例的根存储,或更改数据库的卷位置。 我使用了以下命令来更改运行 docker 的虚拟机上的 docker 目录。 也许是杀鸡用了牛刀,但很管用。 - 停止 docker 并将 docker 文件复制到空间充足的文件系统(本例中为 /data/docker/data)。 见下面的示例: ```other [root@mysamserver lib]# sudo systemctl stop docker [root@mysamserver lib]# pwd /var/lib [root@mysamserver lib]# cp -rp docker /data/docker/data [root@mysamserver lib]# [root@mysamserver lib]# rm -rf docker ``` - 在 docker 配置文件中更新卷路径。 注意此文件还有一个网络设置“bip”(请参见注释:...) ```swift cat /etc/docker/daemon.json { "data-root": "/data/docker/data", "bip": "192.168.0.1/24" } ``` - 重启 docker ```swift sudo systemctl daemon-reload sudo systemctl restart docker systemctl status docker.service ``` ## 2. 设置 SAM 我假定您已在测试系统上设置 SAM,并熟悉它的基本操作:添加集群和实例,以及查看系统指标。 建议您花 20 分钟时间查看我在虚拟全球峰会 2020 上的展示,以了解安装步骤的概述,以及添加多个目标的运行指标时 SAM 的外观。 要观看此会议,请使用以下链接(您需要使用您的电子邮件注册): [DEV007 系统警报和监视](https://intersystems.6connex.com/event/virtual-summit/en-us/contents/434680/share?rid=Lobby&nid=804450) 登录到 SAM 门户并配置一些 IRIS 实例。 这会填充配置文件并提供向导。 `http://mysamserver:8080/api/sam/app/index.csp#/` > 注意:如果要添加多个实例,或者希望用脚本执行此步骤,可以通过 API 添加实例。 请参见文档。 ## 3. 升级到生产许可证 SAM 随附了一个 IRIS 社区版许可证。 有几个限制,包括 IRIS.DAT 限制为 10GB。 10GB 不足以长时间从多个目标收集数据。 请联系您的 InterSystems 联系人以获取生产许可证。 在没有编辑器的情况下,在精简的容器中更新许可证可能很棘手,我只是在 IRIS 容器上登录一个交互式会话,然后使用以下命令更新许可证密钥: - 打开 shell,切换目录至 mgr 文件夹(iris.key 文件的默认位置) ```swift docker exec -it sam_iris_1 bash cd /dur/iconfig/mgr ``` - 使用 unix“here 文档”更新密钥。 在“>”后面粘贴密钥文本。 在密钥文本后面,输入“>EOF”以提交命令。 然后输入“exit”退出 shell。 ```other cat [ConfigFile] FileType=InterSystems License Rev-A.1 LicenseID=999999 [License] LicenseCapacity=InterSystems IRIS 2020.2 Server for SAM:etc etc, the key you were sent by your InterSystems contact. >EOF exit ``` - 然后使用提供的 docker-compose shell 脚本停止再启动 SAM: ```swift ./stop.sh ./start.sh ``` - 可以通过访问系统管理门户或登录到 iris 实例并检查 messages.log 来检查许可证是否一切正常。 ```shell docker exec -it sam_iris_1 bash cd /dur/iconfig/mgr cat messages.log ``` ## 4. 在目标上安装其他 prometheus 导出程序 例如,prometheus 节点导出程序可显示各种硬件和内核相关的指标。 [节点导出程序文档](https://prometheus.io/docs/guides/node-exporter/) 通过请求(抓取)实例端点的指标,测试节点导出程序是否正常工作: ```swift curl my_target_server_name:9100/metrics ``` 您应该看到类似下面的信息: ```swift mylaptop:~ mo$ my_target_server_name:9100/metrics | more HELP go_gc_duration_seconds A summary of the GC invocation durations. # TYPE go_gc_duration_seconds summary go_gc_duration_seconds{quantile="0"} 4.8862e-05 go_gc_duration_seconds{quantile="0.25"} 7.5898e-05 go_gc_duration_seconds{quantile="0.5"} 9.2974e-05 go_gc_duration_seconds{quantile="0.75"} 0.000130664 go_gc_duration_seconds{quantile="1"} 0.000358762 go_gc_duration_seconds_sum 303.291715258 go_gc_duration_seconds_count 2.572586e+06 # HELP go_goroutines Number of goroutines that currently exist. # TYPE go_goroutines gauge go_goroutines 9 : : many many metrics will be displayed ``` 注意您可以对您的 IRIS 实例执行同样操作: ```swift mylaptop:~ mo$ curl my_target_server_name:52776/api/monitor/metrics | more iris_cpu_pct{id="AUXWD"} 0 iris_cpu_pct{id="CSPDMN"} 0 iris_cpu_pct{id="CSPSRV"} 0 iris_cpu_pct{id="ECPCliR"} 0 iris_cpu_pct{id="ECPCliW"} 0 iris_cpu_pct{id="ECPSrvR"} 0 iris_cpu_pct{id="ECPSrvW"} 0 : : many many metrics will be displayed ``` ## 5. 编辑配置文件以添加对新目标的抓取 例如,前一个技巧中的 node-exporter 实例。 配置文件将位于 SAM 的安装位置。 如下所示,可以看到 grafana 和 prometheus `yml` 配置文件。 ```plaintext [root@mysamserver sam-1.0.0.115-unix]# ls config docker-compose.yml readme.txt start.sh stop.sh [root@mysamserver sam-1.0.0.115-unix]# tree -x config config ├── alertmanager │   └── isc_alertmanager.yml ├── grafana │   ├── dashboard.json │   ├── dashboard-provider.yml │   ├── datasource.yml │   └── grafana.ini ├── nginx │   └── nginx.conf └── prometheus ├── isc_alert_rules.yml └── isc_prometheus.yml 4 directories, 8 files ``` ## 5.1 添加目标到 prometheus 以下示例是使用 SAM 中的配置 GUI 屏幕创建的 `isc_prometheus.yml` 文件。 该文件包含两个集群。 一个集群监视 sam 实例本身,另一个集群监视五个 IRIS 实例。 ```yaml alerting: alertmanagers: - static_configs: - targets: - alertmanager:9093 global: evaluation_interval: 15s scrape_interval: 15s remote_read: - url: http://iris:52773/api/sam/private/db/read remote_write: - url: http://iris:52773/api/sam/private/db/write rule_files: - ./isc_alert_rules.yml scrape_configs: - job_name: SAM metrics_path: /api/monitor/metrics scheme: http static_configs: - labels: cluster: "1" targets: - mysaminstance.mycompany.com:8080 - labels: cluster: "2" targets: - myiristarget1:52776 - myiristarget2:52776 - myiristarget3:52776 - myiristarget4:52776 - myiristarget5:52776 ``` - 要添加对其他运行 node-exporter 的目标的抓取,请将以下内容添加到 `isc_prometheus.yml` 文件的底部。 注意 API `metrics_path` 与 IRIS 不同。 ```yaml alerting: alertmanagers: - static_configs: - targets: - alertmanager:9093 global: evaluation_interval: 15s scrape_interval: 15s remote_read: - url: http://iris:52773/api/sam/private/db/read remote_write: - url: http://iris:52773/api/sam/private/db/write rule_files: - ./isc_alert_rules.yml scrape_configs: - job_name: SAM metrics_path: /api/monitor/metrics scheme: http static_configs: - labels: cluster: "1" targets: - iscsydsam.iscinternal.com:8080 - labels: cluster: "2" targets: - myiristarget1:52776 - myiristarget2:52776 - myiristarget3:52776 - myiristarget4:52776 - myiristarget5:52776 - job_name: node_shard1 metrics_path: /metrics scheme: http static_configs: - labels: cluster: "2" group: node targets: - myiristarget1:9100 - job_name: node_shard2 metrics_path: /metrics scheme: http static_configs: - labels: cluster: "2" group: node targets: - myiristarget2:9100 - job_name: node_shard3 metrics_path: /metrics scheme: http static_configs: - labels: cluster: "2" group: node targets: - myiristarget3:9100 - job_name: node_shard4 metrics_path: /metrics scheme: http static_configs: - labels: cluster: "2" group: node targets: - myiristarget4:9100 - job_name: node_shard5 metrics_path: /metrics scheme: http static_configs: - labels: cluster: "2" group: node targets: - myiristarget5:9100 ``` - 然后使用提供的 docker-compose shell 脚本停止再启动 SAM: ```swift ./stop.sh ./start.sh ``` SAM 现在从您通过 GUI 添加的 IRIS 实例以及相同实例上的 node-exporter 中收集指标。 # 6. 增加 Prometheus 收集指标的天数 在 SAM 的第一版中,您可以在 GUI 中更改收集指标的天数。 但是,我在显示所有指标时遇到一个问题。 在我弄清楚发生了什么之前,我更改了 Prometheus 中的保留天数,否则 SAM 将收集数据,但是您在 Grafana 的 Prometheus 查询中看不到指标。 在文件 `docker-compose.yml` 中用来安装 SAM 的层,更改 Prometheus 启动时设置的保留天数,例如在 `prometheus` 部分中,更新 `storage.tsdb.retention.time` 参数以匹配所需的保留天数: ```swift prometheus: command: - --web.enable-lifecycle - --config.file=/config/isc_prometheus.yml - --storage.tsdb.retention.time=30d ``` > 注意:在 SAM 的第一版中,最长保留天数为 30 天。 然后使用提供的 docker-compose shell 脚本停止再启动 SAM: ```swift ./stop.sh ./start.sh ``` ## 7. 创建您自己的仪表板 您可以向现有仪表板添加面板,也可以创建新的仪表板以满足您的监视需求。 这是一个很大的主题,所以留到下一个帖子再说。 不过,这里先帮助您上手。 在 SAM 屏幕上使用 `View in Grafana`(在 Grafana 中查看)按钮切换到 Grafana。 ![DraggedImage.png](https://res.craft.do/user/full/635e53bd-527a-1620-0e31-f8c3bdff1139/doc/CB3E6427-4D46-40C7-93DF-9E1FE801E814/C1AAEA2C-B8AF-4CF6-AB18-DD562971A9BC_2) 打开 Grafana 后,可以创建或编辑仪表板; ![DraggedImage-1.png](https://res.craft.do/user/full/635e53bd-527a-1620-0e31-f8c3bdff1139/doc/CB3E6427-4D46-40C7-93DF-9E1FE801E814/BC370FDF-308A-4917-9262-42AE286BDE8B_2) 网上有许多查询导出程序(如 node-exporter)的示例。 > 当可以显示 IRIS 系统指标(SAM 中的默认设置)、IRIS 应用程序指标(您需要将这些指标构建到应用程序中)以及其他指标(如 node-exporter 或由供应商创建的任何数量的指标)时,真正强大的功能才体现出来。 例如,[使用 SAM 和 cAdvisor 监视 Docker 容器](https://community.intersystems.com/post/monitor-docker-containers-using-sam-and-cadvisor)
文章
姚 鑫 · 六月 30, 2021

第二十三章 执行XSLT转换

# 第二十三章 执行XSLT转换概述 XSLT(Extensible StyleSheet Language Transformations,可扩展样式表语言转换)是一种基于XML的语言,用于描述如何将给定的XML文档转换为另一个XML或其他“人类可读”的文档。可以使用`%XML.XSLT`和`%XML.XSLT2`包中的类来执行`XSLT 1.0`和`2.0`转换。 注意:使用的任何XML文档的XML声明都应该指明该文档的字符编码,并且文档应该按照声明的方式进行编码。如果未声明字符编码, IRIS将使用本书前面的“输入和输出的字符编码”中描述的默认值。如果这些默认值不正确,请修改XML声明,使其指定实际使用的字符集。 # 在IRIS中执行XSLT转换概述 IRIS提供两个XSLT处理器,每个处理器都有自己的API: - `Xalan`处理器支持`XSLT 1.0`。`XML.XSLT`包为该处理器提供API。 - `Saxon`处理器支持`XSLT 2.0`。`%XML.XSLT2`程序包为该处理器提供API。 `XML.XSLT2` API通过到`XSLT 2.0`网关的连接向`Saxon`发送请求。网关允许多个连接。这意味着,例如,可以将两个独立的 IRIS进程连接到网关,每个进程都有自己的一组编译样式表,同时发送转换请求。 使用Saxon处理器,编译的样式表和`isc:Evaluate`缓存是特定于连接的;必须管理自己的连接才能利用这两个特性。如果打开连接并创建编译样式表或计算填充`isc:Evaluate`缓存的转换,则在该连接上计算的所有其他转换都将访问编译样式表和`isc:Evaluate`缓存条目。如果打开新连接,其他连接(及其编译的样式表和缓存)将被忽略。 这两个处理器的API相似,不同之处在于`%XML.XSLT2`中的方法使用另一个参数来指定要使用的网关连接。 要执行`XSLT`转换,请执行以下操作: 1. 如果使用的是`Saxon`处理器,请按照下一节所述配置`XSLT`网关服务器。或使用默认配置。 如果使用的是`Xalan`处理器,则不需要网关。 系统会在需要时自动启动网关。或者也可以手动启动它。 2. 如果使用的是`Saxon`处理器,则可以选择创建`%Net.Remote.Gateway`的实例,表示到`XSLT`网关的单个连接。 请注意,当使用`Saxon`处理器时,要利用已编译的样式表和`isc:Evaluate`缓存,这一步是必需的。 3. 可以选择创建已编译的样式表并将其加载到内存中。请参阅本章后面的“创建编译样式表”。如果使用的是`Saxon`处理器,请确保在创建编译后的样式表时指定网关参数。 如果打算重复使用同一样式表,则此步骤非常有用。然而,此步骤也会消耗内存。当不再需要编译的样式表时,请务必将其删除。 4. 调用适用API的转换方法之一。如果使用的是`Saxon`处理器,则在调用`Transform`方法时可以选择指定网关参数。 5. 可以选择调用其他转换方法。如果使用的是`Saxon`处理器,则在调用`Transform`方法时可以选择指定网关参数;这使能够使用相同的连接计算另一个转换。此转换将访问与此连接相关联的所有编译样式表和`isc:Evaluate`缓存条目。如果打开新连接,其他连接(及其编译的样式表和缓存)将被忽略。 Studio还提供了一个向导,可以使用该向导测试XSLT转换;本章稍后将对此进行介绍。 # 配置、启动和停止XSLT 2.0网关 当使用`Saxon`处理器(执行`XSLT 2.0`转换)时, IRIS使用`XSLT 2.0`网关(后者使用Java)。要配置此网关,请执行以下操作: 1. 在管理门户中,选择 System Administration > Configuration > Connectivity > XSLT 2.0 Gateway Server. 2. 选择Go。 ![image](/sites/default/files/inline/images/1_49.png) 系统将显示XSLT网关服务器页面。 左侧区域显示配置详细信息,右侧区域显示最近的活动。 ![image](/sites/default/files/inline/images/2_29.png) 3. 在左侧区域中,可以选择指定以下设置: - Port Number -`XSLT 2.0`网关独占使用的TCP端口号。此端口号不得与服务器上的任何其他本地TCP端口冲突。 默认值为 IRIS SuperServer端口号加`3000`。如果此数字大于`65535`,则系统使用`54773`。 - Java Version - 使用的Java版本。 - Log File - 日志文件的路径名。如果忽略此设置,则不执行日志记录。如果指定了文件名但忽略了目录,则将日志文件写入系统管理器的目录。 - Java Home Directory -包含Java bin目录的目录路径。如果服务器上没有默认Java,或者如果想使用不同的Java,请指定此选项。 要查看默认Java,请在服务器上的Shell中执行以下命令: ``` java -version ``` - JVM Arguments - Java虚拟机要使用的任何其他参数。 此区域还显示`JAVA_HOME`环境变量的当前值。 请注意,在网关运行时,不能编辑这些值中的任何一个。 4. 如果已进行更改,请选择保存以保存更改。或选择重置以。 5. (可选)选择测试以测试更改。 在此页面上,还可以执行以下操作: - 启动网关。要执行此操作,请选择右侧区域中的Start。 请注意, IRIS会在需要时自动启动网关。不需要手动启动网关。 - 关闭网关。要执行此操作,请选择右侧区域中的Stop(停止)。 # 重用XSLT网关服务器连接(XSLT 2.0) 如果使用的是`Saxon`处理器,InterSystems IRIS将使用之前配置的`XSLT 2.0`网关。为了与此网关通信,InterSystems IRIS在内部创建一个`XSLT`网关连接(`%Net.Remote.Gateway`的实例)。默认情况下,系统创建一个连接,将其用于转换,然后丢弃该连接。打开新连接会产生开销,因此为多个转换维护一个连接可提供最佳性能。此外,必须维护自己的连接,以便利用已编译的样式表和`isc:Evaluate`缓存。 要重用XSLT网关连接,请执行以下操作: 1. 调用`%XML.XSLT2.Transformer`的`StartGateway()`方法: ``` set status=##class(%XML.XSLT2.Transformer).StartGateway(.gateway) ``` 此方法启动XSLT 2.0网关(如果它尚未运行),并返回`%Net.Remote.Gateway`的实例作为输出。请注意,该方法还返回状态。 在`%Net.Remote.Gateway`实例表示与网关的连接。 `StartGateway()`有一个可选的第二个参数`useSharedMemory`。如果此参数为真(缺省值),则与`localhost`或`127.0.0.1`的连接将使用共享内存(如果可能)。要强制连接仅使用`TCP/IP`,请将此参数设置为False。 2. 检查上一步返回的状态: ```java if $$$ISERR(status) { quit } ``` 3. 创建任何已编译的样式表。执行此操作时,请将网关参数指定为`%Net.Remote.GatewayInstance`的实例在步骤1中创建。 4. 根据需要调用`%XML.XSLT2.Transformer`的`Transform`方法(`TransformFile()`、`TransformFileWithCompiledXSL()`、`TransformStream()`和`TransformStreamWithCompiledXSL()`)。执行此操作时,请将网关参数指定为在步骤1中创建的`%Net.Remote.Gateway`的实例。 5. 如果不再需要给定的编译样式表,请在调用`%XML.XSLT2.CompiledStyleSheet`的`ReleaseFromServer()`方法: ```java Set status=##class(%XML.XSLT2.CompiledStyleSheet).ReleaseFromServer(compiledStyleSheet,,gateway) ``` 重要提示:当不再需要已编译的样式表时,请务必使用此方法。 6. 当不再需要XSLT网关连接时,调用`%XML.XSLT2.Transformer`的`StopGateway()`方法,并将网关连接作为参数传递: ```java set status=##class(%XML.XSLT2.Transformer).StopGateway(gateway) ``` 此方法丢弃连接并重置当前设备。它不会停止`XSLT 2.0`网关。 重要提示:当不再需要连接时,请务必使用此方法。 有关示例,请参见XSLT2中的`Example10()`方法。`Samples`命名空间中的`Examples`。 # 排除XSLT 2.0网关服务器连接故障 当XSLT 2.0网关打开时,InterSystems IRIS和网关服务器之间的连接可能会变得无效。例如,如果出现网络错误或在InterSystems IRIS连接到网关服务器后重新启动网关服务器,则连接可能无法正常关闭。因此,可能会遇到错误。 可以通过连续调用XSLT网关连接对象的`%LostConnectionCleanup()`方法和`%reconnect`方法,尝试将InterSystems IRIS重新连接到网关服务器。 如果希望在断开连接时自动重新连接到网关服务器,请将网关连接对象的`AttemptReconnect`属性设置为true。 # 创建编译的样式表 如果打算重复使用同一样式表,则可能需要编译该样式表以提高速度。请注意,此步骤会消耗内存。当不再需要编译的样式表时,请务必将其删除。 要创建编译的样式表,请执行以下操作: - 如果使用的是`Xalan`处理器(对于`XSLT 1.0`),请使用`%XML.XSLT.CompiledStyleSheet`的以下类方法之一: - `CreateFromFile()` - `CreateFromStream()` - 如果使用的是`Saxon`处理器(用于`XSLT 2.0`),请在使用`%XML.XSLT2.CompiledStyleSheet`的以下类方法之一: - `CreateFromFile()` - `CreateFromStream()` 另请注意,将需要创建一个XSLT网关连接;请参阅“重用XSLT网关服务器连接(`XSLT 2.0`)”。 对于所有这些方法,完整的参数列表按顺序如下: 1. source - 样式表。 对于`CreateFromFile()`,此参数是文件名。对于`CreateFromStream()`,此参数是一个流。 2. compiledStyleSheet - 编译后的样式表,作为输出参数返回。 这是样式表类(`%XML.XSLT.CompiledStyleSheet`或`%XL.XSLT2.CompiledStyleSheet`,视情况而定)的实例。 3. errorHandler - 编译样式表时使用的可选自定义错误处理程序。 对于这两个类中的方法,这是`%XML.XSLT.ErrorHandler`实例。 4. (仅适用于`%XML.XSLT2.CompiledStyleSheet`)网关-`%Net.Remote.Gateway`的实例 ``` //将tXSL设置为等于适当流的OREF Set tSC=##class(%XML.XSLT.CompiledStyleSheet).CreateFromStream(tXSL,.tCompiledStyleSheet) If $$$ISERR(tSC) Quit ```
文章
Qiao Peng · 十月 9, 2023

英国NHS 基于FHIR的数字健康实践案例和经验教训

英国国民医疗保健服务(NHS)简介 国民医疗保健服务(NHS)是英国的公共资助的医疗保健系统的总称,覆盖英格兰的、苏格兰和威尔士。它是世界上第二大单一付款人医疗保健系统,针对英国常住居民提供免费的、全面的卫生服务。这些卫生服务不仅是医疗服务,还包含社区护理服务、精神健康、临终关怀等。 NHS是最大的分级诊疗体系:先看全科医生或急诊,再由他们转诊到医院看专科医生、住院或者手术。它管理着9千万患者记录和6千5百万份病历;每天有100万的就诊、200万电子处方和75万电子转诊。 NHS有200万员工,是世界最大的、非军队的单一机构。一直被评为让英国人最自豪的英国机构,击败了皇室、武装部队和英国广播公司。 NHS面临的挑战和应对 作为政府买单的全国性医疗保健系统,提高治疗效果、提升效率、降低费用是NHS始终面临的挑战。 NHS广泛使用InterSystems的TrakCare作为电子病历系统以获得统一的、最新的患者视图;使用HealthShare作为医疗机构间健康信息共享和交换平台,合并和共享患者信息、治疗计划和临终愿望计划,让授权的医护人员查看患者完整、及时的护理记录小结;使用InterSystems IRIS医疗行业版支撑包括基于机器学习的辅助决策的创新应用,例如对阿尔茨海默氏症的早期发现与诊断。NHS还提供全国的电子处方服务 - 直接将电子处方发送到患者选择的药房,和电子转诊服务。 但NHS仍有很多纸质流程和众多的旧有系统,数字化程度和数据的互操作能力有限。例如NHS使用了21种不同的电子系统来记录患者的数据。这些系统之间不能很好地沟通,因此治疗患者的医生可能无法了解有效治疗患者所需的所有信息。约十分之一的就诊中,医院和全科医生无法获得患者之前的健康记录。“医院和全科医生通常没能在正确的时间、正确的地点获得正确患者的正确信息。这可能导致错误和事故,从而威胁患者的生命。“ 确保信息使用者在正确的时间、正确的地点获得正确患者的正确信息,是有效决策所需的关键要素。需要获取患者信息的不仅有医生和护士,还包括患者自己。这就是战略性的互操作,它不仅是技术问题,更是一个社会问题。 在COVID-19大流行前,NHS为了实现这些目标,制定了数字化(digitise)、连接(connect)、转型(transform)的数字化转型战略: 将服务数字化:让医疗护理服务提供者和患者在需要时可以安全地访问信息。它承诺到2024年将整个NHS数字化。 将它们连接起来以支持服务集成:连接的健康和护理系统意味着数据可以在 IT 系统、医疗护理提供者和机构之间无缝流动。由此产生的信息洞察有助于根据人群的需求定制服务,实现更有针对性的护理并减少不必要的干预。 通过这些基础实现服务转型:数字技术的真正价值不是来自于将现有实践数字化,而是来自于使用它来彻底改变服务。要设计健康和社会护理服务,以使遭受健康不平等的人受益并其尽可能具有包容性,将确保对健康结果产生最大的积极影响。例如NHS的综合护理计划服务(Coordinate My Care),是一项临床服务,将被动的护理服务转变为计划性护理,将急诊和意外入院转变为离家更近的选择性、计划性、成本更低的护理,将患者被动参加转变为患者主动参与。 COVID-19为NHS带来了新的挑战 - 数字化需求的全面提速。自全球 COVID-19 大流行和国家封锁措施以来,卫生和社会护理提供者都采用数字技术作为护理渠道:虚拟会诊、视频会诊、虚拟COVID-19病房。数字化也已扩展到为患者家中提供 iPad,使他们能够远程进行测试,从而降低暴露于COVID-19的风险并为NHS临床医生节省时间。NHS也计划在未来五年内将面对面门诊预约减少多达三分之一。 所有这一切都对系统的互操作能力和基于互操作能力上的服务创新提出了很高的要求,不仅是功能和法规上的,也是响应速度上的 - 在满足法规和标准的同时快速交付的需求。而FHIR恰逢其时地为NHS的这些需求和数字化转型战略赋能。 NHS的FHIR案例 在英国,INTEROPen是一个开放合作组织,致力于加速制定医疗保健和社会保健领域互操作性的开放标准,建立数字信息无缝流动的健康和护理社区。它由NHS、行业供应商、标准化组织和个人组成, InterSystems 是INTEROPen的创始成员和供应商联席主席。INTEROPen定义并推动采用基于 HL7 FHIR 的开放互操作性标准,它基于FHIR R4建立了英国第一个UK Core的国家级Profile和一系列FHIR实施指南(Implementation Guide),并每年举办四到六场黑客马拉松,使成员组织的开发人员能够测试标准和 API,然后再使用这些标准和 API 来连接基于真实临床场景的系统。 NHS正借助INTEROPen,努力简化不同的标准和流程,让服务创新者获得他们需要的东西,以符合各种技术和临床要求,确保关键信息在正确的时间到达正确的人。 NHS最新的努力都基于FHIR标准和UK Core,并定义了一组开放式 FHIR API,用于所有全科医生系统。基于 FHIR 的互操作性帮助NHS简化和自动化流程,释放宝贵的资源来专注于患者护理。 在FHIR基础上,NHS已经实现了这些服务: 患者服务: 让患者自己就可以查询个人记录、药嘱再配、预约、使用电子转诊服务等。患者可以选择何时何地看专家,实施以来,降低了一半的患者预约爽约风险。电子处方服务将处方数据安全快速地传给患者选择的药房,每年为NHS节省2亿3千万英镑。 患者也可以通过苹果手机的Apple Health应用,使用FHIR API安全、私密地大规模访问他们个人的NHS健康信息。 事件通知: FHIR 消息传递和 InterSystems 技术正在通过NHS网络推动临床事件通知。包括父母在内的用户可以订阅事件并接收每个患者的通知。事件管理系统接收 FHIR 消息、存储它们,并根据订阅偏好通知每个订阅者。事件类型包括疫苗接种、儿科发育里程碑或常规筛查检查等。 信息实时更新: NHS救护车出诊时,除了出诊原因,通常医生对患者的情况一无所知。通过FHIR API,NHS从全科医生系统收集患者信息并提供完整的html版本的小结,让医生在救护车到达前就了解患者的诊断、当前用药、过敏、就诊历史等信息,帮助医生确定更好的处置决定,并评估是否需要住院治疗。 药物管理: 住院时协调用药是困难和耗时的,加上转录用药和过敏信息可能发生的错误,这带来巨大的患者安全风险。 同时,传统的药物清单概念,无论是医生开出的药物清单、药房分配的药物清单,还是患者说他们目前服用的药物清单,它们看起来都一样。而FHIR 引入了一种新的药物管理架构,它的药物模块包括 9 种不同的 FHIR 资源——结构化数据的自描述单元以及对其他资源或数据源的引用。它们允许在不同系统之间进行更有意义和有用的药物信息交换。 使用FHIR药物模块,通过FHIR API,NHS从全科医生系统收集药物和过敏信息: 使用UK Core的 “药物可编码概念”或“药物资源” 传输药物信息 使用UK Core的FHIR剂量语法IG(FHIR Dose Syntax Implementation Guidance)将每剂量的药物量转换为简单的编码量 使用 SNOMED CT 和 NHS的dm+d 字典代码传输药物和过敏/不耐受信息 并及时、准确地将当前用药直接列入InterSystems TrakCare电子病历的患者当前用药列表。对于未编码的药物和过敏数据,InterSystems TrakCare这些信息作为自由文本存储在患者记录中,并允许临床医生将其修正为结构化和编码数据输入 TrakCare。开药时,TrakCare 可视化规则会在有非结构化过敏记录时提醒开药者。 通过这些基于FHIR的药物管理,NHS帮助医生更好、更快地协调住院用药,降低用药错误(这是最常见的医疗错误类型)带来的患者安全风险。 护理平稳过渡: 当患者从医院到护理中心再回到家中继续康复或照料,从一个医生转到另一个医生时,不完整的信息导致治疗连续性不佳、患者安全风险、效率不足、不必要的患者再入院和患者教育失败。NHS颁布了基于FHIR的治疗文档传递标准,它是一个结构化的、编码的文档。当患者从医院、急诊科、门诊预约或择期手术出院时,它由急症医院提供,通过FHIR API发送给全科医生。全科医生直接在患者记录中就可以查看到这些患者信息,无需打开另外的文档查找和阅读,这种及时的信息共享有助于实现不间断的患者护理。 另外,NHS还将FHIR应用在术前评估、知情同意、管理高危慢阻肺等业务场景中。 NHS的经验和教训 NHS在借助FHIR推动战略互操作时给我们带来的经验和教训: 战略互操作不仅是技术问题,更是社会问题 借这个机会转变临床和护理流程、服务 合作 它需要借助合作产生的标准实现,要所有利益相关方一起参与 – 需求方拉动、提供方推动 确保参与方都充分理解需求和标准,并理解标准需要不断进化 临床模型 (需求)-> FHIR Profiles (设计) -> 实施指南 (实施)-> API(实施) 组织测试,用来检验标准 务实 关注在交付有用的事情上 – 它要足够好,但不需要完美,不要过分工程化 尽快试错 很多国家在采纳FHIR,但这个过程会比我们想象的长 不要过分扩展FHIR,先从最小规模的扩展开始
文章
Claire Zheng · 二月 1, 2021

如何在开发者社区上发布同类最佳的问题?

Hi, 大家好! 我们在开发者社区上发布问题的目的是获得答案。 以下是一个非常简单的准则文档,介绍如何提出问题会获得回答。 当您发布问题时,您需要填写 3 个字段:标题、正文和组。 以及标签。 1. 标题 一个好的标题应该包含问题的简短描述,长度不应超过 80-90 个符号。 但是简短并不表示只有一个词。 以下这些就不是很好的问题标题:Cache、Ensemble、Peace、World。 好问题示例: 使用 SQL 查询列表属性 使用 Record Mapper 时如何忽略 CSV 文件上的Headers 在 Cache´SQL 中使用 $CASE 或 $SELECT 功能 标题中的字母应该大写吗? 按照 英语 的规则——是的!这肯定会提高问题的感知度。 2. 正文 正文应该包含英语或/和 Caché Objecsript、SQL、JS 或其他语言的问题描述。 使用 代码块 突出显示 Caché ObjectScript。 提供产品版本总是有帮助的(在终端中输入 $zversion)。 正文中应该只有一个问题。 如果有两个问题,请发布两个不同的问题。 3. 组 组是必选标签,有助于将您的问题归类到一个 InterSystems 产品(Caché、Ensemble、HealthShare)、技术(DeepSee、iKnow)或服务(在线学习、WRC)。 4. 标签 使用标签可邀请(订阅了不同标签的)专家关注您的问题。 在这里,您可以选择关于开发、测试、变更管理、部署和环境的不同标签。 好问题通常很快就会得到回答。 您可以通过“回答”计数器上的绿色前景注意到已回答的问题。 一定要 将回答标记为已接受(将问题标记为已解决) ,当然前提是回答适合您。 当然,这不是如何提出好问题的完整建议列表。 请在本帖中发表您的意见和想法。
文章
姚 鑫 · 六月 6, 2021

Caché 网络实用工具

# Caché 网络实用工具 # [第一章 发送HTTP请求☆☆☆☆☆](https://yaoxin.blog.csdn.net/article/details/117108190) # [第二章 设置和获取HTTP标头☆☆☆☆☆](https://yaoxin.blog.csdn.net/article/details/117148255) # [第三章 发送HTTP请求☆☆☆☆☆](https://yaoxin.blog.csdn.net/article/details/117195938) # [第四章 收发电子邮件☆](https://yaoxin.blog.csdn.net/article/details/117214514) # [第五章 向邮件添加附件☆](https://yaoxin.blog.csdn.net/article/details/117248548) # [第六章 从POP3服务器提取电子邮件☆](https://yaoxin.blog.csdn.net/article/details/117278414) # [第七章 从POP3服务器提取电子邮件☆](https://yaoxin.blog.csdn.net/article/details/117320147) # [第八章 处理收到的电子邮件☆](https://yaoxin.blog.csdn.net/article/details/117350781) # [第九章 创建、编写和阅读MIME邮件☆](https://yaoxin.blog.csdn.net/article/details/117378600) # [第十章 使用FTP☆☆☆☆☆](https://yaoxin.blog.csdn.net/article/details/117394438) # [第十一章 发送和接收IBM WebSphere MQ消息☆](https://yaoxin.blog.csdn.net/article/details/117409322) # [第十二章 IBM WebSphere MQ检索邮件☆](https://yaoxin.blog.csdn.net/article/details/117435132) # [第十三章 使用SSH☆](https://yaoxin.blog.csdn.net/article/details/117459391) # [第十四章 其他InterSystems %Net工具☆☆☆](https://yaoxin.blog.csdn.net/article/details/117508484) # [第十五章 Caché WebSocket☆☆☆](https://yaoxin.blog.csdn.net/article/details/117548341) # 前言 手册帮助程序员使用%Net包中的一些关键类,这些类为许多有用的Internet协议提供了易于使用的接口。因为这个包的类文档相当广泛,所以本手册提供了一个快速、有条理的概述,而不是深入研究每个参数、属性和方法。熟悉本手册中提到的协议和第三方工具。 # 预告 下一期系列将用一个月的时间连载,**《Caché XML》**,敬请期待。 # 交流群 - QQ群号:410039091 - 笔者QQ:454115408 - 公众号:技术理科直男 - [intersys版主:姚鑫](https://cn.community.intersystems.com/user/236891/posts) ![\[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-f9VqwzNP-1608850948003)(3E1D939266954ED48BDAEA9B8086B11E)\]](https://img-blog.csdnimg.cn/20201225070433434.png) # 大型免费课程,进群410039091获取课程目录 - 适合所有阶段程序员,总有一款你遗漏的知识点! ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210606224558577.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3lhb3hpbjUyMTEyMw==,size_16,color_FFFFFF,t_70#pic_center)
公告
jieliang liu · 三月 3, 2022

2022年2月,开发者社区新闻!

欢迎来到2月22日的社区新闻发布! 我们很高兴为InterSystems的开发者介绍我们全新的社区活动日历: 🎯 https://community.intersystems.com/events 在这个日历中,你将看到特区活动的历史。了解现在或即将发生的活动,查看过去的活动,并观看社区的网络研讨会和聚会的录音。 让我们仔细看看如何使用它。 要进入DC日历,请点击 "活动 "顶部菜单,进入 "活动日历 “部分: 在这个日历中,你会发现现有的和过去的活动,这些活动可以被分为不同的类别: 所有活动 网络研讨会 开发者聚会 比赛 通过点击 "预览模式 "中的事件,你将看到它的公告: 随意使用 "列表模式",它显示事件预告,并有一个选项可以将任何可用的事件添加到你的日历中: 你也可以在右边的小日历中选择任何日期,了解当天有什么活动安排或发生: 此外,你可以通过点击 "新事件 "按钮创建你自己的事件。你将被自动转到事件创建页面。 ❗️ 将 "Event"标签添加到帖子中,将打开用于创建活动的特殊字段。 当你在字段中填写了活动名称、注册链接和时间后,你的活动将自动在主页面的 "活动 "块中突出显示。 此外,在你的活动公告中,你会看到:–‎ 带有注册链接的特殊块– 用于快速添加事件到你的日历的按钮 欢迎添加更多关于你的活动的细节,添加简短的描述/直接链接加入/位置。 希望你喜欢我们的更新! 您可以将改进要求和错误报告提交到 DC GitHub. 或者在本帖的评论中发表你的建议。 请继续关注我们的新消息!
文章
Vivi Zhu · 五月 29, 2022

招聘:北京协和医院信息中心招聘运维工程师、Caché数据库管理员和开发工程师

北京协和医院现公开招聘信息类技术岗位。有关事项公告如下:岗位1:运维工程师任职要求:1.年龄30岁以下,本科及以上学历,计算机相关专业;2.熟悉计算机软硬件技术,熟练排除各种软硬件的故障;有基本的网络知识,了解DNS、DHCP原理,熟练使用Ping、tracert等简单命令;3.有2年以上桌面运维工作经验者优先。 岗位2:数据库管理员任职要求:1. 本科及以上学历,计算机相关专业;2. 精通InterSystems Caché数据库,精通MySQL,SQL Server,熟悉Oracle,精通SQL脚本编写;有丰富数据库管理、运维调优经验;3. 5年以上数据库运维管理经验;4. 有医疗行业经验优先。 岗位3:开发工程师任职要求:1. 本科及以上学历,计算机及相关专业,有2年及以上JAVA WEB软件实际开发工作经验,有JVM调优经验者优先;2. 熟悉SSM和SSH框架;有SpringBoot或者SpringCloud实际开发经验;3. 熟悉html5,css,js 等前端开发技术;对jquery、vue等相关技术熟悉;熟悉websocket等相关技术;4. 熟练使用MySQL,SQL Server,熟悉Oracle,有一定的SQL优化经验;5. 熟练使用各种集成开发环境,Eclipse,Idea,SVN,GIT等,熟悉Linux操作系统。 招聘程序(一)个人应聘2022年6月27日24点前登录北京协和医院官网(学术版)招聘栏注册申请。(二)组织面试在资格审查的基础上按1:3的比例确定面试人选,根据综合成绩确定拟录人选。(三)体检考察对拟录人选进行体检和考察。(四)签订协议体检及考察合格人员签订协议。 官方招聘链接为 https://jobs.pumch.cn/JobManage/WebShowJobDetail.aspx?JobId=bf9dcde8-a3de-4fab-805e-f2582255056d
文章
Michael Lei · 六月 14, 2023

使用LangChain 修复 SQL

本文是 SqlDatabaseChain 的简单快速入门(我所做的)。 希望大家会感兴趣。 非常感谢: sqlalchemy-iris 作者@Dmitry Maslennikov 您的项目使我的试验变得可能。 文章脚本使用 openai API,因此请注意不要在外部共享您不打算共享的表信息和记录。 如果需要,可以插入本地模型。 创建一个新的虚拟环境 mkdir chainsql cd chainsql python -m venv . scripts\activate pip install langchain pip install wget # Need to connect to IRIS so installing a fresh python driver python -c "import wget;url='https://raw.githubusercontent.com/intersystems-community/iris-driver-distribution/main/DB-API/intersystems_irispython-3.2.0-py3-none-any.whl';wget.download(url)" # And for more magic pip install sqlalchemy-iris pip install openai set OPENAI_API_KEY=[ Your OpenAI Key ] python 初始测试 from langchain import OpenAI, SQLDatabase, SQLDatabaseChain db = SQLDatabase.from_uri("iris://superuser:******@localhost:51775/USER") llm = OpenAI(temperature=0, verbose=True) db_chain = SQLDatabaseChain.from_llm(llm, db, verbose=True) db_chain.run("How many Tables are there") 错误结果 sqlalchemy.exc.DatabaseError: (intersystems_iris.dbapi._DBAPI.DatabaseError) [SQLCODE: <-25>:<Input encountered after end of query>] [Location: <Prepare>] [%msg: < Input (;) encountered after end of query^SELECT COUNT ( * ) FROM information_schema . tables WHERE table_schema = :%qpar(1) ;>] [SQL: SELECT COUNT(*) FROM information_schema.tables WHERE table_schema = 'public';] (Background on this error at: https://sqlalche.me/e/20/4xp6) ←[32;1m←[1;3mSELECT COUNT(*) FROM information_schema.tables WHERE table_schema = 'public';←[0m>>> 开发者之间的对话 IRIS 不喜欢以分号结尾的 SQL 查询。 现在做什么? ? 想法:我告诉 LangChain 帮我修理SQL如何 太酷了,我们开工吧 !! 测试二 from langchain import OpenAI, SQLDatabase, SQLDatabaseChain from langchain.prompts.prompt import PromptTemplate _DEFAULT_TEMPLATE = """Given an input question, first create a syntactically correct {dialect} query to run, then look at the results of the query and return the answer. Use the following format: Question: "Question here" SQLQuery: "SQL Query to run" SQLResult: "Result of the SQLQuery" Answer: "Final answer here" The SQL query should NOT end with semi-colon Question: {input}""" PROMPT = PromptTemplate( input_variables=["input", "dialect"], template=_DEFAULT_TEMPLATE ) db = SQLDatabase.from_uri("iris://superuser:******@localhost:51775/USER") llm = OpenAI(temperature=0, verbose=True) llm = OpenAI(temperature=0, verbose=True) db_chain = SQLDatabaseChain(llm=llm, database=db, prompt=PROMPT, verbose=True) db_chain.run("How many Tables are there") 结果二 SQLQuery:←[32;1m←[1;3mSELECT COUNT(*) FROM information_schema.tables←[0m SQLResult: ←[33;1m←[1;3m[(499,)]←[0m Answer:←[32;1m←[1;3mThere are 499 tables.←[0m ←[1m> Finished chain.←[0m 'There are 499 tables.' 我就说很快吧 参考资料: https://walkingtree.tech/natural-language-to-query-your-sql-database-using-langchain-powered-by-llms/ https://python.langchain.com/en/latest/modules/chains/examples/sqlite.html#sqldatabasesequentialchain https://python.langchain.com/en/latest/modules/agents/plan_and_execute.html
公告
Claire Zheng · 四月 23

Global Masters 项目自2024年4月26日起暂停服务

InterSystems,我们致力于为您提供最优质的服务,包括我们的Global Master项目。 Global Master项目平台的供应商已经被另一家公司收购,不幸的是,我们无法继续在这个平台上托管我们Global Master项目。我们目前正在评估新的平台供应商,以推动Global Masters Advocate Hub的平稳过渡。 自2024年4月26日起,我们将暂停Global Master项目,以期平稳过度到新平台上。 FAQ: 您的积分、徽章和等级 我们将保存所有截至2024年4月26日的积分、徽章和成就,并将把所有数据迁移到新平台。 您在整个开发者生态中的贡献 在迁移过程中,我们仍然会自动计算对开发者生态系统的所有贡献(帖子、评论、应用程序等)。这些应得的积分和徽章将在新项目启动时添加到您的个人资料中。 奖励 为了提供在迁移过程中兑换奖品的机会,我们计划尽快建立一个专门的奖品网页。但是,我们鼓励您在2024年4月26日之前兑换您计划兑换的奖品(4月26日奖品兑换将停止服务),因为此功能将在一段时间内不可用。 接下来如何? 有关升级的所有信息将在 Discord 和开发者社区相关频道中发布。对于给您带来的不便,我们深表歉意,并将努力尽快完成迁移。 仍有疑问?请联系Global Master支持团队 欢迎通过开发者社区联系 Olga @Olga.Zavrazhnova2637 ,或通过Discord 提问。让我们保持沟通! 我们将尽快同步新平台上线日期! 期待在新平台上与您相见!祝好,Global Masters and Developer Community team
文章
姚 鑫 · 八月 14, 2021

属性关键字InitialExpression,Internal,Inverse,MultiDimensional

# 第101章 属性关键字 - InitialExpression 指定此属性的初始值。 # 用法 要指定此属性的初始值,请使用以下语法: ```java Property name As classname [ InitialExpression = initialexpression ]; ``` 其中,`initialexpression`是用大括号括起来的常量或ObjectScript表达式。 # 详解 此关键字指定属性的初始值。该值是在创建新实例时由类的`%New()`方法分配的。(如果属性是瞬态的的,则其初始值由创建实例时`%New()`调用的代码或实例从磁盘加载到内存时`%OpenId()`调用的代码确定。) 初始表达式的值必须适合给定的属性类型。 表达式可以是任意复杂的,有以下限制: - 初始表达式不能引用其他属性。也就是说,诸如{`..therPropertyname`}这样的表达式无效。 - 初始表达式不能实例化对象,也不能包括对象引用。 - 初始表达式不能调用实例方法(只能调用类方法)。 - 必须在ObjectScript中指定初始表达式。 - 表达式执行的代码不应报告错误。InterSystems IRIS不提供处理表达式返回的错误的方法。 - 如果表达式执行的代码导致发生其他处理,则InterSystems IRIS不提供处理该处理结果的方法。 子类继承`InitialExpression`关键字的值并可以重写它。 # 默认 `InitialExpression`关键字的默认值为`NULL`。 # 示例 下面显示了几个使用ObjectScript表达式的示例: ```java Property DateTime As %Date [ InitialExpression = {$zdateh("1966-10-28",3)} ]; Property MyString As %String [ InitialExpression = {$char(0)} ]; /// 此参数使用参数值进行初始化 Property MyProp As %String [ InitialExpression = {..#MYPARM} ]; /// 这是由一个类方法初始化的 Property MyProp2 As %Numeric [ InitialExpression = {..Initialize()} ]; ``` # 第102章 属性关键字 - Internal 指定此属性定义是否为内部定义(不显示在类文档中)。 # 用法 要指定此属性为内部属性,请使用以下语法: ```java Property propertyname As classname [ Internal ]; ``` 否则,请省略此关键字或将该词放在该关键字之前。 # 详解 类文档中不显示内部类成员。如果希望用户看到某个类,但不能看到其所有成员,则此关键字非常有用。 # 默认 如果省略此关键字,则此属性将显示在类文档中。 # 第103章 属性关键字 - Inverse 指定此关系的反面。关系属性需要。不用于其他属性。 # 用法 要在相关类中指定与该关系属性相反的关系属性,请使用以下语法: ```java Relationship Chapters As Chapter [ Cardinality = cardinality; Inverse = inverse ]; ``` 其中,`Inverse`是相关类中属性的名称。 # 详解 此关键字指定关系的反向方的名称,即相关类中对应关系属性的名称。反向属性必须存在于相关类中,并且具有正确的基数值。 关系属性需要`Inverse`关键字。非关系属性会忽略它。 # 默认 没有默认值。定义关系时,必须指定逆序关键字。 # 示例 ```java Relationship Chapters As Chapter [ Cardinality = many; inverse = Book ]; ``` # 第104章 属性关键字 - MultiDimensional 指定此属性具有多维数组的特征。 # 用法 要指定此属性具有多维数组的特征,请使用以下语法: ```java Property Data [ Multidimensional ]; ``` 否则,省略此关键字或将单词Not放在关键字的前面。 # 详解 多维属性不同于其他属性,如下所示: - IRIS不为其提供属性方法。 - 当对象被验证或保存时,它被忽略。 - 它不会保存到磁盘,除非应用程序包含专门保存它的代码。也就是说,属性也是自动瞬态的。 - 它不能暴露给Java或其他客户端。 - 它不能存储在或通过SQL表公开。 多维属性很少见,但它提供了一种有用的方法来临时包含关于对象状态的信息。 # 默认 如果省略此关键字,则属性不是多维的。