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.
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:
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.
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:
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:
-
Passa a Apps > App Management.
-
Fare clic su Associate App.
{width="500" modal="regular"}
-
Selezionare Project dall’elenco.
-
Selezionare Workspace.
-
Fare clic su Associate.
{width="500" modal="regular"}
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.
-
Aprire la finestra di dialogo di installazione dell’app associata in App Management.
-
Esaminare i casi di utilizzo aziendali dell’applicazione e i passaggi di installazione elencati.
-
Se vengono visualizzati Pre Installation Instructions, completare i prerequisiti prima di procedere.
{width="600" modal="regular"}
-
Fare clic su Install.
-
Monitorare gli indicatori di avanzamento per i singoli elementi fino al termine dell’installazione.
{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. -
Verificare che Successfully Installed sia visualizzato e che gli elementi completati abbiano segni di spunta.
{width="600" modal="regular"}
-
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:
- Sulla scheda dell’app associata, seleziona Manage > Configure.
Nel modulo vengono visualizzate le impostazioni configurabili dell’app.
-
Modificare i valori in base alle esigenze.
-
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:
-
Fare clic su Change Scope.
-
Selezionare un ambito dall’elenco.
-
Modificare i valori per questo ambito.
-
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.
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.
-
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.
-
Passa a Apps > App Management e apri l’aggiornamento disponibile per l’app.
-
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.
-
Avvia l’aggiornamento e monitora l’avanzamento delle operazioni elencate.
-
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.
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.
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:
-
Passa a Apps > App Management.
-
Sulla scheda dell’app, seleziona Manage > Unassociate.
-
Esamina i casi d’uso aziendali e i componenti elencati interessati dalla disinstallazione, inclusi gli eventi e i passaggi di installazione personalizzati.
{width="600" modal="regular"}
-
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.