Dans la page Lightning pour Salesforce, accédez à l’onglet Administrateur Adobe Acrobat Sign.
Dernière mise à jour le
16 oct. 2024
Vous ne parvenez pas à envoyer des accords depuis Salesforce ? Les mappages de données ne mettent pas à jour les champs Salesforce ?
Le document Adobe Acrobat Sign pour Salesforce : Guide de dépannage est conçu pour vous aider à résoudre les problèmes d’envoi d’accords à partir de Salesforce, de mappage de données ou de mise à jour du statut automatique. Découvrez comment :
- Résoudre les problèmes de mappage de données
- Résoudre les problèmes d’envoi des accords
- Résoudre les problèmes de mise à jour du statut automatique
- Résoudre les problèmes pouvant survenir après l’activation des domaines améliorés
- Résoudre les problèmes de recherche de prospects dans l’environnement Government Cloud
- Contacter l’assistance technique
Les mappages de données Acrobat Sign mettent à jour les objets Salesforce lorsqu’un accord Acrobat Sign est signé ou à une étape spécifique du workflow de l’accord. Chaque mappage de données est configuré à l’avance et inclut des règles de mappage de données. Chaque règle de mappage de données définit la source de données et le champ Salesforce cible qu’elle doit mettre à jour. Pour plus d’informations, voir Mappage de données Salesforce.
Si le mappage de données ne met pas à jour un champ Salesforce, exécutez les étapes de dépannage suivantes pour identifier et résoudre le problème :
Pour ce faire, procédez comme suit :
Sélectionnez Autoriser. Le message suivant s’affiche : Les mises à jour du statut automatiques sont activées pour cette organisation.
Assurez-vous que l’utilisateur des mises à jour du statut automatiques (généralement l’administrateur du compte Sign que vous avez utilisé pour configurer l’intégration) et l’expéditeur ont accès aux objets que vous essayez de mettre à jour avec le mappage de données.
Pour vérifier la valeur du champ, vous pouvez l’ajouter à la vue de liste Accords, ou encore utiliser Developer Console ou Workbench.
Assurez-vous que le champ « Résultat du mappage des données » sur l'objet « Contrat » a la valeur « Terminé » ou « Échec ». S'il n'y a aucune valeur, cela signifie que le mappage des données n'a pas été déclenché du tout. Si la valeur est vide et si l’ID utilisateur est renseigné dans le champ Mappage de données, essayez de redéclencher le mappage de données comme suit :
Le champ Erreur de mappage des données enregistre les erreurs du mappage de données. Vous pouvez vérifier la valeur du champ en l’ajoutant à la vue de liste Accords, à l’aide de Developer Console ou de Workbench. Vous trouverez ci-dessous une liste des erreurs courantes et des étapes de résolution correspondantes :
| Erreur | Impossible de mapper le champ de données : échec de la mise à jour System.DmlException. Première exception sur la ligne 0 avec l’ID 00ZxxqwertasdmjVUAR ; première erreur : STRING_TOO_LONG, Titre du propriétaire : valeur de données trop élevée : Adobe Acrobat Sign Adobe Inc (longueur maximale = 20) : [Owner_Title__c] (echosign_dev1) 165 |
Résolution : Cette erreur signifie que les données dans le champ de formulaire du document mis à jour dépassent la limite de taille du champ Salesforce que vous essayez de mettre à jour. Pour y remédier :
|
|
| Erreur |
Tentative de mappage à une référence d’objet associée qui n’a pas été définie sur l’accord : <nom de l’api du champ de l’objet Salesforce que vous tentez de mettre à jour> » |
Résolution : Cette erreur signifie qu’il n’existe aucune connexion établie entre l’objet Accord et l’objet Salesforce que vous essayez de mettre à jour. Voir l’étape 4 ci-dessus. |
|
| Erreur |
Impossible de mapper le champ de données : System.NullPointerException Tentative de suppression de la référence d’un objet nul (echosign_dev1) 656 |
Résolution Cette erreur indique que le mappage de données a échoué car il n’a pas pu accéder à un objet requis. Suivez la procédure ci-dessous pour résoudre le problème :
|
Exemple d’utilisateur :
John Smith
Exemple de cas d’utilisation :
John veut :
- envoyer des accords à partir d’un objet personnalisé appelé Demo 1 à l’aide d’un modèle d’accord ;
- extraire les informations d’un autre objet personnalisé appelé Demo 2 associé à l’objet Demo 1 et les envoyer vers l’accord ; et
- transférer les informations vers l’enregistrement d’objet Demo 2 une fois l’accord signé.
Procédure à suivre pour obtenir le cas d’utilisation :
- Dans l’objet Accord d’Acrobat Sign, créez un champ de recherche pour l’objet Demo 1.
- Sur l'objet « Demo 1 », créez un champ de recherche pour l'objet « Demo 2 ».
Vous ne pouvez pas extraire ou envoyer des informations depuis/vers une liste associée. - Créez un modèle de mappage de données comme suit :
- Indiquez un nom de modèle unique.
- Sous Mappages de champs, sélectionnez Objet sélectionné, puis dans le menu déroulant, sélectionnez Demo 1.
- Dans la deuxième liste déroulante qui se charge, sélectionnez ID Demo 2.
- Dans la troisième liste déroulante qui s’affiche, laissez Aucun(e) et sélectionnez Sélectionner.
- Dans Quel champ Salesforce mettre à jour ?, choisissez le nom du champ que vous devez mettre à jour.
- Pour terminer la configuration du mappage de données, suivez les étapes de la section Utiliser des mappages de données pour transférer les données et les fichiers des signataires vers les enregistrements Salesforce du Guide des modèles et des mappages de champs.
- Créez un modèle de mappage de fusion comme suit :
- Indiquez un nom de modèle unique.
- Sélectionnez Ajouter le mappage des champs.
- Sous Valeur source, sélectionnez Objet sélectionné, puis dans le menu déroulant, sélectionnez Demo 1.
- Dans la deuxième liste déroulante qui se charge, sélectionnez ID Demo 2.
- Dans la liste déroulante suivante qui se charge, sélectionnez le nom du champ avec la valeur que vous devez extraire, puis sélectionnez Terminé.
- Pour terminer la configuration du mappage de fusion, suivez les instructions de la section Utiliser des mappages de fusion pour générer des documents avec les données Salesforce du Guide des modèles et des mappages de champs.
- Créez un modèle d’accord en suivant les étapes décrites dans la section Créer des workflows de modèles.
- Dans le modèle d’accord que vous avez créé ci-dessus, assurez-vous que les modèles de mappage de fusion et de mappage de données sont inclus dans la section Mappage de données.
- Dans la section Informations sur le modèle du modèle d’accord, sélectionnez l’objet Salesforce comme Demo 1.
- Sélectionnez Mapper les données dans les champs de l’accord, puis, dans la boîte de dialogue qui s’affiche :
- Sélectionnez l’option Sélectionner à partir de l’objet.
- Sous Type de source, sélectionnez ID Demo 1.
- Sous Champ d’accord cible, sélectionnez l’objet Demo 1 dans le champ de recherche.
- Sélectionnez Enregistrer.
- Dans le modèle de contrat, sélectionnez Enregistrer.
Il crée un template de contrat lié à l'objet « Demo 1 » avec le mappage de fusion et le mappage de données activés. - Ouvrez un enregistrement d’objet Demo 1 et sélectionnez
> Modifier la page. Ensuite, à partir de la section Gestion personnalisée du panneau de gauche, faites glisser et déposez AgreementPanel et sélectionnez Enregistrer. - Sélectionnez Activation et attribuez la page d’enregistrement en fonction de vos besoins. À des fins de test, choisissez Affecter comme valeur par défaut de l’organisation, qui expose AgreementPanel à tous les utilisateurs.
- Sélectionnez Suivant et Enregistrer.
- Accédez à l’enregistrement d’objet Demo 1 et actualisez la page. Le panneau AgreementPanel que vous avez ajouté doit apparaître.
- Sélectionnez Envoyer un accord pour signature. Le modèle d’accord que vous avez créé s’affiche.
- Sélectionnez le modèle d’accord et suivez les étapes à l’écran pour envoyer l’accord. Vérifiez que l’accord inclut les données fusionnées de l’objet Demo 2.
- Signez l’accord. L’enregistrement Demo 2 mis à jour avec la valeur de l’accord s’affiche.
Si vous ne parvenez pas à envoyer des accords à partir de Salesforce, exécutez les étapes de dépannage suivantes :
Assurez-vous que vous utilisez une version prise en charge d’Adobe Acrobat Sign. Voir Versions prises en charge.
Assurez-vous de disposer, en tant qu'expéditeur, des autorisations requises.
Voir Comment accorder l’accès requis aux utilisateurs. Outre les objets et les champs mentionnés dans le guide, l’expéditeur doit avoir accès aux autres objets Salesforce utilisés dans le workflow.
Vérifiez si votre objet Accord ou d’autres objets Acrobat Sign dans Salesforce ont des personnalisations telles que des déclencheurs, des workflows ou des règles. Si oui, désactivez toutes les personnalisations et envoyez un contrat de test pour voir s'il passe.
Si le contrat est envoyé avec succès après la désactivation des personnalisations, consultez notre guide du développeur pour obtenir des directives.
Annotation
nous ne proposons pas de support pour le dépannage des personnalisations.
Utilisez l’une des méthodes suivantes pour identifier le type d’erreur que vous avez reçu lors de l’envoi de l’accord :
- Ouvrez l’enregistrement de l’accord affecté dans Salesforce et recherchez une bannière rouge avec un message d’erreur. Cette erreur doit indiquer la cause première.
- Cochez le champ Message d’erreur sur l’objet Notification d’accord.
- Pour vérifier via Developer Console et exécuter la requête SOQL suivante :
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<saisir l’id d’accord>
Reportez-vous au tableau suivant répertoriant les erreurs et les étapes de résolution :
|
Erreur |
Résolution |
|---|---|
|
Adresse e-mail ou ID d’utilisateur non valide spécifié dans l’en-tête x-api-user Vous ne possédez pas de compte d’utilisateur Adobe Acrobat Sign valide |
Ces erreurs indiquent que l’expéditeur n’a pas de licence Acrobat Sign valide. Pour résoudre le problème :
|
|
Format de fichier non pris en charge |
Cette erreur se produit lorsque le document que vous tentez d’envoyer pour signature n’est pas dans un format pris en charge. Reportez-vous à la section Formats de document pris en charge de la page Configuration requise pour Acrobat Sign pour vérifier les formats de fichier pouvant être chargés dans Acrobat Sign. |
|
ID d’objet incorrect utilisé dans le bouton de signature |
Cette erreur se produit lorsque l’ID de modèle du bouton Envoyer au nom de ou l’ID principal de l’objet n’est pas valide. Nous vous suggérons de saisir l’ID d’objet correct, puis de réessayer le processus. |
Si un accord n’est pas mis à jour avec le statut correct, exécutez les étapes de dépannage suivantes :
Vérifiez que vous respectez les conditions préalables et les configurations post-installation (obligatoire) mentionnées dans le document Adobe Acrobat Sign pour Salesforce : Guide d’installation.
Sur la page Lightning de Salesforce, accédez à Administrateur Adobe Acrobat Sign > Activer les mises à jour du statut automatiques et assurez-vous que le message Les mises à jour du statut automatiques sont activées pour cette organisation s’affiche.
Si le message ne s’affiche pas, procédez comme suit :
- Déconnectez-vous puis reconnectez-vous en tant qu’administrateur système.
- Accédez à Administrateur Adobe Acrobat Sign > Activer les mises à jour du statut automatiques et sélectionnez Activer.
- Dans la boîte de dialogue Autoriser l’accès à Acrobat Sign qui s’affiche :
- Notez l’adresse électronique au bas de la boîte de dialogue.
- Assurez-vous que cette adresse électronique dispose d’une licence Sign valide et qu’elle est un administrateur système dans Salesforce.
- Assurez-vous que l’utilisateur dispose des autorisations Utilisateur de l’intégration Adobe Sign.
- Sélectionnez Autoriser.
Le message suivant devrait s’afficher : Les mises à jour du statut automatiques sont activées pour cette organisation.
Dans l’objet Notification d’accord, consultez le champ Message d’erreur. Pour vérifier la valeur du champ, exécutez la requête SOQL ci-dessous sur Developer Console :
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'
Si l’accord est un accord push qui a été créé en dehors de l’environnement Salesforce, assurez-vous de suivre les recommandations du document Adobe Acrobat Sign pour Salesforce : Guide du service Documents volumineux et accords push.
Accédez à l’onglet Accords, sélectionnez tous les accords qui n’ont pas pu être mis à jour, puis dans le coin supérieur droit, sélectionnez Mettre à jour l’accord.
Vérifiez si le statut de ces accords est mis à jour. S’ils sont mis à jour, vérifiez si le problème est toujours reproductible avec un nouvel accord de test. S’il est reproductible, suivez les étapes de dépannage ci-dessous.
Si le problème ne se reproduit pas, il peut s’agir d’une instance unique et nous vous suggérons de vous référer à ce guide de dépannage si le problème survient de nouveau.
Vérifiez si votre objet Accord ou d’autres objets Acrobat Sign dans Salesforce ont des personnalisations telles que des déclencheurs, des workflows ou des règles.
Si c’est le cas, désactivez toutes les personnalisations et envoyez un accord de test selon la procédure habituelle pour voir s’il est transmis. Le statut doit passer de Brouillon à Émis pour signature.
Si le statut de l’accord passe à Émis pour signature après la désactivation des personnalisations, consultez notre Guide du développeur pour obtenir des instructions.
Si le statut n’est pas mis à jour, envoyez un accord de test directement à partir de l’onglet Accords avec les personnalisations désactivées et vérifiez s’il est transmis. Si le statut ne change toujours pas, vérifiez les étapes 1 et 2 mentionnées ci-dessus.
Annotation
nous ne proposons pas de support pour le dépannage des personnalisations.
| Objets Acrobat Sign | ||
|---|---|---|
| Ajouter des pièces jointes | Mappages de fichiers | Mapper les données dans les champs de l’accord |
| Ajouter les modèles de champs de formulaire | Importations de champs de formulaire | Mappages de fusion |
| Ajouter des destinataires | Mappage enfant des champs de formulaire | Mutex |
| Accords | Entrée de mappage enfant des champs de formulaire | Mappages d’objets |
| Evénements d’accord | Mappages de champs de formulaire | Destinataires |
| Modèles d’accord | Entrées de mappage des champs de formulaire | Accord signé |
| Mappages de données | Mappages de groupes | Déclencheurs |
| Mappages de champs | Modèles de bibliothèque | Résultats de synchronisation des utilisateurs |
| Type d’accord | ||
Les domaines améliorés de Salesforce sont désormais activés par défaut dans toutes les organisations, ce qui n’a aucune incidence sur le package Acrobat Sign pour Salesforce. Toutefois, les clients qui configuraient leurs sites pour le téléchargement de fichiers volumineux et les accords Push rencontrent des problèmes lorsque leurs domaines améliorés sont activés, ce qui entraîne une modification des URL du site et des accords rompus.
Pour garantir le bon fonctionnement des accords, les clients doivent mettre à jour les paramètres personnalisés pour les téléchargements de fichiers volumineux afin de refléter l’URL du site mise à jour.
Pour mettre à jour l’URL de rappel des accords Push, les clients doivent Contacter l’assistance technique et founir les informations requises. Pour en savoir plus, consultez la section Obtenir des services configurés individuels pour votre compte Acrobat Sign.
Acrobat Sign pour Salesforce vous permet de rechercher et d’ajouter des prospects en tant que destinataires de l’accord lorsque l’option Prospects est sélectionnée comme type de destinataire. Cependant, si les utilisateurs Government Cloud créent des prospects, des contacts ou des utilisateurs, mais ne parviennent pas à les trouver à l’aide du champ Rechercher, les administrateurs d’organisation Saleforce peuvent suivre ces étapes de résolution :
- Accédez à Configuration > Gestionnaire d’objets et recherchez ensuite Prospect.
- Dans le panneau de gauche, sélectionnez Champs et relations.
- Pour tous les champs requis (tels que Nom, E-mail, Mobile, etc.), vérifiez l’accessibilité pour les utilisateurs. Pour cela, procédez comme suit :
- Sélectionnez un champ que vous souhaitez vérifier. Par exemple, sélectionnez Mobile.
- Pour tous les utilisateurs pour lesquels vous souhaitez activer l’accès au champ, cochez la case Visible.
- Sélectionnez Enregistrer.
Si le problème n’est pas résolu, même après avoir suivi les étapes de dépannage ci-dessus, contactez l’assistance technique et fournissez-nous les informations suivantes :
- Description du problème
- Adresse électronique de l’administrateur du compte Acrobat Sign utilisé pour configurer l’intégration
- Adresse électronique de l’administrateur du compte Acrobat Sign utilisé pour activer les mises à jour du statut automatiques :
- Version du package Acrobat Sign installée dans Salesforce
- ID d’organisation Salesforce
- ID des enregistrements Salesforce pour les accords affectés
- Adresse électronique de l’utilisateur concerné
- Le problème est-il systématiquement reproductible, intermittent ou ponctuel ?
- Date de la dernière occurrence : <Indiquer les informations de date/heure/fuseau horaire de la dernière occurrence connue>
- Étapes à suivre pour reproduire le problème
- Comportement attendu : <Décrire le comportement attendu lorsque vous suivez les étapes>
- Notes de dépannage : <Fournir des informations sur le dépannage effectué jusqu’à présent à l’aide de cette documentation>
Simplifiez votre travail avec Acrobat Sign
Gérez et signez des documents en ligne rapidement et facilement.
