Utilizzare i microservizi per le risorse e i profili di elaborazione

I microservizi per le risorse forniscono un’elaborazione scalabile e resiliente delle risorse utilizzando applicazioni native per il cloud (o processi di lavoro). Adobe gestisce i servizi per una gestione ottimale dei diversi tipi di risorse e opzioni di elaborazione.

I microservizi per le risorse consentono di elaborare una vasta gamma di tipi di file che include più formati pronti all’uso rispetto alle versioni precedenti di Experience Manager. Ad esempio, è ora possibile estrarre le miniature dei formati PSD e PSB che in precedenza richiedevano soluzioni di terze parti come ImageMagick.

L’elaborazione delle risorse dipende dalla configurazione in Profili di elaborazione. Experience Manager fornisce una configurazione predefinita di base e consente agli amministratori di aggiungere una configurazione di elaborazione delle risorse più specifica. Gli amministratori creano, gestiscono e modificano le configurazioni dei flussi di lavoro di post-elaborazione, inclusa la personalizzazione facoltativa. La personalizzazione dei flussi di lavoro consente agli sviluppatori di estendere l’offerta predefinita.

Vista di alto livello sull’

NOTA

L’elaborazione delle risorse qui descritta sostituisce il modello di flusso di lavoro DAM Update Asset esistente nelle versioni precedenti di Experience Manager. La maggior parte dei passaggi standard relativi alla generazione del rendering e ai metadati viene sostituita dall’elaborazione dei microservizi per le risorse e gli eventuali passaggi rimanenti possono essere sostituiti dalla configurazione del flusso di lavoro di post-elaborazione.

Comprendere le opzioni di elaborazione delle risorse

L’Experience Manager consente i seguenti livelli di elaborazione.

Opzione Descrizione Casi d'uso coperti
Configurazione predefinita È disponibile così come è e non può essere modificata. Questa configurazione fornisce funzionalità di generazione del rendering di base.
  • Miniature standard utilizzate dall’ Assets interfaccia utente (48, 140 e 319 pixel)
  • Anteprima grande (rendering web - 1280 pixel)
  • Estrazione di metadati e testo.
Configurazione personalizzata Configurata dagli amministratori tramite l’interfaccia utente. Fornisce ulteriori opzioni per la generazione del rendering estendendo l'opzione predefinita. Estendi l’opzione preconfigurata per fornire formati e rappresentazioni diversi.
  • Rendering FPO.
  • Modificare il formato di file e la risoluzione delle immagini
  • Applicabile in modo condizionale ai tipi di file configurati.
Profilo personalizzato Configurato dagli amministratori tramite l'interfaccia utente per utilizzare il codice personalizzato tramite applicazioni personalizzate per chiamare Asset compute Service. Supporta requisiti più complessi in un metodo cloud-nativo e scalabile. Consulta casi d'uso consentiti.

Formati di file supportati

I microservizi per le risorse supportano un’ampia varietà di formati di file per elaborare, generare rappresentazioni o estrarre metadati. Consulta formati di file supportati per l'elenco completo dei tipi MIME e delle funzionalità supportate per ciascun tipo.

Configurazione predefinita

Alcuni valori predefiniti sono preconfigurati per garantire la disponibilità dei rendering predefiniti richiesti in Experience Manager. La configurazione predefinita garantisce inoltre la disponibilità delle operazioni di estrazione dei metadati e di estrazione del testo. Gli utenti possono iniziare a caricare o aggiornare le risorse immediatamente e l’elaborazione di base è disponibile per impostazione predefinita.

Con la configurazione predefinita, viene configurato solo il profilo di elaborazione più semplice. Tale profilo di elaborazione non è visibile sull’interfaccia utente e non è possibile modificarlo. Viene sempre eseguito l’elaborazione delle risorse caricate. Tale profilo di elaborazione predefinito assicura che l’elaborazione di base richiesta da Experience Manager sia completata su tutte le risorse.

Configurazione standard

