> 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/zapis-danych-tymczasowych.md).

# Zapis danych tymczasowych

Możliwe jest zapisanie pewnych danych pomiędzy wywołaniami serwisu. Służy do tego obiekt `registry` wywoływany z poziomu lokalnego kontekstu (`context.registry()`).

Obiekt do poprawnego działania wymaga działającej aplikacji **EximeeRegistry**.

{% hint style="danger" %}
**Ważne:** Zapis danych za pomocą EximeeRegistry **nie służy** do zapisu czegokolwiek na stałe!
{% endhint %}

## Dostępne metody

Obiekt `registry` udostępnia następujące metody pozwalające na zarządzanie zapisanymi danymi:

| Metoda                                      | Opis                                                                                                                                                                                                                                         |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `save(namespace, id, data)`                 | Zapisuje przekazane dane pod wskazanym identyfikatorem.                                                                                                                                                                                      |
| `saveVersion(namespace, id, data, version)` | Zapisuje dane z weryfikacją wersji. Jeśli pole `version` jest nieustawione lub puste – zapis następuje bez weryfikacji. Jeśli wartość pola `version` nie zgadza się z aktualną wersją przechowywanych danych, wniosek zakończy się z błędem. |
| `get(namespace, id)`                        | Pobiera zapisane dane (zwraca samą zawartość).                                                                                                                                                                                               |
| `getVersion(namespace, id)`                 | Pobiera zapisane dane wraz z ich aktualną wersją. Zwraca obiekt o strukturze: `{ data: 'zapisane dane', version: 'aktualna wersja danych' }`.                                                                                                |
| `delete(namespace, id)`                     | Usuwa zapisane dane ze wskazanej przestrzeni.                                                                                                                                                                                                |

## Przestrzeń nazw i cykl życia danych

* **Przestrzenie nazw (namespace):** Dane przechowywane są w wydzielonych przestrzeniach nazw ustalanych przez administratorów.
* **Czas życia (TTL):** Każdej przestrzeni można ustawić indywidualny czas życia danych. **Domyślnie wynosi on 90 dni.**
* **Aktualizacja:** Podanie tego samego `id` w ramach kilku wywołań zapisu powoduje zaktualizowanie danych powiązanych z tym identyfikatorem.
* **Wersjonowanie:** Wersja danych to unikalny identyfikator generowany automatycznie przy każdym zapisie (lub aktualizacji) danych. Każdy zapis tworzy nową wersję wpisu. Przy `saveVersion` można podać wersję do weryfikacji — jeśli nie zgadza się z aktualną, zapis zostanie odrzucony. `null` oznacza zapis wymuszony, bez sprawdzania wersji.

## Przykłady użycia

Poniższy skrypt prezentuje cykl życia danych tymczasowych od ich zapisu, poprzez odczyt, bezpieczną aktualizację z weryfikacją wersji, aż po usunięcie:

```javascript
function callService(context) {
    // 1. Zapis danych tymczasowych pod kluczem '123123' w przestrzeni 'test'
    context.registry().save('test', '123123', 'dane tymczasowe');
    
    // 2. Proste pobranie danych (zwróci wartość: 'dane tymczasowe')
    const simpleData = context.registry().get('test', '123123'); 
    
    // 3. Pobranie danych wraz z ich wersją
    const item = context.registry().getVersion('test', '123123'); 
    
    // 4. Bezpieczna aktualizacja danych (zapis się uda, ponieważ wersja z obiektu 'item' jest aktualna)
    context.registry().saveVersion('test', '123123', 'nowe dane', item.version);
    
    // 5. Próba aktualizacji ze złą wersją (zapis się NIE uda, platforma rzuci błąd)
    // context.registry().saveVersion('test', '123123', 'kolejne dane', 'jakaś inna wersja');
    
    // 6. Usunięcie danych z rejestru
    context.registry().delete('test', '123123');

    return [{}];
}
```


---

# 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/zapis-danych-tymczasowych.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.
