uImage-Funktionen

uImage-Funktionen ermöglichen es Ihnen, personalisierte Bilder und Illustrationen dynamisch während der Komposition zu erstellen. Diese Funktionen nutzen Adobe Photoshop- und Illustrator-Vorlagen, um individuelle Grafiken auf Basis von Empfängerdaten zu generieren. Damit lassen sich anspruchsvolle Bildpersonalisierungen realisieren, wie z.B. personalisierte Produktmodelle, individuelle Zertifikate, dynamische Karten und individuelle Werbegrafiken.

Zusätzliche Ressourcen: Ausführliche Informationen zum Definieren und Generieren personalisierter Bilder, einschließlich der Vorlageneinrichtung und Konfiguration in uPlan, finden Sie in der uImage Online-Hilfe. Video-Tutorials sind ebenfalls verfügbar unter campus.xmpie.com.

uImage.uImage-Funktion

Die Funktion uImage.uImage erstellt personalisierte Bilder aus einem Photoshop-Dokumentpaket (.dpkg). Diese Funktion verarbeitet das speziell vorbereitete Photoshop-Dokument im Paket und generiert für jeden Empfänger ein individuelles Bild auf Basis seiner Daten.

Diese Funktion gibt ein Graphic-Asset zurück, das in grafischen ADORs verwendet werden kann.

Syntax

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

Parameter	Beschreibung
packageName	Erforderlich. Der Name des Photoshop-Dokumentpakets (.dpkg), das als Vorlage verwendet werden soll.
outputFolder	Erforderlich. Ausgabeordner. Lassen Sie diesen leer ("") für den Standardausgabeordner.
outputFilename	Erforderlich. Ausgabedateiname. Lassen Sie diesen leer ("") für automatische Benennung. Stellen Sie "OPT:" voran, um die Optimierung zu aktivieren, die das Erstellen bereits vorhandener Bilder vermeidet. (Zum Beispiel, wenn ein Bild mit denselben tagValues bereits verarbeitet wurde.)
outputType	Erforderlich. Ausgabeformat. (Eines von: "JPG", "EPS", "PSD" oder "PNG".) Zusätzliche formatabhängige Einstellungen sind ebenfalls verfügbar.
tagName	Erforderlich. Name eines Tags oder Platzhalters in der Photoshop-Datei.
tagValue	Erforderlich. Wert, der in den Photoshop-Tag eingefügt werden soll. In den meisten Fällen ist dies das ADOR oder die Variable, die den Vornamen, Firmennamen oder andere Daten des Empfängers enthält, die in Photoshop verwendet werden sollen.
Weitere tagName- und tagValue-Paare	Optional. Zusätzliche Name/Wert-Paare können angehängt werden, wenn die Photoshop-Vorlage mehrere Tags enthält.

Beispiele

Personalisierte Zertifikate mit Empfängernamen erstellen:

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

Ergebnis: Generiert personalisierte Zertifikatbilder unter Verwendung des vollständigen Namens des Empfängers in der vorgesehenen Textebene. Gespeichert im Standardausgabeordner mit automatischer Benennung.
Produktmodell-Bilder erstellen:

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

Ergebnis: Personalisierte Produktmodell-Bilder. Gespeichert mit dem Produktnamen im Standardausgabeordner, wobei doppelte Produktnamen übersprungen werden.
Personalisierte Bilder mit mehreren Datenpunkten erstellen:

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

Ergebnis: Generiert Ausweiskarten-Bilder mit Name, Abteilung und Mitarbeiterfoto.

Hinweis: Das Photoshop-Dokumentpaket muss in uPlan ordnungsgemäß mit definierten variablen Ebenen konfiguriert sein, bevor es mit dieser Funktion verwendet werden kann. Siehe die uImage Online-Hilfe für Richtlinien zur Vorlagenvorbereitung.

uImage.CreateImage2-Funktion

Die Funktion uImage.CreateImage2 erstellt personalisierte Bilder aus einer Photoshop-Vorlage. Dies ist eine ältere Funktion, die aus Gründen der Abwärtskompatibilität bereitgestellt wird, um die Generierung personalisierter Bilder direkt aus einer Photoshop-Datei (.psd) zu ermöglichen.

