Reporting in-applicazione negli spazi gestiti

È possibile configurare report in-applicazione per le applicazioni che richiedono una rigorosa governance dei dati. Con gli stessi principi utilizzati per lo sviluppo di modelli dati dell'applicazione da utilizzare negli spazi gestiti, è possibile preparare l'applicazione per le funzionalità di reporting in-applicazione. Questo si ottiene utilizzando una sintassi sensibile allo spazio nello script di caricamento.

Quando si sviluppa un'applicazione in preparazione per la pubblicazione in uno spazio gestito, considerare quanto segue:

• I modelli possono essere sviluppati prima o dopo la pubblicazione dell'applicazione. Se si crea il modello prima della pubblicazione, modificare l'applicazione connessa dopo la pubblicazione.

• Una lista di distribuzione deve essere aggiunta all'applicazione prima di pubblicare l'applicazione. Durante lo sviluppo, questa può essere costituita da sorgenti dati fittizie, anziché dalle sorgenti dati effettive. Le sorgenti nella lista di distribuzione sono referenziate nello script di caricamento, quindi lo script deve essere scritto in preparazione alla pubblicazione, utilizzando una sintassi sensibile allo spazio. Questa sintassi viene utilizzata automaticamente per impostazione predefinita se si carica una lista di distribuzione come file sorgente.

• Dopo la pubblicazione, le risorse di reporting – modello, filtri e attività di report – possono essere ricreate come desiderato, in base al caso d'uso di reporting per l'applicazione pubblicata. Le sorgenti dati reali utilizzate nella lista di distribuzione devono essere aggiunte allo spazio gestito.

Configurazioni di report esistenti

Se è stata creata una configurazione di reporting e una lista di distribuzione prima del 26 marzo 2024, è necessario essere a conoscenza delle modifiche al processo di caricamento dei file per le liste di distribuzione.

Per le applicazioni create prima del 26 marzo 2024, un file sorgente della lista di distribuzione caricato nella sezione Reporting veniva rinominato automaticamente e aggiunto allo spazio. Il riferimento a questo file rinominato veniva quindi aggiunto automaticamente allo script di caricamento. Il file sorgente caricato ora non viene più rinominato quando viene aggiunto allo spazio.

Per continuare a utilizzare le configurazioni di report esistenti durante la pubblicazione di queste applicazioni, seguire la sezione corrispondente di seguito, a seconda delle sorgenti della lista di distribuzione. In alternativa, ricreare la configurazione di reporting da zero, utilizzando le guide mostrate più avanti in questa pagina.

Se è stato caricato un file sorgente

Aprire l'Editor caricamento dati e osservare i riferimenti ai nomi dei file nella sezione dello script Lista di distribuzione. Regolare la sintassi in modo che utilizzino un riferimento sensibile allo spazio che punta allo spazio corrente, anziché a uno spazio specifico. Ad esempio, un riferimento a un file potrebbe avere questo aspetto:

FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"

Modificarlo in:

FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"

È possibile notare che l'ID dell'applicazione dell'applicazione sorgente è contenuto nel nome del file. Se si desidera che questo script esatto venga eseguito quando si pubblica l'applicazione, aggiungere il file effettivo della lista di distribuzione allo spazio gestito, con questo nome esatto.

In alternativa, è possibile rinominare il file sorgente nello spazio di sviluppo, aggiornare lo script di caricamento e quindi pubblicare. Infine, aggiungere il file effettivo della lista di distribuzione, con il nome aggiornato.

Se sono state utilizzate sorgenti dati remote manualmente nello script

Se invece si è configurato manualmente lo script di caricamento per fare affidamento su altre sorgenti dati per la lista di distribuzione, è sufficiente regolare lo script di caricamento in modo che contenga riferimenti relativi e sensibili allo spazio alle sorgenti dati (se non è già stato fatto).

Per ulteriori informazioni ed esempi specifici, vedere Sorgenti dati per applicazioni in spazi gestiti.

Flusso di lavoro

Seguire la sequenza seguente per lavorare con il reporting in-applicazione in uno spazio gestito.

Sviluppo dell'applicazione

Sviluppare l'applicazione nello spazio di sviluppo (spazio personale o condiviso), come si farebbe normalmente, in preparazione alla sua pubblicazione nello spazio gestito.

Sviluppare i modelli e i filtri

Se lo si desidera, è possibile creare i modelli di report e i filtri prima di pubblicare l'applicazione. Questo può essere utile come fase nello sviluppo dell'applicazione, ma i modelli e i filtri aggiunti all'applicazione sorgente non vengono mantenuti nella copia pubblicata.

Se si creano i modelli prima della pubblicazione e si desidera utilizzarli per l'applicazione pubblicata, modificare l'applicazione Qlik Sense connessa per i modelli. Per i modelli Excel, PowerPoint e Word, è possibile eseguire questa azione nel componente aggiuntivo. In alternativa, eseguire questa azione nell'applicazione Qlik Sense durante il caricamento dei modelli nell'applicazione pubblicata. Vedere Modificare l'applicazione Qlik Sense connessa.

Preparare il riferimento alla lista di distribuzione

Quando si aggiunge una lista di distribuzione a un'applicazione, lo script di caricamento dell'applicazione viene modificato. Lo script di caricamento di un'applicazione non è accessibile in un'applicazione pubblicata. Pertanto, è necessario aggiungere una lista di distribuzione all'applicazione prima di pubblicarla.

