Gestione dell’app

Utilizza App Management per associare, installare, configurare, aggiornare e annullare l’associazione delle applicazioni App Builder all’istanza Commerce. I moduli di configurazione vengono generati dallo schema di ogni app, per cui puoi gestire le impostazioni senza dover sviluppare un’interfaccia utente amministratore personalizzata.

Gestione app {width="500" modal="regular"}

Trovare un’applicazione in Admin

In Apps > App Management, ogni applicazione viene visualizzata come una scheda. L’elenco può includere ogni app associata all’istanza di Adobe Commerce per l’organizzazione Adobe IMS selezionata. Utilizza i controlli sopra le schede per limitare i risultati:

Controllo
Descrizione
Filter by app…
Cerca per nome applicazione.
Status
Limita le schede in base allo stato del ciclo di vita. All Statuses mostra ogni app; gli altri valori includono Associated, Installed, Partially Installed e Unassociated. Lo stato di ogni scheda corrisponde all’indicatore colorato nell’elenco.
Extensibility patterns
Limita le schede in base alle funzionalità utilizzate dall’app. All Extensibility Patterns mostra ogni app; gli altri valori sono allineati ai badge su ogni scheda, ad esempio Business Configuration, Admin UI SDK, Webhooks e Events.

Il campo di ricerca ed entrambi i filtri si applicano insieme. Per visualizzare nuovamente l’elenco completo, cancellare il campo di ricerca e selezionare All Statuses e All Extensibility Patterns.

Rivedi dettagli applicazione

Sulla scheda dell’applicazione, selezionare Manage > Details per esaminarne il nome, la descrizione e la versione. La finestra di dialogo fornisce due schede:

  • Details elenca i casi d’uso aziendali dell’applicazione, inclusi gli eventi e i passaggi di installazione personalizzati. Rivedi le etichette e le descrizioni per comprendere cosa aggiunge l’applicazione a Commerce.
  • App config visualizza la configurazione dell’applicazione come JSON per l’ispezione.

Scheda Dettagli con i casi di utilizzo aziendali dell'applicazione {width="600" modal="regular"}

Scheda di configurazione app che visualizza la configurazione JSON dell'applicazione {width="600" modal="regular"}

Acquisire un’app

Acquire App apre una nuova scheda del browser (o una visualizzazione del browser separata) in Adobe Exchange, dove puoi scoprire le inserzioni sul marketplace relative a Commerce e aggiungere applicazioni alla tua organizzazione Adobe IMS. Una volta acquisita, approvata e distribuita l’app, questa verrà visualizzata in App Management per associazione e installazione.

Prerequisiti

Prima di associare un’app, assicurati di disporre dei seguenti elementi:

Requisito
Descrizione
Accesso amministratore
Amministratore Commerce con autorizzazioni App Management
App implementata
Applicazione App Builder distribuita nella tua organizzazione e pronta per la connessione
Accesso organizzazione
Accesso all’organizzazione Adobe in cui è distribuita l’app

Esercitazione

Guarda questo video per scoprire come associare un’app a un’istanza Commerce e configurare le impostazioni.

Associare un’app

Il processo di associazione importa siti web, store e visualizzazioni dello store da Commerce e crea il collegamento tra l’app e l’istanza Commerce.

Per collegare l’applicazione App Builder a un’istanza Commerce:

  1. Passa a Apps > App Management.

  2. Fare clic su Associate App.

    Associa app {width="500" modal="regular"}

  3. Selezionare Project dall’elenco.

  4. Selezionare Workspace.

  5. Fare clic su Associate.

    Dettagli app {width="500" modal="regular"}

WARNING
Se la sincronizzazione dell'ambito non riesce, l'associazione viene comunque completata. È possibile sincronizzare manualmente gli ambiti in un secondo momento dalla vista Manage Scopes nella configurazione dell'app associata.

Installare un’app

L’associazione collega un’app all’istanza di Commerce. Per le app che includono componenti installabili, come eventi, webhook, estensioni dell’interfaccia utente amministratore o passaggi di installazione personalizzati, l’installazione applica tali componenti all’istanza.

  1. Aprire la finestra di dialogo di installazione dell’app associata in App Management.

  2. Esaminare i casi di utilizzo aziendali dell’applicazione e i passaggi di installazione elencati.

  3. Se vengono visualizzati Pre Installation Instructions, completare i prerequisiti prima di procedere.

    Valutazione dell'installazione con istruzioni di preinstallazione e casi di utilizzo aziendali {width="600" modal="regular"}

  4. Fare clic su Install.

  5. Monitorare gli indicatori di avanzamento per i singoli elementi fino al termine dell’installazione.

    Stato dell'installazione per singoli elementi {width="600" modal="regular"}

    note warning
    WARNING
    Tenere aperta la pagina fino al termine dell'installazione. La chiusura o l'aggiornamento della pagina potrebbe impedire il corretto completamento dell'installazione.
  6. Verificare che Successfully Installed sia visualizzato e che gli elementi completati abbiano segni di spunta.

    Installazione completata con segni di spunta per gli elementi completati {width="600" modal="regular"}

  7. Completa le istruzioni di post-installazione fornite dall’app, quindi configurane le impostazioni in base alle esigenze.

Configurare le impostazioni

Dopo aver associato un’app nella visualizzazione App Management, configurarne le impostazioni tramite il modulo:

  1. Sulla scheda dell’app associata, seleziona Manage > Configure.

Nel modulo vengono visualizzate le impostazioni configurabili dell’app.

  1. Modificare i valori in base alle esigenze.

  2. Fare clic su Save.

Configurazione specifica per ambito

