> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnilinker.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# Korzystanie z aplikacji w zasobniku

> Sprawdzaj stan agenta ERP Sync w obszarze powiadomień Windows oraz wstrzymuj, wznawiaj i uruchamiaj synchronizację.

Aplikacja w zasobniku systemowym to okno agenta ERP Sync na komputerze, na którym działa agent. Pokazuje, co robi
usługa Windows, i pozwala nią sterować. Sama niczego nie synchronizuje: jej zamknięcie nie zatrzymuje usługi,
a synchronizacja działa dalej w tle.

## Uruchom aplikację w zasobniku

Aplikacja w zasobniku uruchamia się sama dla każdego, kto zaloguje się na komputerze agenta. Zapewnia to instalator.
Po instalacji lub aktualizacji usługa także uruchamia ją dla wszystkich zalogowanych osób. Ikona aplikacji pojawi się
w obszarze powiadomień obok zegara. Jeśli jej nie widzisz, kliknij strzałkę **Pokaż ukryte ikony**.

Aby uruchomić ją ręcznie, uruchom `Omnilinker.ErpSync.Tray.exe` z podfolderu `tray` folderu instalacyjnego,
domyślnie:

```text theme={null}
C:\Program Files\Omnilinker\ErpSync\current\tray
```

Jednocześnie może działać tylko jedna kopia. Przy próbie uruchomienia drugiej pojawia się komunikat „Omnilinker ERP
Sync is already running in the system tray.”

Aby zamknąć aplikację, kliknij ikonę prawym przyciskiem myszy i wybierz **Exit**. Uruchomi się ponownie przy Twoim
następnym logowaniu. Aby zatrzymać synchronizację, zatrzymaj usługę Windows: `Stop-Service OmnilinkerErpSyncService`
w PowerShell uruchomionym jako administrator.

## Co możesz zrobić w aplikacji w zasobniku

Każdy, kto jest zalogowany na komputerze, może zobaczyć status, logi i ustawienia (bez hasła i klucza API) oraz
użyć pozycji **Sync Now**, **Resume Sync**, **Trigger Hash Check**, **Resume Hash Check**, przycisku **Test Now**
w oknie statusu, sugerowanej akcji **Test ERP Connection**, **Mark All Read** i **Refresh Reference Data**.

Te działania zmieniają agenta i wymagają członka lokalnej grupy **Omnilinker ERP Sync Operators** albo
administratora, który uruchomił aplikację w zasobniku z podwyższonymi uprawnieniami:

* [kreator konfiguracji](/pl/erp/setup-wizard) oraz **Validate**, **Refresh**, **Load**, **Test Connection**
  i **Save** w oknie **Settings...**,
* **Enable Change Tracking** i **Disable Change Tracking**,
* **Pause Sync**, **Pause Hash Check** i **Cancel Hash Check**,
* **Clear All** w powiadomieniach okna statusu.

