XML export

XML export je k dispozici na adrese http://www.a-prague.com/xml/export.php. Této adrese je potřeba v URL nebo v POST datech předat přihlašovací údaje – přihlašovací jméno v parametru login, heslo v parametru password. Pro přístup ke XML exportu je potřeba mít příslušné oprávnění.

Bez dalších parametrů je vrácen seznam tabulek, které je možno získat. Každou z těchto tabulek je možno předat v GET parametru table. V tom případě je vrácen její kompletní obsah.

Chyby

Pokud dojde k chybě (autorizace, neplatný název tabulky, …), je vrácen jediný element <error> obsahující popis chyby.

Formát vrácených dat

Kořenový element dokumentu je <resultset>, každý řádek tabulky je uzavřen ve značce <row>. V každém řádku tabulky je seznam značek <field> s atributem name obsahujícím název sloupce. Všechny hodnoty obsahují čistá textová data – pokud je jejich obsahem HTML fragment, je patřičným způsobem zakódován. U prázdných hodnot (NULL) se sloupec nepředává.

Texty jsou k dispozici v několika jazycích. Tyto texty jsou uloženy ve sloupcích sloupec_en, sloupec_de a podobně. V dokumentaci jsou tyto sloupce popsány jako sloupec_LANG. Seznam používaných jazyků je k dispozici v tabulce jazyky. Všechny texty jsou vždy k dispozici v anglické verzi, ostatní překlady mohou být nedostupné – v tom případě nejsou vůbec přenášeny.

Veškerá data jsou přenášena v kódování UTF-8.

Ukládání dat

Rozhraní dovoluje kromě exportu dat také ukládání nových objednávek a hodnocení hotelů. V tom případě se místo parametru table předá parametr save s hodnotou objednavka nebo hodnoceni.

Výpočet ceny

Do výpočtu ceny ubytování vstupuje několik tabulek. Základní cena je uložena v tabulce pokoj_cenik. Cena doplňových služeb je uložena v tabulce hotel_cena a nevztahují se na ni žádné slevy.

Hotel může aplikovat slevu na všechny pokoje – ta je uložena v tabulce hotel_specialni_nabidka. Sleva může být vyjádřena absolutní hodnotou nebo procentem (určuje sloupec mena) a může platit jen pro určitý počet osob (min_osob, max_osob). Ve stejné tabulce jsou uloženy i nabídky „X nocí za cenu Y“ (ve sloupcích x, y a jednorazove) a nabídky transferu zdarma (sloupce x a transfer).

Kromě toho může být aplikovaná sleva i na jednotlivé pokoje – ty jsou uložené v tabulce pokoj_cenik_sleva. Mohou být opět vyjádřeny absolutně nebo relativně (mena) a mohou platit jen od určitého počtu nocí (min_noci).

Přistýlky

Počet lůžek je uveden v tabulce pokoj ve sloupci pocet_luzek. Maximální možný počet přistýlek je uveden ve sloupci pristylka. Přistýlky jsou uloženy buď v tabulce hotel_cena se sloupcem specialni nastaveným na extra_bed nebo v tabulce pokoj se sloupcem byt nastaveným na extra_bed. Druhý způsob se používá v případě, kdy se cena přistýlky mění v průběhu roku.

Import dat

Data je vhodné uložit z XML do vlastní databáze a na webových stránkách je zobrazovat z ní. Databáze by měla být vytvořena podle dokumentace jednotlivých tabulek např. následujícím PHP skriptem:

<?php
$jazyky = array();
$xml = simplexml_load_file("http://www.a-prague.com/xml/export.php?login=" . LOGIN . "&password=" . PASSWORD . "&table=jazyky");
foreach ($xml->row as $row) {
    $jazyk = array();
    foreach ($row->field as $field) {
        $jazyk[(string) $field["name"]] = (string) $field;
    }
    $jazyky[] = $jazyk;
}

