Distribuzione di un manifesto personalizzato – Aiuto

Potrete utilizzare questo articolo per distribuire un manifesto personalizzato agli utenti di Rainbow. Scoprirete la differenza tra la distribuzione tramite la console di amministrazione e l’importazione locale, come funziona la priorità di distribuzione e come rimuovere un manifesto quando necessario.

Panoramica

Un manifesto personalizzato è un file JSON che personalizza l’interfaccia di Rainbow per i Suoi utenti: pulsanti di azione, chiamate API, applicazioni incorporate, widget… Una volta distribuito, viene applicato automaticamente ogni volta che il client Rainbow viene avviato.

Requisiti di licenza: le estensioni del manifesto personalizzato (pulsanti di azione, chiamate API, applicazioni integrate, widget) richiedono una licenza Business o di livello superiore. Senza una licenza Business sono disponibili solo gli eventi PBX (monitoraggio delle chiamate in entrata/in uscita).

Esistono due modalità di distribuzione:

Modalità	Chi	Ambito	Priorità
Console di amministrazione	L'utente, dalla console di amministrazione	Tutti i client utente (Web + Desktop, tutte le sessioni)	Ha la priorità
Importazione locale	Utente finale	Solo il dispositivo o il browser utilizzato per l’importazione	Sovrascritta dalla distribuzione tramite la console di amministrazione degli amministratori

Nota: la distribuzione da parte dell’amministratore ha sempre la priorità. Se un manifesto viene assegnato tramite la console, sostituisce qualsiasi importazione locale e l’opzione Importa/Esporta scompare dal client Rainbow.

Disattivazione dell’importazione locale: è possibile disattivare l’opzione Importa/Esporta per i propri utenti tramite i profili: Azienda → Profili → [profilo] → Autorizzazioni → Manifest personalizzato. Una volta disattivata, l’opzione scompare dal menu del client e viene applicato esclusivamente il manifest assegnato dalla console di amministrazione.

Distribuzione tramite la console di amministrazione

Questo è il metodo consigliato per l’ambiente di produzione. È sufficiente caricare il manifesto una sola volta; Rainbow lo applicherà automaticamente a tutti gli utenti interessati.

Schermata di configurazione

Il manifesto e i domini attendibili vengono configurati nella stessa sezione:

Azienda → Informazioni → Personalizzazione

Console Rainbow — Azienda → Informazioni → Personalizzazione

Importazione nella console

Acceda a Azienda → Informazioni → Personalizzazione → Custo-manifest
Fare clic su Importa e selezionare il file .json o .zip
Verifichi che il manifesto compaia nell’elenco

Assegnazione agli utenti

Due metodi di assegnazione:

Per singolo utente

Vada su Membro → Informazioni → Manifest personalizzato
Selezionare il manifesto da applicare

Per profilo utente

Vada su Azienda → Profili
Modifichi il profilo → sezione Custo-manifest
Selezionare il manifesto: questo si applica a tutti i membri del profilo

Tramite provisioning di massa (importazione CSV o sincronizzazione LDAP)

L’assegnazione del custo-manifest può essere inclusa in un’importazione CSV in blocco o nella sincronizzazione LDAP
Il campo corrispondente nel file CSV è «selectedAppCustomisationTemplate»
In LDAP, l’attributo selezionato è anch’esso AppCustomisationTemplate

Nota: questo metodo è particolarmente indicato per assegnare un manifesto a un numero elevato di utenti in un’unica operazione.

Adozione da parte dei clienti

Il manifesto distribuito viene scaricato automaticamente al successivo avvio del client. Non è richiesta alcuna azione da parte degli utenti.

Web: il manifesto viene caricato all’inizio di ogni sessione. Un aggiornamento ha quindi effetto al successivo accesso.

Desktop: il manifesto viene scaricato all’avvio dell’applicazione.

Domini attendibili

Prima della distribuzione, si verifichi che tutte le origini URL a cui fa riferimento il manifesto siano dichiarate in:

Azienda → Informazioni → Personalizzazione → Domini Custo-manifest

In assenza di tale dichiarazione, al momento del caricamento viene visualizzato un avviso e le estensioni non funzionano senza dare alcun avviso. Si veda l’articolo Sicurezza di rete e domini attendibili per le estensioni con manifesto personalizzato.

Aggiornamento di un manifesto distribuito

Modificare il manifesto

Modifichi il file JSON localmente
Nella console: Azienda → Personalizzazione → Custo-manifest → Sostituisci
Importare la nuova versione

La versione precedente viene sostituita. I client la scaricheranno al prossimo avvio.

