使用文档 .hml 格式而不是 .pdf
Use document .hml format instead of .pdf
上下文：
我在 webapi 中使用 DocuSign.eSign nuget 包向客户发送用于签名的 PDF 文件，这是按预期工作的（我处于大局的初始阶段）。
问题：
我一直在阅读 here 可以发送 .html 文档以供签名。我期待找到一些文档或片段示例，说明我应该如何发送带有 .html 文档的信封以供签名。
动机：
这将是一种非常好的方式来处理（节省数周的编码时间）普通 html 而不是使用 PDF 生成来进行花哨的文档设计并且具有不同的宽度和高度或者没有固定的签名或其他输入需要的位置降落。
问题：
是否可以在我可以找到更多详细信息的地方执行此操作？如果可能的话，我需要如何定义签名者标签？ pdf 的宽度 x 高度或 html 标签 + 属性。
提前致谢。
一般来说，放置 DocuSign 标签的方法有以下三种：
- 绝对（或固定）定位。
- 相对（又名锚点或自动放置）定位。
- PDF 表单域
绝对定位
当您拥有不经常更改的固定文档或文档，并且您可以通过反复试验来找到运行良好的位置，然后保存这些位置以供将来使用时，这将非常有用。坐标系以页面左上角为原点 (0,0)，您指定页码和 x,y（以像素为单位）作为您想要标签的位置。例如，要将一个签名标签放置在第一个文档第 1 页左上角向右 100 像素和向下 200 像素的位置：
{
"signHereTabs": [
{
"xPosition": "100",
"yPosition": "200",
"documentId": "1",
"pageNumber": "1"
}
]
}
相对（又名锚标记或自动放置）定位
使用锚标记，您可以告诉系统根据文档内容本身在您的文档上放置签名标签（或任何其他 DocuSign 标签）。例如，如果您的文档中有文本
"Please Sign Here"
然后您可以让系统在该位置放置一个签名标签，或者更好的是，在该位置放置一个以英寸、像素、毫米等为单位的偏移量。例如，如果您想要放置一个签名标签距文本 "Please Sign Here"
向右 1 英寸，向下 0.5 英寸
{
"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 找到。
上下文： 我在 webapi 中使用 DocuSign.eSign nuget 包向客户发送用于签名的 PDF 文件，这是按预期工作的（我处于大局的初始阶段）。
问题： 我一直在阅读 here 可以发送 .html 文档以供签名。我期待找到一些文档或片段示例，说明我应该如何发送带有 .html 文档的信封以供签名。
动机： 这将是一种非常好的方式来处理（节省数周的编码时间）普通 html 而不是使用 PDF 生成来进行花哨的文档设计并且具有不同的宽度和高度或者没有固定的签名或其他输入需要的位置降落。
问题： 是否可以在我可以找到更多详细信息的地方执行此操作？如果可能的话，我需要如何定义签名者标签？ pdf 的宽度 x 高度或 html 标签 + 属性。
提前致谢。
一般来说，放置 DocuSign 标签的方法有以下三种：
- 绝对（或固定）定位。
- 相对（又名锚点或自动放置）定位。
- PDF 表单域
绝对定位
当您拥有不经常更改的固定文档或文档，并且您可以通过反复试验来找到运行良好的位置，然后保存这些位置以供将来使用时，这将非常有用。坐标系以页面左上角为原点 (0,0)，您指定页码和 x,y（以像素为单位）作为您想要标签的位置。例如，要将一个签名标签放置在第一个文档第 1 页左上角向右 100 像素和向下 200 像素的位置：
{
"signHereTabs": [
{
"xPosition": "100",
"yPosition": "200",
"documentId": "1",
"pageNumber": "1"
}
]
}
相对（又名锚标记或自动放置）定位
使用锚标记，您可以告诉系统根据文档内容本身在您的文档上放置签名标签（或任何其他 DocuSign 标签）。例如，如果您的文档中有文本
"Please Sign Here"
然后您可以让系统在该位置放置一个签名标签，或者更好的是，在该位置放置一个以英寸、像素、毫米等为单位的偏移量。例如，如果您想要放置一个签名标签距文本 "Please Sign Here"
向右 1 英寸，向下 0.5 英寸{
"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 找到。