DocumentazioneCommerceIntegrazione di AEM Assets

Metadati Commerce in AEM Assets

Ultimo aggiornamento: 15 luglio 2026

Creato per:

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

I metadati di Commerce sono il contratto tra AEM Assets e Commerce. Indica a Commerce quali risorse sono per Commerce, a quali prodotti appartengono e come devono essere utilizzate o visualizzate. Questi metadati consentono all’integrazione di AEM Assets di mappare e sincronizzare correttamente i file di risorse.

I metadati di Commerce offrono le seguenti funzionalità:

  • Contrassegna una risorsa come idonea per Commerce tramite il campo commerce:isCommerce.
  • Associa una risorsa a uno o più SKU di prodotto tramite il campo commerce:skus.
  • Definire la modalità di visualizzazione della risorsa in Commerce tramite i campi commerce:roles e commerce:positions.
  • Aggiungi testo alternativo specifico per Commerce codificato dalla visualizzazione archivio tramite i campi commerce:altTextStoreViews e commerce:altTextValues.
  • Esporre questi campi nell’interfaccia utente delle proprietà di AEM Assets tramite una scheda Commerce e un modulo schema.
IMPORTANT
La funzionalità Testo alternativo specifico per Commerce non è ancora disponibile tramite onboarding self-service. Attualmente viene fornito solo quando distribuisci il pacchetto di codice personalizzato assets-commerce (vedi Installare il pacchetto assets-commerce manualmente). Il supporto nativo è pianificato per la prossima versione di AEM.

Per configurare queste risorse nel progetto AEM, vedi Configurare il progetto AEM Assets. Il resto di questo argomento descrive come vengono forniti i metadati.

contenuti del pacchetto AEM Commerce assets-commerce

Adobe fornisce il pacchetto di codice AEM Commerce assets-commerce per aggiungere spazi dei nomi Commerce e risorse schema metadati alla configurazione di 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 personalizzato commerce:roles e commerce:positions che mostrano come la risorsa viene visualizzata in Commerce.

    • Metadati multifield di testo alternativo (Alt texts) che consentono agli editor di immettere testo alternativo per ogni codice di visualizzazione dell’archivio Commerce. Il multifield persiste in due proprietà String[] allineate all’indice:

      • commerce:altTextStoreViews — memorizza il codice di visualizzazione per ogni riga.
      • commerce:altTextValues — testo alt corrispondente nello stesso indice di ogni voce in commerce:altTextStoreViews.

      Le implementazioni di App Builder che utilizzano una corrispondenza esterna possono intercettare queste proprietà durante la trasformazione dei payload delle risorse. Questo non cambia il modo in cui le immagini del prodotto vengono assegnate o definite nell’ambito del catalogo. Vedi Testo alternativo localizzato 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 localizzato 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.

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