v7 v8

Funzionalità avanzate

Come utente tecnico, oltre a proprietà generali, puoi sfruttare funzionalità avanzate per configurare i rapporti, ad esempio:

Utilizzo degli script

Riferimento a script esterni

Puoi fare riferimento ai codici JavaScript che verranno eseguiti sul lato client e/o server quando viene richiamata la pagina del rapporto.

Per eseguire questa operazione:

  1. Modifica il proprietà report e fai clic su Scripts.

  2. Clic Add e seleziona lo script a cui fare riferimento.

  3. Quindi seleziona la modalità di esecuzione.

    Se aggiungi più script, utilizza le frecce della barra degli strumenti per definirne la sequenza di esecuzione.

Per la normale esecuzione sul lato client, gli script di riferimento devono essere scritti in JavaScript e devono essere compatibili con i browser più diffusi. Per ulteriori informazioni al riguardo, consulta questa sezione.

Aggiunta di un’attività Script

Quando progettazione del report, utilizza Script attività per elaborare i dati e creare facilmente query complesse che non abilitano il linguaggio SQL. È possibile inserire direttamente la query nella finestra dello script.

Il Texts consente di definire stringhe di testo. Possono quindi essere utilizzati con la seguente sintassi: $(Identifier). Per ulteriori informazioni sull’utilizzo dei testi, consulta Aggiunta di un’intestazione e un piè di pagina.

ATTENZIONE

Si sconsiglia di utilizzare il codice JavaScript per creare aggregati.

Per creare una cronologia del rapporto, aggiungi la seguente riga alla query JavaScript per salvare i dati archiviati:

if( ctx.@_historyId.toString().length == 0 )

In caso contrario, verranno visualizzati solo i dati correnti.

Aggiunta di un parametro URL

Il Parameters scheda di proprietà report consente di definire impostazioni aggiuntive per il rapporto: queste impostazioni verranno trasmesse nell’URL durante la chiamata.

ATTENZIONE

Per motivi di sicurezza, questi parametri devono essere utilizzati con cautela.

Per creare una nuova impostazione:

  1. Fai clic su Add e immettere il nome dell'impostazione.

  2. Se necessario, specificare se l'impostazione sarà obbligatoria o meno.

  3. Selezionare il tipo di impostazione che si desidera creare: Filter o Variable.

    Il Filter entities consente di utilizzare un campo del database come parametro.

    I dati vengono recuperati direttamente a livello di entità: ctx/recipient/@account.

    Il Variable L’opzione ti consente di creare o selezionare una variabile che verrà passata come parametro dell’URL e che può essere utilizzata nei filtri.

Il Response HTTP headers consente di impedire il clickjacking quando si include la pagina del report in una pagina HTML utilizzando iframe. Per evitare il clickjacking, puoi scegliere X-Frame-options header comportamento:

  • None: il rapporto non avrà X-Frame-options header.
  • Same as origin: impostato per impostazione predefinita per i nuovi rapporti e i rapporti ripubblicati. Il nome host sarà lo stesso dell’URL del rapporto.
  • Deny: il report non può essere incluso in una pagina HTML utilizzando iframe.

Aggiunta di variabili

Il Variables La scheda contiene l’elenco delle variabili configurate nel rapporto. Queste variabili sono esposte nel contesto del rapporto e possono essere utilizzate nei calcoli.

Fai clic su Add per creare una nuova variabile.

Per visualizzare la definizione di una variabile, selezionala e fai clic sul pulsante Detail… pulsante.

Caso d’uso: utilizzare variabili e parametri in un rapporto

Nell’esempio video seguente, scoprirai come aggiungere un parametro "_type" per creare visualizzazioni diverse di un rapporto, in base al valore di questo attributo.

Scopri questa funzione nel video

Richiamo di un altro report

A Salta l’attività è simile a una transizione senza freccia: ti consente di passare da un’attività all’altra o di accedere a un altro rapporto.

In questa pagina