使用复合模板的意外行为

Question

对于理解内联模板的工作方式，我有一个问题。我有两个服务器模板和两个内联模板，一个内联模板与服务器模板相结合。我想知道我是否没有为信封仍然有效的内联模板填写信息。以下是我的要求：

请求

{
  "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"
}

我假设内联模板必须提供所有的签名者。两个模板中的角色名称是相同的( ##Buyer1和##Seller1在两个模板中)。我认为，不填写内联模板将意味着该文件将失败。我错了，但我不知道为什么。它成功了吗?因为两个服务器模板上的角色名称是相同的，并且为一个内联模板指定角色名就足够了吗？

Answer 1

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

以下是复合模板使用的完整规则。

这里引用了一些人的话。

每个CompositeTemplate都会在信封中添加一个新文档和模板。对于每个CompositeTemplate，适用这些规则： 模板按其序列值的顺序进行覆盖。 如果文档未传递到系统中，则使用第一个模板的文档(基于模板的序列值)。 最后在所有情况下获胜，但文件除外(即信封信息、收件人信息、安全字段信息)。这样做是为了保持简单。没有特殊的外壳。 例如，如果希望在选项卡上具有更高的安全性，则需要在包含选项卡的最后一个模板中指定该安全性。如果希望角色收件人具有更高的安全性，则需要位于指定角色收件人的最后一个模板中。 收件人匹配基于收件人角色和路由顺序。如果有匹配，则将收件人信息合并在一起。在应用了所有模板覆盖之后，将对所有CompositeTemplates进行最后一次传递，以折叠具有相同电子邮件、用户名和路由顺序的收件人。这将防止相同的收件人处于相同的路由顺序。。