DocumentazioneCommerceIntegrazione di AEM Assets

Configurare il progetto AEM Assets per supportare i metadati di Commerce

Ultimo aggiornamento: 11 maggio 2026

Creato per:

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

Quando si utilizza AEM Assets as a Digital Asset Management System (DAM) for Commerce, l’installazione del pacchetto assets-commerce consente di gestire immagini e video per i prodotti Commerce dall’ambiente di authoring AEM.

Completa i seguenti passaggi per configurare il progetto AEM Assets con il codice pacchetto e i metadati richiesti per gestire le risorse Commerce dall’ambiente di authoring AEM:

  1. Informazioni sul contenuto del pacchetto assets-commerce

  2. Completa i passaggi di installazione per configurare il progetto AEM Assets per il supporto dei metadati Commerce

contenuti del pacchetto AEM Commerce assets-commerce

Adobe fornisce un codice pacchetto AEM Commerce assets-commerce per aggiungere risorse dello spazio dei nomi e dello schema dei metadati di Commerce alla configurazione dell’ambiente Experience Manager Assets as a Cloud Service.

Questo codice di pacchetto aggiunge le seguenti risorse all’ambiente di authoring AEM Assets:

  • Uno spazio dei nomi personalizzato, Commerce per identificare le proprietà relative a Commerce.

    • Tipo di metadati personalizzato commerce:isCommerce con etichetta Eligible for Commerce per assegnare tag alle risorse Commerce associate a un progetto Adobe Commerce.

    • Un tipo di metadati personalizzato commerce:skus e un componente dell’interfaccia utente corrispondente per aggiungere una proprietà Product Data. I dati prodotto includono le proprietà dei metadati per associare una risorsa Commerce agli SKU di prodotto.

      Controllo interfaccia utente dati prodotto personalizzato {width="600" modal="regular"}

    • Attributi del tipo di metadati personalizzati commerce:roles e commerce:positions per mostrare come viene visualizzata la risorsa in Commerce.

    • Metadati multifield di testo alternativo (Alt texts) che consentono agli editor di immettere testo alternativo con chiave per il codice di visualizzazione dell’archivio di Commerce. Questo non cambia il modo in cui le immagini del prodotto vengono assegnate o definite nell’ambito del catalogo. Vedi Testo alternativo nei metadati di AEM Assets.

  • Modulo schema metadati con scheda Commerce che include i campi Eligible for Commerce e Product Data per l’assegnazione di tag alle risorse Commerce. Il modulo fornisce inoltre opzioni per mostrare o nascondere i campi roles e position dall’interfaccia utente di AEM Assets.

    Scheda Commerce per modulo schema metadati AEM Assets {width="600" modal="regular"}

  • Esempio di risorsa con tag e approvata da Commerce equipment_6.jpg per supportare la sincronizzazione iniziale delle risorse. Solo le risorse Commerce approvate possono essere sincronizzate da AEM Assets ad Adobe Commerce.

NOTE
Per ulteriori informazioni sul codice pacchetto AEM Commerce, consulta la pagina readme su GitHub.

Testo alternativo nei metadati di AEM Assets

Il multifield Alt texts​è disponibile nell’editor metadati risorse di AEM Assets nella scheda Commerce​quando si modifica un’immagine idonea.

IMPORTANT
Il comportamento di visualizzazione per punto vendita si applica solo al testo alternativo. L’integrazione di AEM Assets non sincronizza diverse immagini di prodotto per ogni vista store di Adobe Commerce. Le immagini dei prodotti di AEM continuano a essere sincronizzate con Commerce con lo stesso comportamento di assegnazione della galleria utilizzato prima di questa versione.

Il campo multiplo contiene una riga per ogni visualizzazione store di Commerce. Ogni riga dispone di due input:

  • Store View Code — Identificatore della visualizzazione archivio (ad esempio default o en_US).

  • Alt Text — Testo alternativo per la visualizzazione archivio, limitato a 255 caratteri.

Selezionare Add per aggiungere altre righe per altre visualizzazioni dello store. Per rimuovere una riga, selezionare l’icona Delete sulla riga per rimuoverla.

Testi Alt con più campi con input Codice visualizzazione archivio e Testo Alt {width="600" modal="regular"}

