<#import "/ftl/spring.ftl" as spring/> <@spring.message code="doc.page.title"/> <@mdp.mdp_index_common/> <@mdp.mdp_index_top/>
移动警务开放平台二次开发文档 更新时间:2014-06-16
移动警务开放平台
二次开发说明书

1前言

1.1编写目的

移动警务开放平台提供完整的公安行业软件资源申请、开发与发布一站式开发流程,为方便第三方开发这更好的使用开放平台,降低行业软件入门,特此编写该文档,遵循该文档执行的开发流程,可快速上线行业应用。

1.2预期读者

第三方数据源提供者;

第三方应用开发者。

1.3术语、定义、符号及缩略语
缩写。术语 解释
MDP 移动警务应用开发与发布系统
UAS 统一授权认证服务器
PAMS 移动警务综合管理系统
DRS 数据请求服务

2概述

2.1简述

移动警务开放平台(以下简称开放平台)提供一个基本的服务,然后通过开放自身的接口,使得第三方开发者得以通过使用或组装其接口以及其他第三方服务接口产生新的应用,并且使得该应用能够统一发布在这个平台之上。

第三方整体接入开放平台涉及 资源发布、资源申请、资源调用、统一认证、人员同步、应用发布、应用升级以及PAMS审批各种申请,接入时并非全部流程都需要,以下介绍各流程对应使用场景。

以下截图均为开放平台MDP页面。

本文档对开放平台接入整理流程做详细说明。

2.2开放平台二次开发整体结构
2.3参考资料

接口调用说明详见《移动警务开放平台接口调用.doc》 ;

二次开发流程中基础用户使用说明详见《移动警务开发与发布系统-用户手册.doc》 。

数据源资源发布参照《DRS配置手册V-2.3.pdf》

3开发者账号
3.1帐号注册

浏览器访问:http://mdpIp:mdpPort/mdp/

帐号注册

已有开发者帐号,可直接跳过该步骤,查看3.2。

3.1.1无单位人员注册

注册时手工输入“基本信息”内容,单位信息为空点击“注册”,如图3.1.1。注册后人员类型为无单位 ,人员审核状态为单位已审核 。

图3.1.1注册页面
3.1.2注册新单位(并注册该单位管理员)

注册时手工输入“基本信息”,“单位信息”点击“注册”,如图3.1.2。注册后人员类型为有单位 ,人员审核状态为单位已审核 ,系统管理员审核通过后该人员拥有单位管理员角色。

图3.1.2 注册页面
3.1.3注册成为单位下的人员

注册信息提交后,该人员类型为有单位,人员审核状态为单位未审核,审核时需要经过二级审核,即需要先通过单位管理员的审核,然后再通过平台管理员的审核。

图3.1.3注册成为单位下的人员
3.2登录

普通用户可直接登录MDP:http://mdpIp:mdpPort/mdp/

管理员可通过单点登录登录本系统和管理后台:http://casIp:casPort/cas/

用户名为注册时的身份证号或移动警务信息管理系统(PAMS)里的警员警号、身份证号:

单点登录
4资源
4.1资源说明

开放平台统一管理资源,包括网络接口、数据库等,可直接在内网申请接入网资源,接入网申请内网资源,跨域的跳转由开放平台自身处理,第三方用户只需关注与资源的调用即可。

用户可发布资源,已发布并审核通过的资源可在开放平台管理页面被其他第三方用户看到。第三方用户可对想要接入的资源提出申请,由PAMS管理员对第三方用户的申请进行授权,授权通过的资源即可下载开发文档和开发资源包使用。

4.2开放平台资源发布
4.2.1资源发布流程图
4.2.2资源发布
资源发布

图“资源发布”:

开放平台菜单栏“资源”,可查看所有公开资源,点击“发布资源”可发布新资源。

资源发布信息

图“资源发布信息”:发布资源时,红色*标识代表必填:

为适用公安行业网络规范,按实际资源类型如下配置,即可访问不同网段的资源(如接 入网访问内网资源)

a.数据源类:(数据库类资源)

资源为数据库表或视图等数据库资源时,可发布为该种资源,此时应先在DRS系统上接入该数据库信息,并由DRS将数据库资源转换为数据源接口,此处服务地址配置为DRS接口地址。

如:要发布192.168.6.6数据库中xdja用户下的rk_czrk表,则先在DRS系统上转换为数据源接口(具体详见《DRS配置手册V-2.3.pdf》),然后资源服务地址配置为DRS系统接口地址:http://drsIp:drsPort/drs/ws/DataRequest?wsdl。

