> Source: https://docs.cyberelements.io/identity/7.1/fr/UserDocumentation/ReportsAuditsManagement/CreateModifyDeleteReport/

# Créer / modifier / supprimer un rapport

La configuration du rapport est faite avec un fichier au format XML. Il s'agit de définir :

- La requête sur la base de données CyberElements Identity pour récupérer les informations souhaitées,
- Les propriétés de chaque colonne à afficher au format XML : Type d'objet, nom dans la base SQL, nom à afficher, index d'affichage...
- Les options d'affichage des graphiques (histogramme, Camembert, pastilles de couleur).

Cliquez sur le bouton « Nouveau rapport » pour créer et configurer un nouveau rapport

Sélectionnez un rapport et cliquez sur le bouton « Modifier » pour modifier sa configuration.

![Nouveau rapport](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_NouveauRapport.png)

## Propriétés d'un rapport

| Paramètre | Description | Types et valeurs possibles |
|---|---|---|
| Nom | Nom d'affichage du rapport. | Chaîne de caractères. Obligatoire. |
| Code | Représente l'identifiant de l'objet. Sa valeur doit être unique parmi tous les rapports. | Chaîne de caractères, sans espace et sans caractère spécial. Obligatoire |
| Catégorie | Catégorie du rapport au sein de laquelle s'affichera dans la liste des rapports. | Liste des catégories prédéfinies. |
| Description |  | Chaîne de caractères. |
| XML | Balises XML décrivant la requête SQL dans la base Hpliance, les propriétés de chaque colonne du rapport et les propriétés des éléments graphiques. | Texte sous format XML. |
| Choix d'un modèle de rapport | Modèle graphique du rapport (en plus du tableau de données). | Sans graphique, Histogramme, Histogramme empilé, Camembert ou Boule de couleur par seuil. |
| Avec paramètres | Permet d'ajouter des variables saisies par l'utilisateur. Il faudra ajouter la balise au XML. | Case à cocher. |

## Écrire le XML d'un rapport simple

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
```

**Exemple : Liste des utilisateurs sans numéro de téléphone**

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
```

## Balises XML décrivant les colonnes d'un rapport

| Balises XML | Définition | Valeurs possibles |
|---|---|---|
| Name | Le nom du champ tel qu'il est défini dans la requête SQL. | Chaîne de caractères. |
| Column_Link_Id | Utilisé pour construire des colonnes dont le contenu est cliquable. Correspond au nom de la colonne contenant l'ID utilisé pour gérer le lien. | Chaîne de caractères. *Facultatif* |
| ObjectType | Type de l'objet cible du lien cliquable (Personne, structure). | Personne = 1 => Redirection sur la page userDetails.aspx |
|  |  | Structure = 2 => Redirection sur la page structure.aspx |
|  |  | *Facultatif* |
| DisplayName | Nom de la colonne à afficher dans l'interface. | Chaîne de caractères. |
| Visible | Indique si la colonne est visible ou cachée. | 'TRUE' ou 'FALSE' |
| DisplayIndex | Index de la colonne (ordre d'affichage). | Entier supérieur à 0 |

## Ajouter des paramètres saisis par l'utilisateur dans le rapport : balise

Sélectionnez la case à cocher « Avec paramètres » et ajoutez au XML les balises ci-dessous :

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
```

**Exemple : Droits arrivant à expiration**

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
```

Balises XML dans <Parameter> décrivant les paramètres pouvant être saisis par l'utilisateur :

| Balise XML | Définition | Valeurs possibles |
|---|---|---|
| Variable | Nom de la variable utilisé dans la requête SQL (sans l'@). | Chaîne de caractères. |
| Data Type | Type de l'objet CyberElements Identity du paramètre. Si ce n'est pas un type de base (date, string, int, ...), la paramètre sera une liste déroulante contenant les valeurs possibles. | Structure=2 ; Règle d'habilitation=3 ; Application=4 ; Référentiel=5 ; Droit=8 ; StructureType=11 ; Arbre=12 ; AdminProfil=18 ; PersonType=19 ; Chaîne de caratères=22 ; Entier=23 ; Booléen=24 ; Date=25. |
| Label | Libellé à afficher à l'utilisateur. | Chaîne de caractères. |
| AttributeCode | Code de l'attribut PSA. | Chaîne de caractères correspondant à un code PSA. |
| Mandatory | Indique si l'utilisateur doit absolument préciser une valeur. | 'TRUE' ou 'FALSE |
| DefaultValue | Dans le cas des paramètres optionnels, la valeur par défaut à mettre en cas de non-saisie par l'utilisateur. | Chaîne de caractères. |

## Définir les paramètres des graphiques

Sélectionner le modèle graphique dans la liste déroulante et ajoutez au XML les balises ci-dessous :

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
```

Histogramme empilé

Ajoutez les balises ci-dessous au sein de la balise  :

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
```

Boule de couleur par seuil

Ajoutez les balises ci-dessous au sein de la balise  :

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
```

## Traduire les noms des colonnes d'un rapport

Les colonnes et les valeurs du résultat d’un rapport peuvent être traduites en plusieurs langues.

Voici un exemple d’un rapport ayant des colonnes traduites :

```
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
```

**Balises XML**

- Internationaldisplayname :
    - **Définition** : Balise utilisée pour traduire le nom des colonnes retournées par le rapport. Il doit y avoir autant de fois cette balise que de langues configurées dans CyberElements Identity.
    - **Attribut** : Lang=« <code_langue> » où <code_langue> représente le code de la langue defini dans la configuration des langues dans l'onglet General > Paramètre de l'application
    - **Valeur possible** : Chaîne de caractères. Nom de la colonne affichée dans le rapport pour la langue.
- CultureColumnName :
    - **Définition** : Définition du XML de culture pour traduire le contenu du tableau résultant du rapport.
    - **Attribut** : Prop=« <Attribut_XML> » où <Attribut_XML> représente l'attribut de la propriété du XML de culture correspondant aux différentes valeurs de la colonne.
    - **Valeur possible** : Chaîne de caractères. Colonne de culture de la requête SQL.

## Afficher le rapport en fonction du contexte de l'utilisateur

Dans la version 4000 d’Hpliance, il est possible d’ajouter à un rapport un paramètre invisible qui sera défini en fonction de la personne qui exécute le rapport. Les valeurs du rapport s'afficheront en fonction des valeurs d'un attribut de l'utilisateur. Par exemple, il ne verra que les résultats pour sa structure.

Exemple de rapport : Lister tous les droits des personnes qui sont dans la même structure. Affiche les noms, prénoms, droits et applications de toutes les personnes dont l'attribut de type structure « Responsabilité » est égale à celui de l'utilisateur connecté.

```
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
```

**Balises XML décrivant les paramètres selon le contexte de l'utilisateur**

- Variable :
    - **Définition** : Nom de la variable utilisé dans la requête SQL (sans l'@).
    - **Valeur possible** : Chaîne de caractères.
- AttributUserConnected :
    - **Définition** : Défini si le paramètre est défini en fonction du contexte de l'utilisateur courant ou si c'est un paramètre à saisir manuellement depuis l'interface.
    - **Valeur possible** :
        - True : Contexte utilisateur
        - False : Saisie manuelle
- AttributeCode :
    - **Définition** : Code de l'attribut PSA.
    - **Valeur possible** : Chaîne de caractères correspondant au code PSA.
