示例:使用轻应用模板

更新时间:
复制 MD 格式

本文介绍如何通过手动导入模板的方式安装轻应用。

前提条件

使用限制

模板文件只能用于不同的BizWorks租户或同一BizWorks下的不同项目。否则,在导入模板的过程中会报错。

使用轻应用模板示例简介

您可通过轻应用以低代码、可视化的方式搭建前端应用,实现前端应用和中台服务的打通。BizWorks团队从电商运营管理后台里截取部分应用页面作为示例轻应用,帮助您快速了解如何使用BizWorks轻应用进行Web应用开发,包含模型编排、服务编排及页面编排等内容。

使用轻应用模板全流程操作步骤示例

步骤一:下载示例轻应用模板

轻应用模板示例文件下载到本地。

步骤二:安装轻应用模板

  1. 应用列表页面,单击模板安装应用

  2. 模板安装应用对话框中,如果您想通过企业应用模板的方式安装轻应用模板(否则您可以跳过该步骤),请参考以下步骤安装。

    1. 模板安装应用对话框中,选中企业应用模板,单击确定

    2. 通过企业应用模板安装面板,您可以在本地模板订阅模板页签单击目标企业轻应用模板,单击下一步

      重要

      一个项目中同时最多只能有一个模板处于安装过程中。

      如果您在该项目中已经安装过应用模板,在通过企业应用模板安装面板会有相应的信息提示:

      • 如果您上次安装失败,则提示您:安装失败,您还可以单击点开查看查看安装失败的具体原因。

      • 如果您上次安装成功,则提示您:安装成功。如果安装成功,则提示您:安装成功,显示已安装的应用模板信息。

      • 如果有模板正处于安装过程中,则界面提示如下。安装过程中,页面提示后台安装中,您可以离开此页面,稍后查询结果,单击完成即可离开安装页面。

    3. 在版本列表选中目标版本后,单击下一步

  3. 模板安装应用对话框中,如果您想通过导入模板的方式安装轻应用模板(否则您可以跳过该步骤),请参考以下步骤安装。

    1. 模板安装应用对话框中,选中导入模板,单击确定

    2. 手动导入模板安装面板的上传模板文件区域,单击虚线文本框区域或将目标模板文件拖拽至虚线文本框区域内,模板文件成功上传后,单击下一步

    重要
    • 轻应用组装平台仅支持安装模板类型为轻应用的应用模板,其他类型不支持安装。

    • 模板文件成功上传后,系统会保留最近一次的模板信息。

    模板文件上传成功后,您可以看到类似以下界面。在手动导入模板安装弹窗中,上传应用模板文件后,系统展示已上传模板的卡片信息,包括模板名称、类型(轻应用)、版本号及开发状态。单击基本信息页签可查看更新时间、提供者、联系方式及介绍等字段,确认无误后单击下一步

    重要

    一个项目中同时最多只能有一个模板处于安装过程中。

    如果您在该项目中已经安装过应用模板,在手动导入模板安装面板会有相应的信息提示:

    • 如果您上次安装失败,则提示您:安装失败,您还可以单击点开查看查看安装失败的具体原因。如果您想重新安装新模板,您可以单击删除,删除旧模板后,重新上传安装新模板。如果您上次安装失败,则提示您:应用模板 xxx 安装失败,您可以单击点开查看链接查看安装失败的具体原因。

    • 如果您上次安装成功,则提示您:安装成功。如果您想重新安装新模板,您可以单击删除,删除旧模板后,重新上传安装新模板。如果安装成功,页面顶部显示 安装成功 提示,下方展示已安装的模板卡片及其基本信息(名称、版本号、状态等)。

    • 如果有模板正处于安装过程中,则界面提示如下。安装过程依次经过依赖配置应用信息检查确认安装三个步骤。进入确认安装步骤后,系统提示"后台安装中,您可以离开此页面,稍后查询结果"。等待安装完成后,单击完成

  4. 模板安装应用依赖配置向导页,单击下一步

    说明

    由于模板内的轻应用不依赖任何业务域,故此处无需进行依赖业务域配置。

  5. 模板安装应用应用信息检查向导页,完成对计划新增的轻应用信息轻应用名称应用版本描述)的查看和修改后,单击开始安装

    说明

    安装开始后系统将会自动创建新版本的轻应用,因此需要对相关信息进行检查和确认。

    单击开始安装后,界面如下。安装过程包含三个步骤:依赖配置应用信息检查确认安装。进入确认安装步骤后,系统在后台执行安装,页面提示"后台安装中,您可以离开此页面,稍后查询结果"。安装完成后单击完成

    • 如果提示您安装成功,单击轻应用。安装成功后,单击提示信息中的轻应用链接。

      页面自动跳转至通过模板安装的轻应用概览页,您可以看到已完成安装的应用编码为bizworks-lightapp-template的轻应用。此时进入该轻应用的概览页面,可查看应用基本信息(包括应用类型、负责人、当前版本、应用来源等)及应用数据统计(依赖业务域、结构对象、服务编排、页面编排的数量),并可通过右上角的 应用部署编辑应用属性应用版本管理应用成员管理 进行后续操作。

    • 如果提示您安装失败,界面会提示您具体失败原因。您可以根据提示进行相关操作,或者联系BizWorks技术人员帮您解决该问题。

      说明

      安装失败后,您仍然可以在这个项目中再次进行安装。

