> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/kolumny-listy-wszystkich-spraw.md).

# Kolumny listy wszystkich spraw w konfiguracji aplikacji

W konfiguracji aplikacji, w zakładce **Lista spraw**, wskazujesz pola modelu danych, z których [lista wszystkich spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/lista-wszystkich-spraw.md) w Eximee Dashboard bierze dane sprawy:

* **kolumny wspólne** – dla kolumn **Klient**, **ID**, **PESEL** i **Status**, wspólnych dla spraw wszystkich aplikacji, wybierasz pole modelu danych,
* **rozszerzenia** – dodajesz kolumny dodatkowe z [katalogu kolumn listy spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md), np. „Kwota deklarowana (PLN)”, i dla każdej wybierasz pole modelu danych. Lista pokazuje je w sekcji **Rozszerzenia** panelu **Konfiguracja kolumn**.

Aplikacja zapisuje tylko klucz kolumny i pole modelu danych. Nazwę i typ kolumny dodatkowej lista bierze z katalogu, a wartość – z pola modelu danych sprawy. Lista pokazuje wartość, którą aplikacja zapisała ostatnio we wskazanym polu. Na tych wartościach działają też sortowanie, wyszukiwanie i filtr **Status**.

{% hint style="info" %}
Ustawienie dotyczy tylko tabelarycznej listy wszystkich spraw. Na [listę spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-spraw.md) w postaci kafli nie ma wpływu.
{% endhint %}

## Wymagania

