功能入口
位置:租户端控制台 - {第三方顶部导航}
地址:console.{工业环境域名}/xxx(根据实际第三方接入url)
功能说明
在应用市场上架的应用,用户购买后,在租户控制台会有对应购买应用的使用入口,一般叫产品管理 或 服务列表 或 应用列表。
接入说明
接入方式 | 接入说明 | 负责 |
---|---|---|
复用平台列表功能 | 联系工业侧,工业侧进行配置 | 工业侧 |
定制化第三方服务列表 | 页面嵌入工业平台,相关逻辑由第三方调用平台接口完成 | 第三方 |
复用平台列表功能
正常情况下,页面功能可以复用平台已有形式,平台已有服务列表形式 - 参考如下示例图:
复用的前提是:
- 应用上架到工业云应用市场(商品中心)进行售卖交付
- 接入了实例中心Saas自动交付(Saas类应用)
- 服务列表的功能无第三方定制数据,均为平台默认数据、默认操作。
定制化第三方服务列表
当该功能页形态与平台默认形式不同,存在定制化数据内容时,列表功能由第三方调用平台接口完成。
准备工作
(1)前端界面iframe方式接入;
(2)后端部分接口由地市云通过openapi提供。
功能逻辑说明
前端页面包含以下按钮:
授权:根据当前登录角色进行idaas应用的授权
进入应用:根据当前实例的信息返回携带token的loginUrl,并跳转到对应链接
续费:调用计费接口续费
升级:对当前实例进行规格升级
如下图所示:
页面展示逻辑
判断逻辑-是否实名认证
通过当前登录用户是否认证(user.Strategy=0表示未认证, 具体值以账号中心说明为准),若未认证则显示“使用xxxx需要完成账号实名认证“,其提供跳转按钮http://console.{工业环境域名}/account/auth对应域名所对应的认证地址。若已认证,进行`逻辑-是否有实例`的判断。
判断逻辑-是否有实例
通过拉取订单数据接口查询DescribeOrderStatistics,已发货订单数量是否大于0,若小于零则显示以下界面;若大于0则显示对应应用列表界面。
判断逻辑-升级选择规格后页面跳转
规格选择后,跳转路径为 /main/third-app-payment/order/{OrderID}
按钮操作逻辑
授权
点击授权,打开用户列表,可复选用户进行授权:
- 已授权用户是勾选状态,未授权用户是未勾选状态;
- 不允许对管理员(isAdmin==true字段表示)进行授权状态的变更,即不显示对应勾选框。
- 在传递授权用户到后台时,除了已勾选用户外,还需传递所有的管理员角色
- 注意授权列表已授权的用户显示在最下面,方便用户勾选(后端返回的数据未排序)
进入应用
通过接口获取实例的loginUrl和id_token,进行免密登陆。
续费
对于可续费的应用,点击续费,获取续费规格,确认规格后会跳转到续费付款界面。通过接口创建续费订单,若创建成功则跳转到工业云付款页面。
升级
- DescribeProduct 接口获取商品的规格和额外计费项。
- DescribeInstances 接口获取实例的当前的规格和额外计费项。
- DescribeProductPriceInfo 接口计算当前选择的配置的价格。
比较当前选择的配置的价格是否高于原规格和额外计费项价格,如果高于则允许点击“确定”进行下一步;否则,不允许升级。
- CreateUpgradeOrder 创建升级订单,跳转到门户订单确认页面。
升级规格选择页

图片上方-当前配置:显示的是当前实例的规格与额外配置项
图片下方-目标配置:显示的是实例对应商品当前可选的规格、计费项
按钮显示说明
针对不同状态的应用,按钮显示情况不同。其按钮显示条件如下表:
按钮 | 条件 | 相关字段 |
---|---|---|
授权 | 已发货saas应用接入idaas当前用户是企业管理员 | instance.Status=delivered && instance.DeliverType=saas && instance.LoginType=idaas && user.Strategy=20 |
进入应用 | 已发货saas应用接入idaas | instance.Status=delivered && instance.DeliverType=saas && instance.LoginType=idaas |
续费 | 已发货可续费当前用户为个人认证或企业管理员 | instance.Status=delivered && instance.Renewable=true &&(user.Strategy=20||user.Strategy=10) |
升级 | DescribeInstance接口获取实例的Upgradable为true且CanCancelRefund为false |
接口列表
列出可能使用到的接口:
接口 | 说明 |
---|---|
DescribeInstances | 查询实例列表 |
DescribeInstance | 查询实例详情 |
ModifyInstanceName | 修改实例名称 |
DescribeUser | 查询可授权用户列表 |
DescribeInstanceAccessors | 查询实例已授权访问者/组 |
SetInstanceAccessors | 实例授权 |
DescribeInstanceDeliveredContent | 查询交付内容 |
CreateRenewOrder | 创建升级订单 |
DescribeOrderStatistics | 拉取订单统计数据 |