第四章 使用管理门户（四）

管理门户页面参考

管理门户由多个页面组成，分为以下功能区域：

• 主页Home — 管理门户主页
• 健康Health — 医疗保健页面。仅适用于 IRIS for Health™ 和 HealthShare® Health Connect。
• 分析Analytics — IRIS® 商业智能页面
• 互操作性Interoperability — 产品页面
• 系统操作 — 系统操作页面
• 系统资源管理器 — 数据库管理页面
• 系统管理 — 系统管理页面

Home

主页包含许多用于导航管理门户的选项。

Health

IRIS for Health 和 Health Connect 中的医疗保健特定功能显示在管理门户的 Health 部分的可用页面上。在访问这些健康页面之前，需要安装 Foundation 命名空间。

Analytics

商业智能页面分为管理门户的分析部分中显示的类别。

Interoperability

产品页面分为管理门户的互操作性部分中显示的类别。

System Operations

系统操作员页面分为管理门户的系统操作部分中显示的类别。下表显示了每个类别和相关的文档来源。

第三章 使用管理门户（三）

浏览管理门户

管理门户有两种不同的视图模式可供选择以进行页面导航。可以通过单击管理门户功能区中所需的查看按钮随时在查看模式之间切换。视图模式有：

• 分栏视图 Columns view ——分栏显示页面；这是默认模式。此查看模式允许选择收藏夹并分配自定义资源。
• 列表视图 List view — 在下拉列表中显示页面名称。

注意：除了使用视图导航管理门户外，还可以通过位于功能区中的搜索工具直接进入页面；有关详细信息，请参阅本章中的管理门户功能区部分。

Columns view

“列视图”显示用于到达目标页面的子菜单。如果单击最终子菜单中的标题/名称，则会显示目标页面；如果在框内单击而不是在标题/名称本身上单击，则操作窗格将显示在右侧。

操作窗格

操作窗格解释了一个菜单选项，并允许执行与其相关的多项操作。要在“列”视图中显示操作窗格，请在最终子菜单中的选项周围的框内单击，而不是在选项本身上单击。可以在操作窗格中执行以下操作：

• 将目标页面添加到主页上的收藏夹列表中，如管理门户欢迎窗格中所述。
• 查看加载页面和分配自定义资源所需的系统资源，如在管理门户中使用自定义资源中所述。

注意：如果资源的名称在操作窗格中被截断，请将指针移到名称上以查看其全部内容。

• 单击 Go 转到目标页面。

操作窗格仅在“列”视图中可用。

第11讲 Git IDEA VS GitHub
第12讲 Git Gitee 简介使用
第13讲 Git Android Stuido VS Gitee

会议 ID：818 298 9668
8-29晚 21：00-22：00 点
创造价值，分享学习，一起成长，相伴前行

还有Cache学习系列

跟版主学caché——大型史诗级免费技术培训caché百讲

第二章 使用管理门户（二）

管理门户概述

本节介绍管理门户页面的一些常见布局元素。

注意：在管理门户中的任何位置，将光标移到菜单项上都会显示该项目的描述。

管理门户主页

管理门户主页的标题是 Welcome, 。在标题旁边，功能区包含以下选项：

• 两个视图按钮，可让指定如何在菜单列中显示链接。
• 搜索栏，位于功能区的右侧。当指定一个词并按 Enter 键时，将显示包含该词的所有页面的列表；然后，可以单击要显示的目标页面，而无需浏览子菜单。

以下部分描述了主页的区域：

管理门户菜单栏

位于主页左边缘的菜单栏是导航门户的主要方法。

管理门户欢迎窗格

欢迎窗格位于主页的中心，包括经常访问的页面的快捷方式。它包含以下字段：

• 收藏夹Favorites — 列出选择为收藏夹的管理门户页面（请参阅操作窗格）；可以单击每个页面标题直接转到该页面。
• 最近Recent — 列出自上次启动 IRIS 以来最近显示的页面。
• Did you know? — 显示提示。
• 链接 Links - 指向可能想要访问的页面的链接。

