Guida all’utilizzo dell’add-in Qlik per Microsoft Excel

Guida all'utilizzo dell'add-in Qlik per Microsoft Excel

Se sei un utente Qlik alla ricerca di un modo efficace per integrare i tuoi dati e le tue analisi direttamente in Microsoft Excel, sei nel posto giusto!

In questa guida, ti mostreremo come iniziare a utilizzare l’add-in Qlik per Microsoft Excel, fornendoti istruzioni dettagliate su come attivarlo, aprirlo e connetterti ai contenuti di Qlik Sense. Prima di tutto, assicurati di avere l’add-in installato.

Requisiti per l’utilizzo dell’add-in

Prima di iniziare a utilizzare l’add-in per generare un modello di report per un’applicazione Qlik Sense in uno spazio condiviso, è necessario disporre dei permessi di visualizzazione in tale spazio.

Per connettersi all’app nell’add-in, è sufficiente avere accesso in sola lettura allo spazio dell’app.

Tuttavia, è importante notare che i report generati dai modelli creati saranno eseguiti in base agli accessi del proprietario del task di report. Pertanto, il creatore del modello non dovrebbe utilizzare contenuti di fogli dell’app che non intende rendere visibili agli altri membri dello spazio in futuro (ad esempio, un foglio privato).

Se stai utilizzando la versione web di Microsoft Excel per Microsoft 365, assicurati di consentire i pop-up nelle impostazioni del browser.

Attivazione dell’add-in

Dopo che un amministratore Microsoft ha installato l’add-in Qlik per la tua organizzazione, puoi attivarlo e utilizzarlo se ti sono stati forniti i relativi accessi. A seconda della versione di Microsoft Excel che stai utilizzando, i passaggi potrebbero variare leggermente. Si consiglia di fare riferimento alla documentazione ufficiale di Microsoft per i dettagli completi. Segui questi passaggi:

  1. Apri la versione desktop o web di Excel.
  2. Vai su Home > Componenti aggiuntivi > Ottieni componenti aggiuntivi.
  3. Nella scheda AMMINISTRATI DA AMMINISTRATORE della finestra di dialogo, seleziona l’add-in Qlik.

Il pulsante dell’add-in Qlik viene aggiunto alla barra delle schede.

Apertura dell’add-in

Per aprire l’add-in, fai clic sull’icona Qlik nella barra delle schede sotto la scheda Home.

Qlik Add-In per Microsoft Excel

Connessione al tenant e accesso

Quando apri l’add-in, ti verrà chiesto di connetterti al tenant di Qlik Cloud per cui è stato installato l’add-in. Un’unica installazione dell’add-in configura l’add-in per un tenant Qlik Cloud specifico. Clicca su “Connetti”. È richiesta una configurazione del client OAuth per installare l’add-in.
Verrai invitato a effettuare l’accesso la prima volta che ti connetti o se la connessione è stata chiusa dal lato del server. Segui questi passaggi:

  1. Quando ti viene chiesto di accedere, segui la procedura di accesso per il tuo account Qlik, utilizzando la configurazione del provider di identità del tuo tenant, se applicabile.
  2. Nella finestra di autorizzazione dell’app, autorizza l’app con il client OAuth facendo clic su “Approva”. Dovrai farlo solo dopo il primo accesso al tenant.

Selezione dell’app Qlik Sense per il modello

Dopo aver effettuato l’accesso, devi selezionare lo spazio e l’app Qlik Sense che desideri utilizzare come origine per il modello che stai creando. Un modello di report utilizza un’unica app. Potrai aggiungere oggetti solo da un’app Qlik Sense a ciascun file di modello Excel. Esegui questi passaggi:

  1. Sotto Spazio, seleziona lo spazio di Qlik Cloud Analytics.
  2. Sotto App, seleziona l’app Qlik Sense dallo spazio.
  3. Fai clic su Salva.

