Object Script(六)

• 变量的类型

ObjectScript中的变量是没有类型的，也就是说，它们没有一个指定的数据类型，可以接受任何数据值。

ObjectScript支持以下几种类型的变量：

1. 本地变量 ：只有创建它的进程可以访问的变量，当该进程终止时，改变量将自动删除。一个本地变量可以从任何命名空间访问。

示例:

     SET str = "A string"

2. 进程私有的全局变量 ： 只有创建它的进程可以访问的变量，并且在进程结束时不再存在。一个进程专用的全局变量可以从任何命名空间访问，因为它与命名空间无关。进程私有的全局变量对于临时存储大数据值特别有用。在许多情况下，它们可以替代Mgr/Temp目录的使用，在进程终止时提供自动清理。

示例：

       SET ^||flintstones(1)="Fred"

       SET ^||flintstones(2)="Wilma"

3. 全局变量 ： 一个存储在InterSystems IRIS数据库中的持久性变量。一个全局变量可以从任何进程中访问，并且在创建它的进程终止后仍然存在。全局变量是针对个别命名空间的。

示例：

SET ^myglobal = "This is a global stored in the current namespace"

4.

Object Script(五)

• 在类中定义属性

Property PropName as Classname(PARAM1=value,PARAM2=value) [ Keywords ] ;

Property SSN As %String(PATTERN = "3N1""-""2N1""-""4N") [ Required ];

• 创建函数示例

Studio创建:

将下段代码填写入建好的类中：

