Vai al contenuto principale Passa a contenuto complementare

Creazione di report in-app negli spazi gestiti

È possibile configurare report in-app per le applicazioni che richiedono una data governance rigorosa. Con gli stessi principi che si usano per lo sviluppo di modelli dati dell'applicazione da usare negli spazi gestiti, è possibile preparare l'applicazione per le funzionalità di creazione di report in-app. Per raggiungere questo obiettivo, basta utilizzare una sintassi con riconoscimento dello spazio nello script di caricamento.

video thumbnail

Quando si sviluppa un'applicazione in preparazione per la pubblicazione in uno spazio gestito, considerare i seguenti fattori:

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

  • È necessario aggiungere una lista di distribuzione all'applicazione prima di pubblicarla. Durante lo sviluppo, questa può essere composta da sorgenti dati fittizie, anziché dalle sorgenti dati effettive. Poiché si fa riferimento alle sorgenti nella lista di distribuzione nello script di caricamento, quest'ultimo deve essere scritto in preparazione per la pubblicazione, utilizzando una sintassi con riconoscimento dello spazio. Tale sintassi viene utilizzata automaticamente per impostazione predefinita se si carica una lista di distribuzione come file sorgente.

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

Configurazioni di report esistenti

Qualora si fosse creata una configurazione per il Creazione report e una lista di distribuzione prima del 26 marzo 2024, è necessario essere consapevoli 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 Creazione report veniva rinominato automaticamente e aggiunto allo spazio. Il riferimento al file rinominato veniva quindi aggiunto automaticamente allo script di caricamento. Ora, il file sorgente non viene più rinominato quando viene aggiunto allo spazio.

Per continuare a utilizzare le configurazioni esistenti per i report quando si pubblicano queste applicazioni, seguire la sezione corrispondente di seguito, a seconda delle sorgenti della lista di distribuzione. In alternativa, ricreare la configurazione per il Creazione report da zero, seguendo le istruzioni elencate più avanti su questa pagina.

File sorgente caricato in precedenza

Aprire l'Editor caricamento dati e verificare i riferimenti ai nomi file nella sezione dello script per la Lista di distribuzione. Apportare modifiche alla sintassi in modo da utilizzare un riferimento con riconoscimento dello spazio che punta allo spazio corrente, anziché a qualsiasi spazio specifico. Per esempio, un file di riferimento potrebbe assomigliare a questo:

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

Modificarlo come mostrato di seguito:

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

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

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

Utilizzo di sorgenti dati configurate manualmente in precedenza nello script

Se al contrario si è configurato manualmente lo script di caricamento in modo da basarsi su altre sorgenti dati per la lista di distribuzione, basta regolare lo script di caricamento perché contenga riferimenti relativi, e con riconoscimento dello spazio, alle sorgenti dati (se non lo si è già fatto).

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

Flusso di lavoro

Seguire la sequenza riportata sotto per utilizzare i report in-applicazione in uno spazio gestito.

Sviluppo di applicazioni

Sviluppare l'applicazione nel proprio spazio di sviluppo (personale o condiviso), come si farebbe normalmente, in preparazione per la pubblicazione nello spazio gestito.

Sviluppo di modelli e filtri

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

Se si creano i modelli prima della pubblicazione e si desidera utilizzarli per l'applicazione pubblicata, cambiare l'applicazione Qlik Sense connessa per i modelli. Per i modelli Excel, è possibile eseguire questa azione nel componente aggiuntivo. In alternativa, eseguire questa azione nell'Qlik Sense applicazione mentre si caricano i modelli nell'applicazione pubblicata. Vedere Modifica l'applicazione Qlik Sense connessa.

Preparazione del 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.

A questo punto, la lista di distribuzione deve essere semplicemente un segnaposto per il file effettivo o altre sorgenti che si desidera utilizzare per la lista di distribuzione nello spazio gestito.

