如何使用iText7修改XFA表单XDP的form数据流实现表单填充

实现逻辑 #

直接操作PDF底层的XFA资源数组，定位form对应的流对象，修改后回写即可，不需要调用封装好的FillXfaForm方法：

1. 加载目标PDF，获取XFA资源数组
2. 定位form条目对应的流对象，读取其XML内容
3. 按需修改XML中的字段值，重新计算form节点的checksum值
4. 将修改后的XML内容写回流，保存PDF即可

完整代码示例 #

using iText.Forms;
using iText.Kernel.Pdf;
using System;
using System.IO;
using System.Linq;
using System.Security.Cryptography;
using System.Text;
using System.Xml.Linq;

class XfaFormModifier
{
    static void Main(string[] args)
    {
        string inputPdfPath = "你的输入PDF路径.pdf";
        string outputPdfPath = "你的输出PDF路径.pdf";

        using (PdfReader reader = new PdfReader(inputPdfPath))
        using (PdfWriter writer = new PdfWriter(outputPdfPath))
        using (PdfDocument pdfDoc = new PdfDocument(reader, writer))
        {
            // 获取XFA表单对象
            XfaForm xfaForm = PdfAcroForm.GetAcroForm(pdfDoc, true).GetXfaForm();
            PdfArray xfaArray = xfaForm.GetXfaResource();

            // 遍历XFA数组找到form对应的流
            PdfStream formStream = null;
            for (int i = 0; i < xfaArray.Size(); i++)
            {
                // XFA数组结构为 [键1, 流引用1, 键2, 流引用2...]
                if (xfaArray.Get(i) is PdfName name && name.GetValue() == "form")
                {
                    // 下一个元素就是form对应的流引用
                    formStream = xfaArray.Get(i + 1).GetIndirectReference().GetRefersTo() as PdfStream;
                    break;
                }
            }

            if (formStream == null)
            {
                throw new Exception("未找到XFA中的form流");
            }

            // 读取form流的XML内容
            byte[] formBytes = formStream.GetBytes();
            string formXmlStr = Encoding.UTF8.GetString(formBytes);
            XDocument formXml = XDocument.Parse(formXmlStr);
            XNamespace ns = "http://www.xfa.org/schema/xfa-form/2.8/";

            // 示例：修改NumeroEvenement字段的值
            var targetField = formXml.Descendants(ns + "field")
                .FirstOrDefault(f => f.Attribute("name")?.Value == "NumeroEvenement");
            if (targetField != null)
            {
                var textNode = targetField.Descendants(ns + "text").FirstOrDefault();
                if (textNode != null)
                {
                    textNode.Value = "你要修改的新值99887766";
                }
            }

            // 示例：修改txt0_UnitePlaignante字段的值
            var unitField = formXml.Descendants(ns + "field")
                .FirstOrDefault(f => f.Attribute("name")?.Value == "txt0_UnitePlaignante");
            if (unitField != null)
            {
                var textNode = unitField.Descendants(ns + "text").FirstOrDefault();
                if (textNode != null)
                {
                    textNode.Value = "300";
                }
            }

            // 重新计算form节点的checksum（必填，否则阅读器会忽略修改）
            string modifiedXmlStr = formXml.ToString();
            byte[] modifiedBytes = Encoding.UTF8.GetBytes(modifiedXmlStr);
            using (SHA1 sha1 = SHA1.Create())
            {
                byte[] hashBytes = sha1.ComputeHash(modifiedBytes);
                string newChecksum = Convert.ToBase64String(hashBytes);
                formXml.Root.Attribute("checksum").Value = newChecksum;
            }

            // 将修改后的XML写回流
            byte[] finalBytes = Encoding.UTF8.GetBytes(formXml.ToString());
            formStream.SetData(finalBytes);

            // 保存PDF
            pdfDoc.Close();
        }
    }
}

注意事项 #

• 代码中的命名空间需要和你实际form节点的xmlns保持一致，示例用的是你提供的http://www.xfa.org/schema/xfa-form/2.8/，如果版本不同要对应修改
• 如果是Python环境，逻辑完全一致，调用iText7 for Python的对应API即可，底层操作XFA数组和流的逻辑没有区别
• 修改完成后可以用Adobe Acrobat打开验证，普通PDF阅读器可能不支持XFA表单渲染

内容的提问来源于stack exchange，提问作者Gab ПК