> 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/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/dane-wejsciowe-i-wyjsciowe.md).

# Dane wejściowe i wyjściowe

Obiekt `context` (dostępny jako parametr wejściowy w skryptach platformy) stanowi główne narzędzie do interakcji z aktualnym stanem formularza. Umożliwia on pobieranie parametrów z mapy wejściowej, odczyt oraz modyfikację stanu komponentów, a także wywoływanie innych usług i walidatorów.

## Metody obiektu `context` (Wejście)

Poniżej znajduje się zestawienie metod dostępnych na obiekcie wejściowym:

### Pobieranie parametrów skryptu

* `List<String> getParameters(final String name)` – pobiera listę wartości przypisanych do podanego klucza z mapy danych wejściowych.
* `String getFirstParameter(final String name)` – pobiera pierwszy element z listy dla danego klucza. Zwraca `"null"` w przypadku braku wartości.
* `String getFirstParameter(final String name, final String defaultIfEmpty)` – pobiera pierwszy element z listy, a jeśli go nie ma lub jest pusty, zwraca zdefiniowaną wartość `defaultIfEmpty`.
* `Map<String, List<String>> getInputParameters()` – zwraca całą mapę danych wejściowych przekazanych do skryptu.

### Interakcja z komponentami formularza

{% hint style="warning" %}
Dostępność i rodzaj atrybutów do pobrania są ściśle zależne od typu komponentu. Więcej informacji na stronie [Atrybuty komponentów](https://docs.eximee.com/budowanie-aplikacji/logika-biznesowa/jezyk-wyrazen-definiowania-warunkow-warunki-z-getvalue/atrybuty-komponentow.md).
{% endhint %}

* `String isVisible(final String id)` – zwraca informację, czy komponent o wskazanym ID jest widoczny.
* `String getValue(final String id)` – pobiera aktualną wartość komponentu lub zmiennej sesyjnej o wskazanym ID.
* `String getData(final String id, final String attribute)` – pobiera wartość konkretnego atrybutu dla komponentu o wskazanym ID.
* `void setValue(final String componentId, final String value)` – ustawia podaną wartość `value` w komponencie o wskazanym `componentId` (zasada podawania ID jest taka sama jak przy `getValue`).

{% hint style="info" %}
Wywołując skrypt wewnątrz komponentu złożonego, w celu ustawienia wartości komponentu / zmiennej sesyjnej osadzonej w tym samym komponencie, należy `componentId` poprzedzić znakiem **`@`**.

Z kolei pobieranie danych z zewnątrz (np. z formularza nadrzędnego) powinno odbywać się z zachowaniem zasad hermetyzacji – poprzez zdefiniowanie **parametrów wejściowych** komponentu złożonego i zmapowanie na nie odpowiednich wartości.
{% endhint %}

{% hint style="danger" %}
**UWAGA!** Próba wykonania `setValue` na komponencie, który nasłuchuje na inny komponent, lub na komponencie, na który nasłuchują inne komponenty, skutkuje rzuceniem wyjątku.
{% endhint %}

### Wywoływanie zewnętrznych usług

* `List<Map<String, String>> callService(String name, Map<String, List<String>> input)` – umożliwia wywołanie zewnętrznego serwisu (ServiceProxy).
* `ValidatorOutput validate(String name, Map<String, List<String>> input)` – umożliwia wywołanie walidatora z poziomu skryptu.

## Zwracanie wyników (Wyjście)

Wynik wykonania skryptu (np. w zasilaniu komponentów) należy zwrócić w formie tablicy. Platforma obsługuje to na dwa sposoby:

1. **Lista map** – tablica obiektów na wyjściu jest parsowana na listę map, po czym zostaje przetwarzana w standardowy sposób przez komponent wywołujący.
2. **Pojedyncza mapa** – zwrotka zostaje opakowana jako lista jednoelementowa i przetwarzana standardowo.

```javascript
// Przykład zwracania listy map
function callService(context) {
    return [{'output': 'result1'}, {'output': 'result2'}, {'output': 'result3'}];
}
```

## Przykłady użycia

### Zasilenie komponentu Pole wyboru wartości z listy (Combobox) <a href="#skrypty-scriptservice-przykladowyskryptzasilajacykomponentpolewyboruwartoscizlisty-combobox-example" id="skrypty-scriptservice-przykladowyskryptzasilajacykomponentpolewyboruwartoscizlisty-combobox-example"></a>

Skrypt zasila **Pole wyboru wartości** z listy (Combobox) na podstawie przekazanego parametru 'locale'.

Wyjścia **id**, **label**, oraz **description** należy podpiąć pod odpowiednie pola Combobox, kolejno **id**, **text**, oraz **description**.

Skrypt zasilający Combobox:

```javascript
function callService(context) {
    const locale = context.getFirstParameter('locale');
    if (locale === 'pl') {
        return [
            { 'id': 1, 'label': 'Wartosc 1', 'description': 'Opis 1', },
            { 'id': 2, 'label': 'Wartosc 2', 'description': 'Opis 2' }
        ];
    } else if (locale === 'en') {
        return [
            { 'id': 1, 'label': 'Label 1', 'description': 'Description 1', },
            { 'id': 2, 'label': 'Label 2', 'description': 'Description 2' }
        ];
    } else {
        return [
            { 'id': 1, 'label': 'Wartosc domyslnego tlumaczenia 1', 'description': 'Opis 1', },
            { 'id': 2, 'label': 'Wartosc domyslnego tlumaczenia 2', 'description': 'Opis 2' }
        ];
    }
}
```

### Pobieranie nazwy plików z komponentu Załączniki (UploadFile)

Skrypt wykorzystuje metodę **getData()**, która pobiera wartość konkretnego atrybutu dla komponentu o wskazanym id. Dla komponentu **Załączniki** nazwy dodanych plików określane są za pomocą atrybutu **fileNames** i przychodzą z wniosku jako string w formacie JSON (np. *\["name1.png", "name2.png"]*), dlatego konieczne jest przekształcenie tego stringa w obiekt za pomocą metody **JSON.parse**.

{% hint style="warning" %}
**UWAGA!** Metoda **getData()** wykorzystuje id komponentu, więc skrypt nie jest uniwersalny - dla każdego wniosku należy podać odpowiednie id komponentu **Załączniki**:
{% endhint %}

```javascript
function callService(context) {
    const firstAttachmentFiles = JSON.parse(context.getData("@GesUploadFile1", "fileNames"));
    const secondAttachmentFiles = JSON.parse(context.getData("@GesUploadFile2", "fileNames"));
}
```

### Pobieranie wartości Pola wyboru wartości z listy (Combobox) w Sekcji Powtarzalnej (RepeatableSection) <a href="#skrypty-scriptservice-fragmentskryptupobierajacegowartoscipolawyboruwartoscizlisty-comboboxa-zsekcji" id="skrypty-scriptservice-fragmentskryptupobierajacegowartoscipolawyboruwartoscizlisty-comboboxa-zsekcji"></a>

Skrypt wykorzystuje metodę **getData()**, która pobiera wartość konkretnego atrybutu, dla komponentu o wskazanym id. Dla komponentu **Pole wyboru wartości z listy** wartości (etykiety) danych kluczy określane są za pomocą atrybutu **label.**

```javascript
for (let i=0; i<10; i++)  {
        let id = "GesRepeatableSection1.row" + i + ".GesCombobox1";
        let comboboxLabel = context.getData(id, "label");
}
```


---

# 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/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/dane-wejsciowe-i-wyjsciowe.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.
