Integration mit AEM Verarbeitungsprofilen

Damit Asset compute-Sekundäre benutzerdefinierte Ausgabeformate in AEM as a Cloud Service generieren können, müssen sie über Verarbeitungsprofile in AEM als Cloud Service-Autorendienst registriert sein. Bei allen Assets, die diesem Verarbeitungsprofil unterliegen, wird der Worker beim Hochladen oder erneuten Verarbeiten aufgerufen und die benutzerdefinierte Ausgabedarstellung wird generiert und über die Ausgabeformate des Assets bereitgestellt.

Definieren eines Verarbeitungsprofils

Erstellen Sie zunächst ein neues Verarbeitungsprofil, das den Worker mit den konfigurierbaren Parametern aufruft.

Verarbeitungsprofil

  1. Melden Sie sich bei AEM als Cloud Service-Autorendienst als AEM Administrator an. Da es sich um ein Tutorial handelt, empfehlen wir die Verwendung einer Entwicklungsumgebung oder einer Umgebung in einer Sandbox.
  2. Navigieren Sie zu Tools > Assets > Verarbeitungsprofile .
  3. Tippen Sie auf die Schaltfläche Erstellen
  4. Benennen Sie das Verarbeitungsprofil WKND Asset Renditions.
  5. Tippen Sie auf die Registerkarte Benutzerdefiniert und dann auf Neu hinzufügen
  6. Definieren des neuen Dienstes
    • Name des Ausgabeformats: Circle
      • Die Dateinamenausgabe, die zur Identifikation dieser Ausgabedarstellung in AEM Assets verwendet wird
    • Erweiterung: png
      • Die Erweiterung der Ausgabedarstellung, die generiert wird. Setzen Sie dies auf png , da dies das unterstützte Ausgabeformat ist, das der Webdienst des Sekundärs unterstützt, und zu transparentem Hintergrund hinter dem ausgeschnittenen Kreis führt.
    • Endpunkt: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker
      • Dies ist die URL zum Worker, der über aio app get-url abgerufen wurde. Stellen Sie sicher, dass die URL auf den richtigen Arbeitsbereich verweist, basierend auf der AEM als Cloud Service-Umgebung.
      • Stellen Sie sicher, dass die Worker-URL auf den richtigen Arbeitsbereich verweist. AEM as a Cloud Service Stage sollte die Staging-Workspace-URL verwenden und AEM as a Cloud Service Production sollte die URL des Produktionsarbeitsbereichs verwenden.
    • Dienstparameter
      • Tippen Sie auf Parameter hinzufügen
        • Schlüssel: size
        • Wert: 1000
      • Tippen Sie auf Parameter hinzufügen
        • Schlüssel: contrast
        • Wert: 0.25
      • Tippen Sie auf Parameter hinzufügen
        • Schlüssel: brightness
        • Wert: 0.10
      • Diese Schlüssel-Wert-Paare, die an den Asset compute Worker übergeben und über das JavaScript-Objekt rendition.instructions verfügbar sind.
    • MIME-Typen
      • Umfasst: image/jpeg, image/png, image/gif, image/bmp, image/tiff
        • Diese MIME-Typen sind die einzigen, die die npm-Module des Sekundärs enthalten. Diese Liste beschränkt, welche Assets vom benutzerdefinierten Worker verarbeitet werden.
      • Schließt Folgendes aus: Leave blank
        • Verarbeiten Sie niemals Assets mit diesen MIME-Typen mithilfe dieser Dienstkonfiguration. In diesem Fall verwenden wir nur eine Zulassungsliste.
  7. Tippen Sie oben rechts auf Speichern .

Anwenden und Aufrufen eines Verarbeitungsprofils

  1. Wählen Sie das neu erstellte Verarbeitungsprofil WKND Asset Renditions aus.

  2. Tippen Sie in der oberen Aktionsleiste auf Profil auf Ordner anwenden .

  3. Wählen Sie einen Ordner aus, auf den das Verarbeitungsprofil angewendet werden soll, z. B. WKND und tippen Sie auf Anwenden

  4. Navigieren Sie zum Ordner, auf den das Verarbeitungsprofil nicht angewendet wurde, über AEM > Assets > Dateien und tippen Sie auf WKND.

  5. Laden Sie einige neue Bild-Assets (sample-1.jpg, sample-2.jpg und sample-3.jpg) in einen beliebigen Ordner unter dem Ordner hoch, auf den das Verarbeitungsprofil angewendet wurde, und warten Sie, bis das hochgeladene Asset verarbeitet wird.

  6. Tippen Sie auf das Asset, um seine Details zu öffnen.

    • Standardausgabeformate können in AEM schneller generiert und angezeigt werden als benutzerdefinierte Ausgabeformate.
  7. Öffnen Sie die Ansicht Ausgabeformate in der linken Seitenleiste.

  8. Tippen Sie auf das Asset mit dem Namen Circle.png und überprüfen Sie das generierte Ausgabeformat.

    Generierte Ausgabe

Beendet!

Herzlichen Glückwunsch! Sie haben das Tutorial zum Erweitern von AEM as a Cloud Service Asset compute Microservices abgeschlossen! Sie sollten jetzt benutzerdefinierte Asset compute-Sekundäre einrichten, entwickeln, testen, debuggen und bereitstellen können, um sie für Ihre AEM als Cloud Service-Autorendienst zu verwenden.

Überprüfen Sie den vollständigen Projektquellcode auf Github.

Das endgültige Asset compute-Projekt ist auf Github verfügbar unter:

Github enthält den endgültigen Status des Projekts, der vollständig mit den Arbeits- und Testfällen gefüllt ist, jedoch keine Anmeldeinformationen enthält, d. h. .env, .config.json oder .aio.

Fehlerbehebung

Auf dieser Seite