Asset-Microservices und Verarbeitungsprofile verwenden

Asset-Microservices erlauben eine skalierbare und zuverlässige Verarbeitung von Assets mithilfe von Cloud-nativen Programmen (auch als „sekundäre Programme“ bezeichnet). Adobe verwaltet die Service für eine optimale Handhabung verschiedener Asset-Typen und Verarbeitungsoptionen.

Mit Asset-Microservices können Sie eine breite Palette von Dateitypen verarbeiten, die mehr Formate standardmäßig abdecken, als dies mit früheren Versionen von Experience Manager möglich war. Beispielsweise ist jetzt die Extraktion von Miniaturansichten in PSD- und PSB-Formaten möglich, zuvor waren jedoch Lösungen von Drittanbietern wie ImageMagick erforderlich.

Die Asset-Verarbeitung hängt von der Konfiguration in Verarbeitungsprofilen ab. Experience Manager bietet eine einfache Standardeinrichtung und ermöglicht es Administratoren, spezifischere Asset-Verarbeitungskonfigurationen hinzuzufügen. Administratoren können die Konfigurationen von Nachbearbeitungs-Workflows erstellen, verwalten und ändern, einschließlich optionaler Anpassungen. Durch Anpassen der Workflows können Entwickler das Standardangebot erweitern.

Optionen zur Asset-Verarbeitung verstehen

Experience Manager ermöglicht die Verarbeitung der folgenden Ebenen.

Unterstützte Dateiformate

Asset-Microservices bieten Unterstützung für eine Vielzahl von Dateiformaten, um Daten zu verarbeiten, Ausgabedarstellungen zu generieren oder Metadaten zu extrahieren. Unter Unterstützte Dateiformate finden Sie eine vollständige Liste der MIME-Typen und der jeweils unterstützten Funktionen.

Standardkonfiguration

Einige Standardwerte sind vorkonfiguriert, um sicherzustellen, dass die in Experience Manager erforderlichen Standardausgabedarstellungen verfügbar sind. Außerdem stellt die Standardkonfiguration sicher, dass Metadatenextraktion und Textextraktion verfügbar sind. Benutzer können sofort mit dem Hochladen oder Aktualisieren von Assets beginnen. Die grundlegende Verarbeitung ist standardmäßig verfügbar.

Bei der Standardkonfiguration wird nur das einfachste Verarbeitungsprofil konfiguriert. Solch ein Verarbeitungsprofil ist in der Benutzeroberfläche nicht sichtbar und kann nicht geändert werden. Es wird immer ausgeführt, um hochgeladene Assets zu verarbeiten. Mit einem standardmäßigen Verarbeitungsprofil wird sichergestellt, dass die von Experience Manager benötigte grundlegende Verarbeitung für alle Assets durchgeführt wird.

Standardkonfiguration

Experience Manager bietet Funktionen zum Generieren spezifischerer Ausgabedarstellungen für gängige Formate gemäß den Anforderungen des Benutzers. Ein Administrator kann zusätzliche Verarbeitungsprofile anlegen, um die Erstellung solcher Ausgabedarstellungen zu erleichtern. Benutzer können dann eines oder mehrere der verfügbaren Profile bestimmten Ordnern zuweisen, um die zusätzliche Verarbeitung zu erhalten. Beispielsweise kann die zusätzliche Verarbeitung Ausgabedarstellungen für Web, Smartphone und Tablet generieren. Das folgende Video zeigt, wie Sie Verarbeitungsprofile erstellen und anwenden und auf die erstellten Ausgabedarstellungen zugreifen.

• Breite und Höhe der Ausgabedarstellung: Eine Angabe der Breite und Höhe der Ausgabedarstellung sorgt für die maximale Größe des generierten Ausgabebilds. Asset-Microservices versuchen, die größtmögliche Ausgabedarstellung zu erstellen, dessen Breite und Höhe nicht größer als die angegebene Breite bzw. Höhe sind. Das Seitenverhältnis wird beibehalten, d. h. es entspricht dem Original. Ein leerer Wert bedeutet, dass bei der Asset-Verarbeitung die Pixelabmessungen des Originals berücksichtigt werden.

• Einschlussregeln für MIME-Typen: Wenn ein Asset mit einem bestimmten MIME-Typ verarbeitet wird, wird der MIME-Typ zunächst mit dem Wert für die ausgeschlossenen MIME-Typen für die Ausgabespezifikation verglichen. Wenn er mit dieser Liste übereinstimmt, wird diese spezifische Ausgabedarstellung nicht für das Asset generiert (Blockierungsliste). Andernfalls wird der MIME-Typ mit dem eingeschlossenen MIME-Typ verglichen. Wenn er mit der Liste übereinstimmt, wird die Ausgabedarstellung generiert (Zulassungsliste).

