Fonctionnement du moteur des rapports

Présentation

L'objet de cette page est de présenter le fonctionnement du moteur des rapports.

Requête dynamique

La présence du tag "[OF_DYNAMIC_SQL]" dans un rapport, permet d'identifier une requête dynamique.

Une requête dynamique est une requête SELECT construisant une autre requête SELECT à l'intérieur d'elle-même. L'on nomme cette autre requête, une requête imbriquée.

Les requêtes dynamiques sont principalement utilisées pour afficher sous forme de colonne, des données provenant de champs métiers comme par exemple, pour le rapport Coordonnées (avec profil X et/ou validité Y expirant à une date postérieure ou égale à Z).

Remplacement des variables

Variable associé à un champ de type dbObject

Une variable associée à ce type de champ recevra comme valeur possible :

• Lorsque "Pas de filtre" est sélectionné, le caractère : -
• Lorsqu'une valeur est sélectionnée, un id sous forme de nombre

Exemple de rapport : Liste des utilisateurs actifs possédant le profil "$profileId"

SELECT person.*
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE profile.id='$profileId'
  AND activated=1

Exemple de remplacement :

SELECT person.*
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE profile.id='1'
  AND activated=1

Exemple de rapport : Liste des utilisateurs actifs avec ou non, un filtrage sur le profil "$profileId"

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id='$profileId' OR '-'='$profileId' )

Dans ce rapport, cette partie permet d'assurer le filtrage :

profile.id='$profileId'

Et cette partie s'assurer le non-filtrage :

'-'='$profileId'

Exemple de remplacement assurant le filtrage :

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id='1' OR '-'='1' )

Exemple de remplacement assurant le non-filtrage :

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id='-' OR '-'='-' )

Exemple de rapport avec une requête dynamique :

[OF_DYNAMIC_SQL]
SELECT 'SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id=\'$profileId\' OR \'-\'=\'$profileId\' )'

Variable associé à un champ de type dbObjectMulti

Une variable associée à ce type de champ recevra comme valeur possible :

• Lorsque rien n'est coché, la chaîne : '-'. Cela est considéré comme "Pas de filtre".
• Lorsqu'une valeur est cochée, un id sous forme de nombre
• Lorsque plusieurs valeurs sont cochées, plusieurs id sous forme de chaîne suivante : 1,2,3

Exemple de rapport : Liste des utilisateurs actifs avec ou non, un filtrage sur le(s) profil(s) "$profileId"

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id IN ($profileId) OR '-' IN ($profileId) )

Dans ce rapport, cette partie permet d'assurer le filtrage :

profile.id IN ($profileId)

Et cette partie s'assurer le non-filtrage :

'-' IN ($profileId)

Exemples de remplacement assurant le filtrage :

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id IN (1) OR '-' IN (1) )

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id IN (1,2,4) OR '-' IN (1,2,4) )

Exemple de remplacement assurant le non-filtrage :

SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id IN ('-') OR '-' IN ('-') )

Exemple de rapport avec une requête dynamique :

[OF_DYNAMIC_SQL]
SELECT CONCAT('SELECT *
FROM person
LEFT JOIN profile ON person.profile & profile.id
WHERE ( profile.id IN (', IF('-' IN ($validityTypeId), '\'-\'', '$validityTypeId'), ') OR \'-\' IN (', IF('-' IN ($validityTypeId), '\'-\'', '$validityTypeId'), ') )')

Visualisation de rapport

Lors d'une demande de visualisation de rapport, le moteur des rapports :

• Récupère les valeurs des champs de saisie affichées dans le formulaire et stocke ces valeurs dans les variables correspondantes à ces champs de saisie
• Extrait la requête du rapport
• Remplace dans la requête, chaque variable par leur valeur correspondante
• Interprète la requête. Lors d'une requête dynamique, celle-ci est interprété une seconde fois
• Affiche le résultat sous forme de tableau

Exemple de rapport :

SELECT *
FROM ma_table
WHERE mon_champ='$maVariable'

Exemple de rapport après remplacement des variables :

SELECT *
FROM ma_table
WHERE mon_champ='1'

SELECT *
FROM ma_table
WHERE mon_champ='test'