Přeskočit na obsah
TappeerTappeerNápověda Tappeer

Přidání a nastavení konektoru

Návod, jak přidat konektor, nastavit jeho směr, plán synchronizace a přílohy a jak ho bezpečně zapnout. Konektor synchronizuje jednu entitu s jedním externím systémem.

Než začnete

Postup: přidání konektoru

  1. Na stránce Integrace klikněte na Přidat konektor. Můžete také použít tlačítko pro přidání konektoru v pruhu konkrétní entity — pak se entita předvyplní a nabídnou se jen pluginy, které ji umí synchronizovat.
  2. V okně Přidat konektor vyplňte:
    • Plugin — systém, se kterým se má synchronizovat;
    • Název — podle něj konektor poznáte všude v aplikaci;
    • Typ entity — co se má synchronizovat, například Firmy nebo Faktury. Později ho už nezměníte; pro jinou entitu přidejte nový konektor;
    • Směr synchronizace — v poli Příchozí (externí → Tappeer) zvolte Vypnuto nebo Úplná synchronizace a odchozí směr zapněte zaškrtnutím Odchozí (Tappeer → externí) (nabízejí se jen směry, které plugin umí);
    • Instalace — ze které instalace konektor čte. Každá instalace má pro jednu entitu nejvýš jeden konektor, takže instalace, kterou už pro tuto entitu používá jiný konektor, je nedostupná a u ní je název toho konektoru. Pokud zatím žádná není, přidejte ji na stránce Instalace; u Money S3 a ABRA Flexi okno nabídne také průvodce nastavením integrace (viz Rychlý start).
  3. Klikněte na Zaregistrovat a nastavit. Konektor se vytvoří vypnutý a otevře se jeho stránka.

Stránka konektoru

Stránka konektoru má záložky:

  • Nastavení — základní údaje, plán synchronizace, přílohy a nastavení pluginu (popsané níže);
  • Transformace — pravidla pro jednotlivá pole, business klíč, filtry a výchozí hodnoty (viz Pole a transformace);
  • Vazby — čekající shody a spárované záznamy (viz Párování záznamů a duplicity);
  • Monitor — průběhy synchronizace a události konektoru (viz Sledování synchronizace). Na širokém displeji je monitor zobrazený vedle editoru místo záložky; v užším okně (například 1280 px) zůstává záložkou.

Změny na záložkách Nastavení a Transformace se neukládají hned. Dokud jsou neuložené, zobrazí se dole lišta s tlačítky Uložit změny a Zahodit.

V záhlaví stránky je tlačítko Synchronizovat (ruční spuštění synchronizace) a Smazat (smazání konektoru).

Základní údaje

Sekce Základní údaje obsahuje Plugin a Typ entity (oba jen ke čtení), Název, Směr synchronizace a Instalace. Pod směrem aplikace vysvětlí jeho význam, například „Příchozí: záznamy změněné v MoneyS3 se zapisují do Tappeeru.“ (aplikace zde uvádí název systému tak, jak ho hlásí plugin)

  • Instalaci můžete změnit výběrem jiné, nebo přidat novou tlačítkem Nová instalace. Instalace, kterou pro tuto entitu už používá jiný konektor, je nedostupná. Když volná nezbývá, aplikace odkáže na konektor, který instalaci používá, a na stránku Instalace.
  • Typ entity změnit nelze. Pro jinou entitu přidejte nový konektor.

Plán synchronizace

Sekce Plán synchronizace určuje, kdy se konektor spouští sám. Ruční synchronizace tlačítkem Synchronizovat funguje vždy, s plánem i bez něj.

Plán přidáte tlačítkem Přidat plán. U každého plánu zvolíte:

  • Co synchronizovat:
    • Úplná synchronizace — přečte všechny záznamy;
    • Jen změny (od posledního běhu) — přečte jen záznamy změněné od posledního úspěšného běhu. Nabízí se jen u příchozího konektoru a jen u systému, který umí vypsat změněné záznamy (Money S3 to neumí).
  • Jak často: Každou minutu, Každých 15 minut, Každých 30 minut, Každou hodinu, Každých 6 hodin, Denně v zadaný čas (s polem Čas), Týdně v zadaný den (s poli Den a Čas), nebo Vlastní (cron).