Diese Funktion gibt ein Graphic-Asset zurück, das in grafischen ADORs verwendet werden kann.

Hinweis: Es wird empfohlen, ein Photoshop-Dokumentpaket und die Funktion uImage.Image anstelle einer direkten Photoshop-Datei zu verwenden. Das Photoshop-Dokumentpaket enthält die Photoshop-Datei zusammen mit allen Schriften, Aktionen und weiteren Informationen, um eine reibungslose Produktion zu gewährleisten und Fehler durch fehlende Komponenten zu vermeiden.

Syntax

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

Parameter	Beschreibung
templateName	Erforderlich. Der Name der Photoshop-Datei, die für die Bildgenerierung verwendet werden soll.
outputFolder	Erforderlich. Ausgabeordner. Lassen Sie diesen leer ("") für den Standardausgabeordner.
outputFilename	Erforderlich. Ausgabedateiname. Lassen Sie diesen leer ("") für automatische Benennung. Stellen Sie "OPT:" voran, um die Optimierung zu aktivieren, die das Erstellen bereits vorhandener Bilder vermeidet. (Zum Beispiel, wenn ein Bild mit denselben tagValues bereits verarbeitet wurde.)
outputType	Erforderlich. Ausgabeformat. (Eines von: "JPG", "EPS", "PSD" oder "PNG".) Zusätzliche formatabhängige Einstellungen sind ebenfalls verfügbar.
openingAction	Erforderlich. Name einer Aktion oder eines Skripts, das beim ersten Öffnen der Photoshop-Datei und vor dem Hinzufügen von Tag-Werten verwendet wird. (Verwenden Sie "NO" für keine Aktion, "ACN=folder\\action" für eine Aktion oder "SCR=C:\\folder\\script.js" für ein Skript.)
closingAction	Erforderlich. Name einer Aktion oder eines Skripts, das nach dem Hinzufügen von Tag-Werten und vor dem Schließen der Photoshop-Datei verwendet wird. (Verwenden Sie "NO" für keine Aktion, "ACN=folder\\action" für eine Aktion oder "SCR=C:\\folder\\script.js" für ein Skript.)
copyFittingMode	Erforderlich. Copyfitting-Modus. "OFF" = keiner, "OF" = Überlauf, "UF" = Unterlauf, "B" = sowohl Unterlauf als auch Überlauf.
copyFittingMethod	Erforderlich. Copyfitting-Methode. "HS" = horizontale Skalierung, "FS" = Schriftskalierung.
tagName	Erforderlich. Name eines Tags oder Platzhalters in der Photoshop-Datei.
tagValue	Erforderlich. Wert, der in den Photoshop-Tag eingefügt werden soll. In den meisten Fällen ist dies das ADOR oder die Variable, die den Vornamen, Firmennamen oder andere Daten des Empfängers enthält, die in Photoshop verwendet werden sollen.
Weitere tagName- und tagValue-Paare	Optional. Zusätzliche Name/Wert-Paare können angehängt werden, wenn die Photoshop-Vorlage mehrere Tags enthält.

Beispiele

Ein personalisiertes Werbebild erstellen:

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

Ergebnis: Eine personalisierte Werbegrafik unter Verwendung des Vornamens des Empfängers, ohne Öffnungs- oder Schließskripte, mit horizontaler Skalierung, die nur angewendet wird, wenn der Name den Tag in Photoshop überläuft.
Ein personalisiertes Produktbild mit Kundennamen erstellen:

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

Ergebnis: Generiert eine Produktetiketten-EPS-Grafik mit dem Kundennamen, ohne Copyfitting, mit Speicherung der Ausgabe in einem bestimmten Ordner, einschließlich des Kundennamens im Dateinamen, und optimiert, um doppelte Arbeit zu vermeiden.
Ein personalisiertes Banner mit mehreren Elementen erstellen:

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

Ergebnis: Generiert ein Webbanner, personalisiert mit Name, Angebotscode und Ablaufdatum.