ClassMethod FindPatient(id As %String) As HIS.Patient{  Set patient= ##class(HIS.Patien).%OpenId(id)        Quit patient}

Terminal 调用：

set p = ##class(HIS.Patient).

大家是不是经常遇到以下情况:

• 系统有 bug 但是无法在本地复现
• 你需要在受影响的实例中运行几行代码
• 能完整访问系统管理门户，但是没有终端或者管理控制台, 也不能访问 Studio, Atelier 或者 VSCode
• 你要怎么运行你的几行代码来测试???

Hi, 社区!

想和大家分享一下俄罗斯论坛上的一个Debug方法。

假设我想对应用程序进行Debug，我想让它在某一行停止执行。

在代码中加入这一行:

l +d,-d

当我想在这一行中开始调试时，我在终端中屏蔽了d

USER> l +d

执行该应用程序。

应用程序在这一行停止，让我用Studio调试器连接到它。

为了释放锁，我在终端做了以下工作

USER> l -d

还有其他好的Debug 建议吗？

本月我们正式发布VS Code ObjectScript扩展的1.8.0版本，它包含以下增强功能和错误修复。

最大的更新是支持服务器端的项目文件，因为很多人会记得Studio。如果你在客户端工作，VS Code已经有很好的项目管理功能。你可以简单地使用一个文件夹作为一个项目，或者使用多个根目录的工作空间。但是如果你在服务器端工作，你可能会喜欢一些更好的工具管理能力，这就是这个功能的意义所在。更多内容，欢迎查阅文档的新项目章节。

1.8.0版本的更新日志

• 增强功能
  • 增加对服务器端项目的支持 (#851)
  • 实现isfs文件夹的重命名和删除 (#923, #922)
  • 支持isfs和导出过滤器的 "映射 "标志，以过滤从其他数据库映射的软件包(#931)

完整的更新日志在这里。

如果您已经安装了ObjectScript扩展，VS Code会自动更新。如果您是一个新用户，请从这里开始。 

    我一直希望 VSCode 能够拥有熟悉的 Studio 外观。

    值得庆幸的是，VSCode 易于定制，因此您可以为任何元素选择任何颜色。

    这是我到目前为止得到的：

有很多方法可以使用Intersystems生成excel文件，其中一些是ZEN报告、IRIS报告（Logi报告或正式称为JReports），或者我们可以使用第三方Java库，可能性几乎是无限的。

但是，如果你想只用Caché ObjectScript创建一个简单的电子表格呢？(没有第三方应用程序)

在我的案例中，我需要生成包含大量原始数据的报告（财务人员喜欢这些数据），但是我的ZEN/IRIS失败了，给了我一个我想称之为 "零字节的文件"，基本上说java的内存用完了，并导致报告服务器上的重载。

这可以用Office Open XML（OOXML）来完成。Office Open XML格式是由一个ZIP包内的一些XML文件组成的。因此，基本上我们需要生成这些XML文件，并将其压缩重命名为.xslx。就这么简单。

这些文件遵循一套简单的惯例，称为开放包装惯例。你需要声明各部分的内容类型，以及告诉消费应用程序应该从哪里开始。

为了创建一个简单的电子表格，我们至少需要5个文件。

• workbook.xml
• worksheet.xml
• [Content_Types].xml
• styles.xml
• _rels
  • .rels
  • workbook.xml.rels

workbook.xml
工作簿是各种工作表的容器。

程序化访问 Production

要用程序编辑Production（界面），你可以使用互操作性API和SQL查询的组合。

现有的命名空间

从顶层了解你目前正在工作的命名空间和生产是很重要的。

// Object script 
// The active namespace is stored in this variable
$$$NAMESPACE 
// Print namespace
Write $$$NAMESPACE

# Python
import iris
# The active namespace is returned from this method
iris.utils._OriginalNamespace()
# Print namespace
print(iris.utils._OriginalNamespace())
>>> DEMONSTRATION

现有Production (正在或者最后一次运行的Production)

另外，知道你的Production名称是很重要的，你可以使用以下API获得名称空间中正在运行的Production。

// ObjectScript
USER>ZN "DEMONSTRATION"
// Get current or last run production
DEMONSTRATION>W ##class(Ens.

HI 开发者们,

我们在bilibili 发布了新的视频！

<iframe src="//player.bilibili.com/player.html?aid=637281555&bvid=BV1cb4y1p7RE&cid=550213579&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

好人不需要规则。

神秘博士

要成为日期和时间的主人并不是一件容易的事，在任何编程语言中，这总是一个问题，有时会让人感到困惑，我们将澄清并提出一些提示，使这项任务尽可能简单。

坐上TARDIS，我将把你变成一个时间领主。

How to use Studio Coding to do service registration function of service component in production system 如何通过studio代码开发，实现production界面的服务组件的服务注册功能

@Ming Zhou 在 https://community.intersystems.com/post/how-get-all-properties-defined-c 上问了一个很好的问题......而这个答案正好总结了为什么ObjectScript 是我最喜欢的语言。

当我第一次向别人介绍ObjectScript或IRIS时，我总是解释说，你可以写一个类，编译它，得到一个表，并从对象或关系的角度来处理你的数据--这是一种最自然的方式。

但无论哪种方式，它都只是一个薄薄的包装，包裹着被称为Globals的超级快速的内部数据结构，当你真的需要更快的速度时，你可以使用这些结构。

当我和比较爱较真的技术人员沟通时，我会告诉他们：ObjectScript允许各种炫酷的元编程，因为你可以用完全相同的方式与你刚刚写的类进行交互--从对象或关系的角度。或者在你需要额外的速度时直接使用超快的底层数据结构。

你可以在对这个问题的回答中看到答案： "我怎样才能得到一个类中的所有属性，包括继承的属性？"

这里有三种不同的方式来获得相同的答案。

Class DC.

Hello 家人们，

    InterSystems 学习网站有许多非常棒的课程。 因此，如果您想了解 InterSystems 并开始使用 InterSystems，希望这些资源可以帮到你：

听IRIS 专家聊IRIS，学技术，练英语听力，尽在Intersystems 系联在线培训广播电台
 https://datapoints.intersystems.com.

21. Embedded Python — Released February 3, 2022

20. The InterSystems Kubernetes Operator — Released July 27, 2021 [Transcript available]

19. What's New in Version 2021.1 of InterSystems IRIS? — Released June 3, 2021

18. The InterSystems IRIS® FHIR® Accelerator Service — Released May 5, 2021

17. The Analytics & AI Landscape — Released April 6, 2021

16. A Cloud DBMS Visionary — Released January 27, 2021

15. Writing ObjectScript in VS Code — Released November 17, 2020

14.

Hi 开发者们, 

New video is already on InterSystems Developers YouTube: 

⏯ Embedded Python for ObjectScript Developers: Working with Python and ObjectScript Side-By-Side

<iframe src="//player.bilibili.com/player.html?aid=892887041&bvid=BV1fP4y177XF&cid=478516671&page=1" width="400" height="300" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true"> </iframe>

$HOROLOG（$H）

表示当前的本地日期和时间，是由两个整数值组成的字符串，这些整数是计数器，是InterSystems IRIS存储格式，不是用户可读的日期和时间。

ddddd,sssss

代码示例：

w $H,!
 
北京时间2021年12月29日15：15：30时，输出结果为：
 
66107,54930

第一个整数，ddddd，是当前日期，表示为自1840年12月31日以来的天数，其中第1天是1841年1月1日。这个日期到达的最大年年限是9999年12月31日，所以这个整数的最大值是2980013。$HOROLOG不能直接用于表示1840年到9999年范围之外的日期

第二个整数，sssss，是当前的时间，表示为从当天午夜开始的秒数计数。系统将时间字段从0递增到86399秒。当午夜时分达到86399时，系统将时间字段重置为0，并将日期字段增加1。

你可以通过调用Horolog()方法获得相同的当前日期和时间信息，如下所示。

WRITE $SYSTEM.SYS.Horolog()

$NOW()

$NOW()返回当前进程的本地日期和时间，是InterSystems IRIS存储格式，不是用户可读的日期和时间。

ddddd,sssss.ffffff

代码示例：

w $NOW(),!

北京时间2021年12月29日15：15：30时，输出结果为：

66107,54930.

dformat ：

正如你在我的简介中看到的，我在一所大学教书，我想分享我对IRIS（或之前的Caché）教学的看法。

已经有一段时间了，但我还记得在今年早些时候看到YURI MARX GOMES关于 "用InterSystems对象和SQL开发 "一系列课程。他对第1天、第2天和第3天的课程内容进行了简要的描述，并附有讲师Joel Solon的评论。我心想，分享我自己的经验可能会有趣。

在我真正写下我教给学生的东西之前，先简单介绍一下我的经历。

在我毕业拿到硕士学位回到大学工作后，我们系决定更新我们的课程，在普通课程中增加几门新课程。其中一门是 "后关系型数据库"。它是为研究生第一年的学生讲授的。开始时，它包括72小时的讲座和72小时的实践。现在变为秋季学期72小时的讲座和36小时的实践。

由于我是一名新员工，而且是一名年轻有为的员工，我被赋予了讲授这门新学科的职责。我感到惊讶和惊恐是不言而喻的。首先，我根本没有任何教学方面的实践经验。其次，我只有夏天的三个月时间来学习一项对我来说完全陌生的技术并准备课程的讲授。幸运的是，我已经知道了应该教授哪个数据库。这个数据库就是InterSystems Caché。

总之，我或多或少地准备好了，然后我亲爱的学生们的问题开始了。例如，为什么他们必须学习这个数据库，他们在哪里以及如何使用这个数据库，等等。

Object Script(四)

面向脚本

• 类

类的主要类型

类成员

技术概要：ObjectScript

技术概要：ObjectScript

本文档将向您介绍 ObjectScript 编程语言，并提供了几个示例，说明如何使用它来存储和检索来自 InterSystems IRIS®数据平台的数据。本技术概要（First Look）并不试图提供对该语言或其功能的全面概述。您可以使用本文件末尾列出的参考资料，继续您的探索。

要浏览所有的技术概要（First Look），包括可以在 InterSystems IRIS 免费的评估实例上执行的那些，请参见 InterSystems First Looks（《InterSystems 技术概要》）。

什么是 ObjectScript？

ObjectScript 是一种编程语言，用于在 InterSystems IRIS 数据平台上快速开发复杂的业务应用。ObjectScript 源代码被编译成 object 代码，该代码可针对业务应用程序中的典型操作（包括字符串操作和数据库访问）进行高度优化。

ObjectScript 的独特之处之一是它的底层存储结构，即所谓的 globals。Globals 可以被认为是持久的多维稀疏数组。ObjectScript 允许您直接从 globals 访问数据，但也允许您通过其本机 object 和 SQL 支持来访问这些数据。

Object Script(三)

面向脚本

• Routine

可将routine看做全局可调用的函数，一个函数是一个执行程序(Roution)，它执行一个操作（例如，将一个字符串转换为其对应的ASCII码值）并且可以返回一个值。

语法结构：

Routine可以有一个标签，ObjectScript代码，以及结尾的注释，所有这些元素都是可选的。可以使用"；"或"//"来表示注释。对于多行注释，用"/*"标记注释的开头，用 "*/"标记注释的结尾。

结构示例:

标签

      ObjectScript代码

end

• 创建Routine示例

Studio创建:

打开Studio，点击左上角新建文件。选择General->ObjectScript Routine

将下段代码填写入建好的Routine。

hello ; hello world routinewrite !, "hello world"          write !, "bye"      endquit  ; end

Terminal调用：

打开Terminal，执行下段代码，即可检查结果。

    do ^hello

如何通过studio代码开发，实现生产界面的服务组件的服务注册功能

众所周知，Object Script是一个弱类型开发语言，%String是我们非常常用的一个类型，时不时有客户在初次接触Object Script编写程序时遇到%String长度限制的问题，在这里做一个简单总结，以便于相关开发人员作为参考。

1. MAXLEN设置字符串的长度。
Property Name As %String(MAXLEN = 50);
a) 如果不设置MAXLEN, 默认长度限制为50
b) MAXLEN = "", 没有限制长度，也就是字符串本身的长度限制。

如果超限，您将会看到如下报错，
错误 #7201: 数据类型值'abcdefghijklmnopqrstuvwxyzabcdefghijklmnopqrstuvwxyz'的长度超过50允许的MAXLEN 

2. 字符串本身的长度限制。
在没有开启长字符串的情况下，%String类型的长度限制是32,767个字符。

如果超限，您会遇到报错<MAXSTRING>，如果遇到这个报错，建议您改用流类型%Stream，如%Stream.FileCharacter, %Stream.GlobalCharacter等等，更多关于如何使用流类型，详见如下在线文档，
http://dreamymclean.intersystems.skytapdns.com:52773/csp/docbook/DocBook.UI.Page.cls?

利用Intersystems IRIS医疗版数据平台内置多模型整合

医院信息查询业务解决方案

概述：

随着医院信息化建设的逐步完善，医院子系统越来越多，系统间接口越来越多，同时接口费用不断增加，管理工作变得越来越复杂。其中，查询类业务接口根据业务类型分化，数量也是逐步递增，带来接口量大、开发工作繁重、代码冗余、维护困难等等问题。针对这一困境，我们利用Intersystems IRIS数据平台内置多模型整合医院信息查询业务解决方案。该应用程序可通过内置模型应用完成查询业务，大大缩小开发、维护、实施等项目关键运转周期。

应用链接：HealthInfoQueryLayer           

关键应用：IRIS for Health、REST API、ObjectScript、Globals 、SQL、DATA LOOKUP TABLES

应用程序采用模型及应用介绍：

1.采用模型

1.1. Globals (key-value)

Globals是可以在IRIS数据库中存储和管理的稀疏多维数组。您可以使用ObjectScript和本机API处理Globals。

工具:

https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GGBL_MANAGING

应用：

应用程序根据Globals的键值对、访问速度快的特性。

Object Script(二)

• 特殊符号

ObjectScript没有定义任何保留字：你可以自由地使用任何字作为标识符（如变量名）。为了达到这个目的，ObjectScript使用了一组内置的命令以及特殊的字符（比如函数名的"$"前缀），以便将标识符与其他语言元素区分开来。

Object Script(一)

• 概况

ObjectScript是一种用于在InterSystems IRIS数据平台上快速开发编程语言，它是面向对象的弱类型脚本语言，非常适用于各种应用，包括业务逻辑、应用集成和数据处理。

在这里，我将主要介绍ObjectScript的命令脚本，类，方法和Routine等使用方式和语法规范。如有任何疑问，可在InterSystems开发者社区进行深入讨论。

• IDE选择

可以使用InterSystems IRIS内置的Studio或Visual Studio Code（需要安装Object Script扩展）来查看和编辑代码。这里我们使用InterSystems IRIS内置Studio来做示例。

如果你已安装InterSystems IRIS或者InterSystems HS 等任何InterSystems产品，找到右下角的图标 ，单击鼠标右键,点击Studio，如下图所示：

输入用户名和密码(用户名：superuser 密码：安装时自己设置的密码)，即可进入到Studio开发环境，如下图所示：

• Terminal

可以直接打开InterSystems IRIS的终端尝试执行ObjectScript的简单指令。

这是一个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的实例

可以使用%SYS.Journal.File类中的ByTimeReverseOrder查询，以及%SYS.Journal.Record类中的List查询来实现。

下面是这两个查询的具体作用：

A) %SYS.Journal.File类中的ByTimeReverseOrder查询
这个查询会获取journal日志文件名并按降序排列

USER>set rs=##class(%ResultSet).%New("%SYS.Journal.File:ByTimeReverseOrder")
 
USER>do rs.Execute()
 
USER>while rs.Next() { write rs.Name,! }
c:\intersystems\cache\mgr\journal\20190620.003
c:\intersystems\cache\mgr\journal\20190620.002
c:\intersystems\cache\mgr\journal\20190620.001
c:\intersystems\cache\mgr\journal\20190610.001

B) %SYS.Journal.Record类中的List查询
这个查询可以从指定journal日志文件中获取日志记录

USER>set rs2=##class(%ResultSet).

除了objectscript 自带的 list，array 数据结构以外，是否有存在其它已经实现好的数据结构，类似 java 里面 collection包一样，是否有已经实现好的排序工具，有没有针对集合类的sort工具。