> 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/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq/konfiguracja.md).

# Konfiguracja

Ta strona opisuje konfigurację, którą przygotowują administratorzy, żeby skrypty mogły wysyłać wiadomości na kolejki RabbitMQ funkcją `api.queue.v1.publishAsync` (strona [Lowcode do RabbitMQ](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq.md)).

Do konfiguracji potrzebujesz danych, które projektant procesu ustalił z administratorami i przesłał w zgłoszeniu ([przykład zgłoszenia](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq.md#przyklad-zgloszenia)): nazwy połączenia, exchange albo kolejki docelowej, routing key oraz informacji, z jakich skryptów będą wysyłane wiadomości.

## Przykład konfiguracji

Zmienne ustawiasz w pliku `env.yaml` (ConfigMap) każdej aplikacji z sekcji [Aplikacje, które wymagają konfiguracji](#aplikacje-ktore-wymagaja-konfiguracji). Pełny przykład konfiguracji połączenia `INTEGRATION`:

```yaml
# Dane brokera RabbitMQ, wspólne dla wszystkich połączeń
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_HOST: 'rabbitmq.bank.local'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_PORT: '5671'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_ENABLED: 'true'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_VALIDATE_SERVER_CERTIFICATE: 'true'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_VERIFY_HOSTNAME: 'true'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_VIRTUAL_HOST: 'eximee'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_USERNAME: '<uzytkownik>'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_PASSWORD: '<haslo>'

# Połączenie "integration": exchange domyślny, routing key = nazwa kolejki
SCRIPT_QUEUE_INTEGRATION_PRODUCER_EXCHANGE: ''
```

Kolejne sekcje opisują, skąd wziąć wartości do tego przykładu, w których aplikacjach je ustawić, jak przygotować broker, a potem połączenia, segment `COMMON` i każdą zmienną.

## Dane ze zgłoszenia

| Dane ze zgłoszenia                          | Co z nimi zrobić                                                                                                                                                                                                                                                                       |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nazwa połączenia, na przykład `integration` | Projektant procesu może zaproponować nazwę. Potwierdź ją albo wskaż istniejące połączenie. Użyj jej wielkimi literami w nazwach zmiennych, na przykład `SCRIPT_QUEUE_INTEGRATION_PRODUCER_EXCHANGE`. Nazwa nie może zawierać znaku `_` (sekcja [Nazwa połączenia](#nazwa-polaczenia)). |
| Exchange                                    | Wpisz go w `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_EXCHANGE`. Dla exchange domyślnego ustaw pustą wartość `''`.                                                                                                                                                                            |
| Kolejka docelowa i routing key              | Załóż kolejkę na brokerze, a przy exchange nazwanym także binding z exchange z tym routing key. W konfiguracji Eximee ich nie wpisujesz: routing key podaje skrypt przy każdej wysyłce.                                                                                                |
| Wysyłka ze skryptu usługowego w formularzu  | Skonfiguruj połączenie w aplikacji `webforms` (sekcja [Aplikacje, które wymagają konfiguracji](#aplikacje-ktore-wymagaja-konfiguracji)).                                                                                                                                               |
| Wysyłka z zadania skryptowego w procesie    | Skonfiguruj połączenie w aplikacji `process-handler-executor-camunda`.                                                                                                                                                                                                                 |

## Aplikacje, które wymagają konfiguracji

Wiadomość wysyła aplikacja, która wykonuje skrypt. Konfigurację połączenia dodaj w każdej aplikacji, z której skrypty mają wysyłać wiadomości:

| Aplikacja                          | Skrypty                                   |
| ---------------------------------- | ----------------------------------------- |
| `webforms`                         | Skrypty usługowe wywoływane z formularzy. |
| `process-handler-executor-camunda` | Zadania skryptowe w procesach.            |

Konfiguracja jednej aplikacji nie działa w drugiej. Jeżeli połączenie `integration` jest skonfigurowane tylko w `webforms`, zadanie skryptowe, które go używa, zakończy się błędem `No queue client found. [connectionId=integration]`.

## Przygotowanie brokera

Platforma nie tworzy kolejek, exchange'y ani bindingów na brokerze. Przygotowuje je administrator RabbitMQ.

{% hint style="danger" %}
Aplikacja nie sprawdza, czy exchange i kolejka docelowa istnieją. Wiadomość wysłana na exchange, którego nie ma na brokerze, albo z routing key, dla którego nie ma żadnej kolejki, przepada bez błędu.
{% endhint %}

## Połączenia i segment `COMMON`

Konfiguracja składa się z nazwanych połączeń. Połączenie to dane brokera (adres, virtual host, użytkownik, TLS) oraz exchange, na który trafiają wysyłane wiadomości. Nazwą połączenia skrypt wskazuje, którędy wysłać wiadomość.

`COMMON` nie jest połączeniem. To zestaw wartości domyślnych, które aplikacja dołącza do każdego połączenia. Połączenie może nadpisać dowolną z nich własną wartością.

Połączenie powstaje tylko wtedy, gdy ma ustawiony exchange (`PRODUCER_EXCHANGE`). Połączenie bez exchange nie jest tworzone, a skrypt, który go używa, kończy się błędem `No queue client found`.

### Typowa konfiguracja: jeden broker

W większości wdrożeń wszystkie kolejki leżą na jednym brokerze, w jednym virtual hoście. Wtedy:

* dane brokera ustaw raz, w zmiennych `SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_*`,
* utwórz jedno połączenie, na przykład `INTEGRATION`, i ustaw w nim tylko exchange.

Taką konfigurację pokazuje [przykład konfiguracji](#przyklad-konfiguracji) na początku strony.

### Kilka połączeń: inny broker, virtual host, użytkownik albo exchange

Dodaj kolejne połączenie, gdy część wiadomości ma trafić na inny broker, do innego virtual hosta, z innym użytkownikiem albo na inny exchange. W nowym połączeniu ustaw jego exchange oraz te dane, które różnią się od `COMMON`.

Przykład: połączenie `PARTNER` wysyła na exchange `partner.zdarzenia` w virtual hoście `partner`. Adres, port, TLS i dane logowania bierze z `COMMON`:

```yaml
SCRIPT_QUEUE_PARTNER_PRODUCER_CLIENT_VIRTUAL_HOST: 'partner'
SCRIPT_QUEUE_PARTNER_PRODUCER_EXCHANGE: 'partner.zdarzenia'
```

W skrypcie odwołujesz się do niego nazwą `'partner'`.

{% hint style="warning" %}
Nie ustawiaj `PRODUCER_EXCHANGE` w segmencie `COMMON`. Exchange z `COMMON` obowiązuje w każdym połączeniu, które nie ustawiło własnego, więc każde takie połączenie wysyłałoby na ten sam exchange, także na brokerze albo w virtual hoście, na którym go nie ma. Takie wiadomości przepadają bez błędu.
{% endhint %}

### Nazwa połączenia

Nazwa połączenia to fragment nazwy zmiennej pomiędzy `SCRIPT_QUEUE_` a `_PRODUCER`. W przykładzie `SCRIPT_QUEUE_INTEGRATION_PRODUCER_EXCHANGE` połączenie nazywa się `INTEGRATION`.

* W skrypcie podawaj nazwę połączenia małymi literami: `'integration'`. Nazwa zapisana wielkimi literami kończy się błędem `No queue client found`.
* Nazwa połączenia to jedno słowo, bez znaku `_`. Aplikacja traktuje znak `_` w nazwie zmiennej jako separator. Ze zmiennej `SCRIPT_QUEUE_BANK_CENTRALNY_PRODUCER_EXCHANGE` nie powstanie połączenie `BANK_CENTRALNY`, a skrypt, który wywoła `'bank_centralny'`, zakończy się błędem `No queue client found`. Użyj na przykład `BANKCENTRALNY` i w skrypcie `'bankcentralny'`.
* Nazwa `COMMON` jest zarezerwowana dla wartości domyślnych i nie tworzy połączenia.

## Zmienne

### Połączenie z brokerem

Zamiast `<POLACZENIE>` wpisz `COMMON` (wartość dla wszystkich połączeń) albo nazwę połączenia (wartość tylko dla niego). Wartość domyślna obowiązuje, gdy zmiennej nie ustawiono ani dla połączenia, ani w `COMMON`.

| Zmienna                                                                     | Opis                                                                                                                    | Wartość domyślna                                     |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_HOST`                            | Adres brokera.                                                                                                          | `localhost`                                          |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_PORT`                            | Port brokera.                                                                                                           | `5671` przy włączonym TLS, w przeciwnym razie `5672` |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_VIRTUAL_HOST`                    | Virtual host RabbitMQ.                                                                                                  | `/`                                                  |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_USERNAME`                        | Użytkownik brokera.                                                                                                     | `guest`                                              |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_PASSWORD`                        | Hasło użytkownika brokera.                                                                                              | `guest`                                              |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_SSL_ENABLED`                     | `true` włącza szyfrowanie połączenia (TLS).                                                                             | `false`                                              |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_SSL_VALIDATE_SERVER_CERTIFICATE` | `true` włącza weryfikację certyfikatu brokera. Opis w sekcji [Połączenie szyfrowane (TLS)](#polaczenie-szyfrowane-tls). | `false`                                              |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_CLIENT_SSL_VERIFY_HOSTNAME`             | `true` włącza sprawdzanie, czy certyfikat brokera został wystawiony dla jego adresu.                                    | `false`                                              |

{% hint style="info" %}
Zmienne wysyłki mają w nazwie `PRODUCER`. Zmienne odbioru, z `CONSUMER` w nazwie, ustawia się osobno w aplikacji `lowcode-queue-consumer` (strona [Konfiguracja konsumentów RabbitMQ](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/konsumenci-rabbitmq/konfiguracja.md)).
{% endhint %}

### Exchange połączenia

Zamiast `<POLACZENIE>` wpisz nazwę połączenia. Nie ustawiaj tej zmiennej w `COMMON`.

| Zmienna                                       | Opis                                                                                                                                                    | Wartość domyślna                                |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| `SCRIPT_QUEUE_<POLACZENIE>_PRODUCER_EXCHANGE` | Exchange, na który połączenie wysyła wiadomości. Pusta wartość `''` oznacza exchange domyślny: wiadomość trafia na kolejkę o nazwie równej routing key. | Brak: połączenie bez exchange nie jest tworzone |

{% hint style="warning" %}
Aplikacja ignoruje bez ostrzeżenia zmienną z literówką w nazwie, na przykład `SSL_ENABLE` zamiast `SSL_ENABLED`. Po każdej zmianie konfiguracji sprawdź działanie wysyłki (sekcja [Sprawdzenie działania](#sprawdzenie-dzialania)).
{% endhint %}

## Połączenie szyfrowane (TLS)

Do połączenia szyfrowanego z weryfikacją certyfikatu brokera ustaw wszystkie trzy zmienne:

```yaml
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_ENABLED: 'true'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_VALIDATE_SERVER_CERTIFICATE: 'true'
SCRIPT_QUEUE_COMMON_PRODUCER_CLIENT_SSL_VERIFY_HOSTNAME: 'true'
```

Certyfikat brokera jest wtedy sprawdzany domyślnym truststore Javy w obrazie aplikacji. Certyfikat samopodpisany albo wystawiony przez wewnętrzne CA zostanie odrzucony, jeżeli tego CA nie ma w truststore.

{% hint style="danger" %}
Samo `SSL_ENABLED: 'true'` szyfruje połączenie, ale nie weryfikuje certyfikatu brokera: aplikacja zaakceptuje dowolny certyfikat. Na środowiskach produkcyjnych zawsze ustawiaj także `SSL_VALIDATE_SERVER_CERTIFICATE` i `SSL_VERIFY_HOSTNAME`.
{% endhint %}

## Wdrożenie zmian w konfiguracji

Aplikacja tworzy połączenia przy starcie. Po zmianie `env.yaml`, na przykład po dodaniu połączenia, uruchom aplikację ponownie.

Aplikacja nie łączy się z brokerem przy starcie, tylko przy pierwszej wysyłce. Uruchomi się więc także przy niedostępnym brokerze albo błędnych danych połączenia, a błąd pojawi się dopiero w skrypcie, który wysyła wiadomość.

## Sprawdzenie działania

1. Wywołaj skrypt, który wysyła wiadomość, na przykład przykładowy skrypt usługowy ze strony [Lowcode do RabbitMQ](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq.md#przykladowy-skrypt-uslugowy).
2. Jeżeli skrypt zakończył się błędem, porównaj komunikat z tabelą w sekcji [Rozwiązywanie problemów](#rozwiazywanie-problemow).
3. W panelu RabbitMQ Management otwórz kolejkę docelową, rozwiń sekcję **Get messages** i pobierz wiadomość. Sprawdź jej treść i nagłówki.

Aplikacja nie zapisuje w logach na poziomie `INFO` informacji o wysłanych wiadomościach. Wpisy o wysyłce dodaje sam skrypt przez obiekt `Logger`, tak jak przykładowy skrypt usługowy.

## Rozwiązywanie problemów

| Objaw                                                                                                 | Możliwa przyczyna                                                                                                                                                                                                                                     | Rozwiązanie                                                                                                                    |
| ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Skrypt kończy się błędem `No queue client found. [connectionId=<nazwa>]`                              | Połączenie nie jest skonfigurowane w aplikacji, która wykonuje skrypt, nie ma ustawionego `PRODUCER_EXCHANGE` albo jego nazwa zawiera znak `_`.                                                                                                       | Dodaj połączenie z `PRODUCER_EXCHANGE` w tej aplikacji i uruchom ją ponownie.                                                  |
| Skrypt kończy się błędem `AmqpConnectException`, `AmqpAuthenticationException` albo `AmqpIOException` | Aplikacja łączy się z brokerem przy pierwszej wysyłce. `AmqpConnectException`: broker jest niedostępny albo adres lub port są błędne. `AmqpAuthenticationException`: błędne dane logowania. `AmqpIOException`: na przykład virtual host nie istnieje. | Sprawdź zmienne `PRODUCER_CLIENT_*` i dostępność brokera z aplikacji. Przy porcie `5671` sprawdź, czy ustawiono `SSL_ENABLED`. |
| Skrypt kończy się bez błędu, a wiadomości nie ma na kolejce                                           | Exchange z `PRODUCER_EXCHANGE` nie istnieje na brokerze, brakuje bindingu exchange z kolejką albo routing key nie pasuje do żadnej kolejki.                                                                                                           | Sprawdź exchange, bindingi i routing key na brokerze.                                                                          |

## Powiązane strony

* [Lowcode do RabbitMQ](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq.md) — wysyłka wiadomości ze skryptów i zadań skryptowych.
* [Konfiguracja konsumentów RabbitMQ](https://docs.eximee.com/eksploatacja-aplikacji/obsluga-zdarzen/konsumenci-rabbitmq/konfiguracja.md) — konfiguracja odbioru wiadomości.


---

# 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/eksploatacja-aplikacji/obsluga-zdarzen/lowcode-do-rabbitmq/konfiguracja.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.
