企业接入APPNEST平台指南

1. 搭建APP NEST环境

由于APP NEST是入驻式部署,因此在获取部署环境前,由企业或者销售经理填写好APP NEST产品环境申请单,主要录入信息,包括:企业名称、企业现有人员规模、使用APP NEST产品用途、一年内使用用户数、是否试用、试用有效期、是否使用即时通讯功能、相关负责人手机号或者邮箱号。

填写好上述环境申请单后,将根据企业信息生成相应的中间件安装包、门户客户端安装包、IDE开发工具、管理平台部署包,同时生成相应的license文件。

实施工程师,根据企业预期用户使用量来进行部署安装,同时实现企业用户数据与平台的用户中心进行对接,这个对接过程视企业需求而定,国信灵通提供用户中心的Excel导入模板,或者通过接口的方式实现数据导入并后期定时同步。

环境搭建完毕后,默认会自动创建一个超级管理员账号。

2.  创建轻应用

企业管理员可以通过超级管理员账号创建子管理员,同时创建相应的开发者账号。企业可以自行通过开发者账号来开发移动应用,也可以将开发者账号分配给第三方开发者通过APP NEST平台来开发移动应用。

管理员登入到门户管理平台,创建开发者账号:

创建开发者

开发者获取到开发者账号之后,可以登录开发平台创建应用。
开发者平台界面

点击上图的“添加新应用”按钮,则进入到创建应用界面,开发者可以选择创建离线轻应用(APP NEST轻应用zip)、在线轻应用(APP NEST轻应用在线)或服务型应用:

开发者平台界面2

后台地址: 以http://或者https:// 开头的URL,是轻应用的后台管理页面地址;配置后台地址后可以通过管理平台页面跳转到轻应用的管理后台。

应用创建完毕后,在应用列表页面可以看到已创建应用的应用标识(APPKey)和APPSecret,这两个参数可以使用APP NEST所提供的开放性服务接口(详见《APP NEST开放性服务使用规范》)。

在应用列表点击详情进入到应用详情界面,可以上传当前应用的新版本,离线轻应用和在线轻应用的版本上传方式不尽相同,离线轻应用上传的是zip包,而在线轻应用上传的轻应用首页的web url地址,二者区别参考下图:

离线轻应用

在线轻应用

对于在线轻应用版本,主要上传URL地址,或者用户点击高级选项,编辑高级选项中的权限及入口页面的设置。

URL地址 : 以http://或者https:// 开头的URL,是轻应用的首页地址;在门户客户端上点击轻应用图标,将访问这个URL指向的页面。

版本保存成功后,将提交给管理员进行版本审核。

3. 轻应用开发

  • 开发者需要新增轻应用获取轻应用的APPKey和APPSecret,用来在轻应用开发时调用APP NEST开放平台的接口;
  • APP NEST服务端提供了企业通讯录、文件中心、消息推送等功能,以开放性接口服务的形式给开发者使用,详细可参考《APP NEST开放性服务使用规范》;
  • APP NEST门户客户端提供了一个轻应用运行的容器,并开放了多套可以调用门户客户端本地能力和业务能力的JS接口,客户端开发者可以通过这些接口使用APP NEST门户客户端本地能力,实现轻应用与门户客户端功能的结合;
  • APP NEST提供了与管理平台集成的能力,接口使用可以参考《管理平台集成文档》;
  • APP NEST平台提供了开发过程中需要的调试工具好性能好建议,可以参考《开发工具使用手册》;

实现免登

轻应用接入APP NEST门户客户端后,通过门户实现免登无需让员工进行二次登陆,员工在进入轻应用的时可以获取当前用户的信息实现与原系统中的账户打通。详细文档请参阅《客户端开发规范》中统一认证。

调用客户端JS SDK

轻应用调用客户端JS SDK的权限配置在轻应用的描述文件中,详细可见《客户端开发规范》中main.xml文件描述,只有配置了权限列表的接口才有权限调用。轻应用在提交安装包到管理平台时,管理员会预先审核轻应用所调用的接口列表。

调用服务端API接口

开发者在调用APP NEST开放平台接口时需要附加APPKey和APPSecret

推送消息

用户可以在消息模块中查看轻应用发送的消息,开发者可以通过发送消息接口将消息推送到消息模块。

调用消息推送接口时需要使用HTTP协议,发送的数据包为JSON格式。目前开放平台支持纯文本、纯图片、多媒体、纯文件、外部链接等消息类型。