中国电信通用Widget开放系统技术规范平台分册（上）

1、保密等级：公开发放 中国电信集团公司技术标准 q/ct 2187.2-2009 中国电信通用 widget 开放系统技术规范 平台分册 v1.0 2009-10-30 发布2009-10-30 实施 中国电信集团公司发布 q/ct 2187.2-2009中国电信通用 widget 开放系统技术规范 目 平台分册 录 目 前 1 2 3 录. i 言.iv 范围 . 1 规范性引用文件 . 1 名词术语和缩略语 . 2 3.1 3.2 3.3 术语. 2 缩略语. 3 约束. 3 4系统架构 . 3 4.1 4.2 4.3 uwop 在网络中的位置. 4 uwop 内部结构 . 5 uwop 接

2、口概述 . 6 5功能要求 . 7 5.1widget 引擎管理 . 7 5.1.1 5.1.2 版本管理. 7 下载与更新 . 8 5.2引擎插件管理. 8 5.2.1 5.2.2 5.2.3 编号管理. 8 版本管理. 8 下载与更新 . 9 5.3widget 应用管理 . 9 5.3.1 5.3.2 5.3.3 5.3.4 5.3.5 5.3.6 编号管理. 9 类别管理. 9 小图标管理 . 9 版本管理. 10 下载与更新 . 10 生命周期管理 . 10 5.3.7widget 评论 . 12 5.3.8widget 排名 . 12 5.3.9widget 搜索 . 12 5.3

3、.10widget 应用推荐 . 13 5.4终端管理 . 13 i 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 5.4.1 5.4.2 5.4.3 5.4.4 5.4.5 信息采集（可选）. 13 数据备份恢复（可选） . 14 故障诊断（可选）. 14 性能监控（可选）. 14 遗失管理（可选）. 14 5.5用户管理 . 14 5.5.1 5.5.2 5.5.3 5.5.4 5.5.5 总体要求. 14 权限分配. 15 终端用户管理 . 16 开发者管理 . 17 管理员管理 . 17 5.6 5.7 5.8 5.9 5.10 广告管理 . 1

4、7 应用开发环境. 18 业务代理 . 18 用户门户 . 19 安全 . 19 5.10.1认证 . 19 5.10.2鉴权 . 19 5.10.3数字签名. 19 5.10.4widget 分发控制（可选） . 20 5.11统计和业务清单. 23 5.11.1数据源. 23 5.11.2统计报表. 23 5.11.3业务清单. 24 6业务流程 . 24 6.1widget client 相关业务流程. 24 6.1.1widget 发现与下载. 24 6.1.2引擎插件下载 . 25 6.1.3widget 运行 . 26 6.1.4widget 引擎更新. 26 6.1.5widge

5、t 应用更新. 30 6.1.6终端管理. 32 6.2开发者管理流程. 32 6.2.1 6.2.2 考核 . 32 应用统计查询 . 32 6.3应用开发和调测流程 . 33 6.3.1应用开发与调测. 33 6.3.2widget 应用移植. 33 7性能要求 . 34 7.1 7.2 7.3 处理性能 . 34 稳定性要求 . 34 备份、倒换和故障恢复要求 . 34 ii 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 8软硬件要求. 34 8.1硬件要求 . 34 8.1.1 8.1.2 8.1.3 8.1.4 主机设备. 35 存储设备. 3

6、5 备份设备. 35 网络设备. 35 8.2软件要求 . 36 8.2.1 8.2.2 8.2.3 操作系统要求 . 36 应用软件要求 . 37 数据库. 37 8.3时间同步要求. 38 9环境要求 . 38 附录 a 接口规程 . 39 a-1 uws-1 接口规程. 39 a-1.1 消息定义. 39 a-1.2 widget 引擎自引导. 40 a-1.3 注册 . 42 a-1.4 登录 . 44 a-1.5 注销 . 45 a-1.7 引擎相关. 47 a-1.8 widget 应用相关 . 55 iii q/ct 2187.2-2009中国电信通用 widget 开放系统技术

