ProcessMaker 3.8.3：Excel上传自动填充Grid列故障排查求助

问题背景 #

在ProcessMaker 3.8.3中搭建流程，Dynaform包含文件上传控件、列名为Name/Address/City/Contact Num的Grid及提交按钮，目标是上传Excel后自动将表格数据填充至Grid，但触发器执行后Grid无数据填充。

核心问题分析 #

原代码存在几个关键问题：

1. 自定义文件路径易出错，未使用ProcessMaker内置的文件路径常量
2. Grid数据格式不匹配：ProcessMaker的Grid要求关联数组（键名对应列名），原代码用了索引数组
3. 未处理Excel表头行，可能导致表头被导入Grid
4. 缺乏错误捕获机制，无法定位加载Excel时的异常

修正后的触发器代码 #

// 加载PhpSpreadsheet库，使用ProcessMaker内置的composer路径
require_once PATH_CORE . 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;

// 获取上传文件ID，确保变量名与Dynaform中文件上传控件一致
$fileId = @@excel_file;
if (empty($fileId)) {
    throw new Exception("请先上传Excel文件");
}

// 使用ProcessMaker内置常量获取文件存储路径，避免路径错误
$filePath = PATH_DOCUMENT . $fileId;

// 加载Excel文件并捕获异常
try {
    $spreadsheet = IOFactory::load($filePath);
    $worksheet = $spreadsheet->getActiveSheet();
} catch (Exception $e) {
    throw new Exception("Excel文件加载失败: " . $e->getMessage());
}

$gridData = [];
$rowCount = 0;

// 遍历Excel行，跳过表头（若Excel第一行为表头）
foreach ($worksheet->getRowIterator() as $row) {
    $rowCount++;
    // 跳过第一行表头，若Excel无表头可删除此判断
    if ($rowCount === 1) {
        continue;
    }

    $cellIterator = $row->getCellIterator();
    $cellIterator->setIterateOnlyExistingCells(false); // 确保遍历所有列，包括空单元格

    $cellValues = [];
    foreach ($cellIterator as $cell) {
        $cellValues[] = $cell->getValue();
    }

    // 按照Grid列名构建关联数组，键名必须与Dynaform中Grid列名完全匹配
    $gridRow = [
        'Name' => $cellValues[0] ?? '',
        'Address' => $cellValues[1] ?? '',
        'City' => $cellValues[2] ?? '',
        'Contact Num' => $cellValues[3] ?? ''
    ];

    $gridData[] = $gridRow;
}

// 将数据赋值给Grid变量，确保变量名与Dynaform中Grid控件ID一致
@@excel_grid = $gridData;

关键配置与排查步骤 #

1. 确认PhpSpreadsheet安装：在ProcessMaker根目录执行composer require phpoffice/phpspreadsheet，确保库已正确安装
2. 变量名匹配：Dynaform中文件上传控件的变量名必须为excel_file，Grid控件的变量名必须为excel_grid，与代码中完全一致
3. 触发器执行时机：设置触发器在Dynaform步骤之后执行（用户提交Dynaform后立即运行）
4. Excel格式规范：确保Excel第一列为Name、第二列为Address、第三列为City、第四列为Contact Num，无合并单元格
5. 调试方法：可在代码末尾添加@@debug_log = print_r($gridData, true);，在Dynaform中添加文本框绑定@@debug_log，查看数据生成情况

内容的提问来源于stack exchange，提问作者Ashesh Pradhan