如何在基于FTL的DocuSign模板中动态引用元素的所在页码

嘿，刚好碰到过类似的需求，咱们来捋捋怎么解决这个问题～

首先得明确：DocuSign本身并没有像LaTeX那样直接支持“标记元素后自动生成交叉引用页码”的原生标签，但结合你用的FTL模板和DocuSign的API能力，完全可以实现动态页码引用，下面是两种可行的方案：

方案一：预生成文档时计算页码（适合内容固定或可预渲染的场景） #

因为你是用FTL生成模板再填充内容，那可以在最终文档生成阶段先搞定页码计算：

• 第一步：在FTL模板里给需要引用的表格留好标记，同时在引用页码的位置定义FTL变量，比如：

  <!-- 表格所在位置 -->
  <table id="peopleTable">
    <!-- 表格内容 -->
  </table>
  
  <!-- 引用位置 -->
  <p>See table in page ${peopleTablePage}</p>
  

• 第二步：当你用FTL填充变量生成完整的HTML后，先把这个HTML转换成PDF（可以用wkhtmltopdf、Puppeteer这类工具），然后通过PDF解析工具（比如PyPDF2、iText）定位到peopleTable这个元素所在的页码。
• 第三步：把获取到的页码值赋值给peopleTablePage变量，重新渲染FTL模板得到最终的文档，再上传到DocuSign发送信封。

方案二：利用DocuSign自定义字段+API获取页码（适合DocuSign模板直接编辑的场景） #

如果你们是直接在DocuSign模板编辑器里结合FTL变量，也可以用自定义字段来做标记：

• 第一步：在DocuSign模板中，给表格所在的位置添加一个隐藏的文本自定义字段（比如命名为peopleTableMarker），确保这个字段和表格在同一页面。
• 第二步：在需要引用页码的位置，添加一个普通文本字段（或者用FTL变量占位），用来显示最终的页码。
• 第三步：当你准备发送信封时，调用DocuSign的API获取文档的字段信息，找到peopleTableMarker字段所在的页码，然后把这个页码值填充到引用位置的文本字段中，再完成信封的发送。

重要提醒 #

不管用哪种方案，一定要确保是在所有动态内容都填充完成后再计算页码，不然如果因为内容增减导致页数变化，之前算的页码就会出错啦！

备注：内容来源于stack exchange，提问作者uzluisf