Adobe Sign pour Salesforce : flux automatisés avec le générateur de processus

Le Générateur de processus de Salesforce est un outil graphique de point-and-click qui permet d’automatiser des actions basées sur le déclenchement d’événements dans votre environnement Salesforce.

Les processus sont conçus autour d’un type if/then de flux logique et contiennent un événement de déclencheur, au moins une condition et au moins une action qui peut se produire en temps réel, et/ou comme un événement planifié.

Adobe Sign prend en charge deux types d’actions : Mise à jour des enregistrements et Apex

Chaque type d’action possède plusieurs actions pouvant être appelées :

• Send
• Cancel
• Delete
• Remind
• Update
• Le chargement (modèle) est uniquement disponible lorsque vous utilisez le type d’action Apex.

Le gestionnaire de processus est un outil très puissant et la description détaillée de son fonctionnement n’est pas traitée dans ce document.

Ce document décrit les actions disponibles via la v20 d’Adobe Sign pour le package Salesforce.

Si vous souhaitez en savoir plus sur le gestionnaire de processus en général, il existe une documentation et un Trailhead interactif fournis par Salesforce.

Processus qui utilisent « Mise à jour d’enregistrements » comme type d’action

Cette méthode utilise le type d’action Mise à jour d’enregistrement dans le gestionnaire de processus Salesforce pour définir le champ de la liste déroulante d’action d’arrière-plan sur l’enregistrement d’accord pour appeler une action.

Un processus peut être créé (en fonction des événements de modification d’enregistrement) et peut ensuite appeler une action sur un accord relative à Adobe Sign. Les utilisateurs peuvent contrôler à quel moment l’action se produira (c’est-à-dire après quelle mise à jour de champ dans l’enregistrement principal) et quels accords associés sont sélectionnés pour l’action.

Actuellement, les actions suivantes sont prises en charge :

• Send
• Cancel
• Delete
• Remind
• Update

Points à connaître :

• Toute erreur détectée lors du processus sera stockée dans le champ Message d’erreur et peut être affichée sur la page Accord correspondante.
• Les actions planifiées sont prises en charge.
• Les documents de bibliothèque Adobe Sign sont pris en charge.
• Un ou plusieurs accords parent et enfant peuvent être sélectionnés.
• Lors de la mise à jour d’un enregistrement d’accord, l’enregistrement associé est l’objet echosign_dev1.
  • L’objet echosign_dev1 est associé aux objets communs Salesforce (Compte, Opportunité, Contact, etc.). Si les Accords sont liés à un objet personnalisé, ce nom est propre à l’organisation.

• Les actions sont déclenchées en mettant à jour le champ de liste déroulante Action d’arrière-plan sur l’enregistrement d’accord avec la valeur correspondante.

• L’enregistrement d’accord doit déjà exister. Il ne peut pas être créé ou chargé à partir d’un modèle d’accord à l’aide d’un type d’action « Mise à jour d’enregistrements ».

Processus qui utilisent Apex comme type d’action

Cette méthode utilise le type d’action Apex dans Process Builder pour appeler une Méthode appelable fournie avec le package géré pour effectuer l’action correspondante. 

Un processus peut être créé (en fonction des événements de modification d’enregistrement) et peut ensuite appeler une action sur un accord relative à Adobe Sign.

Les actions appelables suivantes ont été définies :

• Action appelable de chargement du modèle d’accord
  • AgreementTemplateLoadInvocableAction.load
    • Transmette l’ID principal et du modèle et toutes les variables d’exécution.
    • Envoyer un paramètre facultatif permettant de contrôler si la génération de modèle fonctionne en mode asynchrone.
      • Obligatoire si le modèle contient un document à partir de la bibliothèque Adobe Sign.
    • Renvoyer l’ID d’enregistrement d’accord généré ou tout message d’erreur.
      • L’erreur ne sera pas visible par les utilisateurs exécutant l’action de déclenchement.

En appelant la classe Charger le type d’accord, vous pouvez configurer quatre options de champ :

• ID d’enregistrement principal : l’ID d’enregistrement Salesforce de l’objet auquel l’accord doit être associé. 
  • Habituellement défini sur le type Référence de champ et la valeur « [Object].Id » où l’objet est Opportunité, Compte, etc.
