Import_from_XML

C/C++PascalSQL

BOOL Import_from_XML(cdp_t cdp, const char * dad_ref, const char * fname, struct t_clivar * hostvars, int hostvars_count);
function Import_from_XML(cdp : cdp_t; dad_ref, fname : PChar; hostvars : ^t_clivar; hostvars_count : Integer) : Boolean;
PROCEDURE Import_from_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
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 import dat v XML formátu ze zadaného souboru fname podle popisu mapování uvedeného v DAD.

Parametr dad_ref může mít dvě podoby. Je-li ve tvaru jméno_objektu uvozené hvězdičkou (viz příklad), 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.

Pomocí pole hostvars lze do proměnných klientské aplikace, navázané na určitý element DADu, předat hodnotu. 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.

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`.Import_from_XML. Na Linuxu je třeba vždy předem nahrát extenzi příkazem 

CALL load_server_extension('602xml')



Návratová hodnota

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



Příklad

V jazyce SQL - import dat z XML souboru s použítím uloženého DAD:

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

Viz