===== XML Egyszerűsített lekérdezések =====
A rendszer lehetőséget biztosít a tokenes bejelentkezés használatára is a szokásos név + jelszó helyett, ezzel akár egy lépésre egyszerűsítve a kommunikációs folyamatokat.
A token a felhasználó létrehozásakor, módosításakor jön létre.
Tokenes bejelentkezéskor a következő felépítésű URL-t kell küldeni a szervernek:
http://....bin/index.cgi?xml''"
tokenA_token_helyelangHU"
Természetesen megfelelően URL kódolva az XML-t GET esetén. (küldhető POST-al is).
Az alapvető műveleteket tartalmazó oldal eléréséhez a dok=>sysportal kulcsot lehet használni.
Ld. sysportal.php példa kód
Az itt kapott output tartalom megfelel [[spec:xml_interface|Esystem XML Interface version 0.3]] leírásnak.
Ha van Raktar modul telepitve a rendszerre akkor az outputban megtalaljuk a kovetkezo sorokat:
raktarkeszlet
...
dokraktar_lista
...
Itt két lehetőségünk van
1, [[spec:xml_pelda_raktarlekerdezes|]] oldal 7. pontjától folytatjuk a műveleteket vagy
2, használjuk a tokenes kérés küldést, azaz a elküldjük a "token", "lang","dok" kulcsot.
A "dok" kulcs érteket a sysportal "raktarkeszlet" alatt a dok field értéke tartalmazza, ez jelenleg "raktar_lista"
raktar_lista.php-ben látható erre egy példa
Cikktörzs listázása is ugyanígy történik. A sysportalban a "termek_lista" choicename-t kell használni.
Ekkor megkapjuk a teljes termek listát.
Új termék rögzítése: sysportalból meghívjuk a "uj_termek" choicename-t.
tokenes példa a uj_termek_token.php, az eredmény az uj_termek_eredmeny.xml
Ekkor kapunk egy minta XML-t, amelyet érdemes XML értelmezővel feldolgozni.
A megfelelő adatokat ki kell tölteni (" tag-ek közötti értekek"), majd visszaküldeni.
Visszaküldéskor az XML GET/POST mező érteké a generált XML .
Példa egy visszaküldhető XML-re a termek_minta.xml, amely egy új termek felvételére szolgál.
Lehetőség van egy meglevő termék módosítására.
A termek_kivalasztas.php a paraméterben megadott cikkszámot betölti szerkesztésre.
A példa kódokban értelemszerűen a token,url,[cikkszam] mezők értékét a megfelelő konkrét adatokra kell átírni.
');
$tail = urlencode('');
$text = $head;
foreach($fields as $key=>$value)
$text.=''.urlencode($key).''.urlencode($value).'';
$text .= $tail;
$contents = file_get_contents($url.'?xml='.$text);
return $contents;
}
$url = 'http://...../cgi-bin/index.cgi';
$fields = array(
'dok'=>'sysportal',
'token'=>'TOKEN-hely',
'lang'=>'HU',
);
print esystem_xml_communication($url,$fields);
?>
');
$tail = urlencode('');
$text = $head;
foreach($fields as $key=>$value)
$text.=''.urlencode($key).''.urlencode($value).'';
$text .= $tail;
$contents = file_get_contents($url.'?xml='.$text);
return $contents;
}
$url = 'http://...../cgi-bin/index.cgi';
$fields = array(
'dok'=>'raktar_lista',
'token'=>'TOKEN-hely',
'lang'=>'HU',
);
print esystem_xml_communication($url,$fields);
?>
');
$tail = urlencode('');
$text = $head;
foreach($fields as $key=>$value)
$text.=''.urlencode($key).''.urlencode($value).'';
$text .= $tail;
$contents = file_get_contents($url.'?xml='.$text);
return $contents;
}
$url = 'http://...../cgi-bin/index.cgi';
$fields = array(
'dok'=>'torzs_cikk_termek',
'token'=>'TOKEN-hely',
'lang'=>'HU',
);
print esystem_xml_communication($url,$fields);
?>
mainformsidXwMRmET2HUformbtorzs_cikk_termeklidVa0n2czMHUciddHK900XMHUoidhiddenRekordazonosító a cikk táblábancikkszamtext^[^'\<\>\\\x00-\x1f\x7f]*$1A termék cikkszáma.old_cikkszamhiddengykodtextA termék kódja, mely a gyártó álltal meghatározott cikkszám.megnevezestext1A cikk megnevezése.kshtextAz cikk KSH jele (SZJ, VTSZ, stb)afakulcsselectafakoron_kivul20.0015.000.0025.001ÁFA% meghatározásmegystext1Az cikk mennyiségi egysége (db, óra, doboz, stb).unit1num1Az cikk legkissebb mennyisége, amivel a rendszer dolgozikcikk_kategoriaselectAz cikk kategóriájagyartoselectLaposA cikk besorolása gyártók szerintvonalkodtextA termék vonalkódjaaktiv1booleanAktív-e még a cikk?gysz0booleanGyáriszám nyilvántartás tartozzon-e a cikkhez?garanciatextAz cikkre vonatkozó garancia.minkeszlettextMinimumkészletmaxkeszlettextMaximumkészletfixar0booleanRögzített eladási árak használata a beszerzési ár alapján kalkulált árak helyettbeszar0numAz utolsó beszerzési árbeszar_penznemHUFtextbeszardat2010.03.22textAz utolsó beszerzési ár dátumaEUR_beszar_szaztextEUR_beszar ár %ures_oszlophiddenEUR_beszar0.00numEUR_beszar ár_ar_helpEUR_beszar_penznemEURtextElrontott_szaztextElrontorr %ures_oszlophiddenElrontott0numElrontorr_ar_helpElrontott_penznemHUFtextEuR_1_szaztextEuros ár %ures_oszlophiddenEuR_10.00numEuros ár_ar_helpEuR_1_penznemEURtextUSD2_szaztextUSD2 %ures_oszlophiddenUSD20.00numUSD2_ar_helpUSD2_penznemUSDtextakcios_huf_szaztextnenezd %ures_oszlophiddenakcios_huf0numnenezd_ar_helpakcios_huf_penznemHUFtextakciosarkat_HUF_szaztextAkciós_EUR %ures_oszlophiddenakciosarkat_HUF0.00numAkciós_EUR_ar_helpakciosarkat_HUF_penznemUSDtextakcuos_USD_szaztextakcuos_USD %ures_oszlophiddenakcuos_USD0.00numakcuos_USD_ar_helpakcuos_USD_penznemUSDtextakicos_jo_szaztextakcios_huf %ures_oszlophiddenakicos_jo0numakcios_huf_ar_helpakicos_jo_penznemHUFtextar1_szaztextKiskereskedelmi %ures_oszlophiddenar10numKiskereskedelmi_ar_helpar1_penznemHUFtextar2_szaztextViszonteladói %ures_oszlophiddenar20numViszonteladói_ar_helpar2_penznemHUFtextar3_szaztextNagykereskedelmi %ures_oszlophiddenar30numNagykereskedelmi_ar_helpar3_penznemHUFtextar4_szaztextPiaci ár %ures_oszlophiddenar40numPiaci ár_ar_helpar4_penznemHUFtextujakcio_szaztextujakcio %ures_oszlophiddenujakcio0.00numujakcio_ar_helpujakcio_penznemUSDtextusa1_szaztextUsaDollaros ár %ures_oszlophiddenusa10numUsaDollaros ár_ar_helpusa1_penznemHUFtextmegjtextareaA cikkre vonatkozó megjegyzésbuttonsubmitb_szamolb_felveszb_cloneb_eldobbacksidXwMRmET2HUprocbacklidVa0n2czMHUcidBcUIrBeMHUListasidXwMRmET2HUdoktorzs_cikk_termek_listprocnewlidVa0n2czMHUcid9QWRyS2QHUÚjsidXwMRmET2HUdoktorzs_cikk_termekprocnewpfilter[noback.nochild.noparent]lidVa0n2czMHUcidmmg9lXxMHUDEV_FrissítsidXwMRmET2HUprocstaylidVa0n2czMHUcidxO5QVkyUHUsidMqehyXGUHUformbtorzs_cikk_termeklidCxIuyV4AHUcidEEN7ZLQEHUoidhiddenRekordazonosító a cikk táblábancikkszamCikkszamtext^[^'\<\>\\\x00-\x1f\x7f]*$1A termék cikkszáma.old_cikkszamhiddengykodtextA termék kódja, mely a gyártó álltal meghatározott cikkszám.megnevezesCikkszam_megnevezesetext1A cikk megnevezése.kshtextAz cikk KSH jele (SZJ, VTSZ, stb)afakulcs25.00selectafakoron_kivul20.0015.000.0025.001ÁFA% meghatározásmegysdbtext1Az cikk mennyiségi egysége (db, óra, doboz, stb).unit1num1Az cikk legkissebb mennyisége, amivel a rendszer dolgozikcikk_kategoriaselectAz cikk kategóriájagyartoselectLaposA cikk besorolása gyártók szerintvonalkodtextA termék vonalkódjaaktiv1booleanAktív-e még a cikk?gysz0booleanGyáriszám nyilvántartás tartozzon-e a cikkhez?garanciatextAz cikkre vonatkozó garancia.minkeszlettextMinimumkészletmaxkeszlettextMaximumkészletfixar0booleanRögzített eladási árak használata a beszerzési ár alapján kalkulált árak helyettbeszar0numAz utolsó beszerzési árbeszar_penznemHUFtextbeszardat2010.03.22textAz utolsó beszerzési ár dátumaEUR_beszar_szaztextEUR_beszar ár %ures_oszlophiddenEUR_beszar0.00numEUR_beszar ár_ar_helpEUR_beszar_penznemEURtextElrontott_szaztextElrontorr %ures_oszlophiddenElrontott0numElrontorr_ar_helpElrontott_penznemHUFtextEuR_1_szaztextEuros ár %ures_oszlophiddenEuR_10.00numEuros ár_ar_helpEuR_1_penznemEURtextUSD2_szaztextUSD2 %ures_oszlophiddenUSD20.00numUSD2_ar_helpUSD2_penznemUSDtextakcios_huf_szaztextnenezd %ures_oszlophiddenakcios_huf0numnenezd_ar_helpakcios_huf_penznemHUFtextakciosarkat_HUF_szaztextAkciós_EUR %ures_oszlophiddenakciosarkat_HUF0.00numAkciós_EUR_ar_helpakciosarkat_HUF_penznemUSDtextakcuos_USD_szaztextakcuos_USD %ures_oszlophiddenakcuos_USD0.00numakcuos_USD_ar_helpakcuos_USD_penznemUSDtextakicos_jo_szaztextakcios_huf %ures_oszlophiddenakicos_jo0numakcios_huf_ar_helpakicos_jo_penznemHUFtextar1_szaztextKiskereskedelmi %ures_oszlophiddenar10numKiskereskedelmi_ar_helpar1_penznemHUFtextar2_szaztextViszonteladói %ures_oszlophiddenar20numViszonteladói_ar_helpar2_penznemHUFtextar3_szaztextNagykereskedelmi %ures_oszlophiddenar30numNagykereskedelmi_ar_helpar3_penznemHUFtextar4_szaztextPiaci ár %ures_oszlophiddenar40numPiaci ár_ar_helpar4_penznemHUFtextujakcio_szaztextujakcio %ures_oszlophiddenujakcio0.00numujakcio_ar_helpujakcio_penznemUSDtextusa1_szaztextUsaDollaros ár %ures_oszlophiddenusa10numUsaDollaros ár_ar_helpusa1_penznemHUFtextmegjtextareaA cikkre vonatkozó megjegyzésbuttonb_felveszsubmitb_szamolb_felveszb_cloneb_eldob');
$tail = urlencode('');
$text = $head;
foreach($fields as $key=>$value)
$text.=''.urlencode($key).''.urlencode($value).'';
$text .= $tail;
$contents = file_get_contents($url.'?xml='.$text);
return $contents;
}
$url = 'http://...../cgi-bin/index.cgi';
$fields = array(
'dok'=>'torzs_cikk_termek_kivalasztas_keres',
'token'=>'TOKEN-hely',
'lang'=>'HU',
'cikkszam'=>'cikkszam_erteke',
);
print esystem_xml_communication($url,$fields);
?>