产品管理|服务列表|应用列表

最近更新时间:11/9/2023, 4:23:09 PM作者:andrewren(任豪)

功能入口

位置:租户端控制台 - {第三方顶部导航}

地址:console.{工业环境域名}/xxx(根据实际第三方接入url)

功能说明

在应用市场上架的应用,用户购买后,在租户控制台会有对应购买应用的使用入口,一般叫产品管理 或 服务列表 或 应用列表。

接入说明

接入方式 接入说明 负责
复用平台列表功能 联系工业侧,工业侧进行配置 工业侧
定制化第三方服务列表 页面嵌入工业平台,相关逻辑由第三方调用平台接口完成 第三方

复用平台列表功能

正常情况下,页面功能可以复用平台已有形式,平台已有服务列表形式 - 参考如下示例图:

img

img

复用的前提是:

  1. 应用上架到工业云应用市场(商品中心)进行售卖交付
  2. 接入了实例中心Saas自动交付(Saas类应用)
  3. 服务列表的功能无第三方定制数据,均为平台默认数据、默认操作。

定制化第三方服务列表

当该功能页形态与平台默认形式不同,存在定制化数据内容时,列表功能由第三方调用平台接口完成。

准备工作

(1)前端界面iframe方式接入;

(2)后端部分接口由地市云通过openapi提供。

功能逻辑说明

前端页面包含以下按钮:

  • 授权:根据当前登录角色进行idaas应用的授权

  • 进入应用:根据当前实例的信息返回携带token的loginUrl,并跳转到对应链接

  • 续费:调用计费接口续费

  • 升级:对当前实例进行规格升级

    如下图所示:

img

页面展示逻辑

判断逻辑-是否实名认证

通过当前登录用户是否认证(user.Strategy=0表示未认证, 具体值以账号中心说明为准),若未认证则显示“使用xxxx需要完成账号实名认证“,其提供跳转按钮http://console.{工业环境域名}/account/auth对应域名所对应的认证地址。若已认证,进行`逻辑-是否有实例`的判断。

img

判断逻辑-是否有实例

通过拉取订单数据接口查询DescribeOrderStatistics,已发货订单数量是否大于0,若小于零则显示以下界面;若大于0则显示对应应用列表界面。

img

判断逻辑-升级选择规格后页面跳转

规格选择后,跳转路径为 /main/third-app-payment/order/{OrderID}

按钮操作逻辑

授权

点击授权,打开用户列表,可复选用户进行授权:

  • 已授权用户是勾选状态,未授权用户是未勾选状态;
  • 不允许对管理员(isAdmin==true字段表示)进行授权状态的变更,即不显示对应勾选框。
  • 在传递授权用户到后台时,除了已勾选用户外,还需传递所有的管理员角色
  • 注意授权列表已授权的用户显示在最下面,方便用户勾选(后端返回的数据未排序)

img

进入应用

通过接口获取实例的loginUrl和id_token,进行免密登陆。

续费

对于可续费的应用,点击续费,获取续费规格,确认规格后会跳转到续费付款界面。通过接口创建续费订单,若创建成功则跳转到工业云付款页面。

//protocol:http或者https协议
//www_host:域名
//OrderId:续费订单id
//config从前端配置中读取
${config.protocol}${config.www_host}/main/cloud-resources/order/${resp.OrderID}
升级
  1. DescribeProduct 接口获取商品的规格和额外计费项。
  2. DescribeInstances 接口获取实例的当前的规格和额外计费项。
  3. DescribeProductPriceInfo 接口计算当前选择的配置的价格。

比较当前选择的配置的价格是否高于原规格和额外计费项价格,如果高于则允许点击“确定”进行下一步;否则,不允许升级。

  1. CreateUpgradeOrder 创建升级订单,跳转到门户订单确认页面。

升级规格选择页

img

图片上方-当前配置:显示的是当前实例的规格与额外配置项

图片下方-目标配置:显示的是实例对应商品当前可选的规格、计费项

按钮显示说明

针对不同状态的应用,按钮显示情况不同。其按钮显示条件如下表:

按钮 条件 相关字段
授权 已发货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 拉取订单统计数据