• Spezielle FPO-Ausgabedarstellung: Beim Platzieren großer Assets aus Experience Manager in Adobe InDesign-Dokumenten muss ein Kreativprofi eine ganze Weile warten, nachdem er ein Asset platziert hat. In der Zwischenzeit kann der Benutzer InDesign nicht verwenden. Dies unterbricht den kreativen Fluss und wirkt sich negativ auf das Kundenerlebnis aus. Adobe ermöglicht die zeitweilige Platzierung kleinformatiger Ausgabedarstellungen in InDesign-Dokumenten. Diese können später bei Assets On-demand in voller Auflösung ersetzt werden. Experience Manager bietet Ausgabedarstellungen, die nur für die Platzierung verwendet werden (FPO). Diese FPO-Ausgabedarstellungen haben eine kleine Dateigröße, weisen aber dasselbe Seitenverhältnis auf.

Das Verarbeitungsprofil kann eine FPO-Ausgabedarstellung (nur für Platzierung) enthalten. In der Adobe Asset Link Dokumentation erfahren Sie, ob Sie es für Ihr Verarbeitungsprofil aktivieren müssen. Weitere Informationen finden Sie in der vollständigen Dokumentation von Adobe Asset Link.

Erstellen eines Standardprofils

Gehen Sie wie folgt vor, um ein Standardverarbeitungsprofil zu erstellen:

1. Administratoren greifen auf Tools > Assets > Verarbeitungsprofile zu. Klicken Sie auf Erstellen.

2. Geben Sie einen Namen ein, der Ihnen hilft, das Profil beim Anwenden auf einen Ordner eindeutig zu identifizieren.

3. Um FPO-Ausgabedarstellungen zu generieren, aktivieren Sie auf der Registerkarte Bild die Option FPO-Ausgabedarstellung erstellen. Geben Sie einen Wert für Qualität zwischen 1 und 100 ein.

4. Um andere Ausgabedarstellungen zu erstellen, klicken Sie auf Neu hinzufügen und geben Sie die folgenden Informationen ein:

   • Dateiname der jeweiligen Ausgabedarstellung.
   • Dateiformat (PNG, JPEG, GIF oder WebP) der jeweiligen Ausgabedarstellung.
   • Breite und Höhe der jeweiligen Ausgabedarstellung in Pixel. Wenn nichts angegeben wird, wird die volle Pixelgröße des Originalbilds verwendet.
   • Qualität in Prozent der jeweiligen JPEG- und WebP-Ausgabedarstellung.
   • Eingeschlossene und ausgeschlossene MIME-Typen zur Definition der Anwendbarkeit eines Profils.

   

5. Klicken Sie auf Speichern.

Benutzerdefiniertes Profil und Anwendungsfälle

Der Asset Compute Service unterstützt eine Vielzahl von Anwendungsfällen, z. B. Standardverarbeitung, Verarbeitung von Adobe-spezifischen Formaten wie Photoshop-Dateien und Implementierung benutzerdefinierter oder unternehmensspezifischer Verarbeitungsformate. Die zuvor erforderliche Anpassung des DAM Update Asset-Workflows wird entweder automatisch oder über die Konfiguration von Verarbeitungsprofilen vorgenommen. Wenn diese Verarbeitungsoptionen geschäftlichen Anforderungen nicht gerecht werden, empfiehlt Adobe, die Standardfunktionen mit Asset Compute Service zu entwickeln und zu erweitern. Einen Überblick finden Sie unter Erweiterbarkeit und Verwendungszeitpunkt.

Sie können Bild-, Video-, Dokument- und andere Dateiformate in verschiedene Ausgabedarstellungen umwandeln, einschließlich Miniaturansichten, extrahiertem Text und Metadaten sowie Archiven.

Entwickler können den Asset Compute Service verwenden, um benutzerdefinierte Programme für die unterstützten Anwendungsfälle zu erstellen. Experience Manager kann diese benutzerdefinierten Programme über die Benutzeroberfläche aufrufen, indem benutzerdefinierte Profile verwendet werden, die Administratoren konfigurieren. Asset Compute Service unterstützt die folgenden Anwendungsfälle beim Aufrufen externer Services:

• Verwenden Sie die ImageCutout-API von Adobe Photoshop und speichern Sie das Ergebnis als Ausgabedarstellung.
• Rufen Sie Drittanbietersysteme auf, um Daten zu aktualisieren, z. B. ein PIM-System.
• Verwenden Sie die Photoshop-API, um basierend auf der Photoshop-Vorlage verschiedene Ausgabedarstellungen zu erstellen.
• Verwenden Sie die Adobe Lightroom-API, um die erfassten Assets zu optimieren und als Ausgabedarstellungen zu speichern.