Nota: nella console Rainbow non è prevista la gestione automatica delle versioni. Conservi le versioni precedenti in locale in modo da poter ripristinare una versione precedente, se necessario.

Forzare il ricaricamento (Web)

Su Rainbow Web, svuotando la cache del browser o effettuando il logout e il login forza il ricaricamento del manifesto.

Rimuovere il manifesto

Per rimuovere il manifesto da uno dei Suoi utenti: acceda a Membro → Informazioni → Manifesto personalizzato e selezioni Nessun manifesto. Il client tornerà allo stato predefinito al prossimo avvio.

Importazione locale (sviluppo e test)

L’importazione locale consente a un utente di caricare un manifesto direttamente nel proprio client Rainbow senza passare attraverso la console di amministrazione. È consigliata per la fase di sviluppo e per i test pre-implementazione.

Ambito limitato: un manifesto importato localmente si applica solo al computer o al browser utilizzato per l’importazione. Non segue l’utente su altre postazioni di lavoro o sessioni.

Importazione in Rainbow Desktop

Aprire Rainbow Desktop
Vada su Impostazioni → Telefonia → Personalizzazione
Fare clic su Importa e selezionare il file .json o .zip
Il manifesto viene applicato immediatamente

Per ottenere un modello di partenza: fare clic su Esporta prima di qualsiasi importazione — Rainbow genera un file di esempio contenente tutti i punti di estensione supportati.

Importazione in Rainbow Web

L’importazione locale su Rainbow Web segue la stessa procedura della versione Desktop (menu Impostazioni → Personalizzazione), ma è limitata al browser attualmente in uso.

Configurazione legacy tramite CLI

Procedura obsoleta: si raccomanda l’implementazione tramite console di amministrazione. L’implementazione centralizzata ha la priorità rispetto a questa modalità di configurazione legacy di Desktop ed è più semplice da gestire.

Per le integrazioni più datate di Rainbow Desktop, era possibile fornire un manifesto al momento dell’installazione tramite l’opzione di configurazione /Custom.

RainbowSetup.exe /Custom=C:\percorso\verso\manifest.json

Quando si utilizza questa modalità, l’opzione Importa/Esporta risulta nascosta all’utente finale. Se in seguito un amministratore assegna un manifesto tramite la console di amministrazione di Rainbow, il manifesto distribuito centralmente ha la priorità.

Problemi comuni

Il manifesto non viene applicato

Causa probabile	Come verificare	Risoluzione
Manifesto non assegnato all'utente	Console → Membro → Manifest personalizzato	Assegnare il manifesto
Il client non è stato riavviato	—	Chieda all’utente di riavviare Rainbow
JSON non valido	Strumenti di sviluppo → Console → errori in fase di caricamento	Verifichi la validità del JSON (strumento in linea o Rainbow Generator)
Importazione locale disabilitata dall’amministratore	Manca l’opzione di importazione/esportazione	Utilizzi la distribuzione da parte dell’amministratore

Durante il caricamento del manifesto viene visualizzato un avviso

Il manifesto fa riferimento a un URL la cui origine non è dichiarata nei domini attendibili.

Soluzione: dichiarare l’origine in Azienda → Personalizzazione → Domini manifest personalizzati.

Avviso: chiudere l’avviso non risolve il problema — le estensioni interessate falliranno silenziosamente in fase di esecuzione.

Le estensioni non vengono visualizzate nel client

Causa probabile	Soluzione
Manifesto assegnato ma client non riavviato	Riavviare Rainbow
Punto di estensione non supportato sul client (Web vs Desktop)	Verificare la compatibilità dei punti di estensione (EP) tra Web e Desktop nella documentazione
Raggiunto il numero massimo di azioni (3 per punto di estensione)	Riduca il numero di azioni nel manifesto
Importazione locale sovrascritta dal manifesto dell’amministratore	Comportamento previsto: il manifesto di amministrazione ha la priorità

L’importazione locale non è possibile (opzione disattivata o assente)

L’amministratore ha disabilitato l’importazione locale tramite il profilo. Si prega di contattare l’amministratore di Rainbow per ottenere l’accesso o richiedere la distribuzione tramite la console.

Lista di controllo per la distribuzione in fase di pre-produzione

JSON convalidato (nessun errore di sintassi, presenza di "version": "2" e "jsonType")
Manifesto testato tramite importazione locale su Rainbow Desktop e Web
Tutte le origini URL dichiarate nei domini del Custo-manifest
In caso di risorse locali: archivio ZIP creato con il file custo-manifest.json nella directory principale
Manifesto assegnato agli utenti o ai profili corretti nella console