Integrare con i profili di elaborazione dell’AEM

Ultimo aggiornamento: 2024-01-26
  • Creato per:
  • Intermediate
    Experienced
    Developer

Ad Asset compute, per generare rappresentazioni personalizzate in AEM as a Cloud Service, i processi di lavoro devono essere registrati nel servizio AEM as a Cloud Service Author tramite Profili di elaborazione. Tutte le risorse soggette a tale profilo di elaborazione avranno il lavoratore richiamato al momento del caricamento o della rielaborazione e avranno la rappresentazione personalizzata generata e resa disponibile tramite le rappresentazioni della risorsa.

Definire un profilo di elaborazione

Crea innanzitutto un nuovo Profilo di elaborazione che richiamerà il processo di lavoro con i parametri configurabili.

Profilo di elaborazione

  1. Accedi al servizio di authoring as a Cloud Service dell’AEM come Amministratore AEM. Trattandosi di un’esercitazione, consigliamo di utilizzare un ambiente di sviluppo o un ambiente in una sandbox.
  2. Accedi a Strumenti > Risorse > Profili elaborazione
  3. Tocca Crea pulsante
  4. Denomina il profilo di elaborazione, WKND Asset Renditions
  5. Tocca il Personalizzato , quindi tocca Aggiungi nuovo
  6. Definisci il nuovo servizio
    • Nome rappresentazione: Circle
      • Nome file della rappresentazione utilizzato per identificare la rappresentazione in AEM Assets
    • Estensione: png
      • Estensione della rappresentazione generata. Imposta su png poiché questo è il formato di output supportato dal servizio web del lavoratore e risulta in uno sfondo trasparente dietro il ritaglio del cerchio.
    • Endpoint: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker
      • Questo è l’URL del lavoratore ottenuto tramite aio app get-url. Assicurati che l’URL punti nell’area di lavoro corretta in base all’ambiente as a Cloud Service dall’AEM.
      • Assicurarsi che l'URL del lavoratore punti all'area di lavoro corretta. Lo stage as a Cloud Service da AEM deve utilizzare l’URL dell’area di lavoro dello stage e la produzione as a Cloud Service da AEM deve utilizzare l’URL dell’area di lavoro di produzione.
    • Parametri del servizio
      • Tocca Aggiungi parametro
        • Chiave: size
        • Valore: 1000
      • Tocca Aggiungi parametro
        • Chiave: contrast
        • Valore: 0.25
      • Tocca Aggiungi parametro
        • Chiave: brightness
        • Valore: 0.10
      • Queste coppie chiave/valore vengono passate nel processo di lavoro Asset compute e sono disponibili tramite rendition.instructions Oggetto JavaScript.
    • Tipi MIME
      • Include: image/jpeg, image/png, image/gif, image/bmp, image/tiff
        • Questi tipi MIME sono gli unici moduli npm del lavoratore. Questo elenco limita i valori elaborati dal lavoratore personalizzato.
      • Esclusi: Leave blank
        • Non elaborare mai le risorse con questi tipi MIME utilizzando questa configurazione del servizio. In questo caso, utilizziamo solo un elenco consentiti.
  7. Tocca Salva in alto a destra

Applicare e richiamare un profilo di elaborazione

  1. Seleziona il profilo di elaborazione appena creato, WKND Asset Renditions

  2. Tocca Applica profilo a cartelle nella barra delle azioni superiore

  3. Seleziona una cartella a cui applicare il profilo di elaborazione, ad esempio WKND e tocca Applica

  4. Passa alla cartella a cui non è stato applicato il profilo di elaborazione tramite AEM > Risorse > File e tocca in WKND.

  5. Carica alcune nuove risorse immagini (sample-1.jpg, sample-2.jpg, e sample-3.jpg) in qualsiasi cartella della cartella in cui è applicato il profilo di elaborazione e attendi l’elaborazione della risorsa caricata.

  6. Tocca la risorsa per aprirne i dettagli

    • Le rappresentazioni predefinite possono essere generate e visualizzate più rapidamente in AEM rispetto alle rappresentazioni personalizzate.
  7. Apri Rappresentazioni vista dalla barra laterale a sinistra

  8. Tocca la risorsa denominata Circle.png e rivedere la rappresentazione generata

    Rappresentazione generata

Finito!

Congratulazioni. Hai terminato il esercitazione su come estendere i microservizi Asset compute as a Cloud Service AEM! Ora dovresti avere la possibilità di configurare, sviluppare, testare, eseguire il debug e distribuire processi di lavoro di Asset compute personalizzati per l’utilizzo da parte del servizio di authoring as a Cloud Service dell’AEM.

Verifica il codice sorgente completo del progetto su Github

L’ultimo progetto di Asset compute è disponibile su Github all’indirizzo:

Github contains è lo stato finale del progetto, completamente popolato con i casi di lavoro e test, ma non contiene credenziali, ad esempio. .env, .config.json o .aio.

Risoluzione dei problemi

In questa pagina