5.1.7 Rapport

5.1.7.1 Présentation

Le rapport permet d'ajouter des options de mise en forme à une recherche détaillée.

Ainsi, il est possible d'exprimer les critères de recherche de la même manière que dans une recherche détaillée, et de choisir parmi les attributs et propriétés de la familles quelles sont celles qui seront présentées.

Le résultat est alors affiché sous la forme d'une table, qui peut ensuite être exportée au format csv.

Il est implémenté au moyen de la famille Report, qui étend la famille DSEARCH.

5.1.7.2 Éléments de paramétrage

Un rapport dispose, en plus des éléments de paramétrage de la recherche détaillée des éléments de présentation suivants :

• un texte de description qui sera présenté sur la page de résultat,

• l'attribut en fonction duquel seront ordonnés les résultats dans le tableau,

• une limite au nombre de résultats présentés. Lorsque le nombre d'éléments est supérieur à cette limite, alors la liste de résultats sera tronquée et seul les N premiers éléments seront présentés. La valeur par défaut est déterminée au moyen du paramètre rep_maxdisplaylimit de la famille rapport (par défaut à 1000).

• les colonnes du tableau de résultat.

  Chaque ligne du tableau "Colonnes" permet de sélectionner un attribut ou une propriété du document qui sera présenté sous forme de colonne dans le tableau des résultats.

  Pour chaque colonne, il est possible d'indiquer :

  • l'attribut du document à l'aide du sélecteur "label"

  • la couleur de la colonne

  • une opération sur la colonne dont le résultat est présenté en pied de tableau.

    Les opérations de pied de tableau disponibles sont :

    Somme

    effectue la somme des éléments de la colonne (attention : le calcul de la somme ne sera correct que pour des valeurs numériques).

    Moyenne

    effectue la moyenne des éléments de la colonne (attention : le calcul de la moyenne ne sera correct que pour des valeurs numériques).

    Cardinal

    effectue un décompte du nombre de lignes dans la colonne.

De plus, il est possible d'exporter le résultat d'un rapport en csv via un assistant d'export.

5.1.7.3 Assistant d'export csv

L'assistant d'export CSV est présent sur les rapports via le menu "export CSV" en consultation, il permet d'exporter le rapport en CSV de deux manières :

• simple : Dans ce cas un document est une ligne et chaque colonne une cellule de cette ligne. Lorsque l'attribut est multiple, les valeurs sont séparées par des \n pour le premier niveau de multiplicité et des , pour le second.
• pivot : Ce mode permet l'export à des fins de traitement dans un tableur avec la fonctionnalité pivot. Les données sont alors dissociées par groupe de multiplicité, c'est à dire que chaque attribut multiple génère un ensemble de colonnes identifiées par le pivot (qui est un attribut ou une propriété du document).

De plus, l'assistant d'export permet de définir différentes propriétés du fichier CSV généré (encodage, séparateur, format de date, etc.).

Figure 65. Export CSV

Options d'exportation :

• le caractère de séparation des cellules : valeur par défaut ";"
• le caractère de séparation de texte : valeur par défaut "
• le caractère de séparation des valeurs décimal : valeur par défaut ,
• 3.2.19 le format des nombre : par défaut les nombres sont exportés avec leur format comme par exemple la devise pour le type money
• le jeu de caractère : valeur par défaut "iso 8859-15"
• le format de la date :
  • US : Format AAAA-MM-JJ HH:MM
  • FR : Format JJ/MM/AAAA HH:MM
  • ISO : Format AAAA-MM-JJTHH:MM
• les balises HTML : pour les attribut HTML permet de ne conserver que le texte brut si on enlève les balises

Les options modifiées sont conservées pour chaque utilisateur et sont réutilisées à chaque nouvelle exportation.

Voir aussi : Programmation des rapports.