Accélérez votre processus de vente
Des livres blancs aux contrats et accords, de nombreux documents sont nécessaires tout au long d'un parcours d'achat. Dans ce tutoriel, découvrez comment Adobe Acrobat Services peut intégrer des expériences documentaires tout au long de ce parcours pour accélérer les ventes.
Générer des accords et des commandes client à partir de données
Les commandes ouvertes, les contrats et autres documents peuvent varier considérablement en fonction de critères spécifiques. Par exemple, un contrat de vente peut inclure uniquement certains termes basés sur des critères uniques, comme le fait d’être dans un pays ou un état spécifique ou d’inclure certains produits dans le cadre de l’accord. La création manuelle de ces documents ou la gestion de nombreuses variantes de modèle peuvent augmenter considérablement les coûts juridiques associés à la révision manuelle des modifications.
L'API Adobe Document Generation vous permet de prendre des données de votre système CRM ou d'un autre système de données pour générer dynamiquement des documents commerciaux en fonction de ces données.
Obtenir les informations d’identification
Commencez par vous inscrire pour obtenir des informations d’identification Adobe PDF Services gratuites :
-
Accédez ici pour enregistrer vos informations d'identification.
-
Connectez-vous à l’aide de votre Adobe ID.
-
Définissez votre nom d’identification (par exemple, Démonstration de commandes ouvertes).
-
Choisissez une langue pour télécharger votre exemple de code (par exemple, Node.js).
-
Vérifiez pour accepter les conditions du développeur.
-
Sélectionnez Créer des identifiants.
Un fichier est téléchargé sur votre ordinateur à l’aide d’un fichier ZIP contenant les fichiers d’exemple pdfservices-api-credentials.json et private.key pour l’authentification. -
Sélectionnez Obtenir le complément Microsoft Word ou accédez à AppSource pour l’installer.
note note NOTE Pour installer le complément Word, vous devez être autorisé à installer des compléments dans Microsoft 365. Si vous ne disposez pas des autorisations nécessaires, contactez votre administrateur Microsoft 365.
Vos données
Si vous extrayez des données d’un système de données spécifique, vous devez les exporter en tant que données JSON ou générer votre propre schéma. Ce scénario utilise l’ensemble de données d’exemple précréé suivant :
{
"salesOrder": {
"comment": "Make sure to call 555-555-1234 when you arrive. The front door is broken."
},
"company": {
"name":"Home Services Co.",
"address": {
"city": "Homestead",
"state": "NY",
"zip": "14623",
"streetAddress": "123 Demohome Street"
}
},
"customer": {
"address": {
"city": "Seattle",
"state": "WA",
"zip": "98052",
"streetAddress": "20341 Whitworth Institute 405 N. Whitworth"
},
"email": "mailto:jane-doe@xyz.edu",
"jobTitle": "Professor",
"name": "Jane Doe",
"telephone": "(425) 123-4567",
"url": "http://www.janedoe.com"
},
"tax": {
"state":"WA",
"rate": 0.08
},
"referencesOrder": [
{
"description": "Carpet Cleaning Service - 3BR 2BA",
"totalPaymentDue": {
"price": 359.54
},
"orderedItem": {
"description": "Carpet Cleaning Service"
}
},
{
"description": "Home Cleaning Service - 3BR 2BA",
"totalPaymentDue": {
"price": 299.99
},
"orderedItem": {
"description": "House Cleaning Service"
}
}
]
}
Ajout de balises de base à un document
Ce scénario utilise un document de bon de commande qui peut être téléchargé ici.
-
Ouvrez le document d'exemple SalesOrder.docx dans Microsoft Word.
-
Si votre module externe Document Generation est installé, sélectionnez Document Generation dans le ruban. Si vous ne voyez pas Génération de document dans votre ruban, suivez ces instructions.
-
Sélectionnez Commencer.
-
Copiez les données d'exemple JSON écrites ci-dessus dans le champ Données JSON.
Ensuite, accédez au panneau Balises de génération de document pour placer des balises dans le document.
-
Sélectionnez le texte à remplacer (par exemple, NOM DE L'ENTREPRISE).
-
Dans le panneau Balisage de génération de document, recherchez « name ».
-
Dans la liste des balises, sélectionnez le nom sous Société.
-
Sélectionnez Insérer du texte.
Ce processus place une balise appelée {{company.name}}, car la balise se trouve sous le chemin dans le fichier JSON.
code language-none { … "company": { "name":"Home Services Co.", … }, … }
Répétez ces actions pour certaines balises supplémentaires du document, telles que STREET ADDRESS, CITY, STATE, ZIP, etc.
Aperçu du document généré
Directement dans Microsoft Word, vous pouvez prévisualiser votre document généré en fonction des exemples de données JSON.
-
Dans le panneau Balise Document Generation, sélectionnez Générer le document. La première fois, vous serez peut-être invité à vous connecter avec votre Adobe ID. Sélectionnez Se connecter et remplissez les invites pour vous connecter avec vos informations d'identification.
-
Sélectionnez Afficher le document.
-
Une fenêtre de navigateur s’ouvre, vous permettant de prévisualiser les résultats du document.
Vous pouvez voir les balises du document qui ont été remplacées par les données des exemples de données d’origine.
Ajouter un tableau au modèle
Dans le scénario suivant, ajoutez une liste de produits à un tableau dans le document.
-
Insérez votre curseur à l’endroit où le tableau doit être placé.
-
Dans le panneau Balisage de génération de document, sélectionnez Avancé.
-
Développez Tableaux et listes.
-
Dans le champ Enregistrements de table, sélectionnez referencesOrder, qui est un tableau qui répertorie tous les éléments du produit.
-
Dans le champ Sélectionner les enregistrements de colonne, saisissez pour inclure le champ description et totalPaymentDue.price.
-
Sélectionnez Insérer un tableau.
Modifiez le tableau pour l’ajuster aux styles, tailles et autres paramètres comme tout autre tableau dans Microsoft Word.
Ajouter un calcul numérique
Les calculs numériques permettent de calculer des sommes et d'autres calculs à partir d'une collection de données, telle qu'une matrice. Dans ce scénario, ajoutez un champ pour calculer le sous-total.
- Sélectionnez $0.00 en regard du titre du sous-total.
- Dans le panneau Balise Document Generation, développez Calculs numériques.
- Sous Sélectionner le type de calcul, choisissez Agrégation.
- Sous Sélectionner le type, choisissez Somme.
- Sous Sélectionner des enregistrements, choisissez Ordre des références.
- Sous Sélectionner l'élément pour effectuer l'agrégation , choisissez totalPaymentsDue.price*.
- Sélectionnez Insérer un calcul.
Ce processus insère une balise de calcul qui fournit la somme des valeurs. Des calculs plus avancés peuvent être effectués à l’aide de calculs JSONata. Par exemple :
-
Sous-total :
${{expr($sum(referencesOrder.totalPaymentDue.price))}}
Calcule la somme de referencesOrder.totalPaymentDue.price. -
Taxe de vente :
${{expr($sum(referencesOrder.totalPaymentDue.price)*0.08)}}
Calcule le prix et multiplie par 8 % pour calculer la taxe. -
Total dû :
${{expr($sum(referencesOrder.totalPaymentDue.price)*1.08)}}
Calcule le prix et les multiples de 1,08 pour calculer le sous-total + la taxe.
Ajouter des conditions conditionnelles
Les sections conditionnelles vous permettent d’inclure une phrase ou un paragraphe uniquement lorsqu’une certaine condition est remplie. Dans ce scénario, seule une section est incluse si elle correspond à un certain état.
-
Dans le document, recherchez la section intitulée DÉCLARATIONS DE CONFIDENTIALITÉ EN CALIFORNIE.
-
Sélectionnez la section avec votre curseur.
-
Dans le Balisage de génération de document, sélectionnez Avancé.
-
Développez Contenu conditionnel.
-
Dans le champ Sélectionner des enregistrements, recherchez et sélectionnez customer.address.state.
-
Dans le champ Sélectionner l'opérateur, sélectionnez =.
-
Dans le champ Valeur, saisissez CA.
-
Sélectionnez Insérer une condition.
La section Californie apparaît uniquement dans le document généré si customer.address.state = CA.
Ensuite, sélectionnez la section pour DÉCLARATIONS DE CONFIDENTIALITÉ WASHINGTON et répétez les étapes ci-dessus, en remplaçant la valeur CA par WA.
Ajouter une image dynamique
L’API Document Generation vous permet d’insérer des images de manière dynamique à partir de données. Cette fonction est utile lorsque vous avez différentes sous-marques et que vous souhaitez modifier des logos, des portraits ou des images pour les rendre plus pertinents pour un secteur d’activité donné.
Les images peuvent être transmises par une URL dans les données ou le contenu base64. Cet exemple utilise une URL.
-
Placez le curseur à l’endroit où vous souhaitez inclure une image.
-
Dans le panneau Balisage de génération de document, sélectionnez Avancé.
-
Développez Images.
-
Dans le champ Sélectionner des balises, choisissez logo.
-
Dans le champ Texte de remplacement facultatif, fournissez une description (c'est-à-dire un logo). Ce processus insère un espace réservé pour l’image qui se présente comme suit :
Cependant, vous souhaitez définir l’image de manière dynamique sur une image qui se trouve déjà dans la mise en page, ce qui peut être fait comme suit :
-
Cliquez avec le bouton droit de la souris sur l’image d’espace réservé insérée.
-
Sélectionnez Modifier le texte alternatif.
-
Dans le panneau, copiez le texte comme suit :
{ "location-path": "logo", "image-props": { "alt-text": "Logo" }}
-
Sélectionnez dans le document une autre image à rendre dynamique.
-
Cliquez avec le bouton droit sur l'image et sélectionnez Modifier le texte de remplacement.
-
Collez la valeur dans le panneau.
Ce processus remplace l’image par une image qui se trouve dans la variable de logo dans les données.
Ajout de balises pour Acrobat Sign
Adobe Acrobat Sign vous permet de capturer des signatures électroniques sur vos documents. Acrobat Sign offre un moyen simple de faire glisser et déposer des champs dans l’interface web. Vous pouvez également contrôler le placement des champs de signature et autres à l’aide d’une balise de texte. Grâce à la balise Adobe Document Generation, vous pouvez facilement placer ces champs de balise de texte.
- Accédez à l’emplacement où une signature est requise dans le document type.
- Insérez votre curseur à l’endroit où la signature est nécessaire.
- Dans le panneau Adobe Document Generation Tagger, sélectionnez Adobe Sign.
- Dans le champ Spécifier le nombre de destinataires, définissez le nombre de destinataires (dans cet exemple, il s'agit d'un destinataire).
- Dans le champ Destinataires, sélectionnez Signataire-1.
- Dans le type Champ, sélectionnez Signature.
- Sélectionnez Insérer une balise de texte Adobe Sign.
Une balise est insérée dans le document.
Acrobat Sign propose plusieurs autres types de champs que vous pouvez placer, tels que les champs de date.
- Dans le type Champ, sélectionnez Date.
- Déplacez le curseur sur l’emplacement Date dans le document.
- Sélectionnez Insérer une balise de texte Adobe Sign.
Génération de votre accord
Vous avez balisé votre document et êtes prêt à commencer. Cette section explique comment générer un document à l’aide des exemples d’API Document Generation pour Node.js, mais ceux-ci fonctionneront dans toutes les langues.
Ouvrez le fichier pdfservices-node-sdk-samples-master qui a été téléchargé lors de l’enregistrement de vos informations d’identification. Les fichiers pdfservices-api-credentials.json et private.key doivent être inclus dans ces fichiers.
- Ouvrez un Terminal pour installer des dépendances à l’aide de l’installation npm.
- Copiez le fichier d’exemple data.json dans le dossier resources.
- Copiez le modèle Word dans le dossier des ressources.
- Créez un nouveau fichier dans le répertoire racine du dossier d’exemples appelé generate-salesOrder.js.
const PDFServicesSdk = require('@adobe/pdfservices-node-sdk');
const fs = require('fs');
const path = require('path');
var dataFileName = path.join('resources', '<INSERT JSON FILE');
var outputFileName = path.join('output', 'salesOrder_'+Date.now()+".pdf");
var inputFileName = path.join('resources', '<INSERT DOCX>');
//Loads credentials from the file that you created.
const credentials = PDFServicesSdk.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("pdfservices-api-credentials.json")
.build();
// Setup input data for the document merge process
const jsonString = fs.readFileSync(dataFileName),
jsonDataForMerge = JSON.parse(jsonString);
// Create an ExecutionContext using credentials
const executionContext = PDFServicesSdk.ExecutionContext.create(credentials);
// Create a new DocumentMerge options instance
const documentMerge = PDFServicesSdk.DocumentMerge,
documentMergeOptions = documentMerge.options,
options = new documentMergeOptions.DocumentMergeOptions(jsonDataForMerge, documentMergeOptions.OutputFormat.PDF);
// Create a new operation instance using the options instance
const documentMergeOperation = documentMerge.Operation.createNew(options)
// Set operation input document template from a source file.
const input = PDFServicesSdk.FileRef.createFromLocalFile(inputFileName);
documentMergeOperation.setInput(input);
// Execute the operation and Save the result to the specified location.
documentMergeOperation.execute(executionContext)
.then(result => result.saveAsFile(outputFileName))
.catch(err => {
if(err instanceof PDFServicesSdk.Error.ServiceApiError
|| err instanceof PDFServicesSdk.Error.ServiceUsageError) {
console.log('Exception encountered while executing operation', err);
} else {
console.log('Exception encountered while executing operation', err);
}
});
- Remplacez
<INSERT JSON FILE>
par le nom du fichier JSON dans /resources. - Remplacez
<INSERT DOCX>
par le nom du fichier DOCX. - Pour l’exécuter, utilisez le Terminal pour exécuter le nœud generate-salesOrder.js.
Le fichier de sortie doit se trouver dans le dossier /output avec le document généré correctement.
Autres options
Une fois votre document généré, vous pouvez effectuer des actions supplémentaires, telles que :
- Protection par mot de passe d’un document
- Compresser le PDF s’il y a de grandes images
- Capture de signatures électroniques sur le document
Pour en savoir plus sur certaines des autres actions disponibles, consultez les scripts du dossier /src dans les fichiers d’exemple. Vous pouvez également en savoir plus en consultant la documentation des différentes actions.
Cas d’utilisation supplémentaires
Adobe Acrobat Services peut aider à rationaliser de nombreuses parties d'un cycle de vente grâce aux workflows de documents numériques :
- Utilisez l’API Adobe PDF Embed pour intégrer des livres blancs et d’autres contenus sur les sites web, tout en mesurant et en collectant des analyses sur l’audience
- Utilisation d’Acrobat Sign pour capturer des signatures électroniques sur vos accords générés
- Extraction des données d’accord de vos documents de PDF à l’aide de l’API Adobe PDF Extract
Formation continue
Vous souhaitez en savoir plus ? Jetez un œil à quelques autres façons d'utiliser Adobe Acrobat Services :
- En savoir plus sur la documentation
- Voir d’autres tutoriels sur Adobe Experience League
- Utilisez les exemples de scripts du dossier /src pour voir comment tirer parti de PDF
- Suivez le Blog sur les technologies d'Adobe pour obtenir les derniers conseils et astuces
- Abonnez-vous à Paper Clips (diffusion mensuelle en direct) pour en savoir plus sur l'automatisation à l'aide de Adobe Acrobat Services.
======= - En savoir plus sur la documentation
- Voir d’autres tutoriels sur Adobe Experience League
- Utilisez les exemples de scripts du dossier /src pour voir comment tirer parti de PDF
- Suivez le Blog sur les technologies d'Adobe pour obtenir les derniers conseils et astuces
- Abonnez-vous à Paper Clips (diffusion mensuelle en direct) pour en savoir plus sur l'automatisation à l'aide de Adobe Acrobat Services