La procedura è leggermente differente, dipendendo se la lista di distribuzione è un file sorgente o una sorgente dati remota aggiunta manualmente allo script. Tuttavia, i concetti di base sono gli stessi. Per una guida completa su come utilizzare una sintassi con riconoscimento dello spazio nello script di caricamento, vedere Sorgenti dati per applicazioni in spazi gestiti.

Opzione 1: caricamento diretto del file sorgente

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

Anziché aggiungere i dettagli definitivi del file di destinazione, è possibile inserire qualsiasi segnaposto desiderato. In questa fase quello che importa è caricare un file, che tale file venga quindi aggiunto automaticamente allo spazio di sviluppo e vi si faccia riferimento nello script.

È possibile verificare che la sezione Distribution List nello script di caricamento contenga un riferimento con riconoscimento dello spazio al file, e non faccia riferimento direttamente a qualsiasi spazio particolare. Questa operazione viene eseguita automaticamente quando si carica un file sorgente come lista di distribuzione nella sezione Creazione report dell'applicazione. Dovrebbe assomigliare a qualcosa di simile a questo:

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

Questo esempio è un riferimento con riconoscimento dello spazio che punta allo spazio corrente nel quale si trova l'applicazione. Il punto e virgola extra prima di DataFiles fornisce il riferimento relativo richiesto.

Successivamente, quando si pubblica l'applicazione nello spazio gestito, caricare il file della lista di distribuzione effettiva nello spazio gestito. La lista di distribuzione effettiva deve avere lo stesso nome file del file a cui si fa riferimento nello script.

Opzione 2: riferimento manuale alle sorgenti dati nello script

Seguire la procedura ordinaria per connettere le sorgenti remote della lista di distribuzione manualmente nello script: Definizione della lista di distribuzione manualmente nello script di caricamento.

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

Pubblica l'applicazione

Una volta 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.

Modifica l'applicazione Qlik Sense connessa

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

Questa procedura può essere completata automaticamente in Qlik Sense durante il caricamento del modello. Per i formati di modello basati su Microsoft OfficeExcel, PowerPoint o Word—questo può essere fatto anche nel componente aggiuntivo corrispondente. Prima di iniziare, è possibile creare una copia separata del modello per distinguerla dal modello per l'applicazione sorgente.

Per le istruzioni complete, vedere:

Nota di suggerimentoUna buona pratica è sviluppare il modello su un'applicazione sorgente situata in uno spazio condiviso. Quando è necessario pubblicare l'applicazione in uno spazio gestito, scaricare il modello direttamente dall'applicazione di origine e caricarlo nell'applicazione pubblicata. Quando l'applicazione e le sue esigenze di reportistica cambiano nel tempo, è possibile seguire questo flusso di lavoro quando si caricano nuove versioni del modello.

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

Aggiunta delle sorgenti della lista di distribuzione effettiva

Nello spazio gestito, creare le connessioni e i file richiesti per caricare la lista di distribuzione, utilizzando lo stesso riferimento dello 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.

Creazione di nuove risorse di reportistica

Ora è possibile aggiungere risorse di reportistica all'applicazione. Queste possono essere costituite dai modelli, filtri e attività di report.

Autorizzazioni

Per lavorare con il reporting nell'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 per lo spazio gestito:

    • Proprietario

    • Può gestire

    • Può eseguire operazioni

    Nota informaticaPer le sottoscrizioni basate sull'utente, il ruolo Può operare richiede anche un Professional diritto utente.

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

Limitazioni

La funzionalità per la creazione di report in-app non è disponibile per le applicazioni pubblicate o distribuite da Client-Managed Qlik Sense (incluse le distribuzioni multi-cloud) in Qlik Cloud. Per utilizzare la funzionalità per la creazione di report in-app con queste applicazioni, migrare l'applicazione utilizzando lo Strumento di migrazione Qlik Analytics o esportare manualmente l'applicazione e ricaricarla in Qlik Cloud.

Per ulteriori informazioni, vedere Creazione di report in-applicazione con applicazioni esportate o migrate.

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!