Export_to_XML

C/C++PascalSQL

BOOL Export_to_XML(cdp_t cdp, const char * dad_ref, const char * fname, tcursnum curs, struct t_clivar * hostvars, int hostvars_count);
function Export_to_XML(cdp : cdp_t; dad_ref, fname : PChar; curs : tcursnum; hostvars : ^t_clivar; hostvars_count : Integer) : Boolean;
PROCEDURE Export_to_XML(INOUT dad_ref CLOB, INOUT fname CHAR(255));


Parametry

cdp
kontextová proměnná klienta
dad_ref
odkaz na DAD
fname
jméno XML souboru
curs
otevřený kurzor nebo -1
hostvars
pole popisující proměnné klienta
hostvars_count
počet složek pole hostvars


Od verze

8.1, úprava 10.0

Popis

Funkce provede export dat uvedených v DAD v XML formátu do zadaného souboru fname. V případě analytického DAD je zdroj dat pevně dán popisem v DAD, proto ponechte hodnotu curs = -1. V případě syntetického DAD je možno využít popisu v DAD, pak ponechte curs = -1, nebo použijte přesměrování na vlastní otevřený kurzor shodné struktury, pak v parametru curs zadejte číslo tohoto kurzoru.

Parametr dad_ref může mít dvě podoby. Je-li ve tvaru jméno_objektu uvozené hvězdičkou (*jméno_objektu), hledá se DAD v otevřené aplikaci jako objekt typu přenos, jinak se čte z uvedené proměnné.

Při použití SQL varianty DAD nesmí vést do ODBC zdroje dat (602SQL server nemá implementováno ODBC). Vede-li DAD do ODBC zdroje dat (od verze 10), pak spojení na tento ODBC zdroj musí být předem otevřeno pomocí funkce ODBC_connect. Vede-li DAD do jiného 602SQL serveru, musí být spojení na tento server předem otevřeno pomocí connect.

Pro použití v jazyce SQL musí být nahraná extenze 602xml a je nutné název funkce prefixovat jejím jménem, tedy CALL `602xml`.Export_to_XML. Na Linuxu je třeba vždy nahrát předem (již před překladem) extenzi příkazem

CALL load_server_extension('602xml')

Pomocí pole hostvars lze předat popis proměnných klientské aplikace, které mohou být použity v dotazu uvedeném jako zdroj dat v DAD nebo jako proměnné, navázané na určitý element DADu. Parametr hostvars_count obsahuje počet takto předávaných proměnných. Pokud proměnné nepoužíváte, uveďte hostvars_count rovno nule.



Návratová hodnota

Klientská funkce vrací TRUE při úspěchu a FALSE při chybě.



Příklad

V jazyce SQL - export dat v XML formátu do zvoleného souboru :

PROCEDURE `exp_xml`();
BEGIN
  DECLARE dad CLOB;
  DECLARE fname CHAR(255);
   
  SET dad ="*pokusny_dad";
  SET fname = "c:\temp\pokus2.xml";
  
  CALL `602xml95`.Export_to_XML(dad,fname);
END

Viz