$file = file_get_contents("http://www.a-prague.com/xml-export-documentation");
preg_match_all('~<h3><a name="(.+)"(.*)</table>~sU', $file, $tables, PREG_SET_ORDER);
foreach ($tables as $table) {
    preg_match_all('~<th>(.+)</th>\\s*<td>(.+)</td>~sU', $table[2], $columns, PREG_SET_ORDER);
    $create = array();
    foreach ($columns as $column) {
        $typ = preg_replace('~ - .*~s', '', strip_tags($column[2]));
        if (substr($column[1], -5) == "_LANG") {
            foreach ($jazyky as $jazyk) {
                $create[] = substr($column[1], 0, -4) . "$jazyk[id] $typ COLLATE utf8_$jazyk[mysql_kodovani]_ci";
            }
        } else {
            $create[] = "$column[1] $typ";
        }
    }
    mysql_query("CREATE TABLE $table[1] (\n\t" . implode(",\n\t", $create) . "\n);\n\n");
}

Import dat lze v PHP provést např. následujícím způsobem:

<?php
$xmlreader = new XMLReader;
$result = mysql_query("SHOW TABLES");
while ($row = mysql_fetch_row($result)) {
    $table = $row[0];
    $xmlreader->open("http://www.a-prague.com/xml/export.php?login=" . LOGIN . "&password=" . PASSWORD . "&table=$table");
    $columns = array();
    $result1 = mysql_query("SHOW COLUMNS FROM $table");
    while ($row1 = mysql_fetch_assoc($result1)) {
        $columns[$row1["Field"]] = $row1["Type"];
    }
    mysql_free_result($result1);
    mysql_query("TRUNCATE $table");
    $set = array();
    while ($xmlreader->read()) {
        if ($xmlreader->nodeType == XMLReader::ELEMENT && $xmlreader->name == "field") {
            $column = $xmlreader->getAttribute("name");
            $xmlreader->read();
            if (isset($columns[$column])) {
                $set[$column] = "'" . addslashes($xmlreader->value) . "'";
            }
        } elseif ($xmlreader->nodeType == XMLReader::END_ELEMENT && $xmlreader->name == "row") {
            mysql_query("INSERT INTO $table (" . implode(", ", array_keys($set)) . ") VALUES (" . implode(", ", $set) . ")");
            $set = array();
        }
    }
    $xmlreader->close();
}
mysql_free_result($result);
?> 

Popis sloupců tabulek

• hotel - Hotely
• kreditni_karty_hotelu - Kreditní karty
• hotel_skupiny - Skupiny
• hotel_storno - Storno podmínky
• hotel_obsazeno - Obsazenost hotelu
• foto - Fotografie
• hotel_cena - Doplňující ceník
• hotel_specialni_nabidka - Speciální nabídky
• pokoj - Pokoje
• vybaveni_hotelu_pokoje - Vybavení
• pokoj_min_noci - Minimální počet nocí
• pokoj_obsazeno - Obsazenost pokojů
• pokoj_cenik - Cena pokojů v jednotlivých obdobích
• pokoj_cenik_sleva - Slevy pokojů
• hodnoceni - Ohlasy
• hodnoceni_text - Hodnocení
• hodnoceni_druh - Skupiny hodnotitelů
• hodnoceni_typ - Typy hodnocení
• hotel_skupina - Skupiny hotelů
• nastaveni - Města
• jazyky - Jazyky
• staty - Státy
• hotel_typ - Typy hotelů
• hotel_umisteni - Umístění
• storno_podminky - Storno podmínky
• kreditni_karty - Kreditní karty
• vybaveni - Vybavení pokojů
• url - URL a další metadata

hotel

kreditni_karty_hotelu

hotel_skupiny

hotel_storno

hotel_obsazeno

foto

hotel_cena

hotel_specialni_nabidka

pokoj

vybaveni_hotelu_pokoje

pokoj_min_noci

pokoj_obsazeno

pokoj_cenik

pokoj_cenik_sleva

hodnoceni

hodnoceni_text

hodnoceni_druh

hodnoceni_typ

hotel_skupina

nastaveni

jazyky

staty

hotel_typ

hotel_umisteni

storno_podminky

kreditni_karty

vybaveni

kurzy

url