能量管理系统应用程序接口emsapi+第407部分时间序列数据访问tsda.pdf

i c s2 7 1 0 0 f 2 0 备案号：2 9 0 4 6 2 0 1 0 口l 中华人民共和国电力行业标准 d l t8 9 0 4 0 7 2 0 1 0 i e c6 1 9 7 0 4 0 7 ：2 0 0 7 能量管理系统应用程序接口( e m s a p i ) 第4 0 7 部分：时间序列数据访问( t s d a ) e n e r g ym a n a g e m e n ts y s t e ma p p l i c a t i o np r o g r a mi n t e r f a c e ( e m s - a p i ) - - p a r t4 0 7 ：t i m es e r i e sd a t aa c c e s s ( t s d a ) 2 0 10 0 5 2 4 发布 ( i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 ，i d t ) 2 0 1 0 1 0 一0 1 实施 国家能源局发布 d l ，t8 9 0 4 0 7 2 0 1 0 m c6 1 9 7 0 - 4 0 7 ：2 0 0 7 目次 前言- i i 引言i 1 范围l 2 规范性引用文件- 1 3 术语、定义和标识约定一2 4c i s 规范- ”2 d l ，t 8 9 0 4 0 7 2 0 1 0 皿c6 1 9 7 0 - 4 0 7 ：2 0 0 7 刖舌 d l8 9 0 是采用i e c6 1 9 7 0 能量管理系统应用程序接口( e m s a p i ) 制定的，主要包括 公共信息模型( c i m ) 和组件接口规范( c i s ) 两方面内容，由以下部分组成： d l t8 9 0 1 能量管理系统应用程序接口( e m s a p i ) 第1 部分：导则和一般要求； d l z8 9 0 2 能量管理系统应用程序接口( e m s - a p i ) 第2 部分：术语 d e f t8 9 0 3 0 1 能量管理系统应用程序接口( e m s - a p i ) 第3 0 1 部分：公共信息模型( c i m ) 基础： d t , t8 9 0 3 0 2 能量管理系统应用程序接口( e m s a p i ) 第3 0 2 部分：公共信息模型( c 1 m ) 财 务、能量计划和备用； d i j z8 9 0 4 0 1 能量管理系统应用程序接口( e m s a p i ) 第4 0 1 部分：组件接口规范( c i s ) 框架； d l t8 9 0 4 0 2 能量管理系统应用程序接口( e m s a p i ) 第4 0 2 部分：组件接口规范( c i s ) 公 共服务： d l t8 9 0 4 0 3 能量管理系统应用程序接口( e m s - a p i ) 第4 0 3 部分：组件接口规范( c i s ) 通 用数据访问； d l t8 9 0 4 0 4 能量管理系统应用程序接口( e m s a p i ) 第4 0 4 部分：组件接口规范( c i s ) 高 速数据访问： d l t8 9 0 4 0 5 能量管理系统应用程序接口( e m s - a p i ) 第4 0 5 部分：组件接口规范( c i s ) 通 用事件和订阅； d i j t8 9 0 4 0 7 能量管理系统应用程序接口( e m s a p i ) 第4 0 7 部分：组件接口规范( c i s ) 时 间序列数据访问： d i j t8 9 0 4 5 3 能量管理系统应用程序接口( e m s a p i ) 第4 5 3 部分：组件接口规范( c i s ) 基 于c i m 的图形交换 d l t8 9 0 5 0 1 能量管理系统应用程序接口( e m s a p i ) 第5 0 1 部分：组件接口规范( c i s ) 公 共信息模型的资源描述框架( c 1 mr i ) f ) 模式。 本部分等同采用i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 能量管理系统应用程序接口( e m s a p i ) 第4 0 7 部分： 时间序列数据访问( t s d a ) ( 英文版) 。 本部分由中国电力企业联合会提出。 本部分由全国电力系统管理及其信息交换标准化技术委员会归口。 本部分起草单位：中国电力科学研究院、国网电力科学研究院、国家电网调度中心、烟台东方电 子信息产业股份有限公司。 本部分主要起草人：潘毅、曹阳、李毅松、李晓露。 本部分在执行过程中的意见或建议反馈至中国电力企业联合会标准化中心( 北京市自广路二条1 号，1 0 0 7 6 1 ) 。 引言 d l ，t8 9 0 4 0 7 2 0 1 0 砸c6 1 9 7 0 - 4 0 7 ：2 0 0 7 本部分是定义能量管理系统( e m s ) 应用程序接口( a p i ) 的d l8 9 0 标准的一部分。d l8 9 0 4 和d l8 9 0 5 x 包含组件接口规范( c i s ) 。d l8 9 0 4 xxc i s 被规定为平台无关模型( p i m ) ，即 独立于用来实现它们的底层技术。p i m 规范也称为第l 级规范。d l8 9 0 5x c i s 则被规定为平台 相关模型( p s m ) 。p s m 规范也称为第2 级规范。 d l8 9 0 4 xxc i s 规定了接口的功能需求，组件( 或应用) 必须实现这些接口，从而能够以标准 的方式与其他组件交换数据和访问公用数据。这些组件接口描述那些能够用来实现这一目的的特定事 件类型和消息内容。 本部分规定了在分布式环境下的时间序列数据的高效传输接口。不仅可以很短的延迟传输少量数 据，而且可在短时间内传输大量数据，但延迟可能较长。同时支持时间序列数据的回放功能。这是作 为为其他子系统提供实时数据的监控与数据采集( s c a d a ) 系统的典型需求。除了s c a d a 系统，其 他系统也会受益于t s d a 的特性，t s d a 非常适合于短延迟和大容量数据传输的要求。 这些组件接口规范引用了d l8 9 0 3 xx ( 包括d l t8 9 0 3 0 1 ) 中定义的电力系统领域实体对象。 i i i d l ，t8 9 0 4 0 7 2 0 1 0 ，m c6 1 9 7 0 - 4 0 7 ：2 0 0 7 能量管理系统应用程序接口( e m s - a p i ) 第4 0 7 部分：时间序列数据访问( t s d a ) 1 范围 本部分规定了高效数据交换使用的通用接口，考虑了提供高效数据交换的局域网( l a n ) 以及跨 越局域网引起的时延。 本部分源自对象管理组织( o m g ) 中工业系统历史数据访问( h d a i s ) 规范。o m g - i d a i s 依托 于o m g 数据访问设施( d a f ) 和o p c 历史数据访问( h d a ) 规范。o m gh d a i s 是用c o r b a 作为 平台的平台相关模型( p s m ) ，o p ch d a 是用微软c o m 作为平台的p s m 。本部分以技术无关的方式 描述了这些p s m 的功能 也就是作为平台无关模型( p i m ) 。因此它对这些功能的解释可用于创建 附加的p s m 或作为现有p s m 的入门介绍，即h d a i s 和o p ch d a 。需要了解o m gh d a i s 和o p c h d a 的人员应该阅读这些文件。 t s d a 接口的目标是要与基于d l8 9 0 的其他接口实现互操作。因此有可能使用从其他接口取回的 信息，通过这个接口来访问同样的信息，例如： 对象标识符； 属性名或标识符； 类名或标识符。 4 6 条给出了c i m 类和属性的一般映射。 在实现t s d a 接口的服务器上，数据组织方式可用数据和元数据浏览接口查看。如果客户端事先 知道对象、类或属性的标识符，还可直接用数据访问接口而不用浏览接口查看。对象标识符可通过其 他接口获得，例如c i m x m l 文件或d l , t8 9 0 4 0 4 中的接口。d l8 9 0 4 5 x 中将描述哪些类和属性是可 用的，如s c a d a 历史数据、历史状态估计结果等。 d l t8 9 0 i 提供了e m s a p i 参考模型，本部分是基于该模型而建立的。在参考模型中介绍了技术 规范中使用的术语并解释了c i s 的任务。 d l z8 9 0 4 0 1 描述了c i s ( d l8 9 0 4 x ) 标准的概述和框架。 d l t8 9 0 4 0 7 与特定技术实现或p s m 的映射将在一个单独的技术文件里描述，也就是后续的d l 8 9 0 5 。实际的实现将使用后续的d l8 9 0 5 、o m g h d a i s 、o m g d a f 或o p c h d a 。 2 规范性引用文件 下列文件中的条款通过本部分的引用而成为本部分的条款。凡是注日期的引用文件，其随后所有 的修改单( 不包括勘误的内容) 或修订版均不适用于本部分，然而，鼓励根据本部分达成协议的各方 研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。 d l t8 9 0 1 能量管理系统应用程序接口( e m s - a p i ) 第1 部分：导则和一般要求( i e c6 1 9 7 0 1 ：2 0 0 5 ，i d t ) d l z8 9 0 2 能量管理系统应用程序接口( e m s a p i ) 第2 部分：术语( i e c6 1 9 7 0 2t s ：2 0 0 4 ， i d t ) d l t8 9 0 3 0 1 能量管理系统应用程序接口( e m s a p i ) 第3 0 1 部分：公共信息模型( c 1 m ) 基 础( i e c 6 1 9 7 0 3 0 1 ：2 0 0 3 ，i d t ) d l z8 9 0 4 0 1 能量管理系统应用程序接口( e m s - a p i ) 第4 0 1 部分：组件接口规范( c i s ) 框架 d l ，t8 9 0 4 0 7 2 0 1 0 i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 ( i e c6 1 9 7 0 - 4 0 1t s ：2 0 0 5 ，i d t ) d l f r8 9 0 4 0 2 能量管理系统应用程序接口( e m s a p i ) 第4 0 2 部分：组件接口规范( c i s ) 公 共服务( i e c6 1 9 7 0 4 0 2 ，i d t ) 工业系统历史数据访问( 皿a i s ) ，o m g 采用的规范，版本1 0 ，d t c 2 0 0 3 0 2 0 l ( 简称“o m g h d a i s ”) 公用事业管理系统( u m s ) 数据访问设施( d a f ) ，o m g 采用的规范，版本2 0 ，正式2 0 0 2 1 1 0 8 ( 简称“o m g d a f ”) 工业系统数据采集( d a i s ) ，o m g 采用的规范，版本1 0 ，正式2 0 0 2 1 1 0 7 ( 简称“o m g d a i s ”) o p c 历史数据访问定制接口规范，版本1 2 0 ，o p c 基金会，2 0 0 3 1 2 ( 简称“o p ch d a ”) 3 术语、定义和标识约定 3 1 术语和定义 d l z8 9 0 2 中的术语和定义适用于本部分。 3 2 标识约定 本部分中用于唯一标识u m l 属性的约定是类名和属性名之间用点连接，如“n o d e ”类中的属性 “i d ”将被命名为“n o d e i d ”。对于子结构中的属性，可用多重属性名表示，如“i t e m i d n o d ei d ”，其 中“n o d ei d ”是结构“i t e m i d ”的一部分。 4c i s 规范 4 1 背景( 资料性) 由于历史的原因，不同工业过程的控制系统有不同的发展路线。电力系统的控制系统是基于u n i x 发展的，而其他工业过程的控制系统大多是基于w i n d o w s 发展的。对于基于w i n d o w s 的控制系统， o p c 已成为主导标准。对于基于u n i x 的系统，在公共对象请求代理体系结构( c o i t i a ) 接口定义语 言( i d l ) 中定义的d a i s h d a i sa p i 已经形成。d a i s h d a i s 是建立在o p c 基础上的，这样可得益 于o p c 的成功，而且能够很容易地桥接到o p c 。为此目的，对象管理组织( o m g ) 从1 9 9 7 年起开 始致力于开发与o p c 功能相同的基于c o r b a 的接口。t s d a 以技术中立的方式描述了o m gh d a i s 和o p ch d a 中的功能，因此t s d a 意图成为一个平台无关模型( p 1 m ) 。 4 2 历史库用例( 资料性) 历史库或企业数据仓库( u d w ) 是企业运行系统中的重要组件。它充当了过去或未来时间序列数 据的仓库。u d w 可作为客户端组件的服务器。这样的系统一般具备如下组成部分： 过程仪器，使传感器数据和执行能力可用。 远程终端设备( r t u ) 或变电站控制系统，用于读传感器数据并进行控制。 用于连接r t u 或变电站控制系统的过程通信单元。远程通信一般通过专门的r t u 协议( 如 i e c6 0 8 7 0 5 远动设备及系统第5 部分：传输规约) 或现场总线协议解决。d l t8 6 0 变电站通信网络和系统是变电站间和变电站内部通信的一种新标准。本规范中定义的接口 可作为一个标准的a p i ，用于封装客户端的通信解决方案。 s c a d a 子系统，使经过处理的传感器数据和各种控制能力对运行人员、应用或其他系统有 效。 基于模型的管理系统，如能量管理系统( e m s ) ，使用s c a d a 子系统来扩展各种处理和控 制。 图形用户界面( g u i ) 。 用于存储时间序列数据的u d w 。 2 控制系统结构如图1 所示。 通过 h s n a p i 的 矗据藏量 d l ，t8 9 0 ，4 0 7 2 0 1 0 ，i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 新蠡据计算 图1 控制系统结构 图2t s d a 的服务器和客户端 u d w 以及可能使用它的客户端如图2 所示。 数据源，记录的数据有s c a d a 记录的实时数据，e m s 记录的计算结果或g u l 记录的人工输 入数据等。 过程通信单元，用于提供来自远方数据源的时间序列数据。 客户端，如一个g u i ，获取数据用于发掘、展示和更新修正。 客户端，如分析程序，获取数据用于分析或作为计算的输入。 u d w 一般还包含一些计算功能，用于从已存储的时间序列数据产生新的结果。 t s d a 支持订阅和读，写操作。订阅的概念如图3 所示。 d l ，t8 9 0 4 0 7 2 0 1 0 i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 t 立订阅 客户 lf l 晨务墨或t 据提供者 图3 数据订阅 通过回调 传t 据 订阅包括用于发布数据的服务器和订阅了接收数据的客户端。服务器预先不知道它的客户端。只有当 客户端建立订阅后，服务器才知道。订阅一旦建立，服务器会在数据可用或已更新时回调客户端。 4 3 数据模型 t s d a 数据模型描述了通过t s d a 接口所看到的数据在服务器内部是如何组织的。服务器的实现 可用不同的方式组织数据，客户端用t s d a 看到的数据模型如图4 所示。 4 + a g s z e $ a t e d _ t y p e s 图4t s d a 数据模型 模型中定义了以下对象： _ 1 咖：描述具有相同时间序列特性( 如数值或数值的计算之间的时间间隔) 的对象。因此， t s d at y p e 与h s d at y p e 有区别。h s d at y p e 主要是描述在d i t8 9 0 3 0 1 中定义的类型， d l ，t8 9 0 4 0 7 2 0 1 0 i r e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 而t s d at y p e 在d l t8 9 0 3 0 1 中没有对应的描述。但是，t s d at y p e 通常可参考h s d a t y p e 。 一一p r o p e n y ：描述作为时间序列记录下来的项( i t e m ) 。t s d ap r o p e r t y 通常可参考h s d a p r o p e r t y 。一个t y p e 可有任意多个p r o p e r t y 。 - - i t e m a t t r i b u t e d e f i n i t i o n ：描述特定于时间序列数据的i t e m a t t r i b u t e 。i t e m a t t r i b u t e d e f i n i t i o n 在 描述时间序列数据上与p r o p e r t y 类似，不同的是其数据特定于某时间序列。一个t y p e 通常有 几个i t e m a t t r i b u t e d e f i n i t i o n 。 i t e m a t 晡b u t c ：描述在t s d a 服务器中，项是怎样处理的，也就是说，对i t e m 时间序列而 言，它是元数据。因此，i t e m a t t r i b u t e 不能用h s d a 访问。由于i t e m a t t r i b u t e 可能随时变 化，它本身就是时间序列，即i t e m a t t r i b u t e v a l u e 。 n o d e ：是具有一个或多个项的对象，这些项以时间序列记录。一个t s d an o d e 一般都有一个 对应的h s d an o d e 。 i t e m ：是具有时间序列的对象，即i t e m v a l u e 。一个i t e m 有多个描述时间序列的i t e m a t t r i b u t e 。 i t e m v a l u e ：是有时标和质量码的值。i t e m 有一个由i t e m v a l u e 组成的时间序列。 - - - - m o d i f i e d r e m v a l u e ：是对i t e m v a l u e 所做的修改。由于不允许改变i t e m v a l u e ，就用 m o d i f i e d l t e m v a l u e 记录i t e m v a l u e 的修改。 a n n o f a d o n ：是可加到i t e m v a l u e 的注释文本。 - a g g r e g a t e d e f i n i t i o n ：描述对时间序列数据进行的计算，如平均值、最大值等。 下列u m l 属性和引用都与标识有关： t y p e i d 、p r o p e r t y i d 、n o d e i d 、i t e m a t t r i b u t e d e f i n i t i o n i d 和a g g r e g a t e d e f i n i t i o n i d 是类型为i d 的系统唯一标识码。i d 类型是字符串或数字，其范围足以支持全局唯一的标识符。但是，并 不要求i d 是全局唯一的。i d 将给机器使用。 类型为i t e m l d 的i t e mi d 是系统唯一的i t e m 标识符，包括指向n o d e 的i t e m l d n o d ei d 和指向 p r o p e r t y 的i t e m i d p r o p e r t y 。 将给机器使用。i d i t e mi d 一一t y p e 1 a b e l 、p r o p e r t y 1 a b e l 、n o d e 1 a b e l 、i t e m a t t r i b u t e d e f i n i t i o n 1 a b e l 和a g g r e g a t ed e f i n i t i o n 1 a b e l 是人的可读的名字。t y p e 1 a b e l 或p r o p e r t y 1 a b e l 是t y p e 或p r o p e r t y 的唯一标识。 n o d e 1 a b e l 只在相同父节点下的子节点中是唯一的。标签( 1 a b e l ) 将给人使用。 - n o d e p a t h n a r n e 是系统内的唯一的名字。它包含从节点到根的所有标签。此概念和文件路径相 同。n o d e p a t h n a m e 的确切形式与平台和实现相关。但是，建议实施中尽可能使用已有的标 准，如w 3 c 的x p a t h 。路径名( p a t h n a m e ) 将给人使用。 一一i t e m p a t h n a m e 是系统内的唯一的名字。它包含从节点到根的所有名字，并以描述i t e m 的 p r o p e r t y 的p r o p e r t y 1 a b e l 结束。i t e m p a t h n a m e 的确切格式与平台和实现相关。但建议实现中 尽可能使用已有的标准，如w 3 c 的x p a t h 。路径名将给人使用。 下列u m l 引用与关联有关： t y p e a g g r e g a t e d _ t y p e s 列举了节点的类型的i d ，这些节点可能是该类型的节点的子节点。它 用于限制节点层次中哪些节点类型可作为子节点出现，例如，如类型s u b s t a t i o n 的n o d e 可包含 类型为b a y 或m e a s u r e m e n t 的n o d e ，t y p e a g g r e g a t e d _ t y p e s 就列举出b a y 和m e a s u r e m e n t 。 _ p r o p e r t y t y p e d 指向p r o p e r t y 所属的t y p e 。它实现p r o p e r t y t y p e 的引用。 - n o d e t y p ei d 是n o d e 具有的t y p e 的t y p e i d 。 n o d c p a r e n t指向一个父节点。如果父节点存在的话。它会建立一个节点的层次结构，作为id 由标签到根节点生成路径名的基础。 i t e i i l i d n o d ei d 指向i t e r m 所属的n o d e 。 i t e m i d p r o p e r t y 指向表示的。id i t e m p r o p e r t y d l ，t 8 9 0 4 0 7 2 0 1 0 i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 i t e m t i m es e r i e s 是表示实际时间序列的i t c m v a l u e s 的一个序列。 i t e m v a l u e m o d i t i c a t i o i l 保存对i t e m v a l u e 的可能的修改。 i t c l n v a l u e a n n o t a t i o n 保存对i t e m v a l u e 的可能的注释。 i t c m a t t r i b u t c i t e mi d 和i t e m a t t r i b u t e d e f i n i t i o n 指向一个i t e m 和一个i t e m a t t r i b u t e d e f i n i t i o n 。 t c m a t 啊b u t e t i m es e r i e s 是表示实际时间序列的i t e m a t t r i b u t e v a l u e s 的一个序列。 以下u m l 属性用于存储数据： p r o p e r t y d a t a描述 的数据类型，如字符串、数字、布尔型等。 _ t y p e itemvalu描e-ttemattributedefinitiondata述 的数据类型，如字符串、数字、布尔t y p e i t e m a t t r i b u t e v a l u e 型等。 i t e m v a l u e v a l u e 是数据类型p r o p e r t y d a t a 的值。数据类型 不能分解成子类型的任t y p es i m p l e 意类型，例如数字、字符串或布尔型类型。 i t c m v a l u e q u a l i t y 是i t e m v a l u e v a l u e 的质量( q u a l i t y ) 码。质量码表示i t e m v a l u e v a l u e 是否有 效，并在无效时给出i t e m v a l u e v a l u e 无效的原因。质量码默认为“g o o d ”，即如果 i t e m v a l u e v a l u e 没有特殊的质量码，那么通过h s d a 接口看到的就是“g o o d ”。有很多规范 定义了质量码，如r t u 协议、i c c p 、e l c o m 、o p cd a 、o m gd a i sd a 等。本部分没 有规定统一的质量码系统，但沿用o m gd a i sd a 中定义的质量码。 i t e m v a l u e t i m es t a m p 是i t e m v a l u e v a l u e 最后一次更新的时间。如果没有给i t e r n v a l u e v a l u e 分 派时间，i t e m t i m e就是未指定的。如可用，对配置参数而言， 填写或_stamp i t e m v a l u e v a l u e 更新的时间就可当作i t e m v a l u e t i m es t a m p 。 l 搬n a 嘶b u t e v a l u e v a l u e 是数据类型i t e m a t t d b u t e d e f i n i t i o n d a t a 的值。数据类型types i m p l e 不能分解成子类型的任意类型，例如数字、字符串或布尔型。 i t e m a t 仃i b i n e v a l u e t i m es t a m p 与i t a m v a l u e t i m e 相同。stamp 4 4 消息( 规范性) 服务器和客户端( 双向) 之间的时间序列消息的有效载荷包括： a ) i t e m 标识，用于唯一标识服务器内的i t e m ( 见图4 中的i t e m i d ) 。 b ) 带时标的数值，每个数值包括： 数据值( 见图4 中的i t e m v a l u e v a l u e ) 。 数据值的质量( 见图4 中的i t e m v a l u e q u a l i t y ) ，即这个值是否可信。如果这个值是坏的，也 要表明坏的原因。默认的质量码是“g o o d ”，即这个值是有效的。 时标( 见图4 中的h e m v a l u e t i m es t a m p ) 表示项过去的值是什么时候记录的，或未来值的计 划记录时间。 如果一个带时标的数值将要替换已存在的数值，从客户端到服务器的消息也可包括附加信息，即 m o d i f i e d l t e m v a l u e 将被创建。 4 5 接口( 规范性) 4 5 1 对象和接口 t s d a 的接口、对象和它们之间的关系如图5 所示。 图5 ，给出了一个t s d a 服务器和客户端实现的对象和接口。图5 用u m l 符号表示，其中接口用 小圆圈带一条指向实现此接口的类的线段显示。接口的名称以大写字母“i ”开头。 t s d a 接口分为以下几组： 浏览接口，用于发现数据。浏览接口位于浏览( b r o w s e ) 对象中。 数据访问接口，用于实际访问数据。数据访问接口位于会话( s e s s i o n ) 对象中。 管理接口，用于管理服务器和客户端之间的连接。 回调接口，用于服务器给客户端发送数据。 6 d l ，t8 9 0 4 0 7 2 0 1 0 ，m c6 1 9 7 0 - 4 0 7 ：2 0 0 7 作为数据宿主的服务器内部数据对象的配置不在本文档的范围内。 s e r v e r 是用于实现i s e r v e r 接口的对象而且可被任意数量的客户端使用。s e r v e r 对象有很多s e s s i o n 对象。值得注意的是s e r v e r 和s e s s i o n 对象可像在o p ch d a 中那样组合成一个对象。 s e s s i o n 对象有以下一些接口： s e s s i o n 用于管理会话。 i c o e 嘶0 n 用于管理客户端和服务器之间的连接。 _ a l u e i o 用于访问i t e m 的时间序列数据。在接口中，如果有修改，则原有的数值将被覆盖。 _ i m o d i f i e d v a l u e i o 用于读取修改前的i t e m v a l u e s 。 i m a t 岫b u t c i o 用于访问i t e m a t t r i b u t e 的时间序列数据。 - - i a n n o t a t i o n i o 用于访问i t e m v a l u e 的注释。 1 p l a y b a c k 用于回放仿真时间内记录的数据。 图5t s d a 的接口、对象和它们之间的关系 s e s s i o n 对象也可拥有具有以下接口的b r o w s e r 对象： i t y p e 浏览接口，用于找到t s d a 服务器实现的n o d e 数据对象的元数据。 i p m p e r t y 浏览接口，用于找到t s d a 服务器实现的i t e m 数据对象的元数据。 7 d l ，t8 9 0 4 0 7 2 0 1 0 i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 o d c 浏览接口，用于找到t s d a 服务器中已经实例化的n o d e 数据对象。 - i m 浏览接口，用于找到n o d e 对象中存在的i t e m s 。 t e m a t 嘶h l t e 浏览接口，用于找到描述i t e m a t t r i b u t e v a l u e s 时间序列数据的i t e m a t t r i b u t e d e f i n i t i o n s 。 i a g g g a t e 浏览接口，用于得到已存在的a g g r e g a t e d e f i n i t i o n s a c a l l b a c k 对象实现i c a l l b a c k 接口，是由客户端实现的。每个s e s s i o n 对象都可有一个相关的 c a l l b a c k 对象。一个客户端可创建任意数量的s e s s i o n 和相关的c a l l b a c k 对象。 d a 服务器和客户端之间的典型交互顺序如图6 所示。 服务器 图6t s d a 对象间的典型交互 典型情况下，客户端启动时先浏览服务器以找到哪些时间序列数据是可用的，浏览接口 ( i t y p e 、i p r o p e r t y 、i n o d e 、i i t e m 、i l t e m a t t r i b u t e 和i a g g r e g a t e ) 就用于此功能。客户端选择在浏 览时找到的i t e m s 子集，并保存起来备用。浏览用的客户端可以是显示框、对话框或数据库生成器 等编辑器。 然后在调用画面时，保存的i t e m 就可被客户端召唤并用于构成s e s s i o n 对象。生成s e s s i o n 对象 后，它就可用于数据的读写或订阅。订阅或异步读写在回调中调出结果。对于订阅来说，回调将持续 到客户端终止这些回调进程。 452s e r v e r 接口和s e s s i o n 接口 i s e r v e r 接口具有的属性和方法如下： 描述服务器状态的只读属性，如服务器的自身状态、启动时间、当前时间、厂商信息等。 r e a t eh i s m f i c md a t aa c c e s ss e s s i o n ( ) ，用于生成s e s s i o n 对象。 r e 咖h i s t o r i c a ld a t a a c c e s ss e s s i o nf o r y i e w ( ) ，用于生成s e s s i o n 对象。此方法可用于服务器 8 d l ，t8 9 0 4 0 7 2 0 1 0 ，i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 支持多层次结构的情况，每个层次结构对应一个视图。 f i n dm e w s ( ) ，返回服务器支持的视图。 表明接口所支持功能的只读属性。 表明服务器可返回的时间序列值( i t e m v a l u e s ) 最大数量的只读属性。 s e s s i o n 对象实现i t s d a s e s s i o n 接口，具有的属性和方法如下： 表明s e s s i o n 状态的只读状态属性，如名字、启动时间、当前时间和组数等。 含有可选择的s h u t d o w n 对象的属性。 c r c a t e) ，用于生成 对象。b r o w s e r ( b r o w s e 4 5 3 m a n a g e m e n t 接口 s e s s i o n 对象还实现了i c o r m e c t i o n 接口，具有以下属性和方法： 由客户端生成的回调( c a l l b a c k ) 对象的属性； r e a t e ( 1 ，用i t e m 构成s e s s i o n 的方法； r e m o v e ( ) ，从s e s s i o n 中删除i t e m 的方法； v a l i d a t e ( ) ，校验i t e m 是否存在的方法； c e l ( ) ，取消正在运行的异步调用的方法。 4 5 4b r o w s e 接口 浏览对象实现以下属性和接口： b r o w s eb a s e t i m e 属性，用于客户端建立浏览的基准时间。浏览接口用基准时间来定位当时定义的 对象。这对于获取过去存在的但已被删除的对象是很有用的，也意味着一个服务器应保持所删除的对 象的历史。如果不提供基准时间就用当前时间。 i t y p e 浏览接口； 1 p r o p e r t y 浏览接e l ； n o d e 浏览接口； 叫i t e m 浏览接口； _ i i t e m a t t r i b u t e 浏览接口； i a g g 嘲 目b 浏览接口。 1 n o d e 和i i t e m 接口有以下方法： f m d ( ) ，返回由i d 指定的一个n o d e 或i t e m 的更多信息； f i n de a c h ( ) ，返回由i d 指定的一些n o d e 或i t e m 的更多信息； f m t b ) ! p a r e n “) ，返回一个指定i d 的父亲下的所有儿子： f i n d y j y p e ( ) ，递归地返回一个指定i d 的父亲下的所有给定t y p e i d 的儿子； g e u a t l m m e s ( ) ，将i d 翻译成相应的路径名； g e ti d s ( ) ，将p a t h n a m e 翻译成i d 。 i t y p e 接口具有以下方法： f i n d ( ) ，返回由i d 指定的一个t y p e 的更多信息； f m d y s c h c m a ( ) ，返回一个给定i d 指定的一个模式所包含的所有类型的标识t y p e i d 。 i p r o p e r t y 接口具有以下方法： 硒d ( ) ，返回由i d 指定的一些p r o p e r t y 的更多信息； f i n t b y - n o d e ( ) ，返回一个指定i d 的n o d e 的所有p r o p e r t y ： f i n d b 咖e ( ) ，返回一个指定i d 的t y p e 的所有p r o p e r t y 。 i l t e m a t t r i b u t e 和i a g g r e g a t e 接口具有以下方法和数据： f l n d ( ) ，返回由i d 指定的一个对象的更多信息： f i n da l l ( ) ，返回所有对象的信息； 9 d l ，t8 9 0 4 0 7 2 0 1 0 ，i e c6 1 9 7 0 - 4 0 7 ：2 0 0 7 所有现存的对象标识( i t e m a t t r i b u t e 和a g g r e g a l ei d ) 的定义。 4 5 5i o 接口 i o 接口支持以下功能： 同步读和写； 异步读和写； 订阅； 回放。 i o 接口包括： a l u e i o ： i m o d i f i e d v a l u e i o ： i i t e m a t 仃i b u t e l 0 ： i a n n o t a t i o n i o ： i p l a y b a c k 。 i v a l u e i o 同步接口有以下方法： s ”c _ f d j a w ( ) ，用于同步读特定时间间隔内记录或更新的数据； - - s y n c _ r e a d _ p r o c e s s e d ( ) ，用于同步读特定时间间隔内使用累加计算的数据； s y l 】c _ r c a d - a u i m e ( ) ，用于同步读一系列指定的时间点的数据； s y l 】c j n s e r t ( ) ，用于同步插入新的时间序列数据值( 即i t e m v a l u e s ) ； s y i l c _ 唧l a c e ( ) ，用于同步替换已有的时间序列数据值( 即i t e m v a l u e s ) ； 唧n c _ i e r rr e p l a c e ( ) ，用于同步替换已有的时间序列数据值( 即i t e m v a l u e s ) ，或者如果数据 值不存在就插入新值； s ”q d e l e t e - r a w ( ) ，用于同步删除特定时间间隔内记录的数据； _ s y n c _ d e l e t e _ a t _ t i m e ( ) ，用于同步删除指定的时间点记录的数据。 i v a l u e i o 异步接口有以下方法： a s y n cr e a dm w ( ) ，用于异步读特定时间间隔内记录的数据。采用这种方法的回调接口是 o nr e a dc o m p l e t e ( ) 。 - - a s y n c r e a d _ p r o c e s s e d ( ) ，用于异步读特定时间间隔内使用累加计算的数据。 - - a s y n cr e a d _ a t _ t i m e ( ) ，用于异步读一系列指定的时间点的数据。采用这种方法的回调接口是 o nr e a dc o m p l e t e ( ) 。 a s y i l c j n s e r t ( ) ，用于异步插入新的时间序列数据值( 即i t e m v a l u e ) 。采用这种方法的回调接 口是o n _ u p d a t ec o m p l e t e ( ) 。 郴y n c r 印1 e ( ) ，用于异步替换已有的时间序列数据值( 即i t e m v a l u e ) 。采用这种方法的回 调接口是o n 、。_ u p d a t e ( ) c ，o m 用p l 于e t e 异( - - - - - a s y n ci n s e r t _ r e p l a c e 步替换己有的时间序列数据值( 即i t e m v a l u e ) ，或者如果值不 存在就新