Distribuzione e installazione dei componenti aggiuntivi Qlik per Microsoft Office

Distribuire e installare i componenti aggiuntivi Qlik per Microsoft Office per consentire agli utenti dell'organizzazione di creare modelli di report. Caricare i modelli di report creati con i componenti aggiuntivi nell'applicazione Qlik Cloud per generare l'output report dalle attività di report.

I componenti aggiuntivi Qlik per Microsoft Office possono essere distribuiti e installati per le versioni web e desktop compatibili di Excel, PowerPoint e Word all'interno di Microsoft 365.

I componenti aggiuntivi vengono installati utilizzando un file manifest. Questo file manifest è necessario affinché l'amministratore di Microsoft 365 (o eventualmente un utente, in determinati metodi di installazione) possa distribuire e installare i componenti aggiuntivi per sé o per gli utenti della propria organizzazione. Un file manifest consente l'installazione di componenti aggiuntivi per un singolo tenant di Qlik Cloud tenant.

Dopo aver ottenuto il file manifest o l'URL, esistono due metodi diversi per distribuire e installare i componenti aggiuntivi:

• Distribuzione centralizzata: Distribuzione, installazione e attivazione centralizzate

• Sideloading: Installazione di componenti aggiuntivi tramite sideloading o condivisione di rete

Per ulteriori informazioni, vedere Progettazione di modelli di report con Qlik componenti aggiuntivi per Microsoft Office.

Preparazione e acquisizione del manifest del componente aggiuntivo

I componenti aggiuntivi Qlik per Microsoft Office vengono installati nell'ambiente Microsoft utilizzando un file manifest. Si tratta di un file XML. Per una distribuzione centralizzata, è probabile che l'amministratore Microsoft debba fornire un URL al file manifest.

Un file manifest è specifico per un singolo tenant di Qlik Cloudtenant. Si utilizza lo stesso file manifest per installare i componenti aggiuntivi per Excel, PowerPoint e Word.

Per installare il componente aggiuntivo è necessaria una configurazione del client OAuth. Dopo aver configurato il client OAuth, ottenere il collegamento al file manifest, nonché il file manifest stesso, dal centro attività Amministrazione.

Procedere come indicato di seguito:

1. Creare il client OAuth nel tenant Qlik Cloud utilizzando la configurazione richiesta. Per le istruzioni complete, vedere Creazione di client OAuth per i componenti aggiuntivi Qlik per Microsoft Office.

2. Passare al centro attività Amministrazione e generare il collegamento al manifest. È inoltre possibile scaricare direttamente il file manifest per casi d'uso alternativi. Vedere Gestione dei manifest di installazione per i componenti aggiuntivi Qlik per Microsoft Office.

Creazione di client OAuth per i componenti aggiuntivi Qlik per Microsoft Office

La configurazione di un client OAuth è richiesta per installare i componenti aggiuntivi Qlik per Microsoft Office. I componenti aggiuntivi sono usati dagli sviluppatori di report per preparare modelli di report per il reporting in-applicazione con Qlik Cloud.

Per fare in modo che OAuth funzioni correttamente nei componenti aggiuntivi, è necessario configurare il client OAuth utilizzando la configurazione esatta mostrata sotto.

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, in Qlik Cloud, andare a Impostazioni.

2. Fare clic su Crea nuovo.

3. Nel menu a comparsa Tipo di client, selezionare App pagina singola. Verranno visualizzati ulteriori campi.

4. Inserire un Nome. L'opzione Descrizione è facoltativa.

5. Come minimo, selezionare la casella di controllo per includere l'ambito user_default. È possibile aggiungere anche altri ambiti nella configurazione, ma se non si include user_default, l'installazione non funzionerà.

   Per una descrizione completa di ogni ambito disponibile, vedere Available OAuth scopes.

6. Nel campo Aggiungi URL di reindirizzamento, inserire l'URL del Qlik Cloud tenant, seguito da questa stringa fissa: /office-add-ins/oAuthLoginSuccess.html

   Il risultato dovrebbe essere simile a questo: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Ad esempio: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Fare clic su Aggiungi.

