Sledování synchronizace
Tappeer zaznamenává každý běh synchronizace, každou změnu nastavení konektoru a každé připojení bridge. Tato stránka ukazuje, kde tyto záznamy najdete, jak je číst a co pravidelně kontrolovat.
Stav konektoru na přehledu
Na stránce Integrace má každý konektor štítek se stavem posledního běhu a s časem, kdy proběhl:
| Štítek | Význam |
|---|---|
| Zatím neběžel | Konektor ještě nikdy nesynchronizoval. |
| Probíhá | Běh právě probíhá. |
| Poslední běh uspěl | Poslední běh doběhl bez chyb. |
| Poslední běh měl problémy | Poslední běh doběhl, ale některé záznamy selhaly nebo některá pole nebyla zapsána. Vedle štítku je jejich počet. |
| Poslední běh selhal | Poslední běh jako celek selhal. |
Pozor na ztracený běh (stav Ztraceno, viz níže): štítek pak ukazuje text Poslední běh uspěl, ale v oranžové barvě. Oranžový štítek proto vždy prověřte na stránce Monitor.
Monitor
Stránka Monitor (v nabídce nastavení pod Integrace) ukazuje každý běh každého konektoru účtu, od nejnovějšího. Zúžit je můžete filtry Konektor, Výsledek a Entita.
Sloupce tabulky: Začátek, Konektor, Entita (entita, směr běhu a jeho druh, například „Jen změny“ nebo „Zpětné načtení“), Stav, Záznamy, Trvání. Kliknutím na řádek běh rozbalíte a uvidíte aktivitu, která v něm proběhla, selhané záznamy, nepřenesené přílohy a nezapsaná pole. Běh „Zpětné načtení“ jen znovu načte stav záznamů, které Tappeer odeslal do druhého systému (například stav zaúčtování faktury); nic jiného nevytváří ani nemění.
Stavy běhu
| Stav | Význam |
|---|---|
| Probíhá | Běh ještě neskončil. |
| Dokončeno | Běh doběhl. I dokončený běh může mít jednotlivé selhané záznamy nebo nezapsaná pole; podívejte se do sloupce Záznamy. |
| Selhalo | Běh skončil chybou a nedoběhl. Vedle stavu je krátký důvod, celé hlášení se zobrazí po najetí myší. Co s ním dělat, popisuje Řešení problémů. |
| Ztraceno | Běh zůstal ve stavu Probíhá, ačkoli jeho zpracování už skončilo, například když bylo zpracování přerušeno, než stihlo běh uzavřít. Tappeer takové běhy ověřuje nejdřív 30 minut po jejich začátku (v ojedinělých případech až po 24 hodinách) a uzavře je jako ztracené. Co se stihlo zapsat, zůstává; spusťte Synchronizovat. |
Počty ve sloupci Záznamy
Sloupec Záznamy shrnuje, co běh udělal, například „12 vytvořeno · 3 upraveno · 140 přeskočeno“. Podle situace přibudou další údaje:
| Údaj | Význam |
|---|---|
| vytvořeno | Záznamy nově založené na cílové straně. |
| upraveno | Záznamy, které se změnily a zapsaly. |
| přeskočeno | Záznamy, které se nezapsaly. Nejčastěji proto, že se od minula nezměnily; to je v pořádku. Ostatní důvody popisuje Řešení problémů. |
| selhalo | Záznamy, jejichž zápis selhal. Běh přesto doběhl. |
| zápis do duplicit | Změněné záznamy cílového systému, které jsou jen duplicitou už spárovaného řádku. Do Tappeeru se nikdy nezapisují (viz Párování záznamů a duplicity). |
| příloh nepřeneseno | Přílohy, které se v tomto běhu nepodařilo přenést. |
| polí nezapsáno | Pole, která se nezapsala: text byl příliš dlouhý, nebo kód z cílového systému neodpovídá mapování v nastavení konektoru nebo připojení. |
Nezapsaná pole
Pole se nezapíše a ponechá si dosavadní hodnotu, když pravidlo transformace narazí na text delší, než dokáže zpracovat, nebo když kód z cílového systému neodpovídá žádné hodnotě v nastavení konektoru nebo připojení, případně odpovídá více hodnotám (například členění DPH z Money S3). Zbytek záznamu se synchronizuje a běh zůstává Dokončeno. Ve sloupci Záznamy se objeví například „3 pole nezapsána“.
Po rozbalení běhu uvidíte tabulku se sloupci Business klíč, Pole a Důvod. Běh uchovává nejvýše 50 takových polí; je-li jich víc, tabulka ukazuje, kolik z celkového počtu zobrazuje. Hodnota pole se nikdy nezobrazuje. Sloupec Důvod říká, co dělat: dlouhý text zkraťte, nebo upravte pravidlo (viz Pole a transformace); u kódu bez mapování doplňte nebo opravte mapování kódů v nastavení konektoru nebo připojení.
Selhané záznamy
Když se záznam nepodaří zapsat, například protože by ho cílový systém odmítl, selže jen tento záznam; běh pokračuje s ostatními a ve sloupci Záznamy přibude například „2 selhalo“. Po rozbalení běhu uvidíte tabulku se sloupci Business klíč a Důvod. Běh uchovává nejvýše 50 selhaných záznamů; je-li jich víc, pod tabulkou je „Zobrazeno 50 z N“.
Častým důvodem je kód delší, než cílový systém dovoluje (Tappeer povoluje u kódu 50 znaků, ERP většinou méně). Sloupec Důvod pak řekne, ve kterém poli cílového systému kód je, kolik znaků cílový systém dovoluje a kolik jich kód má, například: Kód v poli „kodPartn“ má 25 znaků; cílový systém jich dovoluje nejvýš 20. Samotný kód se nikdy nezobrazuje. Zkraťte ho v Tappeeru, nebo upravte pravidlo transformace (viz Pole a transformace), a spusťte synchronizaci znovu. U starších běhů mohou pole a limit chybět; důvod pak jen řekne, že je kód příliš dlouhý. U jiných důvodů vidíte zprávu tak, jak ji konektor nahlásil.
Monitor konektoru
V detailu konektoru je monitor na počítači v pravém panelu nadepsaném Monitor; v užším okně (například 1280 px) je to záložka Monitor. Obsahuje:
- Hlášení o chybě posledního běhu. Pokud poslední běh selhal, zobrazí se nahoře červené hlášení s názvem chyby a doporučeným postupem. Podle chyby nabízí tlačítko Otevřít nastavení, které vás přenese přímo na nastavení, jež je třeba opravit, a u chyb výběru agendy Money S3 i nápovědu Jak Money S3 vybírá agendu. Může také uvést titulek okna, které běh zablokovalo (Blokující okno:), nebo že je cílový systém na počítači s bridgem spuštěný.
- Pozdržené dávky — zobrazí se, jen pokud Tappeer pozdržel chybějící záznamy (viz Chybějící záznamy).
- Duplicity v cílovém systému — zobrazí se, jen pokud je konektor má (viz Párování záznamů a duplicity).
- Přepínač čtyř pohledů: Průběhy synchronizace, Přílohy, Události konektoru a Chybí ve zdroji.
Kde je monitor záložkou Monitor (na mobilu a v užším okně), červené hlášení s postupem tam není; název chyby uvidíte jen u stavu běhu v pohledu Průběhy synchronizace. Doporučený postup najdete podle názvu chyby na stránce Řešení problémů.
Průběhy synchronizace
Stejná tabulka jako na stránce Monitor, jen pro tento konektor. Rozbalením běhu zobrazíte jeho selhané záznamy (viz Selhané záznamy) a aktivitu, například Synchronizace zahájena, Záznamy přeskočeny nebo Synchronizace dokončena. Podrobnosti každé položky otevřete přes Zobrazit detail.
Přílohy
Všechny přílohy, které konektor zařadil do fronty, přenesl nebo odmítl. Sloupce: Soubor, Směr, Stav, Velikost, Pokusů, Důvod, Akce.
| Stav | Význam |
|---|---|
| Ve frontě | Čeká na přenos. |
| Přenáší se | Právě se přenáší. |
| Přeneseno | Hotovo. |
| Selhalo | Přenos se nepodařil. Další běhy ho zkusí znovu. |
| Odmítnuto | Příloha nikdy nebyla způsobilá k přenosu (například Přesahuje povolenou velikost nebo Nepovolený typ souboru) a neopakuje se. |
Akce:
- Zkusit znovu — vrátí neúspěšnou přílohu do fronty.
- Odeslat záznam znovu — Tappeer zapomene, které přílohy daného záznamu už odeslal, a naplánuje je všechny znovu. Použijte, když druhý systém o soubor přišel; může do něj přijít i kopie souboru, který už má.
Události konektoru
Změny nastavení a další události konektoru, od nejnovější: vytvoření, úpravy, zapnutí a vypnutí konektoru a rozhodnutí o vazbách. Filtr Vše ukazuje všechno, Chyby a varování jen problémy. Každá položka má závažnost Informace, Varování nebo Chyba a podrobnosti otevřete přes Zobrazit detail.
Chybějící záznamy
Pohled Chybí ve zdroji vypisuje záznamy, které externí systém přestal posílat nebo nahlásil jako smazané, od nejnovějšího: Proč chybí, Co se stalo (podle režimu ze sekce Smazané záznamy, například Deaktivováno) a kdy to Tappeer zjistil.
Když najednou chybí víc záznamů než obvykle (za poslední den 50 a více, 10 % a více aktivních záznamů, velká část z malého počtu, nebo zdroj nevrátil nic), Tappeer je pozdrží a v monitoru se objeví karta v sekci Pozdržené dávky. Dokud o dávce nerozhodnete, nic se s jejími záznamy nestane; záznamy, které chybí později, se do ní přidají. Karta ukazuje důvod, počty a režim:
- Jsou-li záznamy ve zdroji opravdu smazané, dávku potvrďte. Použije se současné nastavení konektoru. Nedokončenou dávku dokončí tlačítko Dokončit.
- Chybí-li omylem, třeba po změně filtru, zvolte Zahodit dávku. Záznamy, které ve zdroji chybí i dál, posoudí příští synchronizace znovu.
Vypnutý konektor dávku nepotvrdí; zahodit ji můžete i tak.
Stav bridge
Stav bridge najdete v nabídce nastavení pod Integrace → Bridge → vybraný bridge. Štítek u názvu ukazuje Online, Offline, Čeká na spárování nebo Odvolán. Bridge se ozývá každých 15 sekund; když se 45 sekund neozve, Tappeer spojení ukončí. Jako Offline se bridge zobrazí, když se neozval déle než 90 sekund. Stránka má tři záložky:
- Přehled — Název počítače, Platforma, Verze agenta, Naposledy viděn, Registrován a Cílové systémy, které bridge hlásí.
- Historie připojení — jednotlivá spojení bridge s Tappeerem.
- Aktivita — události bridge.
Historie připojení
Sloupce: Připojeno, Odpojeno, Důvod, Brána. U spojení, které stále trvá, je místo času odpojení Stále připojeno. Sloupec Důvod ukazuje technický kód:
| Důvod | Co znamená | Co s tím |
|---|---|---|
heartbeat_timeout |
Od bridge nepřišla žádná zpráva v časovém limitu (45 sekund). | Jedno takové odpojení nevadí. Řada krátkých spojení končících tímto důvodem ukazuje na síť, viz Řešení problémů. |
stream_closed |
Bridge spojení zavřel, nebo spadlo síťové spojení. | Bridge se připojí znovu sám. Opakuje-li se to, zkontrolujte síť a službu na počítači. |
shutdown |
Spojení ukončila strana Tappeeru, typicky při nasazení nové verze. | Nic, bridge se připojí znovu sám. |
gateway_lost |
Server Tappeeru, ke kterému byl bridge připojený, skončil neočekávaně a spojení uzavřel až po svém restartu. | Nic, bridge se připojí znovu sám. |
replaced |
Tentýž bridge navázal nové spojení, které nahradilo staré. | Nic. Často jde o rychlé znovupřipojení. |
revoked |
Bridge byl odvolán. | Bridge už se nepřipojí. Pro nové spárování počítače zaregistrujte nový bridge. |
Opakovaná krátká spojení končící vypršením limitu ukazují na síť; jedno dlouhé spojení ukončené důvodem shutdown je nasazení.
Aktivita
Události bridge, se stejným filtrem Vše / Chyby a varování. Hlavní skupiny událostí:
| Skupina | Události |
|---|---|
| Registrace a přístup | Bridge zaregistrován, Vydán nový registrační kód, Bridge připojen k účtu, Registrace odmítnuta, Připojení odmítnuto, Bridge zneplatněn, Bridge smazán |
| Spojení | Bridge se připojil, Bridge se odpojil, Bridge je nedostupný, Bridge je opět dostupný |
| Stav počítače | Nesprávný čas počítače (hodiny počítače se liší o více než 60 sekund), Chyba agenta (chyba nebo varování, které agent hlásí ze svého logu) |
| Cílové systémy | Přidán cílový systém, Odebrán cílový systém, Cílový systém aktualizován |
Na jiných místech se zobrazují události konektorů (Integrace vytvořena, Integrace upravena, Integrace zapnuta, Integrace vypnuta…), rozhodnutí o vazbách (Shoda potvrzena, Vazba zrušena, Vazba převedena na jiný řádek, Duplicitní záznam firmy nastaven jako primární…) a události synchronizace (Synchronizace zahájena, Synchronizace dokončena, Synchronizace selhala, Záznamy přeskočeny a události příloh).
Kontrolní seznam
Denně (stačí pár minut):
- Na stránce Integrace nemá žádný konektor štítek Poslední běh selhal, Poslední běh měl problémy ani jiný oranžový štítek.
- U záložky Vazby konektorů nesvítí číslo čekajících shod; pokud ano, rozhodněte je.
- Všechny bridge jsou Online.
Týdně:
- Na stránce Monitor vyberte Výsledek „Selhalo“ a projděte selhané běhy za poslední týden.
- Projděte běhy s počtem „selhalo“, „příloh nepřeneseno“ nebo „polí nezapsáno“.
- Na záložce Aktivita každého bridge zapněte Chyby a varování a hledejte Nesprávný čas počítače, Chyba agenta a časté Bridge je nedostupný.
- V monitoru konektorů firem zkontrolujte sekci Duplicity v cílovém systému a předejte duplicity k úklidu v cílovém systému.