Skip to main content

Nastavení synchronizace - IS Pohoda

Obsah

  1. Účel ERP Bridge Proxy

  2. Systémové požadavky a předpoklady

  3. Stažení a instalace Proxy

  4. Konfigurace Proxy
  5. Spuštění / restart Proxy

  6. Registrace instance ERP ve webovém uživatelském rozhraní

  7. Spuštění první synchronizace

  8. Údržba a aktualizace

  9. Řešení problémů

  10. Příloha A - Výchozí umístění souborů.

// Pozn.: dočasné řešení pro připojení k ERP Bridge serveru na microservices vyžaduje zavedení záznamu do c:\Windows\System32\drivers\etc\hosts

89.187.158.194 $INSTANCE.atollon.com

kde $INSTANCE je název instance Atollonu, např. firma.atollon.com

Účel ERP Bridge Proxy

Atollon ERP Bridge Proxy je lehká aplikace pro Windows, která zajišťuje bezpečnou obousměrnou komunikaci mezi synchronizačním serverem Atollon ERP Bridge systému Atollon a lokálním on‑premise ERP systémem (např. Pohoda, Pohoda E1, Helios Inuvio, Byznys CG, Money S3 aj.).
Komunikace probíhá přes protokol WebSocket/HTTPS na portu 443, takže není nutné otvírat příchozí pravidla firewallu – postačí pouze odchozí provoz HTTPS.

Běžící aplikaci Atollon ERP Bridge Proxy najdete v systémové tray ikonce MS Windows:

erpbridge-proxy.png

Systémové požadavky a předpoklady

Komponenta Požadavek
Operační systém Windows 10 (64‑bit) nebo novější / Windows Server 2016 nebo novější
Oprávnění Lokální administrátor pro instalaci a počáteční konfiguraci
Síť Odchozí přístup na *.atollon.com přes TCP 443
ERP klient Již nainstalovaná podporovaná ERP aplikace (Pohoda, Helios Inuvio, …)
Přístupové údaje Přihlášení do webové správy ERP Bridge (obvykle admin nebo root)

