Každý formát souboru má svou hlavičku, ve které se specifikují názvy sloupců. Ty určují, do které proměnné data v daném sloupci patří. Vždy je nutné dodržet pojmenování sloupců, které je specifikováno v tabulce 3. Důležité je také pořadí sloupců.

Klíč

V každém formátu je určena jedna položka, která slouží jako klíč (bývá to první sloupec). Musí být vždy vyplněná. Při importu se podle klíče vyhledává mezi stávajícími položkami ta, jejíž hodnota klíče se shoduje s hodnotou uvedenou v souboru. Pokud taková položka existuje, opraví se podle dat ze souboru její vlastnosti. V opačném případě se vytvoří položka nová.

Příklad:

Jestliže v interním seznamu existují tyto položky:
   MASKA          JMÉNO        
   0541414141     Petr Novák
   0223232323     Libor Novotný
   
a vstupní soubor má tvar (JMÉNO je klíč):
   JMÉNO          MASKA
   Libor Novotný  666
   Fax            999
   
pak po importu konfigurace se tabulka změní na:
   0541414141     Petr Novák
   666            Libor Novotný
   999            Fax
   
Má-li vstupní soubor tvar (MASKA je klíč): 
   MASKA          JMÉNO
   0541414141     Libor Novotný
   999            Fax
   
pak výsledná tabulka bude vypadat takto:  
   0541414141     Libor Novotný
   0223232323     Libor Novotný
   999            Fax

Formát DBF

Většina programů, které pracují s tabulkami dat, umožňuje zapsat nebo načíst data v tomto formátu. Z tohoto důvodu toto rozhraní umožňuje propojení s celou řadou programových produktů. Filtr je upraven tak, aby zpracoval i soubory neodpovídající přesně specifikaci formátu.

Protože soubor neobsahuje žádné informace o tom, jaký druh dat se v něm nachází, při importu se program zeptá, kam je mají data ze souboru uložit.

V uživatelském rozhraní je také možné nastavit použité kódovaní českých znaků, výběrem ze tří možností: kódová stránka 1250 (Windows), 859 (DOS) nebo kódování bří. Kamenických.

Formát CSV

Toto je jednoduché textové rozhraní. Výhodou tohoto formátu je, že je editovatelný běžným textovým editorem a snadno se programuje.

Jednotlivé věty databáze tvoří textové řádky, oddělené dvojicí znaků CR (13) a LF (10) nebo jen jedním znakem LF (10). Sloupce jsou navzájem odděleny středníkem. Je-li potřeba uložit do buňky znak středník, celý řetězec se uzavře do úvozovek nebo apostrofů. V případě, že je řetězec uzavřen v úvozovkách, pak znak úvozovky se zapisuje jako dvě bezprostředně následující úvozovky. Stejné pravidlo platí v případě apostrofů.

Reálná čísla zapisují se s desetinnou tečkou, logické hodnoty se zapisují ANO, A, TRUE, T pro "ano" a NE, N, FALSE, F pro "ne". Na velikosti písmen nezáleží.

Příklad:

tvar souboru ve formátu CSV pro import interního seznamu:

