DocumentazioneCommerceGuida all'integrazione di AEM Assets

Configurare il progetto AEM Assets per supportare i metadati di Commerce

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

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. Scopri di più su ​

  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 di AEM Commerce assets-commerce per aggiungere risorse dello spazio dei nomi e dello schema dei metadati 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.

  • 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, vedere la pagina leggimi.

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:

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. Configura una pipeline di distribuzione oppure verifica che la pipeline possa distribuire modifiche all'ambiente selezionato.

  3. Clona l'archivio Git gestito da Adobe per il programma selezionato.

  4. Da GitHub scaricare il codice del pacchetto dall'archivio Commerce di AEM Assets.

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

  6. In tutti i filter.xml e i pom.xml files per il progetto, sostituisci tutte le occorrenze di <my-app> con il nome dell'app.

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

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

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

  3. 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 crearne manualmente una nell'editor schema metadati.

  1. Passa all’editor schema metadati.

  2. Fai clic su 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 Review Status​il valore predefinito per il campo Basic nella scheda approved.

  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. Fare clic su Apply.

Passaggi successivi

recommendation-more-help
a946a0ea-3a16-4ab1-9bea-af7261643345