* Aplikacja ma model danych – zobacz [Tworzenie modelu danych](https://docs.eximee.com/budowanie-aplikacji/model-danych/tworzenie-modelu-danych.md).
* Pole, które wskazujesz, jest polem pojedynczym: nie ma pól podrzędnych, nie jest tablicą i nie leży w tablicy.
* Aplikacja zapisuje wartość pola w modelu danych, np. z pola formularza powiązanego z modelem albo ze skryptu. Lista nie widzi wartości, które pole tylko pobiera z usługi przy odczycie – zobacz [Przechowywanie danych w modelu](https://docs.eximee.com/budowanie-aplikacji/model-danych/przechowywanie-danych-w-modelu.md).
* Kolumna dodatkowa, której potrzebujesz, jest w katalogu kolumn listy spraw. Nowe kolumny dodaje do katalogu użytkownik z rolą Artifact Manager – zobacz [Katalog kolumn listy spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md).
* Wdrożenie Eximee Dashboard pobiera dane z modelu danych na listę – zobacz [Konfiguracja listy wszystkich spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw.md#wymagania-wdrozeniowe).

## Zakładki konfiguracji aplikacji

Pozycja **Konfiguracja** w nawigacji aplikacji w Eximee Designer ma trzy zakładki:

| Zakładka             | Zawartość                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Lista spraw**      | Pola modelu danych dla kolumn listy wszystkich spraw. Zakładka otwiera się domyślnie.                                                                                                                                                                                                                                                                                             |
| **Ekrany aplikacji** | Skrypt konfiguracji ekranów aplikacji w Eximee Dashboard – zobacz [Konfiguracja ekranów aplikacji](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/konfiguracja-ekranow-aplikacji.md). Wcześniej była to osobna pozycja **Ekrany aplikacji** w nawigacji aplikacji.                                                               |
| **Właściwości**      | Role uprawniające do edycji w Eximee Dashboard i edytor konfiguracji w formacie `klucz=wartość` – zobacz [Konfiguracja z poziomu Low-code](https://docs.eximee.com/zarzadzanie-aplikacja-biznesowa/zarzadzanie-konfiguracja/konfiguracja-aplikacji-biznesowej-serwer-konfiguracji/konfiguracja-z-poziomu-low-code.md). Wcześniej była to cała zawartość pozycji **Konfiguracja**. |

Wszystkie trzy zakładki są częścią artefaktu aplikacji: zmieniasz je w wersji roboczej aplikacji, zapisujesz z nową wersją aplikacji i przenosisz razem z aplikacją eksportem albo migracją. Katalog kolumn przenosi się osobno – zobacz [Przenoszenie katalogu na inne środowisko](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md#przenoszenie-katalogu-na-inne-srodowisko).

## Zakładka „Lista spraw”

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-638c53d4bfdb23f15753be4a1c65122e9995858c%2F1-lista-spraw.png?alt=media" alt="Zakładka Lista spraw w konfiguracji aplikacji demoCaseListColumn1_app z sekcjami Podsumowanie, Kolumny wspólne i Rozszerzenia"><figcaption><p><em><strong>Ilustracja 1.</strong> Zakładka „Lista spraw” aplikacji <code>demoCaseListColumn1_app</code></em></p></figcaption></figure>

Opisy w tabelach pochodzą z dwóch miejsc: opis kolumny dodatkowej – z [katalogu kolumn listy spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md), opis pola – z pola **Opis** na karcie pola w edytorze modelu danych. Dzięki nim widać, co zawiera kolumna i pole, bez otwierania katalogu i modelu.

Zakładka ma, od góry, sekcje:

* **Podsumowanie** – jak pracownik banku zobaczy aplikację w panelu kolumn listy spraw: karta kolumn wspólnych z liczbą kolumn, które mają wybrane pole, np. „4 z 4”, oraz karta **Rozszerzenia** z liczbą i nazwami kolumn dodatkowych aplikacji. Kolumny wspólne bez pola karta pokazuje na żółto pod napisem „Bez pola modelu, na liście spraw puste:”.
* **Kolumny wspólne** – tabela kolumn wspólnych z typem i źródłem wartości. Kolumny, które wypełnia platforma, mają oznaczenie **Platforma** i nie mają ustawień. Kolumna z wybranym polem pokazuje klucz pola, a pod nim opis pola z modelu danych, np. `fullName` i „Klient (kolumna wspólna Klient)”.
* **Rozszerzenia** – tabela kolumn dodatkowych aplikacji. Kolumna z katalogu ma nazwę, a pod nią opis z katalogu, np. **Kwota deklarowana (PLN)** i „Kwota, o którą klient wnioskuje, w złotych.”. Obok są typ kolumny oraz klucz i opis pola modelu danych. Długi opis tabela skraca wielokropkiem.

Poza trybem edycji aplikacji zakładka jest tylko do odczytu.

### Lista pól

Pole dla kolumny wybierasz z listy, która ma pełne klucze pól pojedynczych modelu danych aplikacji, np. `fullName` albo `wnioskodawca.pesel`, oraz ich opisy. Lista ma pola modelu danych w wersji, którą wskazują zależności aplikacji. Na górze listy jest pole **Szukaj pola**, które zawęża ją do pól z wpisanym tekstem.

Lista pól nie jest filtrowana po typie, a zakładka nie sprawdza, czy typ pola pasuje do typu kolumny. Dopasuj pole do typu kolumny z katalogu – zobacz [Typy kolumn](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md#typy-kolumn).

### Kolumny wspólne

1. W Eximee Designer otwórz aplikację i wybierz **Konfiguracja**.
2. Kliknij ikonę ołówka na belce. Designer tworzy [wersję roboczą](https://docs.eximee.com/budowanie-aplikacji/aplikacja-biznesowa/wersjonowanie/wersja-robocza-elementu.md) aplikacji, oznaczoną na belce jako **SZKIC**.
3. W tabeli **Kolumny wspólne** kliknij **Wybierz pole** w wierszu kolumny, np. **Klient**.
4. Wybierz pole z listy, np. `fullName`.
5. Powtórz kroki 3–4 dla kolumn **ID**, **PESEL** i **Status**.
6. Zapisz nową wersję aplikacji ikoną **Zapisz** na belce: wpisz opis zmiany i kliknij **Zapisz** w oknie **Zapisz wersję**.

Aby usunąć pole kolumny, w trybie edycji aplikacji otwórz listę wyboru pola i kliknij **×** przy wybranym polu albo wybierz to samo pole jeszcze raz. Kolumna bez pola ma na liście spraw pustą komórkę.

| Kolumna    | Co zapisuje aplikacja w polu                                                                                                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Klient** | imię i nazwisko albo nazwę klienta, np. „Anna Nowak”. Którą osobę pokazuje kolumna – osobę, która rozpoczęła sprawę, pełnomocnika firmy czy klienta, którego dotyczy sprawa – zależy od wybranego pola. |
| **ID**     | identyfikator klienta, np. „KL-48291736”                                                                                                                                                                |
| **PESEL**  | numer PESEL klienta                                                                                                                                                                                     |
| **Status** | status sprawy jako dowolny tekst, np. „W analizie”                                                                                                                                                      |

Kolumna **Status** pokazuje tekst nadany przez aplikację; lista nie ma ustalonego zestawu statusów. Filtr **Status** na liście ma wszystkie statusy spraw widocznych dla użytkownika, dlatego używaj w aplikacji stałego zestawu statusów, np. „Nowy”, „W analizie”, „Do decyzji”.

Kolumny **Numer sprawy**, **Opis**, **Aplikacja**, **Priorytet**, **Przypisanie** i **Data uruchomienia** wypełnia platforma – zobacz [Źródła danych w kolumnach](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw.md#zrodla-danych-w-kolumnach).

### Rozszerzenia

1. W trybie edycji aplikacji kliknij **Dodaj kolumnę** w sekcji **Rozszerzenia**. Na końcu tabeli pojawia się wiersz z polem **Wyszukaj kolumnę katalogu**.
2. Kliknij **Wyszukaj kolumnę katalogu** i wpisz fragment nazwy albo klucza kolumny, np. `kwota`. Lista pokazuje przy każdej kolumnie nazwę, a pod nią opis z katalogu, typ i liczbę aplikacji, które jej używają, np. „2 aplikacje”.
3. Kliknij kolumnę, np. **Kwota deklarowana (PLN)**. Wiersz dostaje nazwę, opis i typ kolumny z katalogu.
4. W tym samym wierszu kliknij **Wybierz pole** i wybierz pole modelu danych, np. `declaredAmount`.
5. Zapisz nową wersję aplikacji.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-6c657085934d392824ff826fb1d4e342070292f5%2F2-dodanie-kolumny.png?alt=media" alt="Wyszukiwarka kolumn katalogu w sekcji Rozszerzenia z kolumnami Kwota deklarowana (PLN), Oddział, Data złożenia wniosku, Ostatni kontakt i Numer umowy, każda z opisem, typem i liczbą aplikacji"><figcaption><p><em><strong>Ilustracja 2.</strong> Wybór kolumny z katalogu w sekcji „Rozszerzenia”</em></p></figcaption></figure>

Zasady sekcji **Rozszerzenia**:

* Wyszukiwarka nie pokazuje kolumn, które aplikacja już ma, ani kolumn wycofanych. Gdy potrzebnej kolumny nie ma w katalogu, zgłoś ją właścicielowi katalogu.
* Nowy wiersz trafia do konfiguracji dopiero z wybranym polem. Wiersz bez pola znika, gdy zakładka przechodzi w tryb tylko do odczytu, np. po zapisaniu wersji aplikacji.
* Usunięcie pola wyjmuje kolumnę z konfiguracji, ale jej wiersz zostaje, żeby można było wybrać inne pole.
* Ikona kosza **Usuń kolumnę** na końcu wiersza usuwa kolumnę z aplikacji.
* Kolumna wycofana w katalogu ma w wierszu oznaczenie **wycofana**, a kolumna, której klucza nie ma katalog środowiska, oznaczenie **Brak w katalogu**. Aplikacja zachowuje takie kolumny, ale pola nie da się w nich usunąć, bo kolumny nie dałoby się dodać z powrotem. Kolumna **Brak w katalogu** nie jest widoczna na liście spraw, dopóki katalog nie dostanie kolumny z tym kluczem.

## Pole modelu danych używane na liście spraw

Model danych przechowuje tylko wartości pól. Po prawej stronie karty pola w edytorze modelu danych jest sekcja **Używane w**, która pokazuje, w której kolumnie listy spraw aplikacja używa pola, np. „Lista spraw, kolumna **Oddział**”, z odnośnikiem **Konfiguracja aplikacji** do zakładki **Lista spraw**. Pole, którego nie używa żadna aplikacja, ma napis „Pole nie jest używane na liście spraw.”.

<figure><img src="https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-42d2fc3dd82ad78f3be98540c371e68126f9e924%2F5-uzywane-w.png?alt=media" alt="Karta pola branch w edytorze modelu danych z sekcją Używane w: Lista spraw, kolumna Oddział i odnośnikiem Konfiguracja aplikacji"><figcaption><p><em><strong>Ilustracja 3.</strong> Sekcja „Używane w” na karcie pola <code>branch</code></em></p></figcaption></figure>

Gdy zmienisz klucz pola używanego na liście spraw, usuniesz je, zamienisz w tablicę albo dodasz mu pola podrzędne, okno zapisu nowej wersji modelu danych ostrzega: „Lista spraw używa pola …, które usunięto lub zmieniono. Popraw konfigurację aplikacji.”. Ostrzeżenie nie blokuje zapisu, ale do czasu poprawy konfiguracji aplikacji kolumna jest pusta. Wybierz wtedy w zakładce **Lista spraw** pole o nowym kluczu i zapisz nową wersję aplikacji.

## Kolumna dodatkowa w wielu aplikacjach

Lista łączy kolumny dodatkowe różnych aplikacji po kluczu z katalogu. Przykład: aplikacje `demoCaseListColumn1_app` i `demoCaseListColumn2_app` mają w sekcji **Rozszerzenia** kolumnę `declaredAmount`. Panel kolumn ma jedną kolumnę „Kwota deklarowana (PLN)”, a sprawy obu aplikacji pokazują w niej wartości swoich pól `declaredAmount`. Sprawy aplikacji, które nie mają tej kolumny, mają w niej pustą komórkę.

Klucz kolumny z katalogu i klucz pola modelu danych to osobne identyfikatory – w aplikacjach demonstracyjnych są takie same, ale pole może mieć w każdej aplikacji inny klucz: liczy się tylko klucz kolumny z katalogu. Nazwa, typ i sposób sortowania kolumny są takie same dla wszystkich aplikacji.

## Kiedy wartości pojawiają się na liście

* Lista pobiera wartości przy każdym zapisie danych instancji aplikacji w modelu danych i pokazuje wartość zapisaną ostatnio. Pole wyczyszczone albo bez wartości daje pustą komórkę.
* Lista czyta konfigurację z najnowszej wersji aplikacji. Nowa wersja aplikacji trafia na listę z opóźnieniem do minuty.
* Lista nie uzupełnia wstecz wartości zapisanych przed zmianą konfiguracji. Sprawa pokazuje wartość z nowego pola od najbliższego zapisu danych jej instancji, np. gdy formularz zadania sprawy zapisze dane; do tego czasu ma wartości sprzed zmiany.
* Wartości kolumny dodatkowej, której aplikacja już nie używa, zostają przy sprawach, ale lista nie zbiera nowych.
* Wszystkie sprawy jednej instancji aplikacji, np. proces i jego podproces, mają te same wartości.
* Zmiana nazwy albo typu kolumny w katalogu zmienia listę od razu po zapisaniu wersji katalogu, bez ponownego zapisu danych spraw.

## Dane osobowe

Kolumny **Klient**, **ID**, **PESEL** i kolumny dodatkowe mogą zawierać dane osobowe. Pole objęte depersonalizacją w modelu danych aplikacji jest nią objęte także na liście, bez osobnego oznaczenia. Po depersonalizacji lista pokazuje wartość zamaskowaną, a sortowanie, filtry i wyszukiwanie działają na wartościach zamaskowanych. Sprawa zostaje na liście.

Konfigurację danych osobowych w modelu danych opisuje strona [RODO w modelu danych](https://docs.eximee.com/budowanie-aplikacji/model-danych/rodo-zarzadzanie-danymi-osobowymi.md).

## Przykład

Aplikacja `demoCaseListColumn1_app` ma w zakładce **Lista spraw** konfigurację z [ilustracji 1](#zakladka-lista-spraw): kolumny wspólne z polami `fullName`, `clientId`, `pesel` i `status` oraz rozszerzenia „Kwota deklarowana (PLN)”, „Oddział”, „Data złożenia wniosku”, „Ostatni kontakt” i „Numer umowy”. Aplikacja zapisała w sprawie wartości:

| Pole              | Zapisana wartość       | Komórka na liście                                                        |
| ----------------- | ---------------------- | ------------------------------------------------------------------------ |
| `fullName`        | `Anna Nowak`           | **Klient**: Anna Nowak                                                   |
| `clientId`        | `KL-48291736`          | **ID**: KL-48291736                                                      |
| `pesel`           | `12345678901`          | **PESEL**: 12345678901                                                   |
| `status`          | `W analizie`           | **Status**: W analizie                                                   |
| `declaredAmount`  | `18500.50`             | **Kwota deklarowana (PLN)**: 18500.50                                    |
| `branch`          | `Łódź Śródmieście`     | **Oddział**: Łódź Śródmieście                                            |
| `applicationDate` | `2026-10-01`           | **Data złożenia wniosku**: 01.10.2026                                    |
| `lastContactAt`   | `2026-10-21T08:30:00Z` | **Ostatni kontakt**: 21.10.2026 10:30 (serwer w strefie czasu polskiego) |
| `contractNumber`  | `UM/2026/0412`         | **Numer umowy**: UM/2026/0412                                            |

Na liście wszystkich spraw:

* kolumny **Klient**, **ID**, **PESEL** i **Status** pokazują wartości sprawy,
* sekcja **Rozszerzenia** panelu **Konfiguracja kolumn** ma kolumny „Kwota deklarowana (PLN)”, „Oddział”, „Data złożenia wniosku”, „Ostatni kontakt” i „Numer umowy”, domyślnie ukryte, a gdy użytkownik widzi też sprawy aplikacji `demoCaseListColumn2_app` – także kolumnę „Data decyzji”,
* tekst `nowak lodz` wpisany w pole **Szukaj** znajduje sprawę, bo „nowak” pasuje do kolumny **Klient**, a „lodz” do kolumny „Oddział”, także ukrytej.

## Rozwiązywanie problemów

| Problem                                                                                 | Możliwa przyczyna                                                                                                                                                                                  | Rozwiązanie                                                                                                                                                                                                                                                                                             |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kolumna jest pusta mimo wybranego pola.                                                 | Sprawa nie zapisała danych od zmiany konfiguracji, nowa wersja aplikacji nie jest zapisana, pole pobiera wartość z usługi bez zapisu w modelu albo wdrożenie nie pobiera danych z modelu na listę. | Zapisz wersję aplikacji, poczekaj na kolejny zapis danych sprawy, zapisuj wartość w modelu danych i sprawdź z administratorem [wymagania wdrożeniowe](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw.md#wymagania-wdrozeniowe). |
| Wyszukiwarka w sekcji **Rozszerzenia** nie ma potrzebnej kolumny.                       | Kolumny nie ma w katalogu, jest wycofana albo aplikacja już ją ma.                                                                                                                                 | Poproś właściciela katalogu o dodanie lub przywrócenie kolumny.                                                                                                                                                                                                                                         |
| Wiersz kolumny ma oznaczenie **Brak w katalogu**.                                       | Aplikacja została przeniesiona na środowisko, którego katalog nie ma tej kolumny.                                                                                                                  | Przenieś konfigurację platformy na środowisko – zobacz [Katalog kolumn listy spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md#przenoszenie-katalogu-na-inne-srodowisko).                     |
| Komórka pokazuje **Błąd danych**.                                                       | Wartość pola nie pasuje do typu kolumny w katalogu.                                                                                                                                                | Popraw zapis wartości, np. `18500.50` zamiast `18 500,50`, albo wybierz kolumnę o innym typie.                                                                                                                                                                                                          |
| Zapis modelu danych ostrzega: „Lista spraw używa pola …, które usunięto lub zmieniono.” | Pole używane w konfiguracji aplikacji zmieniło klucz albo przestało być polem pojedynczym.                                                                                                         | Wybierz w zakładce **Lista spraw** właściwe pole i zapisz nową wersję aplikacji.                                                                                                                                                                                                                        |

## Powiązane strony

* [Katalog kolumn listy spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/katalog-kolumn-listy-spraw.md)
* [Konfiguracja listy wszystkich spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw.md)
* [Lista wszystkich spraw](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/lista-wszystkich-spraw.md)
* [Edycja modelu danych](https://docs.eximee.com/budowanie-aplikacji/model-danych/edycja-modelu-danych.md)
* [Konfiguracja z poziomu Low-code](https://docs.eximee.com/zarzadzanie-aplikacja-biznesowa/zarzadzanie-konfiguracja/konfiguracja-aplikacji-biznesowej-serwer-konfiguracji/konfiguracja-z-poziomu-low-code.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/eximee-dashboard/konfiguracja/lista-wszystkich-spraw/kolumny-listy-wszystkich-spraw.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
