Documentazione AEM as a Cloud Service Guida utente

Utilizzare i microservizi delle risorse e i profili di elaborazione get-started-using-asset-microservices

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

Sviluppatore
Amministratore

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

I microservizi per le risorse consentono di elaborare un'ampia gamma di tipi di file che coprono più formati predefiniti rispetto alle versioni precedenti di Experience Manager. Ad esempio, è ora possibile estrarre le miniature dei formati PSD e PSB, ma in precedenza richiedevano soluzioni di terze parti come ImageMagick.

L'elaborazione delle risorse dipende dalla configurazione in Profili elaborazione. In questo Experience Manager viene fornita una configurazione di base predefinita che consente agli amministratori di aggiungere una configurazione di elaborazione delle risorse più specifica. Gli amministratori possono creare, gestire e modificare 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.

Visualizzazione di alto livello dell'elaborazione delle risorse

NOTE

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 di rendering e ai metadati vengono sostituiti dall’elaborazione dei microservizi per le risorse; i passaggi rimanenti, se presenti, possono essere sostituiti dalla configurazione del flusso di lavoro di post-elaborazione.

Comprendere le opzioni di elaborazione delle risorse get-started

Experience Manager consente i seguenti livelli di elaborazione.

Opzione

Descrizione

Casi d’uso trattati

Configurazione predefinita

È disponibile così com’è e non può essere modificato. Questa configurazione fornisce funzionalità di base per la generazione delle rappresentazioni.

Miniature standard utilizzate dall'interfaccia utente Assets (48, 140 e 319 pixel)
Anteprima grande (rappresentazione web - 1280 pixel)
Estrazione di metadati e testo.

Configurazione personalizzata

Configurato dagli amministratori tramite l’interfaccia utente di. Fornisce ulteriori opzioni per la generazione della copia trasformata estendendo l'opzione predefinita. Estendi l’opzione predefinita per fornire formati e rappresentazioni diversi.

Rendering FPO.
Modificare il formato 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 il servizio Asset Compute. Supporta requisiti più complessi in un metodo scalabile e nativo per il cloud.

Vedi casi d'uso consentiti.

Formati di file supportati supported-file-formats

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 default-config

Alcune impostazioni predefinite sono preconfigurate per garantire la disponibilità delle rappresentazioni predefinite richieste in Experience Manager. La configurazione predefinita garantisce anche la disponibilità delle operazioni di estrazione dei metadati e 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 di base. Tale profilo di elaborazione non è visibile nell’interfaccia utente e non è possibile modificarlo. Viene sempre eseguito per elaborare le risorse caricate. Questo profilo di elaborazione predefinito garantisce il completamento dell'elaborazione di base richiesta da Experience Manager per tutte le risorse.

Configurazione standard standard-config

Experience Manager forniscono funzionalità per generare rappresentazioni più specifiche per i formati comuni in base alle esigenze dell'utente. Un amministratore può creare ulteriori profili di elaborazione per facilitare la creazione di copie trasformate. Gli utenti assegnano quindi 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. Nel video seguente viene illustrato come creare e applicare Profili di elaborazione e come accedere alle rappresentazioni create.

Larghezza e altezza rappresentazione: le specifiche di larghezza e altezza della rappresentazione forniscono le dimensioni massime dell'immagine di output generata. I microservizi per le risorse tentano di produrre la rappresentazione più grande possibile, con larghezza e altezza non superiori a quelle specificate, rispettivamente. Le proporzioni vengono mantenute, ovvero sono identiche a quelle dell'originale. Un valore vuoto indica che l’elaborazione delle risorse assume la dimensione in pixel dell’originale.
Regole di inclusione del 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 della rappresentazione. Se corrisponde a tale elenco, la rappresentazione specifica non viene generata per la risorsa (elenco Bloccati). In caso contrario, il tipo MIME viene confrontato con il tipo MIME incluso e, se corrisponde all’elenco, viene generata la rappresentazione (elenco Consentiti).
Rendering FPO speciale: quando si inseriscono risorse di grandi dimensioni da Experience Manager in Adobe InDesign documenti, un professionista del settore creativo attende molto tempo dopo aver inserito una risorsa. Nel frattempo, l'utente non può utilizzare InDesign. Questo interrompe il flusso creativo e influisce negativamente sull’esperienza utente. Adobe consente di inserire temporaneamente rappresentazioni di piccole dimensioni in InDesign documenti, che possono essere sostituiti da risorse a risoluzione completa su richiesta in un secondo momento. Experience Manager fornisce copie trasformate utilizzate solo per il posizionamento (FPO). Queste copie trasformate FPO hanno dimensioni di file ridotte ma hanno le stesse proporzioni.

