Docusign eSignature Spoke

Apps im Store anfordern

Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

IntegrationHub-Abonnement

Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

Spoke-Version

Die Docusign eSignature-Spoke v3.1.2 ist die neueste Version.

Spoke-Abhängigkeiten

Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:

ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
ServiceNow Flow Designer – Dynamische Eingaben (com.glide.hub.dynamic_inputs)

Hinweis:

Einige dieser Plugins sind lizenzierbare Funktionen und erfordern eine entsprechende Lizenz, wenn sie außerhalb der Spoke-Implementierung verwendet werden. Informationen zu Lizenzen erhalten Sie von Ihrem Account Manager.

Kompatible Versionen

Diese Spoke wurde für die Docusign eSignature-API-Version v2 oder v2.1 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

Schlüsselfunktionen

Mit der Docusign eSignature-Spoke kann ein Flow Designer:

Automatisieren Sie den Prozess des Sendens eines Dokuments aus einem ServiceNow -Anhang oder einer Docusign eSignature-Vorlage an eine Einzelperson oder Empfängerliste zur digitalen Signatur.
Erkennen und synchronisieren Sie Docusign eSignature-Konten und -Vorlagen in ServiceNow.
- Rufen Sie eine Liste von Accounts und zugehörigen Vorlagen aus Docusign eSignature ab, und fügen Sie sie dann mit dem Subflow „Accounts abrufen“ als Datensätze in den Tabellen „Accounts“ [sn_docusign_spoke_accounts] und „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein, oder aktualisieren Sie sie.
- Rufen Sie Vorlagen ab, die einem angegebenen Docusign eSignature-Konto zugeordnet sind, und fügen Sie sie dann als Datensätze in der Tabelle „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein, indem Sie den Subflow „Vorlagen pro Konto abrufen“ verwenden.
Kopieren und passen Sie Beispiel-Flows für das Senden von Vorlagen und bedarfsgesteuerten Dokumentanforderungen an.
Halten Sie einen Flow an, bis ein Dokument signiert ist. Ein geskripteter REST-API-Webhook wartet darauf, dass der Empfänger das Dokument signiert.
Verwenden Sie Werte aus einem signierten Dokument in einem Flow.
Hängen Sie ein abgeschlossenes Docusign eSignature-Dokument zu Auditzwecken an einen ServiceNow -Datensatz an.
Verwalten Sie Umschläge und Benutzer.

Spoke-Anforderungen

Docusign eSignature-Konto
Anmeldeinformationen des Docusign eSignature-Administrators
Docusign eSignature-Anwendung für die Integration mit ServiceNow konfiguriert
Details zur Docusign eSignature-Anwendung, z. B. Client-ID, Integratorschlüssel, geheime Schlüssel und RSA-Schlüsselpaare
ServiceNow IntegrationHub-Abonnement
Hinweis:
Vergewissern Sie sich, dass Flow Designer Support für das Servicekatalog-Plugin (com.glideapp.servicecatalog.flow_designer) aktiviert ist.

Anweisungen zum Erstellen und Konfigurieren von anwenderdefinierten Anwendungen finden Sie in der Dokumentation zum Docusign Developer Center .

Spoke-Abläufe

Die Docusign eSignature-Spoke bietet Beispiel-Flows, um die Automatisierung von Docusign-Aufgaben zu demonstrieren. Verwenden Sie Docusign eSignature-Spoke-Aktionen, um alle von Ihrer Organisation gewünschten Aufgaben zu automatisieren. Um einen Beispielablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispielabläufe umfassen Folgendes:


Flow	Beschreibung
Senden Sie ein Dokument zur digitalen Signatur	Sendet ein Dokument zur digitalen Signatur an DocuSign, wenn eine Servicekatalog-Anforderung durch das Element „ Dokument für digitale Signatur senden “ erstellt wird. Bevor Sie diesen Flow verwenden, aktivieren Sie das Katalogelement „ Dokument für digitale Signatur senden “.
Senden Sie dem Kandidaten ein Stellenangebot mithilfe der Docusign-Vorlage	Sendet einen DocuSign-Umschlag mithilfe einer Vorlage an einen Anwender. Verwenden Sie diesen Flow beispielsweise, um ein Stellenangebot an einen Kandidaten zu senden. Aktivieren Sie vor der Verwendung dieses Flows das Katalogelement Vorlage demonstrieren – Stellenangebot an Kandidaten senden.