7、规范 前 平台分册 言 本标准为中国电信通用 widget 开放系统系列技术规范之一，本系列规范包括： （1）中国电信通用 widget 开放系统技术规范 总册 （2）中国电信通用 widget 开放系统技术规范 平台分册 （3）中国电信通用 widget 开放系统技术规范 终端引擎及应用开发分册 （4）中国电信通用 widget 开放系统技术规范 ctc widget api 本标准主要依据中国电信集团公司的需求，结合中国电信企业技术标准的特点进行编 写，随着中国电信企业技术标准管理系统的发展完善，还将制定后续的相关标准。 本规范定义了中国电信通用 widget 开放平台技术要求，包括中国电

8、信通用 widget 开放 平台系统架构、功能要求、业务流程、接口要求、设备管理要求、性能要求、等。 本标准由中国电信集团公司提出并归口。 本标准起草单位：中国电信股份有限公司广州研究院。 本标准主要起草人：李慧云。 iv 平台分册q/ct 2187.2-2009 1 中国电信通用 widget 开放系统技术规范 1 范围 本规范适用于中国电信通用 widget 开放平台产品的设计及研发，提供给为中国电信开 发制造 widget 开放平台的设备供应商。本规范是中国电信各级运营单位进行 widget 开放平 台招标采购、工程设计、网络运营、管理、维护等方面的技术依据。 2规范性引用文件 下列文件

9、中的条款通过本企业技术标准的引用而成为本企业技术标准的条款。凡是注日 期的引用文件，其随后所有的修改单（不包括勘误的内容）或修改版均不适用于本标准，然 而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的 引用文件，其最新版本适用于本标准。 【1】widgets 1.0: the widget landscape (q1 2008). m. caceres. w3c working draft. 14 april 2008. 【2】widgets 1.0 requirements, m. caceres, ed. w3c, 23 march 2009 【3】widg

10、ets 1.0: packaging and configuration. m. caceres, ed. w3c working draft 22 december 2008 【4】widgets 1.0: apis and events. a. bersvendsen and m. caceres. forthcoming, 23 april 2009 【5】widgets 1.0: digital signature . m. caceres, ed. w3c, w3c working draft 14 april 2008 【6】widgets 1.0: updates . m. ca

11、ceres. w3c working draft 7 october 2008 【7】bondi 1.0 approved release. bondi interface requirements omtp 26th may 2009 【8】cascading style sheets, level 2, revision 1, b. bos, t. elik, i. hickson, and h. wium lie. w3c candidate recommendation 19 july 2007 【9】document object model (dom) level 1 specif

12、ication , l. wood et al., 1 october 1998. available at /tr/rec-dom-level-1 【10】ecmascript language specification , third edition. ecma, december 1999. available at /publications/standards/ecma-262.htm 【11】the application/json media type for ecmascript

13、object notation . d. crockford. july 2006. available at /rfc/rfc4627.txt 【12】the xmlhttprequest object . a. van kesteren. 2006. w3c working draft, available at /tr/xmlhttprequest/ 【13】.zip file format specification . pkware inc., september 2007. available at http:/

14、【14】 【15】 【16】 oma client provisioning v1.1 specifications, open mobile alliance oma device management v1.2 specifications, open mobile alliance oma dm software component management object (scomo) v1.0, open 平台分册q/ct 2187.2-2009中国电信通用 widget 开放系统技术规范 mobile alliance 【17】 【18】 【19】 oma dm diagnositcs

15、 and monitoring v1.0, open mobile alliance。 drm content format, oma-download-drmcf-v1_0, open mobile alliance drm rights expression language, oma-download-drmcf-v1_0, open mobile alliance 【20】digital rights management, oma-download-drm-v1_0, open mobile alliance 3 3.1 1) 名词术语和缩略语 术语 通用widget开放系统：核心构

16、件包括通用widget开放平台和通用widget终端引擎两部 分，提供一套完整的widget应用环境，可以适配多种终端平台，具有开放接口供第三方 参与widget开发。 系统“通用”是指： 多终端通用：终端适配pc、上网本、mid、手机终端； 多应用通用：兼容apple dashboard、sohu open widget、nokia wrt、jil应 用； 多品牌通用：考虑电信现有品牌业务需求，统一微件技术规范。 系统 “开放”是指： 开放规范打包格式、配置文件、api； 规范ide功能，提供给sp（含普通开发者）进行开发。 2) 3) 4) 5) 6) 7) 8) 通用widget开放平台

