第129章 查询关键字 - WebMethod

指定这个类查询是否为web方法。 仅应用于定义为web服务或web客户端的类。

用法

要指定这个查询是一个web方法，请使用以下语法:

Query name(formal_spec) As classname [ WebMethod ] {    //implementation }

否则，忽略该关键字或将Not放在该关键字之前。

详情

这个关键字指定这个类查询是否是一个web方法，是否可以通过SOAP协议调用。

默认

如果忽略此关键字，则无法以web方法调用查询。

生成的类

当你将这个关键字添加到类查询并编译类时，类编译器会生成两个额外的类:

• Package.OriginalClass.QueryName
• Package.OriginalClass.QueryName.DS

Package.OriginalClass是包含web方法的类，QueryName是类查询的名称。

例如，假设从类ROBJDemo.QueryWS开始。 ，然后向它添加一个名为MyQuery的类查询。 当你将WebMethod关键字添加到该类查询并编译它时，类编译器会生成以下额外的类:

• ROBJDemo.QueryWS.MyQuery
• ROBJDemo.QueryWS.MyQuery.DS

不要修改或直接使用这些生成的类;它们仅供内部使用。

第125章 查询关键字 - SqlName

覆盖投影SQL存储过程的默认名称。 仅当此查询被投影为SQL存储过程时应用。

用法

要覆盖查询投射为SQL存储过程时使用的默认名称，请使用以下语法:

Query name(formal_spec) As classname [ SqlProc, SqlName = sqlname ] {    //implementation }

其中sqlname是SQL标识符。

详解

如果将此查询投影为一个SQL存储过程，则使用此名称作为存储过程的名称。

默认

如果忽略此关键字，查询名称将用作SQL过程名称。

第126章 查询关键字 - SqlProc

指定查询是否可以作为SQL存储过程调用。

用法

要指定查询可以作为SQL存储过程调用，请使用以下语法:

Query name(formal_spec) As classname [ SqlProc ] {    //implementation }

否则，忽略该关键字或将Not放在该关键字之前。

详情

该关键字指定是否可以作为SQL存储过程调用查询。

默认

如果忽略此关键字，则无法将查询作为SQL存储过程调用。

第127章 查询关键字 - SqlView

指定是否将此查询投影为SQL视图。

这是一个IRIS 2020.2上的代码示例，并非InterSystems 官方支持！

本demo基于原始类描述 is based on the raw class descriptions.
使用的数据类是Address, Person, Employee, Company
如果要做更有吸引力的 demo, 可以添加 JSONtoString by ID的方法

用ZPM安装后从终端启动：After installation with ZPM just run from Terminal

USER>do ##class(rcc.ONAPI.demo).Run()
Adjust Parameters
host[127.0.0.1]:
port[51773]:
namespace[USER]:
user[_SYSTEM]:
pwd[SYS]:
timeout[5]:
****** connected ********

下一步, 你会得到一系列可能的Demo动作。you get a list of possible demo actions.
没有输入就意味着没有动作No input means no action.
菜单会一直循环直到退出The menu loops until you exit.

这些API虽然在IRIS 2020.1中已经实现了，但没有被放在官方文档里。

这都是直接从Class Reference中提取的，我只是收集了它来创建第一个概述。

ObjectScript的本地API遵循其他语言平台上使用的API。它从一个静态API开始，允许用户使用Iris Connection连接到IRIS命名空间，无论是本地还是远程。连接接口允许用户实例化IRIS本地API类（%Net.DB.Iris）。然后，该实例可用于访问IRIS全局数组，管理事务，调用例程或类中实现的函数和方法，以及实例化远程迭代器。

%Net.DB.DataSource

该类实现了IRIS Native API for Object Script DataSource接口。
目前，该接口仅包含 CreateConnection 方法

CreateConnection 方法接受 url, port, namespace, user, 和 pwd 等参数. 这些参数的信息请参考 %Net.DB.Connection 。CreateConnection() 返回 %Net.DB.Connection的实例

我有一个CSP页面，当我把大量的文本（例如：10000个字符）放到一个提交的表单的一个字段中时，会出现 "414 error - Request-URI Too Long"。该表格是用POST方法提交的。

根据我做的一些实验，似乎一个URL的最大尺寸是8200个字符左右。

官方的限制是什么，是否有办法增加它？我在文档中搜索了一下，但没有找到任何东西。

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

欢迎积极参与新一轮InterSystems开发者竞赛！

🏆 InterSystems开发者竞赛：InterSystems IRIS Analytics 🏆

竞赛时间：2021年8月23日-9月12日

奖金总额: $8,750

登录页面即可参赛: https://contest.intersystems.com

第117章 属性关键字 - Transient

指定属性是否存储在数据库中。仅适用于持久类。

用法

要指定属性不存储在数据库中，请使用以下语法：

Property name As classname [ Transient ];

否则，请省略此关键字或将该词放在该关键字之前。

详情

对于持久化类，指定属性不存储在数据库中。

请注意， IRIS验证瞬态属性的方式与验证其他属性的方式相同。例如，当保存对象时，系统会验证其所有属性，包括所有临时属性。

在子类中，可以将非瞬态属性标记为瞬态Transient，但不能反过来。

默认

如果省略此关键字，则属性不是瞬态Transient的。

第118章 查询关键字 - ClientName

此查询的客户端投影使用的别名。

用法

要在将查询投影到客户端语言时覆盖查询的默认名称，请使用以下语法:

Query name(formal_spec) As classname [ ClientName = clientname ] {    //implementation }

其中clientname是在客户端语言中使用的名称。

详情

当查询被投影到客户端语言时，此关键字允许定义查询的替代名称。如果查询名称包含客户端语言中不允许的字符，这尤其有用。

默认

如果省略此关键字，查询名称将用作客户端名称。

第119章 查询关键字 - Final

指定此查询是否为最终查询(不能在子类中覆盖)。

第113章 属性关键字 - SqlComputeOnChange

此关键字控制何时重新计算属性。仅适用于触发的计算属性。

用法

要指定何时重新计算属性，请使用以下语法:

Property name As classname [ SqlComputed, SqlComputeCode=sqlcomputecode, SqlComputeOnChange = propertynames ];

其中sqlcomputecode在SqlComputeCode中描述，propertyname是单个属性名或以逗号分隔的属性名列表。该值还可以包括值%%INSERT或%%UPDATE。

请注意，必须使用实际的属性名，而不是SqlFieldname给出的值。

详解

此关键字仅适用于触发的计算属性；对于其他属性，它将被忽略。(触发的计算属性是一个属性，其SqlComputed为真，并且指定了SqlComputeCode，但是其computed和Transient都为假)

此关键字控制重新计算此属性的条件。重新计算可能源于:

• 对任何指定属性的修改。
• 触发器事件的发生。

如果关键字的值为%%INSERT或%%UPDATE，则分别调用INSERT或UPDATE，指定字段(属性)值的事件触发计算。

• 使用%%INSERT，当一行被插入到表中时， IRIS计算字段值。

当前医院面临更多互联互通需求，如预约挂号与分级诊疗、检验结果共享、医联体信息化、监管数据上报、临床辅助决策支持等，都需要对多源数据进行集成与整合。医疗机构内部和跨机构数据交换与共享，对互联互通提出新的要求。HL7 FHIR是国际上医疗行业实现数据交换和信息共享的标准之一，正在快速得到医疗行业广泛关注。InterSystems中国技术总监乔鹏在视频中分享了FHIR标准与国际互联互通的一些实践经验。

国际互联互通的需求是在不断增长，这跟咱们国内的情况是非常类似的。这些年美国在互联互通领域的政策跟实践还是不少的，比如大家可能听到过包括“有意义的使用（Meaningful Use）”，“21世纪治愈法案（21st Century Cures Act）”，还有更多的政策上的驱动。这里先介绍一下“有意义的使用（Meaningful Use）”。

回过头来，业务场景都是千人千面的， FHIR怎么能够用一个标准涵盖尽可能多的用例？HL7吸收了V3的教训，在V3里面不成功的、或者说采纳度比较低的一个原因就V3试图穷举所有用例，由HL7组织自己来规范这些用例。这个是蛮沉重的教训，这也是V3的方法论虽然好，但是这套实施的路线在国际上有很大障碍的原因。

FHIR是快速医疗互操作资源（Fast Healthcare Interoperability Resources）的缩写，所以FHIR的核心是资源模型。它的颗粒度和结构都优于之前的V2 、V3、CDA标准，而且能够灵活扩展。另外一个优势就是它的API，它不仅提供了针对于资源模型本身的原子化的CRUD（创建、读取、更新、删除的这样一些原子化操作），而且提供了查询这种更复杂操作的能力，同样API是可以扩展的。

在国际上有很多互操作标准的开发组织，在我们医院信息化、医疗信息化领域有40多个标准开发组织，最广为人知的就是HL7国际、IHE，当然SNOMED也是，它开发的是行业术语跟语义的标准。

实现互通的方式方法有很多种，我们通常会见到4种：消息交换、文档交换、服务和 API。

在医疗行业要实现互操作，应该要达到语义级别。只有达到语义级别才能保障医疗信息的准确和医疗行为的安全。而要达到语义级别，我们需要基于标准。

什么是互联互通？我们所说的互联互通其实就是国际上的互操作性，HIMSS对于互操作性定义的是：不同的信息系统、设备、应用系统之间、程序之间，在机构区域和国家边界之内，以及跨机构、区域和国家边界，以协调的方式来访问交换集成和协作使用数据的能力。

发现官网上的native api for java教程无内容. 是不是后端出问题了​​​​​​

第109章 属性关键字 - ServerOnly

指定是否将此属性投影到Java客户机。

用法

要指定属性是否被投影到Java客户端，请使用以下语法:

Property name As classname [ ServerOnly = n ];

其中n是下列之一:

• 0表示此属性是投影的。
• 1表示不投影该属性。

详解

此关键字指定属性是否被投影到Java客户端。

默认

如果省略此关键字，属性将被投影。

第110章 属性关键字 - SqlColumnNumber

指定此属性的SQL列号。仅适用于持久类。

用法

要指定属性的SQL列号，请使用以下语法:

Property name As classname [ SqlColumnNumber = 4 ]; 

其中n是正整数。

详解

此关键字允许显式设置此属性的SQL列号。这是为了支持传统应用程序而提供的。

默认

默认值为空字符串。

第111章 属性关键字 - SqlComputeCode

指定设置此属性值的代码。

用法

要指定属性的计算方式，请使用以下语法:

Property name As classname [ SqlComputeCode = { Set {FieldName} = Expression }, SqlComputed ];

• FieldName—正在定义的属性的SQL字段名称。
• Expression—对象指定属性值的脚本表达式。

第105章 属性关键字 - OnDelete

指定删除相关对象时在当前表中采取的操作。此关键字仅适用于将基数Cardinality 指定为“父”或“一”的关系属性。它的使用在所有其他上下文中都是无效的。

用法

要指定删除相关对象时在当前表中采取的操作，请使用以下语法:

Relationship relname As classname [ Cardinality = cardinality, Inverse = inverse, OnDelete = ondelete ];

其中ondelete是以下值之一。在本讨论中，相关记录是属于关系另一方的记录或对象，引用记录是关系这一方的记录或对象。

• cascade级联—删除相关记录时，也会删除该表中的引用记录。
• noaction无操作—当试图删除相关记录时，尝试会失败。
• setdefault —删除相关记录时，该表中的引用记录将被设置为其默认值。
• setnull —删除相关记录时，该表中的引用记录将被设置为null。

详解

此关键字定义了在关系的另一端删除记录时发生的引用操作。

默认

如果忽略此关键字，则:

• 对于Cardinality 基数为父的关系，OnDelete是级联的。也就是说，当删除父记录时，默认情况下，关联的子记录将被删除。
• 对于基数为1的关系，OnDelete为noaction

第101章 属性关键字 - InitialExpression

指定此属性的初始值。

用法

要指定此属性的初始值，请使用以下语法：

Property name As classname [ InitialExpression = initialexpression ];

其中，initialexpression是用大括号括起来的常量或ObjectScript表达式。

详解

此关键字指定属性的初始值。该值是在创建新实例时由类的%New()方法分配的。(如果属性是瞬态的的，则其初始值由创建实例时%New()调用的代码或实例从磁盘加载到内存时%OpenId()调用的代码确定。)

初始表达式的值必须适合给定的属性类型。

表达式可以是任意复杂的，有以下限制:

• 初始表达式不能引用其他属性。也就是说，诸如{..therPropertyname}这样的表达式无效。
• 初始表达式不能实例化对象，也不能包括对象引用。
• 初始表达式不能调用实例方法(只能调用类方法)。
• 必须在ObjectScript中指定初始表达式。
• 表达式执行的代码不应报告错误。InterSystems IRIS不提供处理表达式返回的错误的方法。
• 如果表达式执行的代码导致发生其他处理，则InterSystems IRIS不提供处理该处理结果的方法。

子类继承InitialExpression

第九十七章 属性关键字 - Collection

不推荐使用的方法是指定集合属性的集合类型。不要使用。

详解

此关键字已被“as”语法替换。

第九十八章 属性关键字 - Deprecated

指定此属性已弃用。此关键字被类编译器忽略，仅提供属性已弃用的人类可读指示符。

用法

要指定不推荐使用此属性，请使用以下语法：

Property name As classname [ Deprecated ]; 

否则，请省略此关键字或将该词放在该关键字之前。

第九十九章 属性关键字 - Final

指定此属性是否为最终属性(不能在子类中重写)。

用法

要指定属性为最终属性，请使用以下语法：

Property name As classname [ Final ];

否则，请省略此关键字或将该词放在该关键字之前。

详解

标记为Final的类成员不能在子类中被重写。

默认

如果省略此关键字，则该属性不是最终属性。

第100章 属性关键字 - Identity

指定此属性是否对应于相应SQL表中的IDENTITY列。适用于持久类。

用法

要指定此属性对应于相应SQL表中的IDENTITY列，请使用以下语法：

Property name As %Integer [ Identity ];

注意：属性类型可以是任何整数类型，例如%BigInt、%Integer、%SmallInt或%TinyInt。

我最近看到一个客户问题，是使用 Caché 数据库上运行的病毒扫描程序导致应用程序间歇性变慢和用户响应时间不佳。

出乎意料的是，这是一个常见问题，所以本帖就是提个醒，要将主要 Caché 组件排除在病毒扫描之外。

通常，病毒扫描必须排除 CACHE.DAT 数据库文件和 Caché 二进制文件。 如果防病毒软件扫描 CACHE.DAT 和 InterSystems 文件，那么系统性能_将_受到较大影响。

具体来说，防病毒软件必须排除的 Caché 文件包括：

• Caché 数据库 (CACHE.DAT)。
• Ensemble/bin 或 cache/bin 目录中的 Caché 可执行文件。
• 写入映像日志 (WIJ)。
• 日志目录中的日志文件。

更多详细信息，请参见在线文档。

更多 Caché 文档

第九十三章 属性关键字 - Aliases

指定此属性的其他名称，以便通过对象访问使用。

用法

要为属性指定其他名称，请使用以下语法:

Property name As classname [ Aliases=othernames ]; 

其中othernames是用逗号分隔的有效属性名列表，用大括号括起来。

详解

如果指定别名关键字，编译器会创建一个或多个给定的别名，这些别名指向原始属性所指向的同一基础数据。例如，重新定义Sample.Person的Name属性，如下所示：

Property Name As %String(POPSPEC = "Name()") [ Aliases = {Alternate}, Required ];

然后，代码可以使用Name属性或等效的Alternate属性，如以下终端会话所示：

SAMPLES>set p=##class(Sample.Person).%OpenId(1)
 
SAMPLES>w p.Name
Fripp,Charles Z.
SAMPLES>w p.Alternate
Fripp,Charles Z.
SAMPLES>set p.Alternate="Anderson,Neville J."
 
SAMPLES>w p.Name
Anderson,Neville J.

第八十九章 参数关键字 - Final

指定此参数是否为final(不能在子类中重写)

用法

要指定参数为final最终参数，请使用以下语法：

Parameter name As parameter_type  [ Final ] = value;

否则，请省略此关键字或将该词放在该关键字之前。

详解

标记为Final的类成员不能在子类中被重写。

默认

如果省略此关键字，则该参数不是最终参数。

第九十章 参数关键字 - Flags

修改此参数的用户接口类型(在Studio中)。

用法

要修改此参数的用户接口类型(在Studio中)，请使用以下语法：

Parameter name As parameter_type  [ Flags = flags ] = value;

其中，flags 为以下值之一：

• ENUM-该参数是由Constraint关键字(逗号分隔列表)指定的值之一。检查器将提供这些值的下拉列表。
• LIST -参数值是由逗号分隔的项目列表组成的字符串。

请注意，不使用EDIT、EMPTY和SYS。

详解

修改参数的用户界面类型(在Studio中)。Studio使用此类型为检查器中的参数提供输入验证。类编译器忽略此关键字。

默认

如果省略此关键字，则Studio只允许该参数使用单个值(并且不提供选项下拉列表)。

第九十一章 映射关键字 - Internal

指定此投影定义是否是内部的(不显示在类文档中)。

第八十五章 方法关键字 - WebMethod

指定此方法是否为web method。仅适用于定义为web service或web客户端的类。

用法

要指定此方法是web方法，请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod ] 
{    //implementation }

否则，省略此关键字或将单词Not放在关键字的前面。

详解

此关键字指定此方法作为web方法可用，并且可以通过SOAP协议调用。

重要:在大多数情况下，web方法应该是实例方法，而不是类方法。

默认

如果省略此关键字，则该方法不能作为web method使用。

生成的类

当将此关键字添加到方法并编译类时，类编译器将生成一个额外的类:Package.OriginalClass.MethodName。Package.OriginalClass是包含web方法的类，MethodName是web方法的名称。

例如，从类ROBJDemo.DocLiteralWS开始。然后添加一个名为add的方法。当将WebMethod关键字添加到该方法并进行编译时，类编译器将生成类ROBJDemo.DocLiteralWS.Add。

不要修改或直接使用这个生成的类; 仅供内部使用。

WSDL的关系

对于web服务，该关键字还会影响生成的WSDL，后者现在包含表示此web方法所需的附加元素。

第八十一章 方法关键字 - SoapRequestMessage

当多个web方法具有相同的SoapAction时使用此方法。 在默认场景中，该关键字指定请求消息的SOAP正文中的顶级元素的名称。 仅适用于定义为web服务或web客户端的类。

用法

要在请求消息的SOAP体中指定顶级元素的名称，请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod, SoapAction = "MyAct", SoapRequestMessage="MyReqMessage" ] 
{    //implementation }

其中soaprequestmessage是有效的XML标识符。

详解

注意:此关键字仅对包装的文档/文字document/literal消息有效。

对于包装的文档/文字消息，该关键字指定请求消息的SOAP主体中的顶部元素的名称。(默认情况下，包装文档/文字消息。

如果对同一web服务中的多个web方法使用相同的SoapAction值，请指定此关键字。否则，一般不需要这个关键字。

与WSDL的关系

SoapRequestMessage关键字影响web服务的WSDL的部分。

• rpc —这个web方法使用rpc(远程过程调用)风格的调用。

使用这种绑定风格，SOAP消息被格式化为具有多个部分的消息。

在SOAP消息中，元素包含一个子元素，其名称取自相应的操作名称。这个元素是一个生成的包装元素，它为方法的参数列表中的每个参数包含一个子元素。

重要提示:对于手动创建的web服务，该关键字的默认值通常是合适的。

第七十三章 方法关键字 - Requires

指定用户或进程调用此方法必须拥有的权限列表。

用法

要指定此方法应限于具有指定权限的用户或进程，请使用以下语法:

Method name(formal_spec) As returnclass [ Requires = privilegelist ] 
{    //implementation } 

其中，privilegelist 要么是单个特权，要么是用引号括起来的以逗号分隔的特权列表。 每个权限都采用resource:permission的形式，其中permission是Use、Read或Write(或单字母缩写U、R或W)。

若要为一个资源resource指定多个权限，请使用单字母缩写。

详情

用户或进程必须拥有权限列表中的所有权限才能调用该方法。 调用没有指定权限的方法会导致错误。

如果方法从超类继承了Requires关键字，则可以通过设置关键字的新值将其添加到所需特权的列表中。 不能以这种方式删除所需的特权。

默认

如果忽略此关键字，则调用此方法不需要特殊权限。

示例

下面的方法需要对Sales数据库的读权限和对Marketing数据库的写权限。 (注意，如果一个数据库有写权限，它会自动有读权限。

第六十九章 方法关键字 - PlaceAfter

指定此方法在为类生成的例程中相对于其他方法的顺序。

用法

要指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后，请使用以下语法:

Method name(formal_spec) As returnclass [ PlaceAfter = methodlist ] 
{    //implementation } 

其中methodlist是单个方法名或用逗号分隔的方法名列表，用括号括起来。

详解

此关键字指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后。此关键字用于极少数需要控制类编译器为方法生成代码的顺序的情况。

默认

如果省略此关键字，类编译器将使用其正常逻辑来确定它生成的例程中方法的顺序。

第七十章 方法关键字 - Private

指定此方法是否为私有方法(只能由该类或其子类的方法调用)。

用法

要指定该方法为私有方法，请使用以下语法：

Method name(formal_spec) As returnclass [ Private ] 
{    //implementation }

否则，请省略此关键字或将该词放在该关键字之前。

详情

私有类成员只能由同一类(或其子类)的其他成员使用。请注意，其他语言经常使用protected这个词来描述这种可见性，使用private这个词来表示不可见子类。