Benutzerdefiniertes Profil erstellen

Gehen Sie wie folgt vor, um ein benutzerdefiniertes Profil zu erstellen:

1. Administratoren greifen auf Tools > Assets > Verarbeitungsprofile zu. Klicken Sie auf Erstellen.

2. Klicken Sie auf die Registerkarte Benutzerdefiniert. Klicken Sie auf Neu hinzufügen. Geben Sie den gewünschten Dateinamen der Ausgabedarstellung ein.

3. Geben Sie die folgenden Informationen ein.

   • Dateiname der jeweiligen Ausgabedarstellung und eine unterstützte Dateierweiterung.
   • Endpunkt-URL einer benutzerdefinierten Firefly-Mobile-App. Die Mobile App muss aus derselben Organisation stammen wie das Experience Manager-Konto.
   • Fügen Sie Service-Parameter hinzu, um zusätzliche Informationen oder Parameter an das benutzerdefinierte Programm zu übergeben.
   • Schließen Sie MIME-Typen ein und aus, um die Verarbeitung auf einige bestimmte Dateiformate zu beschränken.

   Klicken Sie auf Speichern.

Bei den benutzerdefinierten Programmen handelt es sich um Headless-Project Firefly-Mobile-Apps. Das benutzerdefinierte Programm erhält alle angegebenen Dateien, wenn sie mit einem Verarbeitungsprofil eingerichtet wurden. Das Programm muss die Dateien filtern.

Beispiel für ein benutzerdefiniertes Profil

Zur Veranschaulichung der Nutzung eines benutzerdefinierten Profils sollten wir uns einen Anwendungsfall ansehen, bei dem Kampagnenbilder mit benutzerdefiniertem Text versehen werden. Sie können ein Verarbeitungsprofil erstellen, das die Photoshop-API zum Bearbeiten der Bilder verwendet.

Die Asset Compute-Service-Integration ermöglicht es Experience Manager, diese Parameter mithilfe des Felds Dienstparameter an das benutzerdefinierte Programm zu übergeben. Das benutzerdefinierte Proramm ruft dann die Photoshop-API auf und übergibt die Werte an die API. Sie können beispielsweise Schriftartname, Textfarbe, Textstärke und Textgröße übergeben, um den benutzerdefinierten Text Kampagnenbildern hinzuzufügen.

Abbildung: Verwenden Sie das Feld Dienstparameter, um zusätzliche Informationen an vordefinierte Parameter zu übergeben, die in das benutzerdefinierte Programm eingebunden sind. In diesem Beispiel werden hochgeladene Kampagnenbilder mit Jumanji-Text in der Arial-BoldMT-Schriftart aktualisiert.

Verarbeitungsprofile zur Verarbeitung von Assets verwenden

Erstellen Sie die zusätzlichen benutzerdefinierten Verarbeitungsprofile und wenden Sie sie auf bestimmte Ordner an, damit Experience Manager sie für Assets verarbeitet, die in diese Ordner hochgeladen oder in diesen aktualisiert wurden. Das standardmäßige integrierte Verarbeitungsprofil wird immer ausgeführt, ist jedoch in der Benutzeroberfläche nicht sichtbar. Wenn Sie ein benutzerdefiniertes Profil hinzufügen, werden beide Profil zur Verarbeitung der hochgeladenen Assets verwendet.

Verwenden Sie eine der folgenden Methoden, um Verarbeitungsprofile auf Ordner anzuwenden:

• Administratoren können unter Tools > Assets Verarbeitungsprofile eine Verarbeitungsprofildefinition auswählen und die Aktion Profil auf Ordner anwenden nutzen. Dadurch wird ein Inhalts-Browser geöffnet, mit dem Sie zu bestimmten Ordnern navigieren, diese auswählen und die Anwendung des Profils bestätigen können.

• Benutzer können einen Ordner in der Assets-Benutzeroberfläche auswählen, die Aktion Eigenschaften zum Öffnen der Ordnereigenschaften verwenden, auf die Registerkarte Asset-Verarbeitung klicken und in der Liste Verarbeitungsprofil das entsprechende Verarbeitungsprofil für diesen Ordner auswählen. Klicken Sie auf Speichern und schließen, um die Änderungen zu speichern.
  

• Benutzer können Ordner oder bestimmte Assets in der Assets-Benutzeroberfläche auswählen, um ein Verarbeitungsprofil anzuwenden, und dann die Option Assets erneut verarbeiten aus den oben verfügbaren Optionen auswählen.

