组装“待处理工单”页面

页面组件分析

分析图1的组成，可以将整个页面分割为3个区域：页面标题、查询条件和待处理工单列表区域，如图2所示。

待处理工单列表通过在列表视图中，使用2个“分栏”的嵌套，组装出待处理工单列表区。

图2 页面组件分析

操作步骤

以下操作步骤只是给出的大致的拖拽方法，您可以根据需要，修改各组件的颜色、对齐方式、边距显示样式，使页面更美观。

1. 在“我的应用”中，单击“设备维修管理系统”，进入应用。
2. 鼠标放在“Page”上，单击界面上出现的“+”，在弹出菜单中选择“标准页面”。
3. 在“标签”和“名称”文本框中输入“workOrderListM”，单击“添加”。

   当编辑已有标准页面时，为防止编辑时多人篡改，编辑前请单击进行锁定。

4. 单击页面右上部的Mobile图标，切换到手机端设计模式。
5. 组装“页面标题区”。
   1. 从基本组件列表区，拖拽1个“标题”组件到“页面内容”。
   2. 选中“标题”组件，在右侧“属性”页签，配置标题组件属性：
      1. 修改“标题内容”为“工单列表”。
      2. 在“样式”下的“高级设置”中，输入如下样式代码，即设置标题组件的背景色、水平居中对齐，文字颜色为白色。

         :root{
         text-align:center;
         background-color:#4a90e2;
         color:#FFFFFF;
         opacity:0.9;
         }

         图3 高级设置
         

6. 组装“查询条件区”。
   1. 拖拽1个“分栏”到“工单列表”之后，在右侧“行布局”下先单击PC中的2栏图标，再单击Phone下的2栏图标，将分栏设置为左右不均分的2栏，如下图所示。
      图4 拖入分栏组件并设置为2栏
      
   2. 选中左侧“栏”，在“样式 > 高级设置”下输入样式代码，设置宽度为75%，高度为40px。
      图5 修改列宽度
      

      :root{
      width:75%;
      height:40px;
      }

   3. 选中右侧“栏”，同样方式设置宽度为25%，高度为40px。

      :root{
      width:25%;
      height:40px;
      }

   4. 拖拽1个“输入框”组件到“分栏”的左栏，修改其“占位符”为“请输入工单完整标题”。
   5. 拖拽1个“按钮”组件到“分栏”的右栏，修改其“显示名称”为“查询”、“类型”为“主要按钮”。
   6. 选择“请输入工单完整标题”所在的“栏”，设置“弹性布局”，并修改内边距为“10px”。
      图6 设置栏属性
      

7. 组装“待处理工单列表区”。
   1. 在“分栏”之后，拖入1个“ 列表视图”组件。
      图7 拖入列表视图
      
   2. 在“列表视图容器”下层的“列表视图”中，拖入1个“分栏”，在右侧修改为1个栏（Phone），并设置分栏内边距为“10px”。
      图8 修改分栏为1栏及内边距
      
   3. 在“分栏”中，再拖入1个“分栏”，并参考上图修改为1个栏（Phone），然后单击分栏的7次，新增7个分栏，新增后，变为8个分栏。
   4. 向第1~7分栏中，分别拖拽2个“标签”组件（并排），然后在第8分栏中，拖入一个“按钮”组件。
   5. 修改第1分栏中的第1个标签的“文本内容”修改为“标题：”。
      图9 修改第1个标签标题
      
   6. 重复上一步，修改第2~7分栏中的第1个标签的“文本内容”为“单号：”、“状态：”、“时间：”和“优先级：”。

      表1 标签的文本内容

      所在分栏	第一栏	第二栏
      1	标题：	保持默认（label）
      2	单号：	保持默认（label）
      3	状态：	保持默认（label）
      4	要求到达时间：	保持默认（label）
      5	要求解决时间：	保持默认（label）
      6	现场故障说明：	保持默认（label）
      7	优先级：	保持默认（label）

      

      正常情况下，第二栏中的内容是动态获取的，在表3中，设置的第二栏中的“文本内容”，仅会在未获取相应工单信息时显示，您也可以根据实际需要自定义“标题”组件默认显示内容。

   7. 在“样式”属性下，自定义修改各个标签组件的样式，例如加粗文本。
      图10 自定义修改样式
      
   8. 在第8行内，选中“按钮”组件，设置按钮“显示名称”为“处理”、“类型”为“主要按钮”，您也可以在属性中为按钮添加图标，修改按钮背景色为“#4a90e2”。

      组装完成效果，如图11所示。

      图11 组装工单信息展示区域
      

