> ## 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. # Konfiguracja agenta w kreatorze konfiguracji > Połącz agenta ERP Sync z połączeniem w Omnilinkerze i z bazą danych ERP za pomocą kreatora konfiguracji w aplikacji w zasobniku. Kreator konfiguracji jest częścią aplikacji w zasobniku systemowym. Pyta kolejno o cztery rzeczy: klucz API, połączenie, bazę danych ERP i końcowe sprawdzenie. Wskaźnik kroków u góry okna pokazuje **API Key**, **Connection**, **Database** i **Done**. ## Zanim zaczniesz * Usługa Windows musi być zainstalowana i uruchomiona. Kreator przekazuje wszystko do usługi, więc bez niej nie zadziała. Zobacz [Instalacja agenta](/pl/erp/install-agent). * Musisz mieć prawo zmieniać agenta: być członkiem lokalnej grupy **Omnilinker ERP Sync Operators** albo administratorem, który uruchomił aplikację w zasobniku z podwyższonymi uprawnieniami. Instalator dodaje do grupy osobę, która zainstalowała agenta. Zobacz [Kto może zmieniać agenta](/pl/erp/install-agent#kto-może-zmieniać-agenta). * Przygotuj klucz API agenta dla połączenia. Zobacz [Tworzenie połączenia](/pl/erp/create-connection). * Przygotuj nazwę serwera bazy danych ERP, nazwę bazy danych oraz, przy uwierzytelnianiu SQL Server, nazwę użytkownika i hasło. ## Otwórz kreator Kreator otwiera się sam, gdy aplikacja w zasobniku startuje, a agent nie ma jeszcze zapisanej konfiguracji. Po instalacji usługa sama uruchamia aplikację w zasobniku, więc kreator pojawia się od razu. Okno ma tytuł **Omnilinker ERP Sync - Setup** i zaczyna się od ekranu **Welcome to Omnilinker ERP Sync**. Jeśli aplikacja w zasobniku nie działa, uruchom `Omnilinker.ErpSync.Tray.exe` z podfolderu `tray` folderu instalacyjnego, domyślnie `C:\Program Files\Omnilinker\ErpSync\current\tray`. ## Przejdź przez kreator Na ekranie **Enter Your API Key**: * **API URL** jest wypełnione adresem `https://omnilinker.pl`. Nie zmieniaj go. * **API Key**: wklej klucz API agenta. Kliknij **Validate & Continue**. Przycisk jest dostępny, gdy oba pola mają wartość. Agent sprawdza klucz w Omnilinkerze. Jeśli klucz jest prawidłowy, adres API i klucz są **od razu zapisywane**, a kreator przechodzi dalej. Jeśli nie, kreator wyświetla jeden z tych komunikatów: | Komunikat | Co zrobić | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Invalid API key. Please check and try again. | Skopiuj klucz jeszcze raz, bez spacji i znaków końca wiersza. Jeśli klucz przepadł, wygeneruj nowy w połączeniu. | | API key doesn't have required permissions. Grant ERP Integration permissions to this API key. | Użyj klucza utworzonego przyciskiem **Wygeneruj klucz agenta** w połączeniu, a nie innego klucza API. | | No ERP connections found. Create one in Omnilinker first. | Najpierw [utwórz połączenie](/pl/erp/create-connection). | | Connection timed out. Check your internet connection. | Sprawdź, czy komputer ma dostęp do `https://omnilinker.pl`. | | Only an administrator of this PC can do that. | Twoje konto Windows nie może zmieniać agenta. Poproś administratora, żeby dodał Cię do grupy **Omnilinker ERP Sync Operators**, a potem kliknij przycisk jeszcze raz. Nie musisz się wylogowywać. Zobacz [Kto może zmieniać agenta](/pl/erp/install-agent#kto-może-zmieniać-agenta). | | Failed to connect to service | Aplikacja w zasobniku nie może połączyć się z usługą Windows. Sprawdź, czy usługa działa: `Get-Service OmnilinkerErpSyncService`. Zobacz [Rozwiązywanie problemów](/pl/erp/troubleshooting). | Kreator podaje, że klucz znajdziesz „under Settings > API Keys”. W rzeczywistości klucz agenta pochodzi z połączenia: otwórz **Integracja ERP** > **Połączenia** i w akcjach połączenia wybierz **Wygeneruj klucz agenta**. Zobacz [Tworzenie połączenia](/pl/erp/create-connection). Na ekranie **Select ERP Connection** kreator pokazuje **API Key Verified** i nazwę Twojej organizacji po `Tenant:`. W polu **ERP Connection** wybierz połączenie, które obsługuje ten agent. Pierwsze połączenie na liście jest wybrane domyślnie. Wiersz pod polem pokazuje dostawcę połączenia, na przykład `Provider: Wapro`. Kliknij **Continue**. Na ekranie **ERP Database Connection** podaj, jak agent ma się łączyć z bazą danych ERP: | Pole | Co wpisać | | ------------------------------------------- | ----------------------------------------------------------------------------------------- | | **Server / Host** | Nazwa lub adres serwera SQL Server, razem z nazwą instancji, jeśli jej używasz. Wymagane. | | **Database Name** | Baza danych ERP. Wymagane. | | **Username (leave empty for Windows Auth)** | Login SQL Server. Zostaw puste, aby użyć uwierzytelniania Windows. | | **Password** | Hasło do tego loginu. Przy uwierzytelnianiu Windows zostaw puste. | W sekcji **Advanced Connection Options**: | Opcja | Znaczenie | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Encrypt connection** | Szyfruje przesyłane dane za pomocą TLS/SSL. | | **Trust server certificate** | Pomija weryfikację certyfikatu, dla certyfikatów z podpisem własnym. Włącz tę opcję tylko wtedy, gdy ufasz serwerowi i jego certyfikatowi. | Kliknij **Test Connection**, aby sprawdzić ustawienia przed zapisaniem. Wynik pojawi się pod przyciskiem. Test jest opcjonalny. Kliknij **Save Configuration**. Przycisk jest dostępny, gdy pola **Server / Host** i **Database Name** mają wartość. Przy uwierzytelnianiu Windows agent łączy się z bazą danych jako konto usługi, Lokalny system, a nie jako Ty. Przy SQL Server na innym komputerze jest to konto komputera agenta (`\$`). Test także jest wykonywany w usłudze, więc sprawdza to samo konto. Zobacz [Wymagania](/pl/erp/requirements#login-sql-server). Jeśli baza danych ERP zawiera więcej niż jedną firmę, ustaw **Company ID** po zakończeniu kreatora, w [oknie Settings](/pl/erp/tray-app#okno-settings) aplikacji w zasobniku. Kreator o to nie pyta. Ekran **Setup Complete!** pokazuje **Configuration Summary** z adresem API, organizacją (tenant), połączeniem, serwerem ERP i bazą danych ERP. Kliknij **Finish**. Ikona agenta pojawi się w obszarze powiadomień. Co pokazuje, opisuje strona [Aplikacja w zasobniku](/pl/erp/tray-app), a jak sprawdzić, czy dane docierają do Omnilinkera, opisuje strona [Monitorowanie](/pl/erp/monitoring). Na krokach połączenia i bazy danych możesz wrócić o jeden krok przyciskiem **Back**. ## Pomiń kreator Na pierwszym kroku możesz kliknąć **Skip for Now**. Kreator poprosi o potwierdzenie (**Skip Setup?**). Agent pozostaje wtedy nieskonfigurowany i nie synchronizuje danych, dopóki nie wpiszesz tych samych danych w oknie **Settings...** z menu w zasobniku. ## Co kreator zapisuje i gdzie Usługa Windows zapisuje konfigurację w jednym pliku, wspólnym dla całego komputera: ```text theme={null} %ProgramData%\Omnilinker\ErpSync\credentials.dat ``` Zwykle jest to `C:\ProgramData\Omnilinker\ErpSync\credentials.dat`. Otworzyć go mogą tylko SYSTEM i administratorzy. Aplikacja w zasobniku nigdy go nie czyta: pyta o dane usługę. Plik zawiera: * klucz API i adres API, * wybrane połączenie i jego nazwę oraz identyfikator Twojej organizacji, * ustawienia bazy danych ERP, łącznie z hasłem, jeśli je podałeś, * identyfikator firmy (Company ID), jeśli ustawiłeś go w oknie **Settings...**. Plik jest zaszyfrowany za pomocą Windows DPAPI w zakresie komputera (machine scope). Można go odszyfrować tylko na tym komputerze, więc nie da się go skopiować na inną maszynę. Ustawienia bazy danych ERP zostają na tym komputerze i nigdy nie są wysyłane do Omnilinkera. Klucz API i adres są zapisywane zaraz po pomyślnym kroku 1, więc plik istnieje nawet wtedy, gdy zamkniesz kreator przed końcem. Przy następnym uruchomieniu kreator już się nie otworzy. Dokończ wtedy konfigurację w oknie **Settings...**. ## Zmień ustawienia później Aby zmienić klucz API, połączenie lub ustawienia bazy danych, użyj pozycji **Settings...** w menu w zasobniku. Zmiany zapisane w tym oknie działają bez ponownego uruchamiania usługi. Zobacz [Okno Settings](/pl/erp/tray-app#okno-settings). Aby przejść przez kreator od początku, zamknij aplikację w zasobniku, jako administrator usuń plik `credentials.dat` i ponownie uruchom aplikację. Agent przestaje synchronizować dane, dopóki nie przejdziesz przez kreator.