8. Nel campo Aggiungi origini consentite, inserire l'URL del tenant e fare clic su Aggiungi.

9. Fare clic su Crea.

10. Viene visualizzata la finestra Copia il tuo ID client. È possibile scegliere di copiare l'ID del client negli appunti; oppure, fare clic su Fine per chiudere la finestra

Dopo aver creato il client OAuth, ottenere il collegamento al XML manifesto aggiornato dal centro attività Amministrazione. Andare alla pagina Impostazioni e selezionare la scheda Email e report. Nella sezione Condivisione e report, selezionare i componenti aggiuntivi Qlik per Microsoft Office. Utilizzare il collegamento fornito per distribuire e installare il componente aggiuntivo.

Distribuzione, installazione e attivazione centralizzate

Si consiglia di rendere disponibili i componenti aggiuntivi Qlik per Microsoft Office con distribuzione e installazione centralizzate. La distribuzione centralizzata richiede l'intervento di un amministratore di Microsoft 365 nell'organizzazione.

Con la distribuzione centralizzata, il manifest del componente aggiuntivo viene caricato nell'interfaccia di amministrazione di Microsoft 365 dell'organizzazione e distribuito agli utenti come installazione preconfigurata. La distribuzione può essere limitata ai membri di gruppi di sicurezza specifici.

È consigliabile utilizzare la distribuzione centralizzata quando:

• Si desidera che il componente aggiuntivo sia installato in modo permanente per i membri dell'organizzazione

• Si desidera gestire la distribuzione ai membri dell'organizzazione

Seguire le sezioni procedurali di seguito per il flusso di lavoro completo.

Distribuzione e installazione centralizzate

La distribuzione centralizzata viene completata da un amministratore di sistema di Microsoft 365.

Procedere come indicato di seguito:

1. Ottenere il file manifest del componente aggiuntivo o l'URL del manifest dopo aver creato un client OAuth. Vedere Preparazione e acquisizione del manifest del componente aggiuntivo.

2. Distribuire il componente aggiuntivo in base alla documentazione ufficiale Microsoft: Distribuire e pubblicare i componenti aggiuntivi di Office. Si noti che la distribuzione tramite distribuzione centralizzata è possibile solo utilizzando l'interfaccia di amministrazione di Microsoft 365.

Con la procedura precedente, i componenti aggiuntivi vengono installati per gli utenti a cui viene concesso l'accesso. Gli utenti attivano quindi i componenti aggiuntivi nella loro versione di Excel, PowerPoint o Word.

Per installare i componenti aggiuntivi su una versione desktop di Excel, PowerPoint o Word senza distribuzione centralizzata, è possibile configurare una condivisione di rete e caricarvi il manifest. Questa operazione può essere eseguita solo su un sistema operativo Windows.

Attivazione di un componente aggiuntivo dopo la distribuzione centralizzata

Una volta che un amministratore Microsoft ha installato un componente aggiuntivo di Qlik per l'organizzazione, l'utente può attivarlo e utilizzarlo se dispone di accesso.

A seconda della versione della tua Microsoft Office applicazione, questi passaggi potrebbero essere leggermente differenti. Per i dettagli completi, fare riferimento alla documentazione ufficiale di Microsoft.

Procedere come indicato di seguito:

1. Aprire una versione desktop o web di Excel, PowerPoint o Word.

2. Andare a Home > Componenti aggiuntivi > Scarica componenti aggiuntivi.

3. Nella scheda ADMIN MANAGED della finestra di dialogo, selezionare il componente aggiuntivo Qlik.

L'icona del componente aggiuntivo di Qlik viene aggiunta alla barra multifunzione.

Visualizzare, gestire e installare componenti aggiuntivi per Excel, PowerPoint e Word

Rimozione di un componente aggiuntivo

Se l'installazione utilizza una distribuzione centralizzata, potrebbe non essere possibile disinstallare il componente aggiuntivo. Ciò dipende dai criteri utilizzati dall'amministratore di Microsoft 365.

Installazione di componenti aggiuntivi tramite sideloading o condivisione di rete