管理门户消息窗格

位于主页右侧边缘的消息窗格显示一般系统信息并提供指向系统仪表板的链接。

如果实例是镜像成员，则消息窗格还显示它所属的镜像、其状态和成员类型以及指向镜像监视器的链接。

管理门户标题

页眉位于管理门户中每个页面的顶部，可用于快速导航门户。

标题包含以下链接：

• 主页Home — 显示管理门户主页。

测试环境为正式环境备份恢复，现在在测试环境尝试搭建mirror，重启了一下数据库，结果全部变为只读了，该怎么解决数据库的只读挂载呢？

[TOC]

第一章 使用管理门户（一）

IRIS数据平台使您能够通过 Web 应用程序Management Portal 执行系统管理和管理任务。这种方法的一个优点是 IRIS 不必安装在用来管理安装的系统上。现在，通过网络远程管理系统，受制于为站点建立的访问控制，变得更加容易。跨版本兼容性问题被最小化，因为数据及其格式信息都直接来自被管理的系统。

默认情况下，管理门户在安装了IRIS 的专用 Web 服务器上运行。可以选择禁用专用 Web 服务器（使用 WebServer 设置）并配置不同的 Web 服务器来运行管理门户。

启动管理门户

可以通过以下方式启动管理门户：

• 在 Microsoft Windows 平台上，单击 IRIS 启动器菜单上的管理门户（Management Portal）。
• 在Web 浏览器中，直接转到管理门户 URI，格式如下：

http://machine:port/csp/sys/UtilHome.csp

其中 machine 是系统的 IP 地址（例如 localhost），port 是 IRIS 安装的 Web 服务器(web service server)的端口号。例如，单个安装 IRIS 在本地服务器上的默认位置是 http://localhost:52773/csp/sys/UtilHome.

第二十六章 源代码文件 REST API 参考（八）

GetEnsClassType

此方法返回用于创建产品的类的名称列表。可以指定要获取的类的类型，例如业务服务类。

URL

GET http://server:port/api/atelier/v1/namespace/ens/classes/type

type 是一个整数，并返回对应于该整数的类，如下所示：

• Adapters 1

• InboundAdapters 2

• OutboundAdapters 3

• Messages 4

• Requests 5

• Responses 6

• BusinessServices 7

• BusinessProcesses 8

• BusinessOperations 9

• DataTransformation 10

• Production 11

• BusinessHost 12

• Dashboard 13

• Rule 14

JSON Messages

以下返回的内容是一个类名数组：