17、：通用widget开放平台是通用widget开放系统的服务器侧平台，提 供widget门户、引擎和widget管理、数字签名管理、应用开发环境、计费、网管等功能。 通用widget引擎：又称为widget用户代理，通用widget引擎是通用widget开放系统的终 端侧引擎，提供widget运行环境、api适配等功能，可适配多种终端平台，主要包括 windows、wm、linux等。 widget（微件）：是轻量级的应用程序，为使用者提供一键式的服务。它通常被设计为 具有特定的功能，如提供天气、股票、拍卖等的信息。一般意义上的widget包括网页 widget、桌面引擎widget，本规范中规

18、定的widget转指桌面引擎widget。 桌面引擎widget：基于终端引擎技术，运行于个人电脑或手机终端上，用户运行后始终 呈现在用户桌面上。 网页widget：基于浏览器技术，运行于网页上，用户浏览网页的时候运行，用户可以在 自己的个人网页上任意位置添加各种功能的widgets，丰富了网页的表现。 widget应用：widget应用从物理上看是一个文件包，widget引擎通过对于widget应用文 件包的解释执行形成一个widget应用，供最终用户使用。 widget应用包：用来描述一个widget应用展现形式和应用逻辑的文件包，可能包括配置 2 缩略语英文全名中文全名 uwosuniv

19、ersal widget open system 通用 widget 开放系统 uwopuniversal widget open platform 通用 widget 开放平台 uweuniversal widget engine 通用 widget 引擎 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 3 文件、界面展示文件、资源文件、应用逻辑文件等文件。 9)widget管理器：widget应用的入口和管理界面，widget管理器启动后运行在用户桌面之 上，用户可以通过widget管理器方便的管理自己下载的widget应用，widget应用可以运 行

20、于管理器中，或者独立运行于用户桌面上。 10) 图标：代表一个widget应用的图片或符号，图标通常用来代表在容器中处于非焦点状态 的widget应用，图标可以动态展现widget应用的状态。例如，天气widget应用可能会随 着天气或时间的变化更新它的图标。 11) 资源：一个widget应用使用的任何文件或目录都或者被放在一个widget的资源里或者可 通过http协议获取 。在widget的资源中，资源可能被放在本地目录中。资源可能包括 图片，文字，标记，样式表，可执行脚本和声音。 12) 启动文件：每个widget应用都包括一个配置文件，widget引擎可以通过该配置文件启动。 13)

21、 配置文档：配置文件也可以定义widget中的资源之间的关系。配置文件通常采取的形式 是一个xml文件。 14) 元数据：数据表明在配置文件涉及著作权或分类的一个widget，但并不影响widget在运 行时的行为（如作者的姓名和电子邮件） 15) 引导：一种机制，通过配置文件指定或自动查找文件中启动widget应用widget。 16) widgetapi：一套编程接口，为开发者提供widget应用的开发接口。 3.2 3.3 缩略语 约束 下述需求约束适用于中国电信通用 widget 开放系统规范体系所涉及的所有文档。 1) 2) 4 本规范中如无特别说明，widget专指桌面引擎widg

22、et。 网页widget不属于规范规定范围。 系统架构 平台分册q/ct 2187.2-2009中国电信通用 widget 开放系统技术规范 4.1 uwop 在网络中的位置 通用widget开放平台 uwop widget clientweb门户 综合业务管理平台 ismp 互联网sp/cp业务 综合业务接入网关 isag 电信其他业务平台 平台 电信sp/cp业务平台 图 4.1 网络系统架构图 1) 2) 3) 4) 通用 widget 开放平台（uwop）：uwop 是 widget 开放系统的服务器平台，提供 widget 引擎、widget 应用的管理，并为第三方开发人员提供 sd

23、k、模拟器等应用 开发环境，通过审批测试的 widget 应用可发布到 widget 开放平台上，供用户下 载。 widget 客户端（widget client）：widget 引擎与运行于之上的 widget 应用称为 widget 客户端，可运行在 pc 桌面和移动终端上，为用户提供各种 widget 应用体 验。 web 门户：web 门户是面向用户的网元，为用户提供了业务展现与管理入口。根 据用户的类型包括终端用户门户、自由开发者门户与运营商门户。 业务平台 a. b. c. 综合业务接入网关（isag）：包括 isag-m 和 isag-b，isag 是实现 cp/sp 业 务统一

