使用带有 Tiff 文件的 AchorString 的 DocuSign 错误（C# SDK）答案

【问题标题】：DocuSign Error Using AchorString With Tiff Files (C# SDK)使用带有 Tiff 文件的 AchorString 的 DocuSign 错误（C# SDK）
【发布时间】：2018-12-06 16:01:40
【问题描述】：

我正在使用 DocuSign C# SDK 发送文档。我正在使用 AnchorString 功能来帮助 DocuSign 确定签名和日期在文档上的位置。这适用于 PDF 文件，但在使用 Tiff 文件（LZW 和 CCITT4 格式）时出现以下错误。是否有更优选的方法将签名锚定到文档？我似乎无法在网上找到很多关于此错误的信息。

当我使用 AnchorStrings 功能（代码包含在下面）调用 CreateEnvelop 时出现以下错误：

调用 CreateEnvelope 时出错：{ "errorCode": "ANCHOR_TAB_STRING_NOT_FOUND", "message": "在文档中找不到指定的 Anchor Tab 字符串。Anchor Tab String \"Signature:\" not found.Anchor Tab String \"Signed:\" not found." }

代码：

  Signer signer = new Signer();

  DateSigned dateSigned = new DateSigned() { AnchorString = "Signed:", Name = "Signed:", AnchorXOffset = "35" };

  signer.Tabs.DateSignedTabs.Add(dateSigned);      
  signer.Tabs.SignHereTabs = new List<SignHere>();    
  SignHere signHere = new SignHere() { AnchorString = "Signature:", Name = "Signature:", AnchorXOffset = "65" };
  signer.Tabs.SignHereTabs.Add(signHere);

更新：

我得到的 ANCHOR_TAG_PROCESSING_FAILURE 错误是因为我没有将 FileExtension 属性设置为 TIFF。我将上述错误更新为使用该属性集收到的错误。

注意：当我创建没有锚字符串的信封时，我没有收到该错误消息。

交叉发布：https://support.docusign.com/s/question/0D51W00006JzLHgSAN/error-using-achorstring-with-tiff-files-c-sdk

【问题讨论】：

标签： c# docusignapi

【解决方案1】：

TL;DR：当源文档使用 tiff、jpg、png、gif 等图像格式时，锚字符串定位将不起作用。您需要使用精确定位。

详情

锚字符串系统通过查找锚字符串的文字字符来工作。在您的情况下，“签名：”因此这些字符需要在 pdf 文档中。（DocuSign 将所有传入的文档格式转换为 PDF。）

对于使用 tiff 等图像格式的原始文档，原始文档不包含字符“Sign:”（或任何其他字符）。相反，图像格式包含文档中单词的图像。

由于文档是图像，因此无法定位文字。您需要为标签使用绝对定位。（或切换到不同的源文档格式，如 .docx、.html、.pdf 等）

【讨论】：

谢谢拉里。我不确定这将如何处理图像。我假设他们对图像使用了某种类型的图像识别，因为 TIFF 是 DocuSign 支持的格式。我的文档是动态的，所以 Y 坐标总是不同的。看来我得计算一下了。
另一个选项，取决于您的业务案例，是添加一个“签名页”，它将跟随 tiff 文档。签名者只会看到页面流。由于您正在创建签名页面，因此您可以使用 html 或 pdf 源代码，并且可以使用锚文本定位。

【解决方案2】：

您的文档似乎无法得到处理，这与您使用锚的方式无关，这是文档无效

【讨论】：

感谢您的回答。请查看我最近的编辑。