{
  status: {
    errors: []
    summary: ""
  }
  console: []
  result: {
    content: [
        "Ens.Enterprise.MsgBank.BankTCPAdapter",
        "Ens.

嗨，开发者们。

不要错过这个由InterSystems Healthcare副总裁@Donald.Woodlock主持的动手实践环节:

⏯ Machine Learning 201 - Neural Networks and Image Recognition

第二十五章 源代码文件 REST API 参考（七）

Query

此方法对 IRIS 表执行 SQL 查询并返回结果。请求正文是指定查询的 JSON 对象。它返回一个匹配查询条件的对象数组。每个返回的对象都包含与查询返回的一行相关的信息。

URL

POST http://server:port/api/atelier/v1/namespace/action/query

SQL 查询在 URL 请求的正文中指定。查询必须在指定的命名空间中指定一个数据库。

此调用需要标头 Content-Type application/json。

JSON Messages

返回内容是一个对象数组。

第二十四章 源代码文件 REST API 参考（六）

Compile

此方法编译源代码文件。它允许一次编译多个源代码文件。它返回一个对应源代码文件对象的数组。

要编译的文件列表作为 JSON 数组在 http 请求的正文中传递。例如，[ "%Api.DocDB.cls", ... ]。

有关示例和其他详细信息，请参阅本手册教程章节中的编译文件。

URL

POST http://server:port/api/atelier/v1/namespace/action/compile

此调用需要标头 Content-Type application/json。

URL Parameters

• 可以传递 URL 参数“flags”（默认为“cuk”），该参数将传递给编译器。

• 如果不希望返回已编译的源代码文件的源，则可以使用值 0 传递 URL 参数 'source'。

JSON Messages

以下是编译 Atelier.NewClass1 时返回的内容：

嗨社区，

这篇文章公开介绍我的 iris-fhir-client 客户端应用。

 iris-fhir-client 可以可以借助嵌入式 python 连接到任何开放的 FHIR 服务器 fhirpy 图书馆.

通过终端和使用 CSP Web 应用程序获取资源信息。

Hi 社区，

本文将演示如何使用 iris-fhir-client 客户端应用程序创建患者和患者观察资源。

建议在开始阅读本文之前可以先读一下我的  第一篇  关于这个应用程序的文章和观看 Youtube 视频。

让我们开始吧：

Hi 社区成员们，

我们很高兴地宣告 社区网络研讨会 回归了！

我们诚邀您参加 @sween 主讲的 使用ECP在AWS上扩展InterSystems FHIR Server 网络研讨会。

Join this webinar to make a technical deep dive, see a demonstration, and benchmark horizontal scaling InterSystems FHIR Server on Amazon Web Services with Enterprise Cache Protocol (ECP). 欢迎加入此次网络研讨会，深入了解技术，观看演示，并在AWS上使用企业缓存协议（ECP）基准测试水平扩展InterSystems FHIR Server。

⏱ 时间： 8月18日（周四）8am (美国东部时间） | 2:00pm (中欧夏季时间）| 8:00pm （北京时间）
👨‍🏫 主讲人: @sween, 全栈架构师，来自Integration Required

我们中的许多人在几年前安装了Ensemble，估计空间是足够的，但现在却遇到了意外--硬盘已经满了！我们可以看看我们可以采取哪些措施来调查发生了什么，然后如何减少所占用的空间。 让我们来看看我们可以采取哪些措施来调查发生了什么，然后如何减少占用的空间。

是什么占用了Ensemble的空间？
让我们来看看在Ensemble中占用空间的东西的清单。

1. Ensemble安装。
2. 备份文件
3. 日志文件
4. Ensemble数据库。
5. 流文件。
6. 自定义应用程序文件

让我们逐一来看看这些文件。

Ensemble安装占用的空间

这是一个相对较小的空间，取决于版本，大约为1GB。如果你想减少它，你有可能删除一些开发包或第三方连接驱动ODBC/JDBC。你可以通过改变安装选项来做到这一点，见Ensemble安装手册。

http://docs.intersystems.com/latest/csp/docbook/DocBook.UI.Page.cls?KEY…

备份文件占用的空间

那么你的磁盘空间被备份文件占用了？如果是这样的话，就应该想想你的系统是否设置得好。备份文件应该放在与Ensemble数据库不同的物理磁盘上，因为如果Ensemble磁盘发生故障，你想从没有发生故障的不同磁盘上恢复它。

第二十三章 源代码文件 REST API 参考（五）

DeleteDoc

此方法删除指定命名空间中的命名源代码文件。它返回相应的源代码文件对象。

与源代码文件有关的错误将在源代码文件对象的状态属性中。

有关示例和其他详细信息，请参阅本手册教程章节中的删除文件。

URL

DELETE http://server:port/api/atelier/v1/namespace/doc/doc-name

注意：如果要删除 CSP 文件 ，则 doc-name 的值包括 /（斜杠）字符。这就是定义 DeleteDoc 的 URLMap 包含此参数名称的 (.*) 而不是 :docname 的原因。有关详细信息，请参阅创建 REST 服务中的“为 REST 创建 URL 映射”。

JSON Messages

以下是源代码文件 xyz.mac 的 DELETE 的返回内容：

{
  "status": {
    "errors": [],
    "summary": ""
  },
  "console": [],
  "result": {
    "name": "xyz.

hello 各位老师好：

          电子病历闭环埋点接口是单独接口，由平台提供接口文档，接口方式为Webservice，不能走在平台标准服务里吗?

导入了一个global(.gof文件)，如何利用导入的数据生成dashboard，求指导。

创建只读账号，分配资源新建角色，资源限制只读，但新建的用户还是可以修改。。。

分配的是所有以%DB和%service开始的资源，但部分是Use的权限，搞不明白。。。

我该怎么创建一个sql 的只读账号呢？

Production是开发者基于InterSystems IRIS产品家族实现互操作功能的主要技术架构。而每个Production的运行依赖于三类主要的业务组件：

• 业务服务(Business Service)
• 业务流程(Business Process)
• 业务操作(Business Operation)

三类组件间以消息作为信息交换的主要媒介。因此，要保障互操作业务的稳定运行，除保障软件平台有充足的软硬件资源运行外，保障Production中消息的高效传输以及三类组件的平稳、高效运行则是运维团队面临的主要目标。下面列举的若干项任务则有助于运维团队实现这些目标：

优化业务组件运行效率

Production中的业务组件都有运行池的概念，允许业务组件运行在多个进程上并发工作以提高整体性能。运行池又可以分为私有池和参与者池两类。

InterSystems 数据平台的互操作功能与久经考验的Ensemble和HealthConnect集成引擎产品一脉相承。事实上，使用IRIS的典型客户不但应用了IRIS提供的多模型数据存储、分布式存储等数据存储特性，也广泛地应用如可视化数据转换，可视化数据流程编辑和可视化规则引擎等一系列互操作能力构建异构系统间或组织机构间的数据流程。

那么，在生产环境上，如何监控与评估数据流程的运行状况，在发生问题时如何快速定位并解决故障，就是用户的运维团队需要考虑的问题。

本系列文章将围绕IRIS互操作功能中核心的互操作消息管理，Production管理与优化及互操作告警与通知三个方面介绍互操作功能的运维基础知识和常用技巧，希望能够帮助客户平稳、高效地运用数据平台。

注：本文提到的InterSystems数据平台，包括Caché数据库、Ensemble集成平台、HealthConnect医疗版集成平台和InterSystems IRIS数据平台。

互操作消息管理

消息是互操作功能中各组件间通信的基本方法，在互操作Production业务服务、业务流程和业务操作之间广泛使用。

除承担信息传递的基本功能外，由于常常需要在生产环境中查看消息内容或重发消息以解决问题，消息检索就是大家最常用到的功能，而IRIS特有的结构化消息存储也为开发和运维团队使用和管理消息创造了便利。

第二十二章 源代码文件 REST API 参考（四）

PutDoc

此方法保存提供的源代码文件。如果文件不存在，此方法将创建它，如果文件存在，此方法将现有文件替换为指定的文件。为确保覆盖文件的正确版本，请指定 If-None-Match 标头以及先前 PutDoc 或 GetDoc 的 ETAG 标头中返回的时间戳值。如果要覆盖文件而不检查版本，请指定 ?ignoreConflict=1 URL 参数。该方法返回一个对应的源代码文件对象。如果要保存二进制文件，请将传入 JSON 消息的 enc 元素设置为 true，并将文件内容包含为 base64 块数组。如果在保存过程中更改了服务器上的文本（例如通过源代码管理挂钩），则更新后的文本将在返回的源代码文件的内容数组中返回。

与源代码文件有关的错误将在返回的源代码文件对象的状态属性中。

版本 2 PutDoc 能够接受三种格式的文件内容：默认 UDL 格式、XML 格式和旧 %RO 导出实用程序使用的格式。 PutDoc 自动识别文件内容的格式。

有关示例和其他详细信息，请参阅本手册教程章节中的在命名空间中创建新文件或更新现有文件。

在这篇文章中，你可以访问InterSystems开发者社区中与学习InterSystems IRIS最相关主题的文章库。找到按机器学习、嵌入式Python、JSON、API和REST应用、管理和配置InterSystems环境、Docker和云、VSCode、SQL、分析/BI、全局、安全、DevOps、互操作性、Native API排列的顶级发表的文章。快来享受学习的乐趣吧!

机器学习

机器学习是建立先进的数据分析和自动化人工活动的一种必要的技术，具有很好的效率。它可以创建认知模型，从现有的数据中学习，并根据其自我调整的算法进行预测、概率计算、分类、识别和 "非创造性 "的人类活动的自动化。

在所有情况下，InterSystems IRIS作为一个数据平台和环境来创建、执行、提供和使用这些机器学习模型。IRIS能够从SQL命令（IntegratedML）中使用ML，使用嵌入式Python和PMML（预测模型标记语言）来执行ML。你可以在以下文章中查看它的功能:

下面是一个ObjectScript片段，它允许为InterSystems IRIS创建数据库、命名空间和Web应用程序:

	set currentNS = $namespace
	
	zn "%SYS"
	
	write "Create DB ...",!
	set dbName="testDB"
 	set dbProperties("Directory") = "/InterSystems/IRIS/mgr/testDB"
 	set status=##Class(Config.Databases).Create(dbName,.dbProperties)
	write:'status $system.Status.DisplayError(status)
	write "DB """_dbName_""" was created!",!!
	
	
	write "Create namespace ...",!
	set nsName="testNS"
	//DB for globals
	set nsProperties("Globals") = dbName
	//DB for routines
	set nsProperties("Routines") = dbName
	set status=##Class(Config.Namespaces).Create(nsName,.nsProperties)
	write:'status $system.Status.DisplayError(status)
	write "Namespace """_nsName_""" was created!",!!
	
	
	write "Create web application ...",!
	set webName = "/csp/testApplication"
	set webProperties("NameSpace") = nsName
	set webProperties("Enabled") = $$$YES
	set webProperties("IsNameSpaceDefault") = $$$YES
	set webProperties("CSPZENEnabled") = $$$YES
	set webProperties("DeepSeeEnabled") = $$$YES
	set webProperties("AutheEnabled") = $$$AutheCache
	set status = ##class(Security.Applications).Create(webName, .webProperties)
	write:'status $system.Status.DisplayError(status)
	write "Web application """webName""" was created!",!
	
	zn currentNS

在Caché基础课程中，同学们同时学习了Caché开发和ObjectScript语法。为了帮助大家完成练习，我们提供了ObjectScript快速参考（俗称 "小抄"）。

它不是所有ObjectScript的参考资料! 它是学生在课程中使用的ObjectScript命令和函数的列表，以及对象、集合等的常用语法。它还包含一些有用的宏。

我们正在为开发者社区提供一个pdf版本。

不久前，GitHub推出了在浏览器中快速运行VSCode的功能，可以在任何仓库中运行。 在任何仓库或拉动请求上按下 . 键，或将URL中的.com换成.dev，就可以直接进入浏览器中的VS Code环境。

这个VSCode是桌面版的轻型版本，完全基于浏览器。由于这个原因，它对允许以这种方式工作的扩展插件有限制。让我介绍一下VSCode-ObjectScript扩展的新版本1.2.1，它现在支持在浏览器模式下运行。

有时，有必要从主机操作系统的Shell（即你的ObjectScript程序所在的地方）执行命令，以启动程序、操作系统服务、安排crontasks以及其他活动。为此，该语言有一个叫做$ZF(-100). 的实用程序:

$ZF(-100,flags,program,args)

其中flags是你想执行的命令的类型。在我们的例子中，标志是"/ SHELL"，用于在主机操作系统上执行shell命令。

Program是要执行的程序或服务的名称。

Args是传递给程序的执行参数。

一个例子是在提示符下打印一些内容，例如:

$ZF(-100,"/SHELL","echo","https://www.intersystems.com/")

如果你的程序依赖于改变当前目录，要运行该程序，在调用前使用以下命令:

Do ##class(%SYSTEM.Process).CurrentDirectory("/path/")

在测试你的代码时，你经常会遇到需要检查对象的实际内容。无论是使用 ZWRITE 还是 $system.OBJ.Dump()，

你会得到一个简单的属性图片，"--- 属性值---"

而 "--- swizzled references ---" 更容易让人混淆 

用“--- calculated references ---" 你只是被留在了后面。

ObjectScriptt至少有三种处理错误的方法（状态代码status codes、异常 exceptions, SQLCODE等）。大多数系统代码使用状态码，但由于一些原因，异常更容易处理。在处理遗留代码时，你要花一些时间在不同的技术之间进行转换。我经常使用这些片段作为参考。希望它们对其他人也是有用的。

///Status from SQLCODE:
set st = $$$ERROR($$$SQLError, SQLCODE, $g(%msg))  //embedded SQL
set st = $$$ERROR($$$SQLError, rs.%SQLCODE, $g(rs.%Message)) //dynamic SQL
///Exception from SQLCODE:
throw ##class(%Exception.SQL).CreateFromSQLCODE(SQLCODE,%msg) //embedded SQL
throw ##class(%Exception.SQL).CreateFromSQLCODE(rs.%SQLCODE,rs.%Message) //dynamic SQL
throw:(SQLCODE'=0)&&(SQLCODE'=100) ##class(%Exception.SQL).

第二十一章 源代码文件 REST API 参考（三）

GetDocNames

此方法返回源代码文件名列表。可选的 cat 和 type 约束源代码文件的类型。

URL

GET http://server:port/api/atelier/v1/namespace/docnames

GET http://server:port/api/atelier/v1/namespace/docnames/cat

GET http://server:port/api/atelier/v1/namespace/docnames/cat/type

其中

• cat 指定类别代码：CLS = class; RTN = routine； CSP = CSP 文件； OTH = other。默认为 *。
• type 指定源代码文件类型。可以是 * 通配符或文件类型。对于 CLS，类型必须是 *。对于 RTN，类型可以是 mac、int、inc、bas 、mvi 或 mvb。对于 CSP，type 可以是 js 或 css 等文件类型的列表，以逗号分隔。默认为 *。

URL Parameters

• URL 参数 'generated=1' 指定应包含生成的源代码文件。
• URL 参数 'filter' 提供了一个可用于匹配名称的 SQL 过滤器。

医疗行业的互操作性在改善病人护理、降低医疗服务提供者的成本以及为提供者提供更准确的情况方面发挥着重要作用。然而，由于有这么多不同的系统，数据的格式也有很多不同的方式。有许多标准被创造出来以试图解决这个问题，包括HL7v2、HL7v3和CDA，但每一种都有其缺点。

FHIR，即快速医疗互操作性资源，是一种新的医疗数据格式，旨在解决这些问题。它是由国际卫生级七组织（HL7）开发的，该组织还开发了HL7v2、HL7v3和CDA。

今天我们将探讨如何在VS代码中借助IntelliSense和自动完成功能，通过使用FHIR Schema 创建和验证FHIR资源。

第 1 步 :从FHIR 官方网站 https://www.hl7.org/fhir/下载 JSON schema file 文件用来做资源校验

第 2 步: 创建文件夹（在这个例子中，我使用病人文件夹和病人资源），并将提取的fhir.schema.json文件复制到同一文件夹，然后从VS Code中打开文件夹

第 3 步: 通过修改setting.json文件，设置VS代码以识别FHIR模式。
按CTRL+SHIFT+P并输入工作区设置JSON文件

第 4 步: 在同一文件夹中创建一个新文件patient.fhir.json。