Utilizzare i microservizi delle 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, l’estrazione delle miniature dei formati PSD e PSB è ora possibile, ma in precedenza è necessaria una soluzione 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.

Comprendere le opzioni di elaborazione delle risorse

Experience Manager consente i seguenti livelli di elaborazione.

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 Immagine 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.

   

5. Fai clic su Salva.

Casi di utilizzo e di 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.

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.

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.

   • Nome file di ogni rendering e estensione file supportata.
   • URL punto finale di un’app personalizzata Firefly. L'app deve provenire dalla stessa organizzazione dell'account Experience Manager.
   • Aggiungi i parametri del servizio a trasmettere informazioni o parametri aggiuntivi all'applicazione personalizzata.
   • Tipi MIME inclusi ed esclusi per limitare l’elaborazione ad alcuni formati di file specifici.

   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.

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.

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 Elaborazione risorse e, nell’elenco Profilo elaborazione, selezionare il profilo di elaborazione appropriato per tale cartella. Per salvare le modifiche, fai clic su Salva e chiudi.
  

• Gli utenti possono selezionare cartelle o risorse specifiche nell’interfaccia utente di Assets per applicare un profilo di elaborazione, quindi selezionare l’opzione Rielabora risorse tra le opzioni disponibili nella parte superiore.

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.

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.

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. La post-elaborazione consente di aggiungere un’elaborazione completamente personalizzata oltre 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.

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.

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 vengono aggiunte in base alle esigenze. Puoi utilizzare entrambi i passaggi supportati disponibili, nonché tutti i passaggi del flusso di lavoro implementati personalizzati.

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

Al termine dell’elaborazione delle risorse caricate, i microservizi per le risorse possono definire il flusso di lavoro di post-elaborazione per elaborare ulteriormente le risorse. Per configurare la post-elaborazione utilizzando i modelli di flusso di lavoro, puoi effettuare una delle seguenti operazioni:

• Applicare un modello di flusso di lavoro in Proprietà cartella.
• Configura il servizio Flusso di lavoro personalizzato Runner.

Applicare un modello di flusso di lavoro a una cartella

Per i casi d’uso tipici di post-elaborazione, considera l’utilizzo del metodo per applicare un flusso di lavoro a una cartella. Per applicare un modello di flusso di lavoro nella cartella Proprietà, segui questi passaggi:

1. Crea un modello di flusso di lavoro.

2. Seleziona una cartella, fai clic su Proprietà nella barra degli strumenti, quindi fai clic sulla scheda Elaborazione risorse .

3. In Flusso di lavoro con avvio automatico, seleziona il flusso di lavoro richiesto, fornisci un titolo del flusso di lavoro e quindi salva le modifiche.

   

Configurare il servizio Workflow Runner personalizzato

Puoi configurare il servizio di esecuzione dei flussi di lavoro personalizzato per le configurazioni avanzate che non possono essere facilmente soddisfatte applicando un flusso di lavoro a una cartella. Ad esempio, un flusso di lavoro che utilizza un’espressione regolare. Adobe CQ DAM Custom Workflow Runner (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) è un servizio OSGi. Fornisce le due opzioni seguenti per la configurazione:

• Flussi di lavoro di post-elaborazione per percorso (postProcWorkflowsByPath): È possibile elencare più modelli di flusso di lavoro, basati su diversi percorsi di archivio. Separa i percorsi e i modelli utilizzando due punti. Sono supportati percorsi archivio semplici. Mappa questi elementi 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(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

Per informazioni su come distribuire una configurazione OSGi, consulta distribuire su Experience Manager.

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 15 GB. Quando si caricano risorse di grandi dimensioni, a volte l’operazione di estrazione dei metadati non riesce.