Dopo che l’app è stata caricata e i suoi metadati sono stati inseriti nel file, puoi fare clic su “Apri file o applicazione esterna” per aprire l’app di origine in Qlik Cloud. Una volta che il modello è connesso a un’app di origine, puoi tornare alla scheda Home nell’add-in per cambiare l’app.

Disponibilità dei fogli nell’app

Quando accedi all’add-in Qlik per Microsoft Excel, vedrai solo i contenuti a cui hai accesso nell’app Qlik Sense di origine. Ad esempio, per un’app nel tuo spazio personale, puoi accedere a tutti i contenuti. Per un’app in uno spazio condiviso, puoi vedere e utilizzare solo i contenuti pubblici nell’app o privati a te. I contenuti di un foglio privato di un altro utente in un’app dello spazio condiviso non possono essere visti o utilizzati.

Anteprima del report

Durante lo sviluppo di un template, potresti aver bisogno di verificare che l’output che verrà creato sia quello desiderato. Per visualizzare l’anteprima del report e vedere come apparirà senza configurare i compiti di report ed inviarli a te stesso, fai clic sull’icona “Download” nell’angolo in alto a destra dell’add-in. Fai clic su “Scarica come Excel (.xlsx)”.

A seconda della configurazione del tuo browser, il report verrà visualizzato in una finestra del browser o scaricato sul tuo computer. Se non vedi un report, verifica di aver consentito i pop-up nel tuo browser. Apri il file generato per controllare i risultati.

Apertura dell’oggetto di origine in Qlik Sense

Se desideri visualizzare l’oggetto di origine in Qlik Sense, seleziona l’oggetto nel foglio di lavoro di Excel. Successivamente, sotto “App di origine” nell’add-in, fai clic su “Apri in un’altra scheda”. Se l’oggetto di origine è un grafico, verrai portato all’app di Qlik Sense per visualizzare il foglio corrispondente.

Salvataggio del lavoro

Salva il foglio di lavoro di Excel come faresti normalmente. Puoi riaprire il file .xlsx come al solito e vedrai il tuo modello.

Trovare la versione dell’add-in e l’indirizzo del server connesso

Puoi trovare la versione dell’add-in e l’indirizzo del tenant Qlik Cloud. Segui questi passaggi:

  1. Nella finestra dell’add-in, fai clic sulla scheda “Home”.
  2. Accanto all’app di origine, fai clic sui tre puntini.
  3. Fai clic su “Informazioni”.
  4. Visualizza l’URL del tenant e la versione dell’add-in di Office, così come lo spazio e il nome dell’app Qlik Sense.

Sincronizzazione dell’add-in con il tenant Qlik Cloud

Se ci sono modifiche nel tenant Qlik Cloud connesso, il documento Excel che utilizza l’add-in non viene aggiornato automaticamente. Ad esempio, potresti aver bisogno di aggiornare:

• L’elenco degli spazi disponibili con cui puoi lavorare.
• L’elenco delle app disponibili con cui puoi lavorare.
• L’elenco delle entità disponibili nell’app Qlik Sense selezionata.
• Le immagini dei grafici che hai utilizzato nel modello. Ad esempio, se hai effettuato delle selezioni nell’app Qlik Sense di origine, potresti volere che le immagini dei grafici riflettano le selezioni nei segnaposti delle immagini.
• Lo stato delle immagini e delle tabelle che hai utilizzato nel modello (ad esempio, perché sono state eliminate o i loro titoli sono cambiati).

Segui i passaggi seguenti per aggiornare i metadati della connessione:

  1. Nella finestra dell’add-in, fai clic sulla scheda “Home”.
  2. Accanto all’app di origine, fai clic sui tre puntini.
  3. Fai clic su “Aggiorna tutte le immagini”.

Ciò applica un aggiornamento globale. Puoi anche eseguire aggiornamenti di singole entità e oggetti nelle altre schede dell’add-in. La funzione è presente quando sono disponibili.
I dati e gli oggetti in un modello non verranno aggiornati quando l’app Qlik Sense viene modificata, a meno che non venga applicato un aggiornamento.