U pozostałych osób kończą się komunikatem „Only an administrator of this PC can do that.” Zobacz
[Kto może zmieniać agenta](/pl/erp/install-agent#kto-może-zmieniać-agenta).

## Kolory ikony

Ikona to kolorowe kółko. Jego kolor pokazuje stan, który usługa zgłosiła jako ostatni:

| Kolor                | Stan     | Znaczenie                                                                       |
| -------------------- | -------- | ------------------------------------------------------------------------------- |
| Zielony              | Idle     | Agent jest gotowy i czeka na następny cykl.                                     |
| Niebieski, animowany | Syncing  | Trwa synchronizacja.                                                            |
| Bursztynowy          | Paused   | Synchronizacja została przez Ciebie wstrzymana.                                 |
| Bursztynowy          | Starting | Usługa się uruchamia albo aplikacja w zasobniku wciąż się z nią łączy.          |
| Czerwony             | Error    | Ostatni cykl zakończył się błędem. Najedź kursorem na ikonę, aby zobaczyć błąd. |
| Szary                | Stopping | Usługa się zamyka.                                                              |

Czerwona plakietka z liczbą oznacza, że tyle zdarzeń nie udało się wysłać do Omnilinkera mimo wszystkich ponowień.
Powyżej 9 pokazuje `9+`.

Kolor nie mówi, czy aplikacja w zasobniku ma połączenie z usługą. Najedź kursorem na ikonę: etykieta zaczyna się od
**Omnilinker ERP Sync -**, po czym następuje **Ready**, **Waiting**, **Disconnected**, **Paused**, **Error:** z treścią
błędu, **Connecting...**, **Starting...** lub **Stopping...**. **Disconnected** oznacza, że aplikacja w zasobniku nie
może połączyć się z usługą. Gdy w kolejce są zdarzenia do wysłania, etykieta pokazuje też `Queue: <n> pending`
i ostatnią zakończoną operację.

## Menu w zasobniku

Kliknij ikonę prawym przyciskiem myszy, aby otworzyć menu. Od góry do dołu:

| Pozycja                                                            | Co robi                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wiersz stanu                                                       | Ten sam tekst co w etykiecie ikony. Nie można go kliknąć.                                                                                                                                                                                |
| **Queue: Empty** lub **Queue: `<n>` pending \| `<n>` failed**      | Zdarzenia czekające na wysłanie do Omnilinkera. Nie można go kliknąć.                                                                                                                                                                    |
| **Suggested Actions:**                                             | Widoczne tylko przy błędzie. Proponuje do trzech rozwiązań, np. **Test ERP Connection**, **Test Cloud Connection**, **Check Settings**, **Retry Now**, **View Logs**, **Check Network**, **Contact Support** lub **View Error Details**. |
| **Open Dashboard**                                                 | Otwiera w przeglądarce **Integracja ERP** > **Panel** w Omnilinkerze.                                                                                                                                                                    |
| **My Connection**                                                  | Otwiera w Omnilinkerze połączenie tego agenta. Dostępne, gdy agent jest skonfigurowany.                                                                                                                                                  |
| **Show Status...**                                                 | Otwiera [okno Status](#okno-status).                                                                                                                                                                                                     |
| **Sync Now**                                                       | Prosi agenta o natychmiastowe wyszukanie zmian. Dostępne, gdy agent jest bezczynny lub wstrzymany.                                                                                                                                       |
| **Pause Sync**                                                     | Wstrzymuje synchronizację. Dostępne podczas synchronizacji.                                                                                                                                                                              |
| **Resume Sync**                                                    | Wznawia synchronizację. Dostępne, gdy synchronizacja jest wstrzymana.                                                                                                                                                                    |
| Wiersz weryfikacji hash                                            | Na przykład **Hash Check: Disabled**, **Hash Check: Pending first run**, **Hash Check: 5m ago (no changes)** lub **Hash Check: Running (1,200/5,000 - 24%)**. Nie można go kliknąć.                                                      |
| **Trigger Hash Check**                                             | Od razu uruchamia weryfikację hash. Dostępne, gdy weryfikacje hash są włączone i żadna nie trwa.                                                                                                                                         |
| **Progress Details**                                               | Widoczne podczas weryfikacji hash: sprawdzone produkty i marki, tempo i szacowany pozostały czas.                                                                                                                                        |
| **Pause Hash Check**, **Resume Hash Check**, **Cancel Hash Check** | Sterują trwającą weryfikacją hash bez wstrzymywania reszty agenta.                                                                                                                                                                       |
| **View Logs**                                                      | Otwiera [okno Logs](#okno-logs).                                                                                                                                                                                                         |
| **Settings...**                                                    | Otwiera [okno Settings](#okno-settings).                                                                                                                                                                                                 |
| **Exit**                                                           | Zamyka aplikację w zasobniku. Usługa działa dalej.                                                                                                                                                                                       |

Pozycje, które nie mają zastosowania w bieżącym stanie, są wyszarzone.

Weryfikacja hash porównuje dane w ERP z tym, co agent wysłał ostatnio, i w ten sposób wykrywa zmiany. Tak agent
wykrywa zmiany, chyba że włączone jest śledzenie zmian WFM\_INT. Zobacz [Wapro](/pl/erp/providers/wapro).

### Sync Now, wstrzymywanie i wznawianie

* **Sync Now** w trybie skanowania skrótów uruchamia weryfikację hash. Agent odbiera żądanie w następnym cyklu
  odpytywania, czyli w ciągu 60 sekund przy domyślnej wartości `PollingIntervalSeconds`.
* **Pause Sync** sprawia, że agent przestaje wykrywać nowe zmiany, dopóki nie wybierzesz **Resume Sync**.
  **Sync Now** nie działa, gdy synchronizacja jest wstrzymana. Najpierw ją wznów.
* Wstrzymanie nie jest zachowywane po ponownym uruchomieniu usługi. Po restarcie agent znowu synchronizuje dane.

## Powiadomienia

Aplikacja w zasobniku pokazuje powiadomienia Windows przy zmianie stanu: **Sync Started**, **Sync Complete**,
**Service Ready**, **Sync Paused** i **Sync Error**. Pokazuje też **Service Disconnected** („Lost connection to
ERP Sync service.”), gdy traci kontakt z usługą, oraz komunikat z wynikiem poleceń takich jak
**Trigger Hash Check**.

Aby je wyciszyć, wyłącz powiadomienia tej aplikacji w Windows: **Ustawienia** > **System** > **Powiadomienia**.

## Okno Status

Wybierz **Show Status...**, aby otworzyć okno **Omnilinker ERP Sync - Status**. Odświeża się co 2 sekundy.

W nagłówku jest **Sync Status** ze wskaźnikami **Cloud** i **ERP**. Poniżej są dwie karty.

Karta **Overview** pokazuje:

* **Current Operations** i **Recently Completed**: co agent robi teraz i co właśnie skończył.
* **Queue Health**: ile zdarzeń czeka i czy kolejka rośnie.
* **System Health**: stan każdego komponentu. Kliknij **Test Now**, aby sprawdzić komponent ponownie.
* **Notifications**: komunikaty od agenta. Użyj **Mark All Read** lub **Clear All**.
* **Entity Statistics**: dla każdego typu encji liczby **Total**, **Synced**, **Pending** i **Failed**.
* **Outbox Queue**: zdarzenia **Pending**, **Sent**, **Failed** i **Retrying**.
* **Schedule** (**Last sync**, **Next sync**), **Hash Check** (**Last check**, **Changes found**), ostatni błąd
  (**Error**) i wersję agenta (**Version**).

Karta **Performance** pokazuje głębokość kolejki, wskaźnik błędów z ostatnich 24 godzin (**Error Rate**), bieżącą
aktywność z przepustowością i pozostałym czasem, **Performance Trends (Last 24 Hours)** (**Throughput**,
**Avg Duration**, **Success Rate**), stan **ERP Connection**, **Cloud API** i **Outbox** oraz
**Recent Activity (Last 5 Operations)**.

Przyciski na dole to **Pause** lub **Resume**, **Sync Now**, **Open Dashboard** i **Close**.

Jak te liczby mają się do tego, co widzisz w Omnilinkerze, opisuje strona [Monitorowanie](/pl/erp/monitoring).

## Okno Settings

Wybierz **Settings...**, aby otworzyć okno **Omnilinker ERP Sync - Settings**. Ma te same pola co
[kreator konfiguracji](/pl/erp/setup-wizard) i kilka dodatkowych.

**Cloud Connection**

* **API URL** i **API Key**. Zapisany klucz jest wyświetlany w postaci zamaskowanej jako `Current key: abcd...wxyz`.
  Aby go zmienić, wpisz nowy klucz i kliknij **Validate**.
* **ERP Connection**: połączenie, które obsługuje ten agent. Kliknij **Refresh**, aby ponownie pobrać listę
  z Omnilinkera.

**Database Connection**

* **Server / Host**, **Database Name**, **Username (leave empty for Windows Auth)** i **Password**. Jeśli hasło jest
  zapisane, zostaw pole **Password** puste, aby je zachować.
* **Company ID (optional, for multi-company databases)**: ogranicza śledzenie zmian do jednej firmy w ERP. Kliknij
  **Load**, aby wyświetlić listę firm w bazie danych, albo wpisz numeryczny identyfikator. W bazie z jedną firmą
  zostaw to pole puste.
* **Advanced Connection Options**: **Encrypt connection** i **Trust server certificate**.
* **Test Connection** sprawdza ustawienia bazy danych z poziomu usługi.

**ERP Change Tracking**

Włącza lub wyłącza śledzenie zmian WFM\_INT w ERP przyciskami **Enable Change Tracking**, **Disable Change
Tracking** i **Refresh Reference Data**. Aby je włączyć, musisz najpierw zaznaczyć pole zgody. Zanim to zmienisz,
przeczytaj stronę [Wapro](/pl/erp/providers/wapro).

Kliknij **Save**, aby zastosować zmiany. Przycisk **Save** jest dostępny, gdy klucz API został zweryfikowany lub jest
już zapisany i wybrane jest połączenie. Usługa przejmuje nowe ustawienia bez ponownego uruchamiania. **Cancel**
zamyka okno bez zapisywania.

## Okno Logs

Wybierz **View Logs**, aby otworzyć okno **Omnilinker ERP Sync - Logs**. Lista **Sync Logs** zawiera ostatnie 200
wpisów logu synchronizacji z usługi, a dla każdego z nich **Time**, **Date**, **Level**, **Category**, **Message**
i **Entity**. Zaznacz wpis, aby zobaczyć jego szczegóły.

* **Show:** filtruje listę: **All**, **Info+**, **Warning+** lub **Errors Only**.
* **Refresh** ponownie pobiera wpisy z usługi.
* **Clear Display** czyści listę. Nie usuwa żadnych logów.
* **Open Log Folder** otwiera w Eksploratorze plików folder logów usługi, `%ProgramData%\Omnilinker\ErpSync\logs`.
  Każdy zalogowany może czytać znajdujące się tam pliki. Zobacz
  [Pliki lokalne](/pl/erp/configuration-reference#pliki-lokalne).

Pomoc przy konkretnych błędach znajdziesz na stronie [Rozwiązywanie problemów](/pl/erp/troubleshooting).
