A szappankérés szerkezete

A fenti kódban a SoapAction HTTP fejléc mező értéke annak a módszernek a neve, amely előtt a névtér követi. Ez az érték ugyanaz a módszer és névtér, mint a CREATE ENDPOINT utasítással létrehozott végponthoz hozzáadott névtér. Megjegyzendő, hogy a mező kitöltése opcionális. A HTTP Host fejléc mező megadja azt a kiszolgálót, amelyre a HTTP kérést küldi.

A SOAP kérelemre vonatkozó információ szerepel az elemben boríték SOAP. Az előző példában a GetCustomerInfo módszerre van szükség. Az xmlns attribútum itt: Megegyezik a CREATE ENDPOINT utasítással létrehozott végfelhasználási módban megadott névtér. A tárolt eljárásokról és névterekről további információt a Külső lekérdezések mintaalkalmazásokhoz a natív XML webszolgáltatásokhoz című témakörben talál. Az alábbi módszerek paraméterek kerülnek gyermekelemekként .

elem az 1-es érték a bemeneti paraméter.

elem A kimeneti paraméter.

Feldolgozási bemeneti paraméterek

A bemeneti paraméterek a következő módon kerülnek feldolgozásra.

Ha a SOAP módszerhez olyan bemeneti paraméter szükséges, amely nem szerepel a SOAP kérésben, az értékek nem kerülnek továbbításra a tárolt eljáráshoz. A tárolt eljárásban megadott alapértelmezett művelet végrehajtásra kerül.

Ha a SOAP módszerhez olyan bemeneti paraméter szükséges, amely szerepel a lekérdezésben, de nincs hozzárendelve egy értékhez, ezt a paramétert átadja a tárolt eljárásnak, üres karakterláncként értékként. Megjegyzendő, hogy ez az érték nem NULL.

Ha a SOAP művelethez bemeneti paraméter szükséges, és azt NULL-ra kell állítani, akkor a SOAP kérésben be kell állítania az xsi: nil attribútumot "true" értékre. Például:

Több szempontot is megadhat. A szakasz további részében egy olyan táblázat található, amely számos, a szabályozatlan SQL lekérdezések végrehajtása során megadható szempontot tartalmaz. Ebben a táblázatban minden olyan szempont, amelyet egy csomópont számára beállíthat , meghatározható az RPC-módszerek paramétercsomópontjaiban.

Ha SOAP kérést küld egy ad hoc SQL lekérdezéshez, hívja az sqlbatch módszert, és adja át a kéréseket és az összes szükséges paramétert.

A következő mintában a HTTP SOAP kérelem az sqlbatch módszert hívja. Vegye figyelembe, hogy csak a HTTP fejléctöredék jelenik meg.

Meg kell jegyeznünk, hogy a HTTP fejléc mező SoapAction értéke az SQL lekérdezések meghatározására használt módszer (sqlbatch) neve. Meg kell jegyezni, hogy ez a fejléc opcionális.

A SOAP kérelemre vonatkozó információ megjelenik az elemben . SOAP elem csak egy gyermekelem van ( ), amely meghatározza a kért módszert. Az elemben megadott névtér azon négyzethez tartozik, ahol az sqlbatch műveletet definiálják. Ez az elem a következő gyermekelemekkel rendelkezik.

elem Egy vagy több végrehajtható lekérdezést határoz meg, pontosvesszővel elválasztva (;).

elem opcionális paraméterlista található. Az előző példában a kérelem borítékában csak egy paraméter kerül átadásra a lekérdezésre. Minden paraméter hozzáadódik a SOAP üzenethez gyermekelemekként elem . A küldéskor meg kell adnia legalább a paraméter nevét (az elem Név attribútuma ) és a paraméter értéke (a gyermekelem elem ).

A váratlan változások elkerülése érdekében adja meg a legpontosabb információkat a paraméterekről. A következő táblázat felsorolja azokat a paramétereket, amelyeket egy elemhez megadhat . Egyes elemek is beállíthatók egy elemhez .