Spoke de signature électronique DocuSign

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 13 minutes de lecture

    • Automatisez le processus d'envoi d'un document à une personne ou à une liste de destinataires pour signature numérique à 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

    Spoke DocuSign eSignature La version 3.0.0 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)
    • Concepteur de flux ServiceNow – 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

    Spoke DocuSign eSignature permet à un Flow Designer d’effectuer les opérations suivantes :

    • 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 personne ou à une liste de destinataires pour signature numérique.
    • Détectez et synchronisez les comptes et les 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 échantillons de flux pour l’envoi de modèles et de demandes de documents à la demande.
    • Mettre 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.
    • Joignez un document de signature électronique DocuSign complété à un ServiceNow enregistrement à des fins d’audit.
    • Gérez 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 que vous avez activé la prise en charge de Flow Designer pour le module d’extension Service Catalog (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 spokes

    La Spoke DocuSign eSignature fournit des exemples de flux pour illustrer l’automatisation des tâches DocuSign. Utilisez Spoke DocuSign eSignature des actions pour automatiser toutes les tâches souhaitées par votre organisation. Pour personnaliser un échantillon de flux, copiez-le dans un nouveau périmètre de l’application. Les échantillons de flux disponibles sont les suivants :

    Flux Description
    Envoyer un document pour signature numérique Envoie un document à DocuSign pour signature numérique lorsqu’une demande de Service Catalog est créée par l’élément Envoyer un document pour signature numérique . Avant d’utiliser ce flux, activez l’élément de catalogue Envoyer un document pour signature numérique .
    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 Démontrer le modèle - Envoyer une offre d’emploi au 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 numérique Envoie un document pour signature numérique 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 l’enveloppe DocuSign à l’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, y compris le profil d’autorisation et les appartenances au groupe.
    Mettre à jour un utilisateur Met à jour un utilisateur, y compris le profil d’autorisation et les appartenances au groupe.
    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.
    Valeur 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 et modèles DocuSign associés à chaque compte et les stocke dans la table Comptes et Modèles respectivement.

    Actions du spoke

    La 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 comptes par alias Récupère les comptes associés à l’enregistrement de l’alias de connexion et d’informations d’identification du spoke.
    Rechercher un ID de rôle Récupère l’ID des rôles pour le nom de rôle spécifié.
    Gestion des enveloppes en vrac Créer une liste d’envois groupés Crée une liste d’envoi groupé.
    Créer une demande d’envoi groupé Crée une demande d’envoi groupé basée sur une liste d’envois groupés 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 groupé pour tester la compatibilité avec l’enveloppe ou le modèle existant.
    Supprimer la liste d’envois en bloc Supprime la liste d’envois 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é, comme le nombre de réussites, le nombre en attente, le nombre d’erreurs, et ainsi de suite.
    Rechercher le flux de lots d’envoi en bloc Récupère les informations des lots d’envoi en bloc.
    Rechercher une liste d’envois groupés Récupère la liste d’envois en bloc spécifiée.
    Rechercher des listes d’envois groupés Récupère une liste des listes d’envoi en bloc.
    Mettre à jour l’action de 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’envois groupés Met à jour la liste d’envois groupés spécifiée.
    Document Signature Rechercher une URL de signature intégré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 intégrée en ligne Récupère une URL qui vous permet d’incorporer la vue du destinataire sur DocuSign.
    Gestion des documents Ajouter un document à l’enveloppe Ajoute des documents à l’enveloppe.
    Joindre un document combiné à l’enregistrement ServiceNow Joint des documents DocuSign à un enregistrement ServiceNow.
    Joindre le document DocuSign à l’enregistrement 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 à partir d’une enveloppe en utilisant le 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 le document dans l’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 de modèle.
    • L’administrateur entre 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 un brouillon d’enveloppe à partir d’un modèle Crée un brouillon d’enveloppe à 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.
    Retirer 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 Envoie un document DocuSign associé à l’enregistrement spécifié ServiceNow à plusieurs destinataires spécifiés pour signature à la fois.
    Remarque :
    Lorsque l’option Utiliser la signature séquentielle est activée, le document DocuSign est envoyé à plusieurs destinataires dans un ordre séquentiel. L’option Utiliser la signature séquentielle contrôle l’ordre dans lequel les destinataires reçoivent et signent les documents.
    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 l’envoi d’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 dans le flux pour un traitement ultérieur.
    Récupération des métadonnées Obtenir la liste des documents Obtient la liste de tous les documents DocuSign dans une enveloppe.
    Obtenir une liste de groupes (métadonnées) Récupère les métadonnées d’une liste de groupes.
    Accéder aux rôles Récupère une liste de rôles.
    Obtenir des rôles (métadonnées) Récupère les métadonnées pour une liste de rôles.
    Gestion des groupes Ajouter un utilisateur au groupe Ajoute un utilisateur 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 des 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 de destinataire est un numéro unique généré par le système.
    Rechercher les destinataires du 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 spokes

    Cela Spoke DocuSign eSignature ajoute un module DocuSign à votre ServiceNow instance. L’synchronise Spoke DocuSign eSignature et stocke les modèles et les enveloppes dans 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 des comptes, reportez-vous à la section Synchroniser DocuSign avec ServiceNow. Le flux secondaire Obtenir des 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.
    Les Spoke DocuSign eSignature tables comprennent ces champs.
    Table Champs
    Comptes [sn_docusign_spoke_accounts]
    • ID de 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 intégrée
    • Date de signature Fuseau horaire
    • Modèle

    Exigences relatives aux comptes DocuSign

    Vous devez Spoke DocuSign eSignature configurer votre compte DocuSign pour générer un jeton OAuth 2.0 JWT Bearer Grant.

    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’informations 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’autorisation d’attribution de code ou de l’autorisation JWT.
      • Utilisez l’autorisation d’octroi de code si votre intégration utilise un navigateur ou un client pour effectuer des requêtes à 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 choix de 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’autorisation d’attribution de code ou de l’autorisation JWT.

    Besoins du MID Server

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