Die Docusign eSignature-Spoke fügt Katalogelemente zur Verwendung mit den Docusign eSignature-Spoke-Beispiel-Flows hinzu. Aktivieren Sie vor dem Auslösen eines Docusign eSignature-Spoke-Beispiel-Flows diese Katalogelemente.


Katalogelement	Beschreibung
Senden Sie ein Dokument zur digitalen Signatur	Sendet ein Dokument zur digitalen Signatur an Docusign.
Vorlage demonstrieren – Stellenangebot an Kandidaten senden	Versendet ein Stellenangebot mithilfe einer Docusign-Vorlage.

Spoke-Unterabläufe

Die Docusign eSignature-Spoke bietet Beispiel-Subflows, um die Automatisierung von Docusign-Aufgaben zu demonstrieren. Um einen Beispiel-Unterablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. Verfügbare Beispiel-Unterabläufe umfassen Folgendes:


Kategorie	Subflow	Beschreibung
Umschlagverwaltung	DocuSign-Umschlag an ServiceNow-Datensatz anhängen	Hängt alle Dokumente in einem Umschlag an einen ServiceNow -Datensatz an.
Umschlagverwaltung	DocuSign-Felddaten abrufen und festlegen	Verarbeitet eine Liste von Katalogelementvariablen und aktualisiert einen Entwurfsumschlag mit jedem Variablenwert.
Anwenderverwaltung	Anwender erstellen	Erstellt einen Anwender einschließlich des Berechtigungsprofils und der Gruppenmitgliedschaften.
Anwenderverwaltung	Anwender aktualisieren	Aktualisiert einen Anwender einschließlich des Berechtigungsprofils und der Gruppenmitgliedschaften.
Vorlagenverwaltung	Ruft Vorlagen pro Account ab	Ruft Vorlagen von einem Docusign-Konto ab und speichert sie in der Vorlagentabelle.
Standard	Beispiel-Subflow für einen Docusign-Webhook	Ruft die Empfängerdetails für den angegebenen Umschlag ab.
Account-Verwaltung	Accounts abrufen	Ruft Docusign-Konten und -Vorlagen ab, die sich auf jeden Account beziehen, und speichert sie in der Tabelle „Accounts“ bzw. „Vorlagen“.

Spoke-Aktionen

Die Docusign eSignature-Spoke bietet Aktionen zur Automatisierung von Docusign-Aufgaben, wenn in ServiceNowEreignisse auftreten. Folgende Aktionen sind verfügbar:


Kategorie	Aktion	Beschreibung
Account-Verwaltung	Sucht nach Kontosignaturanbietern	Ruft eine Liste von Signaturanbietern ab, die der angegebene Account verwenden kann.
	Sucht Accounts nach Alias	Ruft Accounts ab, die dem Spoke-Alias-Datensatz für Verbindungen und Anmeldeinformationen zugeordnet sind.
	Suchen Sie nach der Rollen-ID	Ruft die Rollen-ID für den angegebenen Rollennamen ab.