Experience Manager fornisce funzionalità per generare rappresentazioni più specifiche per i formati comuni in base alle esigenze dell'utente. Un amministratore può creare Profili di elaborazione aggiuntivi per facilitare tale creazione di rendering. Gli utenti quindi assegnano uno o più profili disponibili a cartelle specifiche per eseguire l’elaborazione aggiuntiva. Ad esempio, l’elaborazione aggiuntiva può generare rappresentazioni per web, dispositivi mobili e tablet. Il video seguente illustra come creare e applicare Profili di elaborazione e come accedere alle rappresentazioni create.

  • Larghezza e altezza del rendering: Le specifiche relative a larghezza e altezza del rendering forniscono le dimensioni massime dell'immagine di output generata. I microservizi per le risorse cercano di produrre il rendering più grande possibile, che larghezza e altezza non sono rispettivamente più grandi della larghezza e dell’altezza specificate. Il rapporto di formato viene mantenuto, ovvero lo stesso dell'originale. Un valore vuoto indica che l’elaborazione delle risorse assume la dimensione in pixel dell’originale.

  • Regole di inclusione di tipo MIME: Quando viene elaborata una risorsa con un tipo MIME specifico, il tipo MIME viene prima controllato rispetto al valore dei tipi MIME esclusi per la specifica di rendering. Se corrisponde a tale elenco, questo rendering specifico non viene generato per la risorsa (ad elenco Bloccati). In caso contrario, il tipo MIME viene controllato rispetto al tipo MIME incluso e, se corrisponde all’elenco, il rendering viene generato (elenco Consentiti).

  • Rendering FPO speciale: Quando si inseriscono risorse di grandi dimensioni da Experience Manager a Adobe InDesign documenti, un professionista aspetta un notevole tempo dopo aver inserito una risorsa. Nel frattempo, all'utente è impedito di utilizzare InDesign. Questo interrompe il flusso creativo e influisce negativamente sull’esperienza utente. L’Adobe consente di iniziare temporaneamente il posizionamento di rappresentazioni di piccole dimensioni nei documenti InDesign, che possono essere sostituiti successivamente con risorse a risoluzione completa su richiesta. Experience Manager fornisce rappresentazioni utilizzate solo per il posizionamento (FPO). Queste rappresentazioni FPO hanno dimensioni file ridotte ma hanno le stesse proporzioni.

Il profilo di elaborazione può includere un rendering FPO (solo posizionamento). Per informazioni su come attivarlo per il profilo di elaborazione, consulta Adobe Asset Link documentazione . Per ulteriori informazioni, consulta la documentazione completa di Adobe Asset Link.

Creare un profilo standard

Per creare un profilo di elaborazione standard, effettua le seguenti operazioni:

  1. Gli amministratori accedono a Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

  2. Specifica un nome che ti aiuti a identificare in modo univoco il profilo quando lo applichi a una cartella.

  3. Per generare rappresentazioni FPO, nella scheda Standard abilita Crea rappresentazione FPO. Immettere un valore Quality compreso tra 1 e 100.

  4. Per generare altre rappresentazioni, fai clic su Aggiungi nuovo e fornisci le seguenti informazioni:

    • Nome file di ogni rendering.
    • Formato di file (PNG, JPEG, GIF o WebP) di ogni rendering.
    • Larghezza e altezza in pixel di ciascuna rappresentazione. Se i valori non sono specificati, viene utilizzata la dimensione in pixel dell'immagine originale.
    • Qualità in percentuale di ogni rendering JPEG e WebP.
    • Tipi MIME inclusi ed esclusi per definire l’applicabilità di un profilo.

    elaborazione-profili-aggiunta

  5. Fai clic su Salva.

Casi di utilizzo e profilo personalizzati

Asset Compute Service supporta diversi casi d’uso, ad esempio l’elaborazione predefinita, l’elaborazione di formati specifici per Adobi come i file Photoshop e l’implementazione di un’elaborazione personalizzata o specifica per l’organizzazione. La personalizzazione del flusso di lavoro Risorsa di aggiornamento DAM richiesta in passato viene gestita automaticamente o tramite la configurazione dei profili di elaborazione. Se queste opzioni di elaborazione non soddisfano le esigenze aziendali, Adobe consiglia di sviluppare e utilizzare Asset Compute Service per estendere le funzionalità predefinite. Per una panoramica, consulta comprendere l'estensibilità e quando usarla.

