DocumentazioneCommerceGuida all'integrazione di AEM Assets

Configurare il progetto AEM Assets per supportare i metadati di Commerce

Last update: Thu Jul 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Utente

Per gestire i file di risorse Commerce in AEM Assets, completa i passaggi seguenti per configurare il progetto AEM Assets con il codice standard e i metadati richiesti per gestire le risorse Commerce dall’ambiente di authoring AEM.

  • Passaggio 1: installa un modello di progetto AEM con il codice standard per aggiungere lo spazio dei nomi Commerce e le risorse dello schema metadati alla configurazione dell'ambiente Experience Manager Assets as a Cloud Service.
  • Passaggio 2: Configura il profilo metadati da applicare ai file di risorse Commerce

Aggiungi il codice boilerplate al progetto AEM

Adobe fornisce una piattaforma standard di AEM Commerce, assets-commerce, per aggiungere lo spazio dei nomi e le risorse dello schema dei metadati Commerce alla configurazione dell'ambiente Experience Manager Assets as a Cloud Service. Distribuisci questo codice nell'ambiente come pacchetto Maven. Quindi, configura i metadati Commerce nell’ambiente di authoring AEM Assets per completare la configurazione.

La boilerplate 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
Consulta la pagina leggimi per ulteriori informazioni sulla targhetta Commerce di AEM.

Prerequisiti

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

Installa il pacchetto commerce-assets

  1. Se necessario, crea ambienti di produzione e staging per il progetto AEM Assets da AEM Cloud Manager.

  2. Se necessario, configura una pipeline di distribuzione.

  3. Da GitHub, scarica il codice dalla piastra di avvio di AEM Commerce.

  4. Dal ambiente di sviluppo AEM locale, installa il codice personalizzato nella configurazione dell'ambiente AEM Assets come pacchetto Maven oppure copiando manualmente il codice nella configurazione del progetto esistente.

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

  6. Da AEM Cloud Manager, distribuisci il codice per aggiornare l'ambiente AEM.

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.

Passaggio successivo

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe)."} Installa pacchetti Adobe Commerce

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