Tableaux de bord dashboards
Lorsque vous utilisez AEM, vous avez la possibilité de gérer du contenu de nombreux types différents (pages, éléments, etc.). AEM Les tableaux de bord offrent un moyen simple d’utilisation et personnalisable de définir des pages qui affichent des données consolidées.
Administration des tableaux de bord administering-dashboards
Création D’Un Tableau De Bord creating-a-dashboard
Pour créer un tableau de bord, procédez comme suit :
-
Dans le Outils , cliquez sur Console de configuration.
-
Dans l’arborescence, double-cliquez sur Tableau de bord.
-
Cliquez sur Nouveau tableau de bord.
-
Saisissez le Titre (Mon tableau de bord, par exemple) et la variable Nom.
-
Cliquez sur Créer.
Clonage D’Un Tableau De Bord cloning-a-dashboard
Vous pouvez, si vous le souhaitez, disposer de plusieurs tableaux de bord afin de consulter rapidement des informations sur votre contenu depuis différentes vues. Pour faciliter la création d’un tableau de bord, AEM propose une fonctionnalité de clonage que vous pouvez utiliser pour dupliquer un tableau de bord existant. Pour cloner un tableau de bord, procédez comme suit :
-
Dans le Outils , cliquez sur Console de configuration.
-
Dans l’arborescence, cliquez sur Tableau de bord.
-
Cliquez sur le tableau de bord que vous souhaitez cloner.
-
Cliquez sur Cloner.
-
Saisissez le Nom de votre nouveau tableau de bord.
Suppression D’Un Tableau De Bord removing-a-dashboard
-
Dans le Outils , cliquez sur Console de configuration.
-
Dans l’arborescence, cliquez sur Tableau de bord.
-
Cliquez sur le tableau de bord à supprimer.
-
Cliquez sur Supprimer.
-
Cliquez sur Oui pour confirmer.
Composants de tableau de bord dashboard-components
du commerce électronique overview
Les composants de tableau de bord ne sont rien de plus que des composants AEM standard. Cette section décrit les composants de création de rapports fournis avec AEM.
Composants de création de rapports Web Analytics web-analytics-reporting-components
AEM est fourni avec un ensemble de composants qui effectuent le rendu de plusieurs mesures de vos données SiteCatalyst. Ces composants sont répertoriés dans le sidekick sous le Tableau de bord .
Chaque composant de création de rapports comporte au moins trois onglets :
-
De base: contient la configuration principale.
-
Rapport : contient la configuration propre à chaque rapport.
-
Style: contient une configuration de style, telle que la taille du graphique et la marge.
Les composants de création de rapports sont initialisés avec une configuration par défaut qui vous permet de configurer rapidement votre tableau de bord.
Configuration de base basic-configuration
Le De base donne accès aux entrées de configuration suivantes :
Titre - Titre affiché sur le tableau de bord.
Type de requête - Méthode de demande des données.
Options de configuration - Configuration à utiliser pour se connecter à SiteCatalyst. En l’absence de configuration, on suppose qu’elle est configurée sur la page Tableau de bord (via les propriétés de page).
Identifiant de suite de rapports (facultatif) Suite de rapports de SiteCatalyst que vous souhaitez utiliser pour générer le graphique.
Configuration des rapports report-configuration
Pour pouvoir afficher des statistiques web, vous devez définir la plage de dates des données à récupérer. Le Rapport fournit deux champs pour définir cette plage.
Date à partir de - Date absolue ou relative à partir de laquelle les données sont récupérées.
Date jusque - Date absolue ou relative jusqu’à laquelle les données sont récupérées.
Chaque composant définit également des paramètres spécifiques.
Rapport d’heures supplémentaires overtime-report
Granularité de la date - Unité de temps de l’axe des x (jour ou heure, par exemple).
Mesures - Liste des événements à afficher.
Éléments - Liste d’éléments qui répartit les données de mesure dans le graphique.
Rapport de liste avec classement ranked-list-report
Éléments - L’élément qui répartit les données de mesure dans le graphique.
Mesures L’événement que vous souhaitez afficher.
Nombre des principaux éléments Nombre d’éléments affichés par le rapport.
Rapport de classement ranked-report
Mesures L’événement que vous souhaitez afficher.
Éléments L’élément qui répartit les données de mesure dans le graphique.
Rapport de section du site supérieur top-site-section-report
Ce composant affiche un graphique présentant la section la plus visitée d’un site web selon la configuration suivante.
Nombre des principaux éléments Nombre de sections affichées par le rapport.
Rapport de tendances trended-report
Granularité de la date Unité de temps de l’axe des x (jour ou heure, par exemple).
Mesures L’événement que vous souhaitez afficher.
Éléments L’élément qui répartit les données de mesure dans le graphique.
Extension du tableau de bord extending-dashboard
du commerce électronique overview-1
Les tableaux de bord sont des pages normales (cq:Page
). N’importe quel composant peut donc être utilisé pour les assembler.
Un groupe de composants par défaut, Dashboard
, contient les composants de génération de rapports d’analyse activés par défaut sur le modèle.
Création D’Un Modèle De Tableau De Bord creating-a-dashboard-template
Un modèle définit le contenu par défaut d’un nouveau tableau de bord. Vous pouvez utiliser plusieurs modèles pour créer différents types de tableaux de bord.
Ces modèles sont créés de la même manière que les autres modèles de page, si ce n’est qu’ils sont stockés sous /libs/cq/dashboards/templates/
. Consultez Création d’un modèle Contentpage.
Développement d’un composant Tableau de bord developing-a-dashboard-component
Le développement d’un composant Tableau de bord consiste à créer un composant AEM ordinaire. Cette section décrit un exemple de composant qui affiche les 10 premiers contributeurs.
Le composant « Auteurs principaux » est stocké dans le référentiel, sous /apps/geometrixx-outdoors/components/reporting
. Il comprend les éléments suivants :
-
Un fichier
jsp
qui lit les données jcr et définit le pseudo-élémenthtml
. -
Une bibliothèque côté client contenant un fichier
js
qui récupère et classe les données, puis remplit le pseudo-élémenthtml
.
Le fichier JavaScript suivant est défini dans la bibliothèque cliente geout.reporting.topauthors
en tant qu’enfant du composant lui-même.
Le composant QueryBuilder est utilisé pour interroger le référentiel afin de lire les nœuds cq:AuditEvent
. Le résultat de la requête est un objet JSON duquel sont extraites les contributions de l’auteur.
top_authors.js top-authors-js
$.ajax({
url: "/bin/querybuilder.json",
cache: false,
data: {
"orderby": "cq:time",
"orderby.sort": "desc",
"p.hits": "full",
"p.limit": 100,
"path": "/var/audit/com.day.cq.wcm.core.page/",
"type": "cq:AuditEvent"
},
dataType: "json"
}).done(function( res ) {
var authors = {};
// from JSON to Object
for(var r in res.hits) {
var userId = res.hits[r].userId;
if(userId == undefined) {
continue;
}
var auth = authors[userId] || {userId : userId};
auth.contrib = (auth.contrib || 0) +1;
authors[userId] = auth;
}
// order by contribution
var orderedByContrib = [];
for(var a in authors) {
orderedByContrib.push(authors[a]);
}
orderedByContrib.sort(function(a,b){return b.contrib - a.contrib});
// produce the list
for (var i=0, tot=orderedByContrib.length; i < tot; i++) {
var current = orderedByContrib[i];
$("<div> #" + (i + 1) +" "+ current.userId + " (" + current.contrib +" contrib.)</div>").appendTo("#authors-list");
}
});
Le JSP
inclut le global.jsp
comme la clientlib
.
top_authors.jsp top-authors-jsp
<%@page session="false" contentType="text/html; charset=utf-8" %><%
%><%
%><%@include file="/libs/foundation/global.jsp" %><%
%>
<ui:includeClientLib categories="geout.reporting.topauthors" />
<%
String reportletTitle = properties.get("title", "Top Authors");
%>
<html>
<h3><%=xssAPI.encodeForHTML(reportletTitle) %></h3>
<div id="authors-list"></div>
</html>