Pubblicazione e accessi dei Portali

Il pannello Pubblicazione raccoglie release, stato di pubblicazione e autorizzazioni del Portale. Le operazioni mostrate dipendono dal permesso individuale, dal ruolo nel Progetto e dalle funzionalità predisposte dall’amministratore della piattaforma.

Preparare una release

Prima della pubblicazione:

1. salvare tutte le modifiche;
2. eseguire Valida e correggere gli errori;
3. provare la bozza con Preview;
4. selezionare Pubblica per aprire il pannello;
5. creare una Nuova build release.

La release è una copia immutabile della revisione verificata. Modificare successivamente la bozza non cambia le release già create.

Capire e gestire gli artefatti

Ogni build riuscita produce un artefatto: il documento HTML eseguibile del Portale, completo di layout, stili compilati e runtime dei widget. Al documento è associato un manifest che elenca revisione sorgente, dimensione, capability e dipendenze utilizzate.

Il valore esadecimale mostrato dopo la build è l’hash SHA-256 del contenuto. Non è una password né un codice da inserire altrove: identifica in modo univoco l’artefatto e consente a Sybot di verificarne l’integrità.

Nel pannello Pubblicazione → Build e artefatti è possibile:

• consultare build preview e release con stato e revisione;
• aprire Dettagli per leggere hash completo, dimensione, manifest e diagnostica;
• usare Apri artefatto per ispezionare il documento generato;
• annullare una build ancora in coda o in esecuzione.

Gli artefatti riusciti non vengono cancellati manualmente dall’editor: una release può dipendere esattamente da quel contenuto immutabile. La gestione ordinaria avviene tramite approvazione, deploy, revoca e rollback delle release.

Un Publisher o Owner può approvare una release riuscita. L’approvazione non modifica la bozza e rende la release selezionabile per la pubblicazione sulle destinazioni già rese disponibili. Lo stato viene aggiornato senza ricaricare la pagina.

Se nessuna destinazione è disponibile, rivolgersi al proprietario del Progetto o all’amministratore della piattaforma. Non tentare di riutilizzare una destinazione appartenente a un altro Progetto.

Pubblicare sul primo target

1. approvare la release creata;
2. come Owner del Portale e del Progetto creare il target indicando l'origin esatto, per esempio https://portals.example.com, senza path;
3. se la release contiene Power BI App owns data, aprire Gestisci profili e report, creare un endpoint per il target o per il fallback del suo ambiente ed eseguire Diagnostica fino allo stato verificato;
4. selezionare la release approvata e il target, quindi avviare Deploy;
5. attendere lo stato attivo e usare Apri per collaudare il Portale.

Produzione e pre-produzione richiedono HTTPS. HTTP è disponibile soltanto per un target di sviluppo su localhost. Se una build risulta riuscita ma il pannello non si aggiorna, usare Aggiorna e controllare l'elenco prima di creare una seconda release.

Se la release usa Qlik OAuth impersonation, anche il relativo profilo ed endpoint devono avere una diagnostica positiva. Per un target Agent remoto l'amministratore deve avere predisposto la destinazione: dopo il deploy lo stato resta In attesa dell'Agent finché la release non viene verificata e attivata. La versione precedente rimane disponibile. Consultare Integrazioni governate.

Cosa aspettarsi da un target Agent remoto

Quando si usa Apri, il runtime remoto può reindirizzare alla pagina di accesso della Sybot che possiede il Portale. Dopo l'autenticazione il browser torna automaticamente al Portale: non è necessario eseguire una seconda configurazione nell'editor.

Layout, stili e contenuti statici provengono dalla release attivata sul target. I widget che usano dati, Viste Utente, Workflow, BPMN, Power BI o Qlik continuano ad applicare in tempo reale permessi e configurazioni della Sybot proprietaria. Per questo possono risultare temporaneamente non disponibili se la piattaforma non è raggiungibile, anche quando la parte statica del Portale è già visibile.

Verificare la pubblicazione

Durante l’attivazione il pannello mostra lo stato corrente. Quando l’operazione è completata compare Apri, che consente di provare il Portale con gli stessi controlli di accesso applicati agli utenti finali.

Per un target remoto, Ultimo contatto Agent conferma che l'Agent ha comunicato con Sybot. Non sostituisce il collaudo dei widget dinamici.

Nel collaudo confrontare posizione, larghezza e altezza dei widget con la Preview della stessa revisione. La geometria fa parte dell'artefatto immutabile: dopo un aggiornamento che modifica la resa del Portale occorre creare una nuova build e una nuova release; distribuire di nuovo la stessa release non la ricompila.

Una pubblicazione non riuscita non sostituisce la versione già attiva. Leggere il messaggio mostrato, correggere la causa indicata e ripetere l’operazione con una release valida.

Quando è disponibile una versione precedente, il Publisher può usare Rollback per riattivarla senza modificare o ricostruire la bozza corrente.

Gestire collaboratori e audience

L’Owner trova nel pannello Accesso due aree:

• Collaboratori, per assegnare o revocare il permesso individuale dei membri del Progetto;
• Audience runtime, per autorizzare i ruoli applicativi che possono aprire il Portale pubblicato.

L’audience non sostituisce l’appartenenza al Progetto. La rimozione di un membro, la revoca del permesso o la rimozione del ruolo dall’audience impediscono le successive aperture non più autorizzate.

Risoluzione dei problemi

• La build non parte o resta in attesa: aggiornare il pannello e, se lo stato non cambia, comunicare il messaggio all’amministratore.
• La release non è approvabile: verificare di avere permesso Publisher o Owner e che la build sia riuscita.
• Il Portale pubblicato non si apre: controllare appartenenza al Progetto, permesso o audience e stato attivo.
• Il target remoto torna ripetutamente alla pagina di accesso: chiudere le schede obsolete, riaprire il Portale da Apri e, se il ciclo continua, comunicarlo all'amministratore senza condividere link di autenticazione.
• Il target remoto si apre ma i widget dinamici non rispondono: verificare che la piattaforma Sybot sia raggiungibile; la sola presenza del contenuto statico non conferma la disponibilità di dati e integrazioni.
• I widget pubblicati risultano compressi o fuori griglia: creare una nuova build e una nuova release con la versione corrente, quindi distribuirla; il redeploy della release precedente conserva il vecchio artefatto.
• Dati o Workflow sono negati: verificare che l’oggetto collegato sia ancora accessibile e che la release utilizzi una configurazione corrente.
• Il deploy con Power BI è bloccato: verificare che ogni binding e variante App owns data abbia un endpoint attivo e diagnosticato per il target o per il suo ambiente.
• Compare un identificativo diagnostico: copiarlo senza aggiungere dati riservati e fornirlo all’assistenza.