Fonctions uImage

Les fonctions uImage vous permettent de créer des images et des illustrations personnalisées de manière dynamique lors de la composition. Ces fonctions exploitent des modèles Adobe Photoshop et Illustrator pour générer des visuels personnalisés basés sur les données des destinataires, permettant ainsi une personnalisation d'image sophistiquée comme des maquettes de produits personnalisées, des certificats sur mesure, des cartes dynamiques et des visuels promotionnels individualisés.

Ressources supplémentaires : Pour des informations complètes sur la définition et la génération d'images personnalisées, y compris la préparation des modèles et la configuration dans uPlan, consultez l'aide en ligne uImage. Des tutoriels vidéo sont également disponibles sur campus.xmpie.com.

Fonction uImage.uImage

La fonction uImage.uImage crée des images personnalisées à partir d'un paquet de documents Photoshop (.dpkg). Cette fonction traite le document Photoshop spécialement préparé contenu dans le paquet, générant une image unique pour chaque destinataire en fonction de ses données.

Cette fonction retourne un actif Image pouvant être utilisé dans des ADOR d'image.

Syntaxe

uImage.uImage(packageName, outputFolder, outputFilename, outputType, tagName, tagValue [, ...])

Paramètre	Description
packageName	Requis. Le nom du paquet de documents Photoshop (.dpkg) à utiliser comme modèle.
outputFolder	Requis. Dossier de sortie. Laisser vide ("") pour le dossier de sortie par défaut.
outputFilename	Requis. Nom du fichier de sortie. Laisser vide ("") pour un nommage automatique. Préfixer avec "OPT:" pour une optimisation évitant de créer des images déjà générées. (Par exemple, lorsqu'une image avec les mêmes tagValues a déjà été traitée.)
outputType	Requis. Format de sortie. (L'un des suivants : "JPG", "EPS", "PSD" ou "PNG".) Des paramètres supplémentaires dépendant du format sont également disponibles.
tagName	Requis. Nom d'une balise uImage ou d'un espace réservé dans le fichier Photoshop.
tagValue	Requis. Valeur à placer dans la balise uImage Photoshop. Dans la plupart des cas, il s'agit de l'objet de contenu ou de la variable contenant le prénom du destinataire, le nom de l'entreprise ou d'autres données à utiliser dans Photoshop.
Paires tagName et tagValue supplémentaires	Facultatif. Des paires nom/valeur supplémentaires peuvent être ajoutées si le modèle Photoshop contient plusieurs balises uImage.

Exemples

Créer des certificats personnalisés avec le nom du destinataire :

uImage.uImage("Certificate.dpkg", "", "", "JPG", "FullName", |->[FullName])

Résultat : génère des images de certificat personnalisées en utilisant le nom complet du destinataire dans le calque de texte désigné. Enregistré dans le dossier de sortie par défaut et nommé automatiquement.
Créer des images de maquette de produit :

uImage.uImage("ProductMockup.dpkg", "", "OPT:" & |->[Product Name], "JPG", "product_code", |->[Product Code])

Résultat : images de maquette de produit personnalisées. Enregistré sous le nom du produit dans le dossier de sortie par défaut, en évitant les noms de produits en double.
Créer des images personnalisées avec plusieurs points de données :

uImage.uImage("IDCard.dpkg", "", "", "PNG", "Name", |->[EmployeeName], "Department", |->[Department], "Photo", |->[PhotoFile])

Résultat : génère des images de carte d'identité avec le nom, le département et la photo de l'employé.

Remarque : Le paquet de documents Photoshop doit être correctement configuré dans uPlan avec des calques variables définis avant de pouvoir être utilisé avec cette fonction. Consultez l'aide en ligne uImage pour les instructions de préparation des modèles.

Fonction uImage.CreateImage2

La fonction uImage.CreateImage2 crée des images personnalisées à partir d'un modèle Photoshop. Il s'agit d'une fonction historique conservée pour compatibilité ascendante, permettant la génération d'images personnalisées directement à partir d'un fichier Photoshop (.psd).

Cette fonction retourne un actif Image pouvant être utilisé dans des ADOR d'image.

Remarque : Il est recommandé d'utiliser un paquet de documents Photoshop et la fonction uImage.Image plutôt qu'un fichier Photoshop directement. Le paquet de documents Photoshop inclut le fichier Photoshop ainsi que les polices, actions et autres informations nécessaires pour assurer une production fluide et éviter les erreurs liées à des composants manquants.

Syntaxe

uImage.CreateImage2(templateName, outputFolder, outputName, outputType, openingAction, closingAction, copyFittingMode, copyFittingMethod, tagName, tagValue [, ...])

Paramètre	Description
templateName	Requis. Le nom du fichier Photoshop à utiliser pour la génération d'images.
outputFolder	Requis. Dossier de sortie. Laisser vide ("") pour le dossier de sortie par défaut.
outputFilename	Requis. Nom du fichier de sortie. Laisser vide ("") pour un nommage automatique. Préfixer avec "OPT:" pour une optimisation évitant de créer des images déjà générées. (Par exemple, lorsqu'une image avec les mêmes tagValues a déjà été traitée.)
outputType	Requis. Format de sortie. (L'un des suivants : "JPG", "EPS", "PSD" ou "PNG".) Des paramètres supplémentaires dépendant du format sont également disponibles.
openingAction	Requis. Nom d'une action ou d'un script à utiliser lorsque le fichier Photoshop est ouvert et avant l'ajout des valeurs de balises. (Utilisez "NO" pour aucune action, "ACN=folder\\action" pour une action, ou "SCR=C:\\folder\\script.js" pour un script.)
closingAction	Requis. Nom d'une action ou d'un script à utiliser après l'ajout des valeurs de balises et avant la fermeture du fichier Photoshop. (Utilisez "NO" pour aucune action, "ACN=folder\\action" pour une action, ou "SCR=C:\\folder\\script.js" pour un script.)
copyFittingMode	Requis. Mode d'ajustement. "OFF" = aucun, "OF" = débordement, "UF" = soupassement, "B" = débordement et soupassement.
copyFittingMethod	Requis. Méthode d'ajustement. "HS" = mise à l'échelle horizontale, "FS" = mise à l'échelle de la police.
tagName	Requis. Nom d'une balise uImage ou d'un espace réservé dans le fichier Photoshop.
tagValue	Requis. Valeur à placer dans la balise uImage Photoshop. Dans la plupart des cas, il s'agit de l'objet de contenu ou de la variable contenant le prénom du destinataire, le nom de l'entreprise ou d'autres données à utiliser dans Photoshop.
Paires tagName et tagValue supplémentaires	Facultatif. Des paires nom/valeur supplémentaires peuvent être ajoutées si le modèle Photoshop contient plusieurs balises uImage.

Exemples

Créer une image promotionnelle personnalisée :

uImage.CreateImage2("PromoTemplate.psd", "", "", "JPG", "NO", "NO", "OF", "HS", "firstname", |->[FirstName])

Résultat : un visuel promotionnel personnalisé utilisant le prénom du destinataire, sans script d'ouverture ni de fermeture, et avec une mise à l'échelle horizontale appliquée uniquement en cas de débordement du nom dans la balise uImage Photoshop.
Créer une image de produit personnalisée avec le nom du client :

uImage.CreateImage2("C:\\Templates\\ProductLabel.psd", "C:\\Output", "OPT:Lable_for_" & |->[CustomerName], "EPS", "NO", "NO", "OFF", "HS", "firstname", , |->[CustomerName])

Résultat : génère un visuel EPS d'étiquette de produit avec le nom du client, sans ajustement, et sauvegarde la sortie dans un dossier spécifique avec le nom du client dans le nom de fichier, optimisé pour éviter les doublons.
Créer une bannière personnalisée avec plusieurs éléments :

uImage.CreateImage2("WebBanner.psd", "", "", "PNG", "NO", "NO", "OF", "FS", "firstname", |->[FirstName], "code", |->[OfferCode], "expiry", |->[ExpiryDate])

Résultat : génère une bannière Web personnalisée avec le nom, le code d'offre et la date d'expiration.

Fonction uImage.CreateIllustration2

La fonction uImage.CreateIllustration2 crée des illustrations personnalisées à partir d'un modèle Adobe Illustrator. Cette fonction permet une personnalisation vectorielle, idéale pour les visuels qui doivent être redimensionnés sans perte de qualité, tels que les logos, diagrammes et illustrations techniques.

Cette fonction retourne un actif Image pouvant être utilisé dans des ADOR d'image.

Syntaxe

uImage.CreateIllustration2(templateName, outputFolder, outputName, outputType, openingAction, closingAction, copyFittingMode, copyFittingMethod, tagName, tagValue [, ...])

Paramètre	Description
templateName	Requis. Le nom du modèle Illustrator à utiliser pour la génération d'illustrations.
outputFolder	Requis. Dossier de sortie. Laisser vide ("") pour le dossier de sortie par défaut.
outputFilename	Requis. Nom du fichier de sortie. Laisser vide ("") pour un nommage automatique. Préfixer avec "OPT:" pour une optimisation évitant de créer des images déjà générées. (Par exemple, lorsqu'une image avec les mêmes tagValues a déjà été traitée.)
outputType	Requis. Format de sortie. (L'un des suivants : "JPG", "EPS", "GIF", "PNG", "SWF" ou "AI".) Des paramètres supplémentaires dépendant du format sont également disponibles.
openingAction	Requis. Nom d'une action ou d'un script à utiliser lorsque le fichier Illustrator est ouvert et avant l'ajout des valeurs de balises. (Utilisez "NO" pour aucune action, "ACN=folder\\action" pour une action, ou "SCR=C:\\folder\\script.js" pour un script.)
closingAction	Requis. Nom d'une action ou d'un script à utiliser après l'ajout des valeurs de balises et avant la fermeture du fichier Illustrator. (Utilisez "NO" pour aucune action, "ACN=folder\\action" pour une action, ou "SCR=C:\\folder\\script.js" pour un script.)
copyFittingMode	Requis. Mode d'ajustement. "OFF" = aucun, "OF" = débordement, "UF" = soupassement, "B" = débordement et soupassement.
copyFittingMethod	Requis. Méthode d'ajustement. "HS" = mise à l'échelle horizontale, "FS" = mise à l'échelle de la police.
tagName	Requis. Nom d'une balise uImage ou d'un espace réservé dans le fichier Illustrator.
tagValue	Requis. Valeur à placer dans la balise uImage Illustrator. Dans la plupart des cas, il s'agit de l'objet de contenu ou de la variable contenant le prénom du destinataire, le nom de l'entreprise ou d'autres données à utiliser dans Illustrator.
Paires tagName et tagValue supplémentaires	Facultatif. Des paires nom/valeur supplémentaires peuvent être ajoutées si le modèle Illustrator contient plusieurs balises uImage.

Exemples

Créer une illustration personnalisée :

uImage.CreateIllustration2("DiagramTemplate.ai", "", "", "EPS", "NO", "NO", "OF", "HS", "firstname", |->[FirstName])

Résultat : une illustration vectorielle personnalisée

Préparation des modèles

Avant d'utiliser les fonctions uImage, les modèles (ou paquets de documents) doivent être préparés dans Adobe Photoshop ou Illustrator. Consultez l'aide en ligne uImage ou les tutoriels et formations suivants pour plus d'informations.

Tutoriels et formations

Comment créer des effets uImage basés sur les polices

Comment utiliser un paquet de documents Photoshop avec uCreate Print

Comment utiliser uImage avec uPlan

Utilisation de plusieurs calques de texte dans uImage

Création d'effets de polices imagettes avec uImage

Utilisation d'actions Photoshop avec uImage

Optimisation des performances uImage

Rubriques associées

Fonctions des actifs - Fonctions pour travailler avec les actifs statiques

Fonctions de conversion - Fonctions de conversion entre types de données

Fonctions Chaînes - Fonctions de manipulation de texte

Fonctions GetEnv - Fonctions d'accès aux informations d'environnement