QBS >> Suplementy i Dokumentacja Techniczna do Q-Line 3000 >> Opis QCONL'a

Dokumentacja techniczna serii Q-Line 3000

Format (eksportu/backup'u/importu) danych w Q-Line 3000 - QTR v 1.0

Pliki QTR służą do wymiany danych pomiędzy programami linii 3000, oraz do ich backupowania. Prócz danych zapisywana jest podstawowa struktura danych oraz data ich wyeksportowania i numer wersji. Pliki QTR są plikami tekstowymi zapisanymi w postaci "czytelnej dla ludzkiego oka".


Format pliku zewnętrznego .qtr - czyli Q-Line Text Archive (exportowego)

Plik jest plikiem tekstowym. Jeżeli został wyeksportowany z włączoną kompresją, to wtedy jest zwykłym plikiem tekstowym skompresowanym w formacie GZIP. Plik składa się z kolejnych poleceń QTR. Każde polecenie ma postać: 

COMMAND_ID(<parameters>){<body>}
gdzie Białe znaki są ignorowane, komentarze można wstawiać od // do końca linii i pomiędzy /* */. Wszystkie Stringi w pliku są w postaci znormalizowanej tzn. format jak w poleceniu printf w języku C. Polskie litery eksportowane są w formacie domyślnym środowiska WIN-1250 dla windows i ISO-8859-2 dla UNIX.

Lista poleceń QTR

W plikach QTR zazwyczaj mamy rozpoczęcie pliku, kolejne tabele, a na końcu jego zakończenie Oto przykładowy plik QTR z dwoma tabelami: GAMES i PLAYERS 
FILE_START(VERSION=3 DATE="2001.05.12")
TABLE_START(IMPORTTYPE="DELALL" NAME="GAMES")
HEAD{INT ID STRING REFEREE1 STRING REFEREE2 INT TOURNAMENTID INT TEAMAID INT TEAMBID STRING TEAMA STRING TEAMB INT DATE }
REC{1 "" "" 1 1 2 "POLSKA" "ŁOTWA" 10959 }
REC{2 "" "" 1 3 4 "BUŁGARIA" "JUGOSŁAWIA" 10959 }
REC{3 "" "" 1 5 6 "CZECHY" "HOLANDIA" 10959 }
REC{4 "" "" 1 1 3 "POLSKA" "BUŁGARIA" 10960 }
REC{5 "" "" 1 4 5 "JUGOSŁAWIA" "CZECHY" 10960 }
REC{6 "" "" 1 2 6 "ŁOTWA" "HOLANDIA" 10960 }
REC{7 "" "" 1 1 5 "POLSKA" "CZECHY" 10961 }
REC{8 "" "" 1 2 3 "ŁOTWA" "BUŁGARIA" 10961 }
REC{9 "" "" 1 4 6 "JUGOSŁAWIA" "HOLANDIA" 10961 }
TABLE_STOP(RECCOUNT=9)
TABLE_START(IMPORTTYPE="DELALL" NAME="PLAYERS")
HEAD{INT ID INT NR STRING NAME STRING LASTNAME }
REC{1 1 "ANDRZEJ" "STELMACH" }
REC{2 3 "PIOTR" "GRUSZKA" }
REC{3 5 "PAWEŁ" "ZAGUMNY" }
REC{4 6 "DAWID" "MUREK" }
TABLE_STOP(RECCOUNT=4)
FILE_STOP

Funkcje exportu / importu do i z plików .qtr

Podstawowe zastosowania plików QTR

pliki QTR są dość elastycznym formatem mającym wiele zastosowań oto kilka z nich.

Eksport na podstawie konfiguracji. Aby wykesportować jakiś przez siebie wybrany plik danych, ustawiamy konfigurację w pliku qtr_export.cfg Zaznaczamy, bądź nie, wybrane pozycje (zależnie od konfiguracji) i uruchamiamy eksport.

Konfiguracja exportu (narzędziowy)

Konfiguracja exportu znajduje się w pliku qtr_export.cfg. Zapisany jest on w formacie czytarki bezkontekstowej - patrz stosowny dokument. Cały plik jest rekordemz następującymi polami:

Konfiguracja backup'u

Konfiguracja backup'u znajduje się w pliku qtr_backup.cfg. Zapisany jest on w formacie czytarki bezkontekstowej - patrz stosowny dokument. Cały plik jest rekordemz następującymi polami:

Backup'u serwera

Dodatkową opcją (Backup - ON LINE) serwer sam może co jakiś czas automatycznie wykonywać backup. Służą do tego dwa dodatkowe paremtry w pliku konfiguracyjnym qtr_backup.cfg:

Przykład pliku konfiguracynego qtr_backup.cfg 
record
{
//      Nazwa pliku docelowego
        FileName = "backups/backup.qtr";
        // SKIP | SPECIFIED
        Compression = "YES";
        BackupMode = "SKIP";
//  OFF | DAILY | PERIODIC
        BackupTimerMode = "DAILY";
        BackupTimerModeParam = "04:00";
//      Lista tabel do wyekspotowania
        Tables = array
        {
//   te tabele to tabele zaznaczeń, można je spokojnie pominąć
            "SELECTIONNAME"; "SELECTION";
        };
}