Pubblicare l’estensione personalizzata
L’estensione viene eseguita in Fusion solo dopo che è stata generata, distribuita in Adobe e approvata per la tua organizzazione. Le procedure in questa pagina mostrano come pubblicare l’estensione e come verificare il risultato.
Queste informazioni sono tratte dalla documentazione ufficiale di Adobe e si applicano in modo specifico a Workfront Fusion. Per informazioni generali su Adobe, consulta Flusso di sviluppo delle estensioni dell’interfaccia utente e Gestione estensioni dell’interfaccia utente nella documentazione di Adobe.
Aree di lavoro
Ogni progetto App Builder ha un’area di lavoro Stage e un’area di lavoro Produzione. Considerali come ambienti:
- Stage è per sviluppo e test. Distribuisci qui durante l’iterazione. Non è richiesta alcuna approvazione e il risultato è visibile solo attraverso l’interruttore di prova dello staging descritto di seguito (o l’anteprima locale).
- Produzione è per il rilascio a tutti. Dopo la distribuzione in produzione, invii una richiesta di approvazione e, una volta approvata, l’estensione viene registrata nel Registro di sistema dell’app Adobe e mostrata all’intera organizzazione.
Per ulteriori informazioni, consulta:
- Configurare gli strumenti e l'account dell'estensione dell'interfaccia utente
- Come ottenere l'accesso nella documentazione Adobe.
Per impostazione predefinita, Fusion mostra solo estensioni pubblicate. Si tratta di estensioni distribuite nell’area di lavoro Produzione e quindi inviate per l’approvazione . Questa è l’impostazione predefinita sicura, pertanto una distribuzione work-in-progress non viene mai visualizzata per errore nell’intera organizzazione.
Una distribuzione nell’area di lavoro Stage non è pubblicata, pertanto non viene visualizzata in Fusion. Puoi provare un’estensione in due modi prima di pubblicarla:
- Anteprima locale con
aio app run(vedi Anteprima locale delle estensioni dell’interfaccia utente nella documentazione di Adobe). Non viene distribuito nulla e solo tu lo vedi. - Caricalo dallo stage all’interno di Fusion attivando un’opzione di test per utente nel tuo profilo di Fusion. Questo è descritto in Testare una build della fase in Fusion in questo articolo.
Testare una build di staging in Fusion
Utilizzare questo flusso per visualizzare una distribuzione di staging in Fusion prima di pubblicarla.
Passaggio 1: selezionare l’area di lavoro dello stage
aio console where # shows current org / project / workspace
aio console workspace select # choose Stage
Passaggio 2: generare
aio app build
In questo modo viene compilato il front-end e viene eseguito l’hook dei metadati (che genera app-metadata.json). Correggi eventuali errori segnalati prima di continuare.
Passaggio 3: distribuire
aio app deploy
deploy esegue due operazioni:
- Ospita la tua interfaccia utente nella rete di distribuzione dei contenuti di Adobe, in un URL come
https://<project>-stage.adobeio-static.net. Al termine, CLI stampa l’URL dell’endpoint dell’estensione. Questo è l’URL che Fusion carica nel suo iframe. - Registra gli endpoint dell’estensione per il punto di estensione (
fusion/nav-organization/1) nell’area di lavoro di staging.
Per ulteriori informazioni, vedere Il punto di estensione non esiste nell'articolo sulla risoluzione dei problemi.
Passaggio 4: attivare il test dello staging nel profilo di Fusion
Fusion carica le estensioni Stage solo quando si dà il consenso, per utente:
-
Accedi a Fusion con un account nella stessa organizzazione a cui hai eseguito la distribuzione.
-
Apri il menu dell’avatar utente nell’angolo superiore e vai a Impostazioni prodotto > Profilo di Fusion > Preferenze.
-
Attiva l’opzione Estensioni stage.
Fusion richiede di ricaricare.
-
Conferma il ricaricamento.
Dopo il ricaricamento, Fusion carica le estensioni dall’area di lavoro dello stage anziché dal set pubblicato e assegna a ciascuna un’etichetta (Stage) nell’area di navigazione per distinguerle.
Si tratta di un’impostazione di test personali memorizzata nel browser, non di un’impostazione dell’organizzazione. Disattivala (e ricaricala) per tornare alle estensioni pubblicate. Poiché è memorizzato localmente, non vi segue in un altro browser o computer.
Passaggio 5: verifica in Fusion
-
Apri la sezione che corrisponde al punto di estensione:
fusion/nav-organization/1→ l’area Organizzazione della navigazione a sinistra.fusion/nav-team/1→'area Team (selezionare prima un team).
Viene visualizzato un pulsante con il titolo impostato in
getWidget(), contrassegnato (Stage). -
Fai clic sul pulsante visualizzato.
L’interfaccia utente carica e riceve il contesto Fusion.
Se il pulsante non viene visualizzato o se nel pannello viene visualizzato un errore, vedere Risoluzione dei problemi.
Rilascio in produzione
Quando l’estensione funziona su Stage e sei pronto per tutti gli utenti:
Passaggio 1: passare all’area di lavoro di produzione
aio console workspace select # choose Production
Quando la CLI richiede informazioni sul file .env, seleziona Unisci per mantenere le variabili di ambiente.
Passaggio 2: generare e distribuire in produzione
aio app build
aio app deploy
Passaggio 3: sottomettere la richiesta di approvazione
La pubblicazione è una richiesta di approvazione inviata dall’area di lavoro di produzione:
- Apri Adobe Developer Console, seleziona la tua organizzazione, apri il tuo progetto e passa all’area di lavoro Produzione.
- Invia l’app per approvazione/pubblicazione (richiede il ruolo di amministratore di sistema).
- Dopo l’approvazione, l’estensione viene aggiunta al Registro app Adobe e diventa disponibile in Adobe Experience Cloud, incluso Fusion, per la tua organizzazione.
Per istruzioni dettagliate, consulta Gestione estensioni interfaccia utente nella documentazione di Adobe Developer.
Stato e aggiornamenti
Vale la pena conoscere alcuni comportamenti, in modo da poter distinguere “ci stai ancora lavorando” da “qualcosa non va”:
-
Distribuito in produzione non è lo stesso di visibile.
aio app deployin Produzione carica l’app, ma l’estensione non viene visualizzata. Viene visualizzato solo dopo l’invio e l’approvazione della richiesta di approvazione. Se è stato implementato in Produzione e non viene ancora visualizzato in Fusion, il motivo comune è che non è ancora stato approvato. -
Non è necessaria una nuova approvazione per gli aggiornamenti solo codice. Se l’estensione è già pubblicata e ne modifichi solo il codice (l’interfaccia utente o le azioni di runtime), ridistribuisci allo stesso URL con:
code language-sh aio app deploy --force-deployGli utenti ricevono la nuova versione alla successiva apertura dell’estensione. Nessun elemento da installare. È sufficiente inviare una nuova richiesta di approvazione quando si modifica la registrazione stessa, ad esempio aggiungendo un nuovo punto di estensione o modificando gli annunci di
getWidget(). -
Un’estensione revocata o ritirata scompare. Se un’estensione viene revocata o ritirata dall’utente, non viene più visualizzata in Fusion senza alcun messaggio di errore. Se un’estensione funzionante in precedenza scompare per tutti, verifica se è stata revocata prima di cercare un problema di codice.
Rimuovere (revocare) un’estensione
La rimozione di un’estensione pubblicata viene eseguita revocandola in Adobe Exchange:
- Accedi a Adobe Exchange.
- Vai a Gestisci > App App Builder.
- Seleziona Revoca accanto all’estensione da rimuovere e conferma.
Dopo la revoca, l’estensione mostra uno stato revoked in Extension Manager e non viene più visualizzata in Fusion. Per rimuoverlo completamente, elimina il progetto in Developer Console. Un progetto non può essere eliminato finché la sua estensione non viene revocata.
Per una distribuzione di test solo stage, è possibile rimuovere la distribuzione con:
aio app undeploy
Risorse aggiuntive
Le seguenti risorse sono disponibili nella documentazione di Adobe: