[S’applique également à la v8.]{class="badge positive" title="S’applique également à Campaign v8."}
Fonctionnalités avancées advanced-functionalities
En tant qu'utilisateur technique, en plus des propriétés générales, vous pouvez tirer parti de fonctionnalités avancées pour configurer vos rapports, telles que :
-
Créer des requêtes complexes pour traiter les données dans une activité Script. En savoir plus
-
Ajouter un script externe à exécuter côté serveur ou côté client. En savoir plus
-
Appeler un rapport avec une activité Saut. En savoir plus
-
Ajouter un paramètre d'URL à un rapport pour le rendre plus accessible. En savoir plus
-
Ajouter les variables à utiliser dans le contexte du rapport. En savoir plus
Utilisation de scripts adding-a-script
Scripts externes de référence external-script
Vous pouvez référencer des codes JavaScript qui seront exécutés côté client et/ou côté serveur lors de l'appel de la page du rapport.
Pour cela :
-
Éditez les propriétés du rapport et cliquez sur l'onglet Scripts.
-
Cliquez sur Ajouter et sélectionnez le script à référencer.
-
Choisissez ensuite le mode d'exécution.
Si vous ajoutez plusieurs scripts, utilisez les flèches de la barre d'outils pour définir leur ordre d'exécution.
Les scripts référencés doivent être rédigés en Javascript et être compatibles avec les navigateurs courants afin d'assurer leur bonne exécution côté client. Pour plus d’informations, consultez cette section.
Ajout d'une activité Script script-activity
Lors de la conception de votre rapport, utilisez l'activité Script pour traiter les données et créer facilement des requêtes complexes qui n'activent pas le langage SQL. Vous pouvez saisir directement votre requête dans la fenêtre de script.
L’onglet Textes vous permet de définir des chaînes de texte. Elles peuvent ensuite être utilisées avec la syntaxe suivante : $(Identifier). Pour plus d’informations sur l’utilisation de textes, voir Ajouter un en-tête et un pied de page.
Si vous souhaitez créer un historique de votre rapport, vous devez rajouter la ligne suivante à votre requête JavaScript, afin de conserver vos données historisées :
if( ctx.@_historyId.toString().length == 0 )
Dans le cas contraire, seules les données en cours seront affichées.
Ajout d'un paramètre d'URL defining-additional-settings
L'onglet Paramètres des propriétés du rapport permet de définir des paramètres supplémentaires pour le rapport : ils seront passés sur l'URL lors de l'appel.
Pour créer un nouveau paramètre :
-
Cliquez sur le bouton Ajouter et saisissez le nom du paramètre.
-
Au besoin, indiquez si ce paramètre doit être obligatoire.
-
Choisissez le type de paramètre à créer : Filtre ou Variable.
L'option Filtrer les entités permet d'utiliser un champ de la base comme paramètre.
Les données sont directement récupérées au niveau de l'entité : ctx/recipient/@account.
L'option Variable permet de créer ou sélectionner une variable qui sera passée en paramètre de l'URL et pourra être utilisée au niveau des filtres.
Les En-têtes HTTP de réponse permettent d’empêcher le détournement de clics (clickjacking) si la page du rapport est incorporée dans une page HTML à l’aide d’iframe. Pour éviter le détournement de clics, vous pouvez choisir le comportement de l’En-tête X-Frame-Options :
- Aucun : le rapport ne comporte pas d’En-tête X-Frame-Options.
- Même origine : défini par défaut pour les nouveaux rapports et les rapports republiés. Le nom d’hôte sera identique à l’URL du rapport.
- Refuser : le rapport ne peut pas être incorporé dans une page HTML à l’aide d’iframe.
Ajouter des variables adding-variables
L'onglet Variables contient la liste des variables paramétrées dans le rapport. Ces variables sont exposées dans le contexte du rapport et utilisables dans les calculs.
Cliquez sur le bouton Ajouter pour créer une nouvelle variable.
Pour consulter la définition d'une variable, sélectionnez-la et cliquez sur le bouton Détail….
Cas pratique : utilisation de variables et de paramètres dans un rapport
Dans l'exemple vidéo ci-dessous, vous apprendrez comment ajouter un paramètre "_type" pour créer différentes vues d'un rapport, en fonction de la valeur de cet attribut.
Appel d'un autre rapport calling-up-another-report
Une activité Saut est comme une transition sans flèche : elle permet de passer d'une activité à une autre ou d'accéder à un autre rapport.