In questa fase, la lista di distribuzione deve semplicemente essere un segnaposto per il file effettivo o altre sorgenti che verranno utilizzate per la lista di distribuzione nello spazio gestito.

La procedura è leggermente diversa, a seconda che la lista di distribuzione sia un file sorgente o una sorgente dati remota aggiunta manualmente nello script. Tuttavia, i concetti di base sono gli stessi. Per una guida completa che illustra come utilizzare la sintassi sensibile allo spazio nello script di caricamento, vedere Sorgenti dati per applicazioni in spazi gestiti.

Opzione 1: Caricamento diretto del file sorgente

Seguire la procedura standard per il caricamento di un file sorgente come lista di distribuzione: Aggiunta della lista di distribuzione caricando un file sorgente.

Invece di aggiungere i dettagli finalizzati del destinatario, è possibile inserire eventuali segnaposto desiderati. La cosa importante qui è che si carichi un file e che questo file venga quindi aggiunto automaticamente allo spazio di sviluppo e referenziato nello script.

È possibile verificare che la sezione Distribution List nello script di caricamento contenga un riferimento sensibile allo spazio al file e non faccia riferimento diretto ad alcuno spazio in particolare. Questo viene fatto automaticamente quando si carica un file sorgente come lista di distribuzione nella sezione Reporting dell'applicazione. Dovrebbe avere un aspetto simile a questo:

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

Questo esempio è un riferimento sensibile allo spazio che punta allo spazio corrente in cui si trova l'applicazione. I due punti aggiuntivi prima di DataFiles forniscono il riferimento relativo richiesto.

In seguito, quando si pubblica l'applicazione nello spazio gestito, caricare il file effettivo della lista di distribuzione nello spazio gestito. La lista di distribuzione effettiva deve avere lo stesso nome file del file referenziato nello script.

Opzione 2: Riferimento manuale alle sorgenti dati nello script

Seguire la procedura standard per la connessione manuale alle sorgenti remote della lista di distribuzione nello script: Definizione manuale della lista di distribuzione nello script di caricamento.

Quando si scrive lo script per connettersi alle sorgenti dati richieste per la lista di distribuzione, è possibile utilizzare riferimenti fittizi ai file e alle connessioni in base alle necessità. Nello script, le sorgenti dati devono semplicemente avere gli stessi nomi che avranno nello spazio gestito e i riferimenti a queste sorgenti devono utilizzare una sintassi relativa e sensibile allo spazio.

Pubblicare l'applicazione

Dopo aver preparato lo script di caricamento e la lista di distribuzione, l'applicazione è pronta per essere pubblicata nello spazio gestito. Per ulteriori informazioni sulla pubblicazione di un'applicazione, vedere Pubblicazione di applicazioni.

Creare filtri a livello di oggetto

Se il modello utilizza filtri su singoli oggetti del report (vedere Utilizzo di filtri a livello di oggetto nei modelli di report), è necessario creare i filtri di report corrispondenti nell'applicazione pubblicata prima di caricare qualsiasi modello che utilizzi questi filtri. I filtri di report creati devono avere nomi che corrispondono a quelli nell'applicazione sorgente.

Modificare l'applicazione Qlik Sense connessa

Se è stato creato un modello di report prima di pubblicare l'applicazione, è necessario aggiornare il modello in modo che faccia riferimento all'ID dell'applicazione corretto. Una copia pubblicata di un'applicazione avrà un ID dell'applicazione diverso rispetto all'applicazione sorgente.

Questo processo può essere completato automaticamente in Qlik Sense durante il caricamento di un modello. Per i formati di modello basati su Microsoft Office—Excel, PowerPoint o Word—questo può essere fatto anche nel componente aggiuntivo corrispondente. Prima di iniziare, è possibile creare una copia separata del modello per distinguerlo dal modello per l'applicazione sorgente.

Per le istruzioni complete, vedere:

• Da Qlik Sense: Modifica dell'Qlik Sense applicazione connessa

• Dai componenti aggiuntivi Qlik per Microsoft Office: Modifica dell'app Qlik Sense connessa

È sempre possibile sviluppare e aggiornare i modelli direttamente nello spazio gestito.

Aggiungere le sorgenti effettive della lista di distribuzione

Nello spazio gestito, creare i file e le connessioni necessari per caricare la lista di distribuzione, come referenziato nello script di caricamento. Questo passaggio può essere completato in qualsiasi momento.

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.

Quando le sorgenti connesse vengono aggiunte allo spazio, dovrebbe essere possibile ricaricare l'applicazione.

Creare le nuove risorse di reporting

Ora è possibile aggiungere risorse di reporting all'applicazione. Queste potrebbero consistere nei modelli, nei filtri e nelle attività di report.

Autorizzazioni

Per lavorare con il reporting in-applicazione per le applicazioni negli spazi gestiti, è necessario:

• 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.

• Uno dei seguenti ruoli di spazio nello spazio gestito:

  • Proprietario

  • Può gestire

  • Può operare

  Nota informaticaPer gli abbonamenti basati sull'utente, il ruolo Può operare richiede anche un'assegnazione utente Professional.

Per maggiori informazioni sulle autorizzazioni negli spazi per la creazione di report, vedere Autorizzazioni per il ruolo Servizio di reportistica Qlik.

Limiti