JMENO;MASKA;ZOBRAZIT;POZNAMKA
Tartek;43240402;T;Tartek pevná
"Libor Novotný";1234567;F;Libor pevná
"""Petr"" Novák";7654321;T;mobil

Program Tardat vyžaduje, aby v prvním řádku byla hlavička s názvy sloupců. Jejich pojmenování musí odpovídat specifikaci uvedené v tabulce 3.

Speciální formát Tardatu

Pro potřeby upgradu programu z DOSové verze byl navržen speciální textový formát, který umožňuje uložit do jednoho souboru celou původní konfiguraci programu, tedy několik tabulek s různým, typem dat (pobočky, linky, skupiny, ...).

Soubor je rozdělen na jednotlivé bloky. Každý blok tvoří hlavička, následují věty tabulky a na konci je jeden volný řádek oddělující data od následujícího bloku.

Hlavička je uzavřena v hranatých závorkách. Na začátku je uveden kontext, který určuje, do které části konfigurace následující data patří. Za kontextem může být uvedeno několik atributů, které mají tvar klíč nebo klíč = hodnota nebo klíč = (hodnota, hodnota, hodnota, ...). Jednotlivé atributy se oddělují alespoň jedním znakem mezera, tabulátor, CR, LF.

Tabulka dat obsahuje data v textovém tvaru. Jednotlivé věty tvoří textové řádky, oddělené dvojicí znaků CR a LF. Sloupce se uvnitř řádku oddělují čárkou, středníkem nebo tabulátorem. Jednoduché řetězce mohou obsahovat pouze znaky A-Z, a-z, 0-9, _, +, - a znaky s interpunkcí. Obsahuje-li řetězec jiné znaky, musí se uzavřít do úvozovek. Úvozovky se v tomto případě kódují jak dvojice bezprostředně následujících úvozovek.

Do souboru je také možné ukládat poznámky. Začínají-li dvěma lomítky, platí pouze do konce řádku. Poznámka začínající znaky /* končí dvojicí znaků */.

Kontext specifikuje typ dat, které následují v bloku a také konfigurační tabulku, do které se mají vstupní data uložit. Přehled kontextů je uveden v následující tabulce:

Tabulka 1: Přehled kontextů ve speciálním formátu Tardatu

Tabulka 2: Přehled atributů ve speciálním formátu Tardatu

Povinný atribut SLOUPCE definuje přiřazení hodnot v souboru sloupcům tabulky. Jeho hodnotou je seznam identifikátorů oddělený čárkou a uzavřený do kulatých závorek. Speciálním případem je podtržítko (_) - údaje v tomto sloupci se ignorují, nebo tři tečky (...) které se uvádí na konci a způsobí ignorování tohoto a všech dalších sloupců až do konce řádku.

Reálná čísla zapisují se s desetinnou tečkou. Logické hodnoty se zapisuje ANO, A, TRUE, T pro "ano" a NE, N, FALSE, F pro "ne". Na velikosti písmen nezáleží.

Příklad:

[INTSEZNAM OVERWRITE SLOUPCE=(JMENO, MASKA, ZOBRAZIT, ...)]
"Ostatni cisla", "%", A, "Specialni polozka"
"Praha", "02%", A
"Brno" , "05%", A
"Tartek", "0543210402", A, "Firma Tartek", "Lužická 9, Brno"
"Internet", "0971%", A
"Mobily", "060%^07%", A

Tabulka 3: Specifikace sloupců tabulek pro import konfigurace

Legenda k poznámkám v tabulce:

• povinná - tento sloupec musí být vždy vyplněn
• klíč - tento sloupce může sloužit jako klíč (viz kapitola 1.1.1).

Současná verze programu Tardat obsahuje tyto výstupní filtry:

• Prostý text - neformátovaný textový soubor s pevnou šířkou sloupců

• CSV - textový soubor, jednotlivá pole jsou oddělena středníkem nebo jiným oddělovačem, každý záznam je na samostatném řádku. Filtr má velké množství nastavení, takže lze formát přizpůsobit konkrétním požadavkům.

• stránka HTML - vytvoří jednoduchou stránku v jazyce HTML, která je zobrazitelná běžnými internetovými prohlížeči.

• formát DBF - formát používaný některými relačními databázovými systémy (dBase, FoxPro). Lze jej otevřít také ve většině tabulkových procesorů.

• příkazy SQL - soubor se sadou SQL příkazů. Pomocí konzoly lze tabulku nahrát na databázový server.

Export do prostého textu

Výstupní soubor obsahuje řádky, které jsou odděleny dvojicí znaků CR (13) a LF (10). Kódovaní českých znaků je volitelné, program podporuje kódovou stránku 1250 (Windows), 859 (DOS), ISO 8859-2 (Linux), kód bří Kamenických a výstup bez diakritiky.

Výstup může obsahovat záhlaví s názvem tabulky případně s popisy sloupců. Sloupce tabulky mají pevnou šířku. Soubor může být zakončen informačním řádkem, který obsahuje údaj o počtu záznamů, verzi programu s datem a časem vytvoření tabulky.

Soubor v tomto formátu můžete načíst do běžného textového editoru a vytisknout. Použijte písmo, které má pevnou šířku znaku, například Courier, aby bylo zachováno rozdělení sloupců.

Příklad:

Pobočky ústředny A

Číslo  Jméno pobočky     Skupina Jméno skupiny      Příplatek Maska                                                             
    15 Martin                  2 Obchodní oddělení          0 Nemaskovat                                                                       
    16 Jitka                   3 Sekretariát                0 Nemaskovat                                                                       
    17 Sekretářka              3 Sekretariát                0 Nemaskovat                                                                       

Počet řádků: 3. Přehled vytvořil program TARDAT 3.6.3 dne: 31. 3. 2003 11:53.

Export do formátu CSV

Výstupní soubor obsahuje řádky, které jsou odděleny dvojicí znaků CR (13) a LF (10). Kódovaní českých znaků je volitelné, program podporuje kódovou stránku 1250 (Windows), 859 (DOS), ISO 8859-2 (Linux), kód bří Kamenických a výstup bez diakritiky. Narozdíl od předchozího případu nejsou šířky sloupců pevné, ale mezi jednotlivými sloupci je oddělovač, nejčastěji středník.

Výstup může obsahovat záhlaví s názvem tabulky případně s popisy sloupců. Soubor může být zakončen informačním řádkem, který obsahuje údaj o počtu záznamů, verzi programu s datem a časem vytvoření tabulky. Tyto údaje se uvádějí vždy do poznámky.

Filtr má velké množství parametrů uvedených v následujícím přehledu, které umožňují přizpůsobit výstup podle přání uživatele. Do všech uvedených polí lze vkládat také netisknutelné znaky, jako je tabulátor nebo nový řádek. Tyto znaky se uvozují vždy zpětným lomítkem bez ohledu na nastavení řídícího znaku. Přehled řídících sekvencí je v tabulce 4 .

• pole jsou uzavřená do - znak nebo několik znaků, kterými začíná a končí každé pole, například úvozovky: "25";"Jan Novák"

• jen řetězce - je-li tato volba zatržena, pak se uzavírají pouze textová pole, například 25;"Jan Novák"

• řídící znak "escape" - pokud se v poli vyskytuje znak uzavírající pole, oddělující pole, ukončující řádek nebo řídící znak, pak se před takový znak vloží uvedený řídící znak, například zpětné lomítko: "Jan \"Honza\" Novák".

• pole jsou oddělená - znak nebo několik znaků oddělující jednotlivá pole, například čárka: 25,Jan Novák

• řádky jsou oddělené - znak nebo několik znaků oddělující jednotlivé záznamy,

• poznámky začínají - znak nebo několik znaků, kterými začínají řádky s poznámkou (název tabulky, informační řádek, ...), například mřížka:
  # Pobočky ústředny A

Znaky	Význam
\n	nový řádek (dvojice CR+LF)
\t	tabulátor
\\	zpětné lomítko (!)

Tabulka 4: Řídící sekvence formátu CSV

Příklad:

Jednotlivá pole mají být oddělená čárkou, uzavírají se vždy do apostrofů. Pokud se někde v řetězci vyskytuje apostrof, vloží se před něj druhý apostrof. Záznamy mají být na samostatných řádcích. Poznámky začínají mřížkou.

Výstupní filtr se nastaví takto:

Pole jsou uzavřená do: '
Jen řetězce          : ne
Řícící znak "escape" : '
Pole jsou oddělená   : ,
Řádky jsou oddělené  : \n
Poznámky začínají    : #

Ukázka výstupu (export poboček):

# Pobočky ústředny A
#
CISLO,JMENO,SKUPINA,JMEN_SKUP,PRIPL,MASK_TYP,AUTH_KOD,UTAJENI,POZNAMKA
'15','Martin','2','Obchodní oddělení','0','Nemaskovat','','N',''
'16','Jitka','3','Sekretariát','0','Nemaskovat','','N',''
'17','Sekretářka','3','Sekretariát','0','Nemaskovat','','N',''
# Počet řádků: 3. Přehled vytvořil program TARDAT 3.6.3 dne: 31. 3. 2003 11:56.

Export do jazyka HTML

Výstupní soubor obsahuje jednoduchou webovou stránku, na které je jednoduchá tabulka s daty, záhlavím a informačním řádkem. Kódovaní českých znaků je volitelné, program podporuje kódovou stránku 1250 (Windows), 859 (DOS), ISO 8859-2 (Linux), kód bří Kamenických a výstup bez diakritiky.

Výsledná stránka může obsahovat záhlaví s názvem tabulky. Také hlavička tabulky s popisy sloupců je volitelná. Soubor může být zakončen informačním řádkem, který obsahuje údaj o počtu záznamů, verzi programu s datem a časem vytvoření tabulky.

Příklad:

Pobočky ústředny Siemens 100E

Počet řádků: 3. Přehled vytvořil program TARDAT 3.6.3 dne: 31. 3. 2003 11:58.

Export do formátu dBase III (dbf)

U tohoto formátu se nastavuje pouze kódovaní českých znaků, program podporuje kódovou stránku 1250 (Windows), 859 (DOS), ISO 8859-2 (Linux), kód bří Kamenických a výstup bez diakritiky.

Výsledný soubor lze vložit do většiny tabulkových editorů a databázových systémů.

Příkazy SQL

Výstupní soubor obsahuje příkazy jazyka SQL, který podporuje většina databázových serverů. Kódovaní českých znaků je volitelné, program podporuje kódovou stránku 1250 (Windows), 859 (DOS), ISO 8859-2 (Linux), kód bří Kamenických a výstup bez diakritiky.

Výstup může obsahovat na začátku příkaz USE pro změnu databáze, příkaz DROP TABLE pro vymazání stávající tabulky a příkaz CREATE TABLE pro vytvoření nové tabulky a definici její struktury. Soubor může také v poznámce obsahovat název tabulky a informační řádek, který obsahuje údaj o počtu záznamů, verzi programu s datem a časem vytvoření tabulky.

Příklad:

USE `tardat`;

# Pobočky ústředny Siemens 100E
#

# Struktura tabulky pobockyA
DROP TABLE IF EXISTS `pobockyA`;
CREATE TABLE `pobockyA` (
  `CISLO` INT(6) NOT NULL,
  `JMENO` CHAR(64),
  `SKUPINA` INT(5),
  `JMEN_SKUP` CHAR(64),
  `PRIPL` INT(4),
  `MASK_TYP` CHAR(16),
  `AUTH_KOD` CHAR(10),
  `UTAJENI` CHAR(1),
  `POZNAMKA` CHAR(64));

# Data tabulky pobockyA
INSERT INTO `pobockyA` VALUES ("15","Martin","2","Obchodní oddělení","0","Nemaskovat","","N","");
INSERT INTO `pobockyA` VALUES ("16","Jitka","3","Sekretariát","0","Nemaskovat","","N","");
INSERT INTO `pobockyA` VALUES ("17","Sekretářka","3","Sekretariát","0","Nemaskovat","","N","");

#
# Počet řádků: 3. Přehled vytvořil program TARDAT 3.6.3 dne: 31. 3. 2003 11:59.