创建生态应用
一、说明
创建生态应用,需要服务商管理员或开发人员录入应用基本信息;开放平台会给每个应用生成appKey、appSecret信息,appkey和appSecret是用于获取调用API令牌的必需参数;然后服务商管理员或开发人员为应用 授权可访问的API。
服务商想要创建生态应用,服务商需要具备【生态】开发能力,获取开发能力有2个途径,一个是在服务商认证审核时,由开放平台运营人员给服务商分配相应的开发能力;一个是服务商登录控制台主动申请【生态】开发能力,具体操作见下面的操作详述部分。
创建的生态应用若要访问开放平台的OpenAPI,服务商管理员或开发者必须先给生态应用授权应用可访问的API分类,只有授权了可访问的API分类,平台才允许该应用访问这些API分类下的API。
二、操作详述
1.进入控制台
通过开放平台登录后,右上角点击【控制台】,进入开放平台控制台。
2.应用管理-生态应用
左侧菜单点击【应用管理】-【生态应用】,打开生态应用页面,系统会根据当前服务商是否具备【生态】开发能力确定显示内容
1)若当前服务商不具备【生态】开发能力,需要点击【申请资质】按钮,生成【生态】开发能力申请记录,等待审批。
2)若当前服务商已具备【生态】开发能力,列出当前用户有权限访问的服务商下的应用,可以新增和维护应用
3.新增应用
4.填写应用信息
第一步填写应用信息,属性内容详见下表 需要用户填写的信息说明如下:
字段 | 说明 |
---|---|
应用类别 | 包括测试应用和正式应用,默认选中正式应用; 测试应用无法发布上架,仅供开发测试使用; 正式应用可以上架到云市场进行销售; 应用类别选中后不能进行修改 |
应用名称 | 应用的名称,必输项;名称可以由中文、数字及英文组成,长度不能多于6个汉字或者12个字母。 |
应用图标 | 支持选择默认图标和上传本地图标2种方式;本地图标尺寸必须为120*120的JPG、GIF、PNG图片,且尺寸不大于5M |
应用描述 | 简要描述应用提供的产品或服务,最多32个汉字 |
EncodingAESKey | 回调消息加密参数,是 AES 密钥的 Base64 编码,长度为 43 字符,用于回调消息的加解密。可以点击右侧的【自动生成】按钮,由系统自动生成。必填项 |
回调url | 服务商应用提供的接收ticket的接口的地址,开放平台会向此回调URL定期推送ticket信息,开发者需要持久化ticket,请保证该url在公网环境下可以访问 |
邮箱 | 接收应用订单信息用,应用发布到云市场后,企业租户购买后会向此邮箱发送应用订单信息 |
5.新增应用功能
点击【下一步】,进入第二步维护应用功能页面,如下图所示:
此页面可以维护应用下具体有哪些功能连接页面,支持多端配置,包括WEB端、PC客户端、友空间(其中,微信和钉钉 目前不支持),每端都有相应的配置信息
1)点击【新建】按钮,打开新增应用功能页面,如下图所示:
应用功能基本属性配置如下表所示:
字段 | 说明 |
---|---|
功能名称 | 名称可以由中文、数字及英文组成,长度不能多于6个汉字或者12个字母 |
功能图标 | 支持选择默认图标和上传本地图标2种方式;本地图标尺寸必须为120*120的JPG、GIF、PNG图片,且尺寸不大于5M |
发布客户端 | 应用的客户端类型,包括 web端、PC客户端、友空间,至少选择一类,选择后需要填写相应的配置信息 |
a) Web端,即用友工作台
目前有2个工作台入口,分别是diwork和yonsuite,配置属性如下表所示:
字段 | 说明 |
---|---|
web端Url | 当客户端选择web端时显示,填写web端的主页地址,必填项 |
打开方式 | 当前页面和新页面;当前页面表示就在浏览器的当前页面跳转到web端的主页地址;新页面表示在新窗口或新的标签页打开web端的主页地址 |
集成免登策略 | 选项包括:无、友空间;选择友空间则按照友空间的免登机制进行免登 |
b) PC客户端,即友空间桌面端
配置属性如下表所示:
字段 | 说明 |
---|---|
web端Url | 输入在友空间桌面端打开时跳转地址 |
打开方式 | 支持PC客户端内、浏览器新页、本地3种方式 |
c) 友空间,即友空间APP端
配置属性如下表所示:
字段 | 说明 |
---|---|
app原生导航 | 如果移动应用使用友空间APP原生的导航栏则勾选是,如果使用应用自己的导航栏则勾选否 |
是否原生 | 移动应用是原生开发的应用,还是H5轻应用 |
移动端主页 | 当是否原生选择否时显示,填写移动端的主页地址 |
summerId | 请输入上传到IUAP平台的安装包ID |
推荐到移动端首页 | 当前移动应用是否推荐到友空间APP首页,如果推荐,是放在最前面,还是最后面 |
2)点击【确认】按钮,保存应用功能数据