Richten Sie Auslöser für die Docusign eSignature-Spoke ein

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Richten Sie den Auslöser ein, um die Rückruf-URL in Ihrer -Instanz ServiceNow zu generieren.

    Vorbereitungen

    • Fordern Sie ein Integration Hub-Abonnement an.
    • Aktivieren Sie die Docusign eSignature-Spoke, und richten Sie sie ein.
    • Erforderliche Rolle: admin.

    Aktivieren Sie die Systemeigenschaft für den Gewährungstyp für Client-Anmeldeinformationen

    Erstellen oder aktivieren Sie die Systemeigenschaft „glide.oauth.inbound.client.credential.grant_type.enabled“, um den Gewährungstyp für OAuth-Client-Anmeldeinformationen für eingehende Integrationen vom Docusign-OAuth-Client in die Instanz ServiceNow zu verwenden.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Weitere Informationen zum Gewährungstyp für Client-Anmeldeinformationen finden Sie unter Client Credentials.

    Prozedur

    1. Navigieren zu Alle > Systemeigenschaften > Alle Eigenschaften.
    2. Suchen Sie nach der Systemeigenschaft glide.oauth.inbound.client.credential.grant_type.enabled.
    3. Öffnen Sie den Datensatz.
    4. Geben Sie als Werttrueein.
    5. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.

    Erstellen Sie eine Anwendungsregistrierung, um die eingehenden Anrufe zu authentifizieren

    Erstellen Sie eine Anwendungsregistrierung in der Instanz ServiceNow, um die eingehenden Anrufe zu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
    3. Wählen Sie OAuth-API-Endpunkt für externe Clients erstellen aus.
    4. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Anwendungsregistrierungen-Formular
      Feld Beschreibung
      Name Name zur Identifizierung des Anwendungsregistrierungsdatensatzes. Beispiel: Externer DocuSign-Auslöser.
      OAuth-Anwendungsanwender Anwenderrolle, der der OAuth-Token-Flow zugeordnet ist.
    5. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
      Der Anwendungsregistrierungsdatensatz wird erstellt, und der Wert des Client-Geheimnisses wird generiert.

      Kopieren Sie die Werte für Client-ID und Client-Secret, und notieren Sie sie zur späteren Verwendung.

    Aktivieren Sie die Auslöserdefinition in der Instanz ServiceNow .

    Aktivieren Sie die Auslöserdefinition, um die Rückruf-URL in Ihrer Instanz ServiceNow zu generieren.

    Vorbereitungen

    Erforderliche Rolle: flow_designer und connection_admin.

    Warum und wann dieser Vorgang ausgeführt wird

    Docusign verwendet die Rückruf-URL, um die Nutzlast sicher an die Instanz ServiceNow zu senden.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
    2. Wählen Sie die Registerkarte Integrationen.
    3. Aktivieren Sie die Registerkarte Eingehend.
    4. Suchen Sie die Karte „Docusign eSignature-Spoke“, und wählen Sie Details anzeigenaus.
      Suchen Sie die Docusign eSignature-Spoke- Karte.
    5. Wählen Sie Konfigurieren.
      Konfigurieren Sie den Endpunkt.
    6. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Erforderliche Rollen Rollen, mit denen der Flow ausgelöst wird. Wählen Sie beispielsweise adminaus.
      Applikationsregistrierung Wählen Sie die Anwendungsregistrierung aus, die Sie erstellt haben, um eingehende Anrufe zu authentifizieren. Wählen Sie beispielsweise Externer DocuSign-Auslöseraus.

      Aktivieren Sie den Endpunkt.

    7. Klicken Sie auf Aktivieren.
      Der Endpunkt wird aktiviert, und der Wert der URL wird generiert.

      Kopieren Sie den URL- Wert, und notieren Sie ihn zur späteren Verwendung.

      Kopieren Sie die URL zur späteren Verwendung.

    Fügen Sie eine Konfiguration im Docusign-Konto hinzu

    Fügen Sie eine anwenderdefinierte Konfiguration im DocuSign-Konto hinzu, um Echtzeit-Datenaktualisierungen an die Instanz ServiceNow zu senden.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Melden Sie sich beim Docusign-Konto als Administrator an.
    2. Klicken Sie auf Administrator.
    3. Navigieren zu Integrationen > Verbinden.
    4. Klicken Sie unter Konfigurationenauf Konfiguration hinzufügen, und wählen Sie Anwenderdefiniertaus.
    5. Füllen Sie die Werte im Formular aus.
      Feld Beschreibung
      Name Name zur Identifizierung des anwenderdefinierten Konfigurationsdatensatzes.
      URL zum Veröffentlichen Geben Sie die URL, die bei Aktivierung der Auslöserdefinition generiert wurde, in diesem Format ein: https://<ServiceNow-instance-name> .service-now.com/api/sn_docusign_spoke/docusign_esignature_external_trigger

      Weitere Informationen finden Sie unter Aktivieren Sie die Auslöserdefinition in der Instanz ServiceNow ..
      Datenformat Stellen Sie sicher, dass Sie REST v2.1auswählen.
      Modus für Ereignisnachrichtenübermittlung Wählen Sie Einzelne Nachrichten senden (SIM)aus.
      Ereignisse auslösen Erweitern Sie Umschlag und Empfänger, und wählen Sie diese Ereignisse aus:
      • Umschlag gesendet
      • Umschlag zugestellt
      • Umschlag signiert/vollständig abgeschlossen
      • Umschlag abgelehnt
      • Umschlag storniert
      • Umschlag gelöscht
      • Empfänger gesendet
      • Empfänger geliefert
      • Vom Empfänger signiert/abgeschlossen
      • Empfänger abgelehnt

      Löst auszuwählende Ereignisse aus
    6. Aktivieren Sie unter „Integrations- und Sicherheitseinstellungen“das Kontrollkästchen OAuth einbeziehen (empfohlen).
    7. Klicken Sie auf Konfiguration hinzufügen.
      Der anwenderdefinierte Konfigurationsdatensatz wird erstellt.
    8. Klicken Sie für den von Ihnen erstellten anwenderdefinierten Konfigurationsdatensatz auf Aktionen, und wählen Sie Bearbeitenaus.
      Bearbeiten Sie die anwenderdefinierte Konfiguration.
    9. Klicken Sie unter „Integrations- und Sicherheitseinstellungen“auf OAuth verwalten.
      Die Registerkarte OAuth 2.0 wird angezeigt.
    10. Geben Sie die Werte für „Client-ID“ und „Geheimer Clientschlüssel“ ein.
      Diese Werte werden erstellt, wenn Sie einen Anwendungsregistrierungsdatensatz in Instanz ServiceNow erstellen. Weitere Informationen finden Sie unter Erstellen Sie eine Anwendungsregistrierung, um die eingehenden Anrufe zu authentifizieren.
    11. Geben Sie die URL des Autorisierungsservers in diesem Format ein: https://<ServiceNow-instance-name> .service-now.com/oauth_token.do
    12. Klicken Sie auf Speichern.

    Nächste Maßnahme

    Erstellen Sie mit diesen Auslösern Flows in Workflow-Studio gemäß Ihren Anforderungen. Weitere Informationen finden Sie unter Create a flow with an external trigger.