Il sideloading e l'installazione tramite condivisione di rete sono modi adatti per ottenere rapidamente l'accesso ai componenti aggiuntivi a scopo di test o di prova. Non sono metodi adatti per la distribuzione di componenti aggiuntivi per casi d'uso di produzione e su scala aziendale.

A seconda della versione di Excel, PowerPoint o Word, nonché di altri fattori, i componenti aggiuntivi caricati con questi metodi potrebbero alla fine essere rimossi dalla barra multifunzione. Quando ciò accade, ricaricare il manifest nell'applicazione Microsoft Office.

Opzione 2: Installazione di un componente aggiuntivo sulle applicazioni desktop Microsoft Office utilizzando una condivisione di rete Windows

Per installare i componenti aggiuntivi su una versione desktop di Excel, PowerPoint o Word senza distribuzione centralizzata, è possibile configurare una condivisione di rete e caricarvi il manifest. Questa operazione può essere eseguita solo su un sistema operativo Windows.

Seguire le linee guida di seguito per eseguire il sideloading dei componenti aggiuntivi tramite condivisione di rete. Le istruzioni sono adattate dalla documentazione ufficiale Microsoft. Vedere Eseguire il sideloading dei componenti aggiuntivi di Office per il test da una condivisione di rete o altre risorse Microsoft per ulteriori informazioni.

Passaggio 1: Creare e condividere una cartella

Procedere come indicato di seguito:

1. Creare una cartella per ospitare il componente aggiuntivo Qlik. Ad esempio: C:\Componenti aggiuntivi Qlik per Office

2. In Esplora file di Windows, passare alla cartella principale o alla lettera di unità della cartella che si desidera utilizzare come catalogo di cartelle condivise. Ad esempio: C:\

3. Fare clic con il pulsante destro del mouse sulla cartella e selezionare Proprietà.

4. Aprire la scheda Condivisione e fare clic sul pulsante Condividi....

   

5. Nella finestra di dialogo, aggiungere se stessi e qualsiasi altro utente e/o gruppo con cui si desidera condividere il componente aggiuntivo. Sarà necessaria almeno l'autorizzazione di Lettura/Scrittura per la cartella. Dopo aver terminato di scegliere le persone con cui condividere, fare clic su Condividi.

6. Quando viene visualizzata la conferma che la cartella è stata condivisa, prendere nota del percorso di rete completo visualizzato subito dopo il nome della cartella. Fare clic su Fine per chiudere la finestra di dialogo.

   

7. Fare clic su Chiudi per chiudere la finestra di dialogo Proprietà.

Passaggio 2: Configurare manualmente la cartella condivisa come catalogo attendibile

Procedere come indicato di seguito:

1. Aprire una nuova cartella di lavoro vuota nella versione desktop di Excel, PowerPoint o Word.

2. Fare clic sulla scheda File, quindi fare clic su Opzioni nell'angolo in basso a sinistra.

3. Fare clic su Centro protezione, quindi fare clic sul pulsante Impostazioni Centro protezione....

   

4. Fare clic su Cataloghi di componenti aggiuntivi attendibili.

   

5. Nella casella URL catalogo, immettere il percorso di rete completo della cartella condivisa in precedenza.

6. Fare clic su Aggiungi catalogo.

7. Selezionare la casella di controllo Mostra nel menu per l'elemento appena aggiunto, quindi fare clic su OK per chiudere la finestra di dialogo del Centro protezione.

   

8. Fare clic su OK per chiudere la finestra di dialogo.

9. Chiudere e riaprire l'applicazione in modo che le modifiche abbiano effetto.

Passaggio 3: Eseguire il sideloading del componente aggiuntivo

Procedere come indicato di seguito:

1. Aggiungere il file XML del manifest del componente aggiuntivo alla cartella condivisa.

2. In ExcelPowerPoint o Word, fare clic su Componenti aggiuntivi nella scheda Home della barra multifunzione.

3. Fare clic su Altri componenti aggiuntivi.

4. Fare clic su CARTELLA CONDIVISA nella parte superiore della finestra di dialogo Componenti aggiuntivi di Office.

