Možné výstupní formáty

Server je schopen exportu do tří základních formátů:

XML

HTML

CSV / TEXT (oddělovač závislý na šabloně)

Struktura výstupního souboru bude záviset na klientem dodané výstupní formátovací XSL šabloně, která bude součástí požadavku.

Formátování exportu

Aby se předešlo chybám ve výstupním souboru (zejm. CSV), kdy by mohlo na základě výskytu Null dojít k záměně dat, bude klientský skript přidávat do požadavku XSL šablonu pro zformátování výsledku před uložením do souboru. Tag předané šablony bude vložen jako kmenový do nového objektu DOMu na serveru a tento objekt pak bude použit jako argument transformační metody datového DOMu, který bude obsahovat data z SQL serveru. Výsledkem této transformační metody bude buď text k uložení (v případě CSV) nebo nový DOM, pro uložení výstupního XML souboru.

Exportní složka

Podobně jako u importu, bude mít i export v nastaveních serveru určenu výchozí exportní složku pro export dat přehledů. V požadavku na export pak bude uvedena případná podsložka (relativní odkaz s možností více kroků tj. podsložek).

Jméno exportovaného souboru

Vedle podsložky bude v požadavku rovněž určen typ a název souboru. Název bude možné v případě opakovaného časovaného exportu doplňovat o pořadové číslo exportovaného souboru tak, aby došlo k jeho vrstvení ve složce a nikoli přepisu původního souboru.

Formátovací šablona výstupu

Klient bude jako potomka požadavku vkládat tag xsl:stylesheet, který bude obsahovat formátovací šablonu výstupu aplikovatelnou na tag sql-query-result. Šablona tedy buď bude sestavovat výstupní XML nebo výstupní CSV.

Syntaxe požadavku

Na základě výše popsaných skutečností bude mít požadavek na export následující XML syntaxi:

<do-export
rel-folder="vystup"
file-type="XML|text"
file-ext="xml"
file-caption="exp"
extend-caption="true|false|file|date|time"
validity="{#string}"
repeat="{#string}"
when-off="{true|false}"
failsafe="{#string}"
>
<sql-query>
<select type="...">SELECT ... FROM ...</select>
</sql-query>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
...
</xsl:stylesheet>
</do-export>

Význam jednotlivých atributů:

rel-folder - jmeno složky do níž se budou soubory exportovat

file-type - určuje, zda bude exportovano do XML nebo CSV

file-ext - určuje příponu souboru

file-caption - určuje počáteční písmena názvu souboru

extend-caption - určuje způsob číslování souborů: true - nepřerušená vzestupná řada, file - o jedna vyšší číslo než je nejvyšši číslo již existujícího souboru, date - k názvu souboru přidá datum, time - k názvu souboru přidá datum a čas

validity, repeat, when-off, failsafe - viz Nastavení plánovače úloh

Uzel sql-query obsahuje pak dotaz pro výběr dat a jeho syntaxe je shodná s požadavky na přímé SQL dotazy.

Aby uživatel mohl tento požadavek používat, musí mít ve vlastnostech uživatele aktivováno oprávnění p_export nebo p_admin.

Syntaxe odpovědi