Základní pojmy

Slovníček pojmů, se kterými se v integracích setkáte, a kde je v aplikaci najdete. Stejná vysvětlení ukazuje i aplikace — u tečkovaně podtržených pojmů a u názvů sloupců na stránce Integrace.

Entita

Druh záznamu, který Tappeer vede: například Firmy, Faktury, Střediska nebo Zakázky. Na stránce Integrace má každá entita svůj pruh a každý konektor synchronizuje právě jednu entitu. V aplikaci ji najdete ve sloupci Entita Tappeeru a v nastavení konektoru jako Typ entity.

Externí systém a plugin

Externí systém je druhý systém, odkud záznamy přicházejí nebo kam jdou — účetní program nebo ERP, například Money S3, POHODA nebo ABRA Flexi. S každým systémem komunikuje jeho plugin, který Tappeer dodává a aktualizuje. Verzi pluginu vidíte ve sloupci Externí systém.

Konektor

Jedna synchronizace jedné entity s jedním externím systémem: její směr, plán a pravidla, která cestou upravují každý záznam. Například „Firmy z Money S3“ a „Faktury do Money S3“ jsou dva konektory. Entitu konektoru zvolíte při jeho přidání a později ji nezměníte. Konektor přidáte tlačítkem Přidat konektor; nastavuje se na vlastní stránce se záložkami Nastavení, Transformace, Vazby a Monitor. Podrobnosti: Přidání a nastavení konektoru.

Cílový systém a instalace

Instalace je jedno konkrétní nasazení externího systému, ke kterému se Tappeer připojuje — například jedna agenda Money S3, jedna účetní jednotka POHODY nebo jedna firma v ABRA Flexi. Na instalaci se zadává to, co sdílejí všechny konektory, které ji používají: cesta nebo adresa, firma a přihlašovací údaje. Díky tomu heslo zadáte jen jednou, i když jednu agendu používají konektory pro firmy i faktury. Každá instalace má pro jednu entitu nejvýš jeden konektor. Instalace najdete v nabídce nastavení pod Integrace → Instalace. Podrobnosti: Cílové systémy a instalace.

Připojení: přímé, nebo přes bridge

Připojení říká, jak Tappeer dosáhne na externí systém. Přímé připojení vede přes internet bez prostředníka (v aplikaci Přímo nebo Cloud). Připojení přes bridge vede bezpečným tunelem k agentovi ve vaší síti (v aplikaci Přes bridge nebo Bezpečný tunel). Najdete je ve sloupci Připojení na stránce Integrace.

Bridge

Malý agent Tappeeru (Tappeer Bridge) na počítači s Windows ve vaší síti. Dosáhne na systémy, kam cloud nedosáhne, například na desktopové Money S3 nebo POHODU, a spojení s Tappeerem navazuje vždy sám, směrem ven. Bridgy spravujete v nabídce nastavení pod Integrace → Bridge. Podrobnosti: Instalace a spárování bridge a Provoz bridge.

Párovací kód

Jednorázový kód ve tvaru TPB-XXXX-XXXX-XXXX, kterým se nainstalovaný agent přiřadí k vašemu účtu. Kód platí 15 minut, lze ho použít jen jednou a zobrazí se jen jednou. Velikost písmen nerozhoduje. Vystaví se při registraci bridge a u bridge, který dosud nebyl spárován, ho můžete vystavit znovu tlačítkem Párovací kód.

Směr synchronizace

Kterým směrem konektor přenáší záznamy: příchozím (z externího systému do Tappeeru), odchozím (z Tappeeru do externího systému), nebo oběma. Nastavuje se v sekci Základní údaje v poli Směr synchronizace: pro příchozí směr zvolíte Vypnuto nebo Úplná synchronizace, odchozí směr zapnete zaškrtávacím polem Odchozí (Tappeer → externí). Nabízejí se jen směry, které plugin daného systému umí. Pluginy, které umějí zpětně načíst stav odeslaných záznamů, nabízejí u příchozího směru ještě Jen zpětné načtení; u faktur ho nabízí Money S3 a ABRA Flexi.

Tok pole

Kterým směrem smí jednotlivé pole přecházet: oběma směry, jen do Tappeeru, jen do externího systému, nebo vůbec. Tok umí zápis pole jen omezit, nikdy rozšířit. Pole, ze kterých se skládá business klíč, přecházejí vždy. Tok nastavujete na záložce Transformace v části Pole (viz Pole a transformace).

Business klíč

Hodnota, podle které se pozná, že řádek v Tappeeru a záznam v externím systému jsou totéž — například IČO nebo kód. Obě strany se na ní musí shodnout a měla by být stálá, jedinečná a vždy vyplněná. Záznam bez business klíče se nesynchronizuje. Nastavuje se na záložce Transformace v části Business klíč; změna pravidla klíče znovu přepočítá všechny vazby konektoru.

Náhradní klíč

Druhý způsob, jak při prvním kontaktu najít protějšek záznamu, když business klíč nic nenajde — u firem například IČO a DIČ. Náhradní klíč slouží jen k prvnímu spárování. V aplikaci ho uvidíte jako označení pole na záložce Transformace.

Vazby

Vazba je zapamatované spárování „tento řádek v Tappeeru je tento záznam v externím systému“. Vede se pro každý konektor zvlášť a další běhy podle ní zapisují do správného záznamu. Vazby konektoru najdete na záložce Vazby; aktivní vazbu tam můžete zrušit (Zrušit vazbu) nebo převést na jiný řádek (Změnit řádek). Podrobnosti: Párování záznamů a duplicity.

Čekající shody

Příchozí záznamy, které by mohly odpovídat více řádkům Tappeeru. Synchronizace v takovém případě nehádá: záznam odloží a nechá rozhodnutí na vás. Čekající shody se zobrazují nahoře na záložce Vazby pod nadpisem Čekající shody; vyberete správný řádek a kliknete na Potvrdit, nebo shodu zamítnete tlačítkem Odmítnout. Podrobnosti: Párování záznamů a duplicity.

Potlačení ozvěny

Když Tappeer zapíše záznam do externího systému, v dalším příchozím běhu se tentýž záznam vrátí zpět. Potlačení ozvěny ho pozná jako nezměněný a přeskočí, takže jedna úprava neskáče mezi systémy donekonečna. Nechte ho zapnuté; najdete ho v nastavení konektoru v sekci Engine.

Plán synchronizace

Kdy se konektor spouští sám: například každou hodinu nebo denně v zadaný čas. Bez plánu konektor periodicky neběží, ruční synchronizace tlačítkem Synchronizovat ale funguje vždy. Odchozí konektor může navíc odesílat změny z Tappeeru krátce po uložení. Nastavuje se v sekci Plán synchronizace (viz Přidání a nastavení konektoru).

Běh synchronizace

Jedno spuštění konektoru jedním směrem: přečte záznamy na jedné straně a zapíše je na druhou. Každý běh má stav (Probíhá, Dokončeno, Selhalo) a počty vytvořených, aktualizovaných, přeskočených a chybných záznamů. Běhy najdete na záložce Monitor konektoru a na stránce Monitor pod Integrace (viz Sledování synchronizace).

Transformace

Pravidla, která se na záznam použijí cestou mezi systémy: business klíč, filtry, kroky jednotlivých polí a výchozí hodnoty. Každý plugin dodává výchozí pravidla, která můžete upravit. Najdete je na záložce Transformace (viz Pole a transformace).