步骤三:通过模板安装的轻应用包含的内容说明

轻应用内容

说明

模型管理

轻应用内已包含自定义创建的结构对象,在您为轻应用关联业务域后,也可对业务域内的结构对象进行复用。在模型管理结构对象页面中,模板预置了以下结构对象:各季度&环节PV(ActionQuaterPV)、买家(Buyer)、渠道日订单(DailyChannelOrder)、商品(Item)、登录账户(LoginAccount)、订单(Order)、订单_表格(OrderDisplayInfo)。可对各结构对象执行编辑复制删除操作。

服务编排

服务编排内已包含编排完毕的服务方法,其中:

  • 工作台图表分组内的服务方法模拟了工作台页面内图表的数据源。

  • 订单相关数据源分组内的服务方法模拟了和订单有关的数据源。

  • 登录分组内的服务方法在用户登录动作中被调用。

在实际场景中,您通过依赖业务域内的应用服务方法完成对数据源的获取。

各分组具体包含以下服务方法:工作台图表包含getQuarterActionPV、getWeeklyOdersChannel;订单相关数据源包含getBuyerList、getItemList、getOrderList;登录包含checkPassword、listUserBasicInfo、login、logout、getLoginedUser、getUserBasicInfo。系统方法包含addCookie_bwgetCookie_bw。以getLoginedUser服务为例,其编排流程为:开始 → 获取Cookie(getCookie_bw) → 排他分支判断accountName是否存在(不存在则登录过期,默认条件则调用getUserBasicInfo获取用户基本信息) → 结束。

页面编排

页面编排中已包含通过可视化编排构建完成的5个页面:

  • 登录页

  • 工作台

  • 订单管理

  • 订单登记

  • 订单详情

您可进入页面设计器,查看每个页面内容,包含画布内组件用法、变量管理、逻辑流构建、JS构建等。

配置页面框架

已完成页面框架的基础配置,使用左侧导航、白色背景色,配置了用户信息及用户信息的下拉菜单。在应用框架的属性面板中,导航配置区域可设置导航布局(左侧导航、顶部导航、顶部+左侧导航)、导航背景色(主题色、白色、黑色),以及导航默认收起自动加载导航菜单多页签开关。用户信息配置区域可设置显示用户信息开关、用户名称、用户头像来源(系统文件或外部链接)及图片文件。用户信息下拉菜单区域可管理菜单项(如注销),并通过添加一项按钮新增菜单项。

菜单管理

菜单包含工作台订单后台分组,分组下包含了订单管理订单详情两个菜单项。在编辑菜单配置面板中,可设置配置名称(如"运营管理系统")和唯一标识(如 orderMngmtSystem)。应用菜单配置区域分为左右两栏:左栏列出可用菜单项(订单管理、订单登记、工作台),右栏展示已配置的菜单树结构,可通过新建分组将菜单项组织为分组(如"订单后台"下包含"订单登记"和"订单管理")。

步骤四:开发轻应用

您可以在模板的基础上进行自定义修改,关联业务域、尝试构建其他服务方法及页面,变更页面框架、菜单配置等。具体操作,请参见以下文档:

步骤五:部署轻应用

应用开发完成后,您即可将应用部署至集群并查看其运行效果。模板示例文件的效果图如下:部署完成后,订单管理页面包含按订单ID商品ID搜索的筛选区域,支持按订单状态(全部、待付款、待发货、已发货、已完成、已关闭)切换查看,表格展示商品ID、数量、折扣、总价、买家信息(脱敏显示)、订单状态、下单时间等列,每行末尾提供详情链接。部署完成后,轻应用的工作台页面展示订单管理中心首页仪表板,包含快捷导航入口(订单管理商品管理促销管理类目管理)、数据看板(近7天下单趋势折线图和交易漏斗图)、待处理事项(待发货订单、待审核退单、待收货退单)及最新公告模块。

具体操作,请参见部署和管理轻应用