Vai al contenuto principale Passa a contenuto complementare

Data binding

You use the assets from your Qlik Sense app as the data sources for your report. In your PixelPerfect report template, add data bindings for the app data and images you want to use in the report. Then, connect these data bindings to objects in your template. Data bindings are added in the Database icon with plus symbol Field List menu in the PixelPerfect designer.

Data bindings in the Field List

Image showing the 'Field List' menu expanded in the right side panel of the designer. The 'Field List' menu shows several example data bindings that have been added, such as levels and tables

What is a data binding?

A data binding is a reusable entity that you create in your report template, which contains the data from the app that you then use in your report content. When you add a data binding, the data source to which it refers becomes usable in your template.

A data binding can be reused across multiple objects and bands in your report. For example, you could add a table data binding for a specific pie chart in the app. This data binding could be connected to different objects in the app – for example, it could be used in a native PixelPerfect bar chart and a Cross Tab.

Types of data bindings

Data bindings are added in the Database icon with plus symbol Field List menu that is available on the right side panel in the designer. From this menu, you can add the following types of data bindings.

Levels

Add a field or chart in the app as a level data binding. Level data bindings are often used to bind to bands, looping the creation of distinct content filtered for each value in a dimension.

For more information about using levels to loop over dimensions, see:

You can also add a level data binding and connect it directly to an object in the template. For example, you want to add a label and use it as a title for a section containing looped charts.

Level data bindings are a key element of highly formatted PixelPerfect tables. For more information, see Creating highly formatted tables.

Images

Add images of your Qlik Sense visualizations directly onto your report.

For more information, see Adding images to the report template.

Tables

Add the source table for a visualization as a table data binding. The visualization does not have to be a table. Some Qlik Sense chart types – for example, treemap – cannot be added as table data bindings.

Table data bindings cannot be dragged and dropped directly from the Database icon with plus symbol Field List menu. Instead, they are mainly used to create the following:

Variables

Add variables from the Qlik Sense app as variable data bindings. Variables created in the script, as well as those created when editing sheets, can be used.

For more information, see Working with variables and expressions in your PixelPerfect template.

Expressions

Add calculated expressions, that are evaluated using the Qlik engine, as expression data bindings. For example, you could add an expression such as sum(Sales) as a data binding so that it can be used in native PixelPerfect labels with other natural language, or you could reference it in conditional formatting.

For more information, see Working with variables and expressions in your PixelPerfect template.

Adding a data binding

  1. Open the Database icon with plus symbol Field List menu available from the right-side panel in the designer.

  2. Click the plus icon next to the type of data binding you want to add. For details about each type and how it is used, see Types of data bindings.

  3. When applicable, expand the sheet containing the item you want to add, or search for items.

  4. Click the Plus icon next to the item.

    The data binding is added.

How to use data bindings

After you create a data binding, it is not automatically added to your report content. Instead, it is simply now available for use in the report content. To use a data binding in report content, it needs to be connected to an object or band in the template.

Depending on the type, you can use data bindings in the following ways:

  • If available, drag and drop the data binding directly from the Database icon with plus symbol Field List menu onto the canvas.

  • Add an object from the toolbox panel on the left side of the designer, and then connect it to the data binding. This process varies from object to object. The process usually involves selecting a Data Member and/or similar properties for the object.

  • You can sometimes reference the data binding in the Expression Editor.

For full details, refer to Visualizing app data in your report and related topics.

Refreshing data bindings

È possibile aggiornare i dati dell'app di origine utilizzati in:

  • Oggetti di associazione dati per i grafici aggiunti come livelli. Questi vengono aggiunti in Icona del database con il simbolo più Elenco campi > Livelli.

  • Oggetti di associazione dati per le tabelle di origine utilizzate nei grafici PixelPerfect nativi, nei campi incrociati e nei grafici sparkline. Questi vengono aggiunti in Icona del database con il simbolo più Elenco campi > Tabelle.

Questo tipo di grafico è utile per:

  • Le dimensioni e le misure sono state aggiunte o rimosse dal grafico di origine dalla creazione dell'associazione dati.

  • Le definizioni di dimensioni e misure sono state modificate nel grafico di origine dalla creazione dell'associazione dati.

L'aggiornamento delle sorgenti delle associazioni dati consente di mantenere gli stessi oggetti nel menu Icona del database con il simbolo più Elenco campi, senza doverne creare di nuovi quando le configurazioni del grafico cambiano.

  1. Prima di iniziare, rimuovere tutte le istanze delle colonne e dei campi rimossi o aggiornati dal modello. Questo non è necessario se gli aggiornamenti del grafico si limitano ad aggiungere nuove colonne o campi.

    Questo può comportare una delle seguenti azioni:

    • Rimuovere il riferimento al campo o alla colonna rimossi nelle proprietà del gruppo di report.

    • Per i livelli del grafico, i grafici sparkline e i campi incrociati, rimuovere i riferimenti ai campi eliminati utilizzando l'Editor delle espressioni dopo aver selezionato il livello.

    • Per i grafici PixelPerfect nativi, rimuovere i riferimenti alle colonne eliminate nelle proprietà dell'oggetto. È possibile completare questa azione in Strumento di progettazione dei grafici.

  2. Aprire il menu Elenco campi Icona del database con il simbolo più, disponibile nel pannello laterale destro dello strumento di progettazione.

  3. Fare doppio clic su Livelli o su Tabelle per espandere l'opzione.

  4. Posizionare il cursore sull'elemento che si desidera aggiornare.

  5. Fare clic sull'icona Aggiorna (Aggiorna campi o Aggiorna colonne).

    Aggiornamento dell'associazione dati di un livello nel menu Elenco campi

    Clic sull'icona "Aggiorna campi" per aggiornare l'associazione dati di un livello

    Aggiornamento dell'associazione dati di una tabella nel menu Elenco campi

    Clic sull'icona "Aggiorna colonne" per aggiornare l'associazione dati di una tabella

    Se gli elementi del grafico sono stati modificati durante l'aggiornamento, appare un avviso che elenca ogni modifica. Le modifiche possono includere colonne e campi che sono stati aggiunti, aggiornati o rimossi.

  6. Continuare a sviluppare il modello in base al proprio caso d'uso. Ciò può comportare la riconfigurazione dei contenuti esistenti o l'aggiunta di nuovi contenuti. Dopo aver aggiornato l'associazione dati, le colonne del grafico appena aggiunte saranno ora disponibili per l'uso nel menu Icona del database con il simbolo più Elenco campi.

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!