Verwaltung von Massenumschlägen	Massenversandliste erstellen	Erstellt eine Massenversandliste.
	Erstellen Sie eine Massenversandanforderung	Erstellt eine Massenversandanforderung basierend auf einer vorhandenen Massenversandliste mithilfe eines Umschlags oder einer Vorlage.
	Massenversand-Testanforderung erstellen	Erstellt eine Massenversand-Testanforderung, um die Kompatibilität mit dem vorhandenen Umschlag oder der vorhandenen Vorlage zu testen.
	Massenversandliste löschen	Löscht die angegebene Massenversandliste.
	Sucht Stream mit Massenversand-Batch-Umschlägen	Ruft die Umschläge aus dem angegebenen Massenversand-Batch ab.
	Sucht nach Status des Massenversand-Batches	Ruft den allgemeinen Status des angegebenen Massenversand-Batches ab, z. B. Anzahl der Erfolge, Anzahl der ausstehenden, Anzahl der Fehler usw.
	Sucht Stream mit Massenversand-Batches	Ruft die Informationen der Massenversand-Batches ab.
	Massenversandliste suchen	Ruft die angegebene Massenversandliste ab.
	Massenversandlisten suchen	Ruft eine Liste der Massenversandlisten ab.
	Aktualisiert die Massenversand-Batch-Aktion	Führt eine Massenaktion (erneut senden, korrigieren oder stornieren) für den angegebenen Massenversand-Batch aus.
	Aktualisiert den Status des Massenversand-Batches	Aktualisiert den Namen des angegebenen Massenversand-Batches.
	Massenversandliste aktualisieren	Aktualisiert die angegebene Massenversandliste.
Dokumentsignatur	Suchen Sie nach der URL für eingebettete Signaturen	Erstellt eine Signatur-URL, die in eine Anwendung eingebettet ist. Der Benutzer kann das Dokument signieren, ohne die Anwendung zu verlassen. Hinweis: Die Signatur-URL ist 300 Sekunden lang aktiv und kann jeweils an einen Empfänger gesendet werden.
Dokumentsignatur	Suchen Sie inline nach der eingebetteten Signatur-URL	Ruft eine URL ab, mit der Sie die Empfängeransicht von in DocuSign einbetten können.
Dokumentenmanagement	Dokument zu Umschlag hinzufügen	Fügt Dokumente zum Umschlag hinzu.
	Kombiniertes Dokument an ServiceNow-Datensatz anhängen	Hängt DocuSign-Dokumente an einen ServiceNow-Datensatz an.
	Hängen Sie das DocuSign-Dokument an den Datensatz ServiceNow an	Ruft ein signiertes Docusign-Dokument ab und hängt es an einen ServiceNow -Datensatz an.
	Dokument-ID anhand des Namens suchen	Ruft die Dokument-ID anhand des angegebenen Dokumentnamens aus einem Umschlag ab.
	Sucht nach Dokumenten in einem Umschlag	Gibt eine Liste von Dokumenten mit einer ID und einem Namen im angegebenen DocuSign-Umschlag zurück.
	Ersetzt das Dokument in einem Umschlag	Ersetzt Dokumente durch Umschlag.
Umschlagverwaltung	Empfänger zu Umschlag hinzufügen	Fügt den angegebenen Empfänger dem angegebenen Umschlag hinzu. Hinweis: Die in dieser Aktion verwendete Empfänger-ID ist dem Umschlag zugeordnet und unterscheidet sich von der Empfänger-ID, die in der Aktion „Alle Vorlagenfelder abrufen“ verwendet wird. Der Administrator gibt einen numerischen Wert für diese Empfänger-ID ein.
	Fügen Sie dem Umschlag Empfänger hinzu	Fügt die angegebenen Empfänger dem angegebenen Umschlag hinzu.
	Hängen Sie das DocuSign-Zertifikat an den ServiceNow-Datensatz an	Hängt ein DocuSign-Zertifikat an einen ServiceNow-Datensatz an.
	Umschlag abbrechen	Storniert einen in Bearbeitung befindlichen Umschlag.
	Erstellt einen Entwurfsumschlag aus einer Vorlage	Erstellt einen Entwurfsumschlag aus einer vorhandenen Docusign-Vorlage.
	Erstellt einen Umschlag aus einer zusammengesetzten Vorlage	Erstellt einen Umschlag aus einer vorhandenen zusammengesetzten Vorlage.
	Sucht nach Feld-ID	Ruft die ID des angegebenen Felds aus dem angegebenen Entwurfsumschlag ab.
	Feldwert suchen	Ruft den Wert des angegebenen Felds aus dem angegebenen Umschlag ab.
	Felder suchen	Ruft die Liste der Felder ab, die einem Dokument in einem Entwurfsumschlag zugeordnet sind.
	Suchen Sie die Empfänger-ID anhand des Rollennamens	Ruft die Empfänger-ID des angegebenen Rollennamens aus dem angegebenen Umschlag ab.
	Sucht nach Empfängern in einem Umschlag	Gibt eine Liste von Empfängern mit einer Empfänger-ID und einem Rollennamen im angegebenen DocuSign-Umschlag zurück.
	Empfänger aus Umschlag entfernen	Löscht einen Empfänger aus einem DocuSign-Umschlag.
	Ad-hoc-Signaturanforderung an Anwender senden	Sendet ein DocuSign-Dokument, das dem angegebenen ServiceNow -Datensatz zugeordnet ist, zur Signatur an den angegebenen Empfänger.
	Ad-hoc-Signaturanforderung an Anwender senden – Inline	Sendet ein oder mehrere hochgeladene Dokumente aus einem ServiceNow-Datensatz an mehrere Empfänger.
	Umschlag senden	Sendet einen Umschlag an die angegebenen Empfänger. Hinweis: Vor dem Senden eines Umschlags müssen alle Empfängerdetails angegeben werden.
	Legen Sie den Feldwert fest	Legt den Wert des angegebenen Felds im angegebenen Entwurfsumschlag fest.
	Feldwerte festlegen	Weist die Werte mehrerer Felder zu, die einem Dokument in einem Entwurfsumschlag zugeordnet sind.
	Warten Sie auf die Signatur von Docusign	Hält einen Flow an, bis das angegebene Dokument signiert oder abgelehnt wurde. Gibt den Status des Dokuments zur weiteren Verarbeitung an den Flow zurück.
