【华为云Astro 轻应用】组装“待处理工单”页面示例
为了让用户更容易理解和实施华为云 Astro 中“待处理工单”页面的开发,我们可以用一个“拼装积木搭建房子”的形象比喻,来讲清楚三个核心概念的关系和操作步骤:
🌟 核心关系总览:像搭一座智能房子
模块 | 比喻 | 功能 | 如何连接 |
---|---|---|---|
页面组件(前端) | 积木外壳、窗户、门、按钮 | 负责展示内容和与用户交互(输入框、按钮、列表等) | 通过绑定模型的“字段”展示内容或收集数据 |
页面模型(数据仓库) | 储物柜、控制台 | 用来存储数据(如工单标题、编号等)或接收用户输入 | 一方面接收服务模型传回的数据,一方面提供数据给前端组件 |
服务模型(接口调度员) | 快递小哥、送货员 | 用于调用后台接口,将数据送入模型(即“填满储物柜”) | 被事件触发(例如页面加载、点击按钮),向模型写入数据 |
🧠 简化逻辑图:页面加载时的“数据旅程”
【页面加载】↓
触发服务模型 queryWorkOrder↓
调用后台接口查工单数据↓
将数据写入模型 workOrderList↓
组件(如标签、列表)从模型中“取数据”展示
🧱 操作流程形象化解释(分三步)
步骤一:组装房子的“外壳”——页面组件设计(前端)
目标:构建页面的3个区域
区域 | 比喻 | 作用 |
---|---|---|
页面标题区 | 门牌 | 显示“工单列表”字样 |
查询条件区 | 门铃和信箱 | 用户输入“标题”,点击“查询” |
工单列表区 | 展厅 | 显示多个工单,每个工单是一个积木组合,包括标题、状态、优先级等 |
🔧 主要操作:
-
拖入组件(如标题、输入框、按钮、标签、列表视图)
-
设置样式(背景色、字体、对齐)
-
分栏组件帮助实现“横向布局”
-
使用列表视图 + 嵌套分栏组合,展示一个个工单项
步骤二:搭建房子的“内部电路”——页面模型设计(数据结构)
目标:模型如储物柜,准备好“放数据”的地方
模型 | 用途 | 包含字段 |
---|---|---|
workOrderList | 存放每条工单数据 | 标题、ID、状态、到达时间等 |
queryCondition | 存用户输入的查询条件 | title(工单标题) |
total | 分页用的统计数据 | 当前数量、总数量 |
queryWorkOrder | 请求后台接口的服务模型 | 绑定接口 queryWorkOrder |
🔧 主要操作:
-
在模型视图中新增自定义模型或服务模型
-
为模型添加字段(字段名必须匹配接口返回值或组件需求)
-
保存每个模型
步骤三:连接“前台展示”与“后台数据”——绑定模型与事件代码
🎯 模型与组件绑定:搭上电缆
-
如:标题展示标签 → 绑定字段
workOrderList.HW__title__CST
-
按钮是否禁用 → 绑定字段
workOrderList.isDeal
图示逻辑:
标签组件 ← 模型字段值
按钮组件(禁用) ← 模型字段值
输入框组件 → 模型字段(保存用户输入)
⚙️ 事件逻辑编排:给按钮“上电”
-
页面加载时:自动查找工单
-
触发
queryWorkOrder
服务模型 -
将返回数据填入
workOrderList
模型 -
页面自动展示工单列表
-
-
查询按钮点击时:按标题搜索
-
从
queryCondition.title
读取输入 -
带着输入参数调用
queryWorkOrder
-
再次刷新列表内容
-
-
处理按钮点击时:弹出处理对话框 + BPM流程
-
弹出子页面进行处理
-
提交后更新工单状态
-
重新调用查询接口刷新列表
-
📦 最终搭好的“页面房子”功能一览
操作 | 功能实现 | 关键机制 |
---|---|---|
页面打开就显示工单 | onLoad事件 → query接口 → 填模型 → 显示组件 | 页面事件 + 服务模型 + 数据绑定 |
查询标题关键词 | 按钮事件 + 模型读取输入 + 重新查接口 | 输入框绑定 + 服务模型 |
点击“处理”按钮 | 弹窗 + 发送BPM处理请求 | 按钮事件 + fetch请求 |
🪜 总结流程思维图
1. 先设计页面结构(组件拖拽) → 积木外壳
2. 后设计数据模型(workOrderList等)→ 储物柜
3. 再将组件与模型字段绑定 → 连接电线
4. 添加服务模型调用 → 接通电源
5. 编写事件代码(加载、查询、处理)→ 让房子“动起来”
🧱 实际操作
“待处理工单”页面是一个手机端的页面,用于显示现场工程师名下的待处理工单,将使用标准页面功能实现。
如图1所示工程师在手机端可以看到自己名下所有的待处理工单。系统默认优先显示待处理的工单。
因当前页面组件较多,因此分3个大步骤开发页面,先拖拽页面的前端组件,再定义页面模型,进行模型与前端组件绑定,最后为页面添加相应的事件代码。
页面组件分析
分析图1的组成,可以将整个页面分割为3个区域:页面标题、查询条件和待处理工单列表区域,如图2所示。
待处理工单列表通过在列表视图中,使用2个“分栏”的嵌套,组装出待处理工单列表区。
操作步骤
以下操作步骤只是给出的大致的拖拽方法,您可以根据需要,修改各组件的颜色、对齐方式、边距显示样式,使页面更美观。
- 在“我的应用”中,单击“设备维修管理系统”,进入应用。
- 鼠标放在“Page”上,单击界面上出现的“+”,在弹出菜单中选择“标准页面”。
- 在“标签”和“名称”文本框中输入“workOrderListM”,单击“添加”。
当编辑已有标准页面时,为防止编辑时多人篡改,编辑前请单击
进行锁定。
- 单击页面上方的
Mobile图标,切换到手机端设计模式。
- 组装“页面标题区”。
- 从基本组件列表区,拖拽1个“标题”组件到“页面内容”。
- 选中“标题”组件,在右侧“属性”页签,配置标题组件属性:
- 修改“标题内容”为“工单列表”。
- 在“样式”下的“高级设置”中,输入如下样式代码,即设置标题组件的背景色、水平居中对齐,文字颜色为白色。
:root{ text-align:center; background-color:#4a90e2; color:#FFFFFF; opacity:0.9; }
图3 高级设置
- 组装“查询条件区”。
- 拖拽1个“分栏”到“工单列表”之后,在右侧“行布局”下先单击PC中的2栏图标,再单击Phone下的2栏图标,将分栏设置为左右不均分的2栏,如下图所示。
图4 拖入分栏组件并设置为2栏
- 选中左侧“栏”,在“样式 > 高级设置”下输入样式代码,设置宽度为75%,高度为40px。
图5 修改列宽度
:root{ width:75%; height:40px; }
- 选中右侧“栏”,同样方式设置宽度为25%,高度为40px。
:root{ width:25%; height:40px; }
- 拖拽1个“输入框”组件到“分栏”的左栏,修改其“占位符”为“请输入工单完整标题”。
- 拖拽1个“按钮”组件到“分栏”的右栏,修改其“显示名称”为“查询”、“类型”为“主要按钮”。
- 选择“请输入工单完整标题”所在的“栏”,设置“弹性布局”,并修改内边距为“10px”。
图6 设置栏属性
- 拖拽1个“分栏”到“工单列表”之后,在右侧“行布局”下先单击PC中的2栏图标,再单击Phone下的2栏图标,将分栏设置为左右不均分的2栏,如下图所示。
- 组装“待处理工单列表区”。
- 在“分栏”之后,拖入1个“ 列表视图”组件。
图7 拖入列表视图
- 在“列表视图容器”下层的“列表视图”中,拖入1个“分栏”,在右侧修改为1个栏(Phone),并设置分栏内边距为“10px”。
图8 修改分栏为1栏及内边距
- 在“分栏”中,再拖入1个“分栏”,并参考上图修改为1个栏(Phone),然后单击分栏的
7次,新增7个分栏,新增后,变为8个分栏。 - 向第1~7分栏中,分别拖拽2个“标签”组件(并排),然后在第8分栏中,拖入一个“按钮”组件。
- 修改第1分栏中的第1个标签的“文本内容”修改为“标题:”。
图9 修改第1个标签标题
- 重复上一步,修改第2~7分栏中的第1个标签的“文本内容”为“单号:”、“状态:”、“时间:”和“优先级:”。
说明:表1 标签的文本内容 所在分栏
第一栏
第二栏
1
标题:
保持默认(label)
2
单号:
保持默认(label)
3
状态:
保持默认(label)
4
要求到达时间:
保持默认(label)
5
要求解决时间:
保持默认(label)
6
现场故障说明:
保持默认(label)
7
优先级:
保持默认(label)
正常情况下,第二栏中的内容是动态获取的,在表3中,设置的第二栏中的“文本内容”,仅会在未获取相应工单信息时显示,您也可以根据实际需要自定义“标题”组件默认显示内容。
- 在“样式”属性下,自定义修改各个标签组件的样式,例如加粗文本。
图10 自定义修改样式
- 在第8行内,选中“按钮”组件,设置按钮“显示名称”为“处理”、“类型”为“主要按钮”,您也可以在属性中为按钮添加图标,修改按钮背景色为“#4a90e2”。
- 在“分栏”之后,拖入1个“ 列表视图”组件。
- 单击界面上方的
,保存页面。
定义模型并绑定页面组件
页面模型负责与页面组件交互,获取显示工单需要的数据。结合页面展示需求,可知需要创建如下模型:
模型名称 | 作用 | 详细定义 |
---|---|---|
workOrderList | 保存工单的基本信息。 | 自定义模型,包含的字段节点如下,这些节点与工单对象的字段名称相同,加粗斜体内容请替换为实际命名空间前缀:
|
queryCondition | 查询条件。 | 自定义模型,包含字段节点:title,字段类型Text,与页面上的查询条件对应。 |
queryWorkOrder | 查询工单。 | 服务模型,绑定公共接口“ queryWorkOrder”,调用查询工单逻辑。 |
total | 保存满足查询条件的记录数,作为Scroll组件滚动显示时的累计记录数。 | 自定义模型,包含的字段节点如下:
|
- 定义模型“workOrderList”。
- 单击“模型视图”,切换到模型视图。
- 在模型视图中,单击“新增模型”。
- 添加自定义模型,模型名称“workOrderList”,单击“下一步”。
- 单击“新增节点”,依次增加表2中列出的字段名称,单击“下一步”,再单击“确定”。
- 单击页面上方的
,保存模型。
- 定义模型“queryCondition”。
- 在“模型视图”中,单击“新增模型”。
- 添加自定义模型,模型名称“queryCondition”,单击“下一步”。
- 单击“新增节点”,依次增加表2中列出的字段名称,单击“下一步”,再单击“确定”。
- 单击页面上方的
,保存模型。
- 定义模型“total”。
- 在“模型视图”中,单击“新增模型”。
- 添加自定义模型,模型名称“total”,单击“下一步”。
- 单击“新增节点”,依次增加表2中列出的字段名称,单击“下一步”,再单击“确定”。
- 单击页面上方的
,保存模型。
- 定义模型“queryWorkOrder”。
- 在“模型视图”中,单击“新增模型”。
- 添加服务模型,模型名称“queryWorkOrder”,单击“下一步”,
- “服务类型”选择“公共接口”,“选择项目”为“设备维修管理系统”,“搜索”中的接口选择“queryWorkOrder”,单击“下一步”,再单击“确定”。
- 单击页面上方的
,保存模型。
- 绑定模型“workOrderList”。
- 单击“设计视图”,从“模型视图”切换到“设计视图”。
- 选中“列表视图容器”标签中的“列表视图”标签(不要选择列表视图容器),为其绑定“workOrderList”。
图12 绑定数据模型
- 如图13所示,选中“标题:”后的标签组件label,在右侧“属性”页签,单击“+”,增加属性值绑定,即设置“属性”为“文本内容”,“模型字段”为“workOrderList”下的“HW__title__CST”。
- 依次为其他标签添加属性值绑定,具体绑定的字段如表3所示。
表3 标签的属性值绑定 所在分栏
第一栏
第二栏
第二栏标签绑定的字段
1
标题:
label
workOrderList.HW__title__CST
2
单号:
label
workOrderList.HW__workOrderId__CST
3
状态:
label
workOrderList.HW__status__CST
4
要求到达时间:
label
workOrderList.HW__arriveTime__CST
5
要求解决时间:
label
workOrderList.HW__recoveryTime__CST
6
现场故障说明:
label
workOrderList.HW__faultPhenomenon__CST
7
优先级:
label
workOrderList.HW__priority__CST
- 为“处理”按钮添加属性值绑定,“属性”设置为“禁用”,绑定“workOrderList”的“isDeal”字段,绑定后为“workOrderList.isDeal”。
图14 添加属性值绑定
- 单击页面上方的
,保存设置。
- 绑定模型“queryCondition”。
- 选中“请输入工单完整标题”输入框,为其进行值绑定,绑定字段为“queryCondition.title”。
图15 绑定工单标题
- 单击页面上方的
,保存设置。
- 选中“请输入工单完整标题”输入框,为其进行值绑定,绑定字段为“queryCondition.title”。
定义页面中的事件代码
通过定义页面的on-load事件,可以实现打开页面即自动展示当前工程师的待处理工单。
- 定义页面事件代码。
- 在“设计视图”中,选中最外层的“页面”。
- 在右侧“事件”页签中,单击“加载”后的“+”。
- 在添加事件弹窗中,输入如下脚本代码。
$model.ref('queryWorkOrder').setData({inputParam: {"isFME": true}}); $model.ref('queryWorkOrder').run().then(function (data) { if (data && data.workOrderList) {//将查询到的数据赋值给页面模型来展示$model.ref('workOrderList').setData(data.workOrderList);} }).catch(function (error) {console.log('error is', error); });
- 单击“创建”,退出事件编排窗口。
实现“按标题查询工单”
通过定义“查询”按钮的“点击”事件,可以实现根据工单标题查询工单的能力。
- 在“设计视图”中,选中“查询”按钮。
- 在右侧“事件”页签中,单击“点击”后的“+”。
- 在添加事件弹窗中,输入如下脚本代码。
let queryTitle = $model.ref('queryCondition').getData().title; $model.ref('queryWorkOrder').setData({ inputParam: { "title": queryTitle, "isFME": true } }); $model.ref('queryWorkOrder').run().then(function (data) {if (data && data.workOrderList) {//将查询到的数据赋值给页面模型来展示$model.ref('workOrderList').setData(data.workOrderList);} }).catch(function (error) {console.log('error is', error); });
- 单击“创建”,退出事件编排窗口。
实现“处理工单”
通过定义“处理”按钮的“点击”事件,可以实现接单、处理工单的能力。
- 在“设计视图”中,选中“处理”按钮。
- 在右侧“事件”页签中,单击“点击”后的“+”。
- 在添加事件弹窗中,输入如下脚本代码。 说明:
脚本中红色内容请替换为实际的页面名。
//获取当前组件(即button) let _component = context.$component.current; // 配置页面的bpm参数 context.$page.params["bp.name"] = "HW__WorkOrderBpm"; //获取当前行id let id = _component.$attrs.row.id; let taskId = ""; let instanceId = ""; //遍历获取当前行内容 let row = {}; let workorders = $model.ref('workOrderList').getData(); workorders.forEach(function (wo, idx) {if (wo.id == id) {row = wo;instanceId = wo.HW__instanceId__CST;} }); //打开处理弹框 context.$dialog.popup({title: '处理工单',page: 'HW__workOrderProcess',footerHide: false,width: 20,height: 180,okText: '提交',cancelText: '取消',params: { id: id, row: row },onCancel: function () {},onOk: function () {let statusInfo = { "statusInfo": $model.ref("statusInfo").getData() };let taskData = {"action": "complete","variables": statusInfo};// 获取csrf tokencontext.$utils.getCSRFToken().then(function (token) {let url = '/u-route/baas/bp/v2.0/query/tasks?flag=activeTask&rootID=' + instanceId;fetch(url, {method: 'GET',headers: {'Content-Type': 'application/json','CSRF-Token': token}}).then(function (resp) {resp.json().then(function (data) {taskId = data.result.Recs[0].id;let url2 = '/u-route/baas/bp/v2.0/runtime/tasks/' + taskId;fetch(url2, {method: 'PUT',headers: {'Content-Type': 'application/json'},body: JSON.stringify(taskData)}).then(function (resp) {context.$message.success('处理成功');$model.ref('queryWorkOrder').setData({ inputParam: {"isFME": true} });$model.ref('queryWorkOrder').run().then(function (data) {if (data && data.workOrderList) {//将查询到的数据赋值给页面模型来展示$model.ref('workOrderList').setData(data.workOrderList);}}).catch(function (error) {console.log('error is', error);});}).catch(function (error) {console.log('error is', error);});});}).catch(function (error) {console.log('error is', error);});});} });
- 单击“创建”,退出事件编排窗口。
验证
通过PC端预览页面的方式,访问“待处理工单”页面进行测试。
说明:
请在PC端预览或测试“待处理工单”标准页面,当前版本不建议在手机端预览页面。
- 打开“待处理工单”标准页面。
- 单击界面上方的
,进入预览页面。
- 查看页面的展示效果。
图16 工单列表页面
如果当前租户开发者名下没有工单,所以当前的预览效果只能看到页面框架,没有工单。
图17 无工单信息