> 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.md).

# API skryptów

Skrypty pozwalają na wprowadzanie zaawansowanej logiki biznesowej, integrację z zewnętrznymi usługami, zaawansowaną walidację oraz manipulację stanem wniosku.

## Dostępne obiekty globalne

Pisząc logikę biznesową (niezależnie od tego, czy są to skrypty, walidatory skryptowe, czy zadania skryptowe), masz do dyspozycji dwa główne obiekty globalne, które stanowią fundament pracy z API:

* **`context`** – reprezentuje lokalny kontekst wywołania skryptu. Pozwala na pobieranie parametrów wejściowych, odczytywanie wartości bezpośrednio z komponentów na formularzu, korzystanie z rejestru tymczasowego oraz kontrolowanie struktury danych zwracanych przez skrypt.
* **`api`** – reprezentuje globalne usługi platformy Eximee. Udostępnia metody do interakcji z systemem, m.in. pobieranie kontekstu użytkownika, operacje na procesach BPM, czy odczyt konfiguracji i tłumaczeń aplikacji.

## Podstawy pracy ze skryptami

* [**Dane wejściowe i wyjściowe**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/dane-wejsciowe-i-wyjsciowe.md) – metody obiektu `context`, pobieranie parametrów z formularza i prawidłowe formatowanie zwracanych wyników.
* [**Logowanie informacji i błędów**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/logowanie-informacji-i-bledow.md) – zasady korzystania z loggera, maskowanie danych wrażliwych.
* [**Operacje matematyczne na liczbach**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/operacje-matematyczne-w-scriptcode.md) – jak bezpiecznie przeliczać wartości przy użyciu obiektu `BigDecimal`.
* [**Przetwarzanie plików arkuszy**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/przetwarzanie-plikow-arkuszy.md) – odczyt i parsowanie załączników z rozszerzeniem XLSX.
* [**Rzucanie wyjątków biznesowych**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/rzucanie-wyjatkow-biznesowych.md) - kontrolowane przerywanie działania skryptu, konfiguracja komunikatów dla użytkownika oraz użycie `getErrorPageDefinitionBuilder`.
* [**Zapis danych tymczasowych**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/podstawy-pracy-ze-skryptami/zapis-danych-tymczasowych.md) – korzystanie z pamięci podręcznej (Rejestr / Eximee Registry).

## Usługi platformy (Interfejsy API)

* [**Kontekst zalogowanego użytkownika**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/uslugi-platformy/pobranie-kontekstu-uzytkownika.md) (`api.user`)
* [**Operacje i dostęp do danych procesu**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/uslugi-platformy/operacje-na-procesach.md) (`api.process`)
* [**Pobieranie konfiguracji aplikacji**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/uslugi-platformy/pobieranie-konfiguracji-aplikacji.md) (`api.config`)
* [**Pobieranie treści i tłumaczeń**](/budowanie-aplikacji/logika-biznesowa/scriptcode/skrypty-scriptservice/api-skryptow/uslugi-platformy/pobieranie-tresci-i-tlumaczen.md) (`api.repository`)

## Powiązane obszary platformy

Niektóre zagadnienia ściśle powiązane z pisaniem logiki biznesowej w skryptach zostały szczegółowo opisane w innych częściach dokumentacji Eximee. Zanim rozpoczniesz pracę, upewnij się, że znasz poniższe mechanizmy:

* [**API Modelu Danych**](/budowanie-aplikacji/model-danych/wykorzystanie-modelu-danych/api-modelu-danych.md) – interfejsy do modyfikacji i odczytu modelu danych wniosku.


---

# 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.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.