NOTA

Adobe consiglia di utilizzare un’applicazione personalizzata solo quando i requisiti aziendali non possono essere soddisfatti utilizzando le configurazioni predefinite o il profilo standard.

Può trasformare immagini, video, documenti e altri formati di file in diverse rappresentazioni, quali miniature, testo e metadati estratti e archivi.

Gli sviluppatori possono utilizzare Asset Compute Service per creare applicazioni personalizzate per i casi di utilizzo supportati. Experience Manager può chiamare queste applicazioni personalizzate dall’interfaccia utente utilizzando profili personalizzati configurati dagli amministratori. Asset Compute Service supporta i seguenti casi d’uso per richiamare servizi esterni:

  • Utilizza Adobe Photoshop's ImageCutout API e salva il risultato come rendering.
  • Invoca sistemi di terze parti per aggiornare i dati, ad esempio un sistema PIM.
  • Utilizza l’ API Photoshop per generare diverse rappresentazioni basate sul modello Photoshop.
  • Utilizza Adobe Lightroom API per ottimizzare le risorse acquisite e salvarle come rappresentazioni.
NOTA

Non è possibile modificare i metadati standard utilizzando le applicazioni personalizzate. Puoi modificare solo i metadati personalizzati.

Creare un profilo personalizzato

Per creare un profilo personalizzato, effettua le seguenti operazioni:

  1. Gli amministratori accedono a Strumenti > Risorse > Profili di elaborazione. Fai clic su Crea.

  2. Fare clic sulla scheda Personalizzato. Fare clic su Aggiungi nuovo. Specifica il nome file desiderato per il rendering.

  3. Fornisci le seguenti informazioni.

    Fai clic su Salva.

Le applicazioni personalizzate sono applicazioni headless Project Firefly. L'applicazione personalizzata ottiene tutti i file forniti se sono configurati con un profilo di elaborazione. L'applicazione deve filtrare i file.

ATTENZIONE

Se l’app Firefly e l’account Experience Manager non appartengono alla stessa organizzazione, l’integrazione non funziona.

Esempio di profilo personalizzato

Per illustrare l’utilizzo del profilo personalizzato, consideriamo un caso d’uso per applicare del testo personalizzato alle immagini della campagna. Puoi creare un profilo di elaborazione che sfrutta l’API Photoshop per modificare le immagini.

L’integrazione di Asset compute Service consente ad Experience Manager di trasmettere questi parametri all’applicazione personalizzata utilizzando il campo Parametri di servizio . L’applicazione personalizzata chiama quindi l’API Photoshop e trasmette questi valori all’API. Ad esempio, puoi passare il nome del font, il colore del testo, il peso del testo e le dimensioni del testo per aggiungere il testo personalizzato alle immagini della campagna.

profilo di elaborazione personalizzato

Figura: Utilizza il campo Service Parameters (Parametri del servizio) per trasmettere informazioni aggiunte ai parametri predefiniti generati nell'applicazione personalizzata. In questo esempio, quando le immagini della campagna vengono caricate, le immagini vengono aggiornate con il testo Jumanji nel font Arial-BoldMT.

Utilizzare i profili di elaborazione per elaborare le risorse

Crea e applica i profili di elaborazione aggiuntivi e personalizzati a cartelle specifiche, ad Experience Manager per elaborare le risorse caricate o aggiornate in queste cartelle. Il profilo di elaborazione standard predefinito viene sempre eseguito ma non è visibile nell’interfaccia utente. Se aggiungi un profilo personalizzato, entrambi i profili vengono utilizzati per elaborare le risorse caricate.