• ID de modèle d’accord : l’ID d’enregistrement Salesforce du modèle d’accord à charger. Définir le type « ID » et la valeur associée à l’ID d’enregistrement
• Variables d’exécution du modèle d’accord : destinataires et/ou documents à partir d’une variable. 
  • Une variable : myRecipient=auserguy@adobe.com 
  • Deux variables : myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
• Traitement asynchrone : facultatif, ne pas spécifier sauf si nécessaire. Par défaut, la valeur sera false, l’appel de modèle fonctionnera donc en mode sync (c’est-à-dire la même transaction/le même thread) 
  • Définissez la valeur sur True si votre modèle d’accord charge un document de bibliothèque Adobe Sign.
  • Assurez-vous que la valeur est False si AutoSend est défini sur True pour le modèle.
  • Vous ne pouvez avoir AutoSend et les documents de bibliothèque Adobe Sign en même temps.
  • Tenez compte des limites de Salesforce intégrées si le processus est appelé d’un lot ou de tout autre processus asynchrone.

• Action appelable d’annulation d’accord
  • AgreementCancelInvocableAction.cancelAgreement
    • Transmettre l’ID d’accord
    • Renvoyer tout message d’erreur

• Action appelable de suppression d’accord
  
  • AgreementDeleteInvocableAction.deleteAgreement
    • Transmettre l’ID d’accord
    • Renvoyer tout message d’erreur

• Action appelable de rappel d’accord
  • AgreementRemindInvocableAction.sendReminder
    • Transmettre l’ID d’accord
    • Renvoyer tout message d’erreur

• Action appelable d’envoi d’accord
  
  • AgreementSendInvocableAction.sendAgreement
    • Transmettre l’ID d’accord
    • Renvoyer tout message d’erreur

• Action appelable de mise à jour d’accord
  
  • AgreementUpdateInvocableAction.updateAgreement
    • Transmettre l’ID d’accord
    • Renvoyer tout message d’erreur

Les actions Annuler, Supprimer, Rappel, Envoyer, et Mettre à jour nécessitent uniquement l’ID d’accord de l’accord qui va entrer en vigueur :

Points à connaître :

• Les actions planifiées sont prises en charge.
• Les modèles d’accord avec AutoSend sont pris en charge (par exemple, générer et envoyer).
• Toutes les actions peuvent accepter plusieurs requêtes dans un appel.
• Toutes les exceptions sont inscrites et stockées sur l’enregistrement de résultats et consignées comme erreur dans le journal de débogage Apex afin d’éviter le blocage de l’exécution du processus.
• Le paramètre de la fonction Chargement du modèle (Traitement asynchrone) indique si le traitement de modèle se produit en mode synchrone ou asynchrone. L’appelant doit spécifier si le chargement de modèle doit s’exécuter en mode synchrone ou asynchrone. 
  • Le processus par défaut s’exécute en mode synchrone. L’ensemble des processus doit s’exécuter en mode synchrone.
  • Si AutoSend est activé, le processus doit être en mode synchrone.
  • Le processus devrait être asynchrone si vous deviez charger un document de bibliothèque Adobe Sign.

Limites :

• L’association de modèles AutoSend et de documents de bibliothèque Adobe Sign n’est pas prise en charge en raison d’une limitation dans Salesforce où un thread ne peut pas lancer un autre thread
  .
• Pour tous les paramètres transmis à l’action appelable, seuls les champs parent (aucun champ enfant) peuvent être référencés. Vous ne pouvez réaliser d’actions sur des accords enfant sous un enregistrement principal.
• Les valeurs renvoyées d’un appel Apex ne peuvent pas être utilisées dans un concepteur de processus. Aucune action qui renvoie une valeur n’est prise en charge (c’est-à-dire, obtenir les informations sur le document ou obtenir l’URL de signature).

Services pouvant être mis en attente

Un nouveau calque de service a été mis en œuvre pour appeler les actions d’accord via l’interface de mise en attente Salesforce. D’autres informations utiles sur la mise en attente sont disponibles ici. Les actions appellent les API de service de base qui appellent ensuite l’API Adobe Sign. 

Les actions suivantes sont prises en charge :

• Send
• Cancel
• Delete
• Remind
• Update

L’élément echosign_dev1.AdobeSignApiQueueableService est la classe Apex de service qui prend en compte un paramètre de type echosign_dev1.QueueableServiceParameter, contenant l’action à appeler et l’ID d’enregistrement d’accord :