Last modified: 2022-10-28

Mise à jour des champs de manière programmée

Après la création d'une convention OneSpan Sign, les utilisateurs qui créent des transactions manuellement peuvent utiliser la convention pour automatiser certaines tâches. Au lieu de devoir effectuer ces tâches manuellement, leur exécution automatique permet aux utilisateurs de gagner du temps.

Plus précisément, les utilisateurs peuvent exécuter des programmes pour automatiquement : 

  • Positionner les champs OneSpan Sign dans plusieurs documents pour plusieurs destinataires via les balises de texte
  • Mettre à jour les champs OneSpan Sign avec les données Salesforce via les mappages de champs (la fonction d'insertion)
  • Mettre à jour les champs Salesforce avec les données OneSpan Sign par le biais de Mappages de champs (la fonction Réécriture)

Les sections suivantes décrivent comment faire ces choses :

Mise à jour des champs de OneSpan Sign

La fonction d'insertion copie la valeur d'un champ de Salesforce (par exemple, le prénom) dans un champ correspondant d'un document OneSpan Sign lors de la préparation d'une transaction. Ces données peuvent ensuite être extraites du document signé. Les données en question peuvent être soit des données sur un destinataire, soit des données sur un objet lié à Salesforce.

Utiliser un programme pour insérer automatiquement des données de la base de données Salesforce dans un champ de saisie OneSpan Sign d'un document :

  1. Écrivez un code qui : (a) créera la transaction; (b) joindra à la transaction une convention appropriée, des documents appropriés, des destinataires appropriés, etc.
  2. Si votre convention contient des balises de texte, les champs seront automatiquement créés et positionnés à l'intérieur des documents OneSpan Sign.

  3. Ajoutez à ce code le paramètre URL suivant : « Insert=1 » OU « Insert=true ». Votre code devrait ressembler à l'exemple suivant :
  4. /apex/esl__package?ParentId={!Account.Id}&Name={!Account.Name}%20Agreement&
    			Documents=00P36000000wwrd&ConventionId=a0836000000nfRo&
    		Signer1=00336000003gBYX&Signer1Label=a0K36000001j8V&Insert=1

Ici :

  • Signer1Label est le SalesforceId de l'étiquette de destinataire à appliquer à Signer1.
  • L'adresse ConventionId est le SalesforceId de la convention à utiliser.
  1. Créez un bouton personnalisé qui exécutera ce code. Une fois que vous avez cliqué sur ce bouton, vous devriez voir toutes les données insérées dans Salesforce dans la transaction créée.

Mise à jour des champs Salesforce(réécriture)

La fonction de réécriture d'un mappage de champs permet de mettre automatiquement à jour les données des champs Salesforce à partir des documents OneSpan Sign.

Par exemple, supposons que : (1) un destinataire s'aperçoit au cours de l'Expérience du signataire que son adresse est erronée dans un document de transaction OneSpan Sign; (2) le destinataire corrige son adresse dans ce document.

Si cette adresse OneSpan Sign est mise en correspondance avec un champ d'un objet connexe Salesforce, et que l'option Réécriture a été cochée pour cette mise en correspondance, lorsque la transaction OneSpan Sign est terminée, l'adresse mise à jour sera écrite dans le champ Salesforce.

Les données à réécrire dans Salesforce doivent être saisies lors de l'opération Expérience du signataire.

Utiliser un programme pour mettre à jour un champ Salesforce avec les données d'un document OneSpan Sign lorsque la transaction associée est terminée :

  1. Écrivez le code qui : (a) créera la transaction; (b) joindra à la transaction une convention appropriée, des documents appropriés, des destinataires appropriés, etc.
  2. Si votre convention contient des balises de texte, les champs seront automatiquement créés et positionnés à l'intérieur des documents OneSpan Sign.

  3. Ajoutez à ce code le paramètre URL suivant : « Writeback=1 » OU « Writeback=true ». Votre code devrait ressembler à l'exemple suivant :

/apex/esl__package?ParentId={!Account.Id}&Name={!Account.Name}%20Agreement&

Documents=00P36000000wwrd&ConventionId=a0836000000nfRo&

Signer1=00336000003gBYX&Signer1Label=a0K36000001j8V&Writeback=1

Ici :

  • Signer1Label est le SalesforceID de l'étiquette de destinataire à appliquer à Signer1.
  • L'adresse ConventionId est le SalesforceID de la convention à utiliser.
  1. Créez un bouton personnalisé qui exécutera ce code. Une fois que vous aurez cliqué sur ce bouton, une fois la transaction OneSpan Sign terminée, les données mises à jour au cours de la transaction Expérience du signataire devraient apparaître dans le champ Salesforce associé.
Was this information helpful?
X