Řešení problémů
Když synchronizace selže, bridge je offline nebo se některý záznam nepřenesl, najdete zde postup, jak zjistit příčinu, a vysvětlení všech chybových kódů, které Tappeer hlásí. U každé chyby je popsáno, co ji způsobuje, jak ji opravit a zda Tappeer zkusí krok znovu sám.
Jak postupovat
Začněte ve webové aplikaci a na počítač s bridgem jděte, až když to nestačí. Každý krok vyloučí část příčin, než přejdete k dalšímu.
- Monitor konektoru. V detailu konektoru se na počítači po selhaném běhu zobrazí v pravém panelu Monitor červené hlášení s názvem chyby a doporučeným postupem. Kde je monitor záložkou (na mobilu a v užším okně), hlášení není; název chyby uvidíte jen u stavu běhu v pohledu Průběhy synchronizace na záložce Monitor. Tlačítko Otevřít nastavení vás přenese přímo na nastavení, které je třeba opravit. Název chyby najdete níže v části Chyby synchronizace podle kódu.
- Připravenost k synchronizaci — tlačítkem Ověřit připravenost v detailu konektoru nebo instalace ověříte, zda může synchronizace proběhnout. Kontroly Připojení bridge, Verze pluginu na bridgi, Nastavení, Spuštění cílového systému, Přihlášení, Agenda, Definice exportu a importu a Zkušební export ukážou, kde je problém; u Money S3 s konektorem, který do Money zapisuje produkty, přibude kontrola Klíč importu kmenových karet. Nic se přitom nesynchronizuje.
- Stav bridge. V nabídce nastavení pod Integrace → Bridge → vybraný bridge zkontrolujte stav, Historie připojení a Aktivita (viz Sledování synchronizace).
- Na počítači s bridgem (v příkazovém řádku nebo PowerShellu, jako správce):
bridgectl status— je bridge spárovaný, v jaké fázi je agent a jaká byla poslední chyba?bridgectl doctor— zapisovatelné složky, uložený přihlašovací údaj, dostupnost Tappeeru přes TCP i TLS, důvěryhodné podpisové klíče a čerstvé hlášení agenta.sc query TappeerBridge— běží služba?- Logy v
%ProgramData%\Tappeer\Bridge\logs:launcher.log(spouštěč služby) aagent.log(agent). - Protokol událostí Windows, protokol Aplikace, zdroj
TappeerBridge— start, zastavení, návrat k předchozí verzi, neúspěšné spárování nebo odmítnutá verze pluginu, i když jste soubory logů ještě nečetli.
Podrobný popis příkazů a umístění souborů je na stránce Provoz bridge.
Většina chyb Money S3 se dá opravit v nastavení instalace (na stránce Instalace nebo na stránce bridge, viz Cílové systémy a instalace). Po opravě spusťte v konektoru Synchronizovat, nemusíte čekat na plánovaný běh.
Chyby synchronizace podle kódu
Selhaný běh systému připojeného přes bridge nese kód chyby. Ve webové aplikaci vidíte jeho český název a doporučený postup, kód sám je uvedený u každé chyby níže, abyste ho mohli vyhledat.
„Opakuje se automaticky“ znamená, že Tappeer krok zkusí znovu sám (celkem až třikrát); běh skončí jako Selhalo, až když neuspěje žádný pokus. Chyba, která se automaticky neopakuje, ukončí běh hned, protože bez vašeho zásahu by další pokus dopadl stejně. Plánované běhy se samozřejmě spouštějí dál.
Některé nastavení konektoru není platné
Kód: CONFIG_INVALID · opakuje se automaticky: ne
- Co uvidíte: hlášení „Opravte nastavení.“ a obvykle tlačítko Otevřít nastavení.
- Příčina: některá hodnota v nastavení konektoru nebo instalace neprošla kontrolou pluginu, například chybí povinná hodnota nebo má špatný formát.
- Řešení:
- Klikněte na Otevřít nastavení; otevře se přímo pole, které plugin označil.
- Hodnotu opravte a uložte.
- Spusťte Synchronizovat.
- Selže-li kontrola Klíč importu kmenových karet (Money S3, konektor zapisuje produkty): import kmenových karet v Money S3 nepáruje karty podle Zkratky, takže by Tappeer odmítl zapsat každý produkt. Otevřít nastavení otevře volbu „Spravovat klíč importu kmenových karet“, a dokud je vypnutá volba „Spravovat konfiguraci XML přenosů“, otevře tu. Zapněte obě (skupina Rozšířené), nebo klíč importu kmenových karet nastavte na Zkratku v Money S3 sami. Klíč platí pro celou instalaci Money S3, tedy pro všechny její agendy. Pak klikněte znovu na Ověřit připravenost.
Money S3 nemá agendu s nastaveným IČO
Kód: MONEYS3_AGENDA_NOT_FOUND · opakuje se automaticky: ne
- Co uvidíte: hlášení „Zkontrolujte IČO v nastavení.“, tlačítko Otevřít nastavení a nápověda Jak Money S3 vybírá agendu.
- Příčina: Money S3 na počítači s bridgem nemá žádnou agendu s IČO, které je v instalaci nastavené. Typicky překlep v IČO, nebo agenda leží na jiném počítači či v jiné databázi.
- Řešení:
- V nastavení instalace (skupina Účetní jednotka) zkontrolujte pole „IČO agendy“.
- Ověřte v Money S3 na počítači s bridgem, že agenda s tímto IČO existuje.
- Spusťte Synchronizovat.
Money S3 našlo více odpovídajících agend
Kód: MONEYS3_AGENDA_AMBIGUOUS · opakuje se automaticky: ne
- Co uvidíte: hlášení, že je potřeba zkontrolovat složku agendy, a nápověda Jak Money S3 vybírá agendu.
- Příčina: na počítači je více agend se stejným IČO (například dvě agendy jedné firmy) a nastavení neurčuje, kterou použít.
- Řešení:
- V nastavení instalace vyplňte pole „Přípona složky agendy“ tak, aby odpovídala právě jedna agenda.
- Spusťte Synchronizovat.
Agenda v Money S3 má jiné IČO, než je nastaveno
Kód: MONEYS3_WRONG_AGENDA · opakuje se automaticky: ne
- Co uvidíte: hlášení „Zkontrolujte IČO a agendu v nastavení.“ a nápověda Jak Money S3 vybírá agendu.
- Příčina: Money S3 vrátilo data z agendy, jejíž IČO neodpovídá nastavenému. Jde o pojistku, která brání zápisu do cizí firmy.
- Řešení:
- Zkontrolujte v nastavení instalace pole „IČO agendy“ a „Přípona složky agendy“.
- Ověřte, že v Money S3 nedošlo k přejmenování nebo přesunu agend.
- Spusťte Synchronizovat.
Konfiguraci XML přenosů Money S3 se nepodařilo upravit
Kód: MONEYS3_TRANSFER_CONFIG_UNWRITABLE · opakuje se automaticky: ne
- Co uvidíte: při ověření připravenosti (Ověřit připravenost) selže kontrola Definice exportu a importu s tímto názvem a doporučením zkontrolovat soubory ve složce
XMLDE\Config\Command. Synchronizace kvůli tomu neselže, běží dál se soubory tak, jak jsou. - Příčina: při zapnuté volbě „Spravovat konfiguraci XML přenosů“ (v nastavení instalace, skupina Rozšířené) plugin před každým během upravuje standardní konfiguraci XML přenosů Money S3 tak, aby se firmy importovaly podle kódu partnera; původní soubory si jednou zálohuje. Soubory ve složce
XMLDE\Config\Commandv datech Money S3 ale nešlo přečíst nebo zapsat (jsou jen pro čtení, bridge do nich nesmí zapisovat, nebo mají vlastní, nezděděná oprávnění). - Řešení:
- Na počítači s bridgem ověřte, že soubory ve složce
XMLDE\Config\Commandv datech Money S3 nejsou jen pro čtení a že do nich účet, pod kterým běží služba bridge, smí zapisovat. - Nechcete-li, aby plugin konfiguraci spravoval, vypněte v nastavení instalace volbu „Spravovat konfiguraci XML přenosů“.
- Klikněte znovu na Ověřit připravenost.
- Na počítači s bridgem ověřte, že soubory ve složce
Složku s daty Money S3 se nepodařilo ověřit
Kód: MONEYS3_DATA_FOLDER_UNCONFIRMED · opakuje se automaticky: ne
- Co uvidíte: při ověření připravenosti (Ověřit připravenost) selže kontrola Definice exportu a importu s tímto názvem. Synchronizace kvůli tomu neselže, běží dál se soubory tak, jak jsou. Vede-li ke složce s daty spojení adresářů nebo symbolický odkaz, žádná firma se ale nezapíše (ani firma uvedená na faktuře).
- Příčina: konfiguraci XML přenosů plugin zapisuje jen do složky s daty, kterou určilo samo Money S3: tu, kterou uvádí soubor
MonS3.inivedleMonS3.exe(položkaDATAROOT). SouborMonS3.initam ale není, nemohou ho měnit jen správci, nebo vede ke složce s daty spojení adresářů (junction) či symbolický odkaz. Do složky, kterou bridge jen odhadl nebo ke které vede spojení adresářů či symbolický odkaz, plugin nikdy nezapisuje — někdo jiný ji mohl podstrčit. - Řešení:
- Na počítači s bridgem ověřte, že ve složce s
MonS3.exeje souborMonS3.inis položkouDATAROOT, která uvádí složku s daty, a že ho mohou měnit jen správci. - Ověřte, že složka s daty ani žádná složka nad ní není spojení adresářů (junction) ani symbolický odkaz. Pokud je, nahraďte ji skutečnou složkou a v
MonS3.iniuveďte cestu k ní; vypnutí správy konfigurace tu nepomůže. - Nemůže-li
MonS3.inisložku s daty uvést a nechcete-li, aby plugin konfiguraci spravoval, vypněte v nastavení instalace volbu „Spravovat konfiguraci XML přenosů“. - Klikněte znovu na Ověřit připravenost.
- Na počítači s bridgem ověřte, že ve složce s
Konfigurace XML přenosů Money S3 nebyla nalezena
Kód: MONEYS3_TRANSFER_CONFIG_MISSING · opakuje se automaticky: ne
Tento kód je v katalogu chyb, ale v současné verzi se nehlásí: chybějící konfigurace XML přenosů žádnou kontrolu neshodí. Pokud se přesto objeví, ověřte na počítači s bridgem, že složka s daty Money S3 obsahuje složku XMLDE se standardní konfigurací, nebo v nastavení instalace vypněte volbu „Spravovat konfiguraci XML přenosů“. Pak spusťte Synchronizovat.
Money S3 skončilo, aniž vrátilo data
Kód: MONEYS3_NO_OUTPUT · opakuje se automaticky: ne
- Co uvidíte: hlášení „Zkontrolujte nastavení připojení k Money S3.“, případně poznámku, že cílový systém běží i v jiné relaci. Jde o nastavení instalace Money S3.
- Příčina: Money S3 skončilo bez chyby, ale nic nevytvořilo a neuvedlo žádný známý důvod (odmítnuté heslo nebo agenda mají vlastní kódy).
- Řešení:
- Zkontrolujte nastavení instalace, hlavně „Cesta k MonS3.exe“, edici Money S3 a údaje agendy.
- Pokud hlášení uvádí, že Money S3 běží na počítači s bridgem, zkuste ho zavřít.
- Spusťte Synchronizovat. Pokud chyba trvá, kontaktujte podporu a přiložte log Money S3
RunLogs.txtz doby běhu. Najdete ho v%ProgramData%\<výrobce>\Money S3\Logs\, kde složka výrobce je podle verze Money S3Seyfor,SoliteaneboCÍGLER SOFTWARE.
Money S3 skončilo s chybou
Kód: MONEYS3_EXIT_NONZERO · opakuje se automaticky: ano
- Co uvidíte: hlášení „Chvíli počkejte.“
- Příčina: program Money S3 skončil chybou a nic nezapsal. Bývá to dočasné.
- Řešení: chvíli počkejte a spusťte Synchronizovat. Pokud se chyba opakuje, kontaktujte podporu.
Money S3 nedoběhlo v časovém limitu
Kód: MONEYS3_PROCESS_TIMEOUT · opakuje se automaticky: ano
- Co uvidíte: hlášení s doporučením zvýšit časový limit. Aplikace v textu uvádí pole „Timeout (ms)“; v nastavení instalace se pole jmenuje „Časový limit běhu Money S3 (ms)“ (skupina Rozšířené).
- Příčina: Money S3 běželo déle, než povoluje limit, a bridge ho ukončil. Příčinu se nepodařilo zjistit.
- Řešení:
- Pokud se to stalo jednou, nic nedělejte; Tappeer krok zopakuje.
- Pokud se to opakuje, zvyšte pole „Časový limit běhu Money S3 (ms)“. Výchozí hodnota je 90 000 ms a zvýšit ji lze nejvýše asi o 15 sekund.
- Ověřte, že se Money S3 na počítači s bridgem spustí a nečeká na žádné okno.
Money S3 je otevřené na počítači s bridgem
Kód: MONEYS3_ALREADY_RUNNING · opakuje se automaticky: ne
Tento kód je v katalogu chyb, ale v praxi se nehlásí: synchronizace funguje i vedle otevřeného Money S3. Pokud Money S3 na počítači běží, uvidíte to jako poznámku u jiné chyby („Cílový systém běží i ve stejné uživatelské relaci jako bridge.“ nebo „… i v relaci jiného uživatele.“). V takovém případě zkuste Money S3 na počítači s bridgem zavřít a spusťte Synchronizovat.
Přihlášení do Money S3 se nezdařilo
Kód: MONEYS3_LOGIN_REQUIRED · opakuje se automaticky: ne
- Co uvidíte: hlášení „Heslo do Money S3 chybí nebo není správné.“
- Příčina: Money S3 má zapnutá přístupová práva a v nastavení instalace chybí heslo, nebo ho Money S3 odmítlo.
- Řešení:
- V nastavení instalace (skupina Přihlášení) vyplňte pole „Heslo“, případně „Uživatelské jméno“.
- Uložte a spusťte Synchronizovat.
Okno Money S3 čeká na odpověď
Kód: MONEYS3_DIALOG_BLOCKED · opakuje se automaticky: ne
- Co uvidíte: hlášení s doporučeným postupem a často titulek okna (Blokující okno:), který bývá jen „Money S3“.
- Příčina: Money S3 otevřelo dialog (například hlášení nebo dotaz) a čeká, až ho někdo potvrdí. Bez obsluhy by čekalo donekonečna.
- Řešení:
- Na počítači s bridgem otevřete Money S3, okno vyřiďte a Money S3 zavřete.
- Spusťte Synchronizovat.
Money S3 přestalo reagovat
Kód: MONEYS3_PROCESS_HUNG · opakuje se automaticky: ano
- Co uvidíte: hlášení s doporučením ověřit, že se Money S3 spustí a na nic nečeká.
- Příčina: Money S3 do konce časového limitu nic nedělalo: nepracovalo, nic nezapisovalo a neukázalo známé okno. Bridge ho ukončil.
- Řešení: pokud se to opakuje, spusťte Money S3 na počítači s bridgem ručně a ověřte, že se otevře a nečeká na žádné okno. Pak spusťte Synchronizovat.
Money S3 ještě pracovalo, když vypršel časový limit
Kód: MONEYS3_PROCESS_SLOW · opakuje se automaticky: ano
- Co uvidíte: hlášení s doporučením zvýšit časový limit. Aplikace v textu uvádí pole „Timeout (ms)“; v nastavení instalace se pole jmenuje „Časový limit běhu Money S3 (ms)“.
- Příčina: Money S3 v okamžiku vypršení limitu ještě pracovalo, jen to trvalo déle.
- Řešení: pokud se to opakuje, zvyšte pole „Časový limit běhu Money S3 (ms)“ (nejvýše asi o 15 sekund nad výchozích 90 000 ms). Pokud ani to nestačí, kontaktujte podporu.
Bridge není připojen
Kód: BRIDGE_NOT_CONNECTED · opakuje se automaticky: ano
- Co uvidíte: hlášení „Ověřte, že je počítač s bridgem zapnutý a připojený k internetu.“
- Příčina: Tappeer nemohl požadavek předat bridgi, protože bridge nebyl připojený.
- Řešení: postupujte podle části Bridge je offline. Jakmile je bridge Online, spusťte Synchronizovat.
Bridge je zaneprázdněný
Kód: BRIDGE_BUSY · opakuje se automaticky: ano
- Co uvidíte: hlášení „Chvíli počkejte.“
- Příčina: bridge právě vyřizoval jiné požadavky a další nepřijal.
- Řešení: chvíli počkejte; Tappeer to zkusí znovu. Pokud se chyba opakuje často, zkontrolujte, zda přes jeden bridge neběží současně mnoho konektorů s častými plány.
Tento účet nemůže bridge používat
Kód: BRIDGE_NOT_AVAILABLE · opakuje se automaticky: ne
- Co uvidíte: hlášení „Připojte konektor k instalaci na bridgi, který tento účet smí používat, nebo požádejte účetní kancelář, aby tomuto účtu přidělila agendu.“
- Příčina: instalace, kterou konektor používá, je na bridgi, který tento účet používat nesmí, například na bridgi účetní kanceláře, která tomuto účtu agendu nepřidělila.
- Řešení: připojte konektor k instalaci na bridgi, který účet používat smí, nebo požádejte účetní kancelář o přidělení agendy. Potom spusťte Synchronizovat.
Bridge byl zneplatněn nebo smazán, zatímco na něj synchronizace čekala
Kód: BRIDGE_REVOKED · opakuje se automaticky: ne
- Co uvidíte: hlášení „Připojte konektor k instalaci na jiném bridgi.“
- Příčina: běh čekal ve frontě na bridge a ten byl mezitím zneplatněn nebo smazán.
- Řešení: připojte konektor k instalaci na jiném bridgi a spusťte Synchronizovat.
Chyby podle třídy
Kód, který vaše verze Tappeeru nezná (například od novějšího pluginu), se zobrazí podle své třídy. Hlášení pak obsahuje i původní text chyby (Původní hlášení:), který vám napoví víc.
Synchronizace selhala z dočasného důvodu
Třída: transient. Problém by měl odeznít sám, Tappeer krok obvykle zopakuje. Chvíli počkejte a spusťte Synchronizovat. Pokud chyba trvá, kontaktujte podporu.
Nastavení je potřeba opravit
Třída: config. Něco v nastavení konektoru nebo instalace neodpovídá cílovému systému. Přečtěte si původní hlášení, opravte nastavení (pokud se nabízí, přes Otevřít nastavení) a spusťte Synchronizovat. Automaticky se neopakuje.
Přihlášení do cílového systému se nezdařilo
Třída: auth. Cílový systém odmítl přihlášení. Zkontrolujte přihlašovací údaje v nastavení instalace a spusťte Synchronizovat. Automaticky se neopakuje.
Cílový systém nedoběhl včas
Třída: timeout. Cílový systém neodpověděl v časovém limitu. Tappeer krok obvykle zopakuje. Pokud se to opakuje, kontaktujte podporu.
Data se nepodařilo zpracovat
Třída: data. Cílový systém nebo plugin nedokázal zpracovat data. Původní hlášení uvádí, která data; opravte je ve zdrojovém systému a spusťte Synchronizovat. Automaticky se neopakuje.
Selhaný běh bez kódu i třídy (například u konektorů bez bridge) ukazuje jen původní text chyby ve sloupci Stav v monitoru.
Bridge je offline
Bridge má štítek Offline, když se neozval déle než 90 sekund. Projděte postupně:
- Je počítač zapnutý a služba běží?
sc query TappeerBridgemusí ukázatRUNNING. Službu restartujete v PowerShellu příkazemRestart-Service TappeerBridge. - Co říká bridge sám?
bridgectl statusukáže fázi a poslední chybu,bridgectl doctorověří síť, TLS a přihlašovací údaj. - Síť, proxy a TLS. Bridge se vždy připojuje sám ven, dovnitř se nic neotevírá. Pokud
bridgectl doctorhlásí, že Tappeer je dostupný přes TCP, ale selže TLS, nahrazuje proxy certifikát vlastním. Nainstalujte kořenový certifikát proxy do úložiště počítače, nebo ho uveďte v konfiguraci bridge vcloud.extra_ca_certs. - Čas počítače. Liší-li se hodiny počítače o více než 60 sekund, objeví se v aktivitě bridge Nesprávný čas počítače. Opravte synchronizaci času ve Windows. Tappeer se proti posunu hodin jistí tím, že záznamy čte s přesahem, takže špatný čas většinou znamená zbytečně znovu načítané záznamy; přesto ho opravte.
- Platí ještě přihlašovací údaj? Byl-li bridge odvolán, už se nepřipojí. Zaregistrujte nový bridge a počítač spárujte znovu (viz Instalace bridge).
Typické situace:
| Co vidíte | Co to je a co dělat |
|---|---|
V logu PERMISSION_DENIED, agent jednou ohlásí, že čeká |
Přihlašovací údaj bridge byl odvolán. Zaregistrujte nový bridge a počítač znovu spárujte; agent nový údaj převezme bez restartu. |
V logu UNAUTHENTICATED a stále nové pokusy o připojení |
Neplatný (zastaralý) přihlašovací údaj. Počítač znovu spárujte. |
Služba při startu hlásí chybu 1069 |
Heslo účtu, pod kterým služba běží, je špatné, nebo je účet zakázaný či zamčený. bridgectl service-account ukáže, o který účet jde; nastavte účet znovu se správným heslem (bridgectl service-account --account DOMÉNA\jméno --password-stdin). |
| TCP funguje, TLS selhává | Proxy podstrkuje vlastní certifikát. Viz bod 3 výše. |
| Bridge je online a pak zhruba každých 45 sekund offline | Zprávy od bridge nedorazí. Nějaké síťové zařízení (proxy, firewall) zavírá nečinné spojení; zkontrolujte jeho časový limit nečinnosti po celé cestě. |
bridgectl status hlásí připojení, Tappeer hlásí offline |
Spojení „visí“. Agent takové spojení po 90 sekundách bez zpráv ukončí a připojí se znovu. Opakuje-li se to, něco mezi počítačem a Tappeerem drží spojení otevřené, ale nepřenáší data. |
| Bridge je online, ale synchronizace hned selhávají | Problém je obvykle v cílovém systému, ne v bridgi. Přečtěte si chybu běhu (viz výše). |
Důvody odpojení na záložce Historie připojení:
heartbeat_timeout— bridge se 45 sekund neozval. Řada krátkých spojení s tímto důvodem ukazuje na síť.shutdown— spojení ukončila strana Tappeeru, typicky při nasazení nové verze. Bridge se připojí znovu sám.gateway_lost— server Tappeeru skončil neočekávaně a spojení uzavřel až po svém restartu. Bridge se připojí znovu sám.
Další důvody popisuje Sledování synchronizace.
Záznam se nesynchronizoval
Běh doběhl, ale konkrétní záznam se nepřenesl. Rozbalte běh v monitoru a u položky Záznamy přeskočeny otevřete Zobrazit detail. Detail uvádí důvod u každého záznamu (jmenovitě nejvýše 100 záznamů, ostatní jen v součtu), technickým kódem a anglickým popisem:
| Kód | Anglický popis v detailu | Co znamená a co dělat |
|---|---|---|
unchanged |
unchanged since the last sync | Záznam se od minula nezměnil. Vše v pořádku, nic nedělejte. |
no-business-key |
no business key | Záznam nemá business klíč. Doplňte klíčové pole ve zdroji, nebo upravte pravidlo klíče (Zkontrolovat kolize ukáže řádky bez klíče). |
source-excluded-no-business-key |
excluded by the source for having no business key | Zdroj záznam vyřadil, protože nemá klíč (například firma bez kódu). Doplňte ho. |
not-found |
not found | Požadovaný záznam neexistuje ani v jednom systému. Zkontrolujte klíč. |
loop-suspected |
write loop suspected | Záznam se přepisuje příliš často (více než 5× za 60 sekund), systémy si ho nejspíš navzájem přepisují. Po chvíli se uvolní sám; trvale to vyřešíte úpravou pravidel nebo toku pole (viz Pole a transformace). |
validation-failed |
failed validation | Záznam neodpovídá datovému modelu, například chybí povinná hodnota. Detail říká co; opravte data ve zdroji. |
target-rejected |
rejected by the target system | Cílový systém záznam odmítl. Detail obsahuje jeho hlášení; opravte podle něj. |
filtered |
excluded by the instance’s filter or setting | Záznam vyřadil filtr nebo nastavení konektoru (například vypnuté vydané faktury). Pokud to není záměr, upravte filtr nebo nastavení. |
not-addressable |
not addressable in the target system | Záznam nemá vazbu ani klíč, podle kterého by ho šlo v cílovém systému najít, a zakládat tam nové záznamy nelze. Doplňte klíč, nebo záznam spárujte. |
ambiguous-match |
matched more than one record, parked for review | Odpovídá více řádkům Tappeeru. Rozhodněte v sekci Čekající shody (viz Párování záznamů a duplicity). Stejný důvod má i záznam, jehož kód převzal jiný řádek a jehož shodu jste odmítli; ten už v sekci nečeká. |
ambiguous-target-match |
the target system holds more than one record under its key | Cílový systém má záznam pod stejným klíčem vícekrát. Odstraňte duplicitu tam; detail vypisuje kolidující id. |
unresolved-reference |
referenced a record that does not exist in Tappeer | Záznam odkazuje na něco, co v Tappeeru není (například uživatele). Nejdřív synchronizujte nebo založte odkazovaný záznam. |
partner-not-linked |
its counterparty is not linked in the target system | Firma z faktury není v cílovém systému spárovaná a nešla odeslat. Viz Párování záznamů a duplicity. |
ambiguous-partner |
its counterparty matches more than one record in the target system | IČO nebo DIČ firmy odpovídá v cílovém systému více záznamům. Odstraňte duplicitní firmu tam; faktura se odešle při dalším běhu. |
archived |
archived in Tappeer; only its read-back fields were written | Záznam je v Tappeeru archivovaný. Zapsala se jen pole zpětně načítaná z druhého systému (například stav zaúčtování faktury), ostatní změny se do archivovaného záznamu nezapisují. Je to očekávané chování. |
Záznamy, jejichž zápis selhal, se počítají jako „selhalo“ a jejich chyba je v aktivitě běhu. Pole, která se nezapsala kvůli dlouhému textu, jsou v tabulce nezapsaných polí (viz Sledování synchronizace).
Změny z Tappeeru se neodesílají
Změna uložená v Tappeeru se do cílového systému odešle zhruba 5 sekund po poslední úpravě (rychlé úpravy jednoho záznamu se slijí do jednoho odeslání). Když se tak nestane, zkontrolujte:
- Je konektor zapnutý? Vypnutý konektor (přepínač Zapnuto) nikdy nesynchronizuje.
- Má konektor odchozí směr? Na záložce Nastavení v sekci Základní údaje.
- Je zapnuté okamžité odesílání? V sekci Plán synchronizace přepínač „Okamžitě odesílat změny z Tappeeru do systému …“. Když je vypnutý, změny odejdou jen naplánovanou úplnou synchronizací nebo ručně (Synchronizovat). Skutečný stav ukazuje přepínač.
- Projde záznam filtrem? Odfiltrovaný záznam se neodesílá.
- Teče pole ven? Pole s tokem Jen do Tappeeru nebo Nesynchronizuje se se neodesílá. Změna jen v nesynchronizovaném poli se ani nepozná jako změna.
- Odkud změna přišla? Změna, kterou do Tappeeru přinesl tentýž konektor, se do něj neposílá zpět (do ostatních konektorů ano).
- Neběží právě jiný běh konektoru? Odeslání počká, až skončí.
Pokud se změnu nedaří předat ke zpracování, Tappeer to zkouší zhruba tři hodiny a pak ji vzdá; ve webové aplikaci se to neukáže. Chybí-li změna v cílovém systému, spusťte Synchronizovat, případně kontaktujte podporu, která umí nedoručené změny vrátit do fronty. Synchronizovat spustí úplnou synchronizaci ve všech směrech, které konektor má (nejdřív příchozí); odchozí běh zapíše jen záznamy, jejichž obsah se liší od posledního zápisu.
Velké množství změn najednou (například hromadná úprava) může Tappeer odeslat jednou úplnou synchronizací místo jednotlivých odeslání.
Smazání záznamu v Tappeeru se do cílového systému nepřenáší; záznam tam případně smažte ručně.
Časté dotazy
Proč běh hlásí stovky přeskočených záznamů?
Téměř vždy jde o záznamy, které se od minula nezměnily (unchanged). To je zdravý stav.
Smazal jsem firmu v Tappeeru, v účetním systému zůstala. Je to chyba? Ne. Smazání se do cílového systému nepřenáší. Obráceně ano: záznam smazaný v cílovém systému Tappeer deaktivuje, odstraní, nebo jen označí podle nastavení Smazané záznamy.
Může synchronizace přepsat údaje, které účetní upravila v účetním systému? Pokud pole teče oběma směry, zapíše se ten stav, který se přenese jako poslední. Chcete-li, aby pole udržoval jen jeden systém, nastavte mu tok (viz Pole a transformace).
Musí být Money S3 na počítači s bridgem zavřené? Obvykle ne, synchronizace funguje i vedle otevřeného Money S3. Pokud chyba uvádí, že Money S3 na počítači běží, zkuste ho zavřít a běh zopakovat.
Co se stane, když je počítač s bridgem vypnutý? Běhy v té době selžou s chybou Bridge není připojen. Po návratu bridge spusťte Synchronizovat, aby se dorovnalo vše, co mezitím neprošlo.
Kde zjistím, kdo změnil nastavení konektoru nebo potvrdil shodu? V monitoru konektoru v pohledu Události konektoru.
Proč konektor nesynchronizuje, i když je plán nastavený? Zkontrolujte, zda je konektor zapnutý (přepínač Zapnuto) a zda nemá štítek Zastaralé nastavení nebo Vyžaduje kontrolu; takový konektor neběží, dokud nastavení nezmigrujete nebo nezkontrolujete.
Kdy kontaktovat podporu
Obraťte se na podporu, když chyba přetrvává i po postupu výše, nebo když hlášení samo doporučuje kontaktovat podporu. Pošlete:
- název účtu a konektoru, případně název bridge,
- čas běhu (sloupec Začátek v monitoru) a kód chyby,
- výstup příkazů
bridgectl status --jsonabridgectl doctor, - logy
launcher.logaagent.logz%ProgramData%\Tappeer\Bridge\logsz doby kolem běhu, - u chyb Money S3 také
RunLogs.txtz doby běhu, ze složky%ProgramData%\<výrobce>\Money S3\Logs\(výrobce je podle verzeSeyfor,SoliteaneboCÍGLER SOFTWARE).
Nikdy neposílejte tajné údaje
Do zprávy nevkládejte hesla, párovací kódy ani soubory s přihlašovacími údaji bridge. Podpora je nepotřebuje.