Spoke Docusign eSignature

  • Rversion finale: Yokohama
  • Mis à jour 10 mars 2025
  • 15 minutes de lecture

    • Automatisez le processus d'envoi d'un document à une personne ou à une liste de destinataires pour signature électronique à l'aide de Docusign eSignature. Par exemple, automatisez la gestion des processus d'intégration et de départ des employés, ou l'envoi des accords de confidentialité, des accords juridiques et des énoncés de travaux. Utilisez les données ServiceNow dans des modèles de documents et permettez aux utilisateurs de charger des documents pour les signer si nécessaire.

    Demander des applications dans l'App Store

    Visitez le site Web ServiceNow Store pour découvrir toutes les applications disponibles et pour obtenir des informations sur la procédure à suivre pour soumettre des demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Storenotes de publication relatives à l'historique des versions.

    Abonnement à Centre d’intégration

    Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

    Version de spoke

    Docusign eSignature spoke v4.0.1 est la dernière version.

    Dépendances des spokes

    Si vous rencontrez des difficultés pour installer l'application, assurez-vous que les modules d'extension dépendants suivants sont installés :

    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • ServiceNow Flow Designer : entrées dynamiques (com.glide.hub.dynamic_inputs)
    Remarque :
    Certains de ces modules d'extension sont des fonctionnalités sous licence et nécessitent une licence appropriée s'ils sont utilisés en dehors de l'implémentation des spokes. Pour en savoir plus sur les licences, contactez votre chargé de clientèle.

    Versions compatibles

    Ce spoke a été conçu pour la version v2 ou v2.1 de l’API Docusign eSignature, mais peut être compatible avec les versions ultérieures.

    Fonctionnalités principales

    Le spoke Docusign eSignature permet à un concepteur de flux de :

    • Automatisez le processus d’envoi d’un document à partir d’une pièce jointe ou d’un ServiceNow modèle de signature électronique Docusign à une liste de personnes ou de destinataires pour signature électronique.
    • Découvrez et synchronisez les comptes et modèles de signatures électroniques Docusign dans ServiceNow.
      • Récupérez une liste de comptes et de modèles associés à partir de Docusign eSignature, puis insérez-les ou mettez-les à jour en tant qu’enregistrements dans les tables Comptes [sn_docusign_spoke_accounts] et Modèles [sn_docusign_spoke_docusign_templates] à l’aide du flux secondaire Obtenir des comptes.
      • Récupérez les modèles associés à un compte de signature électronique Docusign spécifié, puis insérez-les ou mettez-les à jour en tant qu’enregistrements dans la table Modèles [sn_docusign_spoke_docusign_templates] à l’aide du flux secondaire Obtenir des modèles par compte.
    • Copiez et personnalisez des exemples de flux pour l’envoi de modèles et de demandes de documents sur demande.
    • Mettez en pause un flux jusqu’à ce qu’un document soit signé. Un webhook scripté de l’API REST attend que le destinataire signe le document.
    • Utilisez les valeurs d’un document signé dans un flux.
    • Joindre un document Docusign eSignature rempli à un enregistrement à des ServiceNow fins d’audit.
    • Gérer les enveloppes et les utilisateurs.

    Exigences relatives au spoke

    • Compte DocuSign eSignature
    • Informations d’identification de l’administrateur de signature électronique DocuSign
    • Application de signature électronique Docusign configurée pour s’intégrer à ServiceNow
    • Détails de l’application de signature électronique DocuSign tels que l’ID client, la clé d’intégrateur, les clés secrètes et les paires de clés RSA
    • ServiceNow Abonnement à Centre d’intégration
      Remarque :
      Assurez-vous d’avoir activé la prise en charge de Concepteur de flux pour le module d’extension Catalogue de services (com.glideapp.servicecatalog.flow_designer).

    Consultez la documentation du Centre de développement Docusign pour obtenir des instructions sur la création et la configuration d’applications personnalisées.

    Flux de spoke

    Le spoke Docusign eSignature fournit des exemples de flux pour illustrer l’automatisation des tâches Docusign. Utilisez les actions de spoke Docusign eSignature pour automatiser toutes les tâches souhaitées par votre organisation. Pour personnaliser un exemple de flux, copiez-le dans un nouveau périmètre de l’application. Exemples de flux disponibles :

    Flux Description
    Envoyer un document pour signature électronique Envoie un document à Docusign pour signature électronique lorsqu’une demande de Catalogue de services est créée par l’élément Envoyer un document pour signature électronique . Avant d’utiliser ce flux, activez l’élément de catalogue Envoyer un document pour signature électronique .
    Envoyer une offre d’emploi au candidat à l’aide du modèle Docusign Envoie une enveloppe DocuSign à un utilisateur à l’aide d’un modèle. Par exemple, utilisez ce flux pour envoyer une offre d’emploi à un candidat. Avant d’utiliser ce flux, activez l’élément de catalogue Modèle de démonstration - Envoyer une offre d’emploi à un candidat .

    Le Spoke Docusign eSignature ajoute des éléments de catalogue à utiliser avec les exemples de flux Spoke Docusign eSignature. Avant de déclencher un exemple de flux Spoke Docusign eSignature, activez ces éléments de catalogue.

    Élément de catalogue Description
    Envoyer un document pour signature électronique Envoie un document pour signature électronique dans Docusign.
    Modèle de démonstration : envoyer une offre d’emploi au candidat Envoie une offre d'emploi à l'aide d'un modèle Docusign.

    Flux secondaires du spoke

    Le spoke Docusign eSignature fournit des exemples de flux secondaires pour illustrer l’automatisation des tâches Docusign. Pour personnaliser un exemple de flux secondaire, copiez-le dans un nouveau périmètre de l’application. Exemples de flux secondaires disponibles :

    Catégorie Flux secondaire Description
    Gestion des enveloppes Joindre une enveloppe Docusign à un enregistrement ServiceNow Joint tous les documents d’une enveloppe à un ServiceNow enregistrement.
    Obtenir et définir les données de champ Docusign Traite une liste de variables d’éléments de catalogue et met à jour une enveloppe brouillon avec chaque valeur de variable.
    Gestion des utilisateurs Créer un utilisateur Crée un utilisateur comprenant le profil d’autorisation et les appartenances à des groupes.
    Mettre à jour un utilisateur Met à jour un utilisateur, y compris le profil d’autorisation et les appartenances aux groupes.
    Gestion des modèles Obtenir des modèles par compte Récupère les modèles d’un compte Docusign et les stocke dans la table Modèles.
    Par défaut Exemple de flux secondaire de webhook Docusign Récupère les détails du destinataire pour l’enveloppe spécifiée.
    Gestion des comptes Obtenir des comptes Récupère les comptes Docusign et les modèles associés à chaque compte et les stocke respectivement dans une table Comptes et modèles.

    Actions du spoke

    Le spoke Docusign eSignature fournit des actions pour automatiser les tâches Docusign lorsque des événements se produisent dans ServiceNow. Les actions disponibles sont les suivantes :

    Catégorie Action Description
    Gestion des comptes Rechercher des fournisseurs de signature de compte Récupère une liste de fournisseurs de signature que le compte spécifié peut utiliser.
    Rechercher des comptes par alias Récupère les comptes associés à l’enregistrement d’alias de connexion et d’informations d’identification du spoke.
    Rechercher un ID de rôle Récupère l’ID de rôle pour le nom de rôle spécifié.
    Gestion des enveloppes en vrac Créer une liste d’envoi en bloc Crée une liste d’envoi en bloc.
    Créer une demande d’envoi en bloc Crée une demande d’envoi en bloc basée sur une liste d’envoi en bloc existante à l’aide d’une enveloppe ou d’un modèle.
    Créer une demande de test d’envoi en bloc Crée une demande de test d’envoi en bloc pour tester la compatibilité avec l’enveloppe ou le modèle existant.
    Supprimer la liste d’envoi en bloc Supprime la liste d’envoi en bloc spécifiée.
    Rechercher le flux d’enveloppes de lot d’envoi en bloc Récupère les enveloppes du lot d’envoi en bloc spécifié.
    Rechercher l’état du lot d’envoi en bloc Récupère l’état général du lot d’envoi en bloc spécifié, tel que le nombre de réussites, le nombre en attente, le nombre d’erreurs, etc.
    Rechercher un flux de lots d’envoi en bloc Récupère les informations des lots d’envoi en bloc.
    Rechercher une liste d’envoi en bloc Récupère la liste d’envoi en bloc spécifiée.
    Rechercher des listes d’envoi en bloc Récupère une liste des listes d’envoi en bloc.
    Mettre à jour l’action du lot d’envoi en bloc Effectue une action en bloc (renvoyer, corriger ou annuler) sur le lot d’envoi en bloc spécifié.
    Mettre à jour l’état du lot d’envoi en bloc Met à jour le nom du lot d’envoi en bloc spécifié.
    Mettre à jour la liste d’envoi en bloc Met à jour la liste d’envoi en bloc spécifiée.
    Document Signature Rechercher l’URL de signature incorporée Crée une URL de signature incorporée dans une application. L’utilisateur peut signer le document sans quitter l’application.
    Remarque :
    L’URL de signature est active pendant 300 secondes et peut être envoyée à un seul destinataire à la fois.
    Rechercher l’URL de signature incorporée en ligne Récupère une URL qui vous permet d’intégrer la vue de destinataire sur Docusign.
    Gestion des documents Ajouter un document à l’enveloppe Ajoute des documents à l’enveloppe.
    Joindre un document combiné à un enregistrement ServiceNow Joint les documents Docusign à un enregistrement ServiceNow.
    Joindre le document Docusign à l’enregistrement ServiceNow Récupère un document Docusign signé et le joint à un ServiceNow enregistrement.
    Rechercher un ID de document par nom Récupère l’ID de document dans une enveloppe à l’aide du nom de document spécifié.
    Rechercher des documents dans une enveloppe Renvoie une liste de documents avec un ID et un nom dans l’enveloppe DocuSign donnée.
    Remplacer un document dans une enveloppe Remplace les documents dans l’enveloppe.
    Gestion des enveloppes Ajouter un destinataire à l’enveloppe Ajoute le destinataire spécifié à l’enveloppe spécifiée.
    Remarque :
    • L’ID de destinataire utilisé dans cette action est associé à l’enveloppe et est différent de l’ID de destinataire utilisé dans l’action Obtenir tous les champs du modèle.
    • L’administrateur saisit une valeur numérique pour cet ID de destinataire.
    Ajouter des destinataires à l’enveloppe Ajoute les destinataires spécifiés à l’enveloppe spécifiée.
    Joindre le certificat Docusign à l’enregistrement ServiceNow Joint un certificat Docusign à un enregistrement ServiceNow.
    Annuler l’enveloppe Annule une enveloppe en cours de traitement.
    Créer une enveloppe brouillon à partir d’un modèle Crée une enveloppe brouillon à partir d’un modèle Docusign existant.
    Créer une enveloppe à partir d’un modèle composite Crée une enveloppe à partir d’un modèle composite existant.
    Rechercher un ID de champ Récupère l’ID du champ spécifié à partir de l’enveloppe de brouillon spécifiée.
    Rechercher la valeur du champ Récupère la valeur du champ spécifié à partir de l’enveloppe spécifiée.
    Rechercher des champs Récupère la liste des champs associés à un document dans une enveloppe brouillon.
    Rechercher un ID de destinataire par nom de rôle Récupère l’ID de destinataire du nom de rôle spécifié à partir de l’enveloppe spécifiée.
    Rechercher des destinataires dans une enveloppe Renvoie une liste de destinataires avec un ID de destinataire et un nom de rôle dans l’enveloppe DocuSign donnée.
    Supprimer le destinataire de l’enveloppe Supprime un destinataire d’une enveloppe Docusign.
    Envoyer une demande de signature ad hoc à l’utilisateur Envoie un document Docusign associé à l’enregistrement spécifié ServiceNow au destinataire spécifié pour signature.
    Envoyer une demande de signature ad hoc aux utilisateurs : en ligne Envoie un ou plusieurs documents chargés à partir d’un enregistrement ServiceNow à plusieurs destinataires.
    Envoyer l’enveloppe Envoie une enveloppe aux destinataires spécifiés.
    Remarque :
    Tous les détails du destinataire doivent être fournis avant d’envoyer une enveloppe.
    Définir la valeur du champ Définit la valeur du champ spécifié dans l’enveloppe de brouillon spécifiée.
    Définir des valeurs de champ Affecte les valeurs de plusieurs champs associés à un document dans une enveloppe brouillon.
    Attendre la signature de Docusign Met en pause un flux jusqu’à ce que le document spécifié ait été signé ou rejeté. Renvoie l’état du document au flux pour un traitement ultérieur.
    Gestion des groupes Ajouter un utilisateur au groupe Ajoute un utilisateur à partir d’un groupe.
    Rechercher un ID de groupe Récupère un ID de groupe pour le nom de rôle spécifié.
    Retirer l'utilisateur du groupe Supprime l’utilisateur spécifié d’un groupe.
    Gestion de modèles Rechercher des modèles par compte Récupère les modèles associés au compte Docusign spécifié.
    Rechercher les champs de modèle Récupère tous les champs d’un modèle défini pour un destinataire.
    Remarque :
    • L’ID de destinataire utilisé dans cette action est associé au modèle et est différent de l’ID de destinataire utilisé dans l’action Ajouter un destinataire à l’enveloppe.
    • La valeur de l’ID du destinataire est un nombre unique généré par le système.
    Rechercher des destinataires de modèle Récupère tous les destinataires définis pour un modèle.
    Gestion des utilisateurs Créer un utilisateur Crée un utilisateur Docusign avec les détails de l’utilisateur spécifiés.
    Rechercher les détails de l’utilisateur Récupère les détails d’un utilisateur.
    Mettre à jour un utilisateur Met à jour l’utilisateur spécifié.
    Supprimer l'utilisateur Supprime l’utilisateur Docusign spécifié.

    Module de spoke

    Le spoke Docusign eSignature ajoute un module Docusign à votre ServiceNow instance. Le spoke Docusign eSignature synchronise et stocke les modèles et les enveloppes au format ServiceNow. Le spoke Docusign eSignature inclut ces tables et enregistrements.

    Table/enregistrement Description
    Alias de connexion L’alias de connexion Docusign.
    Tâche planifiée La tâche planifiée Obtenir des comptes et des modèles qui synchronise les modèles et les enveloppes avec votre compte Docusign.
    Comptes Comptes DocuSign synchronisés avec votre ServiceNow instance. Pour synchroniser les comptes, reportez-vous à la section Synchroniser Docusign avec ServiceNow. Le flux secondaire Obtenir les comptes récupère une liste de comptes et de modèles associés à partir de Docusign, puis les insère ou les met à jour en tant qu’enregistrements dans les tables Comptes [sn_docusign_spoke_accounts] et Modèles [sn_docusign_spoke_docusign_templates].
    Modèles Modèles DocuSign à partir de comptes DocuSign synchronisés. Le flux secondaire Obtenir des modèles par compte récupère les modèles associés à un compte Docusign spécifié, puis les insère ou les met à jour en tant qu’enregistrements dans la table Modèles [sn_docusign_spoke_docusign_templates].
    Enveloppes Enveloppes DocuSign à partir de comptes Docusign synchronisés. Les enregistrements de la table Enveloppes ne sont mis à jour que lorsque le webhook est configuré pour le compte Docusign.
    Flux secondaires de réponse au webhook DocuSign
    Les tables de spoke Docusign eSignature incluent ces champs.
    Table Champs
    Comptes [sn_docusign_spoke_accounts]
    • ID du compte
    • Nom du compte
    • Description
    • E-mail
    • Alias
    • Nom d'affichage
    Modèles [sn_docusign_spoke_docusign_templates]
    • Compte
    • ID de modèle
    • Nom
    • Description
    • Dernière modification
    • Nom d'affichage
    Enveloppes [sn_docusign_spoke_envelopes]
    • Compte
    • ID
    • Statut
    • Date de signature
    • Raison refusée
    • Nom d'affichage
    • Signature incorporée
    • Date de signature Fuseau horaire
    • Modèle

    Déclencheurs de spokes

    ServiceNow prend en charge des événements spécifiques sur Docusign qui créent des déclencheurs. Vous devez d’abord configurer un flux avec une définition de déclencheur prise en charge. Lorsqu’un événement, par exemple une demande push, se produit sur le Docusign, il envoie la charge utile via un webhook à l’instance ServiceNow . Ensuite, le flux que vous avez configuré est déclenché sur l’instance ServiceNow pour automatiser un workflow. Les événements pris en charge sont les suivants :

    Catégorie Déclencheur Définition
    Gestion des enveloppes Enveloppe terminée Le déclencheur est lancé lorsqu’une enveloppe a été remplie par tous les destinataires. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Enveloppe refusée Le déclenchement est initié lorsqu’une enveloppe a été refusée par l’un des destinataires. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Enveloppe supprimée Le déclencheur est lancé lorsqu’une enveloppe envoyée est supprimée. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Enveloppe livrée Le déclenchement est lancé lorsque tous les destinataires ont ouvert l’enveloppe via le site Web de signature Docusign. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Enveloppe envoyée Le déclencheur est lancé lorsqu’une enveloppe est envoyée au destinataire. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Enveloppe annulée Le déclencheur est lancé lorsqu’une enveloppe a été annulée par l’expéditeur ou a expiré. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Gestion des destinataires Destinataire terminé Le déclencheur est lancé lorsque le destinataire a terminé ses actions pour l’enveloppe. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Destinataire refusé Le déclencheur est déclenché lorsque le destinataire refuse de signer le(s) document(s) dans l’enveloppe. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Destinataire livré Le déclenchement est lancé lorsque le destinataire a consulté le(s) document(s) dans une enveloppe via le site Web de signature Docusign. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.
    Destinataire envoyé Le déclencheur est lancé lorsqu’une notification par e-mail est envoyée au destinataire pour lui indiquer que c’est à son tour de signer une enveloppe. Configurez le flux pour qu’il s’exécute uniquement lorsque les conditions de déclenchement spécifiées sont remplies.

    Pour plus d’informations sur la configuration des déclencheurs du spoke Docusign eSignature, reportez-vous à la section Configurer des déclencheurs pour le spoke Docusign eSignature. Pour plus d’informations sur l’intégration entrante, reportez-vous à la section Intégration entrante conditionnelle et pilotée par les événements.

    Exigences relatives au compte DocuSign

    Le spoke Docusign eSignature nécessite la configuration de votre compte Docusign pour générer un jeton d’attribution de porteur OAuth 2.0 JWT.

    Exigences en matière d'alias de connexion et d'informations d'identification

    Hub d'intégration utilise des alias pour gérer les informations de connexion et d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

    Ce spoke utilise l’enregistrement d’alias de connexion et d’informations d’identification Docusign pour autoriser des actions.

    Important :
    • Vous pouvez choisir de configurer le spoke Docusign à l’aide de l’octroi de code d’autorisation ou de l’octroi JWT.
      • Utilisez le code d’autorisation Accorder si votre intégration utilise un navigateur ou un client pour effectuer des demandes à un serveur Web.
      • Utilisez JWT Grant si chaque utilisateur de votre intégration utilise un seul compte système pour se connecter.

      Pour plus d’informations sur le moment où choisir l’une des méthodes de configuration, consultez Choisir le type OAuth dans la documentation du développeur Docusign.

    • Votre entreprise peut disposer d’un compte Docusign pour chaque service qui utilise Docusign. Pour utiliser plusieurs comptes avec ce spoke, créez un alias enfant pour chaque compte. Assurez-vous également de remplacer l’alias de base par l’alias enfant dans vos flux. Lors de l’exécution, le système identifie l’alias enfant associé au compte et envoie les informations de connexion et d’identification correctes dans la demande.

      Si votre société ne dispose que d’un seul compte, vous pouvez utiliser l’alias Docusign par défaut fourni avec le spoke et procéder à la configuration du spoke Docusign à l’aide de l’octroi de code d’autorisation ou de l’octroi JWT.

    Besoins du MID Server

    Ces actions utilisent des appels REST, qui peuvent s’exécuter sur une instance ou un serveur MID. Utilisez l’enregistrement de connexion associé à l’alias Docusign pour configurer l’emplacement d’exécution des actions et définir les attributs de sélection de Serveur MID. Pour en savoir plus, consultez Serveur MID.