Quando si salva, la convalida lato client blocca l’invio se una riga presenta un Store View Code​vuoto o se due righe utilizzano lo stesso codice di visualizzazione archivio (senza distinzione maiuscole/minuscole).

Le voci di testo alternative vengono mantenute nei metadati delle risorse JCR come due proprietà String[] allineate all’indice:

  • commerce:altTextStoreViews: memorizzare il codice di visualizzazione per ogni riga.
  • commerce:altTextValues: Corrispondenza del testo alternativo nello stesso indice di ogni voce in commerce:altTextStoreViews.

Quando queste risorse vengono sincronizzate con Adobe Commerce, nella galleria di supporti del prodotto viene scritto del testo alternativo per la visualizzazione del negozio per i codici di visualizzazione del negozio corrispondenti. La mappatura immagine sottostante è invariata.

Prerequisiti

Per distribuire il codice pacchetto assets-commerce nell’ambiente AEM Assets as a Cloud Service AEM sono necessarie le risorse e le autorizzazioni seguenti:

Visualizzazioni prodotto

[Solo SaaS]{class="badge positive" title="Applicabile solo ai progetti Adobe Commerce as a Cloud Service e Adobe Commerce Optimizer (infrastruttura SaaS gestita da Adobe)."} Dynamic Media con funzionalità OpenAPI è self-service per gli elementi visivi di prodotto basati su AEM Assets.

  1. Passa al Cloud Manager.

  2. Seleziona l’ambiente desiderato.

  3. Abilita Dynamic Media con funzionalità OpenAPI.

    Se il pulsante Dynamic Media con funzionalità OpenAPI non è attivo, aprire un ticket di supporto.

AEM Assets

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe)."} In AEM as a Cloud Service, invia un ticket di supporto Adobe con le seguenti informazioni:

  • Title: Abilita Dynamic Media OpenAPI per integrare completamente Adobe Commerce con AEM Assets

    • Contenuto del ticket di supporto:

      • AEM Program ID
      • Adobe Commerce URL
      • AEM Environment ID
      • IMS Org ID

Dopo aver inviato il ticket di supporto, Adobe abilita Dynamic Media con funzionalità OpenAPI nell’ambiente Cloud Services e condiviso i dettagli, come l’ID client IMS, per consentire all’utente di procedere con l’integrazione.

Passaggio 1: installare il pacchetto assets-commerce

  1. Passa a AEM Cloud Manager, seleziona un programma e crea ambienti di produzione e di staging che desideri integrare con Adobe Commerce.

  2. Clona l’archivio Git gestito da Adobe per il programma selezionato.

    Credenziali archivio Cloud Manager e comando clone {width="600" modal="regular"}

    In Cloud Manager Pipeline, selezionare Access Repo Info per aprire Repository Info. Copia il valore URL o Git command line, genera una password di accesso, se necessario, quindi clona localmente con il client Git.

  3. Da GitHub scaricare il codice del pacchetto dall’archivio Commerce di AEM Assets.

  4. Dall’ambiente di sviluppo AEM locale, copia manualmente il codice scaricato nell’archivio gestito Adobe esistente.

  5. In tutti i file filter.xml e pom.xml del progetto, sostituisci tutte le occorrenze di <my-app> con il nome dell’app.

    note
    NOTE
    In alternativa, puoi installare il codice personalizzato nella configurazione del progetto AEM Assets come pacchetto Maven.

  6. Apporta le modifiche e invia il ramo di sviluppo locale all’archivio Git di Cloud Manager.

  7. Configura una pipeline di distribuzione oppure verifica che la pipeline possa distribuire modifiche all’ambiente selezionato.

    Pipeline Cloud Manager {width="600" modal="regular"}

    Quando la pipeline esiste, apri il menu delle azioni (…) a Run, Edit, View/Edit variables o altre azioni. Consulta la documentazione della pipeline Cloud Manager collegata in precedenza.

  8. Da AEM Cloud Manager, aggiorna l’ambiente AEM utilizzando la pipeline per distribuire il codice.

  9. Vai a una risorsa e modificane le proprietà per convalidare le modifiche:

    • Lo schema metadati predefinito include la scheda Commerce.

    • Sono visibili gli SKU del prodotto e i campi Eligible for Commerce.