b.业务资源:(内网服务资源)

业务部署在内网,接入网需访问内网业务资源的情况,该资源类型可实现访问。

如:现注册内网部署的服务pams(pams有一些接口需要在接入网调用),则选该资源类型,然后资源服务地址配置为PAMS服务地址:http://pamsIp:pamsPort/pams。此时注册的服务可且仅可调用PAMS发布的所有接口或服务。

c.网络资源:(内网服务器资源)

内网服务器部署多个服务且共用一个端口,则选该资源类型时可访问所绑定指定服务器IP,指定PORT的所有服务。

如:现注册内网服务器192.168.66.66的6666端口,则内网服务器192.168.66.66上所有走6666端口的接口或服务均可通过该类型注册的资源访问。

附件状态:

公开资源:所有用户登录后均可下载和查看公开资源的文档及资源(暂时均发布为该资源);

非公开资源:用户不可见文档及资源。

资源发布
图“资源发布”:

已发布的资源可在用户-->我的资源中按状态查看。

发布的资源需等待管理员审核通过后方可在菜单栏资源中看到或被人申请,请注意登陆mdp查收站内信。

4.4.3资源下载及使用

用户申请通过的资源即可根据申请内容下载使用:

我的申请

管理员审核结果会已站内信形式展示给用户;

申请通过的资源可按照申请内容使用该资源。

5应用
5.1应用说明

第三方单位可以自己开发应用并在开放平台上线应用,开放平台自己提供辅助模块帮助第三方开发着快速接入开放平台,如统一认证客户端统一管理用户及权限,DRS提供数据源类资源的调用客户端等。

5.2应用开发整体流程图
应用开发整体流程图
5.3开放平台应用开发
5.3.1应用接入开放平台

应用接入开放平台需对接开放平台系统中的部分接口

统一认证接入:开放平台的应用登录用户是有开放平台UAS系统统一管理的,如要获得统一的用户体验,第三方应用需对接统一认证客户端,如第三方仅需使用开放平台资源,同样可以跳过结对统一认证客户端,由第三方自己维护用户。

数据源资源接入:开放平台资源来资源是由DRS系统维护的数据源,包含基础数据库、全国请求服务、交管六合一等常用业务,字典翻译、多数据源等基础功能。

接入方式详见:《移动警务开放平台接口调用.doc》

5.3.2应用规范与约束
  • 应用包名不可重复
  • 应用版本按android规范指定
5.3.3应用发布

第三方已开发并测试通过的应用可在开放平台上线。

图应用发布:

开放平台菜单栏“应用”,可查看已上传应用,点击“发布应用”可发布新应用。

应用基本信息
图“应用基本信息”:

点击发布应用后进入发布应用界面,选择应用包后系统自动读取APK部分信息,其中红色*标识的输入框为必填项,应用分类和推荐警钟根据实际应用正确选择,此处可选快速完成,快速完成的应用没有应用图片信息,应用资源直接绑定信息。

服务绑定资源
图“服务绑定资源”:

如果图“应用基本信息”点击下一步,则可上传应用图片信息,如:应用截图。继续点击下一步则进入服务或应用绑定资源页面。 服务绑定资源:

第三方应用服务器需要调用哪些资源则在“服务绑定资源”标签进行绑定,资源名称为实时检索。

应用绑定资源
图“应用绑定资源”:

第三方应用直接绑定开放平台资源的应用则选则“应用绑定资源”标签,绑定需要的资源,资源名称为实时检索。

如都不需要,则跳过。

已发布的应用需管理员在PAMS平台对应用进行审批,请注意登陆mdp查收站内信。

5.3.4应用下载使用

审批通过的应用可在开放平台或手机终端应用中心看到和下载使用。

5.3.5应用修改和升级

审批后的应用可以修改(包括通过和不通过),在用户-->我的应用中根据自定义检索条件检索当前用户的应用。

应用升级
图“应用升级”:

鼠标放“详情”上,会有“详情”、“修改”和“升级”三种操作。

详情:查看当前应用详细信息,

修改:修改应用信息,

升级:升级当前应用版本。应用升级时,新应用包的包名应和原应用包名一致,版 本号比原应用版本号高,其他按页面说明操作。

请查看附件
<@mdp.mdp_index_bottom/>