Applica i profili di elaborazione alle cartelle utilizzando uno dei seguenti metodi:

  • Gli amministratori possono selezionare una definizione di profilo di elaborazione in Strumenti > Risorse > Profili di elaborazione e utilizzare l'azione Applica profilo a cartelle. Apre un browser dei contenuti che ti consente di navigare in cartelle specifiche, selezionarle e confermare l’applicazione del profilo.
  • Gli utenti possono selezionare una cartella nell’interfaccia utente Assets, utilizzare l’azione Proprietà per aprire la schermata delle proprietà della cartella, fare clic sulla scheda Profili elaborazione e selezionare il profilo di elaborazione appropriato per tale cartella nell’elenco a comparsa. Per salvare le modifiche, fai clic su Salva e chiudi.
    Applicare un profilo di elaborazione a una cartella dalla scheda Proprietà risorsa
SUGGERIMENTO

A una cartella può essere applicato un solo profilo di elaborazione. Per generare più rendering, aggiungi più definizioni di rendering al profilo di elaborazione esistente.

Dopo aver applicato un profilo di elaborazione a una cartella, tutte le nuove risorse caricate (o aggiornate) in questa cartella o in una delle relative sottocartelle vengono elaborate utilizzando il profilo di elaborazione aggiuntivo configurato. Questa elaborazione si aggiunge al profilo predefinito standard.

NOTA

Un profilo di elaborazione applicato a una cartella funziona per l’intero albero, ma può essere sostituito con un altro profilo applicato a una sottocartella. Quando le risorse vengono caricate in una cartella, Experience Manager controlla le proprietà della cartella contenitore per un profilo di elaborazione. Se non viene applicata alcuna applicazione, viene controllata una cartella padre nella gerarchia per verificare la presenza di un profilo di elaborazione da applicare.

Per verificare che le risorse siano state elaborate, visualizza in anteprima le rappresentazioni generate nella vista Rappresentazioni nella barra a sinistra. Apri l’anteprima delle risorse e apri la barra a sinistra per accedere alla vista Rendering . Le rappresentazioni specifiche nel profilo di elaborazione, per le quali il tipo di risorsa specifico corrisponde alle regole di inclusione del tipo MIME, devono essere visibili e accessibili.

rappresentazioni aggiuntive

Figura: Esempio di due rappresentazioni aggiuntive generate da un profilo di elaborazione applicato alla cartella principale.

Flussi di lavoro di post-elaborazione

In una situazione in cui è necessaria un’elaborazione aggiuntiva delle risorse che non può essere ottenuta utilizzando i profili di elaborazione, è possibile aggiungere alla configurazione flussi di lavoro aggiuntivi di post-elaborazione. Questo consente di aggiungere un’elaborazione completamente personalizzata all’elaborazione configurabile tramite i microservizi per le risorse.

I flussi di lavoro di post-elaborazione, se configurati, vengono eseguiti automaticamente da Experience Manager al termine dell'elaborazione dei microservizi. Non è necessario aggiungere manualmente i moduli di avvio del flusso di lavoro per attivare i flussi di lavoro. Gli esempi includono:

  • Passaggi del flusso di lavoro personalizzati per elaborare le risorse.
  • Integrazioni per aggiungere metadati o proprietà alle risorse da sistemi esterni, ad esempio informazioni su prodotti o processi.
  • Elaborazione aggiuntiva eseguita da servizi esterni.

Per aggiungere una configurazione di flusso di lavoro post-elaborazione a Experience Manager, effettua le seguenti operazioni:

  • Crea uno o più modelli di flusso di lavoro. In questa documentazione, questi modelli personalizzati sono denominati modelli di flusso di lavoro post-elaborazione . Si tratta dei normali modelli di flusso di lavoro Experience Manager .
  • Aggiungi i passaggi del flusso di lavoro richiesti a questi modelli. Esamina i passaggi dal flusso di lavoro predefinito e aggiungi tutti i passaggi predefiniti richiesti al flusso di lavoro personalizzato. I passaggi vengono eseguiti sulle risorse in base alla configurazione di un modello di flusso di lavoro. Ad esempio, se desideri che l’assegnazione tag avanzati avvenga automaticamente al momento del caricamento delle risorse, aggiungi il passaggio al modello di flusso di lavoro di post-elaborazione personalizzato.
  • Aggiungi il passaggio DAM Update Asset Workflow Completed Process alla fine. L’aggiunta di questo passaggio garantisce che l’Experience Manager sappia quando termina l’elaborazione e che la risorsa possa essere contrassegnata come elaborata, ovvero Nuova venga visualizzata sulla risorsa.
  • Crea una configurazione per il servizio Custom Workflow Runner Service che consente di configurare l’esecuzione di un modello di flusso di lavoro post-elaborazione tramite un percorso (posizione della cartella) o tramite un’espressione regolare.

