使用文档.hml格式而不是.pdf

Question

上下文： 我在webapi中使用DocuSign.eSign nuget软件包发送PDF文件以便签名给客户，这是按预期工作的（我在初始阶段进入大图）。

问题： 我一直在阅读here .html文件可以发送签名。我期待找到一些文档或代码示例，说明如何使用.html文档发送信封进行签名。

动机： 这将是一个非常好的方式来处理（节省数周的编码）与普通的HTML，而不是使用PDF生成花哨的文档设计和具有不同的宽度和高度或没有固定的位置位置签名或其他输入需要着陆。

问题： 我可以在哪里找到更多细节吗？如果可能，我将如何定义签名者选项卡？宽度x高度，适用于pdf＆＃39; s或html标签+属性。

提前致谢。

Answer 1

一般来说，有三种放置DocuSign标签的方法：

1. 绝对（或固定）定位。
2. 相对（又名Anchor或AutoPlace）定位。
3. PDF表单字段

绝对定位

当您拥有不经常更改的固定文档或文档时，这非常有用，您可以通过试验和错误来查找运行良好的位置，然后保存这些位置以备将来使用。坐标系使用原点（0,0）作为页面的左上角，并指定页码和x，y，以像素为单位指示选项卡的位置。例如，要将一个签名选项卡放置在第一个文档的第1页左上角100个像素和200个像素的位置：

{
    "signHereTabs": [
        {
            "xPosition": "100",
            "yPosition": "200",
            "documentId": "1",
            "pageNumber": "1"
        }
    ]
}   

相对（又名锚定标记或自动放置）定位

使用锚点标记，您可以告诉系统根据文档内容本身在文档上放置签名选项卡（或任何其他DocuSign选项卡）。例如，如果您的文档中有文本

＆＃34;请在此处签名＆＃34;

然后，您可以让系统在该位置放置一个签名选项卡，甚至更好，在该位置放置一个偏移量，以英寸，像素，毫米等为单位。例如，如果要放置签名选项卡向右1英寸，距离文本向下0.5英寸＆＃34;请在此处签名＆＃34;

{  
    "signHereTabs":[  
        {  
            "anchorString":"Please Sign Here",
            "anchorXOffset":"1",
            "anchorYOffset":".5",
            "anchorUnits":"inches",
            "recipientId":"1"
        }
    ]
}

请注意，您没有为锚定选项卡指定pageNumber，这意味着系统会在您在文档中找到anchorString值时放置选项卡。

PDF表单字段定位

您还可以提供包含表单字段的（非展平的）PDF文件，并让DocuSign平台将PDF字段转换为DocuSign字段，位于相同的位置。此外，您可以告诉系统根据字段名称转换为特定的选项卡类型。有关详细信息，请参阅此API指南page上的转换PDF字段部分。

所有这些信息都可以通过DocuSign Developer Center找到。