搜索​​​​

InterSystems IRIS、Health Connect和上一代的Ensemble提供了优秀的互操作架构，但即便有低代码开发能力，很多开发者还是希望能用自己的技术栈语言在InterSystems的产品上开发互操作产品。 考虑到互操作产品本身的开放性要求和各个技术栈背后庞大的生态价值，InterSystems IRIS和Health Connect提供了Production EXtension (PEX)架构，让开发者使用自己的技术栈语言来开发互操作解决方案。目前PEX支持Java、.net、Python。 这里我们介绍使用Java利用PEX进行互操作产品的开发。 一 InterSystems IRIS上使用Java开发的基础 在进入PEX主题前，需要简单介绍一下Java在InterSystems IRIS上开发的各种技术选项，因为PEX也是以这些技术选项为基础的。 如果仅把InterSystems IRIS作为一个数据库看待，可以使用JDBC对它进行SQL访问，这是最传统的开发方式； Java是一个面向对象的开发语言，而InterSystems IRIS也是支持面向对象的数据平台。InterSystems IRIS的外部语言服务器技术，提供了一套Java原生SDK，让Java和InterSystems IRIS可以互相访问对方的对象，甚至Java可以通过它直接访问InterSystems IRIS后台的持久化多维数组。外部语言服务器提供了非常灵活、高效的开发方式； 如果是想把Java对象直接持久化到InterSystems IRIS，除了Hibernate，InterSystems IRIS提供一种更高性能的方法 - XEP（Express Event Persistence表达事件持久化）； 最后，Java可以通过PEX开发InterSystems IRIS的互操作产品组件。PEX基于Java原生SDK。 作为多种Java访问方式的基础，InterSystems IRIS的Java外部语言服务器的架构如下： InterSystems IRIS和Java通过动态代理对象的方式操作对方对象，动态代理无需在对方代码变更时重新生成代理类。 InterSystems IRIS提供了intersystems-jdbc-<版本号>.jar，不仅用于JDBC连接、也用于Java外部语言服务器连接，提供Java原生SDK。 在Java端通过jdbc.IRIS管理InterSystems IRIS连接，使用jdbc.IRISObject反向操作IRIS对象。 InterSystems IRIS端提供并管理包括Java语言服务器在内的一系列外部语言服务器。注意，一般情况下，使用系统开箱的这些外部服务器就够了，不需要额外建立额外的Java语言服务器。而且，也无需事先启动，外部语言服务器会在调用时自动启动。 Java连接到InterSystems IRIS，并创建IRIS外部服务器的示例： String connStr = "jdbc:IRIS://127.0.0.1:1972/USER"; String user = "superuser"; String pwd = "SYS"; // 使用DriverManager 创建IRIS连接 // IRISConnection conn = (IRISConnection)java.sql.DriverManager.getConnection(connStr,user,pwd); // 或使用IRISDataSource 创建IRIS连接 IRISDataSource ds = new IRISDataSource(); ds.setURL(connStr); ds.setUser(user); ds.setPassword(pwd); IRISConnection conn = (IRISConnection) ds.getConnection(); // 创建IRIS外部服务器 IRIS irisjv = IRIS.createIRIS(conn);  // 调用IRIS类%PopulateUtils的类方法Name，产生随机姓名 String tempTrader = irisjv.classMethodString("%PopulateUtils", "Name"); 二 PEX 开发 PEX针对于互操作产品的开发，通过PEX使用外部语言开发互操作产品所需的组件，甚至可以通过PEX开发互操作产品的所有组件。 2.1 InterSystems IRIS互操作产品架构 典型的InterSystems IRIS互操作产品架构如下，它的典型工作机制是： 业务服务通过入站适配器监听外部系统，例如TCP和文件系统，将数据组织成消息发送给业务流程 业务流程根据流程需要在特定流程节点将消息发送给业务操作 业务操作通过出站适配器访问外部应用，发送数据并获取响应，并将响应数据组织成消息反馈给业务流程 在互操作产品内部流转的都是消息，消息默认自动持久化并可以通过SQL等方式结构化查询 互操作产品涉及3类组件： 业务组件：包括业务服务、业务流程、业务操作 适配器：包括入站适配器和出站适配器 消息 这3类组件都可以通过PEX进行开发。 2.2 PEX 类和类包 InterSystems IRIS 提供了一个intersystems-utils-<版本号>.jar包，提供com.intersystems.enslib.pex类包，用于基于Java开发互操作产品组件。 在Java代码里还要调用IRIS Object Script开发的组件和代码，因此，还需要intersystems-jdbc-<版本号>.jar。 2.3 示例业务场景介绍 下面我们根据一个示例业务场景介绍如何使用Java PEX进行互操作产品的开发。 业务场景是一个银行间汇款的流程： 业务服务(Finance.FromFileTransaction)监听特定文件夹，并从新汇款申请文件中解析出汇款请求，发送给业务流程(Finance.ProcessPaymentRequest)； 业务流程先将请求发送给汇出行的业务操作(Finance.ToPayFromBank)，获取汇出行的审核结果； 如果汇出行审核批准，则业务流程继续将请求发送给接收行的业务操作(Finance.ToPayToBank) 这里汇出行的业务操作和接收行的业务操作都会将数据写入特定文件夹的文件中。 这个场景中，我们完全使用Java开发全部的组件，包括：请求、响应消息；入站、出站文件适配器；业务操作；业务流程和业务服务。 下面我们就开始吧。 2.4 消息开发 Java消息类是com.intersystems.enslib.pex.Message的子类，消息中的属性，需要定义为public。它会在互操作业务组件间传递时自动持久化。 在IRIS端，Java消息自动映射到EnsLib.PEX.Message，它是一个持久化的IRIS类，包含以下属性： %classname属性：Java消息类名 %json属性：Java消息的JSON类型（IRIS动态对象） 在InterSystems IRIS端，例如消息可视化追踪页面和消息表，你看到的Java消息都是EnsLib.PEX.Message类型。 PEX消息用到的共同账号信息类的示例代码： package Finance; // 封装银行账号信息的类. public class PaymentProfile extends com.intersystems.enslib.pex.Message { public int AccountNumber; public int RoutingNumber; public String UserName; } 请求消息的示例代码： package Finance; import Finance.PaymentProfile; // PEX开发的转账请求消息. public class TransactionRequest extends com.intersystems.enslib.pex.Message { public double TransactionAmount; // 转账金额 public PaymentProfile PayFrom; // 付方银行账号信息 public PaymentProfile PayTo; // 收方银行账号信息 public String FromCurrency; // 付方货币 public String ToCurrency; // 收方货币 // 实例化银行账号属性. public TransactionRequest(){ PayFrom = new PaymentProfile(); PayTo = new PaymentProfile(); } } 响应消息的示例代码： package Finance; // PEX开发的转账响应消息. public class TransactionResponse extends com.intersystems.enslib.pex.Message { public boolean approved; } 2.5 业务组件和适配器的运行时变量 在互操作产品的管理配置页面，可以设置各个业务组件和适配器的配置项，例如文件适配器的文件路径，方便实施和管理。 对于Java开发的业务组件和适配器，同样我们需要这样的配置项。这些配置项，我们称之为运行时变量，这样进行定义： 运行时变量是Java业务组件类和适配器类的public类型的属性 对这些属性使用Java annotation进行元数据描述，例如： @FieldMetadata(IsRequired=true,Description="文件路径") public String FilePath; 后面的Java业务组件和适配器会用到运行时变量的声明方法。 2.6 入站适配器开发 如果要开发Java入站适配器，需要定义一个com.intersystems.enslib.pex.InboundAdapter的Java子类。并在类中实现以下方法： 方法 参数 说明 OnTask 无 适配器根据调用间隔设置，周期性地调用该方法对数据源进行查询；将数据调用BusinessHost.ProcessInput()将数据发送给业务服务；BusinessHost是业务服务的固定的变量名 OnInit 无 适配器初始化的方法 OnTearDown 无 适配器退出清理的方法 例如入站文件适配器示例代码如下： package Finance; import java.io.File; // 导入File类. import java.io.FileNotFoundException; // 导入此类以处理错误. import com.intersystems.enslib.pex.FieldMetadata; // 导入PEX运行时变量类 // 这是一个PEX的入站适配器，检测定义在InboundFilePath的文件夹路径。如果文件夹下有文件，遍历这些文件，使用ProcessInput()将文件路径发送给业务服务 public class PEXInboundAdapter extends com.intersystems.enslib.pex.InboundAdapter { @FieldMetadata(IsRequired=true,Description="输入文件路径") public String InboundFilePath; // 文件夹路径配置项. public void OnTearDown() {} public void OnInit() {} public void OnTask() throws Exception { // 检查文件夹路径，并遍历文件. File folder = new File(InboundFilePath); File[] list = folder.listFiles(); if (list.length > 0) { for (File file : list) { // 忽略.keep后缀文件. // 其它文件路径发送给业务组件BusinessHost. if (file.getName().equals(".keep")) {continue;} BusinessHost.ProcessInput(file.getAbsolutePath()); } } } } 2.7 Java开发组件的注册与更新 开发好的Java组件，需要在InterSystems IRIS端进行注册，让互操作产品可以直接使用这些组件。 注册的方法在Production扩展页面，点击注册新组件： 在远程类名称中填写Java组件类名 在代理名称中填写IRIS生成的代理类名称，可以和Java类名不同。这个类名是在互操作产品中看到和使用的名字。 选择外部语言服务器为%Java Server 将封装有Java组件类的jar文件路径和其它依赖jar文件路径添加到网关额外CLASSPATHS下 注册后就可以在列表中看到注册的组件和组件类型，并在互操作产品中可以直接使用了。 如果后来修改了Java代码，则需要选中已经组册的组件，对其进行更新： * 记得下面这些Java开发的组件也需要注册后使用。 2.8 出站适配器开发 同样，可以通过继承com.intersystems.enslib.pex.OutboundAdapter来开发Java出站适配器类。 它需要实现以下方法： 方法 参数 说明 OnInit 无 适配器初始化的方法 OnTearDown 无 适配器退出清理的方法 其它方法 根据需要 执行具体的适配器操作 例如出站文件适配器示例代码如下，它提供写文件的方法： package Finance; import java.io.File; // 导入File类. import java.io.FileNotFoundException; // 导入此类以处理错误. import java.lang.StringBuffer; // 导入string buffer类. import java.io.FileWriter; // 写文件的包. import java.util.Date; // 处理日期的包. import com.intersystems.enslib.pex.FieldMetadata; // 导入PEX运行时变量类. import java.text.SimpleDateFormat; // 格式化日期字符串的包. // 这是一个PEX的出站适配器，通常被业务操作使用，连接到外部系统. 这里适配器提供WriteToFile()方法，供业务操作调用. public class PEXOutboundAdapter extends com.intersystems.enslib.pex.OutboundAdapter { @FieldMetadata(IsRequired=true,Description="输出文件路径") public String FilePath; // 输出文件路径. public void OnTearDown() {} public void OnInit() {} //写文件的方法，输入参数input是向文件中写入的内容 public Object WriteToFile(java.lang.Object input) throws Exception { // 转换为字符串 String OutputMessage = (String)input; // 允许用户输入的路径有或没有尾部路径分隔符. if (FilePath.substring(FilePath.length() - 1) != File.separator) { FilePath = FilePath + File.separator; } // 用当前日期时间产生文件名. Date today = new Date(); SimpleDateFormat Formatter = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ"); String DateString = Formatter.format(today); // 产生完整文件路径. String OutputPath = FilePath + DateString; // 创建文件. File OutputFile = new File (OutputPath); // 实例化FileWriter对象. FileWriter writer = new FileWriter(OutputFile); // 将内容写入文件 writer.write(OutputMessage); writer.close(); return null; } } 2.9 业务操作开发 Java业务操作类，是com.intersystems.enslib.BusinessOperation的子类。需要实现以下功能： 方法 参数 说明 OnInit 无 适配器初始化的方法 OnTearDown 无 适配器退出清理的方法 OnMessage 无 个方法会在业务操作收到其它业务组件传递过来的消息时被调用 在该方法内部，可以调用适配器的方法 - Adapter.invoke("适配器方法名", 方法参数) Adapter是适配器对象，已经实例化，无需执行自己的实例化代码。Adapter是固定变量名 getAdapterType 无 返回使用的适配器类名 如果是PEX开发的适配器，返回的是它注册到InterSystems IRIS的代理类名 如果使用默认适配器，返回 Ens.InboundAdapter 如果不使用适配器，返回空字符串 例如我们的示例中，有以下2个业务操作： 1. 与汇出银行接口的业务操作类： package Finance; import Finance.TransactionRequest; import Finance.PaymentProfile; import Finance.TransactionResponse; import java.lang.StringBuffer; // PEX业务操作类，和支付银行接口. // 它从业务流程接收请求消息Finance.ProcessPaymentRequest, 将消息内容写入文件并返回内容为'approval' 的响应消息(Finance.TransactionResponse). public class ToPayFromBank extends com.intersystems.enslib.pex.BusinessOperation { public void OnTearDown() {} public void OnInit(){} // 确定适配器 public String getAdapterType() { return "Finance.PEXOutboundAdapter"; } // 响应请求消息 public java.lang.Object OnMessage(java.lang.Object object) throws java.lang.Exception { // 将输入对象转换为对应的类实例. TransactionRequest request = (TransactionRequest)object; // 初始化StringBuffer对象，构造输出文件内容. StringBuffer outputMessage = new StringBuffer(); // 将数据写入StringBuffer. outputMessage.append("Debit request:" + System.lineSeparator()); outputMessage.append("Route:" + request.PayFrom.RoutingNumber + System.lineSeparator()); outputMessage.append("Account: " + request.PayFrom.AccountNumber + System.lineSeparator()); outputMessage.append("Amount: " + request.TransactionAmount); // 调用出站适配器的方法，将数据写入文件. Adapter.invoke("WriteToFile", outputMessage.toString()); // 实例化响应消息，并对响应消息赋值后返回给业务流程. TransactionResponse response = new TransactionResponse(); response.approved = true; return response; } } 2. 与接收银行接口的业务操作类： package Finance; import Finance.TransactionRequest; import Finance.PaymentProfile; import java.lang.StringBuffer; // PEX业务操作类，和收款银行接口. // 从业务流程接收请求消息，并将消息内容写入文件. public class ToPayToBank extends com.intersystems.enslib.pex.BusinessOperation { public void OnTearDown() {} public void OnInit(){} // 确定适配器 public String getAdapterType() { return "Finance.PEXOutboundAdapter"; } // 响应请求消息 public java.lang.Object OnMessage(java.lang.Object object) throws java.lang.Exception { // 将输入对象转换为对应的消息类实例. TransactionRequest request = (TransactionRequest)object; // 实例化StringBuffer对象以构造文件内容. StringBuffer outputMessage = new StringBuffer(); // 将数据写入StringBuffer. outputMessage.append("credit request:" + System.lineSeparator()); outputMessage.append("SourceRouting:" + request.PayFrom.RoutingNumber + System.lineSeparator()); outputMessage.append("SourceAccount: " + request.PayFrom.AccountNumber + System.lineSeparator()); outputMessage.append("ToAccount: " + request.PayTo.AccountNumber + System.lineSeparator()); outputMessage.append("Amount: " + request.TransactionAmount); // 调用出站适配器方法将数据写入文件 Adapter.invoke("WriteToFile", outputMessage.toString()); // 无需响应消息. return null; } } 2.10 业务流程开发 使用Java开发业务流程，则完全是代码开发模式，而非基于BPL的低代码模式。 Java业务流程类是com.intersystems.enslib.pex.BusinessProcess 的子类，需要实现以下方法： 方法 参数 说明 OnInit 无 适配器初始化的方法 OnTearDown 无 适配器退出清理的方法 OnRequest request 请求消息 处理发送给业务流程的请求消息，这个请求消息启动业务流程 OnResponse request 请求消息, response 响应消息, callRequest - 本次异步调用发起的请求消息, callResponse - 本次异步调用收到的响应消息, completionKey - 异步调用发起时传入的completionKey 处理异步调用返回的响应消息-callResponse OnComplete request 请求消息, response 响应消息 整个业务流程完成时，被调用的方法 另外，类里还可以声明需要在业务流程期间保存的持久化数据，和在BPL中要到的上下文（context）数据一样，例如记录汇出行的审核结果。声明时，需要加@Persistent这个Java annotation： @Persistent // 定义名为runningTotal的持久化的属性 public integer runningTotal = 0; 本用例的业务流程示例代码如下： package Finance; import Finance.TransactionRequest; //导入请求消息类 import Finance.TransactionResponse; //导入响应消息类 // 这是一个PEX业务流程类，它从业务服务(Finance.FromFileService)接收请求消息. // 先将汇款请求消息发送给汇出行业务操作(Finance.ToPayFromBank) 并等待审核结果. 如果批准, 将请求消息发送给接收行业务操作(Finance.ToPayToBank). public class ProcessPaymentRequest extends com.intersystems.enslib.pex.BusinessProcess { public Object OnComplete(Object object,Object object2) {return null;} public void OnTearDown(){} public void OnInit(){} // 无需返回响应消息给调用者 public java.lang.Object OnResponse(java.lang.Object request, java.lang.Object response, java.lang.Object callRequest, java.lang.Object callResponse, java.lang.String completionKey) throws java.lang.Exception { return null; } // 处理请求消息 public java.lang.Object OnRequest(java.lang.Object object) throws java.lang.Exception { // 将输入对象转换为对应的消息类实例. TransactionRequest request = (Finance.TransactionRequest) object; // 将支付请求消息以同步请求的方式发送给汇出行. Object response = SendRequestSync("Finance.ToPayFromBank", request); // 将收到的响应消息对象转换为对应的消息类实例. TransactionResponse bankResponse = (TransactionResponse)response; // 记录汇出行审核结果，用于调试 LOGINFO("汇出行审核结果是："+bankResponse.approved); // 检查汇出行审核结果，如果是批准，则将汇款请求发送给接收行. if (bankResponse.approved) { // 使用异步调用方式通知接收行，无需等待返回. SendRequestAsync("Finance.ToPayToBank", request); } return null; } } 2.11 业务服务开发 Java业务服务类是com.intersystems.enslib.pex.BusinessService 的子类。它有一个父类定义的属性 – TargetComponentNames， 用于设置发送消息目标的下游业务组件名列表。可以同时发送消息给多个下游业务组件，组件名之间通过逗号分隔。 业务服务可以使用适配器，这时它会根据适配器的设置定期轮询外部系统，例如SQL适配器轮询外部SQL表、文件适配器轮询外部文件夹。但业务服务也可以不使用适配器，而直接被外部系统调用，例如发布为SOAP、RESTful服务的业务服务就不使用适配器。 适配器 执行过程 需要实现的方法 使用专业适配器 适配器的OnTask()方法定期执行获得数据，将数据发送给业务服务的ProcessInput() OnProcessInput() 使用默认适配器 Ens.InboundAdapter 适配器的OnTask()方法定期执行，并调用业务服务的ProcessInput()； 业务服务的OnProcessInput()执行数据获取 OnProcessInput() 不使用适配器 不定期执行，用户代码在需要时通过Director.CreateBusinessService() 创建业务服务，并执行其方法 OnProcessInput() 或其它需要的方法 本示例中的业务服务使用前面Java开发的文件入站适配器，其代码如下： package Finance; import java.io.File; // 导入File类. import java.io.FileNotFoundException; // 导入此类以处理错误. import java.util.Scanner; // 导入Scanner类读取文本文件. import Finance.TransactionRequest; // 导入请求消息类. // 这是一个PEX的业务服务类，从文件读取汇款请求. 将文件内容转换为Finance.TransactionRequest消息对象,并检查运行时变量TargetComponentNames，确定需要把请求消息发送给哪些业务组件. public class FromFileTransaction extends com.intersystems.enslib.pex.BusinessService { public String TargetComponentNames; // 用逗号分隔的发送目标组件列表，运行时从配置项获取. public void OnTearDown() {} public void OnInit() {} // 确定适配器 public String getAdapterType() { return "Finance.PEXInboundAdapter"; } // OnProcessInput根据业务服务的'call interval' 设置会被定期调用. public java.lang.Object OnProcessInput(java.lang.Object messageInput) throws java.lang.Exception { String path = (String)messageInput; File file = new File(path); // 创建scanner对象读取文件. Scanner reader = new Scanner(file); // 实例化请求消息TransactionRequest对象. TransactionRequest request = new TransactionRequest(); // 设置消息属性. request.TransactionAmount = Float.parseFloat(reader.nextLine().split(":")[1]); String tempString = reader.nextLine(); // 解析嵌套的PaymentProfile对象，并赋值给请求消息的PayFrom属性. String[] tempStringArray = tempString.split(":"); String[] PaymentProfile = tempStringArray[1].split("\\|"); request.PayFrom.AccountNumber = Integer.parseInt(PaymentProfile[0]); request.PayFrom.RoutingNumber = Integer.parseInt(PaymentProfile[1]); request.PayFrom.UserName = PaymentProfile[2]; // 解析PaymentProfile对象，并赋值给PayTo属性. tempString = reader.nextLine(); tempStringArray = tempString.split(":"); PaymentProfile = tempStringArray[1].split("\\|"); request.PayTo.AccountNumber = Integer.parseInt(PaymentProfile[0]); request.PayTo.RoutingNumber = Integer.parseInt(PaymentProfile[1]); // 设置剩余属性. request.PayTo.UserName = PaymentProfile[2]; request.FromCurrency = reader.nextLine().split(":")[1]; request.ToCurrency = reader.nextLine().split(":")[1]; reader.close(); // 处理后删除文件. file.delete(); // 获取Split target business component string and send to each component. String[] targetNames = TargetComponentNames.split(","); for (String name : targetNames){ SendRequestAsync(name, request); } return null; } } 2.12 组装互操作产品并进行测试 将这些Java开发的组件组册后，就可以像InterSystems IRIS的本地组件一样使用了。我们将业务操作、业务流程和业务服务依次加入到Production，并配置好相应的配置项： 对于每个业务操作，需要配置一项： 文件路径：输出的文件夹路径 对于业务服务，需要配置两项： InboundFilePath: 监听的汇款请求文件夹路径 TargetComponentNames: 目标业务流程，这里应该填Finance.ProcessPaymentRequest 下面是用于测试的汇款请求文件内容，把它copy到一个文本文件中保存： TransactionAmount:59.43 PayFrom:232422|23532532|TJohnson21 PayTo:24224242|423533453|ERichards55 FromCurrency:USD ToCurrency:USD 启动Production后，可以将测试数据文件copy到业务服务监听到文件夹下。如果成功，应该可以看到这样的消息追踪结果，可以看到，用Java开发的PEX组件运行结果和IRIS自带的组件没有区别： 2.13 需要实现的Java类方法总结 下图总结了用Java开发不同组件时，需要实现的方法，以及这些组件间的调用流程和关系： 完整的规范参见这里。 三 在Java组件中使用Object Script开发的组件 上面是使用Java开发全套互操作产品组件的示例。实际情况下，InterSystems IRIS已经提供了大量适配器、消息和业务组件，而且使用低代码工具 - 例如业务流程建模图形化工具 - 往往更方便，所以通常Java可以使用Object Script开发的大量组件，而无需全部由Java开发。 在低代码开发业务流程时，可以直接在BPL里调用Java PEX开发的业务流程和业务操作，和IRIS本地开发的组件无异。 另外两种典型的用例是Java组件使用Object Script的消息、Java组件使用Object Script的适配器。在Java端使用Object Script类和对象，需要有前面讲的Java外部语言服务器的基础，文档参见这里。 3.1 Java组件使用Object Script的消息 在Java PEX中使用Object Script定义的消息，直接使用IRIS类的反向代理类IRISObject即可。例如在Java PEX业务操作的OnMessage方法中，要获得传入的Object Script消息的属性值，只需要把传入消息对象转换为IRISObject对象，并调用它的getXXX方法获取属性即可，可以这样： @Override public Object OnMessage(Object object) throws Exception { // 处理类型Ens.StringRequest的ObjectScript消息，获取StringValue属性的值 // 使用ObjectScript消息，将Object转换为 IRISObject IRISObject requestObj = (IRISObject)object; 通过IRISObject的getString方法获取它名为StringValue属性的值 String value = requestObj.getString("StringValue"); ... } 那怎么在Java组件中创建新的Object Script消息实例呢？你需要已经建立了IRIS连接的类型为com.intersystems.jdbc.IRIS的实例。 PEX的Java业务组件类和适配器类都继承于Common类，从Common类继承一个公共属性irisHandle，类型为IRISObject。而irisHandle有一个公共属性iris，类型为com.intersystems.jdbc.IRIS。因此可以通过它来创建Object Script消息实例。例如我们要创建一个类型为Ens.StringContainer的响应消息，并给其StringValue属性赋值： @Override public Object OnMessage(Object object) throws Exception { // 处理类型Ens.StringRequest的ObjectScript消息，获取StringValue属性的值 // 使用ObjectScript消息，将Object转换为 IRISObject IRISObject requestObj = (IRISObject)object; String value = requestObj.getString("StringValue"); // 创建一个类型为Ens.StringContainer的ObjectScript响应消息 IRISObject response = (IRISObject)(this.irisHandle.iris.classMethodObject("Ens.StringContainer","%New")); response.set("StringValue",value+"test me"); return response; } 3.2 Java业务组件使用Object Script的适配器 如果Java业务服务使用Object Script的适配器，无需做任何处理，适配器会将数据发送给Java业务服务的OnProcessInput方法，而Java业务服务只需要将接收的数据转换为IRISObject类型进行处理即可。 如果是Java业务操作要使用Object Script适配器，则需要调用适配器的方法。调用适配器方法，可以使用Adapter属性的invoke方法调用适配器类的方法，语法是 Adapter.invoke("方法名", 方法参数)，例如： // 使用Object Script的出站文件适配器(EnsLib.File.OutboundAdapter)，并调用它的Exists方法检查是否存在文件a.txt Object obj = Adapter.invoke("Exists", "a.txt"); 虽然这里介绍的是使用Java PEX开发互操作产品组件，您也可以使用.net 和Python进行开发，而且任何语言开发的PEX组件都可以一起使用。通过PEX，可以充分利用已有的生态代码和组件快速开发互操作产品。