Creare modelli di flusso di lavoro di post-elaborazione

I modelli di flusso di lavoro di post-elaborazione sono normali Experience Manager modelli di flusso di lavoro. Crea modelli diversi se hai bisogno di un’elaborazione diversa per posizioni di archivio o tipi di risorse diversi.

Le fasi di elaborazione devono essere aggiunte in base alle esigenze. Puoi utilizzare tutti i passaggi supportati disponibili, nonché tutti i passaggi del flusso di lavoro implementati su misura.

Assicurati che l’ultimo passaggio di ogni flusso di lavoro di post-elaborazione sia DAM Update Asset Workflow Completed Process. L’ultimo passaggio consente ad Experience Manager di sapere quando viene completata l’elaborazione delle risorse.

Configurare l’esecuzione del flusso di lavoro di post-elaborazione

Per configurare i modelli di flusso di lavoro di post-elaborazione da eseguire per le risorse caricate o aggiornate nel sistema al termine dell’elaborazione dei microservizi per le risorse, è necessario configurare il servizio Flusso di lavoro personalizzato.

Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) è un servizio OSGi e fornisce due opzioni di configurazione:

  • Flussi di lavoro di post-elaborazione per percorso (postProcWorkflowsByPath): È possibile elencare più modelli di flusso di lavoro, basati su diversi percorsi di archivio. I percorsi e i modelli devono essere separati da due punti. Sono supportati percorsi di archivio semplici e devono essere mappati su un modello di flusso di lavoro nel percorso /var . Esempio: /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Flussi di lavoro di post-elaborazione per espressione (postProcWorkflowsByExpression): È possibile elencare più modelli di flusso di lavoro, in base a diverse espressioni regolari. Le espressioni e i modelli devono essere separati da due punti. L’espressione regolare deve puntare direttamente al nodo Asset e non a una delle rappresentazioni o dei file. Esempio: /content/dam(/.*/?lang=it)(marketing/seasonal)(/.*?lang=it):/var/workflow/models/my-workflow.
NOTA

La configurazione di Custom Workflow Runner è una configurazione di un servizio OSGi. Per informazioni su come distribuire una configurazione OSGi, consulta distribuzione in Experience Manager .
La console Web OSGi, a differenza delle distribuzioni di servizi on-premise e gestiti di Experience Manager, non è direttamente disponibile nelle distribuzioni di servizi cloud.

Per informazioni dettagliate su quale passaggio del flusso di lavoro standard può essere utilizzato nel flusso di lavoro di post-elaborazione, vedi passaggi del flusso di lavoro nel flusso di lavoro di post-elaborazione nella guida per gli sviluppatori.

Best practice e limitazioni

  • Considera le tue esigenze per tutti i tipi di rendering durante la progettazione dei flussi di lavoro. Se non prevedete la necessità di un rendering in futuro, rimuovete il relativo passaggio di creazione dal flusso di lavoro. Le rappresentazioni non possono essere eliminate in blocco in seguito. Le rappresentazioni indesiderate possono occupare molto spazio di archiviazione dopo un uso prolungato di Experience Manager. Per le singole risorse, puoi rimuovere manualmente i rendering dall’interfaccia utente. Per più risorse, puoi personalizzare Experience Manager per eliminare rappresentazioni specifiche oppure eliminare le risorse e caricarle di nuovo.
  • Al momento, il supporto è limitato alla generazione di rappresentazioni. La generazione di nuove risorse non è supportata.
  • Attualmente, il limite di dimensione del file per l’estrazione dei metadati è di circa 10 GB. Quando si caricano risorse di grandi dimensioni, a volte l’operazione di estrazione dei metadati non riesce.

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now