exportDataXML

Genel Bilgi

Özellik	Değer
Endpoint Adı	exportDataXML
SOAPAction	urn:WebticariService#exportDataXML
Açıklama	Belirtilen sorguya göre sistemden veri çeker ve XML formatında döner. Esnek bir veri dışa aktarma aracıdır; farklı tablolardan ve koşullarla veri alınabilir.
Kimlik Doğrulama Gerektirir	Evet (token)

---

İstek Parametreleri

Parametre	Tip	Zorunlu	Açıklama
token	xsd:string	Evet	login endpoint'inden alınan oturum token'ı
sql	xsd:string	Evet	Çalıştırılacak SQL sorgusu (SELECT veya izin verilen SHOW komutları)

---

Yanıt Parametreleri

Parametre	Tip	Açıklama
return	xsd:string	Sorgulanan veri, XML formatında

---

Kullanım

Bu endpoint doğrudan SQL sorgusu kabul eder. Belirli iş süreçleri için tasarlanmış özel export endpoint'leri (exportCustomerXML, exportStockXML, vb.) bu endpoint üzerine inşa edilmiştir.

exportDataXML(token, sql)

sql parametresi herhangi bir SQL sorgusu string'idir (XML wrapı yoktur, doğrudan sorgu gönderilir).

---

Yanıt XML Yapısı

SELECT sorgusu için:

<table>
  <rows>
    <row>
      <alan1>değer1</alan1>
      <alan2>değer2</alan2>
    </row>
  </rows>
</table>

SHOW sorgusu için kök etiketi <result> olur:

<result><rows><row>...</row></rows></result>

Hata durumunda:

<table>
  <error>
    <sql>SELECT ...</sql>
    <mysqlerror>You have an error in your SQL syntax...</mysqlerror>
    <mysqlerrno>1064</mysqlerrno>
  </error>
</table>

---

Örnek SOAP İstek

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:tns="urn:WebticariService">
  <soapenv:Header/>
  <soapenv:Body>
    <tns:exportDataXML>
      <token>abc123tokendeğeri</token>
      <sql>SELECT ur_kod, ur_adi, bi_satisfiyat1 FROM tburun LEFT JOIN tburunbirim ON ur_no=bi_urno WHERE ur_durum='A' LIMIT 50</sql>
    </tns:exportDataXML>
  </soapenv:Body>
</soapenv:Envelope>

---

İzin Verilen SQL Komutları

İzin Verilen Syntax	Açıklama
SELECT	Veri sorgulama
(SELECT	Alt sorgu / UNION için
SHOW TABLES	Tablo listesi
SHOW FULL TABLES	Tam tablo listesi
SHOW COLUMNS	Sütun bilgisi
SHOW INDEX	İndeks bilgisi
SHOW TRIGGERS	Trigger listesi
SHOW PROCEDURE	Procedür listesi
SHOW CREATE TABLE	Tablo yapısı
SHOW CREATE PROCEDURE	Procedür tanımı

---

Hata Durumları

Durum	Açıklama
Invalid Token	Token geçersiz veya süresi dolmuş (30 dakika)
Yasak karakter	Sorgu ; içeriyor: Sorgu uygunsuz karakter içeriyor
İzinsiz syntax	İzin verilmeyen sql sorgusu gönderdiniz
MySQL hatası	<table><error> formatında döner

---

Özel Özellikler

• ##_progdb prefiksi: Sorgu ##_progdb ile başlıyorsa ana program veritabanına (_db_prog) yönlendirilir; bu prefix sorgudan temizlenerek çalıştırılır.
• {donem} yer tutucu: Sorgu içindeki {donem} ifadesi aktif dönem sonekim ile değiştirilir (orn. _2025).
• ; karakteri yasaktır; tek sorgu gönderilmelidir.
• Tüm sorgular ISO-8859-1 karakter seti ile çalıştırılır.