Condivisione dei template di report di Excel

I template contengono solo i tag di tabella e le immagini di anteprima. Se un altro utente desidera modificare e visualizzare l’anteprima del modello, deve avere:

• L’add-in Qlik installato nella propria versione di Microsoft Excel.
• Accesso a Qlik Cloud.
• Autorizzazioni di visualizzazione nello spazio e nell’app Qlik Cloud (così da poter connettersi all’app Qlik Sense nell’add-in e accedere ai suoi dati).

Tuttavia, un modello di report è un normale foglio di lavoro di Excel che contiene i dati disponibili al momento della creazione dell’anteprima. Puoi condividere il file di modello con chiunque, ma solo gli utenti con accesso all’app di origine potranno connettersi ad essa nell’add-in e applicare gli aggiornamenti.

Cambiare l’app Qlik Sense connessa

Un template di report di Excel può generare report da un’unica app Qlik Sense. Ci sono due modi per cambiare l’app Qlik Sense connessa. Questi sono descritti nelle sezioni seguenti.

Cambio dell’app in un template vuoto

Dopo aver creato un template e averlo collegato a un’app Qlik Sense, è possibile cambiare l’app connessa purché non vi siano oggetti aggiunti al template. Esegui questi passaggi:

  1. Nella finestra dell’add-in, fai clic sulla scheda “Home”.
  2. Accanto all’app di origine, fai clic sui tre puntini.
  3. Fai clic su “Modifica app di origine”.
  4. Seleziona lo Spazio e l’App e fai clic su Salva.

Connessione a un diverso app ID

Se hai un’app che è stata duplicata, trasferita tra spazi o trasferita tra tenant Qlik Cloud, puoi cambiare l’ID dell’app e, facoltativamente, del tenant, a cui si connette il modello. Per poterlo fare, la nuova app deve contenere gli stessi ID degli oggetti dell’app a cui è attualmente connesso il modello. Segui questi passaggi:

  1. Prima di cambiare la connessione del modello, è consigliabile creare una copia di backup del modello.
  2. Nella finestra dell’add-in, fai clic sulla scheda “Home”.
  3. Accanto all’app di origine, fai clic sui tre puntini.
  4. Fai clic su “Cambia connessione modello”.
  5. Inserisci l’ID app dell’app a cui vuoi che si connetta il modello.

Puoi copiare e incollare direttamente l’ID dell’app dall’URL quando hai l’app aperta.

6. Se la nuova app si trova in un tenant Qlik Cloud diverso rispetto all’app attualmente connessa, attiva l’impostazione per Cambiare il tenant Qlik Cloud. Inserisci il nuovo URL del tenant.
7. Fai clic su “Cambia connessione modello”.
8. Chiudi e riapri l’add-in.

Capacità aggiuntive

Accesso ai messaggi di errore

Ci sono messaggi di errore nativi nell’add-in Excel. Per assistere nella segnalazione degli errori quando contatti Qlik, controlla i messaggi di errore nel pannello degli strumenti per sviluppatori del tuo browser, nelle schede JavaScript e di Rete.

Ricerca degli oggetti Qlik Sense nell’add-in

Puoi trovare un oggetto Qlik Sense specifico espandendo e scorrendo l’elenco che appare a destra dopo aver cliccato sul pulsante di aggiunta o puoi inserire una stringa nel modulo di ricerca. Dopo aver premuto Invio, verrà effettuata una ricerca della stringa nei seguenti campi dell’app Qlik Sense inserita:

• ID oggetto
• Nome oggetto (fogli inclusi)
• Tipo di grafico

Cambiare layout di stampa e area di stampa

Se il report di Excel generato verrà stampato o convertito in PDF, potresti dover regolare le impostazioni di stampa nel tuo modello. Apri il foglio di lavoro. Se desideri impostare la stessa orientazione e area di stampa per più fogli, esegui una delle procedure seguenti:

Due o più fogli adiacenti: Fai clic sulla scheda per il primo foglio. Successivamente, tenendo premuto Shift, fai clic sulla scheda per l’ultimo foglio che ti serve.
Due o più fogli non adiacenti: Fai clic sulla scheda per il primo foglio. Successivamente, tenendo premuto Ctrl, fai clic sulle schede degli altri fogli che ti servono.
Tutti i fogli: Fai clic con il pulsante destro del mouse su qualsiasi scheda del foglio e quindi fai clic su “Seleziona tutti i fogli”. Nella scheda Layout di pagina, fai clic su Orientamento. Seleziona Orizzontale o Verticale. Sul foglio aperto, seleziona l’area che desideri stampare. Nella scheda Layout di pagina, fai clic su Area di stampa. Fai clic su Imposta area di stampa. Se hai selezionato più fogli contemporaneamente, avranno tutti la stessa area di stampa.

Best Practice per la denominazione efficace degli oggetti nello sviluppo dell’app Qlik Sense

Quando si tratta di denominare gli oggetti nelle app Qlik Sense, è importante seguire determinate best practice per garantire chiarezza, coerenza e manutenibilità. I nomi degli oggetti sono i tag dei grafici e delle tabelle che compaiono nel tuo template di report. Ecco alcuni consigli per la denominazione degli oggetti come tabelle, grafici e altri elementi in Qlik Sense:

Usa un nome univoco per ciascun oggetto. Evita duplicazioni che potrebbero generare confusione e farti aggiungere il tipo di oggetto sbagliato.
Usa nomi chiari e descrittivi. Scegli nomi che riflettano accuratamente lo scopo e il contenuto dell’oggetto. Evita nomi ambigui o generici che potrebbero confondere gli utenti.
Sii conciso ma informativo. Mantieni i nomi concisi fornendo al contempo informazioni sufficienti per trasmettere la funzione o i dati dell’oggetto. Nomi lunghi e complessi possono essere scomodi da gestire.
Utilizza convenzioni di denominazione coerenti. Stabilisci e segui una convenzione di denominazione coerente per tutti gli oggetti della tua app. Ciò aiuta a mantenere una struttura logica e rende più facile cercare, identificare e gestire gli oggetti.
Evita l’uso di caratteri speciali. Limitati a caratteri alfanumerici e trattini bassi nei nomi degli oggetti. I caratteri speciali possono causare problemi nello scripting o nelle espressioni.
Usa camel case o trattini bassi al posto degli spazi: Scegli tra camel case (es. “miaTabella”) o trattini bassi (mia_tabella) per separare le parole nei nomi degli oggetti. Ciò migliora la leggibilità e rende i nomi più comprensibili.
Evita l’uso di parole chiave riservate. Qlik Sense ha parole chiave riservate che non dovrebbero essere utilizzate come nomi di oggetti. Queste parole chiave vengono utilizzate nelle espressioni, negli script o nell’ambiente Qlik Sense. Esempi includono “if”, “and”, “or”, “load”, ecc.
Usa nomi significativi e intuitivi per dimensioni e misure. Quando crei dimensioni e misure all’interno dei grafici, utilizza nomi che descrivano chiaramente i dati sottostanti o i calcoli che rappresentano. Questo migliora la comprensione e la collaborazione tra sviluppatori e utenti finali.
Documenta le convenzioni di denominazione. Mantieni una documentazione che delinei le convenzioni di denominazione utilizzate nelle tue app Qlik Sense. Ciò aiuta i nuovi sviluppatori a capire le convenzioni di denominazione e garantisce coerenza quando più sviluppatori lavorano sulla stessa app.
Rivedi e aggiorna regolarmente i nomi degli oggetti. Man mano che la tua app evolve o i requisiti cambiano, rivedi e aggiorna periodicamente i nomi degli oggetti per garantire che siano in linea con la struttura e le funzionalità attuali dell’app.