5. Selezionare Qlik per inserire il componente aggiuntivo.

6. Potrebbe essere visualizzata una finestra di dialogo con un messaggio simile al seguente: Qlik desidera visualizzare una nuova finestra. Fare clic su Consenti.

Rimozione di un componente aggiuntivo installato tramite condivisione di rete

Procedere come indicato di seguito:

1. Se Excel, PowerPoint o Word è aperto, chiuderlo.

2. Eliminare il contenuto di questa cartella: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Opzione 3: Sideloading di un componente aggiuntivo sulle applicazioni desktop macOS

Per macOS, i componenti aggiuntivi possono essere installati sulle versioni desktop di Microsoft 365 di Excel, PowerPoint o Word. Per i requisiti di sistema e software, vedere Requisiti di sistema e software.

Seguire le linee guida di seguito. Le istruzioni sono adattate dalla documentazione ufficiale Microsoft. Per le istruzioni complete, fare riferimento alla documentazione ufficiale Microsoft: Eseguire il sideloading di un componente aggiuntivo in Office su Mac

Procedere come indicato di seguito:

1. Aprire l'applicazione Finder sul computer.

2. Immettere la seguente combinazione di tasti: Command+Shift+G

   Si apre il menu Vai alla cartella.

3. Immettere uno dei seguenti percorsi a seconda dell'applicazione Microsoft Office:

   • Excel: /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint: /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word: /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   Potrebbe accadere che la cartella wef non esista ancora sul computer. In tal caso, crearla in questa posizione.

4. Nella cartella wef, aggiungere una copia del file manifest XML.

5. Aprire Excel, PowerPoint o Word. Se è già aperto, sarà necessario riavviarlo.

6. Nella barra multifunzione, passare a Home > Componenti aggiuntivi.

7. Selezionare il componente aggiuntivo Qlik.

Il componente aggiuntivo Qlik dovrebbe ora essere disponibile nella barra multifunzione.

Rimozione di un componente aggiuntivo caricato tramite sideloading dalle applicazioni desktop macOS

Per rimuovere il componente aggiuntivo Qlik, è necessario cancellare la cache di Office sul computer. Per ulteriori informazioni, vedere:

• Rimuovere un componente aggiuntivo caricato tramite sideloading

• Cancellare la cache di Office

Risoluzione dei problemi

Questa sezione fornisce suggerimenti per la risoluzione dei problemi comuni di distribuzione e installazione.

Per ulteriori suggerimenti sulla risoluzione dei problemi, vedere Risoluzione dei problemi - Reportistica in-applicazione.

Finestra di dialogo vuota visualizzata durante l'autenticazione dopo la distribuzione di un componente aggiuntivo Qlik per Microsoft Office

Quando un utente cerca di autenticarsi sul componente aggiuntivo di reporting per Microsoft Excel, Microsoft PowerPoint o Microsoft Word, la relativa finestra di dialogo di autenticazione a comparsa potrebbe essere vuota. In alternativa, l'utente potrebbe visualizzare un errore nella finestra di dialogo (in particolare, con il codice 12006).

Per fare in modo che un utente possa lavorare con un componente aggiuntivo Qlik per Microsoft Office, il flusso di autenticazione richiede un reindirizzamento tra il tuo tenant e il provider di identità ospitato in un dominio diverso. Il provider di identità è un'impostazione Cross-Origin-Opener-Policy con impostazioni restrittive. Come risultato, la parte della comunicazione tra i domini nel flusso di autenticazione viene bloccata, impedendo alle informazioni di accesso di essere restituite correttamente al componente aggiuntivo.

Azione proposta  

La seguente risoluzione dovrebbe essere eseguita da un amministratore di rete che è responsabile per l'impostazione dei provider di identità.

Procedere come indicato di seguito:

• Impostare l'intestazione della risposta dall'IDP alla finestra di dialogo come segue:

  Cross-Origin-Opener-Policy: unsafe-none

Per maggiori informazioni, consultare la documentazione ufficiale di Microsoft: Best practices and rules for the Office Dialog API (Procedure consigliate e regole per l'API della finestra di dialogo Office)