Nachdem ein Verarbeitungsprofil auf einen Ordner angewendet wurde, werden alle neuen Assets, die in diesen Ordner oder in dessen Unterordnern hochgeladen (oder aktualisiert) werden, mit dem konfigurierten zusätzlichen Verarbeitungsprofil verarbeitet. Diese Verarbeitung erfolgt zusätzlich zum Standardprofil.

Um sicherzustellen, dass Assets verarbeitet werden, müssen Sie die erzeugten Ausgabedarstellungen in der Ansicht Ausgabedarstellungen in der linken Leiste als Vorschau anzeigen. Öffnen Sie die Asset-Vorschau und dann die linke Leiste, um auf die Ansicht Ausgabedarstellungen zuzugreifen. Die spezifischen Ausgabedarstellungen im Verarbeitungsprofil, für die der Typ des jeweiligen Assets mit den Einschlussregeln des MIME-Typs übereinstimmt, sollten sichtbar und zugänglich sein.

Abbildung: Beispiel zweier zusätzlicher Ausgabedarstellungen, die von einem Verarbeitungsprofil generiert wurden, das auf den übergeordneten Ordner angewendet wurde.

Nachbearbeitungs-Workflows

In Fällen, in denen zusätzliche Verarbeitung von Assets erforderlich ist, die mit den Verarbeitungsprofilen nicht erreicht werden kann, können der Konfiguration zusätzliche Nachbearbeitungs-Workflows hinzugefügt werden. Mit der Nachbearbeitung können Sie zusätzlich zur konfigurierbaren Verarbeitung mithilfe von Asset-Microservices eine vollständig angepasste Verarbeitung hinzufügen.

Nachbearbeitungs-Workflows werden, falls konfiguriert, automatisch von Experience Manager ausgeführt, nachdem die Verarbeitung der Microservices abgeschlossen ist. Es ist nicht notwendig, Workflow-Starter manuell hinzuzufügen, um die Workflows auszulösen. Zu den Beispielen gehören:

• Benutzerdefinierte Workflow-Schritte zur Verarbeitung von Assets.
• Integrationen, um Assets von externen Systemen Metadaten oder Eigenschaften hinzuzufügen, z. B. Produkt- oder Prozessinformationen.
• Zusätzliche Verarbeitung durch externe Services.

Gehen Sie wie folgt vor, um Experience Manager eine Workflow-Konfiguration für die Nachbearbeitung hinzuzufügen:

• Erstellen eines oder mehrerer Workflow-Modelle. Diese benutzerdefinierten Modelle werden in dieser Dokumentation als Workflow-Modelle nach der Verarbeitung bezeichnet. Es handelt sich um normale Experience Manager-Workflow-Modelle.
• Fügen Sie diesen Modellen die erforderlichen Workflow-Schritte hinzu. Überprüfen Sie die Schritte aus dem Standard-Workflow und fügen Sie dem benutzerdefinierten Workflow alle erforderlichen Standardschritte hinzu. Die Schritte werden basierend auf einer Workflow-Modellkonfiguration für die Assets ausgeführt. Wenn beispielsweise Smart-Tagging beim Hochladen von Assets automatisch erfolgen soll, fügen Sie den Schritt zum benutzerdefinierten Workflow-Modell für die Nachbearbeitung hinzu.
• Fügen Sie am Ende den Schritt Abgeschlossener Prozess zum DAM-Workflow eines Asset-Updates hinzu. Durch Hinzufügen dieses Schritts wird sichergestellt, dass Experience Manager weiß, wann die Verarbeitung abgeschlossen ist, und das Asset als verarbeitet markiert werden kann, d. h., dass beim Asset der Wert Neu angezeigt wird.
• Erstellen Sie eine Konfiguration für den Custom Workflow Runner Service, mit der die Ausführung eines Nachbearbeitungs-Workflow-Modells entweder nach Pfad (Speicherort für Ordner) oder nach regulären Ausdrücken konfiguriert werden kann.

Weitere Informationen dazu, welcher standardmäßige Workflow-Schritt im Nachbearbeitungs-Workflow verwendet werden kann, finden Sie unter Workflow-Schritte im Nachbearbeitungs-Workflow in der Entwicklerreferenz.

Erstellen von Nachbearbeitungs-Workflow-Modellen

Nachbearbeitungs-Workflow-Modelle sind normale Experience Manager-Workflow-Modelle. Erstellen Sie verschiedene Modelle, wenn Sie für verschiedene Repository-Standorte oder Asset-Typen eine unterschiedliche Verarbeitung benötigen.