介绍 由于InterSystems最近宣布从2023.2版本开始停止对InterSystems Studio的支持，转而独家开发Visual Studio Code（VSC）IDE的扩展，相信后者比Studio提供了更优越的体验，我们很多开发者都已切换或开始使用 VSC。很多人可能想知道如何打开终端进行操作，因为VSC没有像Studio那样的输出面板，也没有集成的功能来打开IRIS终端，除非下载InterSystems开发的插件。 概括 介绍 解决方案 对于至少具有 IRIS 2020.1 或 IRIS IRIS 2021.1.2 的用户– 使用 Web 终端 对于至少具有 IRIS 2023.2 的用户 – 使用 WebSocket 终端 对于使用基于 Docker 的 IRIS 的用户 对于在本地计算机上使用 2023.2 之前的 IRIS 版本的用户 对于使用 SSH 连接在基于远程服务器的 IRIS 上进行编码的用户 解决方案 在 VSC 中打开终端的方法有多种，具体取决于您使用的具体配置，我在这里总结了适合任何情况的最佳解决方案： 对于至少具有 IRIS 2020.1.1 或 IRIS 2021.1.2 的用户 – 使用 Web 终端 至少拥有 IRIS 2020.1.1 或 IRIS 2021.1.2 且被允许安装外部扩展的用户（某些人可能由于公司有关第三方应用程序的政策而不允许安装），可能会发现 VSC 的 Web 终端扩展很有用。谁不知道， Web 终端是一个基于 Web 的 InterSystems 产品终端，使用 ObjectScript（例如 IRIS、Caché、Ensemble、HealthShare、TrakCare）构建，允许在浏览器中使用更高级版本的终端（ 这里是项目页面）。通过此 VSC 扩展，只需单击一下即可直接从 VSC 启动基于 Web 的终端。 要打开 Web 终端，请单击： InterSystems Tools > 选择一个名称空间 > 单击以下图标之一 ( , ）在 VSC 终端面板或浏览器上打开 Web 终端（按 Alt 更改默认图标）： 对于至少具有 IRIS 2023.2 的用户 – 使用 WebSocket 终端 至少拥有 IRIS 2023.2 的用户可以利用最新版本的 VSC 扩展中包含的新“ WebSocket 终端”功能，并且不需要其他解决方法。 要打开 WebSocket 终端，请单击： InterSystems Tools > 选择一个名称空间 > 单击 Web 终端旁边的图标。 对于使用基于 Docker 的 IRIS 的用户 在 Docker 中使用 IRIS 环境并使用 VSC 的人员可以直接在 Docker 环境中启动终端会话。 单击状态栏中的 Docker 语音，然后选择Open Terminal in Docker 。 我要感谢@Evgeny.Shvarov 有关这一点的图片和解释。 对于在本地计算机上使用 2023.2 之前的 IRIS 版本的用户 对于使用在本地计算机上运行的 IRIS 版本的用户，可以在 VSC 中设置专用的 IRIS 终端： 打开设置.json 文件。您可以通过多种方式找到它，例如单击“视图”> “命令面板”> 输入：“设置”>打开用户设置 (JSON) 在“ terminal.integrated.profiles.windows ”下添加以下代码： "terminal.integrated.profiles.windows" :{ "IRIS Terminal" : { "path" : [ "C:\\InterSystems\\IRISHealth\\bin\\irissession.exe" ], "args" : [ "IRISHEALTH" ], "icon" : "terminal-cmd" } } 注意：插入irissession.exe的正确路径。 C。要从 VSC 打开终端，请导航至：终端>新终端>启动配置文件... > IRIS 终端。 d.终端菜单中现在应该可以使用“IRIS Terminal”语音： 对于使用 SSH 连接在基于远程服务器的 IRIS 上进行编码的用户 对于使用基于可通过 SSH 连接（例如使用PuTTY ）访问的远程服务器（例如公司服务器）的 IRIS 版本的人员来说，可以使用远程 - SSH VSC扩展将 VSC 直接连接到服务器。为此： 安装远程 - SSH：编辑配置文件 VSC 扩展； 单击“远程资源管理器”图标 在侧边栏中； 选择“打开 SSH 配置文件” 并打开配置文件，路径为： C:\Users\<用户名>\.ssh\config 在配置文件中插入以下代码： Host my-putty-connection HostName < IP address or server name > User < username > IdentityFile < private key path on your local machine > Port < port > IP 地址和端口对应于 PuTTY 中指定的主机名和端口，用户名是用于访问远程服务器的用户凭据，IdentityFile 是 PuTTY 私钥的文件路径。 注意：VSC 无法读取 PuTTY (.ppk) 生成的私钥的原始格式。要通过 PuTTY 在 VSC 和远程服务器之间建立连接，您必须复制原始私钥并将新版本转换为 .pem 格式。为了进行转换： 启动 PuTTYgen 应用程序 在“文件”菜单下，单击“加载私钥” 选择 .ppk 格式的私钥，然后选择“打开” 在“转换”菜单下，单击“导出 OpenSSH 密钥”（强制使用新文件格式）。 设置扩展名为 .pem 的新名称，然后单击“保存”按钮。 将此新 .pem 文件的路径链接到 VSC 中的IdentifyFile 参数 保存文件。几秒钟后，新连接应出现在“远程资源管理器”面板中； 单击“在新窗口中连接... ”以在新的 VSC 窗口中打开 SSH 连接： 选择远程计算机的操作系统（仅在第一次访问时） 在新窗口中，导航至：终端>新终端（或使用快捷键 Ctrl + ò 或 Ctrl + Shift + ò）。 您现在已连接到远程计算机，并且可以在 VSC 中使用其 IRIS 终端。 注意：此操作仅在您之前通过 PuTTY 启动远程连接时有效，并且在 PuTTY 关闭或未连接到远程服务器时不起作用。此操作不会启动 PuTTY，它仅允许 VSC 连接到 PuTTY 建立的隧道。 要通过 VSC 启动 PuTTY 连接，您可以使用批处理文件（在 Windows 上）。提供的connect_remote.bat文件使用 PuTTY 附带的 Plink 命令来启动会话： @echo off set SESSION="<your saved session name>" plink -load %SESSION% 要启动会话，只需在 VSC 终端中键入.\connect_remote.bat以打开远程连接并插入您的凭据。 注意：后一种方法使您可以访问支持所有 VSC 快捷方式的终端版本！欢迎回来 Ctrl+V，再见 Shift+Insert 🎉

### 0. 算法概述 SM3密码杂凑算法是中国国家密码管理局2010年公布的中国商用密码杂凑算法标准。该算法于2012年发布为密码行业标准(GM/T 0004-2012)，2016年发布为国家密码杂凑算法标准(GB/T 32905-2016)。 SM3适用于商用密码应用中的数字签名和验证，是在[SHA-256]基础上改进实现的一种算法，其安全性和SHA-256相当。SM3和MD5的迭代过程类似，也采用Merkle-Damgard结构。消息分组长度为512位，摘要值长度为256位。 整个算法的执行过程可以概括成四个步骤：**消息填充、消息扩展、迭代压缩、输出结果**。 ### 1. 消息填充 SM3的消息扩展步骤是以512位的数据分组作为输入的。因此，我们需要在一开始就把数据长度填充至512位的倍数。具体步骤如下： 1、先填充一个“1”，后面加上k个“0”。其中k是满足(n+1+k) mod 512 = 448的最小正整数。 2、追加64位的数据长度。  ### 2. 消息分组扩展 将填充后的消息m′按512比特进行分组：m′ = B(0)B(1)...B(n−1) 其中n=(l+k+65)/512。 SM3的迭代压缩步骤没有直接使用数据分组进行运算，而是使用这个步骤产生的132个消息字。（一个消息字的长度为32位/4个字节/8个16进制数字）概括来说，先将一个512位数据分组划分为16个消息字，并且作为生成的132个消息字的前16个。再用这16个消息字递推生成剩余的116个消息字。  ### 3. 迭代压缩 SM3使用消息扩展得到的消息字进行迭代运算。  初值IV被放在A、B、C、D、E、F、G、H八个32位变量中，整个算法中最核心、也最复杂的地方就在于**压缩函数**。压缩函数将这八个变量进行64轮相同的计算。  ### 4. 输出结果 将得到的A、B、C、D、E、F、G、H八个变量拼接输出，就是SM3算法的输出。  ### 5. 附录   ### 6. Caché实现 ``` /// SM3密码杂凑算法是中国国家密码管理局2010年公布的中国商用密码杂凑算法标准 /// 该算法于2012年发布为密码行业标准(GM/T 0004-2012)，2016年发布为国家密码杂凑算法标准(GB/T 32905-2016)。 /// 对长度为l(l < 2^64)比特的消息m，SM3杂凑算法经过填充和迭代压缩，生成杂凑值，杂凑值长度为256比特。 Class Utility.SM3 Extends %RegisteredObject { /// Creator： wyh /// CreatDate： 2022-11-01 /// Description：SM3加密 /// Input: msg:原文 /// Output： 16进制密文 /// Debug： w ##class(Utility.SM3).Hashsm3("{""appId"":""60C90F3B796B41878B8D9C393E2B6329"",""nonceStr"":""1234567890"",""timestamp"":""60C90F3B796B41878B8D9C393E2B6329"",""version"":""V2.0.0""}F2D8D966CD3D47788449C19D5EF2081B") ClassMethod Hashsm3(msg) { #; 初始值IV =7380166f 4914b2b9 172442d7 da8a0600 a96f30bc 163138aa e38dee4d b0fb0e4e s V(0) = "01110011100000000001011001101111 01001001000101001011001010111001 00010111001001000100001011010111 11011010100010100000011000000000 10101001011011110011000010111100 00010110001100010011100010101010 11100011100011011110111001001101 10110000111110110000111001001110" #; 1. 消息填充 s m = ..s2m(msg) #; 2. 消息分组 #; 将填充后的消息m′按512比特进行分组：m′ = B(0)B(1)...B(n−1) #; 其中n=(l+k+65)/512。 s n = $l(m)/512 f i = 0 : 1 : n-1 d .s B(i) = $e(m, 512 * i + 1, 512 * (i + 1)) #; 3. 迭代压缩 #; 对m′按下列方式迭代： #; FOR i=0 TO n-1 #; V(i+1) = CF(V(i),B(i)) #; ENDFOR #; 其中CF是压缩函数，V(0)为256比特初始值IV，B(i)为填充后的消息分组，迭代压缩的结果为V(n)。 .s V(i+1) = ..CF(V(i) ,B(i)) #; 4. 杂凑输出 #; ABCDEFGH = V(n) #; 输出256比特的杂凑值y = ABCDEFGH。 s rtn = "" f i = 1 : 1 : 8 d .s bit = $p(V(n), " ", i) .s num = ..bs2n(bit) .s hex = $ZHEX(num) .i $l(hex) < 8 d ..f j = 1 : 1 : 8 - $l(hex) d ...s hex = "0" _ hex .s rtn = rtn _ hex s rtn = $zcvt(rtn, "L") return rtn } /// 1. 消息填充 /// 将填充后的消息m′按512比特进行分组：m′ = B(0)B(1)...B(n−1) /// 其中n=(l+k+65)/512 ClassMethod s2m(msg) { s len = $l(msg) s r = "" f i = 1 : 1 : len d .s num = $ascii($e(msg, i)) .s bs = ..n2bs(num) .s r = r _ bs s rtn = r s rtn = rtn _ "1" s k = 512 - (64 + ($l(r) + 1)) # 512 f i = 1 : 1 : k d .s rtn = rtn _ "0" s lenbs = ..n2bs($l(r)) s t = 64 - $l(lenbs) f i = 1 : 1 : t d .s rtn = rtn _ "0" s rtn = rtn _ lenbs return rtn } /// 3. 迭代压缩 /// 令A,B,C,D,E,F,G,H为字寄存器,SS1,SS2,TT1,TT2为中间变量,压缩函数V(i+1) = CF(V(i),B(i)), 0

1.数据的价值 数据的核心价值是帮助我们决策。 我们无时无刻不在决策，大到战略决策——为一家新医院选址，还有战术决策——鉴别产品的目标市场或抵押贷款审批，更频繁的是操作决策——决定患者的手术方案或患者药物的调整。 这些决策要求不同的决策速度，传统的数据中心已经能较好地帮助我们做战略决策、战术决策，甚至一些操作决策。但新的业务需求要求我们的决策速度越来越快，甚至借助机器学习自动为我们做出即时的决策，例如批准还是拒绝一笔信用卡交易或基于算法自动交易。 无论是人工决策还是基于机器学习的自动决策，决策的依据是数据。数据的速度和质量决定了决策的速度和质量。要支持决策，需要数据具有如下特征： （1）完整 ：关联且具有完整上下文； （2）干净 ：数据质量没有问题； （3）及时 ：在决策点上没有延迟。 传统数据中心很难在及时性上满足要求。 2.数据挑战 数字化浪潮下，我们面临更大的数据挑战： 数据规模：数据量已经完全超出了人工处理能力。 数据源多样性：数据源不再仅是数据库，流式引擎的消息、物联网、对象存储......它们还带来了越来越多模型种类的数据。 更多的数据孤岛：更多的系统和应用被建设，进一步增加了数据孤岛现象。 跨部门的数据不一致：统计口径和统计时间的差异，造成财务部门统计的数据，总是和业务部门统计的数据对不上。 数据服务对象变化：现在业务分析师、运营数据消费者、数据工程师、数据科学家和普通人群都是服务对象。 部署需求的多样性：传统本地部署、云部署、混合部署...... 而由于技术、法律、经济性等原因，传统的数据集中保存无以为继...... 数据库、数据仓库、数据湖，这些传统的数据管理技术应对这些需求和挑战，越来越力不从心。数据库能保持数据的热度（良好的数据存取速度），但支持的模型类型和数据来源有限；数据仓库要统一数据质量与格式（Schema on Write），缺乏灵活性；数据湖可以“以原始形态保存一切数据” （Schema on Read），但各种数据进入这样一个湖，全都变成了无法直接分析利用的冷数据！ 应对之道 – 数据编织和智能数据编织 数据编织是正在兴起的数据管理技术以应对数据挑战，Gartner将其定为2022年12大战略技术趋势之首。 那什么是数据编织？ Gartner将数据编织定义为一种设计概念，可作为数据和连接流程的集成层（结构）。通过对现有、可发现和可推理的元数据资产进行持续分析，数据编织能够在所有环境（包括混合云和多云平台）中设计、部署和利用可重复使用的集成数据。 智能数据编织（Smart Data Fabric）则更进一步，在结构中直接嵌入各种分析能力，包括数据探索、商业智能、自然语言处理和机器学习，使企业可以更快、更容易地获得全新洞察，为智能预测和规范性服务及应用提供动力。 Gartner的这个名词解释还是有些抽象，如何理解它？为何数据编织/智能数据编织是解决上述挑战的利器？ 如何利用现有的产品真实实现智能数据编织的落地？ InterSystems提供的智能数据编织解决方案 今天，智能数据编织（Smart Data Fabric）正被用于许多行业的实际生产中，为各种企业级、关键任务创新提供动力，包括场景规划和决策支持、法规遵从、实时可见性和警报等，作为全球领先的数据技术提供商，为应对当前数据挑战，特别通过InterSystems IRIS新一代数据平台提供智能数据编织解决方案，整合了许多关键特性和能力，以满足客户实施智能数据编织进行数字化转型的需求，该方案在解决数据挑战的同时，允许现有的遗留应用和数据保持原位，最大限度地利用以前的技术投资，包括现有的数据湖和数据仓库，而不需要“撕裂和替换”任何现有技术。 InterSystems IRIS数据编织解决方案把智能数据编织分为3个阶段： 数据互联互通阶段：有能力实时、双向打通各种数据源，将数据源有机编织在一起。 数据集成阶段：对数据本身进行编织，为多模型数据提供高性能存取和转换、加入数据安全控制、建立数据谱系、抽象为干净和统一的语义层供数据用户使用。 智能利用阶段：对建立了统一语义的数据提供紧贴数据的智能利用能力，例如商业智能分析、自然语言分析、机器学习，并使这些智能增强数据编织本身。 InterSystems IRIS数据平台在单一技术栈内提供智能数据编织的这些能力：互联互通、数据集成、自助服务、智能分析和多云 。 传统数据利用的是多级瀑布模式：数据从数据库到数据湖，再到数据中心，数据大批量、高延时地在异构数据平台间移动和拷贝。这是影响数据时效性、一致性的主要原因。所以InterSystems智能数据编织第一就要解决这个问题，而解决之道就是互联互通和数据集成。 1.互联互通 因为数据源和数据模型的多样性，传统的ETL在能力和时效性上都已不能满足需求，需要更完整的互联互通能力。长期以来，InterSystems是互操作技术的领导者，它提供各种适配器实时接入各种数据源，例如流式处理引擎Kafka，并对遗留系统进行现代化，即便有很多遗留系统作为数据源，依然可以通过它将其数据模型多态化和数据服务现代化。 2.数据集成 数据集成（Integration）不追求将数据放在一起，而是要建立数据间的准确关联，建立具有连续上下文的全息数据，甚至丰富数据。InterSystems提供： （1）多模型 面对多元数据，Gartner表示，要想成功利用数据编织，企业必须确保数据编织能够动态地（通过元数据驱动设计）支持不同数据交付风格的组合，以支持特定的用例。 InterSystems的多模型数据建模和保存能力，让不同的数据以最适合的模型进行操作，它支持原生的对象、表、键值对和JSON文档。 （2）多语言 如何操作多模型的数据？每个数据用户都有熟悉或适合其用途的语言来使用数据，例如很多场景下，SQL是最简单的使用数据的语言。InterSystems让用户可以用SQL操作一切数据，哪怕它是以键值对建模和保存的。 （3）数据转换 不同的数据用户希望得到不同结构的数据。InterSystems提供图形化的高效数据转换工具，为用户构建干净的、单一可信的数据。 3.自助服务 如何发现、探索、推理数据编织平台中的数据？需要借助统一的语义和自助的服务能力。 （1）统一语义 为了数据完整性，无论是数据仓库还是数据湖，都将数据中心化存储。这造成了很多数据障碍：数据的时效性低、数据的质量参差不齐、数据需求严重依赖IT去清洗关联等等。 InterSystems的自适应分析是一个统一的、抽象的语义层，通过建立虚拟/逻辑数据分析立方体，用户可以使用SQL或BI工具访问这个语义层，而自适应分析自动使用SQL访问后台的多InterSystems IRIS数据平台实例获得数据和分析结果，不需要将数据集中保存到一起。 数据无需集中，因此无需ETL，没有数据抽取拷贝的时间成本开销，提供高时效性的数据；而抽象语义层将多数据源的数据建立逻辑关联，向用户提供干净、完整的语义上下文。 （2）行业语义级的数据编织 医疗健康行业面临相较其它行业更复杂的行业数据，在现实业务中要应对不同的语义表达。编织不同语义的数据源，将数据抽象为非标准语义，这会为后面的数据价值利用增加障碍。 FHIR建立统一行业语义的行业数据内容标准、利用标准行业术语和标识符、定义统一的传输标准、并逐步建立隐私和安全标准，让使用行业语义编织数据成为可能。 InterSystems支持所有FHIR的交互范式，提供FHIR服务器和FHIR资源仓库，并通过FHIR SQL构建器，建立基于SQL的FHIR数据访问能力，用最简单的数据操作支持BI/AI。通过FHIR来搭建具有统一行业语义和生态的数据编织平台。 （3）自助服务 长久以来，由于数据源和数据本身的复杂性，专业IT用户把持着数据的使用，商业用户极度依赖于专业用户才能获取、分析和利用数据。 借助统一语义层和对标准的支持，InterSystems让商业用户使用自己熟悉的工具和语言，例如SQL、BI工具和API来探索数据、操作数据和分析数据。 4.智能分析 为数据编织增加智能， InterSystems提供开放的智能分析能力。包括嵌入平台的机器学习、自然语言分析、商业智能特性，对第三方工具和生态的支持，以及对标准的支持——MDX、UIMA、PMML...... InterSystems提供全SQL操作方式的自动化机器学习，并允许使用第三方的自动化机器学习后台，如DataRobot，从而避免学习不同的API，用最简单的SQL就可以获得丰富的机器学习能力： 5.多云 数据编织平台要能支持所有主要的开发和部署环境，使开发人员和运营团队能够在他们选择的环境中工作。并与现有的基础设施和最佳技术无缝集成，支持最广泛的客户环境和应用要求。 公共云、私有云、本地、混合、裸机和虚拟机环境，InterSystems支持所有部署选项，且都只需要一个API，而不需要对你的应用程序进行修改。 6.单一技术栈而不建议不同产品和技术的堆砌与粘合 这一点至关重要。从整个数字化、信息化行业来看，信息部门尤其是最终用户的人员配置是远远不足的，从信息化部/科技部到我们的服务厂商，大部分从业人员工作负载基本都处在一个饱和甚至过饱和的状态，同时，IT从业人员由于薪酬激励的原因，大部分的中高端IT人才集中在少数行业或者少数头部厂商。针对这种情况，在数智底座的技术选择上，应该采取“少就是多”的策略，选择尽可能少的技术和产品种类，或者说一体化的技术架构，用一套技术体系来支持多种业务应用的实现，从而降低管理和学习成本。 另外一个原因，比如传统闭源厂商，很多软件产品都是收购或者是不同团队部门研发的，不同软件之间也需要集成或者胶水（参考文章：统一技术的高效数据架构能帮助客户节约大量成本）成本也是极其昂贵的。如果是选择开源技术栈，除了集成以外，还要考虑更多的比如技术路线的生命周期持久度，比如今天选择的技术会不会很快就过时了，技术支持如何延续？此外开源技术人员的成本普遍高于传统软件，人员流动也比较强，这也是企业选型必须考虑的问题。 总结 InterSystems的智能数据编织解决方案通过对数据源、数据的编织，避免多级瀑布式的大规模、高延迟的数据拷贝。构建抽象的统一语义层，并借助行业标准语义，建立基于标准的数据编织平台，为用户提供简单易用的数据探索和利用能力。利用全面的智能分析能力提升数据质量和数据价值，并降低数据利用的难度。多云的架构确保了对最广泛的客户环境和应用要求的支持，为数智底座的实施部署铺平了道路。

亲爱的社区用户，您好！ 您可能知道，您在 Open Exchange 上每发布一个应用程序都会获得 [Global Masters](https://intersystems.influitive.com/) 积分奖励。 最近，我们针对 [ZPM](https://openexchange.intersystems.com/package/ObjectScript-Package-Manager) 应用程序推出了附加积分。 **现在，您的每个 ZPM 应用程序都会为您赢得额外的 400 积分！**积分将自动调整。 立即查看 Global Masters 上的积分和可用奖励！ 如果您对 Global Masters 有任何疑问，欢迎在下面的评论中提问。 * * * 关于 Global Masters 的其他信息： 什么是 Global Masters？ 从这里开始如何在 InterSystems Global Masters 上获得积分  

不少客户问我关于从Cache迁移到IRIS的问题。为什么要迁移到IRIS？Cache是优秀的，稳定的，有很好的性能，为什么要迁移到IRIS呢？这些客户是对的，但在过去几年，数字化转型提出了不少新问题、新需求和新挑战，客户需要更灵活、更完整、更前瞻的解决方案，InterSystems公司很有远见地洞察到了这一点，推出了IRIS。一句话，IRIS是一套数据平台解决方案，它帮助客户和合作伙伴为迎接数字化转型的挑战提供了充足的弹药。

修改过用户门户之后，重新启动就报这个错，然后使用自带的修复功能，修复之后依然报错，日志中显示没有C:\InterSystems\HealthConnect\mgr\IRIS.WIJ,我复制了别人的过来依然报错，由于代码没有做备份我不能重装，有没有什么办法修复一下，或者把代码备份一下，我再重装。 如果由于修改系统文件、误删除文件等问题导致系统启动、初始化等过程失败，还请联系WRC解决故障。 WRC 联系方式： support@intersystems.com 400-601-9890 https://wrc-china.intersystems.com/wrc/login.csp

InterSystems 常见问题解答 通过在持久类（=table）定义中提供的%BuildIndices() 方法的参数中指定要重建索引的 ID 的开始值和结束值，您可以仅重建该范围内的索引。 例如，要仅针对 ID=10 到 20 重建 Sample.Person 类中的 NameIDX 索引和 ZipCode 索引，请执行以下代码（ID 范围在第 5 个和第 6 个参数中指定）。 set status = ##class (Sample.Person). %BuildIndices ( $LB ( "NameIDX" , "ZipCode" ), 1 ,, 1 , 10 , 20 ) $LB() 是$ListBuild() 函数。 %BuildIndices() 方法使用它来指定索引名称。 有关如何重建索引的更多信息，请参阅文档。 2018.1版本请参考此文档。

亲爱的开发者， 最近我们收到很多类似“如何成为一个活跃（Active）、有贡献值的成员”的问题。 条件很简单！ 1. 回答问题 我们有许多未得到回答的问题, 以及 还没有收到有效回答的问题. 非常欢迎您在这些问题上共享您的见解和回答，帮助其他社区成员成长！ 2. 撰写文章，发布帖子 撰写您使用InterSystems技术的经验和心得：解决方案、开发心得、解决bug的小技巧、部署等等。 这里是一些 帖子示例 ，这些帖子都对我们的社区建设很有帮助。 除了中文社区外，我们还有英语社区、日语社区、葡语社区等等，我们也欢迎您将这些社区里的文章翻译成中文进行发布！ 3. 在Open Exchange提交应用程序 通过Github、Gitlab或任何其他公共存储库，在Open Exchange上共享您的库、解决方案和工具。 如果您对社区有什么问题和建议，欢迎跟帖回复、畅所欲言！我们欢迎大家共同建设社区，使这个社区对中国使用InterSystems技术的开发者们越来越有用！ 请新注册的同学们阅读这篇文章，多问问题发帖子/有效评论； 或者多回答问题，中英文都可以： https://cn.community.intersystems.com/?filter=questions； https://community.intersystems.com/?filter=questions

# 第一章 简介global InterSystems IRIS®的核心功能之一是其多维存储引擎。此功能允许应用程序以紧凑、高效的多维稀疏数组存储数据。这些数组称为全局数组。 本章介绍： - 什么是全局变量(`globals` )，以及可以对其执行的操作。 - 全局变量的逻辑和物理结构，包括在分布式数据库体系结构中使用全局变量。 - 如何使用全局变量在应用程序中存储和检索数据。 - 如何使用全局变量。 # 特点 全局变量提供了一种在持久的多维数组中存储数据的易于使用的方法。 例如，可以使用名为`^Settings`的全局变量将值`“Red”`与键`“Color”`相关联： ```java SET ^Settings("Color")="Red" ``` 可以利用全局变量的多维特性来定义更复杂的结构： ```java SET ^Settings("Auto1","Properties","Color") = "Red" SET ^Settings("Auto1","Properties","Model") = "SUV" SET ^Settings("Auto2","Owner") = "Mo" SET ^Settings("Auto2","Properties","Color") = "Green" ``` 全局变量具有以下功能： - 简单易用-全局变量和其他编程语言变量一样易于使用。 - 多维-可以使用任意数量的下标指定全局内节点的地址。 例如，在 `^Settings("Auto2","Properties","Color")`中，下标`Color`是全局设置中的第三级节点。 下标可以是整数、数字或字符串值，并且不需要是连续的。 - 稀疏-用于寻址全局节点的下标高度压缩，不需要连续的值。 - 高效-全局变量上的操作(插入、更新、删除、遍历和检索)都经过高度优化，可实现最高性能和并发性。还有用于特殊操作(如批量插入数据)的其他命令。有一组特殊的全局变量是为临时数据结构设计的(例如，用于对记录进行排序)。 - 可靠-InterSystems IRIS数据库提供了许多机制来确保存储在全局数据库中的数据的可靠性，包括逻辑级和物理级日志记录。执行数据库备份操作时，将备份存储在全局数据库中的数据。 - 分布式IRIS提供了多种方法来控制存储在全局数据库中的数据的物理位置。可以定义用于存储全局的物理数据库，或将全局的部分分布到多个数据库中。使用InterSystems IRIS的分布式数据库功能，可以在数据库和应用程序服务器系统网络中共享全局数据。此外，通过镜像技术，存储在一个系统上的全局数据库中的数据可以自动复制到另一个系统上。 - **并发-全局支持多个进程之间的并发访问。在单个节点(数组元素)中设置和检索值始终是原子的：不需要锁定即可保证可靠的并发访问。此外，InterSystems IRIS支持一组强大的锁定操作，可用于为涉及多个节点的更复杂情况提供并发性。使用对象或SQL访问时，会自动处理此并发。** - **事务性-InterSystems IRIS提供定义事务边界的命令；可以启动、提交或回滚事务。在回滚的情况下，事务内对全局变量所做的所有修改都将被撤消；数据库的内容将恢复到事务前的状态。通过将各种InterSystems IRIS锁定操作与事务结合使用，可以使用全局变量执行传统的`ACID`事务。(`ACID`事务提供原子性、一致性、隔离性和持久性。)。使用对象或SQL访问时，事务会自动处理。** 注意：本文档中描述的全局变量不应与另一种类型的InterSystems IRIS数组变量混淆：进程私有全局变量。进程私有全局变量不是持久的；它们仅在创建它们程序期间持续。进程私有全局变量也不是并发的；它们只能由创建它们的进程访问。进程专用全局可以通过其多字符名称前缀：`^||`或`^|"^"|`轻松地与全局区分开来。 # 例如 一个简单的例子就可以展示全局变量的易用性和性能。下面的程序示例创建一个`10,000`个节点的数组(如果存在，则首先将其删除)并将其存储在数据库中。可以尝试这样做，以了解全局变量的性能： ```java /// w ##class(PHA.TEST.Global).GlobalSimple() ClassMethod GlobalSimple() { Set start = $ZH // get current time Kill ^Test.Global For i = 1:1:10000 { Set ^Test.Global(i) = i } Set elap = $ZH - start // get elapsed time Write "Time (seconds): ",elap q "" } ``` ```java DHC-APP> w ##class(PHA.TEST.Global).GlobalSimple() Time (seconds): .00307 ``` 我们还可以看到迭代和读取数组中的值需要多长时间(确保首先运行上面的示例来构建数组)： -读取持久数组- ```java /// w ##class(PHA.TEST.Global).ReadGlobalSimple() ClassMethod ReadGlobalSimple() { Set start = $ZH // get current time Set total = 0 Set count = 0 // get key and value for first node Set i = $Order(^Test.Global(""),1,data) While (i '= "") { Set count = count + 1 Set total = total + data // get key and value for next node Set i = $Order(^Test.Global(i),1,data) } Set elap = $ZH - start // get elapsed time Write "Nodes: ",count,! Write "Total: ",total,! Write "Time (seconds): ",elap,! q "" } ``` ```java DHC-APP>w ##class(PHA.TEST.Global).ReadGlobalSimple() Nodes: 10000 Total: 50005000 Time (seconds): .001879 ``` # 在应用程序中使用 在InterSystems IRIS应用程序中，全局变量有多种使用方式，包括： - 作为对象和SQL引擎共享的底层存储机制。 - 作为用于为对象和SQL数据提供各种索引(包括位图索引)的机制。 - 作为用于执行不适合进程存储器的某些操作的工作空间。例如，当没有预先存在的索引可用于排序数据时，SQL引擎使用临时全局变量对数据进行排序。 - 用于在对象或SQL访问方面难以表达或效率低下的持久性对象或SQL表上执行专用操作。例如，可以定义一个方法(或存储过程或Web方法)来对表中保存的数据执行专门的分析。通过使用方法，这样的操作是完全封装的；调用者只需调用该方法。 - 实现特定于应用程序的自定义存储结构。许多应用程序需要存储难以用关系表示的数据。使用全局变量，可以定义自定义结构，并通过对象方法将其提供给外部客户端。 - 用于InterSystems IRIS系统使用的各种特殊用途的数据结构，例如配置数据、类定义、错误消息和可执行代码。 全局变量不受关系模型的限制。 它们提供了开发针对特定应用程序优化的定制结构的自由。 对于许多应用程序来说，明智地使用全局变量可能是提供性能的秘密武器，而这种性能是关系应用程序开发人员梦寐以求的。 无论应用程序是否直接使用全局变量，了解它们的操作都是有用的。 理解全局及其功能将帮助设计更高效的应用程序，并为确定应用程序的最佳部署配置提供帮助。

在 Caché 中处理 SOAP 请求时，有时需要通过直接访问（有时是编辑）所发送的 XML（即 SOAP 请求和随后的 SOAP 响应）来调试错误。 如果要调试 Caché Web 服务，使用 SoapUI (https://www.soapui.org/) 之类的工具手动创建和控制 SOAP 请求通常很有用，这样可以很容易地在 Caché Web 服务上看到调整的效果。 但是如果已经有 Web 服务（可能不是 Caché），并且想要调试相关的 Caché Web 客户端该怎么办？ 您可能已将 SOAP 响应 XML 保存在文件中（例如 Caché SOAP 日志），您需要一个“虚拟”Web 服务将其发送到 Caché Web 客户端，就像实际的 Web 服务一样操作。 由于我经常在技术支持的过程中需要调试客户的 Caché Web 客户端，我创建了这样一个“虚拟”的Web 服务 – 见下文： Class JSUtil.DummyWebService Extends %CSP.Page { /// Mimic a SOAP Web Service by sending the specified SOAP Response XML. /// Typically this XML will be copied-and-pasted from a SOAP log. Parameter CONTENTTYPE = "text/xml"; /// File containing the SOAP Response XML: Parameter XMLFILENAME = "C:\data\soapresponse.txt"; ClassMethod OnPage() As %Status { set XML="" set stream = ##class(%Stream.FileCharacter).%New() set sc = stream.LinkToFile(..#XMLFILENAME) while 'stream.AtEnd { set XML = XML_stream.Read() } write XML quit $$$OK } } 要使用 JSUtil.DummyWebService 类： 1.将参数 XMLFILENAME 的值更改为包含来自 Web 服务的 SOAP 响应的 XML 的位置。 通常，此文件可内容可通过手动剪切和粘贴 Caché SOAP 日志中的响应 XML 消息来创建。 2.使用 Studio 的“View Web Page”获取此 CSP 页面的 URL，它应显示响应的XML消息内容。 3.将上面的 URL 粘贴到 Caché Web 客户端的 LOCATION 参数中。 现在，当调用 Caché Web 客户端时，它将收到参数 XMLFILENAME 指向的 SOAP 请求 XML。 我已经多次使用这种方法来帮助调试 Caché Web 客户端。 参考以下示例： SOAP 日志的“Web 客户端的输入”中包含以下错误： ERROR #6203: Unexpected Element （完整的 SOAP 日志可在此处找到：[_https://github.com/ISC-schulman/InterSystems/raw/master/soaplog.txt_](https://github.com/ISC-schulman/InterSystems/raw/master/soaplog.txt)） 我们还有 Web 服务的 WSDL ([_https://github.com/ISC-schulman/InterSystems/raw/master/example.wsdl_](https://github.com/ISC-schulman/InterSystems/raw/master/example.wsdl))，但无法访问 Web 服务本身。 （虽然这对于 InterSystems 支持来说很常见，但不可否认，对于客户可能并不常见 – 这只是一个简单的示例，说明如何使用 DummyWebService。） 首先，使用 DummyWebService 重现错误： 1.使用 SOAP 向导从提供的 WSDL 生成 Web 客户端。 所有参数均使用默认值（尽管您可以指定包名称。） 2.查看 SOAP 日志，然后将 Web 服务响应的XML（“Input to Web client”）剪切并粘贴到文件中： OK   3.通过 JSUtil.DummyWebService 中的参数 XMLFILENAME 指向此文件。 4.使用 Studio 的“Display Web Page”查看 DummyWebService – 它应显示步骤 2 中创建的文件内容。 5.将步骤 4 中的 URL 剪切并粘贴到步骤 1 中生成的 Web 客户端的 LOCATION 参数中。 6.调用 Web 客户端，例如  set client = ##class(MyWebService.RequestWSSoapHttpPort).%New()  do client.createAsynchronuosRequest("x") quit 7. 验证（例如通过 SOAP 日志）是否发生相同错误，即“ERROR #6203: Unexpected Element”。   接下来我们解决这个错误。 这里会经历一些过程或反复试验，但同样只是为了说明如何使用 DummyWebService。 1.像之前一样使用 SOAP 向导和提供的 WSDL 生成 Web 客户端 – 指定不同的包名称以防止覆盖第一个 Web 客户端。 另外，参数全部采用默认值，除了一处： 在 SOAP 向导的步骤 3 中选择“对于文档样式的 Web 方法使用未包装的消息格式(Use unwrapped message format for document style web methods)” 2.重复上面的步骤 5 和 6。 3.验证（例如通过 SOAP 日志）Web 客户端错误是否已修正。 _（注意：使用“未包装的消息格式(unwrapped message format)”是解决 Web 客户端问题的常见解决方案 – 有关详细信息，请参见我们的文档中的“使用 SOAP 向导_”。）   **总结** 可以使用 DummyWebService 类将指定的 SOAP 响应（例如，从 SOAP 日志）发送到 Caché Web 客户端，以模拟 Web 服务的响应。

# 第四章 标识符 # 标识符 标识符是SQL实体的名称，例如表、视图、列(字段)、模式、表别名、列别名、索引、存储过程、触发器或其他SQL实体。 标识符名称在其上下文中必须是唯一的; 例如，同一模式中的两个表或同一表中的两个字段不能具有相同的名称。 但是，不同模式中的两个表或不同表中的两个字段可以具有相同的名称。 在大多数情况下，相同的标识符名称可以用于不同类型的SQL实体; 例如，一个模式、该模式中的表以及该表中的字段都可以具有相同的名称，而不会产生冲突。 但是，同一个模式中的表和视图不能具有相同的名称。 InterSystems IRIS®数据平台SQL标识符遵循一组命名约定，根据标识符的使用，这可能会受到进一步的限制。 标识符不区分大小写。 标识符可以是简单标识符，也可以是分隔符。 InterSystems SQL默认支持简单标识符和分隔标识符。 # 简单标识符 简单标识符有以下语法: ``` simple-identifier ::= identifier-start { identifier-part } identifier-start ::= letter | % | _ identifier-part ::= letter | number | _ | @ | # | $ ``` ## 命名约定 标识符`start`是SQL标识符的第一个字符。 它必须是下列之一: - 大写或小写字母。 字母定义为通过ObjectScript `$ZNAME`函数验证的任何字符; 默认情况下，这些字母是大写字母A到Z (ASCII 65-90)，小写字母a到z (ASCII 97-122)，以及带有重音标记的字母(ASCII 192-255，不包括ASCII 215和247)。 InterSystems IRIS可以在SQL标识符中使用任何有效的Unicode(16位)字母字符。 简单的标识符是不区分大小写的(不过，请参见下面的内容)。 按照惯例，它们用首字母大写来表示。 日语区域设置不支持标识符中的重音拉丁字母字符。 日语标识符可能包含(除了日语字符之外)拉丁字母字符A-Z和a-z(65-90和97-122)，以及希腊大写字母字符(913-929和931-937)。 - 一个下划线(`_`)。 - 百分号(`%`)。InterSystems IRIS以%字符开头的名称(以`%Z`或`%z`开头的除外)保留为系统元素，不应用作标识符。 标识符部分是SQL标识符的任何后续字符。这些剩余字符可能由零个或多个字符组成: - 字母(包括Unicode字符)。 - 数字。数字被定义为数字0到9。 - 下划线(`_`)。 - At标志(`@`)。 - 井号(`#`)。 - 美元符号(`$`)。 一些符号字符也用作运算符。**在SQL中，`#`符号用作模运算符。在SQL中，下划线字符可以用来连接两个字符串；提供这种用法是为了与ObjectScript兼容，首选的SQL串联运算符是`||`。** 将符号解释为标识符字符总是优先于将其解释为运算符。任何关于符号字符作为运算符的正确解析的歧义都可以通过在运算符前后添加空格来解决。 简单标识符不能包含空格或非字母数字字符(上面指定的符号字符除外)。系统间SQL导入工具从导入的表名中删除空格。 注意:SQL游标名称不遵循标识符命名约定。 InterSystems SQL包含不能用作简单标识符的保留字。 有关这些保留词的列表, 要测试一个单词是否是保留单词，请使用`$SYSTEM.SQL.IsReservedWord()`方法。 但是，带分隔符的标识符可以与SQL保留字相同。 任何不遵循这些命名约定的标识符都必须在SQL语句中表示为带分隔符的标识符。 ## 字母 **默认情况下，InterSystems SQL标识符不区分大小写。 InterSystems SQL通过将标识符转换为所有大写字母后比较它们来实现这一点。** 这对名称的实际使用情况没有影响。 (注意，SQL的其他实现可能会以不同的方式处理标识符的大小写敏感性。 因此，建议避免使用基于案例的标识符。) **请注意，系统间SQL中的游标名称和密码是区分大小写的。** ## 测试有效标识符 InterSystems IRIS提供了`%SYSTEM.SQL`的`IsValidRegularIdentifier()`方法。它测试字符串是否是有效的标识符。它测试字符用法和保留字。它还执行200个字符的最大长度测试(这是用于避免错误输入的任意长度；这不是标识符验证)。以下对象脚本示例显示了此方法的使用: ```java /// d ##class(PHA.TEST.SQL).Identifiers() ClassMethod Identifiers() { WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("Fred") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("%Fred#123") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("%#$@_Fred") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("_1Fred") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("%#$") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("1Fred") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("Fr ed") WRITE !,$SYSTEM.SQL.IsValidRegularIdentifier("%sqlupper") } ``` ```java DHC-APP>d ##class(PHA.TEST.SQL).Identifiers() 1 1 1 1 1 0 0 0 ``` 前三个方法调用返回1，表示有效的标识符。第四个和第五个方法调用也返回1；这些是有效的标识符，尽管它们不能用作表名或字段名。最后三个方法调用返回0，表示标识符无效。其中两个是无效的，因为它们违反了字符规则——在这些情况下是以数字开头或包含空格。最后一次方法调用返回0，因为指定的字符串是保留字。请注意，这些规则测试是最低要求；它们不能证明标识符对所有的SQL使用都有效。 这个方法也可以作为存储过程从ODBC或JDBC调用:`%SYSTEM.SQL_IsValidRegularIdentifier("nnnn")`。 ## 名称空间的名字 命名空间名称(也称为数据库名称)遵循标识符命名约定，并对标点字符和最大长度有额外的限制。 命名空间名称可以作为带分隔符的标识符，并且可以与SQL保留字相同。 但是，相同的命名空间名称标点限制适用于简单标识符和分隔标识符。 ## 标识符和类实体名称 通过去除非字母数字字符，SQL表名、视图名、字段名、索引名、触发器名和过程名用于生成相应的持久类实体。 生成的类实体和全局变量的名称遵循这些规则。 注意:命名空间名称和SQL模式名称以及相应的包名称不遵循这些规则。 - 仅在包含标点字符方面不同的标识符是有效的。 因为类对象名称不能包含标点字符，InterSystems IRIS通过去掉所有标点字符来生成相应的唯一对象名称。 如果去掉标识符的标点字符会导致非唯一的类对象名称，InterSystems IRIS将最后一个字母数字字符替换为一个递增的字符后缀，从而创建一个唯一的名称。 对于表、视图、字段、触发器和过程类方法名，这是一个以0开头的整数后缀。 例如，`myname`和`my_name`生成`myname`和`mynam0`，添加我的`#name`生成`mynam1`。 如果生成的惟一名称的数量大于10 (`mynam9`)，则通过替换以(`mynamA`)开头的大写字母后缀生成额外的名称。 因为表和视图共享相同的名称空间，所以表或视图的后缀计数器都是递增的。 对于索引名，这个后缀是一个大写字母，以`a`开头。例如，`myindex`和`my_index`生成`myindex`和`myindeA`。 如果定义了一个以后缀字符结束的名称(例如`my_name0`或`my_index`)， InterSystems IRIS将通过递增到下一个未使用的后缀来处理惟一名称的生成。 - 第一个字符为标点字符，第二个字符为数字的标识符对于表名、视图名或过程名无效。 它们对字段名和索引名有效。 如果SQL字段名或索引名的第一个字符是标点字符(`%`或`_`)，第二个字符是数字，InterSystems IRIS将追加小写的`“n”`作为相应属性名的第一个字符。 - 完全由标点字符组成的标识符，或以两个下划线字符(`__name`)开头的标识符，或包含两个井号(`nn##nn`)的标识符作为SQL实体名称通常是无效的，应该在所有上下文中避免使用。 可以将SQL标识符中的特定字符转换为相应对象标识符中的其他字符。 在允许的标识符字符规则不同的环境中，这有助于标识符的使用。 使用 `%SYSTEM.SQL`的`SetDDLIdentifierTranslations()`方法。 要确定当前设置，调用`$SYSTEM.SQL.CurrentSettings()`。 在DDL运行时将SQL标识符转换为对象标识符时，“From”字符串中的字符被转换为“to”字符串中的字符。 ### 在类定义中指定SQL名称 定义投射SQL实体的持久化类时，每个SQL实体的名称与其对应的持久化类定义元素的名称相同。 要使SQL表、字段或索引名称不同，可以使用`SqlTableName`、`SqlFieldName`或`SqlName`(对于索引)关键字在类定义中指定SQL名称。 例如: ``` Property LName As %String [SqlFieldName = "Family#Name"]; ``` ``` Index NameIdx As %String [SqlName = "FullNameIndex"]; ``` ## 标识符长度注意事项 **SQL标识符的最大长度为128个字符。当InterSystems IRIS将SQL标识符映射到相应的对象实体时，它会创建最多96个字符的相应属性、方法、查询或索引名称。如果前96个字符的两个SQL标识符相同，InterSystems IRIS会将相应对象名称的第96个字符替换为整数(从0开始)以创建唯一名称。** # 分隔标识符 分隔标识符的语法如下： ```java delimited-identifier ::= " delimited-identifier-part { delimited-identifier-part } " delimited-identifier-part ::= non-double-quote-character | double-quote-symbol double-quote-symbol ::= "" ``` 带分隔符的标识符是由分隔符字符括起来的唯一标识符。InterSystems SQL支持双引号(`“`)作为分隔符，分隔符一般用于避免简单标识符的命名限制。 请注意，InterSystems SQL使用单引号字符(`‘`)来分隔文字。因此，必须使用双引号字符(`“`)指定分隔标识符，必须使用单引号字符(`‘`)指定文字。例如，`’7‘`是数字文字`7`，但`”7“`是分隔标识符。当SQL语句用双引号括起来时(例如，在动态SQL中)，该字符串中的双引号字符必须是双引号。 **SQL空字符串应始终指定为一对单引号字符`‘’`。启用分隔标识符支持时，一对双引号字符`“”`将被解析为无效的分隔标识符，并生成`SQLCODE-1`错误。** ## 分隔标识符有效名称 分隔的标识符必须是唯一的名称。带分隔符的标识符不区分大小写；按照惯例，标识符用首字母大写表示。 分隔标识符可以与SQL保留字相同。分隔标识符通常用于避免与SQL保留字的命名冲突。 分隔标识符几乎可以包含任何可打印字符，包括空格。大多数分隔的标识符名称不能包含以下字符：逗号(`，`)、句点(`.`)、插入符号(`^`)和两个字符的箭头序列(`->`)；但是分隔的标识符角色名称和用户名可以包含这些字符。分隔的标识符类名可以包含句点(`.`)。任何分隔的标识符都不能以星号(`*`)开头。以下术语不能用作分隔标识符：`%vid`。违反这些命名约定会导致`SQLCODE-1`错误。 用作表、架构、列或索引名的分隔标识符必须能够转换为有效的类实体名称。因此，它必须至少包含一个字母数字字符。以数字(或标点符号后跟数字)开头的分隔标识符会生成带有字母`“n”`前缀的相应类实体名称。 以下示例显示了对列名和表名使用分隔标识符的查询： ```java SELECT "My Field" FROM "My Table" WHERE "My Field" LIKE 'A%' ``` 为表名指定分隔标识符时，必须分别分隔表名和架构名。因此，`“schema”`。`“tablename”`或`schema`。`“tablename”`是有效的标识符，但是`“schema.tablename”`不是有效的标识符。 ## 禁用分隔标识符支持 默认情况下，启用对定界标识符的支持。 禁用分隔标识符支持时，双引号内的字符将被视为字符串文字。 可以使用带有`SUPPORT_DELIMITED_IDENTIFIERS`关键字的`SET OPTION`命令在系统范围内设置分隔标识符支持。 可以使用`％SYSTEM.SQL`类的`SetDelimitedIdentifiers（）`方法在系统范围内设置分隔标识符支持。 若要确定当前设置，请调用`$SYSTEM.SQL.CurrentSettings（）`。 # SQL保留字 SQL包含一长串不能用作标识符的保留字。 实用性很高的文章，👍

为什么要连接系统？ 连接系统可以让一个系统处理来自非本系统的信息。例如，以下场景需要连接系统： 为了提高效率，最初设计为执行单一功能的系统需要集成。例如，您可以通过集成跟踪库存、订购材料、记录销售和控制运输的各个系统来提高效率。 系统合并后，在不同机构中执行相同功能的系统需要协同工作才能使统一的机构有效。 将系统连接在一起时，您可能会面临一些挑战，例如： 不同系统使用不同的通信协议：一个系统可能使用TCP，另一个系统使用SOAP，第三个系统使用REST。 不同系统使用不同格式或基于不同标准的不同消息。 需要保证消息成功传递到正确的系统，并能够检测和纠正故障。 必须监控传输消息的系统，如果一次消息过多，则为消息提供一个队列，并监控整体系统性能以确保没有任何障碍。 虽然可以编写自定义应用程序来连接系统，但开发一款InterSystems IRIS® 产品要容易得多，也快得多。 InterSystems IRIS 提供了一个框架，允许连接系统，并最大限度地减少或消除对自定义代码的需求。 Production介绍 InterSystems IRIS Production是一个集成框架，用于轻松连接系统和开发互操作性应用程序。产品Production提供包含各种消息格式和通信协议的内置连接。您可以轻松添加其他格式和协议，并通过编写代码或使用图形向导定义业务逻辑和消息转换。产品提供消息的持久存储，允许跟踪消息的路径并审核消息是否成功传递。一个Production由业务服务（BS）、业务流程（BP）和业务操作（BO）组成： 业务服务(BS)与外部系统连接并接收Production来自外部系统的消息。 业务流程(BP)允许您定义业务逻辑，包括路由和消息转换。 业务操作(BO)与外部系统连接并将消息发送给它们。 将系统连接在一起时，让所有系统互相理解它们的消息和文档是有挑战性的。例如，思考以下问题： 您有两个独立的系统：一个是从多个联网设备采集数据，另一个是跟踪损坏的设备和维修进程的工单系统。 当前程序依赖于人工干预来监控设备并启动维修进程。这导致了拖延情况且不可靠。 您的任务是将两个系统连接在一起：监控正在收集的数据并自动启动修复进程。您知道如何检测数据收集系统中的故障设备并知道如何启动维修，尽管两个系统所存储的数据代表同一项目，但是两个系统的存储数据格式并不兼容。 您还需要记录数据收集系统启动维修时的操作。 可以使用InterSystems IRIS 产品解决这个问题。它提供了一个定义接口的框架，该接口接收来自数据采集系统的消息，将消息转换为维修系统可以理解的消息，然后将消息发送到维修系统。它还存储消息路径。 下面以一个简单的Production作为示例 出于演示目的，本文档中的Production使用文件适配器（file adapter）并将外部系统表示为文件。由于处理外部系统的大部分工作是由InterSystems IRIS 提供的适配器完成的，因此开发一款可以连接到含有 REST、TCP、SOAP 或HTTP 的外部系统的Production的过程与使用文件适配器开发产品非常相似。 使用文件适配器（File Adaptor）创建Production 在本节中，您将使用入站文件适配器和出站文件适配器创建Production。可以使用 InterSystems IRIS 中内置的业务服务（BS）、业务流程（BP）和业务操作（BO），因此您无需下载任何代码。 尝试一下！使用文件适配器创建产品 想要尝试一下InterSystems IRIS 互操作性功能的在线视频演示吗？查看互操作行快速入门！ 用前须知 要使用该程序，您需要一个正在运行的InterSystems IRIS 实例。您的选择包括多种类型的已授权的和免费的评估实例；该实例不需要由您正在工作的系统托管（尽管它们必须相互具有网络访问权限）。如果您还没有一个可以使用的实例，如何部署每种类型实例的有关信息，请参阅InterSystems IRIS Basics: Connecting an IDE中的部署 InterSystems IRIS。 关于如何用Visual Studio 连接到您的InterSystems IRIS 实例，请参考InterSystems IRIS 连接信息和.Net IDEs。 创建支持互操作的命名空间（Namespace） 为了创建一个production，必须有支持互操作的命名空间。如果您已经创建了启用互操作的命名空间， 则可以将其用于该production。要创建新的支持互操作的命名空间，请遵照以下流程（首次安装InterSystems IRIS 时 创建的命名空间不支持互操作）： 在浏览器中为实例打开Management Portal （管理门户）。 选择系统管理 > 配置 > 系统配置 > 命名空间，进入命名空间页面。 在命名空间页面，选择新建命名空间 ；根据系统配置指南中“配置InterSystems IRIS”一章中，对于“Create/Modify a Namespace（创建/修改命名空间）”说明，确保选中 Enable namespace for interoperability productions（为互操作性产品启用命名空间）复选框。 点击靠近页面顶部的保存按键，然后在结果日志的结尾选择关闭。 创建含有业务服务 (BS)和业务操作（BO）的简单production 在这一步中，您将： 创建一个新的production。 在该production中添加一项业务服务（BS）和两项业务操作（BO）。 配置业务服务（BS）和业务操作（BO）。 现在，您应该创建在托管InterSystems IRIS实例的系统上运行此production所需的四个目录。具体处理方法取决于所用的实例类型，如下所示： 对于ICM 部署的实例，使用带有-machine 和-interactive 选项的 icmexec命令，打开正在运行该实例的容器的bash shell ，例如： icm exec -command bash -machine MYIRIS-AM-TEST-0004 -interactive 然后，您可以在容器文件系统上创建目录。 对于任何容器化实例，无论是授权版还是社区版，请使用 docker exec -it container_name bash 命令打开该容器的bash shell （社区版的容器名称是try-iris ）。然后在容器文件系统上创建4个目录 对于InterSystems Learning Labs（学习实验室），在集成IDE中使用命令行终端，在共享文件夹下创建新文件夹；您可以在/home/project/shared 路径下的Management Portal（管理门户）中浏览这些文件夹。 对于已安装的实例，在本地文件系统上创建4个目录。 本文本假定以下是Windows 系统上已安装实例的目录路径；替换您创建的实际目录的路径。 c:\Practice\In c:\Practice\Out c:\Practice\PDFsOut c:\Practice\Work 在管理门户中，创建一个新的production： 选择Interoperability（ 互操作性），如果出现提示，请选择一个支持互操作的命名空间。 选择Interoperability （ 互操作性）> 列表 > Production。 如果一个产品当前正在命名空间中运行，请打开它，然后选择停止。返回产品列表页面。 选择新建，创建一个新的产品。 指定包名称（例如 TEST）和production名称（例如 FileProd）。您将创建可用于任何目的的通用production。选择OK创建该产品。 向该产品添加一项业务服务（BS）和两项业务操作（BO）： 选择服务旁边的加号符号以显示业务服务向导。 在服务类下拉菜单，选择EnsLib.File.PassthroughService 。 指定服务名FileService。 清空立即启用复选框。 选择确定。 对两项业务操作（BO）重复这些步骤。从选择操作旁边的 加号符号以显示业务操作向导开始。对这两项操作使用 EnsLib.File.Pa ssthroughOperation 类。将一项操作名称命名为WriteFileOp ，另一项命名为WritePDFsOp。 配置这项业务服务（BS）和两项业务操作（BO）： 选择您在产品配置图中创建的业务服务（BS），并在设置选项卡： a. 选择启用复选框。 在文件路径字段，输入c:\Practice\In。 在存档路径字段，输入c:\Practice\Work。 在工作路径字段，输入c:\Practice\Work。 在接收消息的目标名称字段，选择WriteFileOp。 其他字段为默认值。 选择应用。 为两项业务操作（BO）中的每一项指定设置。选择产品图中的操作，然后： a. 选择启用复选框。 在文件路径字段，对于 WriteFileOp 操作输入c:\Practice\Out，对于 WritePDFsOp 操作输入 c:\Practice\PDFsOut。 其他字段为默认值。 选择应用。 启动Production & 跟踪消息 启动该production后，您将复制一个文件到 FileService 的导入目录。您能查看 WriteFileOp 的导出目录中的文件，并通过该production跟踪消息。请注意，运行这个production时不使用WritePDFsOp 操作。要启动production并跟踪消息： 通过选择开始启动产品。 将任一文件复制到c:\Practice\In 目录。如果该产品配置正确，应该会出现以下情况： 几秒钟后，文件从 c:\Practice\In 目录移动到 c:\Practice\Work 目录。文件名称规范将后附时间戳。例如， 如果原始文件是hello.txt，工作文件可能名称为hello.txt_2018-05-07_17.24.57.056 。 文件的新版本被写入c:\Practice\Out 目录。它还附加了一个时间戳。 产品图中的圆圈应保持绿色。如果圆圈变成红色，则表示产品中存在错误。遍历前面的步骤并确保这些目录存在。 在production配置页面选择FileService，选择消息选项卡。它列出了通过该产品的每条消息。选择转到消息查看器。 在消息查看器中选择一条消息，然后选择跟踪选项卡。它将显示从FileService 转到WriteFileOp 操作的消息。 选择正文选项卡，它将显示消息类型和消息中的字段： 请注意，消息类型是Ens.StreamContainer，其中一个字段是OriginalFilename。 将路由器添加到Production中 在本步骤中，将向产品添加路由业务流程和规则。然后，您将一个文件复制到导入目录，并查看显示消息通过路由器的跟踪。在Management Portal（管理门户）中： 选择Interoperability（ 互操作性） >配置>Production进入Production 配置 页面，然后选择流程旁边的加号符号以显示业务流程向导。在向导中： 在业务流程类下拉菜单，选择EnsLib.MsgRouter.RoutingEngine。 选择自动创建规则复选框。 指定业务流程名称为FileRouter。 清空Enabled（ 启用）复选框。 选择确定。 在对话框中选择OK以批准规则类名称 在Production配置页面选择FileRouter，然后在设置选项卡： a. 选择启用复选框。 选择应用。 选择业务规则名称右侧的放大镜。这将启动规则编辑器，并显示在您创建业务流程时自动生成的规则。 在规则编辑器中，您将创建一条规则，将PDF 文件发送到WritePDFsOp 操作，并将所有其他文件发送到WriteFileOp 操作。规则如下所示 要创建此规则： 双击规则中的 constraint （约束）值。 在 源 字段输入FileService。 在消息类字段输入Ens.StreamContainer。 选择OK。 在 规则辅助中选择rule（ 规则） 然后选择when。 选择 when 条件值，并在规则图上方的文本框内输入Document.OriginalFilename Contains ".pdf"，然后选择确定。 选择图中的 when 子句，然后在规则辅助选择 send（发送）。 双击 target 值并选择WritePDFsOp 配置项。 选择图中的 when 子句，然后在规则辅助 选择 otherwise。 选择图中的 otherwise 子句，然后在规则辅助选择 send（ 发送）。 双击 send 子句的 target 值并选择WriteFileOp 配置项。 选择保存。 返回到Production配置页面，选择FileService 并在 Settings 选项卡： 选择FileRouter 为接收消息的目标名称。 清空WriteFileOp 复选框。 然后选择应用。 您的productioin现已完成。FileService 将所有消息发送到FileRouter 业务流程（BP）。FileRouter 将根据规则将消息发送到WritePDFsOp 或WriteFileOp 操作。 如果你将hello.pdf 复制到c:\Practice\In 目录，它将被发送到 c:\Practice\PDFsOut 目录，但是，如果您复制test.txt 到c c:\Practice\In 目录，它将被发送到c:\Practice\Out 目录。您还可以查看消息跟踪，消息跟踪可以显示通过文件路由器的消息路径。例如，hello.pdf 的跟踪可能如下： 了解有关互操作性产品的更多信息 有关产品的更多信息，请参阅： 介绍互操作性production 开发产品production 配置production 制定业务规则

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. i%property实例变量 当你创建任何类的实例时，系统会为该类的每个非计算属性创建一个实例变量。实例变量持有该属性的值。例如，如果一个类有Name和DOB属性，那么实例变量i%Name和i%DOB就可以在该类的任何实例方法中使用。实例变量有进程私有的。请注意，这些变量不在本地变量符号表中，不受Kill命令的影响。InterSystems IRIS也使用额外的实例变量，名称为r%PropName和m%PropName，但这些变量不支持直接使用。 5. 特殊变量（也称为系统变量） ： 一组特殊的内置变量之一，用于某些应用程序使用的系统信息。所有的特殊变量都是由InterSystems IRIS提供的，并以"$"字符前缀命名。用户不能定义额外的特殊变量。特殊变量集被映射为可从所有命名空间访问。 示例： $HOROLOG

# 第一章 SQL性能优化简介 InterSystems SQL支持几个特性来优化InterSystems IRIS®数据平台的SQL性能。 # 表定义优化 SQL性能从根本上取决于良好的数据架构。 将数据划分为多个表并在这些表之间建立关系对于高效的SQL是必不可少的。 描述了以下优化表定义的操作。 这些操作要求定义表，但不要求用数据填充表: - 数据存储策略：可以选择使用`%Storage.Persistent`、`%Storage.SQL`或自定义存储来存储数据。 - 全局变量命名策略：可以使用`USEEXTENTSET`参数为数据和索引查找操作指定更短、更高效的散列全局名称。 - 索引：可以为一个表字段或一组字段定义索引。可以定义几种不同类型的索引：标准索引、位图索引、位图索引和位图范围索引。SQL优化使用定义的索引而不是数据值本身来访问查询、更新或删除操作的特定记录。 # 表数据优化 根据对表中典型数据的分析，可以执行以下操作来优化表访问： - Tune Table：检查典型的表数据并生成`ExtentSize`(行数)、选择性(具有特定值的行的百分比)和`BlockCount`元数据。查询优化器使用此信息来确定最有效的查询执行计划。 - 选择性和异常值选择性：确定某个字段具有特定值的行的百分比，以及某个值是否为异常值，该值明显比该字段的其他值更常见。 # 查询优化 **在几乎所有情况下，用嵌入式SQL编写的查询的执行速度都比用动态SQL编写的查询快。还要注意，由于存在缓存查询，对于嵌入式SQL和动态SQL，重新执行查询的速度都比初始执行快得多。** 可以执行以下操作来优化特定查询的执行。这些查询优化使用现有的表定义和表数据优化： - 运行时统计：用于衡量系统上查询执行的性能。 - 显示计划显示查询的执行计划。 - 缓存查询和文字替换：维护最近动态查询的缓存，允许重新执行查询，而不会重复准备查询的开销。 - SQL语句和冻结计划允许保留查询执行计划，从而允许在不降低现有查询性能的情况下更改表。 - 索引配置和使用：用于指定如何使用现有索引。 - 索引优化提示：`%ALLINDEX`、`%IGNOREINDEX` - 联接优化提示：`%FIRSTTABLE`、`%FULL`、`%INORDER`、`%STARTTABLE` - 子查询优化提示：`%NOFLATTEN`、`%NOMERGE`、`%NOREDUCE`、`%NOSVSO` - 并行查询执行：`%Parallel` - 联合优化： `UNION %PARALLEL`, `UNION/OR` 还可以通过使用数据分片来提高对大型数据库表的查询性能。 # 配置优化 默认情况下，内存和启动设置默认为自动配置，每个进程的最大内存默认为262144 kb。要优化在生产系统上运行的SQL，应该将默认值更改为手动配置，并增加每进程的最大内存设置。 # 分片 分片是跨多个系统对数据及其关联缓存进行分区。分片集群跨多个InterSystems IRIS实例(称为碎片数据服务器)水平(即按行)对大型数据库表进行分区，同时允许应用程序通过单个实例(称为碎片主数据服务器)透明地访问这些表。 必须将表定义为分片。分片表只能在分片环境中使用；非分片表可以在分片或非分片环境中使用。并不是所有的表都适合进行分片。分片环境中的最佳性能通常是通过组合使用分片表(通常非常大的表)和非分片表来实现的 # 快速命令 InterSystems SQL支持快速选择、快速插入和快速截断表。“快速”意味着这些SQL命令的标准调用是使用高效的内部代码执行的。这些快速操作“就是工作”；没有使用特殊语法，也没有提供优化选项。 通过ODBC或JDBC的`SELECT`查询支持快速选择。JDBC上的插入操作支持快速插入。对于不涉及参照完整性的截断表操作，支持快速截断表。 并不是所有的表都支持快速操作，也不是所有的命令语法都可以使用快速执行来执行。InterSystems SQL在可能的情况下执行快速执行；如果无法执行快速执行，InterSystems SQL将执行指定命令的标准执行。