Il profilo di elaborazione può includere una rappresentazione FPO (solo per posizionamento). Consulta la Adobe Asset Link documentazione per capire se devi attivarla per il tuo profilo di elaborazione. Per ulteriori informazioni, consulta Documentazione completa di Adobe Asset Link.

Creare un profilo standard create-standard-profile

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

Gli amministratori accedono a Strumenti > Assets > Profili di elaborazione. Fai clic su Crea.
Specifica un nome che ti aiuti a identificare in modo univoco il profilo quando applichi a una cartella.
Per generare le rappresentazioni dell'oggetto Criteri di gruppo, nella scheda Immagine abilitare Crea rappresentazione oggetto Criteri di gruppo. Inserisci un valore Quality da 1 a 100.
Per generare altre copie trasformate, fare clic su Aggiungi nuovo e fornire le seguenti informazioni:
- Nome file di ciascuna rappresentazione.
- Formato file (PNG, JPEG, GIF o WebP) di ciascuna copia trasformata.
- Larghezza e altezza in pixel di ciascuna rappresentazione. Se i valori non sono specificati, viene utilizzata la dimensione in pixel completa dell'immagine originale.
- Qualità in percentuale di ogni rappresentazione di JPEG e WebP.
- Tipi MIME inclusi ed esclusi per definire l’applicabilità di un profilo.
Fai clic su Salva.

Profilo personalizzato e casi d’uso custom-config

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

NOTE

L’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, tra cui miniature, testo e metadati estratti e archivi.

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

Utilizza l'API ImageCutout di Adobe Photoshop e salva il risultato come rappresentazione.
Chiama i 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 API Adobe Lightroom per ottimizzare le risorse acquisite e salvarle come rappresentazioni.

NOTE

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

Creare un profilo personalizzato create-custom-profile

Per creare un profilo personalizzato, segui questi passaggi:

Gli amministratori accedono a Strumenti > Assets > Profili di elaborazione. Fai clic su Crea.
Fare clic sulla scheda Personalizzato. Fare clic su Aggiungi nuovo. Specifica il nome file desiderato per la rappresentazione.
Fornisci le seguenti informazioni.
- Nome file di ciascuna copia trasformata e estensione di file supportata.
- URL dell'endpoint di un'app personalizzata App Builder. L’app deve appartenere alla stessa organizzazione dell’account di Experience Manager.
- Aggiungere parametri di servizio a passare ulteriori informazioni o parametri 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 app Project App Builder headless. L’applicazione personalizzata ottiene tutti i file forniti se sono configurati con un profilo di elaborazione. L'applicazione deve filtrare i file.

CAUTION

Se l'app App Builder e l'account Experience Manager non appartengono alla stessa organizzazione, l'integrazione non funziona.

Esempio di profilo personalizzato custom-profile-example

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 utilizza l’API Photoshop per modificare le immagini.

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

profilo-elaborazione-personalizzato

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

Utilizzare i profili di elaborazione per elaborare le risorse use-profiles

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 metodi seguenti:

Gli amministratori possono selezionare una definizione di profilo di elaborazione in Strumenti > Assets > Profili di elaborazione e utilizzare l'azione Applica profilo alle cartelle. Viene aperto un browser dei contenuti che consente di passare a cartelle specifiche, selezionarle e confermare l’applicazione del profilo.
Gli utenti possono selezionare una cartella nell'interfaccia utente di Assets, utilizzare l'azione Proprietà per aprire la schermata delle proprietà della cartella, fare clic sulla scheda Elaborazione risorse e nell'elenco Profilo di 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 Opzione Rielabora Assets tra le opzioni disponibili nella parte superiore.