24、接入的实体。提供服务质量监控、业务能力适配和封装等功能。其接入 的业务能力包括短信、彩信、wap、位置服务等。 电信其他业务平台：如号百平台的产品业务平台等。 互联网 sp/cp 业务平台：基于互联网的应用、业务平台，包括股票、新闻等 等。 5)管理平台 a. b. 综合业务管理平台（ismp）：ismp 提供业务网络统一管理、统一认证、统一 鉴权、统一计费、统一数据功能。 其他业务系统对应的管理系统。 4 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 4.2 uwop 内部结构 图 4-2 uwop 系统结构 通用 widget 开放平台包括五个部分，

25、分别是用户接入、管理子系统、业务代理子系统、 管理接口和业务接口。 用户接入部分提供了 widget、web 门户和通用 widget 开放平台之间的接口。widget 与通用开放平台的接口包括： 1) 2) 业务接入：通用 widget 开放平台的业务代理子系统提供的业务使用接口。 管理接入：通用 widget 开放平台的管理子系统提供的管理接口，包括用户登录、 用户认证、widget 引擎更新、widget 应用查询、下载与更新、客户端信息收集、 故障上报和故障恢复、数据备份、终端锁定等。 管理子系统是通用 widget 开放平台的核心部分。其与业务代理子系统在逻辑上独立， 可以分设在不同

26、物理实体上，也可以设置在同一物理实体上。主要包括业务运营、广告管理 与应用开放管理三大部分。其中业务运营包括了通用 widget 开放平台的主要业务管理部分， 包括 widget 引擎、widget 应用的管理，终端管理，终端用户管理，开发者管理和管理员管 理等等。应用开放管理部分维护业务开发的 sdk 和开发环境，提供开发包下载和在线、离 线模拟调测环境。 业务代理子系统是通用 widget 开放平台和业务平台之间的接口逻辑处理层，包括： 1)业务代理：完成接口逻辑处理与转换，将第三方业务平台提供的业务接口转换成 widget 平台对 widget 提供的接口。 5 中国电信通用 widge

27、t 开放系统技术规范平台分册q/ct 2187.2-2009 2) 3) 4) 业务数据同步：同步业务平台的相关数据，主要包括业务帐号、业务配置等。 业务清单生成：生成用户使用代理平台的详细清单 代理平台管理：对 widget 开放平台代理的所有业务平台进行管理，管理的信息包 通用widget开放平台 管理子系统 a1 括业务平台的描述、访问地址、端口、访问参数等等 在这四个逻辑模块中，业务代理模块针对于不同的业务平台分别设置，因此在平台中， 存在多个业务代理模块。 管理接口部分实现通用 widget 开放平台与其他管理平台之间的接口，包括维护监控接 口、统一认证接口和清单传送接口。 业务接口

28、部分实现通用 widget 开放平台与电信现有产品平台、业务能力系统、互联网 业务提供平台之间的接口。 4.3 uwop 接口概述 widget客户端 通用widget开放平台 业务代理子系统 a2 d1 b1 isag b2 电信 sp/cp 业务 平台 c1 ismp cn 电信其 他管理 平台 互联网sp/cp业 务平台 b3 电信其他业务平 台 bn 图 4-3 uwop 内部系统与周边系统之间的接口 1)widget 客户端与 widget 开放平台管理子系统的接口（a1）：完成对 widget 应用、 用户的认证鉴权与管理。包括： a) b) c) d) e) f) g) 通用 w

29、idget 开放平台服务列表与入口查询 用户注册 用户登录认证 widget 引擎更新 widget 查询、下载、评论、更新 配置信息下载、更新 widget 应用合法性认证等 2)widget 客户端与 widget 开放平台业务代理子系统的接口（a2）：widget 客户端使 用此接口调用业务平台的能力。业务代理子系统完成产品业务平台接口的代理与转 换。 6 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 3) 4) widget 开放平台业务代理子系统与业务平台的接口（b）：此接口遵循相应的业务 平台提供的业务调用接口，包括业务帐号认证、业务功能调用

