Wie wende ich eine Vorlage in ein Dokument mithilfe von DocuSign Rest API an

Question

Ich arbeite derzeit mit der Docusign Rest-API und frage mich, ob jemand ein Beispiel dafür hat, wie ich Dokumente und Vorlagen in einem Umschlag hinzufügen kann.Ich habe Zugriff auf die Vorlage-IDs, die ich brauche, und ich habe zusammengesetzte Vorlagen verwendet, um einen Umschlag mit mehreren Dokumenten mit entsprechenden Vorlagen zu erstellen.Ich mache dies nur mit der Vorlage-ID.Jetzt versuche ich herauszufinden, wie man dem Verbundvorlage ein Dokument hinzufügt.Wenn das Dokument eine Vorlage enthält (ich habe Zugriff auf die Vorlagen-IDs, wenn es eins hat), sollte es die Vorlage in dieses Dokument anwenden.

Kann ich Vorlagen in ein Dokument über die REST-API anwenden?Wenn ja, hat jemand ein Beispiel?

Answer 1

Hier sind ein paar Beispiele, die zeigen, wie zusammengesetzte Vorlagen verwendet werden können, um Informationen aus den Vorlagen (en) mit Informationen zu kombinieren, die über die API-Anforderung selbst angegeben sind.

Beispiel # 1:

Die folgende Beispielanforderung erstellt einen Umschlag, in dem die Vorlage verwendet wird, um die Tags- und Empfängerrollen für den Umschlag zu definieren, aber die Dokument- und Empfängerinformationen werden jedoch von der API-Anforderung selbst bereitgestellt.

generasacodicetagpre.

, wie oben gezeigt, um Dokumente über die API-Anforderung selbst bereitzustellen, dass Sie eine mehrteilige Anforderung - wo der erste Teil den vollständigen JSON für die Anforderung stellt, und jeweils Der anschließende Teil der Anforderung stellt den Inhalt eines einzelnen Dokuments dar, das in der JSON referenziert ist. Wenn Ihre JSON mehrere Dokumente verweist, enthält Ihre Anfrage für jedes Dokument einen zusätzlichen / separaten teil> .

Verbundvorlagen sind leistungsstark, da sie Ihnen große Flexibilität in Bezug auf die Kombination von Informationen von Vorlagen mit Informationen (Dokumente, Empfänger) geben, die über die API, die sich über die API bereitgestellt hat, zur Laufzeit anfordern. Das obige Beispiel ist sehr einfach (eine Vorlage, ein Dokument, ein Empfänger) - kann jedoch auf Fällen leicht erweitert werden, in denen mehrere Vorlagen / Dokumente / Empfänger kombiniert werden.

(Die Beispielanforderung auf P26-27 von REST API-Anleitung zeigt das Basisformat, das beim Senden einer mehrteiligen Anforderung erforderlich ist: http://www.docussign.com/sites/default/files/rest_api_guide_v2.pdf )

Beispiel # 2:

Nächstes Nehmen wir an, dass Sie in einen Umschlag alle in einer Vorlage definierten Dokumente einschließen möchten, aber Sie möchten auch zwei zusätzliche Dokumente (nicht definiert von einer Vorlage) in den Umschlag aufnehmen. Die folgende Beispielanforderung erstellt einen Umschlag mit 2 Dokumenten, die als Teil der API-Anforderung (CustomeragRement.pdf und in Rechnung.pdf) angegeben sind, und alle Dokumente, die von der in der 3. Verbund-Vorlagenstruktur referenzierten Vorlage definiert sind. Ein paar allgemeine Hinweise:

.

• Dokumente werden in der Reihenfolge in der Reihenfolge angezeigt, in der sie sind in der JSON-Anfrage angegeben. In diesem Beispiel ist das Dokumentreihenfolge: 1) customeragreement.pdf (angegeben über die API-Anforderung in der ersten zusammengesetzten Vorlagenstruktur), 2) in Rechnung.pdf (angegeben über die API-Anforderung in der zweiten Verbundvorlagenstruktur) und 3 ) Alle von der Vorlage angegebenen Dokumente, auf die in der dritten zusammengesetzten Vorlagenstruktur referenziert ist.

• Obwohl jede einzelne Verbundvorlagenstruktur Empfängerinformationen angeben muss - DocuSign stimmt mithilfe von identischen Empfänger-Info bei der Bildung der Empfänger-Kollektion für den Umschlag überein. In diesem Beispiel hat der resultierende Umschlag nur einen Empfänger: Abby Abbott.

Da wir zwei Dokumente über die API-Anfrage angeben, verfügt die Anforderung über insgesamt drei Teile: 1) JSON, 2) Inhalt des ersten Dokuments, 3) Inhalte des zweiten Dokuments.

generasacodicetagpre.