U volby Vlastní (cron) zadáte Výraz cron a Časové pásmo. Výraz má pět polí oddělených mezerou: minuta, hodina, den v měsíci, měsíc a den v týdnu. Například 0 2 * * * znamená každý den ve 2:00, 30 6 * * 1-5 každý pracovní den v 6:30.

Každý plán ukazuje, kdy poběží příště. Nově přidaný plán se aktivuje až uložením a vypnutý konektor se nikdy nespouští podle plánu.

Osvědčené nastavení pro příchozí směr je častý plán Jen změny (od posledního běhu) doplněný občasným plánem Úplná synchronizace, která dorovná, co by běh se změnami minul. U Money S3, kde je k dispozici jen úplná synchronizace, stačí jeden noční plán.

Okamžité odesílání změn z Tappeeru

U konektoru s odchozím směrem je v sekci přepínač Okamžitě odesílat změny z Tappeeru do systému … (například „Okamžitě odesílat změny z Tappeeru do systému MoneyS3“).

  • Zapnutý: záznam změněný v Tappeeru se krátce po uložení zapíše do externího systému. Pokud konektor právě dokončuje předchozí běh, změna počká, až skončí.
  • Vypnutý: změny se do externího systému dostanou jen naplánovanou úplnou synchronizací nebo ruční synchronizací.
  • U nového konektoru je zapnutý.

Pokud se změnu nedaří předat ke zpracování, Tappeer předání opakuje přibližně tři hodiny a pak to vzdá. Data v Tappeeru se tím neztratí: změnu dorovná příští úplná nebo ruční synchronizace, případně požádejte podporu Tappeer o opětovné odeslání. Pokud se změnu nepodaří zapsat do externího systému (například je bridge offline nebo systém zápis odmítne), uvidíte to jako neúspěšný běh na záložce Monitor — viz Sledování synchronizace a Řešení problémů.

Přílohy

Sekce Přílohy určuje, zda spolu se záznamem putují i jeho přílohy. Dokud ji nezapnete, přenášejí se jen data záznamu. Směr, který plugin pro danou entitu neumí, je nedostupný a aplikace u něj vysvětlí proč (například Money S3 přílohy faktur jen přijímá, viz Podporované systémy).

  • Stahovat přílohy z … — příloha externího záznamu se uloží k záznamu v Tappeeru. Nikdy se z ní nestane sken faktury a nečte ji vytěžování.
  • Odesílat přílohy do … — přílohy záznamu z Tappeeru se nabídnou externímu systému poté, co se zapíšou data záznamu. Soubor, který už tam je, se neposílá znovu. V části Přílohy, které se odesílají zaškrtněte role příloh, které se mají odesílat.

Smazané záznamy

Sekce Smazané záznamy určuje, co Tappeer udělá, když externí systém záznam smaže nebo ho přestane posílat. Platí jen pro konektor s příchozím směrem. Volba Když záznam ve zdroji zmizí:

  • Deaktivovat — záznam zmizí z nabídek; doklady, které ho používají, zůstanou beze změny;
  • Odstranit — záznam se odstraní; když ho něco používá, Tappeer ho jen označí;
  • Jen označit — záznam zůstane, jak je; uvidíte u něj jen štítek „Smazáno ve zdroji (…)“.

Nabízejí se jen režimy, které daná entita umí, a výchozí je označený „(výchozí)“. Doklady (faktury, objednávky, příjemky) se vždy jen označí. Změna platí od příští synchronizace a vyžaduje stejné oprávnění k entitě jako změna příchozích pravidel.