30、、状态结果返回等等。 widget 开放平台管理子系统与管理平台的接口（c），包括： a) b) c) 用户登录认证接口：支持用户登录 widget 开放平台时，widget 开放平台向管 理平台（如 ismp）请求认证鉴权。 维护监控接口：widget 开放平台向管理平台提供系统的维护接口、系统运行 状态等等，便于管理平台的统一管理维护。 清单采集接口：支持 widget 开放平台发送用户的使用清单、业务清单到管理 平台。 5)widget 开放平台管理子系统与业务代理子系统的接口（d1），包括： 1) 2) 业务清单采集：管理子系统通过该接口完成客户使用业务能力或产品的业务清 单采集。 鉴

31、权：支持客户、用户使用能力时进行实时鉴权。 6) 5 管理平台和业务平台的接口：除了互联网独立的业务系统外，电信的业务能力系统 和 cp/sp 业务平台都有对应的管理平台来管理，主要提供能力开通、数据配置、 产品订购等功能。如 ismp 管理 isag 接入的业务能力和电信的 cp/sp 业务平台。 这些管理平台和业务平台之间的接口遵循相关的接口规范。 功能要求 5.1 widget 引擎管理 widget 引擎包括以下属性： 1) 2) 3) 基本信息：版本号、更新时间、安装包大小、下载地址、开发者信息、特征描述等 平台信息：适用于哪些终端平台，如 windows（xp/2000/vista

32、）、linux、window mobile 等等 能力列表：具备哪些能力，如网络相关能力、媒体处理调用能力等 widget 引擎配置文件应包括 widget 引擎启动以及与后台交互所必须的参数设置，包括： 1) 2) 连接参数：widget 引擎与通用 widget 开放平台交互必须的连接配置信息，例如通 用 widget 平台入口地址、端口，下载服务器入口地址、端口等。 运行参数：widget 引擎验证 widget 合法性以及处理后继业务请求所需要的配置信 息，例如 widget 发布证书、服务器密码（用来做对服务器的验证）、安全策略等 等 通用 widget 开放平台应对不同版本的 wi

33、dget 引擎以及引擎配置文件进行管理维护， 并支持 widget 引擎和引擎配置文件的上传、下载与更新。 5.1.1版本管理 widget 引擎安装包分版本管理。版本分为大版本和小版本，大版本为正式发布的版本， 小版本用于表示在某个大版本的基础上，widget 引擎的更新历史。小版本可以不是一个完 整的安装包，仅仅是在大版本基础上，发生变化的文件（可选，初期可考虑小版本也是完整 7 平台分册q/ct 2187.2-2009中国电信通用 widget 开放系统技术规范 的引擎安装包）。 1) 2) 3) 如果引擎的版本变更是由于 widget 开放平台引起，例如接口变化等。widget 开放

34、平台需要在一段时间内，同时支持新旧版本的 widget 引擎均可正常使用。支持旧 版本的时间可配置。 当旧版本的 widget 引擎不再被平台支持，平台需要通过强制更新流程促使用户进 行版本更新。 引擎配置文件是适用于所有的 widget 引擎的，平台只需要维护配置文件的一个最 新版本即可。 5.1.2下载与更新 widget 开放平台支持通过 web 门户或接口方式提供 widget 引擎安装包和配置文件的 下载。 1) 2) 3) 4) web 门户只提供不同终端平台最新的大版本的下载地址。小版本通过接口，在 widget 引擎的升级过程中进行下载。 widget 开放平台应支持配置文件和

35、引擎安装包打包下载：即用户在 web 门户下载 widget 引擎安装包时，平台能自动将引擎配置文件一起打包在下载包中。 widget 开放平台需提供 widget 引擎的版本查询接口，以支持客户端进行 widget 引擎的升级。 widget 开放平台只需支持由终端侧发起 widget 引擎更新的方式。 5.2 引擎插件管理 引擎插件是嵌入到引擎中的插件，实现一些特殊的功能，如 sip 协议栈、位置服务、imps 服务等等。引擎插件包括以下属性： 1) 2) 3) 基本信息：插件编号、插件名称、版本号、作者、功能概述、发布时间、最后更新 时间、安装大小、下载地址等。 引擎信息：适用于哪些版本