Gruppenverwaltung	Anwender zu Gruppe hinzufügen	Fügt Anwender aus einer Gruppe hinzu.
	Suchen Sie nach der Gruppen-ID	Ruft eine Gruppen-ID für den angegebenen Rollennamen ab.
	Anwender aus Gruppe entfernen	Entfernt den angegebenen Anwender aus einer Gruppe.
Vorlagen-Management	Sucht nach Vorlagen pro Account	Ruft die Vorlagen ab, die dem angegebenen Docusign-Konto zugeordnet sind.
	Sucht nach Vorlagenfeldern	Ruft alle Felder in einer Vorlage ab, die für einen Empfänger definiert ist. Hinweis: Die in dieser Aktion verwendete Empfänger-ID ist der Vorlage zugeordnet und unterscheidet sich von der Empfänger-ID, die in der Aktion Empfänger zu Umschlag hinzufügen verwendet wird. Der Wert der Empfänger-ID ist eine eindeutige, vom System generierte Nummer.
	Sucht nach Vorlagenempfängern	Ruft alle für eine Vorlage definierten Empfänger ab.
Anwenderverwaltung	Anwender erstellen	Erstellt einen Docusign-Anwender mit den angegebenen Anwenderdetails.
	Anwenderdetails suchen	Ruft Details für einen Anwender ab.
	Anwender aktualisieren	Aktualisiert den angegebenen Anwender.
	Anwender löschen	Löscht den angegebenen DocuSign-Anwender.

Spoke-Modul

Die Docusign eSignature-Spoke fügt Ihrer Instanz ServiceNow ein Docusign-Modul hinzu. Die Docusign eSignature-Spoke synchronisiert und speichert Vorlagen und Umschläge in ServiceNow. Die Docusign eSignature-Spoke enthält diese Tabellen und Datensätze.


Tabelle/Datensatz	Beschreibung
Verbindungsaliase	Der DocuSign-Verbindungsalias.
Geplante Aufgabe	Geplante Aufgabe zum Abrufen von Konten und Vorlagen, die Vorlagen und Umschläge mit Ihrem DocuSign-Konto synchronisiert.
Accounts	Docusign-Konten, die mit Ihrer Instanz ServiceNow synchronisiert werden. Informationen zum Synchronisieren von Konten finden Sie unter Synchronisieren Sie Docusign mit ServiceNow. Mit dem Subflow „Accounts abrufen“ wird eine Liste von Accounts und zugehörigen Vorlagen aus DocuSign abgerufen und dann als Datensätze in die Tabellen „Accounts“ [sn_docusign_spoke_accounts] und „Vorlagen“ [sn_docusign_spoke_docusign_templates] eingefügt oder aktualisiert.
Vorlagen	DocuSign-Vorlagen aus synchronisierten DocuSign-Konten. Der Subflow „Vorlagen pro Account abrufen“ ruft Vorlagen ab, die einem angegebenen Docusign-Konto zugeordnet sind, und fügt sie dann als Datensätze in die Tabelle „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein oder aktualisiert sie.
Umschläge	Docusign-Umschläge aus synchronisierten Docusign-Konten. Datensätze in der Tabelle „Umschläge“ werden nur aktualisiert, wenn ein Webhook für das Docusign-Konto konfiguriert ist.

