Как управлять настройками видимости в композитном конверте - PullRequest
Новая
       9

Как управлять настройками видимости в композитном конверте

0 голосов
/ 18 января 2019

Я пытаюсь работать с настройками видимости в рабочем процессе, используя API docusign.Рабочий процесс состоит из двух встроенных шаблонов, и я хочу ограничить его, чтобы подписант не мог видеть 1 документ во втором встроенном шаблоне.Вот json, отправляемый в DocuSign: 

{
  "compositeTemplates": [
    {
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "email": ,
                "name": ,
                "recipientId": "2",
                "roleName": "High School Faculty"
              },
              {
                "email": ,
                "name": ,
                "recipientId": "3",
                "roleName": "High School Administration"
              },
              {
                "email": ,
                "name": ,
                "recipientId": "4",
                "roleName": "Department Dean"
              },
              {
                "documentVisibility": [
                  {
                    "documentId": "2",
                    "recipientId": "5",
                    "visible": "false"
                  }
                ],
                "email": ,
                "name": ,
                "recipientId": "5",
                "roleName": "Department Faculty"
              }
            ]
          },
          "sequence": "1"
        }
      ],
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "900cc73b-f35c-45b1-92d1-e8453094aa60"
        }
      ]
    },
    {
      "inlineTemplates": [
        {
          "documents": [
            {
              "documentBase64": <data>, 
              "documentId": "1",
              "fileExtension": "docx",
              "name": "Packet"
            },
            {
              "documentBase64": <data>,
              "documentId": "2",
              "fileExtension": "docx",
              "name": "Packet"
            }
          ],
          "recipients": {
            "signers": [
              {
                "email": ,
                "name": ,
                "recipientId": "2",
                "roleName": "High School Faculty"
              },
              {
                "email": ,
                "name": ,
                "recipientId": "3",
                "roleName": "High School Administration"
              },
              {
                "email": ,
                "name": ,
                "recipientId": "4",
                "roleName": "Department Dean"
              },
              {
                "documentVisibility": [
                  {
                    "documentId": "2",
                    "recipientId": "5",
                    "visible": "false"
                  }
                ],
                "email": ,
                "name": ,
                "recipientId": "5",
                "roleName": "Department Faculty"
              }
            ]
          },
          "sequence": "2"
        }
      ]
    }
  ],
  "emailSubject": "College Now Master Form",
  "enforceSignerVisibility": "true"
}

Когда я прохожу тестирование рабочего процесса, факультет кафедры все еще может просматривать 2-й документ во втором встроенном шаблоне.Я тестирую, поэтому использую один и тот же вход для каждой роли. Может ли это быть проблемой?Кто-нибудь может указать на то, что я делаю неправильно?У нас действительно включена видимость для нашего экземпляра.Спасибо!

1 Ответ

0 голосов
/ 23 января 2019

В соответствии с документами EnvelopeRecipients вы можете использовать параметр ExcludedDocuments, чтобы определить его как часть объекта Recipient: 

  "recipients": {
    "signers": [
      {
        "email": "user@example.com",
        "name": "Example Signer",
        "recipientId": "2",
        "routingOrder":1,
        "excludedDocuments":[2],
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "recipientId": "1",
              "xPosition": "150",
              "yPosition": "150",
              "pageNumber":1
            }
          ]
        }
    }]
}

Вы также захотите подтвердить, как настроена видимость документа для вашей учетной записи, так как она может быть настроена так, чтобы исключать только отправителя или членов учетной записи отправителя. Если для этого параметра установлено значение «если только он не является участником учетной записи подписавшего», тестирование может быть отменено.

...