Travailler avec des applications dynamiques de création de documents

En tirant parti de la fonctionnalité Préparation automatique de OneSpan Sign, diverses applications tierces peuvent créer et distribuer automatiquement des documents sophistiqués après avoir rempli leurs modèles riches de données Salesforce.

Ces données peuvent provenir soit d'objets standard ou personnalisés de Salesforce, soit de sources de données externes via Lightning Connect.

Conga Composer

Conga Composer est l'une des applications tierces mentionnées ci-dessus. Il importe les données de Salesforce au moyen d'un bouton personnalisé Salesforce.

La procédure ci-dessous décrit comment intégrer Conga à OneSpan Sign Embedded Integration for Salesforce afin de créer exactement un tel bouton personnalisé dans un objet contact Salesforce.

Quand un utilisateur final clique sur ce bouton :

1. Un document sera créé avec Conga.
2. Ce document sera joint à l'enregistrement correspondant sur Salesforce.
3. Un paquet OneSpan Sign sera créé, et le document y sera attaché.
4. Des blocs de signature pour deux destinataires seront créés dans le document (via une convention et des étiquettes de destinataire appropriées).
5. La transaction sera envoyée.

Pour obtenir plus d'informations, voir Création de transactions par voie programmatique OneSpan Sign.

Pour créer un bouton personnalisé qui peut interagir avec Conga :

1. Allez à Configuration > Configuration de l'application > Créer > Objets.
2. Sélectionnez l'objet Transaction OneSpan Sign.
3. Dans la section Boutons, liens et actions de la page Objet transaction OneSpan Sign, cliquez sur Nouveau bouton ou lien.
4. Choisissez un type d'affichage pour le bouton que vous voulez créer. Il existe trois types possibles :
• Lien de page - Crée un lien que vous pouvez ajouter à la section des liens de toute page de détails. Les liens peuvent afficher d'autres pages ou sites Web.
• Bouton de page - Crée un bouton que vous pouvez ajouter à l'en-tête de toute page de détails. Les boutons de la page de détail agissent sur l'enregistrement que l'utilisateur est en train de consulter.
• Bouton de liste - Crée un bouton que vous pouvez ajouter à l'en-tête de toute vue de liste ou liste connexe. Les boutons de liste permettent aux utilisateurs de sélectionner plusieurs éléments dans une liste et d'agir sur tous ces éléments à la fois.

Pour ajouter des boutons de liste à une liste liée, modifiez ses propriétés dans la mise en page où apparaît la liste liée d'une transaction OneSpan Sign.

5. Sélectionnez le comportement : Exécutez JavaScript et la source du contenu : OnClick JavaScript.
6. Écrivez et exécutez une variante de l'exemple de code JavaScript suivant. Pour que le code fonctionne, vous devez remplacer ses caractères de remplacement par les paramètres Id de Salesforce.

{!REQUIRESCRIPT("/soap/ajax/30.0/connection.js")}
	var ParentObjectId = '{!Contact.Id}';
	var TransactionName = '{!Contact.Name} CongaPOC';
	var RecipientId = '{!Contact.Id}';
	var Send = true;
	var congaParameters =
	"SessionId={!API.Session_ID}&ServerUrl={!API.Partner_Server_URL_210}
	&Id={!Contact.Id}&TemplateId=00P11000002ImxI&ds7=5&defaultPDF=1&OCNR=1";
	//Change popup visual here
	var popup = 
	window.open("https://composer.congamerge.com?" + congaParameters, 
	'Conga','menubar=no,scrollbars=no,top=100,left=100,width=300,height=200');
	//Do not modify below this line
	var timer = setInterval(function() {
	if(popup.closed) {
	clearInterval(timer);
	var attach = 
	sforce.connection.query("select id from attachment where ParentId ='" 
	+ ParentObjectId+"' order by createddate desc limit 1");
	if(attach.records != null) {
	var packageParameters = 
	'ParentId='+ParentObjectId
	+ '&Name='+TransactionName+'&Documents=' + attach.records.Id
	+ '&Signer1=' + RecipientId + '&Signer2=' + '0031100000eKoFW'
	+ '&ConventionId=a0711000003AGvj'
	+ '&Signer1Label=a0L110000035S7k'
	+ '&retURL={!URLENCODE(Contact.Id)}';
	if(Send) {
	packageParameters += '&Send=1';
	}
	window.location = '/apex/esl__package?' + packageParameters;
	}	
	else {
	window.reload();
	}
	}
}, 500);

La procédure ci-dessus permet de créer un puissant bouton personnalisé dans Salesforce. En cliquant dessus, l'utilisateur final déclenche la séquence d'événements suivante :

Pour vérifier la procédure ci-dessus, certifiez que le document créé par Conga se trouve dans la transaction créée. Si les données insérées sur Salesforce n'apparaissent pas dans ce document, la responsabilité en incombe à Conga.