使用 REST API 创建信封时预填充公司标签答案

【问题标题】：Prefilling company tag while creating envelope using REST API使用 REST API 创建信封时预填充公司标签
【发布时间】：2014-12-15 18:37:07
【问题描述】：

在我用来预填充公司选项卡的请求 xml 下方。基于此Docusign: creating envelopes through templates with the REST API and prefilling tags 我将角色名更改为以签名者开头，但没有帮助。我在这里错过了什么 -

<envelopeDefinition xmlns="http://www.docusign.com/restapi">
  <accountId>accountId</accountId>
  <status>sent</status>
  <compositeTemplates>
    <compositeTemplate>
      <serverTemplates>
        <serverTemplate>
          <sequence>1</sequence>
          <templateId>templateid</templateId>
        </serverTemplate>
      </serverTemplates>
      <inlineTemplates>
        <inlineTemplate>
          <sequence>1</sequence>
          <recipients>
            <signers>
              <signer>
                <email> sverma@icontract.com </email>
                <name>afhoauf vouagi</name>
                <recipientId>1</recipientId>
                <roleName>Contractor</roleName>
                <clientUserId>1</clientUserId>
                <tabs>
                  <companyTabs>
                    <company>
                      <documentId>1</documentId>
                      <pageNumber>1</pageNumber>
                      <recipientId>1</recipientId>
                      <xPosition>70</xPosition>
                      <yPosition>156</yPosition>
                      <tabLabel>Company</tabLabel>
                      <value>SomeName</value>
                      <concealValueOnDocument>false</concealValueOnDocument>
                    </company>
                  </companyTabs>
                </tabs>
              </signer>
              <signer>
                <email> </email>
                <name></name>
                <recipientId>3</recipientId>
                <roleName>Icon</roleName>
                <clientUserId>1</clientUserId>
              </signer>
            </signers>
          </recipients>
        </inlineTemplate>
      </inlineTemplates>
    </compositeTemplate>
    <compositeTemplate>
      <serverTemplates>
        <serverTemplate>
          <sequence>2</sequence>
          <templateId>templateid</templateId>
        </serverTemplate>
      </serverTemplates>
      <inlineTemplates>
        <inlineTemplate>
          <sequence>1</sequence>
          <recipients>
            <signers>
              <signer>
                <email> sverma@icontract.com </email>
                <name>afhoauf vouagi</name>
                <recipientId>1</recipientId>
                <roleName>Contractor</roleName>
                <clientUserId>1</clientUserId>
                <tabs></tabs>
              </signer>
              <signer>
                <email> </email>
                <name></name>
                <recipientId>3</recipientId>
                <roleName>Icon</roleName>
                <clientUserId>1</clientUserId>
              </signer>
            </signers>
          </recipients>
        </inlineTemplate>
      </inlineTemplates>
    </compositeTemplate>
    <compositeTemplate>
      <serverTemplates>
        <serverTemplate>
          <sequence>3</sequence>
          <templateId>templateid</templateId>
        </serverTemplate>
      </serverTemplates>
      <inlineTemplates>
        <inlineTemplate>
          <sequence>1</sequence>
          <recipients>
            <signers>
              <signer>
                <email> sverma@icontract.com </email>
                <name>afhoauf vouagi</name>
                <recipientId>1</recipientId>
                <roleName>Contractor</roleName>
                <clientUserId>1</clientUserId>
                <tabs></tabs>
              </signer>
              <signer>
                <email> </email>
                <name></name>
                <recipientId>3</recipientId>
                <roleName>Icon</roleName>
                <clientUserId>1</clientUserId>
              </signer>
            </signers>
          </recipients>
        </inlineTemplate>
      </inlineTemplates>
    </compositeTemplate>
    <compositeTemplate>
      <serverTemplates>
        <serverTemplate>
          <sequence>4</sequence>
          <templateId>templateid</templateId>
        </serverTemplate>
      </serverTemplates>
      <inlineTemplates>
        <inlineTemplate>
          <sequence>1</sequence>
          <recipients>
            <signers>
              <signer>
                <email> sverma@icontract.com </email>
                <name>afhoauf vouagi</name>
                <recipientId>1</recipientId>
                <roleName>Contractor</roleName>
                <clientUserId>1</clientUserId>
                <tabs></tabs>
              </signer>
              <signer>
                <email> </email>
                <name></name>
                <recipientId>3</recipientId>
                <roleName>Icon</roleName>
                <clientUserId>1</clientUserId>
              </signer>
            </signers>
          </recipients>
        </inlineTemplate>
      </inlineTemplates>
    </compositeTemplate>
    <compositeTemplate>
      <serverTemplates>
        <serverTemplate>
          <sequence>5</sequence>
          <templateId>templateid</templateId>
        </serverTemplate>
      </serverTemplates>
      <inlineTemplates>
        <inlineTemplate>
          <sequence>1</sequence>
          <recipients>
            <signers>
              <signer>
                <email> sverma@icontract.com </email>
                <name>afhoauf vouagi</name>
                <recipientId>1</recipientId>
                <roleName>Contractor</roleName>
                <clientUserId>1</clientUserId>
                <tabs></tabs>
              </signer>
              <signer>
                <email> </email>
                <name></name>
                <recipientId>3</recipientId>
                <roleName>Icon</roleName>
                <clientUserId>1</clientUserId>
              </signer>
            </signers>
          </recipients>
        </inlineTemplate>
      </inlineTemplates>
    </compositeTemplate>
  </compositeTemplates>
</envelopeDefinition>

【问题讨论】：

标签： docusignapi

【解决方案1】：

我不确定您为什么将 roleName 更改为以“签名者”开头，这绝对不是必需的，您链接到的帖子也没有说明您必须使用它。相反，这可能是您的问题所在。

您需要确保您使用的角色名称与您在 API 请求的模板中保存的角色名称相同。例如，如果您通过控制台创建一个模板并为其赋予一个名为“客户”的角色，那么在您的 api 请求中您需要引用相同的名称来将接收者分配给该角色，即：

<signers>
    <signer>
        <email> sverma@icontract.com </email>
        <name>afhoauf vouagi</name>
        <recipientId>1</recipientId>
        <roleName>Customer</roleName>
        ...

另外，我不确定这是否是 Stack Overflow 出现的复制粘贴错误，但您应该删除收件人电子邮件周围的多余空格：

<email> sverma@icontract.com </email>

【讨论】：

谢谢埃尔金。我在两个地方（即模板和请求）都将角色名更改为签名者，所以我在两个地方都使用了相同的角色名。同样在帖子中，提问者有一个更新，他指定使用以签名者开头的角色名解决了他的问题，所以我也尝试了 - 它填充了！似乎如果我以除 Signer 以外的任何名称开始角色名称，它就不起作用。诡异的！是的，在这种情况下，我将 Docusign 上的角色名称从 Random1 更改为 Signer2。例如，Signer3 也有效。
另外，如果我更改 tabLabel 并为其设置一些值，它会在文档中创建一个新选项卡，但即使那个选项卡也没有显示任何值

【解决方案2】：

我不确定您是否可以为名为“公司”的标签设置值。我认为这与 DocuSign 的内置公司标签冲突，该标签只能由签名者填写。如果您需要预填充这样的标签，只需使用普通文本选项卡并将名称/标签设置为其他内容。例如。 “公司名称”

【讨论】：