Plus tôt ce mois-ci, l’équipe Adobe Document Services a publié une mise à jour de notre API de services PDF qui se concentre spécifiquement sur notre API de génération de documents. Dans cet article, nous passerons rapidement en revue ces nouvelles fonctionnalités et comment elles peuvent améliorer les flux de travail de génération de documents. Nous approfondirons également ces nouvelles fonctionnalités et en discuterons également dans les futures diffusions en direct.
Notes de version
Avant de plonger, les dernières notes de version couvrent les deux étapes de migration (si nécessaire, la version d’aujourd’hui ne ne pas), des liens vers des versions historiques des documents, ainsi qu’un historique détaillé des modifications. Bien que nous ne parlions pas de l’API PDF Embed aujourd’hui, ce service possède également sa propre page de notes de version.
Prise en charge des images SVG
L’API de génération de documents prend en charge les images dynamiques via la conversion base64 pour les fichiers JPEG, PNG, GIF, BMP et TIFF. La version d’aujourd’hui ajoute la prise en charge de SVG. SVG peut être beaucoup plus petit que les formats d’image comparables, fournit des images vectorielles plus nettes et peut accélérer l’utilisation de votre API et réduire la taille des documents.
Notez que vos données SVG doivent toujours être encodées en base64 avant d’utiliser l’API. En dehors de cela, vous aurez la possibilité de dimensionner l’image dans votre document ainsi que de fournir du texte alternatif. Voir la partie Images de la documentation pour plus d’informations.
Tableaux horizontaux
Il s’agit d’une excellente nouvelle fonctionnalité qui, honnêtement, peut ne pas avoir de sens tant que vous ne la voyez pas en action. Heureusement, nos docs ont de superbes images que je peux « emprunter ». Avant la publication d’aujourd’hui, nous prenions en charge les tableaux dont les lignes se répétaient en fonction de vos données. Considérez l’image ci-dessous :
Nous appelons cela un tableau à expansion verticale, car à mesure que vous ajoutez plus de lignes de données, le tableau de votre document généré grandira. Un tableau à expansion horizontale se développe cependant vers la droite :
Pour prendre en charge cette nouvelle fonctionnalité, nous avons ajouté une prise en charge au sein de vos jetons pour définir la direction de l’expansion. Dans un tableau vertical (par défaut), votre tableau peut ressembler à ceci :
Vous pouvez maintenant spécifier explicitement une direction verticale en ajoutant :cell-extension(vertical) à votre table.
Inversement, une table à expansion horizontale utiliserait :cell-extension(horizontal):
Cette nouvelle fonctionnalité facilite le passage à un style de tableau plus adapté à vos données. Ainsi, par exemple, les tableaux de comparaison sont généralement bien meilleurs au format horizontal.
Notez que la génération de documents peut parfois être un peu difficile avec l’espacement. Lorsque vous modifiez manuellement des balises dans votre document, n’incluez pas d’espaces entre vos expressions et les crochets.
Prise en charge HTML dans les données
La plus grande nouveauté de cette version est la prise en charge de la fourniture d’informations de style dans vos données. Il s’agit d’une version initiale et nous prévoyons d’offrir plus de support pour le HTML et le style au fil du temps, mais avant d’entrer dans les détails de ce qui est supporté, que diriez-vous d’un exemple ?
Tenez compte des éléments suivants dans un document Word :
Si vous souhaitez styliser la valeur du nom, vous pouvez appliquer les styles Word comme bon vous semble. Mais que faire si vous vouliez appliquer un style à un portion des données ? Ainsi, par exemple, étant donné le nom de « Raymond Camden », vous souhaitez mettre en gras uniquement le nom de famille. Avec la mise à jour d’aujourd’hui, c’est désormais possible. Voici à quoi cela ressemblerait dans vos données :
{
"name":"Raymond <b>Camden</b>"
}
Lors de l’exécution de Document Generation, le style gras ne sera appliqué qu’au nom de famille. Bien que cela puisse évidemment être fait d’autres manières (en divisant le nom et en utilisant plusieurs jetons dans votre modèle Word), cette nouvelle prise en charge simplifiera l’application d’un style personnalisé et complexe.
Actuellement, vous pouvez utiliser les parties suivantes de la spécification HTML :
- Les
<span>,<br>,<b>,<i>, et<u>Mots clés. - Les
<a>balise pour créer des liens. Cela peut être particulièrement utile pour créer des liens personnalisés à des fins de suivi. - Stylisation en ligne du formulaire,
<span style="....">. Les styles en ligne pris en charge incluentfont-weight: bold,font-style: italic,text-decoration: underline,color, etfont-weightavec le soutien depttailles.
Essayez ceci maintenant
La meilleure chose à propos des mises à jour de Document Generation est que vous pouvez tester cela dès maintenant sans écrire une seule ligne de code. Vous pouvez soit vous diriger vers le terrain de jeu de l’API de génération de documents, soit simplement utiliser le complément Word pour tester dans votre propre client Microsoft Word.