Spoke Docusign eSignature

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

Le spoke Docusign eSignature v3.1.2 correspond à 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

Le spoke Docusign eSignature permet à un concepteur de flux 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 électronique.
Détectez et synchronisez les comptes et les modèles ServiceNowDocusign eSignature dans .
- 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 d’API REST scripté attend que le destinataire signe le document.
Utiliser les valeurs d’un document signé dans un flux.
Joignez un document Docusign avec signature électronique dûment rempli à 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 Docusign eSignature
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égration, 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 Docusign Developer Center 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 spoke Docusign eSignature pour automatiser toutes les tâches souhaitées par votre entreprise. Pour personnaliser un exemple de flux, copiez-le dans un nouveau périmètre de l’application. Les exemples de flux disponibles sont les suivants :


Flux	Description
Envoyer un document pour signature électronique	Envoie un document à Docusign pour une 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 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 é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. Les exemples de flux secondaires disponibles sont les suivants :


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.
Gestion des enveloppes	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.
Gestion des utilisateurs	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.
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 respectivement dans la table Comptes et modèles.

Actions du spoke

Le spoke Docusign eSignature fournit des actions permettant d’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 signatures 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 un flux d’enveloppes par 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, et ainsi de suite.
	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 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’envoi en bloc	Met à jour la liste d’envoi en bloc spécifiée.
Document Signature	Rechercher l’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 destinataire à la fois.
Document Signature	Rechercher l’URL de signature intégrée en ligne	Récupère une URL qui vous permet d’intégrer la vue des destinataires 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 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 d’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 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 un 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 gabarit 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 un brouillon d’enveloppe.
	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 : 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 préliminaire 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	Suspend un flux jusqu’à ce que le document spécifié ait été signé ou rejeté. Renvoie l’état du document dans le flux pour 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 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 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 les tables et enregistrements suivants :


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 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 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 Fuseau horaire de la date de signature Modèle

Exigences relatives au compte Docusign

Le spoke Docusign eSignature nécessite la configuration de 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’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 les actions.

Important :

Vous pouvez choisir de configurer le spoke Docusign à l’aide de l’attribution du code d’autorisation ou de l’attribution JWT.
- Utilisez l’accord de code d’autorisation 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 en savoir plus sur le moment choisi pour choisir l’une ou l’autre des méthodes de configuration, consultez la section Choisir le type OAuth dans la documentation du développeur Docusign.
Votre entreprise dispose peut-être 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. Veillez également à 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.
- Pour plus d’informations sur l’alias enfant et le remplacement de l’alias de base, reportez-vous à la section Prise en charge de plusieurs connexions.
- Pour en savoir plus sur la configuration de plusieurs comptes, reportez-vous à la section Créer des alias enfants pour les comptes Docusign supplémentaires.
Si votre entreprise 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’attribution du code d’autorisation ou de l’attribution JWT.

Besoins du MID Server

Ces actions utilisent des appels REST, qui peuvent s’exécuter sur une instance ou sur 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 du Serveur MID. Pour en savoir plus, consultez Serveur MID.