---
title: Okno edycji raportu
description: "Okno edycji raportu pozwala na dodawanie nowego raportu lub zmianę parametrów istniejącego raportu. Okno otworzyć można z poziomu listy raportów: [PP Mag -> zakładka RAPORTY.](https://ppmag.pl/docs/modul-raporty/) ![Okno edycji raportu w programie PP Mag.](https://ppmag.pl/wp-content/uploads/2025/07/obraz-1-1024x490.png) ## Sekcje definiowania raportu - Id raportu -…"
url: "https://ppmag.pl/docs/okno-edycji-raportu/"
updated: "2025-12-30"
category: PP Mag / Raporty
---

# Okno edycji raportu

Okno edycji raportu pozwala na dodawanie nowego raportu lub zmianę parametrów istniejącego raportu.

Okno otworzyć można z poziomu listy raportów: [PP Mag -> zakładka RAPORTY.](https://ppmag.pl/docs/modul-raporty/)

![Okno edycji raportu w programie PP Mag.](https://ppmag.pl/wp-content/uploads/2025/07/obraz-1-1024x490.png)

## Sekcje definiowania raportu

- Id raportu - identyfikator raportu w systemie.
- Poziom dostępu - określenie poziomu dostępu do raportu, pozwalający na ograniczanie dostępu uprawnieniami użytkownika. Uprawnienie to jest weryfikowane tylko w gdy raport jest uruchamiany z poziomu programu PP Mag.
- Nazwa - nazwa własna raportu pozwalająca na jego identyfikację i wyświetlana na liście raportów.
- Opis - dłuższy opis raportu pozwalający na czytelne opisanie sposobu jego działania.
  - - Dostępny w przeglądarce - określenie czy raport może być wykonywany z poziomu przeglądarki (szczegóły: [Jak korzystać z raportów w przeglądarce](https://ppmag.pl/docs/jak-korzystac-z-raportow-w-przegladarce/)).
- Sposób udostępniania - określenie w jaki sposób raport może być uruchamiany przez przeglądarkę:
  - Publiczny - raport będzie wyświetlany na liście raportów po zalogowaniu w przeglądarce i będzie można go otwierać za pomocą standardowego linku.
  - Niepubliczny - raport nie będzie wyświetlany na liście raportów po zalogowaniu w przeglądarce, nie będzie można go wyświetlać za pomocą standardowego linku. Dla takiego raportu wymagane jest dodanie własnego identyfikatora.
  - Własne id - identyfikator raportu niepublicznego o maksymalnej długości 36 znaków. Można wpisywać dowolne ciągi znaków, ale aby link był trudniejszy do zgadnięcia to zalecamy aby był to UUID.
  - Odświeżanie - częstotliwość odświeżania raportu z poziomu przeglądarki.  Parametr używany w przypadku wyświetlania raportów wymagających automatycznego odświeżania (np. na ekranach w magazynie wyświetlających aktualny status). Zalecamy aby czas odświeżania był ustawiany co minimum kilka minut. Jeżeli wykonanie raportu jest kosztowne to nawet dłuższe.
- Parametry - lista parametrów raportu.
  - Dodaj - dodaje nowy parametr.
  - Edytuj - uruchamia edycję wybranego parametru.
  - Usuń - usuwa wybrane parametry.
- Zapytanie - kwerenda SQL, która będzie wykonywana przy uruchamianiu raportu.

## Parametry raportu

Parametry raportu umożliwiają wprowadzanie wartości przez użytkownika zamiast zaszywać na sztywno kryteria wyszukiwania w zapytaniu SQL.

### Typy parametrów

Dostępne są następujące typy parametrów:

- Tekst - wprowadzanie wartości tekstowych (np. symbolu magazynu, numeru dokumentu, kategorii).
- Data - wprowadzanie daty: rok, miesiąc, dzień.
- Liczba - wprowadzanie  liczb całkowitych (np. liczba dni sprzed ilu ma wyszukiwać dane).

### Właściwości parametru

Przy definiowaniu parametru dostępne są pola:

- Nazwa - nazwa parametru, która będzie występowała w zapytaniu.
- Opis - opis parametru, który będzie wyświetlony użytkownikowi obok pola do uzupełnienia wartości.
- Domyślna wartość - wartość, która będzie podstawiona do pola przy wyświetleniu okna raportu. Użytkownik będzie musiał tą wartość zmienić na własną.
- Typ parametru - jeden z dostępnych typów (liczba, data, tekst). W zależności od wyboru w oknie wykonania raportu wyświetlone będzie odpowiednie pole do wprowadzania wartości.

### Wstawienie do zapytania

W zapytaniu SQL nazwa parametru musi być wstawiona ze znakiem @ (małpa). Poniższy przykład przedstawia ustawienie w zapytaniu parametrów typu data i typu tekst:

> SELECT
>  CAST(DATA_UTWORZENIA AS DATE) AS DZIEN,
>  COUNT(*) AS LICZBA_DOKUMENTOW
>  FROM MAG_WYDANIA
>  WHERE
>  DATA_UTWORZENIA >= '@DATA_OD' AND DATA_UTWORZENIA <= '@DATA_DO'
>  AND MAGAZYN = '@MAGAZYN'
>  GROUP BY CAST(DATA_UTWORZENIA AS DATE)
>  ORDER BY DZIEN;

W powyższym zapytaniu wstawione są trzy parametry:

- @DATA_OD
- @DATA_DO
- @MAGAZYN

### Uwagi

- Dodając parametr do zapytania należy brać pod uwagę, że będzie on podmieniony na wpisaną wartość, ale zapytanie musi być tak skonstruowane, aby było poprawne składniowo.
- Należy zakładać, że wszystkie parametry muszą być uzupełnione przez użytkownika. Jeżeli użytkownik nie poda jakiegoś parametru, to w zapytaniu zostanie wstawiona np. pusta wartość dla parametru typu Tekst.

## Ograniczanie dostępu uprawnieniami

Każdy raport może mieć określony poziom od 1 do 9. W ustawieniach dotyczących uprawnień użytkowników można dodać do roli poziom raportu, który może być wykonywany przez użytkownika do niej przypisanego.

Jeżeli zalogowany użytkownik będzie posiadał uprawnienia do raportów poziomu pierwszego, to będzie mógł wykonywać tylko raporty z danego poziomu, a pozostałe będą dla niego zablokowane.