> 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/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/wybor-rachunku-accountselector.md).

# Wybór rachunku - AccountSelector

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

Komponent wyboru rachunku umożliwia wybranie go z listy rozwijanej. Każda pozycja może mieć osobno opisy, prezentowane w dwóch rzędach. Dodatkowo komponent wspiera grupowanie elementów pojawiających się na liście.

![](https://1082717226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2CssJT0zIo4SJQLbSZ6l%2Fuploads%2Fgit-blob-a9d818da76ba5ebbe55788e763a6af58286ed018%2FaccountSelector.png?alt=media)

✅ **Kiedy stosować:**

* Wybór rachunku z listy rozwijanej, gdzie pozycje mają dodatkowy opis, numer konta, saldo lub grupowanie.

:x: **Kiedy nie stosować:**

* Wystarczy wybór jednej opcji bez dodatkowych danych. **Stosuj**: [Radio](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/radio.md) / [Tile](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/kafel-tile.md) / [Combobox](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/pole-wyboru-wartosci-z-listy-combobox.md).

## Właściwości komponentu

| Właściwość Eximee Designer                      | Nazwa atrybutu w Źródle | Opis                                                                                                                                                     |
| ----------------------------------------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Placeholder pola** (sekcja **Jakość danych**) | placeholderText         | Tekst widoczny w polu przed wybraniem jakiejkolwiek wartości.                                                                                            |
| **Pusta opcja**                                 | emptyOption             | Właściwość dodawana bezpośrednio do źródła. Wartość `true` wyświetla pierwszy element z listy; wartość `false` wyświetla placeholder (np. "Wybierz..."). |

> Więcej informacji o właściwościach komponentu: [Wspólne właściwości komponentów](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow.md)

## Parametry wejściowe komponentu

| Nazwa parametru       | Opis                                                                                                               |
| --------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **iconUrl**           | Adres URL do ikony/zdjęcia wyświetlanego obok pozycji na liście (zasoby serwera Eximee).                           |
| **text**              | Główna etykieta (opis) pozycji na liście.                                                                          |
| **description**       | Dodatkowy opis pozycji, np. numer konta lub szczegółowe informacje (obsługuje wartości tekstowe lub logiczne).     |
| **suffix**            | Krótki opis dodatkowy wyświetlany na końcu pozycji, np. kwota lub waluta.                                          |
| **groupId**           | Identyfikator grupy. Pozycje z tym samym ID są grupowane i sortowane alfabetycznie w ramach sekcji.                |
| **group**             | Flaga określająca, czy ma być prezentowany wariant z podziałem na grupy (`true`/`false`).                          |
| **ellipsis**          | Określa, czy `description` ma być skracane do jednej linii (`true`/`false`).                                       |
| **ellipsisText**      | Określa, czy `text` ma być skracany do jednej linii. Domyślnie `true`. Ustawienie `suffix` wymusza wartość `true`. |
| **singleAccountList** | Informacja, czy prezentować widok pojedynczej listy kont (`true`/`false`).                                         |
| **shortAccountList**  | Informacja, czy prezentować skróconą wersję listy kont (`true`/`false`).                                           |

## Warianty komponentu

![Ilustracja 1. Komponent z samymi nazwami kont](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/iFerW96MOtF1gmDGLBBL/12_files/image2020-10-7_15-59-47.png)

![Ilustracja 2. Komponent z dodatkowym opisem](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/tYyWFwwhFTRlYIOV8HqM/12_files/image2020-10-7_16-0-16.png)

![Ilustracja 3. Komponent z dodatkowym opisem oraz sekcjami](https://content.gitbook.com/content/2CssJT0zIo4SJQLbSZ6l/blobs/QlJzxtg4ImJkeN9YE3Xz/12_files/image2020-10-7_16-0-56.png)

## Informacje o stanie komponentu

W przeciwieństwie do większości komponentów wyboru, AccountSelector przechowuje wartość jako obiekt JSON zawierający wszystkie dane wybranej pozycji.

Po wybraniu konkretnej opcji komponent przyjmuje wartość w następującym formacie:

```
[{
    "suffix":"(14 731,21 PLN)",
    "description":"83 1123 1023 0000 2613 9510 0000",
    "groupId":"Konta",
    "text":"Konto za zero",
    "value":"4"
}]
```

## Odwoływanie się do wybranej wartości

Możliwe jest wyszukiwanie konkretnych fragmentów tekstu za pomocą metody `indexOf()`.

Dla przykładowej wartości komponentu zaprezentowanej powyżej, warunek:

```
getValue("GesAccountSelector1").indexOf('"value":"4"') != -1
```

zwróci:

* `true` - jeżeli wybrano konto o wartości `4`,
* `false` - jeżeli wybrano inną pozycję.

{% hint style="info" %}
Metoda `indexOf()` zwraca pozycję znalezionego tekstu lub `-1`, jeśli wskazany fragment nie występuje w wartości komponentu.
{% endhint %}

Może to być przydatne w sytuacji, gdy widoczność innego komponentu ma być zależna od wybranego rachunku.

Przykład warunku widoczności ukrywający komponent dla konta o wartości `4`:

```
getValue("GesAccountSelector1").indexOf('"value":"4"') == -1
```

W analogiczny sposób można odwoływać się do pozostałych właściwości obiektu, np. `text`, `description`, `suffix` lub `groupId`.

## Model danych

Dane rachunku wybranego w komponencie Wybór rachunku są zapisywane w modelu danych. W polu **Klucz modelu danych** należy wskazać [węzeł wielokrotny](https://docs.eximee.com/budowanie-aplikacji/model-danych/struktura-modelu-danych.md#strukturamodeludanychbudowanieiuzywanie-definiowanietablicowychpolmodeludanych) o liczebności bez górnego limitu, np. `1..null`. Wybrany rachunek trafia do elementu `[0]` tego węzła, a kolejne wybrane rachunki do elementów `[1]`, `[2]` itd. Pod węzłem należy utworzyć pola, które mają być przechowywane:

| Pole            | Co zawiera                                        |
| --------------- | ------------------------------------------------- |
| **value**       | Identyfikator rachunku. Pole jest wymagane.       |
| **text**        | Główna etykieta rachunku.                         |
| **description** | Dodatkowy opis rachunku, np. numer konta.         |
| **suffix**      | Krótki opis na końcu pozycji, np. saldo i waluta. |
| **groupId**     | Identyfikator grupy, do której należy rachunek.   |
| **iconUrl**     | Adres ikony wyświetlanej obok rachunku.           |

Pola inne niż `value` są opcjonalne – więcej informacji w [Model danych na interfejsie](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/model-danych-na-interfejsie.md#komponenty-o-wartosci-zlozonej). Przy otwarciu formularza wybrany rachunek jest odczytywany z pól zapisanych w modelu.

Przykład: w komponencie ustawiono **Klucz modelu danych** `rachunki`, a pod tym węzłem utworzono pola `value`, `text` i `description`:

```
rachunki (1..null)
├── value
├── text
└── description
```

Użytkownik wybiera rachunek pokazany w sekcji „Informacje o stanie komponentu”. Po zapisaniu wniosku model zawiera:

```
rachunki[0].value = 4
rachunki[0].text = Konto za zero
rachunki[0].description = 83 1123 1023 0000 2613 9510 0000
```

Saldo (`suffix`) i grupa (`groupId`) nie mają pól w modelu, więc nie trafiają do modelu danych.

{% hint style="warning" %}
Jeśli pod węzłem utworzono którekolwiek pole, należy utworzyć też pole `value`. Bez niego formularz zgłasza błąd przy otwieraniu.

Klucz modelu danych musi wskazywać węzeł wielokrotny. Jeśli wskazuje pojedyncze pole, rachunek nie jest zapisywany w modelu.
{% endhint %}

## Zasilenie komponentu wartościami

Aby zasilić komponent danymi w modelu low-code, należy skonfigurować Zewnętrzne Źródło Danych (EDS). Poniżej znajduje się przykład zwracający listę rachunków:

```js
function callService(context) {
    // Pobranie parametrów kontekstowych (opcjonalnie)
    const showSuffix = context.getFirstParameter("showSuffix") === "true";

    return [
        {
            "value": "1",
            "text": "Konto za Zero",
            "description": "83 1123 1023 0000 2613 9510 0000",
            "suffix": showSuffix ? "(14 731,21 PLN)" : null,
            "groupId": "Konta osobiste",
            "iconUrl": "/assets/icons/account_active.png",
            "ellipsis": true
        },
        {
            "value": "2",
            "text": "Karta Kredytowa MC",
            "description": "45 1010 1023 0123 2618 9510 1111",
            "suffix": showSuffix ? "(5 000,00 PLN)" : null,
            "groupId": "Karty",
            "iconUrl": "/assets/icons/card_gold.png",
            "ellipsis": true
        }
    ];
}
```

{% hint style="info" %}
Uwaga! Jeśli w domenie komponentu znajduje się wyłącznie jeden rachunek, wówczas zostaje on automatycznie wybrany, a komponent staje się zablokowany.
{% endhint %}

Po dokonaniu wyboru, komponent przechowuje dane w formacie tablicy obiektów:

```js
[{
    "value": "1",
    "text": "Konto za Zero",
    "description": "83 1123 1023 0000 2613 9510 0000",
    "suffix": "(14 731,21 PLN)",
    "groupId": "Konta osobiste"
}]
```

Wniosek demo:

{% hint style="info" %}
Wniosek demo: demoAccountSelector
{% endhint %}


---

# 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/formularze/biblioteka-komponentow-bazowych/2-pola-wyboru/wybor-rachunku-accountselector.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.