8. 单击界面上方的，保存页面。

定义模型并绑定页面组件

页面模型负责与页面组件交互，获取显示工单需要的数据。结合页面展示需求，可知需要创建如下模型：

1. 定义模型“workOrderList”。
   1. 单击“模型视图”，切换到模型视图。
   2. 在模型视图中，单击“新增模型”。
   3. 添加自定义模型，模型名称“workOrderList”，单击“下一步”。
   4. 单击“新增节点”，依次增加表2中列出的字段名称，单击“下一步”，再单击“确定”。
   5. 单击页面上方的，保存模型。

2. 定义模型“queryCondition”。
   1. 在“模型视图”中，单击“新增模型”。
   2. 添加自定义模型，模型名称“queryCondition”，单击“下一步”。
   3. 单击“新增节点”，依次增加表2中列出的字段名称，单击“下一步”，再单击“确定”。
   4. 单击页面上方的，保存模型。

3. 定义模型“total”。
   1. 在“模型视图”中，单击“新增模型”。
   2. 添加自定义模型，模型名称“total”，单击“下一步”。
   3. 单击“新增节点”，依次增加表2中列出的字段名称，单击“下一步”，再单击“确定”。
   4. 单击页面上方的，保存模型。

4. 定义模型“queryWorkOrder”。
   1. 在“模型视图”中，单击“新增模型”。
   2. 添加服务模型，模型名称“queryWorkOrder”，单击“下一步”，
   3. “服务类型”选择“公共接口”，“选择项目”为“设备维修管理系统”，“搜索”中的接口选择“queryWorkOrder”，单击“下一步”，再单击“确定”。
   4. 单击页面上方的，保存模型。

5. 绑定模型“workOrderList”。
   1. 单击“设计视图”，从“模型视图”切换到“设计视图”。
   2. 选中“列表视图容器”标签中的“列表视图”标签（不要选择列表视图容器），为其绑定“workOrderList”。
      图12 绑定数据模型
      
   3. 如图13所示，选中“标题：”后的标签组件label，在右侧“属性”页签，单击“+”，增加属性值绑定，即设置“属性”为“文本内容”，“模型字段”为“workOrderList”下的“HW__title__CST”。
      图13 为标签绑定模型
      
   4. 依次为其他标签添加属性值绑定，具体绑定的字段如表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

   5. 为“处理”按钮添加属性值绑定，“属性”设置为“禁用”，绑定“workOrderList”的“isDeal”字段，绑定后为“workOrderList.isDeal”。
      图14 添加属性值绑定
      
   6. 单击页面上方的，保存设置。

6. 绑定模型“queryCondition”。
   1. 选中“请输入工单完整标题”输入框，为其进行值绑定，绑定字段为“queryCondition.title”。
      图15 绑定工单标题
      
   2. 单击页面上方的，保存设置。

定义页面中的事件代码

通过定义页面的on-load事件，可以实现打开页面即自动展示当前工程师的待处理工单。

1. 定义页面事件代码。
   1. 在“设计视图”中，选中最外层的“页面”。
   2. 在右侧“事件”页签中，单击“加载”后的“+”。
   3. 在添加事件弹窗中，输入如下脚本代码。

      $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);
      });

   4. 单击“创建”，退出事件编排窗口。

实现“按标题查询工单”

通过定义“查询”按钮的“点击”事件，可以实现根据工单标题查询工单的能力。

1. 在“设计视图”中，选中“查询”按钮。
2. 在右侧“事件”页签中，单击“点击”后的“+”。
3. 在添加事件弹窗中，输入如下脚本代码。

   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);
   });

4. 单击“创建”，退出事件编排窗口。

实现“处理工单”

通过定义“处理”按钮的“点击”事件，可以实现接单、处理工单的能力。

1. 在“设计视图”中，选中“处理”按钮。
2. 在右侧“事件”页签中，单击“点击”后的“+”。
3. 在添加事件弹窗中，输入如下脚本代码。
   

   脚本中红色内容请替换为实际的页面名。

   //获取当前组件（即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 token
           context.$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);
               });
           });
       }
   });

4. 单击“创建”，退出事件编排窗口。

验证

通过PC端预览页面的方式，访问“待处理工单”页面进行测试。

请在PC端预览或测试“待处理工单”标准页面，当前版本不建议在手机端预览页面。

1. 打开“待处理工单”标准页面。
2. 单击界面上方的，进入预览页面。
3. 查看页面的展示效果。
   图16 工单列表页面
   

   如果当前租户开发者名下没有工单，所以当前的预览效果只能看到页面框架，没有工单。

   图17 无工单信息