uImage.CreateIllustration2-Funktion

Die Funktion uImage.CreateIllustration2 erstellt personalisierte Illustrationen aus einer Adobe Illustrator-Vorlage. Diese Funktion ermöglicht vektorbasierte Personalisierung, die ideal für Grafiken ist, die ohne Qualitätsverlust skaliert werden müssen, wie z.B. Logos, Diagramme und technische Illustrationen.

Diese Funktion gibt ein Graphic-Asset zurück, das in grafischen ADORs verwendet werden kann.

Syntax

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

Parameter	Beschreibung
templateName	Erforderlich. Der Name der Illustrator-Vorlage, die für die Illustrationsgenerierung verwendet werden soll.
outputFolder	Erforderlich. Ausgabeordner. Lassen Sie diesen leer ("") für den Standardausgabeordner.
outputFilename	Erforderlich. Ausgabedateiname. Lassen Sie diesen leer ("") für automatische Benennung. Stellen Sie "OPT:" voran, um die Optimierung zu aktivieren, die das Erstellen bereits vorhandener Bilder vermeidet. (Zum Beispiel, wenn ein Bild mit denselben tagValues bereits verarbeitet wurde.)
outputType	Erforderlich. Ausgabeformat. (Eines von: "JPG", "EPS", "GIF", "PNG", "SWF" oder "AI".) Zusätzliche formatabhängige Einstellungen sind ebenfalls verfügbar.
openingAction	Erforderlich. Name einer Aktion oder eines Skripts, das beim ersten Öffnen der Illustrator-Datei und vor dem Hinzufügen von Tag-Werten verwendet wird. (Verwenden Sie "NO" für keine Aktion, "ACN=folder\\action" für eine Aktion oder "SCR=C:\\folder\\script.js" für ein Skript.)
closingAction	Erforderlich. Name einer Aktion oder eines Skripts, das nach dem Hinzufügen von Tag-Werten und vor dem Schließen der Illustrator-Datei verwendet wird. (Verwenden Sie "NO" für keine Aktion, "ACN=folder\\action" für eine Aktion oder "SCR=C:\\folder\\script.js" für ein Skript.)
copyFittingMode	Erforderlich. Copyfitting-Modus. "OFF" = keiner, "OF" = Überlauf, "UF" = Unterlauf, "B" = sowohl Unterlauf als auch Überlauf.
copyFittingMethod	Erforderlich. Copyfitting-Methode. "HS" = horizontale Skalierung, "FS" = Schriftskalierung.
tagName	Erforderlich. Name eines Tags oder Platzhalters in der Illustrator-Datei.
tagValue	Erforderlich. Wert, der in den Illustrator-Tag eingefügt werden soll. In den meisten Fällen ist dies das ADOR oder die Variable, die den Vornamen, Firmennamen oder andere Daten des Empfängers enthält, die in Illustrator verwendet werden sollen.
Weitere tagName- und tagValue-Paare	Optional. Zusätzliche Name/Wert-Paare können angehängt werden, wenn die Illustrator-Vorlage mehrere Tags enthält.

Beispiele

Eine personalisierte Illustration erstellen:

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

Ergebnis: Eine personalisierte Vektorillustration

Vorlagenvorbereitung

Bevor Sie uImage-Funktionen verwenden, müssen Vorlagen (oder Dokumentpakete) in Adobe Photoshop oder Illustrator vorbereitet werden. Weitere Informationen finden Sie in der uImage Online-Hilfe oder in den folgenden Tutorials und Schulungen.

Tutorials und Schulungen

How create font-based uImage effects

How to use a Photoshop document package with uCreate Print

How to use uImage with uPlan

Using multiple text layers in uImage

Creating Image or picture font effects with uImage

Using Photoshop actions with uImage

Optimizing uImage performance

Weitere Themen

Asset-Funktionen - Funktionen für die Arbeit mit statischen Assets

Konvertierungsfunktionen - Funktionen zum Konvertieren zwischen Datentypen

String-Funktionen - Funktionen für die Textbearbeitung

GetEnv-Funktionen - Funktionen für den Zugriff auf Umgebungsinformationen