Tip pro pilotní testování
Pokud chcete ověřit chod řešení v izolovaném testovacím prostředí, nejprve nainstalujte pracovní stanici s přístupem uživatele do systému pouze na testovací databázi. Ze zkušeností je tento přístup více než opatrný. V prvním kole synchronizace "full sync" (Restart) se přenáší data zejména z IS Pohoda do Atollonu:

  1. Účtová osnova
  2. Číselné řady
  3. Střediska, Činnosti, Zakázky
  4. Kontakty (podle příznaku v IS Pohoda potom vytváří v Atollonu složku Zákazníci nebo Dodavatelé
  5. Produkty
  6. Pokud je to konfigurované, přenáší se do Atollonu i historické objednávky a faktury

Při běžné synchronizaci se přenáší schválené doklady - objednávky, faktury (přijaté i vydané).

Stažení a instalace Proxy

  1. Otevřete prohlížeč a přejděte na: https://vaseinstance.atollon.com/ui/erpbridge/ (kde místo "vaseinstance" zadejte název instance vaší firmy).
    Přihlaste se údaji poskytnutými konzultantem Atollonu.

  2. V levém panelu zvolte ERP Bridge Proxy Download.
    Stáhne se instalační soubor (EXE/MSI, ≈ 40 MB).

  3. Spusťte instalátor jako správce a dokončete průvodce.
    Restart Windows obvykle není nutný, ale proved’te jej, pokud k němu instalátor vyzve. Je vhodné ověřit, že po restartu OS se ERP Bridge Proxy automaticky nastartuje.

erpbridge-proxy-download.png

Výsledek: Tři odkazy na aplikace jsou vytvořené ve Start Menu  › Programy › Atollon ERP Bridge Proxy:
• ERPBridge – nastartuje synchronizační službu
• Configuration – otevře Proxy editor konfigurace
• Uninstall Atollon ERP Bridge Proxy - odinstaluje synchronizátor

Konfigurace Proxy

  1. Otevřete zástupce Configuration. Zobrazí se dialog Instance Configuration (viz Obrázek 1).

    1. Figure 1 – Configuration app shortcut

      image.png

  2. Vyplňte následující pole:

    Pole Hodnota
    Instance wss://<název-instance>.atollon.com (např. wss://chytrafirma.atollon.com)

  3. V poli Key se objeví vygenerovaný GUID.


    Okno Instance Configuration

     

    erpbridge-confg.png

     

  4. Stiskněte Save – tento krok nevynechávejte!

    Nastavení se uloží do C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\application.yml.

Spuštění služby Proxy

  1. Spusťte ERPBridge ze Start menu (nebo jej později zaregistrujte jako službu – viz kapitola Údržba).

  2. Ve Správci úloh › Procesy na pozadí ověřte, že běží ERPBridge a že se neobjevila výstraha firewallu.

image.png

Registrace ERP Bridge instance ve webovém rozhraní

  1. Ve Web UI http://<vaseinstance>.atollon.com/ui/erpbridge klikněte na Add New. Zobrazí se formulář Add New Instance.

  2. V poli Instance Type zvolte svůj ERP (např. Pohoda).

  3. Nastavte Frequency – pro testování doporučujeme každých 5 minut (lze změnit později).

  4. Vyberte Atollon Instance (tenant) ze seznamu.

  5. Zadejte Instance Name (např. Pohoda‑Office).

  6. Vložte Client Key vygenerovaný v ERP Bridge Proxy výše.

  7. Doplňte ERP‑specifické cesty a přístupové údaje:

    • Cesta k Pohoda.exe – např. C:\Program Files (x86)\STORMWARE\POHODA\Pohoda.exe

    • XML folder – např. C:\ProgramData\STORMWARE\POHODA01\Data\ (ponechte zpětné lomítko na konci cesty)

    • Database files folder – stejné nebo vlastní umístění dat

    • Uživatelské jméno/heslo Pohoda – účet s právy XML Import

    • ICO – IČO společnosti (jen pro Pohodu)

    • V případě varianty Pohoda E1 - cesta k MS SQL pro případ, že je MS SQL na stejném stroji nebo ve vnitřní síti: SERVER-POHODA-N\POHODA;trustServerCertificate=true

  8. Zkontrolujte zaškrtávací pole (Product sync, Contact sync, Import invoices, …) a aktivujte požadované funkce.

  9. Klikněte na Confirm.

Příklad nastavení IS Pohoda (lokální databáze)

pohoda-local-setup-1.pngpohoda-local-setup-2.png


Příklad nastavení IS Pohoda E1 (MS SQL)

pohoda-e1-setup-1.pngpohoda-e1-setup-2.png

První spuštění synchronizace

  1. Označte řádek instance a zvolte ⋯ Action › Restart

  2. Sledujte ukazatele Last Synchronisation a Failed instances.
    • Zelená = úspěch, • Červená = chyba (viz Odstraňování problémů).

  3. Ověřte, že se data (např. kontakty, produkty) zobrazila ve vašem ERP. První synchronizace tisíců záznamů může trvat půl hodiny, první nicméně uvidíte přírůstky v kontaktech.

Konfigurace v Atollonu po první synchronizaci

  1. Při první synchronizaci se z IS Pohoda natáhne účtová osnova a číselné řady. V případě číselných řad (Faktury vydané, Faktury přijaté, Objednávky, apod.) je nutné před jejich použitím v Atollonu nastavit výchozí finanční účty. Tyto slouží k přednastavení zaúčtování přenášených transakcí. Cílem je nastavit systém tak, aby se přenášené doklady již nemusely v IS Pohoda upravovat ručně.
    1. Nastavení výchozích účtů pro číselné řady / deníky najdete v návodu na nastavení deníků.
    2. Nastavení výchozích účtů pro produkty (služby) najdete v návodu na vytvoření nových produktů.

Pravidelná synchronizace

ERP Bridge instance umožňuje nastavit frekvenci synchronizace (počet minut). Doporučujeme nastavit 5 - 15 minut. V průběhu pravidelné synchronizace se přenáší pouze parciální změny - kontrolují se zejména schválené doklady - objednávky a faktury přijaté nebo vydané, které se přenesou z Atollonu do Pohody, případně pokud je to nastaveno se přenesou objednávky a faktury z Pohody do Atollonu.

Údržba a aktualizace

Úkon Doporučení
Vždy přihlášený uživatel Na PC / serveru, kde běží Atollon ERP Bridge Proxy je potřeba, aby byl trvale přihlášen uživatel, pod kterým byla služba instalována. IS Pohoda neumožňuje headless provoz.
Aktualizace Proxy Stáhněte novou verzi instalátoru a spusťte ji; soubor application.yml zůstane zachován.
Log soubory %PROGRAMDATA%\Atollon\ERPBridge\logs\*.log – rotujte měsíčně.
Zálohy databáze Použijte nativní postup vašeho ERP (Pohoda, Helios, …). Bridge sám o sobě data neukládá.

Odstraňování problémů

Projev Možná příčina Řešení
„Instance unreachable“ Proxy neběží Restartujte službu Atollon ERP Bridge Proxy.
Synchronizace končí HTTP 403 Neplatný client key Vygenerujte nový key v Configuration, zadejte jej do Web UI a uložte.
Data se neimportují Chybná cesta XML/dat Zkontrolujte cesty ve formuláři Add New Instance.

Výchozí umístění souborů

Soubor / Složka Výchozí cesta
Spustitelné soubory C:\Program Files (x86)\Atollon ERP Bridge Proxy\program\
Konfigurační soubor application.yml (stejná složka jako výše)
Logy %PROGRAMDATA%\Atollon\ERPBridge\logs\
Zástupci Start menu %PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\Atollon ERP Bridge Proxy\

No Comments
Back to top