复合模板的意外行为

时间:2017-02-01 19:50:26

标签: docusignapi docusigncompositetmplts

我在理解内联模板的工作方式时遇到了问题。我有2个服务器模板和2个内联模板,1个内联模板可以与服务器模板结合使用。我想看看我是否填写了信封仍然有效的内联模板的信息。这是我的要求:

请求

{
  "compositeTemplates": [
    {
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "8a3a21af-4348-45e1-85b9-72a331c9c67a"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "1",
          "recipients": {
            "signers": []
          }
        }
      ],
      "document": {
        "documentId": "2",
        "name": "FinalSale.docx",
        "fileExtension": "docx",
        "documentBase64": [bytearray]
      }
    },
    {
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "d22048be-4bfe-43c2-9acf-3d5bcd79144f"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "1",
          "recipients": {
            "signers": [
              {
                "name": "Kathy Keaton",
                "email": "KathyKeaton1@outlook.com",
                "recipientId": "1",
                "accessCode": "5000",
                "routingOrder": "1",
                "roleName": "##Buyer1"
              },
              {
                "name": "Kathy Lloyd",
                "email": "KathyLloyd1@outlook.com",
                "recipientId": "2",
                "accessCode": "5000",

                "routingOrder": "2",
                "roleName": "##Seller1"
              }
            ]
          }
        }
      ],
      "document": {
        "documentId": "1",
        "name": "Going to test out signatures and initials.docx",
        "fileExtension": "docx",
        "documentFields": [
          {
            "name": "dgsvalue",
            "value": "dgs-222"
          }
        ],
        "documentBase64": [bytearray]
      }
    }
  ],
  "status": "sent",
  "emailSubject": "Please sign the following 2 documents at 2:39 PM"
}

响应

{
  "envelopeId": "f8a090cf-ddc3-4612-8f24-9ff13beddc48",
  "uri": "/envelopes/f8a090cf-ddc3-4612-8f24-9ff13beddc48",
  "statusDateTime": "2017-02-01T19:39:26.2330000Z",
  "status": "sent"
}

我假设内联模板必须提供所有签名者。 2个模板中的角色名称相同(## Buyer1和## Seller1都在两个模板中)。我原本以为没有填写内联模板意味着它会在该特定文档上失败。我错了,但我不确定为什么。它是否成功,因为两个服务器模板上的角色名称相同,并为一个内联模板指定它就足够了?

1 个答案:

答案 0 :(得分:3)

您无需在内联模板中提供所有签名者。

以下是Composite template usage的完整规则。

在这里引用其中一些。

  

每个CompositeTemplate都会添加一个新文档和模板叠加   信封。对于每个CompositeTemplate,将应用这些规则:

     

模板按其序列值的顺序重叠。

     

如果Document未传入系统,则为第一个模板   使用文档(基于模板的序列值)。

     

除文件(即信封)外,所有情况下的最后胜利   信息,收件人信息,安全领域信息)。这个   这样做是为了让事情变得简单。没有特殊的外壳。

     

例如,如果要在选项卡上获得更高的安全性,则需要在包含选项卡的最后一个模板中指定。如果您希望角色收件人具有更高的安全性,则需要在指定该角色收件人的最后一个模板中。

     

收件人匹配基于收件人角色和路由顺序。如果存在匹配,则将收件人信息合并在一起。在应用了所有模板叠加后,在所有CompositeTemplates上完成最终传递,以使用相同的电子邮件,用户名和路由顺序折叠收件人。这可以防止在相同的路由顺序中拥有相同的收件人。