Die Docusign eSignature-Spoke-Tabellen enthalten diese Felder.


Tabelle	Felder
Accounts [sn_docusign_spoke_accounts]	Account-ID Accountname Beschreibung E-Mail Alias Anzeigename
Vorlagen [sn_docusign_spoke_docusign_templates]	Account Vorlagen-ID Name Beschreibung Zuletzt geändert Anzeigename
Umschläge [sn_docusign_spoke_envelopes]	Account ID Status Unterzeichnet am Ablehnungsgrund Anzeigename Eingebettete Signatur Zeitzone des Signaturdatums Vorlage

Docusign-Kontoanforderungen

Für die Docusign eSignature-Spoke müssen Sie Ihr Docusign-Konto konfigurieren, um ein OAuth 2.0 JWT Bearer Grant-Token zu generieren.

Alias-Anforderungen für Verbindungen und Anmeldeinformationen

IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen sowie OAuth-Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren.

Diese Spoke verwendet den DocuSign-Alias-Datensatz für Verbindungen und Anmeldeinformationen, um Aktionen zu autorisieren.

Wichtig:

Sie können die DocuSign-Spoke mit Autorisierungscode-Gewährung oder JWT-Gewährungeinrichten.
- Verwenden Sie Autorisierungscode Gewährung, wenn Ihre Integration einen Browser oder Client verwendet, um Anforderungen an einen Webserver zu stellen.
- Verwenden Sie JWT Grant, wenn jeder Anwender Ihrer Integration einen einzelnen Systemaccount für die Anmeldung verwendet.
Weitere Informationen dazu, wann Sie eine der Setup-Methoden auswählen sollten, finden Sie unter OAuth-Typ auswählen in der DocuSign-Entwicklerdokumentation.
Ihr Unternehmen kann für jede Abteilung, die Docusign verwendet, ein Docusign-Konto haben. Um mehrere Accounts mit dieser Spoke zu verwenden, erstellen Sie für jeden Account einen untergeordneten Alias. Stellen Sie außerdem sicher, dass Sie den Basisalias in Ihren Flows mit dem untergeordneten Alias überschreiben. Zur Laufzeit identifiziert das System den untergeordneten Alias, der dem Account zugeordnet ist, und sendet in der Anforderung die richtigen Verbindungs- und Anmeldeinformationen.
- Weitere Informationen zum untergeordneten Alias und zum Überschreiben des Basisalias finden Sie unter Unterstützt mehrere Verbindungen.
- Informationen zum Einrichten mehrerer Konten finden Sie unter Erstellen Sie untergeordnete Aliasse für zusätzliche Docusign-Konten.
Wenn Ihr Unternehmen nur über einen Account verfügt, können Sie den standardmäßigen Docusign- Alias verwenden, der mit der Spoke bereitgestellt wird, und mit der Einrichtung der Docusign-Spoke mit Autorisierungscode Gewährung oder JWT-Gewährungfortfahren.

MID Server-Anforderungen

Diese Aktionen verwenden REST-Aufrufe, die auf einer Instanz oder einem MID-Server ausgeführt werden können. Verwenden Sie den Verbindungsdatensatz, der dem Docusign-Alias zugeordnet ist, um zu konfigurieren, wo Aktionen ausgeführt werden, und um MID-Server-Auswahlattribute festzulegen. Weitere Informationen finden Sie unter MID-Server.