Power Automate生成的Repeating Section Content Control在Word Online正常但桌面版异常

一、Power Automate端修复方案 #

• 检查重复内容控件的XML绑定
  确保模板中Repeating Section Content Control绑定的是唯一的XML节点集合，而非单个节点。在Word设计模式下：

  1. 选中重复控件，右键选择「属性」
  2. 确认「XML映射」中绑定的是数组型节点（比如/root/items/item），而非单个/root/items/item[1]
  3. 内部嵌套的文本控件必须绑定到子节点（如item/name、item/desc），不能直接绑定父节点

• 修改Power Automate填充逻辑
  避免直接对重复控件进行「替换文本」操作，改用「Populate a Microsoft Word template」动作的原生重复字段映射：

  1. 上传模板时，确保Power Automate正确识别重复字段集合（会自动生成「Apply to each」循环）
  2. 在循环内为每个子控件单独赋值，不要批量替换整个重复段的HTML或文本

• 禁用Word的控件自动更新
  生成文档后，添加「Run script」动作执行Word脚本，强制锁定重复控件的内容：

  async function main(context: Word.RequestContext) {
    const doc = context.document;
    const contentControls = doc.contentControls;
    for (let cc of contentControls.items) {
      if (cc.type === Word.ContentControlType.repeatingSection) {
        cc.lockContentControl = true;
        cc.lockContents = true;
      }
    }
    await context.sync();
  }
  

  注：此脚本需在Power Automate中启用Word Online脚本权限

二、PHP端替代方案 #

如果Power Automate的问题无法快速修复，可直接用PHP生成符合要求的Word文档：

• 使用PHPWord库
  直接通过PHP动态生成包含重复段落的Word文档，完全绕过Power Automate的控件兼容性问题：

  require_once 'vendor/autoload.php';
  
  $phpWord = new \PhpOffice\PhpWord\PhpWord();
  $section = $phpWord->addSection();
  
  // 模拟用户输入的重复数据
  $items = [
      ['name' => '商品A', 'desc' => '描述A'],
      ['name' => '商品B', 'desc' => '描述B'],
      ['name' => '商品C', 'desc' => '描述C'],
  ];
  
  // 添加重复段落
  foreach ($items as $item) {
      $section->addText("名称: {$item['name']}");
      $section->addText("描述: {$item['desc']}");
      $section->addTextBreak();
  }
  
  // 生成文档并保存/发送
  $writer = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
  $writer->save('output.docx');
  

  支持富文本、表格等复杂格式，生成的文档在桌面版Word中无兼容性问题

• 生成PDF替代Word
  如果客户接受PDF格式，可使用TCPDF或DomPDF将HTML内容转为PDF，完全避免Word控件的兼容性问题：

  require_once 'tcpdf/tcpdf.php';
  
  $pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
  $pdf->AddPage();
  
  $html = '<h1>订单详情</h1>';
  $html .= '<table border="1">';
  $html .= '<tr><th>名称</th><th>描述</th></tr>';
  foreach ($items as $item) {
      $html .= "<tr><td>{$item['name']}</td><td>{$item['desc']}</td></tr>";
  }
  $html .= '</table>';
  
  $pdf->writeHTML($html, true, false, true, false, '');
  $pdf->Output('output.pdf', 'I');
  

三、临时应急方案 #

如果以上方案都无法快速落地，可在Power Automate生成文档后，添加「Convert Word document to PDF」动作，将文档转为PDF发送给客户，PDF在桌面端显示无异常

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