Configurare l’integrazione di Experience Cloud con l’amministratore di Commerce

Inizia a usare l’integrazione di Experience Cloud con Commerce Admin configurando l’applicazione Commerce per l’utilizzo delle estensioni Commerce Admin Unified Experience and Commerce Events.

Prerequisiti

  • Adobe Commerce deve essere configurato per utilizzare Autenticazione Adobe IMS

  • Provisioning e autorizzazioni degli account: gli amministratori devono disporre di profilo aziendale Adobe con accesso alle seguenti risorse per configurare l’integrazione Experience Cloud:

    • Adobe Admin Console: aggiunta e gestione di account utente e sviluppatore Adobi per l'organizzazione
    • Console Adobe Developer: accesso per sviluppatori o amministratori di sistema per creare progetti App Builder e generare le credenziali di connessione e la configurazione del progetto per utilizzare il servizio Adobe I/O Events
    • Progetto di infrastruttura cloud per Commerce: installa i moduli richiesti e configura il server applicazioni Commerce utilizzando Adobe Commerce CLI
    • Amministratore Commerce: aggiornamento della configurazione dell’archivio e gestione degli account utente di Commerce

Panoramica sulla configurazione

Abilita l’integrazione completando le seguenti attività:

Controllare l’ambiente Commerce e la configurazione dell’applicazione

Prima di configurare l’integrazione Experience Cloud, verifica che il progetto e l’applicazione Commerce soddisfino i requisiti.

  1. Sulla workstation locale, passa alla directory del progetto per il progetto Commerce.

  2. Consulta il ramo dell’ambiente per l’istanza da integrare con Experience Cloud.

  3. Verifica che Adobe IMS sia abilitato.

    • Utilizza il URL di accesso SSH per consentire all’ambiente di connettersi al server applicazioni Commerce.

    • Dalla riga di comando, utilizza Adobe Commerce CLI per verificare lo stato del modulo IMS.

      code language-bash
      bin/magento admin:adobe-ims:status
      

    Se il modulo non è abilitato, abilitarlo utilizzando l’organizzazione e le credenziali per il progetto di integrazione IMS.

  4. Verifica che l’utente Admin possa accedere a Commerce Admin utilizzando il proprio Adobe ID.

    • Vai all’URL dell’amministratore di Commerce.

    • Se hai effettuato l’accesso, disconnettiti.

    • Assicurati che l’utente Admin venga reindirizzato per l’accesso utilizzando il proprio Adobe ID.

      Accesso ad Adobe Commerce tramite Adobe ID {width="600" modal="regular"}

  5. Dalla directory del progetto cloud sulla workstation locale, verifica che l’estensione Commerce Admin Unified Experience sia installata.

    code language-bash
    composer show *unified-experience*
    

    Se l'estensione è installata, Composer restituisce il nome e la descrizione dell'estensione.

    code language-none
    magento/module-unified-experience <version> Commerce module responsible for integration with Adobe Experience Cloud
    

    Se l'estensione non è installata, utilizza Composer per installarla. Quindi, esegui il commit delle modifiche e ridistribuisci l’ambiente cloud.

    code language-none
    composer require magento/module-unified-experience
    composer update
    

Abilita esperienza unificata amministrazione Commerce

Abilita l’estensione Commerce Admin Unified Experience, quindi accedi tramite Experience Cloud.

NOTE
Queste istruzioni mostrano come un amministratore di progetto Commerce Cloud può abilitare l’estensione utilizzando Adobe Commerce CLI. Gli utenti Commerce Admin possono anche abilitare l’estensione aggiornando il Impostazioni di configurazione dell’archivio commerciale.
  1. Dalla directory principale dell’ambiente di progetto Cloud sulla workstation locale, utilizza strumento CLI magento-cloud per accedere al server applicazioni Commerce.

    code language-bash
    magento-cloud ssh
    
  2. Abilita magento/module-unified-experience tramite Adobe Commerce CLI:

    code language-bash
    bin/magento config:set admin/unified_experience/enabled 1
    Admin Unified Experience integration is enabled
    
  3. Cancella la cache.

    code language-bash
    bin/magento cache:clean
    

Configurare eventi Adobe I/O per Commerce

