Distribuzione e installazione di Qlik componenti aggiuntivi per Microsoft Office

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

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

I componenti aggiuntivi vengono installati utilizzando un file manifesto. Per distribuire e installare i componenti aggiuntivi per se stessi o gli utenti nella propria organizzazione, l'amministratore di Microsoft 365 (o, eventualmente, un utente, in determinati metodi di installazione) ha bisogno di tale file manifesto.Un file manifesto consente l'installazione dei componenti aggiuntivi per un singolo Qlik Cloudtenant.

Una volta scaricati il file manifesto o l'URL, sono disponibili due metodi differenti per distribuire e installare i componenti aggiuntivi:

• Distribuzione centralizzata: Distribuzione centralizzata, installazione e attivazione

• Sideload: Installazione di componenti aggiuntivi mediante il sideload o la condivisione di rete

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

Requisiti del software e di sistema

Nota su Qlik Cloud Government

I componenti aggiuntivi di Qlik per Microsoft Office sono supportati per lo sviluppo di modelli di report per le app nei tenant di Qlik Cloud Government o Qlik Cloud Government - DoD. I componenti aggiuntivi sono disponibili solo per Office 365 Commercial.

Per installare e usare i componenti aggiuntivi Qlik, è necessario soddisfare i seguenti requisiti.

Qlik componente aggiuntivo per Microsoft Excel

Per Windows installazioni:

• Windows 10 v.1903 o versione successiva

• Microsoft 365 v.16.0.11629 o versione successiva

Per macOS installazioni:

• macOS v.14 o versione successiva

• Microsoft 365 v.16.83 o versione successiva

Inoltre, per eseguire il componente aggiuntivo di Qlik per Microsoft Excel, è necessario disporre di un'installazione Microsoft Excel con ExcelAPI 1.9 o versione successiva. Per verificare l'installazione Excel sia conforme, fare riferimento alla pagina Set di requisiti per l'API JavaScript per Excel.

Se la versione di ExcelAPI è anteriore alla versione richiesta minima, viene visualizzato un errore che indica che il componente aggiuntivo Qlik richiede una versione successiva di Microsoft Excel.

Se è necessario fare clic sull'area vuota a destra in Microsoft Excel e premere F5 per aggiornare la pagina e visualizzare l'errore.

Se viene visualizzato questo errore, aggiornare l'installazione di Microsoft Excel.

componente aggiuntivo di Qlik per Microsoft PowerPoint

Per Windows installazioni:

• Windows 10 v.1903 o versione successiva

• Microsoft 365 versione 2504 (versione 18730.20030) o successiva

Per macOS installazioni:

• macOS v.14 o versione successiva

• Microsoft 365 v.16.96 o versione successiva

componente aggiuntivo di Qlik per Microsoft Word

Per Windows installazioni:

• Windows 10 v.1903 o versione successiva

• Microsoft 365 2208 (build 15601.20148) o versioni successive

Per le installazioni macOS:

• macOS v.14 o versione successiva

• Microsoft 365 v.16.64 o versione successiva

Preparazione e scaricamento del manifesto del componente aggiuntivo

I componenti aggiuntivi di Qlik per Microsoft Office vengono installati nell'ambiente Microsoft utilizzando un file manifesto. È un file XML. Per una distribuzione centralizzata, un URL al file manifesto probabilmente dovrà essere fornito dall'amministratore Microsoft.

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

Per installare il componente aggiuntivo, è richiesta la configurazione di un client OAuth. Una volta configurato il client OAuth, scaricare il collegamento al file manifesto, oltre allo stesso file manifesto, 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 di Qlik per Microsoft Office.

2. Andare al centro attività Amministrazione e generare il collegamento al file manifesto. È possibile anche scaricare il file manifesto direttamente per i casi di utilizzo alternativi. Vedere Gestione dei file manifesto di installazione per i componenti aggiuntivi di Qlik per Microsoft Office.

Creazione di client OAuth per i componenti aggiuntivi di 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-app 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 Scopi OAuth disponibili.

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 centralizzata, installazione e attivazione

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

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

È possibile utilizzare la distribuzione centralizzata nei seguenti casi:

• Quando si desidera che il componente aggiuntivo venga installato in modo permanente per i membri della propria organizzazione

• Quando si desidera gestire la distribuzione ai membri della propria organizzazione

Per il flusso di lavoro completo, seguire le sezioni che descrivono le procedure, qui di seguito.

Distribuzione centralizzata e installazione

La distribuzione centralizzata viene completata con l'aiuto di un amministratore di sistema di Microsoft 365.

Procedere come indicato di seguito:

1. Scaricare il file manifesto del componente aggiuntivo o l'URL del file manifesto dopo aver creato un client OAuth. Vedere Preparazione e scaricamento del manifesto del componente aggiuntivo.

2. Distribuire il componente aggiuntivo in base alla documentazione ufficiale di Microsoft: Distribuire e pubblicare i componenti aggiuntivi per Office. Notare che la consegna mediante la distribuzione centralizzata è possibile solo se si utilizza il centro di amministrazione Microsoft 365.