36、的插件引擎 功能信息：实现功能的情况，api 下载地址等等。 通用 widget 开放平台对不同版本的引擎插件进行管理： 1) 2) 支持引擎插件的上传、下载和版本更新。 同一个 widget 引擎可嵌入 0 个或多个引擎插件，同一个引擎插件可适用于多个版 本的 widget 引擎。widget 开放平台需要维护 widget 引擎和引擎插件的关联关系。 5.2.1编号管理 运营商审核引擎插件的发布申请后，为引擎插件分配 id。 1) 2) 要求系统能自动生成并分配引擎插件编号。 同时支持运营商操作员审核插件引擎发布申请时手工修改编号的功能，系统需要检 测该号码是否已用。审核一旦通过，则编号生

37、效，生效之后不可修改。 5.2.2版本管理 引擎插件安装包分版本管理。版本分为大版本和小版本，大版本为正式发布的版本，小 版本用于表示在某个大版本的基础上，引擎插件的更新历史。 8 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 5.2.3下载与更新 widget 开放平台支持以 web 门户和接口方式下载引擎插件安装包。 1) 2) 3) web 门户只提供最新的大版本的下载地址。小版本通过接口，在 widget 引擎的升 级过程中进行下载。 widget 开放平台需提供引擎插件的版本查询接口，以支持客户端进行引擎插件的 升级。 widget 开放平台只

38、需支持由终端侧发起引擎插件更新的方式。 5.3 widget 应用管理 widget 应用包括以下属性： 1) 2) 3) 4) 5) 基本信息：widget 编号、widget 名称、版本号、作者、widget 功能描述、发布时 间、最后更新时间、安装包大小、下载地址等；widget 标识唯一标识此 widget 应用。 引擎信息：适用于哪些版本的 widget 引擎 应用分类：属于何种应用，如小工具类（时钟、计算器）、信息类（如新闻、股票）、 通信类（如传真、通讯录）等等。 收费信息：是否收费，收费规则。 其他信息：用户评论、排名等等。 通用 widget 开放平台对不同 sp 发布的 w

39、idget 应用进行审批、上线、应用开通、下线、 下载统计、打分统计等；并对 widget 应用的版本、生命周期进行管理。可根据应用的情况， 对 widget 应用进行推荐。 5.3.1编号管理 运营商审核 widget 应用的发布申请后，为 widget 应用分配 id，此 id 的分配与引擎插 件的 id 分割开。 1) 2) 要求系统能自动生成并分配 widget 应用编号。 同时支持运营商操作员审核 widget 应用发布申请时手工修改编号的功能，系统需 要检测该号码是否已用。审核一旦通过，则编号生效，生效之后不可修改（可选）。 5.3.2类别管理 1) 2) 3) 4) widget

40、 应用类别的管理，供终端用户门户分类展示，如：新闻、音乐、影视、通 信、游戏、动漫、书吧、社区等，要求支持对 widget 应用类别的增加、修改、删 除、查询，并同步给门户。 widget 应用类别进行修改、删除时必须修改、删除已属于该类的 widget 应用的类 别信息。 widget 应用类别可按不同的纬度划分。 开发者发布 widget 应用时可以选择应用类别，一个 widget 应用在同一个纬度下 属于一个类别。 5.3.3小图标管理 开发者申请发布 widget 应用时可以提交供 web 门户和 widget 码头展现的小图片，通 过开发者自服务界面上载到通用 widget 开放平台

41、。 9 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 1) 2) 要求系统自动检验图片的文件名、大小和格式，如没有图片，要求门户展现默认图 片。 小图标由 ftp 接口同步到门户，由门户根据业务信息中携带的图标地址寻找相应的 图片。 5.3.4版本管理 widget 应用分版本管理。版本不分大小版本，均为正式发布的版本。要求系统对版本 的变化历史和最新版本的 widget 应用包进行存储和管理。 5.3.5下载与更新 widget 开放平台支持以 web 门户和接口方式下载 widget 应用包。 1) 2) widget 开放平台需提供 widget

42、应用的版本查询接口，以支持客户端进行 widget 应用的升级。 widget 开放平台只需支持由终端侧发起 widget 应用更新的方式。 5.3.6生命周期管理 本小节描述了 widget 应用通用的生命周期管理流程，如果 widget 应用通过其他平台 发布（如 ismp），遵循相应的产品生命周期管理流程。 生命周期管理包括两个要素：状态、状态的流转。 状态 widget 应用分别维护两类状态：基本状态、工作流状态。基本状态用于标识 widget 应用当前所处的状态，工作流状态用于标识 widget 应用基本状态流转流程中的工作流环节。 两者需同时起作用，共同标识 wid