Quando l’integrazione Experience Cloud è abilitata, il servizio Adobe I/O Events invia i dati dell’evento Commerce ad Experience Cloud per gestire l’accesso degli amministratori ai progetti Commerce. La configurazione del servizio richiede l’abilitazione dell’estensione Adobe I/O Events for Commerce (magento/commerce-eventing) e la configurazione del servizio Adobe I/O Events in Admin.

Abilita eventi Commerce

Abilitare l’estensione Commerce Events (magento/commerce-eventing) per inviare dati evento personalizzati dall’applicazione Commerce al servizio Adobe I/O Events.

NOTE
Per Commerce 2.4.6 e versioni successive, l’estensione Commerce Events è installata per impostazione predefinita. Per i progetti Commerce con Commerce 2.4.5, utilizza innanzitutto Compositore per installare l’estensione, quindi attivalo.
  1. Dall’ambiente di sviluppo del progetto Commerce locale, aggiungi la seguente configurazione alla .magento.env.yaml file.

    code language-yaml
    stage:
      global:
        ENABLE_EVENTING: true
      deploy:
        CRON_CONSUMERS_RUNNER:
          cron_run: true
          max_messages: 0
          consumers: []
    
  2. Aggiungi, esegui il commit e distribuisci il file aggiornato .magento.env.yaml file nell’ambiente cloud.

TIP
Per informazioni dettagliate sulla configurazione e la gestione delle variabili di ambiente mediante .magento.env.yaml file, vedi Configurare le variabili di ambiente per la distribuzione.

Configurare l’integrazione di Commerce Events

Configura l’integrazione degli eventi Commerce completando le seguenti attività. Per istruzioni dettagliate, consulta Adobe I/O di eventi per Commerce documentazione per gli sviluppatori.

  1. Creare un progetto App Builder per ricevere i dati dell’evento dall’istanza Commerce.

    Per configurare l’integrazione in Commerce Admin, sono necessari credenziali e dati di configurazione dal progetto App Builder.

  2. Configura Adobe Commerce per utilizzare gli eventi Adobe I/O.

  3. Aggiorna il progetto App Builder per ricevere i dati dell’evento dall’istanza Commerce.

    Non registrarti o iscriverti a eventi dall’istanza Commerce. La registrazione dell’evento viene inviata al progetto App Builder quando configuri il provider di eventi per l’applicazione Commerce.

    Dopo aver collegato il provider di eventi al progetto App Builder, abbonati al observer.uex_commerce_instance_update e salva le modifiche.

  4. Per stabilire la connessione, invia un evento al consumatore tramite il provider di eventi.

    • Dalla riga di comando nella directory del progetto cloud locale, utilizzare SSH per connettersi al server applicazioni Commerce.

      code language-bash
      magento-cloud ssh
      
    • Invia i dati dell’evento controllando lo stato dell’estensione Admin Unified Experience tramite Adobe Commerce CLI.

      code language-bash
      bin/magento bin/magento admin:uex:status
      

Testare l’integrazione

Verifica che un amministratore Commerce possa accedere ad Experience Cloud per visualizzare i progetti Commerce disponibili e accedere ad Admin e Storefront per ciascun progetto.

  1. Accedi all’Experience Cloud utilizzando l’Adobe ID e l’organizzazione associate all’istanza Commerce.

    Accedere ai progetti Commerce dalla home page di Experience Cloud {width="600" modal="regular"}

  2. Visualizza i progetti Commerce disponibili selezionando Commerce.

    Area di lavoro Progetti Commerce, ad Experience Cloud {width="600" modal="regular"}

  3. Apri l’Amministratore per un’istanza selezionando Open.

    Vista dell’amministratore di Commerce con integrazione Experience Cloud abilitata {width="600" modal="regular"}

  4. Verifica di poter eseguire le attività di amministrazione come previsto.

    I flussi di lavoro nell’amministratore di Commerce devono seguire la stessa procedura. Se riscontri modifiche o errori del flusso di lavoro dopo aver abilitato l’integrazione Experience Cloud, contatta l’amministratore di sistema Commerce oppure invia un ticket di supporto Adobe.

Dopo aver configurato l’integrazione di Experience Cloud, verifica che gli account amministratore dispongano del provisioning corretto per accedere ai progetti Commerce tramite Experience Cloud. Consulta Gestire gli utenti amministratori.

recommendation-more-help
31746fd0-1ead-45b5-9192-1aaf582c5f66