Smazání pozná úplná synchronizace, která doběhla bez chyb záznamů, nebo běh jakéhokoli druhu, ve kterém systém smazání sám nahlásí (Money S3 u smazaných dokladů). Když se záznam ve zdroji znovu objeví, Tappeer ho při další synchronizaci vrátí. Když najednou chybí víc záznamů než obvykle, třeba po zúžení rozsahu filtrem nebo po změně účetní jednotky, Tappeer s nimi nic neudělá a pozdrží je v dávce, kterou potvrdíte nebo zahodíte v monitoru (viz Chybějící záznamy).

Nastavení připojení, Engine a verze nastavení

Nastavení připojení obsahuje nastavení pluginu, která se liší podle entity, například definice přenosu nebo sazby DPH u faktur; povinné hodnoty jsou první. Nastavení sdílená celou instalací (adresa, firma, přihlašovací údaje) se zadávají na instalaci — odkaz Upravit její sdílená nastavení vás tam dovede. Co které pole znamená, popisuje Podporované systémy.

V sekci Engine je přepínač Potlačení ozvěny. Přeskočí záznam, který se z druhého systému vrátí beze změny, aby jedna úprava neskákala mezi systémy donekonečna. Nechte ho zapnutý. Vypnutí použijte jen výjimečně, například abyste jednorázově vynutili přepsání všech záznamů, a pak ho znovu zapněte — vypnutý způsobí, že se každý záznam zapíše při každém běhu.

Sekce Verze nastavení ukazuje, pro kterou verzi nastavení pluginu byly hodnoty konektoru uložené, a Stav:

Stav Význam
Aktuální Nastavení odpovídá aktuální verzi pluginu.
Zastaralé Nová verze pluginu změnila podobu nastavení a konektor ještě nebyl převeden. Konektor neběží; klikněte na Migrovat nyní.
Vyžaduje kontrolu Převod proběhl, ale něco nevyřešil (například chybí nová povinná hodnota). Konektor se vypnul. Opravte hodnoty a uložte; platné uložení stav zruší.

Dokud konektor není na aktuální verzi, ukazuje stránka nahoře upozornění s tlačítky Migrovat nyní a Zkontrolovat v Nastavení. Před migrací uložte rozpracované změny.

Zapnutí konektoru

Konektor synchronizuje, jen když je zapnutý. Přepínač Zapnuto je nad editorem na každé záložce. Vypnutý konektor může být neúplný — tak si ho připravíte předem. Zapnutí vyžaduje kompletní nastavení konektoru i instalace; pokud něco chybí, uložení se odmítne a aplikace ukáže, co opravit.

Stav konektoru ukazují štítky:

  • Zapnuto — konektor synchronizuje;
  • Koncept — konektor ještě nebyl zapnutý;
  • Plugin není dostupný — plugin konektoru není na platformě nainstalovaný, konektor nelze zapnout;
  • Zastaralé nastavení nebo Vyžaduje kontrolu — viz verze nastavení výše.

Ruční synchronizaci spustíte tlačítkem Synchronizovat v záhlaví konektoru nebo na kartě konektoru na stránce Integrace. Spustí se jen u zapnutého konektoru s aktuálním nastavením.

Doporučený první běh

  1. Ověřte instalaci tlačítkem Ověřit připravenost.
  2. Nastavte konektor nejdřív jen s příchozím směrem (Příchozí (externí → Tappeer) na Úplná synchronizace, Odchozí (Tappeer → externí) nezaškrtnuté), zapněte přepínač Zapnuto, klikněte na Uložit změny a pak na Synchronizovat.
  3. Na záložce Monitor zkontrolujte výsledek běhu (viz Sledování synchronizace).
  4. Na záložce Vazby vyřešte Čekající shody — záznamy, které by mohly odpovídat více řádkům Tappeeru (viz Párování záznamů a duplicity).
  5. Teprve potom přidejte odchozí směr, uložte a nastavte plán synchronizace.

Při potížích pomůže Řešení problémů.