43、get 应用的完整状态。 基本状态：包括未提交、申请、正常、预撤回、撤回。 1) 2) 3) 4) 5) 未提交：开发者完成 widget 应用开发，上传 widget 应用到平台，widget 应用处 于未提交状态。 申请：开发者提交 widget 应用发布申请后，widget 应用处于申请状态； 正常：widget 应用成功发布，已发布的 widget 应用状态正常； 预撤回：widget 应用撤回需设置缓冲期，缓冲期可以设置为当前时间。当撤回缓 冲期未到前，处于预撤回状态。预撤回时，平台不再提供此 widget 应用的下载地 址，同时此 widget 应用承载的在线业务处于预注销状态（在

44、预注销阶段，仍然为 在线用户提供业务，并给予用户提示，业务即将注销）； 撤回：撤回缓冲期到。 工作流状态： 1) 2) 3) 4) 审核中：开发者已经提交申请，运营商操作员审批中； 配置中：运营商配置操作员配置数据中； 测试中：运营商操作员/开发者测试 widget 应用； 结束：工作流结束。通过邮件、短信等方式，将处理结果通知开发者和运营商操作 员。 状态流转 10 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 申请 撤回 预撤回正常 1 2 4 5 无 6 未提交 3 图 5-3-6-2.1 状态流转图 工作流环节： 审核： 由运营商

45、操作员对开发者提交的 widget 应用进行审核。 配置： 进行业务配置，包括 isag 配置、用户门户配置等；上述配置可以根据具体情况，采用 自动配置或手工配置、或无需配置。配置后的信息需同步到业务代理子系统。 测试： 测试分为在线测试和离线测试： 1) 2) 离线测试：在运营商实验环境中进行的端到端测试； 在线测试：widget 应用发布到商用系统的用户门户，只有测试用户可以看到，通 过测试用户下载、使用，进行端到端测试。 初期，widget 应用开放平台可只提供在线测试环境。 升级：通过修改并测试通过的 widget 应用替换之前的 widget 应用版本。 一、状态流转 1 uwop

46、侧提供 https 服务, 以保 证数据在网络上传输的安全性. 2平台返回注册结果, 响应内容以 xml 格式返回. 数据描述 请求 https get 参数： http get 参数说明最大长度 cmdcp_register30 key注册加密串,如果处于安全考虑,可 以次用此传次参数, 参数内容为手 机号和密码的加密串 加密方式为: base64(3des(账号$密码$手机号 码) 手机号:15 账号:20 密码:20 元素说明最大长度 status 响应返回值 4 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 43 响应数据 schema： 注册响

47、应数据结构 数据说明： 消息示例 1. 2. 请求消息 https get url?cmd=cp_register&key=dfg(,fty.fwi 响应消息 成功： 0 http get 参数 说明最大长度 cmdcp_login30 type01 key登录加密串. 如果基于安全考虑, 参数内容为账号和密码的加密串. 加密方式为: base64(3des(账号$密码) 账号:20 密码:20 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 失败 1 a-1.4 登录 a-1.4.1 帐号/密码方式登录 登录接口规程中包括了认证。 接口说明 终端用户使用

48、服务前, 需要先登录到平台。经过平台认证通过的终端用户, 由平台维护 用户使用服务期间的 session 信息.session 过期后,提示用户重新登录. 认证方式使用 http basic 认证. 采用 https get 方法请求。uwop 侧提供 https 服务, 以保证数据在网络上传输的安 全性. 信令流程 widget client通用微件开放平台 发送登录url http basic认证 记录session信息 登录成功 数据描述 请求 https get 参数： 44 http get 参数 说明最大长度 cmdcp_login30 type11 key登录加密串. 如果基于安全考虑, 参数内容为手机号码的加密串. 加密方式为: base64(3des(手机号码) 手机号:15 中国电信通用 widget 开放系统技术规范平台分册q/ct 2187.2-2009 登入成功, 平台返回终端 http 状