Utilizza la configurazione specifica dell’ambito quando siti web, store o viste store diverse richiedono impostazioni univoche. Ad esempio, è possibile abilitare una funzione solo per una specifica area geografica o vista store oppure utilizzare impostazioni diverse per marchio. Le impostazioni in un ambito inferiore sovrascrivono quelle degli ambiti superiori.

Per ignorare i valori globali a un livello di ambito specifico:

  1. Fare clic su Change Scope.

  2. Selezionare un ambito dall’elenco.

  3. Modificare i valori per questo ambito.

  4. Fare clic su Save.

Gestisci ambiti

Accedi a Manage Scopes dalla schermata dei dettagli dell’app per gestire la gerarchia dell’ambito per la tua app.

Gestisci ambiti {width="500" modal="regular"}

Azione
Descrizione
Add root scope
Aggiungi un ambito che si applica solo all’app.
Sync Commerce scopes
Aggiornare l’elenco dei siti Web, dei negozi e delle visualizzazioni dello store da Commerce dopo averli aggiunti o modificati.
Import scopes
Importa gli ambiti in blocco da un file.

Aggiornare un’app

Quando lo sviluppatore dell’app distribuisce una nuova versione di un’app installata, App Management riceve una notifica della disponibilità di un aggiornamento. L’implementazione di App Builder e un aggiornamento di App Management sono operazioni separate: l’aggiornamento applica le modifiche pianificate ai componenti installati, come eventi, webhook ed estensioni dell’interfaccia utente di amministrazione.

Chiedi al tuo sviluppatore di app di confermare che l’app supporta gli aggiornamenti. Per i prerequisiti di SDK e i requisiti di migrazione, consulta Aggiornare l’app nella documentazione per gli sviluppatori.

Rivedere e avviare un aggiornamento

In modalità manuale, che è l’impostazione predefinita, è possibile rivedere e avviare l’aggiornamento in App Management.

  1. Registra la versione e la configurazione dell’app installata ed esegui il backup dei dati dell’applicazione e delle risorse esterne con l’aiuto dello sviluppatore dell’app.

  2. Passa a Apps > App Management e apri l’aggiornamento disponibile per l’app.

  3. Esamina le modifiche pianificate ed eventuali avvisi. Un aggiornamento può aggiungere, modificare o rimuovere componenti. Se un passaggio di installazione personalizzato viene rimosso, lo script di disinstallazione non viene eseguito e le risorse create non vengono pulite automaticamente. Prima di procedere, conferma le operazioni di pulizia necessarie con lo sviluppatore dell’app.

  4. Avvia l’aggiornamento e monitora l’avanzamento delle operazioni elencate.

  5. Esaminare il risultato dell’aggiornamento e verificare la presenza di operazioni non riuscite. Se l’aggiornamento non riesce, seguire L’aggiornamento non riesce prima di utilizzare Retry Upgrade.

In modalità manuale, le modifiche pianificate ai componenti Commerce installati non vengono applicate fino all’avvio dell’aggiornamento. Tuttavia, la distribuzione può aggiornare il codice dell’azione di runtime già utilizzato dall’app installata prima dell’esecuzione dell’aggiornamento.

Aggiornamenti automatici

Lo sviluppatore dell’app controlla la modalità di aggiornamento. Chiedi allo sviluppatore di confermare se l’app utilizza aggiornamenti manuali o automatici.

WARNING
Gli aggiornamenti automatici sono sperimentali e vengono avviati dopo la distribuzione senza la revisione dell’amministratore, inclusi gli script di installazione personalizzati che possono modificare le risorse esterne. Coordina con lo sviluppatore prima di abilitare gli aggiornamenti automatici, anche quando una nuova versione distribuita cambia la modalità da manuale a automatica.

Modifiche alla configurazione aziendale

Le modifiche allo schema di configurazione aziendale dell’app vengono visualizzate automaticamente dopo la distribuzione. Sono separati dall’installazione e dagli aggiornamenti e non attivano un aggiornamento dell’app.

Annullare l’associazione di un’app

Annulla l’associazione di un’app quando non è più necessaria e connessa all’istanza di Commerce. Ad esempio, potrebbe essere necessario ritirare un’integrazione, passare a un’area di lavoro diversa o pulire le configurazioni di test.

WARNING
L’annullamento dell’associazione rimuove tutti i valori di configurazione per questa istanza. Questa operazione non può essere annullata. La disinstallazione può anche rimuovere componenti e risorse dell’app tramite script di disinstallazione personalizzati.

Prima di procedere, registra la versione e la configurazione installate, esegui il backup dei dati dell’applicazione e chiedi allo sviluppatore dell’app quali risorse vengono rimosse dagli script di disinstallazione dell’app e quali richiedono la pulizia manuale. Pianifica eventuali interruzioni del servizio e come ripristinare l’app, le sue impostazioni e i relativi dati. Per gli aggiornamenti di routine, aggiorna l’app invece di annullare l’associazione.

Per rimuovere un’app da un’istanza di Commerce:

  1. Passa a Apps > App Management.

  2. Sulla scheda dell’app, seleziona Manage > Unassociate.

  3. Esamina i casi d’uso aziendali e i componenti elencati interessati dalla disinstallazione, inclusi gli eventi e i passaggi di installazione personalizzati.

    Annulla associazione elenco conferme casi di utilizzo aziendali interessati {width="600" modal="regular"}

  4. Conferma l’azione.

Documentazione correlata

  • Risoluzione dei problemi App Management - Risolvi i problemi più comuni relativi all’associazione, all’installazione, alla configurazione e agli aggiornamenti.
  • Aggiorna l’app - Requisiti degli sviluppatori per le modalità di aggiornamento, gli script di migrazione e la diagnostica.
recommendation-more-help
commerce-help-app-management