Integrieren mit AEM-Verarbeitungsprofilen

Damit Asset Compute-Sekundäre benutzerdefinierte Ausgabedarstellungen in AEM as a Cloud Service generieren können, müssen sie über Verarbeitungsprofile im Author-Service von AEM as a Cloud Service registriert sein. Bei allen Assets, die diesem Verarbeitungsprofil unterliegen, wird der Sekundär beim Hochladen oder erneuten Verarbeiten aufgerufen. Dann wird die benutzerdefinierte Ausgabedarstellung generiert und über die Ausgabedarstellungen des Assets bereitgestellt.

Definieren eines Verarbeitungsprofils

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

Verarbeitungsprofil

  1. Melden Sie sich beim Author-Service von AEM as a Cloud Service als AEM-Admin an. Da es sich hierbei um ein Tutorial handelt, empfehlen wir die Verwendung einer Entwicklungsumgebung oder einer Umgebung in einer Sandbox.

  2. Gehen Sie zu Tools > Assets > Verarbeitungsprofile

  3. Klicken Sie auf die Schaltfläche Erstellen.

  4. Nennen Sie das Verarbeitungsprofil WKND Asset Renditions.

  5. Klicken Sie auf die Registerkarte Benutzerdefiniert und dann auf Neu hinzufügen.

  6. Definieren Sie den neuen Service:

    • Name der Ausgabedarstellung: Circle

      • Der Dateiname der Ausgabedarstellung, mit dem diese Ausgabedarstellung in AEM Assets identifiziert wird.
    • Erweiterung: png

      • Die Erweiterung der generierten Ausgabedarstellung. Legen Sie sie auf png fest, da dies das unterstützte Ausgabeformat ist, das der Webservice des Sekundärs unterstützt und das zu einem transparenten Hintergrund hinter dem ausgeschnittenen Kreis führt.
    • Endpunkt: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker

      • Dies ist die über aio app get-url abgerufene URL zum Sekundär. Stellen Sie sicher, dass die URL auf den richtigen Arbeitsbereich verweist, basierend auf der AEM as a Cloud Service-Umgebung.
      • Stellen Sie sicher, dass die Sekundär-URL auf den richtigen Arbeitsbereich verweist. Für das AEM as a Cloud Service-Staging sollte die URL des Staging-Arbeitsbereichs verwenden werden und für die AEM as a Cloud Service-Produktion die URL des Produktionsarbeitsbereichs.
    • Dienstparameter

      • Klicken Sie auf Parameter hinzufügen.

        • Schlüssel: size
        • Wert: 1000
      • Klicken Sie auf Parameter hinzufügen.

        • Schlüssel: contrast
        • Wert: 0.25
      • Klicken Sie auf Parameter hinzufügen.

        • Schlüssel: brightness
        • Wert: 0.10
      • Diese Schlüssel-Wert-Paare werden an den Asset Compute-Sekundär weitergegeben und sind über das JavaScript-Objekt rendition.instructions verfügbar.

    • MIME-Typen

      • Eingeschlossen: image/jpeg, image/png, image/gif, image/bmp, image/tiff
        • Diese MIME-Typen sind die einzigen, die in den npm-Modulen des Sekundärs enthalten sind. Diese Liste beschränkt, welche vom benutzerdefinierten Sekundär verarbeitet werden.
      • Ausgeschlossen: Leave blank
        • Verarbeiten Sie über diese Service-Konfiguration niemals Assets mit diesen MIME-Typen. In diesem Fall verwenden wir nur eine Zulassungsliste.
  7. Klicken Sie oben rechts auf Speichern.

Anwenden und Aufrufen eines Verarbeitungsprofils

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

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

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

  4. Navigieren Sie über AEM > Assets > Dateien zu dem Ordner, auf den das Verarbeitungsprofil nicht angewendet wurde, 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 mit dem angewandten Verarbeitungsprofil hoch und warten Sie, bis das hochgeladene Asset verarbeitet wird.

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

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

  8. Tippen Sie auf das Asset namens Circle.png und überprüfen Sie die generierte Ausgabedarstellung

    Generierte Ausgabedarstellung

Fertig!

Herzlichen Glückwunsch! Sie haben das Tutorial zur Erweiterung von Asset Compute-Microservices in AEM as a Cloud Service abgeschlossen! Sie sollten jetzt benutzerdefinierte Asset Compute-Sekundäre einrichten, entwickeln, testen, debuggen und bereitstellen können, die von Ihrem Author-Service in AEM as a Cloud Service verwendet werden.

Überprüfen Sie den vollständigen Quell-Code des Projekts auf Github.

Das fertige Asset Compute-Projekt ist auf Github verfügbar unter:

Github enthält den fertigen Status des Projekts, in dem es vollständig mit dem Sekundär und Testfällen gefüllt ist, jedoch keine Anmeldeinformationen enthält, d. h. .env, .config.json oder .aio.

Fehlerbehebung

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69