Creazione di una lista di distribuzione per il report
Prima di creare un'attività di report, è necessario definire la lista di distribuzione per l'applicazione Qlik Sense che è alla base del report. La lista di distribuzione contiene tutti i destinatari e i gruppi di destinatari che possono ricevere le attività di report di un'applicazione.
Utilizzare la lista di distribuzione per configurare gli individui a cui inviare i report. Quando si configura un'attività di Creazione report, l'utente seleziona i destinatari e i gruppi dalla lista di distribuzione che riceveranno l'output per quell'attività di Creazione report specifica.
La lista di distribuzione fornisce i seguenti dettagli:
-
Tutti i destinatari dei report generati dall'applicazione, inclusi i loro nomi, indirizzi e-mail, i filtri applicati loro e i gruppi a cui appartengono.
-
Tutti i gruppi (raccolte di uno o più destinatari) che possono ricevere i report generati dall'applicazione.
Se si carica un file sorgente come lista di distribuzione, viene visualizzato nelle schede Destinatari e Gruppi all'interno della sezione Creazione report dell'applicazione.
Le schede Destinatari e Gruppi
È possibile aggiungere un solo file sorgente a un'applicazione. Se è necessario apportare modifiche al file sorgente, modificare il file (o la sorgente dati) caricato originariamente e ricaricarlo. Se al contrario si utilizzano delle connessioni dati per definire la lista di distribuzione, apportare le modifiche allo script in base alle necessità. Notare che in tal caso, è necessario apportare delle modifiche equivalenti a configurazione dell'attività di reporting e filtri, se necessario.
Chi può ricevere i report?
Utilizzando la funzionalità di reporting in-app con Qlik Cloud Analytics, è possibile inviare report e-mail a destinatari interni ed esterni.
Output e Section Access
La tabella sottostante descrive ogni tipo di destinatario e il contenuto che è possibile visualizzare nei report. Questa tabella delinea il comportamento per le applicazioni con e senza Section Access. Per maggiori informazioni sulla creazione di report in-app e Section Access, vedere Creazione di report in-app e Section Access.
| Tipo di destinatario | Descrizione | Comportamento |
|---|---|---|
| Interne |
Un utente nel tenant Qlik Cloud, identificato dall'indirizzo e-mail corrispondente (la corrispondenza non distingue tra maiuscole e minuscole). Per sapere come aggiungere un utente al tenant Qlik Cloud, vedere:
|
Se l'applicazione non utilizza Section Access, i dati inclusi nel report di questo destinatario dipenderanno dal tipo di accesso di cui il proprietario dell'attività di report dispone per l'applicazione. |
| Esterni | Un utente che non è nel tenant Qlik Cloud. | I dati inclusi nel report si basano sempre sul tipo di accesso di cui dispone il proprietario dell'attività di report, indipendentemente dal fatto che l'applicazione utilizzi Section Access o meno. |
Distribuzione di report Microsoft SharePoint
Se invece si desidera distribuire i report tramite una cartella di distribuzione (Microsoft SharePoint), chiunque abbia accesso alla posizione specificata nella connessione corrispondente può accedere ai report. L'identificazione di destinatari interni funziona allo stesso modo dell'output dei messaggi e-mail.
La consegna dei report tramite la cartella di distribuzione di Microsoft SharePoint non è disponibile se l'applicazione utilizza Section Access.
Quando si inviano report tramite una cartella di distribuzione, è comunque necessario definire un elenco di distribuzione affinché l'applicazione generi l'output del report. La lista di distribuzione consente ancora di determinare il numero di versioni dell'output dei report da generare quando le attività di report vengono eseguite (un file per il filtro di ogni destinatario individuale). Per maggiori informazioni su come archiviare i report in una cartella di distribuzione, vedere Consegna di report in una cartella di distribuzione.
Lista di distribuzione, filtri dei destinatari e output delle attività
La lista di distribuzione consente di controllare i filtri dei report applicati in modo individuale a ogni destinatario.Quando si aggiunge l'elenco di distribuzione all'applicazione, viene creato un destinatario separato per ogni filtro applicato. Quando si configura un'attività di Creazione report, ogni destinatario viene aggiunto come abbinamento utente-filtro corrispondente a un singolo filtro.
Ad esempio, se si applicano i filtri A e B a un destinatario denominato User1, all'applicazione vengono aggiunti due destinatari: User1 con il filtro A e User1 con il filtro B.
Per maggiori informazioni su come configurare l'attività di report per generare l'output richiesto, vedere:
Considerazioni per la proprietà delle attività per i ricaricamenti pianificati
Gli elenchi di distribuzione funzionano attraverso modifiche automatiche o manuali allo script di caricamento di un'applicazione. Quando si crea o si modifica la lista di distribuzione di un'applicazione, sia caricando un file di origine nella sezione Creazione report o tramite la modifica manuale dello script di caricamento, si diventa il nuovo proprietario di tutte le attività create per i ricaricamenti pianificati di tale applicazione.
Per ulteriori informazioni, vedere Proprietà delle attività.
Aggiunta della lista di distribuzione
Aggiungere la lista di distribuzione utilizzando uno dei seguenti metodi:
-
Caricamento di un file sorgente
-
Definire i destinatari e i gruppi manualmente nello script di caricamento
Nelle sezioni sottostanti, viene illustrato ogni metodo disponibile.
Aggiunta della lista di distribuzione caricando un file sorgente
È possibile definire una lista di distribuzione caricando un file sorgente contenente le informazioni richieste. Il file deve contenere una formattazione e una struttura specifiche. Il modo più facile per creare il file sorgente è scaricare il file di esempio e modificarlo con le informazioni su destinatari e gruppi.
Caricamento di un file sorgente come lista di distribuzione sostituisce il file sorgente esistente, nel caso ve ne sia già uno. Solo un file sorgente può essere applicato a un'applicazione. Se si carica un file sorgente, quest'ultimo sostituisce il file sorgente caricato precedentemente nell'applicazione, se presente. Questa operazione può causare l'errore dell'attività di report esistente se vi sono delle corrispondenza errate tra i nuovi file e quelli precedenti.
Quando si aggiunge una lista di distribuzione caricando un file sorgente, una nuova sezione (Distribution List) viene generata automaticamente nello script di caricamento dell'applicazione, e l'applicazione viene ricaricata. Questa sezione dello script elenca i destinatari e i gruppi per l'applicazione. I dettagli nel file di distribuzione diventano quindi accessibili nel modello dati dell'applicazione.
Quando si carica un file sorgente come lista di distribuzione, il file viene aggiunto anche come file di dati allo spazio contenente l'applicazione. La sezione dello script Distribution List fa riferimento a questo file come un elemento all'interno dello spazio.
Considerazioni
Tenere presente i seguenti dettagli che è importante conoscere prima di caricare un file sorgente:
-
La nuova sezione dello script Distribution List viene aggiunta come l'ultima sezione nello script. Come risultato, qualsiasi problema di formattazione dello script nell'ultima sezione prima della Distribution List causerà un errore di ricaricamento. Per esempio, potrebbe mancare un punto e virgola alla fine dell'ultima tabella, impedendone il caricamento.
-
Non modificare le espressioni della funzione SubField nella sezione dello script della Distribution List generata automaticamente. Queste espressioni sono richieste per supportare i valori separati da virgola per filtri e gruppi.
SubField([Filters],',') AS [DL_DISTRIBUTION_FILTERS], SubField([Groups],',') AS [DL_DISTRIBUTION_GROUP_NAMES] -
Poiché il caricamento del file sorgente funziona caricando i dati nell'applicazione, viene conteggiato anche nel volume di caricamento dati acquistato definito nella sottoscrizione Qlik Cloud (applicabile solo per le sottoscrizioni basate sulla capacità). Vedere Sottoscrizioni di Qlik Cloud basate sulla capacità.
Scaricamento del file di esempio
Il file sorgente di esempio è una cartella di lavoro Excel che è possibile modificare prima di caricarla nell'applicazione.
Procedere come indicato di seguito:
-
Aprire la scheda Destinatari o Gruppi nella sezione Creazione report di un'applicazione.
-
Fare clic su Aggiungi destinatari e gruppi.
-
Selezionare
Scarica esempio.
Scaricamento del file della lista di distribuzione di esempio
Dopo aver scaricato il file di esempio, è possibile modificarlo per aggiungere i destinatari e i gruppi per l'applicazione.
Aggiunta dei destinatari
Aprire il file di esempio appena scaricato e assicurarsi di aprire il seguente foglio di lavoro:
DL_DISTRIBUTION_SVC_USERS_QCS
Quindi, è possibile sostituire i dati nel foglio per aggiungere i destinatari desiderati. Non cambiare o rimuovere la prima riga che mostra le intestazioni delle colonne.
Procedere come indicato di seguito:
-
Nella colonna Nome, aggiungere il nome dei destinatari.
-
Nella colonna E-mail, aggiungere l'indirizzo e-mail dei destinatari. Notare che questa colonna viene formattata automaticamente, in modo da funzionare da collegamento ipertestuale alla destinazione di un indirizzo e-mail.
-
Nella colonna Filtri, aggiungere i gruppi di filtri che corrispondono a quelli aggiunti nella scheda Filtri nella sezione Creazione report dell'applicazione. Separare i gruppi di filtri con delle virgole.
-
Nella colonna Gruppi, aggiunge e i gruppi a cui appartiene il destinatario. Separare ogni gruppo con una virgola.
Aggiunta di gruppi
Nel file sorgente, i gruppi vengono definiti nel foglio con questo titolo:
DL_DISTRIBUTION_SVC_gruppi_QCS
Aprire il foglio di lavoro e sostituire i dati per creare i gruppi nella lista di distribuzione. Non cambiare o rimuovere la prima riga che mostra le intestazioni delle colonne.
Procedere come indicato di seguito:
-
Nella colonna Nome, aggiungere il nome del gruppo.
-
Nella colonna Descrizione, aggiungere una descrizione del gruppo.
Caricamento del file della lista di distribuzione
Dopo aver creato il file sorgente, caricarlo nelle schede Destinatari o Gruppi nella sezione Creazione report dell'applicazione. Quando si esegue questa operazione, l'applicazione si ricarica e i destinatari e i gruppi vengono popolati nelle rispettive sezioni.
Procedere come indicato di seguito:
-
Aprire la scheda Destinatari o Gruppi.
-
Fare clic su Aggiungi destinatari e gruppi.
-
Selezionare Carica nuova versione (.xlsx).
Caricamento del file sorgente
Definizione della lista di distribuzione manualmente nello script di caricamento
L'aggiunta di un elenco di distribuzione tramite caricamento di file modifica indirettamente lo script di caricamento dell'applicazione. In alternativa, utilizzare lo script di caricamento direttamente per aggiungere destinatari e gruppi. Questa opzione è adatta per gli utenti avanzati, ed è particolarmente utile se si desidera utilizzare connessioni per la sorgente dati per fornire le informazioni su destinatari e gruppi.
Ad esempio, se i destinatari e i gruppi sono definiti in un file sorgente esterno o si trovano in un database o un sistema di risorse umane (ad esempio, Workday), questa opzione consente ai destinatari e ai gruppi nell'applicazione di aggiornarsi dinamicamente in base alla sorgente connessa.
Requisiti
Affinché i campi nello script vengano riconosciuti come appartenenti all'elenco di distribuzione dell'applicazione, è necessario applicare tag a ogni campo richiesto che corrisponde all'elemento richiesto dell'elenco di distribuzione. Vedere la tabella sottostante per maggiori informazioni.
| Campo che richiede un tag | Tag richiesto | Esempio |
|---|---|---|
| Nome destinatario | DL_DISTRIBUTION_SVC__recipientName | tag field [GetSheetValues.Name] with 'DL_DISTRIBUTION_SVC__recipientName' |
| Indirizzo e-mail destinatario | DL_DISTRIBUTION_SVC__recipientEmail | tag field [GetSheetValues.Email] with 'DL_DISTRIBUTION_SVC__recipientEmail' |
| Filtri destinatario | DL_DISTRIBUTION_SVC__recipientFilters | tag field [GetSheetValues.Filters] with 'DL_DISTRIBUTION_SVC__recipientFilters' |
| Nome gruppo | DL_DISTRIBUTION_SVC__groupsName | tag field [GetSheetValues.Groups] with 'DL_DISTRIBUTION_SVC__groupsName' |
| Descrizione gruppo | DL_DISTRIBUTION_SVC__groupDescription | tag field [GetSheetValues.GroupDescription] with 'DL_DISTRIBUTION_SVC__groupDescription' |
Script di esempio
Di eseguito ecco un esempio della sezione di uno script connessa a destinatari e gruppi:
Eliminazione di una lista di distribuzione
Se necessario, è possibile rimuovere tutti i destinatari e i gruppi dall'applicazione.
Procedere come indicato di seguito:
Aprire la scheda Destinatari o Gruppi.
Fare clic su
accanto a qualsiasi destinatario o gruppo e selezionare 
Elimina tutto.
Creazione di report in-applicazione e Section Access
Se l'applicazione utilizza Section Access, la generazione dei report funziona in modo differente. Per ulteriori informazioni, vedere Creazione di report in-app e Section Access.
Liste di distribuzione negli spazi gestiti
Per le applicazioni negli spazi gestiti, la lista di distribuzione non può essere modificata dalla sezione Creazione report dell'applicazione. Prima di pubblicare un'applicazione in uno spazio gestito, caricare una lista di distribuzione fittizia oppure, fare riferimento manualmente alle risorse remote richieste nello script. Si consiglia di utilizzare una sintassi che riconosce gli spazi nello script di caricamento. In altre parole, i riferimenti alle sorgenti dati dovrebbero puntare allo spazio corrente nel quale è posizionata l'applicazione. A seconda di come si aggiunge la lista di distribuzione, questa sintassi può essere utilizzata automaticamente.
Le sorgenti dati che forniscono la lista di distribuzione devono avere gli stessi nomi dei parametri (nomi di connessioni, file e campi) delle sorgenti della lista di distribuzione utilizzate nello script di caricamento dell'applicazione sorgente.
L'utente carica le sorgenti dati effettive per la lista di distribuzione nello spazio gestito.
Per maggiori informazioni, fare riferimento alle seguenti guide:
Autorizzazioni per le liste di distribuzione
Per gestire la lista di distribuzione di un'applicazione, sono necessari:
Autorizzazioni assegnate a te da un amministratore tenant. Per maggiori informazioni, un amministratore può fare riferimento a Impostazione delle autorizzazioni per le funzionalità di reporting a consumo.
Per maggiori informazioni sulle autorizzazioni negli spazi per la creazione di report, vedere Autorizzazioni per il ruolo Servizio di reportistica Qlik.
Autorizzazioni per gli spazi
La gestione della lista di distribuzione in un'applicazione Qlik Sense richiede ruoli specifici per lo spazio. I requisiti dipendono dal tipo di spazio in cui si trova la tua applicazione.
Requisiti per le applicazioni negli spazi condivisi
I seguenti requisiti si applicano per le applicazioni negli spazi condivisi:
Per visualizzare la lista di distribuzione nella sezione Creazione report dell'applicazione, è necessario disporre dell'accesso Può modificare allo spazio.
Per modificare, ricaricare ed eliminare la lista di distribuzione, è necessario disporre dell'accesso Può modificare i dati nelle applicazioni per quello spazio.
Per ulteriori informazioni, vedere Gestione delle autorizzazioni negli spazi condivisi.
Requisiti per le applicazioni negli spazi gestiti
La lista di distribuzione non è configurabile direttamente in uno spazio gestito. Lo script di caricamento fa riferimento alle sorgenti dati che verranno utilizzate per caricare la lista di distribuzione. Per aggiungere queste sorgenti dati allo spazio, è necessario disporre di autorizzazioni richieste per aggiungere e gestire sorgenti dati in uno spazio gestito. Per ulteriori informazioni, vedere Gestione delle autorizzazioni negli spazi gestiti.
Per maggiori informazioni sulla creazione di report nell'applicazione negli spazi gestiti, vedere Creazione di report in-app negli spazi gestiti.
Requisiti per un'applicazione nel tuo spazio personale
Per avere il controllo completo sulla lista di distribuzione, è necessario disporre del ruolo utente Private Analytics Content Creator nel tenant.
Limitazioni della lista di distribuzione
Non è possibile utilizzare le virgole nei campi contenenti i nomi di destinatari e gruppi e negli indirizzi e-mail dei destinatari. Questa limitazione si applica sia quando si carica la lista di distribuzione come un file e anche quando la si definisce manualmente nello script di caricamento.
È possibile aggiungere un massimo di 1000 destinatari e 1000 gruppi alla lista di distribuzione di un'applicazione. Il numero totale di destinatari, in gruppi o meno, non può essere superiore a 1000.