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

# Tworzenie, zmiana i usuwanie raportu

Raport konfiguruje się za pomocą pliku XML. Musisz określić:

- zapytanie do bazy danych CyberElements Identity pozwalające pobrać wymagane informacje,
- właściwości każdej kolumny do wyświetlenia w formacie XML: typ obiektu, nazwa w bazie danych SQL, nazwa do wyświetlenia, indeks wyświetlania itd.
- opcje wyświetlania wykresów (wykres słupkowy, wykres kołowy, kolorowe punkty).

Kliknij przycisk „New report”, aby utworzyć i skonfigurować nowy raport.

Wybierz raport i kliknij przycisk „Modify”, aby zmienić jego konfigurację.

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

## Właściwości raportu

| Parameter | Opis | Typy i możliwe wartości |
|---|---|---|
| Name | Nazwa wyświetlana raportu. | Ciąg znaków. Obowiązkowe. |
| Code | Odpowiada identyfikatorowi obiektu. Jego wartość musi być unikalna w obrębie wszystkich raportów. | Ciąg znaków , bez spacji i bez znaków specjalnych. Obowiązkowe |
| Category | Kategoria raportu, w której będzie wyświetlana lista raportów. | Lista wstępnie zdefiniowanych kategorii. |
| Description |  | Ciąg znaków. |
| XML | Znaczniki XML opisujące zapytanie SQL w bazie danych Hpliance, właściwości każdej kolumny raportu oraz właściwości elementów graficznych. | Tekst w formacie XML. |
| Choice of report template | Szablon graficzny raportu (dodatkowo do tabeli danych). | Without chart, Histogram, Stacked histogram, Pie chart lub Color ball by threshold. |
| With parameters | Umożliwia dodanie zmiennych wprowadzanych przez użytkownika. Musisz dodać do XML znacznik . | Pole wyboru. |

## Pisanie XML prostego raportu

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

**Przykład: lista użytkowników bez numeru telefonu**

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

## Znaczniki XML opisujące kolumny raportu

| Znacznik XML | Definicja | Możliwe wartości |
|---|---|---|
| Name | Nazwa pola, tak jak jest zdefiniowana w zapytaniu SQL. | Ciąg znaków. |
| Column_Link_Id | Służy do tworzenia kolumn zawierających dane klikalne. Odpowiada nazwie kolumny zawierającej identyfikator używany do zarządzania łączem. | Ciąg znaków. *Opcjonalne* |
| ObjectType | Typ obiektu docelowego klikalnego łącza (Identity, struktura). | Identity = 1 => przekierowanie na stronę userDetails.aspx |
|  |  | Structure = 2 => przekierowanie na stronę structure.aspx |
|  |  | *Opcjonalne* |
| DisplayName | Nazwa kolumny wyświetlana w interfejsie. | Ciąg znaków. |
| Visible | Wskazuje, czy kolumna jest wyświetlana czy ukryta. | 'TRUE' lub 'FALSE' |
| DisplayIndex | Indeks kolumny (kolejność wyświetlania). | Liczba całkowita większa od 0 |

## Dodawanie do raportu parametrów wprowadzanych przez użytkownika: znacznik

Zaznacz pole wyboru „With parameters” i dodaj do XML następujące znaczniki:

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

**Przykład: uprawnienia, których ważność wkrótce wygaśnie**

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

Znaczniki XML w <Parameter>, które opisują parametry możliwe do wprowadzenia przez użytkownika:

| Znacznik XML | Definicja | Możliwe wartości |
|---|---|---|
| Variable | Nazwa zmiennej używanej w zapytaniu SQL (bez @). | Ciąg znaków. |
| Data Type | Typ obiektu CyberElements Identity odpowiadający parametrowi. Jeśli nie jest to podstawowy typ obiektu (data, ciąg znaków, liczba całkowita itd.), parametr będzie listą rozwijaną zawierającą możliwe wartości. | 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 | Etykieta wyświetlana użytkownikowi. | Ciąg znaków. |
| AttributeCode | Kod atrybutu PSA. | Ciąg znaków odpowiadający kodowi PSA. |
| Mandatory | Wskazuje, czy użytkownik musi podać wartość. | 'TRUE' lub 'FALSE |
| DefaultValue | W przypadku parametrów opcjonalnych jest to wartość domyślna wstawiana, gdy użytkownik nic nie wprowadzi. | Ciąg znaków. |

## Określanie parametrów wykresów

Wybierz szablon graficzny z listy rozwijanej i dodaj do XML następujące znaczniki:

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

Wstaw następujące znaczniki do znacznika :

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

Kolorowy okrąg według progu

Wstaw następujące znaczniki do znacznika :

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

## Tłumaczenie nazw kolumn raportu

Kolumny i wartości zawarte w wynikach raportu można przetłumaczyć na kilka języków.

Poniżej przykład raportu, którego kolumny zostały przetłumaczone:

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

**Znacznik XML**

- Internationaldisplayname:
    - **Definicja**: znacznik służący do tłumaczenia nazw kolumn zwracanych przez raport. Ten znacznik musi występować tyle razy, ile języków jest skonfigurowanych w CyberElements Identity.
    - **Atrybut**: Lang=„<\language_code>”, gdzie <\language_code> oznacza kod języka określony w ustawieniach języka w karcie General > Application Settings.
    - **Możliwa wartość**: ciąg znaków. Nazwa kolumny wyświetlana w raporcie dla danego języka.
- CultureColumnName:
    - **Definicja**: definicja XML culture, który służy do tłumaczenia treści tabeli generowanej przez raport.
    - **Atrybut**: Prop=„<\XML_Attribute>”, gdzie <\XML_Attribute> oznacza atrybut właściwości XML odpowiadający różnym wartościom kolumny.
    - **Możliwa wartość**: ciąg znaków. Kolumna culture zapytania SQL.

## Wyświetlanie raportu zależnie od kontekstu użytkownika

W wersji 4000 Hpliance można dodać do raportu niewidoczny parametr, który jest określany na podstawie osoby wykonującej raport. Wartości raportu będą wtedy wyświetlane na podstawie wartości atrybutu użytkownika. Na przykład osoba zobaczy tylko wyniki dotyczące własnej organizacji.

Przykład raportu: wymień wszystkie uprawnienia przypisane tożsamościom danej struktury. Wyświetl nazwiska, imiona, uprawnienia i aplikacje wszystkich tożsamości, dla których atrybut struktury „Responsibility” odpowiada atrybutowi struktury zalogowanego użytkownika.

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

**Znaczniki XML opisujące parametry na podstawie kontekstu użytkownika.**

- Variable:
    - **Definicja**: nazwa zmiennej używanej w zapytaniu SQL (bez @).
    - **Możliwa wartość**: ciąg znaków.
- AttributUserConnected:
    - **Definicja**: wskazuje, czy parametr jest określany na podstawie kontekstu bieżącego użytkownika, czy musi być wprowadzony ręcznie z interfejsu.
    - **Możliwa wartość**:
        - True: kontekst użytkownika
        - False: wprowadzanie ręczne
- AttributeCode:
    - **Definicja**: kod atrybutu PSA.
    - **Możliwa wartość**: ciąg znaków odpowiadający kodowi PSA.
