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

# Creare/modificare/eliminare un report

Il report si configura tramite un file XML. È necessario definire:

- La query sul database di CyberElements Identity per recuperare le informazioni desiderate,
- Le proprietà di ogni colonna da visualizzare, in formato XML: tipo di oggetto, nome nel database SQL, nome da visualizzare, indice di visualizzazione, ecc.
- Le opzioni di visualizzazione dei grafici (grafico a barre, grafico a torta, punti colorati).

Fare clic sul pulsante «New report» per creare e configurare un nuovo report.

Selezionare un report e fare clic sul pulsante «Modify» per modificarne la configurazione.

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

## Proprietà di un report

| Parametro | Descrizione | Tipi e valori possibili |
|---|---|---|
| Name | Nome visualizzato del report. | Stringa di caratteri. Obbligatorio. |
| Code | Corrisponde all'ID dell'oggetto. Il suo valore deve essere univoco tra tutti i report. | Stringa di caratteri , senza spazi né caratteri speciali. Obbligatorio |
| Category | Categoria di report in cui verrà visualizzato l'elenco dei report. | Elenco di categorie predefinite. |
| Description |  | Stringa di caratteri. |
| XML | Tag XML che descrivono la query SQL nel database Hpliance, le proprietà di ogni colonna del report e le proprietà degli elementi grafici. | Testo in formato XML. |
| Choice of report template | Modello grafico del report (in aggiunta alla tabella dei dati). | Without chart, Histogram, Stacked histogram, Pie chart o Color ball by threshold. |
| With parameters | Consente di aggiungere variabili immesse dall'utente. È necessario aggiungere il tag all'XML. | Casella di controllo. |

## Scrivere l'XML di un report semplice

```
 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
```

**Esempio: elenco degli utenti senza numero di telefono**

```
 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
```

## Tag XML che descrivono le colonne di un report

| Tag XML | Definizione | Valori possibili |
|---|---|---|
| Name | Nome del campo così come è definito nella query SQL. | Stringa di caratteri. |
| Column_Link_Id | Serve a creare colonne contenenti dati su cui è possibile fare clic. Corrisponde al nome della colonna che contiene l'ID utilizzato per gestire il collegamento. | Stringa di caratteri. *Facoltativo* |
| ObjectType | Tipo di oggetto di destinazione del collegamento su cui è possibile fare clic (Identity, struttura). | Identity = 1 => Reindirizzamento alla pagina userDetails.aspx |
|  |  | Structure = 2 => Reindirizzamento alla pagina structure.aspx |
|  |  | *Facoltativo* |
| DisplayName | Nome della colonna da visualizzare nell'interfaccia. | Stringa di caratteri. |
| Visible | Indica se la colonna è visualizzata o nascosta. | 'TRUE' o 'FALSE' |
| DisplayIndex | Indice della colonna (ordine di visualizzazione). | Numero intero maggiore di 0 |

## Aggiungere parametri immessi dall'utente nel report: tag

Selezionare la casella di controllo «With parameters» e aggiungere i tag seguenti all'XML:

```
 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
```

**Esempio: autorizzazioni in scadenza**

```
 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
```

Tag XML in <Parameter> che descrivono i parametri che possono essere immessi dall'utente:

| Tag XML | Definizione | Valori possibili |
|---|---|---|
| Variable | Nome della variabile utilizzata nella query SQL (senza la @). | Stringa di caratteri. |
| Data Type | Tipo di oggetto di CyberElements Identity corrispondente al parametro. Se non si tratta di un tipo di oggetto di base (data, stringa, numero intero, ecc.), il parametro sarà un elenco a discesa contenente i valori possibili. | Structure=2; Authorization Rule=3; Application=4; Repository=5; Right=8; StructureType=11; Tree=12; AdminProfile=18; PersonType=19; String=22; Integer=23; Boolean=24; Date=25. |
| Label | Etichetta da visualizzare all'utente. | Stringa di caratteri. |
| AttributeCode | Codice attributo PSA. | Stringa di caratteri corrispondente a un codice PSA. |
| Mandatory | Indica se l'utente deve obbligatoriamente specificare un valore. | 'TRUE' o 'FALSE |
| DefaultValue | Per i parametri opzionali, è il valore predefinito immesso se l'utente non inserisce nulla. | Stringa di caratteri. |

## Definire i parametri dei grafici

Selezionare il modello grafico dall'elenco a discesa e aggiungere i tag seguenti all'XML:

```
 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
```

Stacked histogram

Inserire i tag seguenti nel tag :

```
 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
```

Cerchio colorato per soglia

Inserire i tag seguenti nel tag :

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

## Tradurre i nomi delle colonne di un report

Le colonne e i valori contenuti nei risultati di un report possono essere tradotti in diverse lingue.

Di seguito un esempio di report in cui le colonne sono state tradotte:

```
 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
```

**Tag XML**

- Internationaldisplayname:
    - **Definizione**: tag utilizzato per tradurre i nomi delle colonne restituite dal report. Questo tag deve essere presente tante volte quante sono le lingue configurate in CyberElements Identity.
    - **Attributo**: Lang=«<\language_code>», dove <\language_code> rappresenta il codice lingua definito nelle impostazioni della lingua nella scheda General > Application Settings.
    - **Valore possibile**: stringa di caratteri. Nome della colonna visualizzato nel report per la lingua.
- CultureColumnName:
    - **Definizione**: definizione dell'XML di cultura utilizzato per tradurre il contenuto della tabella generata dal report.
    - **Attributo**: Prop=«<\XML_Attribute>», dove <\XML_Attribute> rappresenta l'attributo della proprietà XML corrispondente ai diversi valori della colonna.
    - **Valore possibile**: stringa di caratteri. Colonna di cultura della query SQL.

## Visualizzare un report in funzione del contesto dell'utente

Nella versione 4000 di Hpliance è possibile aggiungere a un report un parametro invisibile che verrà definito in funzione della persona che esegue il report. I valori del report verranno visualizzati in funzione dei valori di un attributo utente. Ad esempio, l'utente vedrà solo i risultati relativi alla propria organizzazione.

Esempio di report: elencare tutte le autorizzazioni assegnate alle identità di una determinata struttura. Visualizzare i cognomi, i nomi, le autorizzazioni e le applicazioni di tutte le identità per le quali l'attributo di struttura "Responsibility" corrisponde all'attributo di struttura dell'utente connesso.

```
  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
```

**Tag XML che descrivono i parametri basati sul contesto dell'utente.**

- Variable:
    - **Definizione**: nome della variabile utilizzata nella query SQL (senza la @).
    - **Valore possibile**: stringa di caratteri.
- AttributUserConnected:
    - **Definizione**: specifica se il parametro è definito in funzione del contesto dell'utente corrente o se deve essere immesso manualmente dall'interfaccia.
    - **Valore possibile**:
        - True: contesto dell'utente
        - False: immissione manuale
- AttributeCode:
    - **Definizione**: codice attributo PSA.
    - **Valore possibile**: stringa di caratteri corrispondente al codice PSA.