La scheda Commerce non è visibile nelle proprietà

Se la scheda Commerce non viene visualizzata nelle proprietà, è necessario completare manualmente i passaggi seguenti nell’editor schema metadati:

  1. Passa all’editor schema metadati.

  2. Seleziona Modifica per modificare il modulo schema metadati predefinito.

  3. Creare una scheda Commerce e selezionarla.

  4. Trascina e rilascia il componente Product nella scheda Commerce e mappalo sulla proprietà commerce:skus.

  5. Selezionare la casella di controllo mostra ruoli e mostra ordine.

  6. Trascina e rilascia un componente checkbox nella scheda Commerce e mapparlo sulla proprietà commerce:isCommerce. Definisci Sì e No come opzioni.

Se riscontri altri problemi, crea un ticket di supporto o contatta il rappresentante commerciale per l’integrazione di AEM Assets.

Passaggio 2: facoltativo. Configurare un profilo di metadati

Nell’ambiente di authoring di AEM Assets, imposta i valori predefiniti per i metadati delle risorse Commerce creando un profilo di metadati. Quindi, applica il nuovo profilo alle cartelle di AEM Asset per utilizzare automaticamente queste impostazioni predefinite. Questa configurazione semplifica l’elaborazione delle risorse riducendo i passaggi manuali.

Quando configuri il profilo di metadati, devi configurare solo i seguenti componenti:

  • Aggiungi una scheda Commerce. Questa scheda abilita le impostazioni di configurazione specifiche di Commerce aggiunte dal modello.

  • Aggiungere il campo Eligible for Commerce alla scheda Commerce.

Il componente Interfaccia utente dati prodotto viene aggiunto automaticamente in base al modello.

Definire il profilo di metadati

  1. Accedi all’ambiente di authoring di Adobe Experience Manager.

  2. Dall’area di lavoro di Adobe Experience Manager, vai all’area di lavoro Amministrazione contenuto authoring per AEM Assets facendo clic sull’icona Adobe Experience Manager.

    Authoring di AEM Assets {width="600" modal="regular"}

  3. Apri gli strumenti di amministrazione selezionando l’icona a forma di martello.

    Amministrazione autori AEM gestisce i profili di metadati {width="600" modal="regular"}

  4. Aprire la pagina di configurazione del profilo facendo clic su Metadata Profiles.

  5. Create un profilo di metadati per l’integrazione Commerce.

    Amministrazione autori AEM aggiungi profili metadati {width="600" modal="regular"}

  6. Aggiungi una scheda per i metadati di Commerce.

    1. A sinistra, fare clic su Settings.

    2. Fare clic su + nella sezione scheda e quindi specificare Tab Name, Commerce.

  7. Aggiungi il campo Eligible for Commerce al modulo.

    L'amministratore di AEM Author aggiunge campi di metadati al profilo {width="600" modal="regular"}

    • Fare clic su Build form.

    • Trascina il campo Single Line text nel modulo.

    • Aggiungere il testo Eligible for Commerce per l’etichetta facendo clic su Field Label.

    • Nella scheda Impostazioni, aggiungere il testo dell’etichetta a Etichetta campo.

    • Impostare il testo segnaposto su yes.

    • Nel campo Map to Property, copia e incolla il seguente valore

      code language-terminal 
      ./jcr:content/metadata/commerce:isCommerce

  8. Facoltativo. Per sincronizzare automaticamente le risorse Commerce approvate durante il caricamento nell’ambiente AEM Assets, impostare su approved il valore predefinito per il campo Review Status​nella scheda Basic.

  9. Salva l’aggiornamento.

Applicare il profilo di metadati alla cartella di origine delle risorse di Commerce

  1. Dalla pagina Metadata Profiles, seleziona il profilo di integrazione di Commerce.

  2. Dal menu Azioni, selezionare Apply Metadata Profiles to Folders.

  3. Seleziona la cartella contenente le risorse Commerce.

    Crea una cartella Commerce se non esiste.

  4. Selezionare Apply.

Passaggi successivi

recommendation-more-help
commerce-help-aem-assets-integration