# Limit wniosków (dławik)

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

## Limit aktywnych instancji wniosków

Limit aktywnych instancji wniosków (tzw. *dławik*) pozwala ograniczyć liczbę jednocześnie uruchomionych wniosków danego typu na **konkretnym serwerze**. Po przekroczeniu limitu użytkownik nie może uruchomić kolejnej instancji – zamiast tego wyświetlana jest strona informacyjna.

Rozwiązanie to jest szczególnie przydatne w sytuacjach zwiększonego obciążenia systemu lub podczas prac utrzymaniowych.

## Konfiguracja

Konfiguracja limitów odbywa się w pliku:

```
/etc/eximee/webforms.xml
```

{% hint style="info" %}
Zmiany w pliku są stosowane bez konieczności restartu serwera Tomcat.
{% endhint %}

Przykładowa konfiguracja w pliku .xml:

```js
<webforms>
    <server> 
        <limits>
            <forms>
                <_uwmappertest>3</_uwmappertest>
                <_demo_porownywarka_ofert>3</_demo_porownywarka_ofert>
            </forms>
        </limits>
    </server>
</webforms>
```

W tagu `<forms>` definiujemy wnioski objęte limitem:

```
<_FORMNAME>LIMIT</_FORMNAME>
```

Gdzie:

* `FORMNAME` – nazwa wniosku,
* `LIMIT` – maksymalna liczba aktywnych instancji.

**Ważne zasady:**

* każda nazwa wniosku `FORMNAME` musi posiadać prefix \_
* brak wpisu oznacza **brak limitu**,
* ustawienie wartości 0 oznacza całkowite **zablokowanie wniosku**.

### Przykłady konfiguracji

**Całkowite zablokowanie wniosku**

```
<_przykladowy_wniosek>0</_przykladowy_wniosek>
```

Po wejściu na wniosek użytkownik zobaczy stronę informującą o jego niedostępności.

**Ograniczenie liczby instancji**

```
<_przykladowy_wniosek>2</_przykladowy_wniosek>
```

Trzecia próba uruchomienia wniosku zakończy się wyświetleniem strony błędu.

## Strona informacyjna

Tekst na stronie informacyjnej możemy ustawić z poziomu **Eximee Designer**, w zakładce **Biblioteka → Treści** i wyszukując treść formatowaną **error\_page\_formLimitExceeded**.

Należy również uzupełnić plik **webforms-error-pages.xml** dodając poniższy fragment:

```xml
<code_formLimitExceeded>
    <content>error_page_formLimitExceeded-*</content>
</code_formLimitExceeded>
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eximee.com/eksploatacja-aplikacji/webforms/konfiguracja/limit-wnioskow-dlawik.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.