Con la procedura descritta sopra, i componenti aggiuntivi vengono installati per gli utenti a cui viene fornito l'accesso ad essi. Gli utenti quindi attivano i componenti aggiuntivi nella propria versione di Excel, PowerPoint o Word.

Per installare i componenti aggiuntivi su una versione desktop di Excel, PowerPoint o Word senza distribuzione centralizzata, è possibile impostare una condivisione di rete e caricarvi il manifesto. È possibile farlo unicamente 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. Questo dipende dalla politica utilizzata dall'amministratore di Microsoft 365 della propria organizzazione.

Installazione di componenti aggiuntivi mediante il sideload o la condivisione di rete

L'installazione mediante sideload e la condivisione di rete sono metodi idonei per ottenere rapidamente accesso ai componenti aggiuntivi a scopo di test o per eseguire delle prove. Non sono metodi idonei per la distribuzione di componenti aggiuntivi per la produzione e i casi di utilizzo di scala enterprise.

Dipendendo dalla versione di Excel, PowerPoint o Word, e da altri fattori, i componenti aggiuntivi caricati con questi metodi potrebbero essere infine rimossi dalla barra multifunzione. Se questo accade, ricaricare il file 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 impostare una condivisione di rete e caricarvi il file manifesto. È possibile farlo unicamente su un sistema operativo Windows.

Seguire le linee guida di seguito per completare il sideload dei componenti aggiuntivi tramite una condivisione di rete. Le istruzioni sono state adattate dalla documentazione Microsoft ufficiale. Per maggiori informazioni, vedere Sideload dei componenti aggiuntivi Office per il testing da una condivisione di rete o altre risorse Microsoft.

Passaggio 1: creazione e condivisione di una cartella

Procedere come indicato di seguito:

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

2. In Esplora risorse di Windows, andare alla cartella principale o alla lettera di unità della cartella che si desidera utilizzare come catalogo della cartella condivisa. Per esempio: C:\

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

4. Aprire la scheda Condivisione, quindi fare clic sul pulsante Condividi....

   

5. Nella finestra di dialogo, aggiungere se stessi e qualsiasi altro utente e/o gruppo con chi si desidera condividere il componente aggiuntivo. È necessario disporre almeno dell'autorizzazione di lettura/scrittura per la cartella. Una volta scelte le persone con cui si desidera completare la condivisione, fare clic su Condividi.

6. Quando viene visualizzata la conferma che la cartella è stata condivisa, annotare il percorso di rete completo visualizzato immediatamente 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: configurazione manuale della 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 Trust Center, quindi fare clic sul pulsante Impostazioni Trust Center....

   

4. Fare clic su Cataloghi componenti aggiuntivi attendibili.

   

5. nella casella URL catalogo, inserire il percorso di rete completo alla cartella condivisa precedentemente.

6. Fare clic su Aggiungi catalogo.

7. Selezionare la casella di selezione Mostra nel menu per il nuovo elemento aggiunto, quindi fare clic su OK per chiudere la Finestra di dialogo Trust Center.

   

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: sideload del componente aggiuntivo

Procedere come indicato di seguito:

1. Aggiungere il file manifesto del componente aggiuntivo XML 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 Office.

5. Selezionare Qlik per inserire il componente aggiuntivo.

6. Può essere visualizzata una finestra di dialogo con il seguente messaggio: Qlik desidera visualizzare una nuova finestra. Fare clic su Consenti.

Rimozione di un componente aggiuntivo installato tramite la condivisione di rete

Procedere come indicato di seguito:

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

2. Eliminare i contenuti della seguente cartella: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\.

Opzione 3: Caricare lateralmente un componente aggiuntivo nelle applicazioni macOS desktop

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

Seguire le linee guida seguenti. Le istruzioni sono state adattate dalla documentazione Microsoft ufficiale. Per le istruzioni complete, consultare la documentazione ufficiale di Microsoft: Sideload e componenti aggiuntivi di Office sul Mac.

Procedere come indicato di seguito:

1. Aprire l'applicazione Finder sul computer.

2. Premere la seguente combinazione di tasti sulla tastiera: Comando+Maiusc+G.

   Viene visualizzato 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

   È possibile succedere che la cartella wef non esiste ancora sul computer. Se questo è il caso, crearla in questa posizione.

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

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

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

7. Selezionare il componente aggiuntivo di Qlik.

Ora il componente aggiuntivo di Qlik dovrebbe essere disponibile nella barra multifunzione.

Rimozione di un componente aggiuntivo installato mediante sideload dalle applicazioni desktop macOS

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

• Rimozione di un componente aggiuntivo installato mediante sideload

• Cancellazione della cache di Office

Risoluzione dei problemi

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

Per altri suggerimenti per la risoluzione di problemi, vedere Risoluzione di problemi - Creazione di report in-app.

Finestra di dialogo vuota mostrata 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)