Die Verarbeitungsschritte werden nach Bedarf hinzugefügt. Sie können sowohl die unterstützten Schritte als auch alle benutzerdefinierten Workflow-Schritte verwenden.

Stellen Sie sicher, dass der letzte Schritt jedes Nachbearbeitungs-Workflows DAM Update Asset Workflow Completed Process ist. Der letzte Schritt stellt sicher, dass Experience Manager weiß, wann die Asset-Verarbeitung abgeschlossen ist.

Konfigurieren der Ausführung von Nachbearbeitungs-Workflows

Nachdem die Asset-Microservices die Verarbeitung der hochgeladenen Assets abgeschlossen haben, können Sie einen Nachbearbeitungs-Workflow definieren, um die Assets weiter zu verarbeiten. Um die Nachbearbeitung mithilfe von Workflow-Modellen zu konfigurieren, haben Sie folgende Möglichkeiten:

• Wenden Sie ein Workflow-Modell in den Ordnereigenschaften an.
• Konfigurieren Sie den Custom Workflow Runner-Dienst.

Anwenden eines Workflow-Modells auf einen Ordner

Für typische Anwendungsfälle nach der Verarbeitung sollten Sie die -Methode verwenden, um einen Workflow auf einen Ordner anzuwenden. Gehen Sie wie folgt vor, um ein Workflow-Modell im Ordner Eigenschaften anzuwenden:

1. Erstellen eines Workflow-Modells.

2. Wählen Sie einen Ordner aus, klicken Sie in der Symbolleiste auf Eigenschaften und dann auf die Registerkarte Asset-Verarbeitung .

3. Wählen Sie unter Workflow automatisch starten den gewünschten Workflow aus, geben Sie einen Titel für den Workflow ein und speichern Sie dann die Änderungen.

   

Konfigurieren des Custom Workflow Runner-Dienstes

Sie können den benutzerdefinierten Workflow Runner-Dienst für die erweiterten Konfigurationen konfigurieren, die nicht ohne weiteres erfüllt werden können, indem Sie einen Workflow auf einen Ordner anwenden. Beispiel: ein Workflow, der einen regulären Ausdruck verwendet. Der Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) ist ein OSGi-Dienst. Es bietet die beiden folgenden Konfigurationsoptionen:

• Nachbearbeitungs-Workflows nach Pfad (postProcWorkflowsByPath): Es können mehrere Workflow-Modelle basierend auf unterschiedlichen Repository-Pfaden aufgeführt werden. Trennen Sie Pfade und Modelle mithilfe eines Doppelpunkts. Einfache Repository-Pfade werden unterstützt. Ordnen Sie diese einem Workflow-Modell im Pfad /var zu. Beispiel: /content/dam/my-brand:/var/workflow/models/my-workflow.
• Nachbearbeitungs-Workflows nach Ausdruck (postProcWorkflowsByExpression): Es können mehrere Workflow-Modelle basierend auf unterschiedlichen regulären Ausdrücken aufgelistet werden. Ausdrücke und Modelle sollten durch einen Doppelpunkt getrennt werden. Der reguläre Ausdruck sollte direkt auf den Asset-Knoten verweisen und nicht auf eine der Ausgabedarstellungen oder Dateien. Beispiel: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

Informationen zum Bereitstellen einer OSGi-Konfiguration finden Sie unter Bereitstellen unter Experience Manager.

Best Practices und Einschränkungen

• Berücksichtigen Sie beim Entwickeln von Workflows Ihre Anforderungen für alle Arten von Ausgabedarstellungen. Wenn Sie der Meinung sind, dass eine Ausgabedarstellung in Zukunft nicht erforderlich sein wird, entfernen Sie den Erstellungsschritt aus dem Workflow. Ausgabedarstellungen können später nicht mehr stapelweise gelöscht werden. Unerwünschte Ausgabedarstellungen können nach längerer Nutzung von Experience Manager viel Speicherplatz beanspruchen. Bei einzelnen Assets können Sie Ausgabedarstellungen manuell aus der Benutzeroberfläche entfernen. Bei mehreren Assets können Sie Experience Manager so anpassen, dass entweder bestimmte Ausgabedarstellungen gelöscht oder die Assets gelöscht und die gelöschten Assets erneut hochgeladen werden.
• Derzeit ist die Unterstützung auf das Erzeugen von Ausgabedarstellungen beschränkt. Das Erstellen neuer Assets wird nicht unterstützt.
• Derzeit beträgt die maximale Dateigröße für die Extraktion von Metadaten etwa 10 GB. Beim Hochladen sehr großer Assets schlägt die Metadatenextraktion manchmal fehl.