TIP

A una cartella è possibile applicare un solo profilo di elaborazione. Per generare più rappresentazioni, aggiungi altre definizioni di rappresentazione 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 sue sottocartelle vengono elaborate utilizzando il profilo di elaborazione aggiuntivo configurato. Questa elaborazione si aggiunge al profilo predefinito standard.

NOTE

Un profilo di elaborazione applicato a una cartella funziona per l’intera struttura, 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 individuare un profilo di elaborazione. Se nessun profilo è applicato, viene selezionata una cartella principale nella gerarchia per un profilo di elaborazione da applicare.

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

copie trasformate aggiuntive

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

Flussi di lavoro di elaborazione Post post-processing-workflows

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 ulteriori flussi di lavoro di post-elaborazione. L’elaborazione Post consente di aggiungere un’elaborazione completamente personalizzata oltre a quella configurabile utilizzando i microservizi per le risorse.

I flussi di lavoro di elaborazione Post o Avvio automatico del flusso di lavoro, se configurato, vengono eseguiti automaticamente da Experience Manager al termine dell'elaborazione dei microservizi. Non è necessario aggiungere manualmente moduli di avvio dei flussi di lavoro per attivarli. Gli esempi includono:

Passaggi personalizzati del flusso di lavoro 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 del flusso di lavoro di post-elaborazione a Experience Manager, eseguire la procedura seguente:

Crea uno o più modelli di flusso di lavoro. In questa documentazione questi modelli personalizzati sono denominati modelli di flusso di lavoro di post-elaborazione. Si tratta di Experience Manager modelli di flusso di lavoro regolari.
Aggiungi i passaggi del flusso di lavoro richiesti a questi modelli. Esamina i passaggi del 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 caricamento delle risorse, aggiungi il passaggio al modello di flusso di lavoro di post-elaborazione personalizzato.
Aggiunta del passaggio Flusso di lavoro risorse di aggiornamento DAM completato alla fine. L'aggiunta di questo passaggio assicura che Experience Manager sappia quando termina l'elaborazione e che la risorsa possa essere contrassegnata come elaborata, ovvero Nuova visualizzata sulla risorsa.
Crea una configurazione per il servizio Custom Workflow Runner che consenta di configurare l’esecuzione di un modello di flusso di lavoro di post-elaborazione in base a un percorso (percorso cartella) o a un’espressione regolare.

Per informazioni dettagliate sul passaggio del flusso di lavoro standard che può essere utilizzato nel flusso di lavoro di post-elaborazione, vedere passaggi del flusso di lavoro di post-elaborazione nella documentazione per gli sviluppatori.

Creare modelli di flusso di lavoro di post-elaborazione create-post-processing-workflow-models

I modelli di flusso di lavoro di elaborazione Post sono Experience Manager modelli di flusso di lavoro regolari. Se hai bisogno di un’elaborazione diversa per posizioni di archivio o tipi di risorse diversi, puoi creare modelli diversi.

I passaggi di elaborazione vengono aggiunti in base alle esigenze. Puoi utilizzare sia i passaggi supportati disponibili, sia tutti i passaggi del flusso di lavoro implementati in modo personalizzato.

Verificare 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 è stata completata l’elaborazione delle risorse.

Configurare l’esecuzione di un flusso di lavoro di post-elaborazione configure-post-processing-workflow-execution

Una volta completata l’elaborazione delle risorse caricate, i microservizi per le risorse possono definire un flusso di lavoro di post-elaborazione per elaborare ulteriormente le risorse. Per configurare la post-elaborazione utilizzando i modelli di flusso di lavoro, effettuate una delle seguenti operazioni:

Applica un modello di flusso di lavoro nelle proprietà della cartella.
Configurare il servizio Workflow Runner personalizzato.

Applicare un modello di flusso di lavoro a una cartella apply-workflow-model-to-folder

Per i casi di utilizzo 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à, eseguire la procedura seguente:

Crea un modello di flusso di lavoro.
Selezionare una cartella, fare clic su Proprietà nella barra degli strumenti e quindi fare clic sulla scheda Elaborazione Assets.
In Avvia flusso di lavoro automatico, selezionare il flusso di lavoro richiesto, fornire un titolo del flusso di lavoro, quindi salvare le modifiche.

Configurare il servizio Workflow Runner personalizzato configure-custom-workflow-runner-service

Puoi configurare il servizio runner flusso 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. Per la configurazione sono disponibili le due opzioni seguenti:

Flussi di lavoro di elaborazione Post per percorso (postProcWorkflowsByPath): è possibile elencare più modelli di flusso di lavoro, in base a percorsi di archivio diversi. Separa i percorsi e i modelli utilizzando i due punti. Sono supportati percorsi di archivio semplici. Mappare questi a un modello di flusso di lavoro nel percorso /var. Ad esempio: /content/dam/my-brand:/var/workflow/models/my-workflow.
Flussi di lavoro di elaborazione Post per espressione (postProcWorkflowsByExpression): è possibile elencare più modelli di flusso di lavoro, in base a espressioni regolari diverse. Le espressioni e i modelli devono essere separati da due punti. L’espressione regolare deve puntare direttamente al nodo Risorsa e non a uno dei rendering o dei file. Ad esempio: /content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow.

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

Disattiva esecuzione flusso di lavoro di post-elaborazione

Se la post-elaborazione non è necessaria, creare e utilizzare un modello di flusso di lavoro "vuoto" nella selezione Avvia automaticamente flusso di lavoro.

Creare il modello di flusso di lavoro con avvio automatico disattivato

Passa a Strumenti > Flusso di lavoro > Modelli
Seleziona Crea > Crea modello dalla barra delle azioni superiore
Specifica un titolo e un nome per il nuovo modello di flusso di lavoro, ad esempio:
- Titolo: Disabilita flusso di lavoro con avvio automatico
- Nome: disable-auto-start-workflow
Seleziona Fine per creare il modello di flusso di lavoro
Seleziona e Modifica il modello di flusso di lavoro creato
Nell'editor modelli flusso di lavoro, selezionare Passaggio 1 dalla definizione del modello ed eliminarlo
Apri il pannello laterale e seleziona Passaggi
Trascina il passaggio Flusso di lavoro risorsa di aggiornamento DAM completato nella definizione del modello
Seleziona il pulsante Informazioni pagina (accanto all'interruttore Pannello laterale) e seleziona Apri proprietà
Nella scheda Base, seleziona Flusso di lavoro transitorio
Seleziona Salva e chiudi dalla barra delle azioni superiore
Seleziona Sincronizza nella barra delle azioni superiore
Chiudi l’editor modello flusso di lavoro

Applicare il modello di flusso di lavoro con avvio automatico disattivato

Segui i passaggi descritti in Applica un modello di flusso di lavoro a una cartella e imposta Disattiva flusso di lavoro con avvio automatico in quanto il flusso di lavoro con avvio automatico per le cartelle non richiede la post-elaborazione delle risorse.

Best practice e limitazioni best-practices-limitations-tips

Durante la progettazione dei flussi di lavoro, considera le tue esigenze per tutti i tipi di rendering. Se non prevedi la necessità di una rappresentazione in futuro, rimuovi il relativo passaggio di creazione dal flusso di lavoro. Non è possibile eliminare le rappresentazioni in blocco in un secondo momento. Le rappresentazioni indesiderate potrebbero occupare una grande quantità di spazio di archiviazione dopo l'uso prolungato di Experience Manager. Per le singole risorse, puoi rimuovere manualmente le rappresentazioni dall’interfaccia utente. Per più risorse, puoi personalizzare Experience Manager per eliminare rappresentazioni specifiche oppure eliminare le risorse e caricarle nuovamente.
Attualmente, il supporto è limitato alla generazione di rappresentazioni. La generazione di una nuova risorsa 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’estrazione dei metadati non riesce.

Consulta anche

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab