DocuSign eSignatur Spoke
Automatisieren Sie den Prozess des Sendens eines Dokuments an eine Einzelperson oder eine Liste von Empfängern zur digitalen Signatur mit DocuSign eSignature. Automatisieren Sie beispielsweise das Onboarding und Offboarding von Mitarbeitern, oder versenden Sie Geheimhaltungsvereinbarungen, rechtliche Vereinbarungen und Arbeitsbeschreibungen. Verwenden Sie ServiceNow-Daten in Dokumentvorlagen, und ermöglichen Sie Benutzern, bei Bedarf Dokumente zur Signatur hochzuladen.
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
DocuSign eSignature-Spoke v 3.0.0 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)
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
DocuSign eSignature-Spoke ermöglicht einem Flow Designer:
- Automatisieren Sie den Prozess des Sendens eines Dokuments aus einem ServiceNow -Anhang oder einer DocuSign-eSignatur-Vorlage an eine Einzel- oder Empfängerliste zur digitalen Signatur.
- Erkennen und synchronisieren Sie DocuSign eSignatur-Konten und -Vorlagen in ServiceNow.
- Rufen Sie eine Liste von Accounts und zugehörigen Vorlagen aus DocuSign eSignatur ab, und fügen Sie sie dann als Datensätze in die Tabellen „Accounts“ [sn_docusign_spoke_accounts] und „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein, oder aktualisieren Sie sie als Datensätze in dem Subflow Accounts abrufen.
- Rufen Sie Vorlagen ab, die einem angegebenen DocuSign eSignature-Konto zugeordnet sind, und fügen Sie sie dann mit dem Subflow „Vorlagen pro Konto abrufen“ als Datensätze in die Tabelle „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein, oder aktualisieren Sie sie.
- Kopieren Sie Beispiel-Flows zum Senden von Vorlagen und On-Demand-Dokumentanforderungen, und passen Sie sie 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 ausgefülltes DocuSign-eSignatur-Dokument zu Auditzwecken an einen ServiceNow -Datensatz an.
- Umschläge und Benutzer verwalten.
Spoke-Anforderungen
- DocuSign eSignature-Konto
- Anmeldeinformationen des DocuSign eSignature-Administrators
- DocuSign eSignature-Anwendung, die für die Integration mit ServiceNow konfiguriert ist
- Details der DocuSign eSignature-Anwendung, z. B. Client-ID, Integratorschlüssel, geheime Schlüssel und RSA-Schlüsselpaare
- ServiceNow IntegrationHub-AbonnementHinweis:Vergewissern Sie sich, dass Sie die Flow Designer-Unterstützung für das Plugin „Service Catalog“ (com.glideapp.servicecatalog.flow_designer) aktiviert haben.
In der Dokumentation zum DocuSign Developer Center finden Sie Anweisungen zum Erstellen und Konfigurieren benutzerdefinierter Anwendungen.
Spoke-Abläufe
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 Service Catalog-Anforderung vom 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. Bevor Sie diesen Flow verwenden, aktivieren Sie das Katalogelement „ Demonstrationsvorlage – 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. |
| Nachweisvorlage: Stellenangebot an Kandidaten senden | Versendet ein Stellenangebot mithilfe einer DocuSign-Vorlage. |
Spoke-Unterabläufe
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. |
| DocuSign-Felddaten abrufen und festlegen | Verarbeitet eine Liste von Katalogelementvariablen und aktualisiert einen Umschlagentwurf mit jedem Variablenwert. | |
| Anwenderverwaltung | Benutzer erstellen | Erstellt einen Benutzer einschließlich des Berechtigungsprofils und der Gruppenmitgliedschaften. |
| Anwender aktualisieren | Aktualisiert einen Anwender einschließlich des Berechtigungsprofils und der Gruppenmitgliedschaften. | |
| Vorlagenverwaltung | Ruft Vorlagen pro Account ab | Ruft Vorlagen von einem DocuSign-Account ab und speichert sie in der Vorlagentabelle. |
| Standard | Beispiel-Subflow für DocuSign-Webhook | Ruft die Empfängerdetails für den angegebenen Umschlag ab. |
| Account-Verwaltung | Accounts abrufen | Ruft DocuSign-Accounts und -Vorlagen ab, die sich auf jeden Account beziehen, und speichert sie in der Tabelle „Accounts“ bzw. „Vorlagen“. |
Spoke-Aktionen
DocuSign eSignature-Spoke bietet Aktionen zum Automatisieren von DocuSign-Aufgaben, wenn Events in ServiceNowauftreten. Folgende Aktionen sind verfügbar:
| Kategorie | Aktion | Beschreibung |
|---|---|---|
| Account-Verwaltung | Sucht Accounts nach Alias | Ruft Accounts ab, die dem Spoke-Alias-Datensatz für Verbindungen und Anmeldeinformationen zugeordnet sind. |
| Sucht nach Rollen-ID | Ruft die Rollen-ID für den angegebenen Rollennamen ab. | |
| Verwaltung von Massenumschlägen | Erstellen Sie eine Massensendeliste | Erstellt eine Massenversandliste. |
| Erstellen Sie eine Massensendeanforderung | Erstellt eine Massensendeanforderung basierend auf einer vorhandenen Massensendeliste mithilfe eines Umschlags oder einer Vorlage. | |
| Erstellen Sie eine Massenversand-Testanforderung | Erstellt eine Massensende-Testanforderung, um die Kompatibilität mit dem vorhandenen Umschlag oder der vorhandenen Vorlage zu testen. | |
| Löschen Sie die Massenversandliste | Löscht die angegebene Massenversandliste. | |
| Sucht nach Stream „Massenversand-Batch-Umschläge“. | Ruft die Umschläge aus dem angegebenen Massenversand-Batch ab. | |
| Sucht nach dem Status des Massenversand-Batch | Ruft den allgemeinen Status des angegebenen Massenversandbatches ab, z. B. Anzahl der Erfolge, Anzahl ausstehend, Anzahl der Fehler usw. | |
| Sucht nach Stream „Massenversand-Batches“. | Ruft die Informationen der Massenversand-Batches ab. | |
| Suchen Sie nach einer Massenversandliste | Ruft die angegebene Massenversandliste ab. | |
| Sucht nach Massenversandlisten | Ruft eine Liste der Massenversandlisten ab. | |
| Aktualisieren Sie die Batch-Aktion „Massenversand“. | Führt eine Massenaktion (erneut senden, korrigieren oder stornieren) für den angegebenen Massenversand-Batch aus. | |
| Aktualisieren Sie den Massenversand-Batch-Status | Aktualisiert den Namen des angegebenen Massenversand-Batches. | |
| Aktualisieren Sie die Massenversandliste | 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. |
| Suchen Sie inline nach der eingebetteten Signatur-URL | Ruft eine URL ab, mit der Sie die Empfängeransicht des 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. | |
| DocuSign-Dokument an Datensatz anhängen | Ruft ein signiertes DocuSign-Dokument ab und hängt es an einen ServiceNow -Datensatz an. | |
| Suchen Sie die Dokument-ID anhand des Namens | Ruft die Dokument-ID aus einem Umschlag unter Verwendung des angegebenen Dokumentnamens ab. | |
| Sucht nach Dokumenten in einem Umschlag | Gibt eine Liste von Dokumenten mit einer ID und einem Namen im angegebenen DocuSign-Umschlag zurück. | |
| Dokument in Umschlag ersetzen | Ersetzt Dokumente in einen Umschlag. | |
| Umschlagverwaltung | Empfänger zu Umschlag hinzufügen | Fügt den angegebenen Empfänger dem angegebenen Umschlag hinzu. Hinweis:
|
| Fügen Sie dem Umschlag Empfänger hinzu | Fügt die angegebenen Empfänger dem angegebenen Umschlag hinzu. | |
| DocuSign-Zertifikat an ServiceNow-Datensatz anhängen | Hängt ein DocuSign-Zertifikat an einen ServiceNow-Datensatz an. | |
| Umschlag abbrechen | Bricht einen laufenden Umschlag ab. | |
| Erstellt einen Umschlagentwurf aus einer Vorlage | Erstellt einen Umschlagentwurf 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. | |
| Sucht nach Feldwert | 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 nach Rollenname | 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. | |
| Entfernen Sie den Empfänger aus dem Umschlag | 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. | |
| Senden Sie eine Ad-hoc-Signaturanforderung an Anwender | Sendet ein DocuSign-Dokument, das dem angegebenen ServiceNow -Datensatz zugeordnet ist, an mehrere angegebene Empfänger zur Signatur gleichzeitig. Hinweis: Wenn die Option Sequenzielle Signatur verwenden aktiviert ist, wird das DocuSign-Dokument in sequenzieller Reihenfolge an mehrere Empfänger gesendet. Die Option Sequenzielles Signieren verwenden steuert die Reihenfolge, in der die Empfänger die Dokumente erhalten und signieren. |
|
| 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 auf 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. | |
| Metadatenabruf | Ruft die Liste der Dokumente ab | Ruft die Liste aller DocuSign-Dokumente in einem Umschlag ab. |
| Gruppenliste abrufen (Metadaten) | Ruft Metadaten für eine Gruppenliste ab. | |
| Rollen abrufen | Ruft eine Liste von Rollen ab. | |
| Rollen abrufen (Metadaten) | Ruft Metadaten für eine Liste von Rollen ab. | |
| 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-Account zugeordnet sind. |
| Sucht nach Vorlagenfeldern | Ruft alle Felder in einer Vorlage ab, die für einen Empfänger definiert ist. Hinweis:
|
|
| Sucht nach Vorlagenempfängern | Ruft alle für eine Vorlage definierten Empfänger ab. | |
| Anwenderverwaltung | Benutzer erstellen | Erstellt einen DocuSign-Anwender mit den angegebenen Anwenderdetails. |
| Suchen Sie nach Anwenderdetails | Ruft Details für einen Anwender ab. | |
| Anwender aktualisieren | Aktualisiert den angegebenen Anwender. | |
| Benutzer löschen | Löscht den angegebenen DocuSign-Anwender. |
Spoke-Modul
DocuSign eSignature-Spoke fügt Ihrer Instanz ServiceNow ] ein DocuSign-Modul hinzu. DocuSign eSignature-Spoke synchronisiert und speichert Vorlagen und Umschläge in ServiceNow. DocuSign eSignature-Spoke enthält die folgenden Tabellen und Datensätze.
| Tabelle/Datensatz | Beschreibung |
|---|---|
| Verbindungsaliasnamen | Der DocuSign-Verbindungsalias. |
| Geplante Aufgabe | Die regelmäßige Aufgabe „Accounts und Vorlagen abrufen“, die Vorlagen und Umschläge mit Ihrem DocuSign-Account synchronisiert |
| Accounts | Mit Ihrer ServiceNow -Instanz synchronisierte DocuSign-Accounts. Informationen zum Synchronisieren von Konten finden Sie unter DocuSign mit ServiceNow synchronisieren. Der Subflow „Accounts abrufen“ ruft eine Liste von Accounts und zugehörigen Vorlagen aus DocuSign ab und fügt sie dann als Datensätze in die Tabellen „Accounts“ [sn_docusign_spoke_accounts] und „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein oder aktualisiert sie als Datensätze. |
| Vorlagen | DocuSign-Vorlagen aus synchronisierten DocuSign-Accounts. Der Subflow „Vorlagen pro Account abrufen“ ruft Vorlagen ab, die einem angegebenen DocuSign-Account zugeordnet sind, und fügt sie als Datensätze in die Tabelle „Vorlagen“ [sn_docusign_spoke_docusign_templates] ein oder aktualisiert sie. |
| Umschläge | DocuSign-Umschläge aus synchronisierten DocuSign-Accounts. Datensätze in der Tabelle „Umschläge“ werden nur aktualisiert, wenn der Webhook für das DocuSign-Konto konfiguriert ist. |
| Tabelle | Felder |
|---|---|
| Accounts [sn_docusign_spoke_accounts] |
|
| Vorlagen [sn_docusign_spoke_docusign_templates] |
|
| Umschläge [sn_docusign_spoke_envelopes] |
|
DocuSign-Kontoanforderungen
DocuSign eSignature-Spoke erfordert die Konfiguration Ihres DocuSign-Kontos, 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 Datensatz des DocuSign-Alias für Verbindungen und Anmeldeinformationen, um Aktionen zu autorisieren.
- Sie können die DocuSign-Spoke mit Autorisierungscode grant oder JWT granteinrichten.
- Verwenden Sie Autorisierungscode Grant, wenn bei Ihrer Integration ein Browser oder Client verwendet wird, um Anforderungen an einen Webserver zu stellen.
- Verwenden Sie JWT Grant, wenn sich jeder Benutzer Ihrer Integration mit einem einzigen Systemkonto anmeldet.
Weitere Informationen dazu, wann Sie eine der Setup-Methoden auswählen, finden Sie unter OAuth-Typ wählen in der DocuSign-Entwicklerdokumentation.
- Ihr Unternehmen verfügt möglicherweise über ein DocuSign-Konto für jede Abteilung, die DocuSign verwendet. Um mehrere Konten mit dieser Spoke zu verwenden, erstellen Sie für jedes Konto 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 Konto zugeordnet ist, und sendet die korrekten Verbindungs- und Anmeldeinformationen in der Anforderung.
- Weitere Informationen zum untergeordneten Alias und zum Überschreiben des Basisalias finden Sie unter Unterstützung mehrerer Verbindungen.
- Weitere Informationen zum Einrichten mehrerer Konten finden Sie unter Erstellen Sie untergeordnete Aliasse für zusätzliche DocuSign-Konten.
Wenn Ihr Unternehmen nur einen Account hat, können Sie den standardmäßigen DocuSign- Alias verwenden, der mit der -Spoke bereitgestellt wird, und mit der Einrichtung der DocuSign-Spoke mit Autorisierungscode grant oder JWT grantfortfahren.
MID Server-Anforderungen
Diese Aktionen verwenden REST-Aufrufe, die auf einer Instanz oder einem MID Server ausgeführt werden können. Verwenden Sie den dem DocuSign-Alias zugeordneten Verbindungsdatensatz, um zu konfigurieren, wo Aktionen ausgeführt werden, und um MID Server-Auswahlattribute festzulegen. Weitere Informationen finden Sie unter MID-Server.