OrgService WSDL-magyarázat

<?xml version="1.0" encoding="UTF-8"?>

<wsdl:definitions

name="OrganizationServices"

xmlns:pref="http://common.types.raiffeisen.hu/common"

xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

xmlns:tns="http://organization.raiffeisen.hu/Organization"

xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:typ="http://organization.types.raiffeisen.hu/OrganizationData"

targetNamespace="http://organization.raiffeisen.hu/Organization">

<wsdl:types>

<xsd:schema

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

targetNamespace="http://organization.types.raiffeisen.hu/OrganizationData"

xmlns:typ="http://organization.types.raiffeisen.hu/OrganizationData" >

<xsd:include schemaLocation="../types/organization/OrganizationData.xsd"/>

</xsd:schema>

</wsdl:types>

<wsdl:import location="../types/common/common.xsd" namespace="http://common.types.raiffeisen.hu/common"></wsdl:import>

<wsdl:message name="GetOUInfoRequestMsg">

<wsdl:part name="getOUInfoRequestPart" element="typ:GetOUInfoRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetOUInfoResponseMsg">

<wsdl:part name="getOUInfoResponsePart" element="typ:GetOUInfoResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="SearchOURequestMsg">

<wsdl:part name="searchOURequestPart" element="typ:SearchOURequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="SearchOUResponseMsg">

<wsdl:part name="searchOUResponsePart" element="typ:SearchOUResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetOUHierarchyRequestMsg">

<wsdl:part name="getOUHierarchyRequestPart" element="typ:GetOUHierarchyRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetOUHierarchyResponseMsg">

<wsdl:part name="getOUHierarchyResponsePart" element="typ:GetOUHierarchyResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetOUMembersRequestMsg">

<wsdl:part name="getOUMembersRequestPart" element="typ:GetOUMembersRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetOUMembersResponseMsg">

<wsdl:part name="getOUMembersResponsePart" element="typ:GetOUMembersResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetPersonInfoRequestMsg">

<wsdl:part name="getPersonInfoRequestPart" element="typ:GetPersonInfoRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetPersonInfoResponseMsg">

<wsdl:part name="getPersonInfoResponsePart" element="typ:GetPersonInfoResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetPersonGroupsRequestMsg">

<wsdl:part name="getPersonGroupsRequestPart" element="typ:GetPersonGroupsRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetPersonGroupsResponseMsg">

<wsdl:part name="getPersonGroupsResponsePart" element="typ:GetPersonGroupsResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="searchPersonRequestMsg">

<wsdl:part name="searchPersonRequestPart" element="typ:SearchPersonRequest">

</wsdl:part>

</wsdl:message>

<wsdl:message name="searchPersonResponseMsg">

<wsdl:part name="searchPersonResponsePart" element="typ:SearchPersonResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="GetPeopleInfoRequestMsg">

<wsdl:part name="getPeopleInfoRequestPart" element="typ:GetPeopleInfoRequest"></wsdl:part>

</wsdl:message>

<wsdl:message name="GetPeopleInfoResponseMsg">

<wsdl:part name="getPeopleInfoResponsePart" element="typ:GetPeopleInfoResponse"></wsdl:part>

</wsdl:message>

<wsdl:message name="GetPeopleInfo_v2RequestMsg">

<wsdl:part name="getPeopleInfo_v2RequestPart" element="typ:GetPeopleInfo_v2Request"></wsdl:part>

</wsdl:message>

<wsdl:message name="GetPeopleInfo_v2ResponseMsg">

<wsdl:part name="getPeopleInfo_v2ResponsePart" element="typ:GetPeopleInfo_v2Response"></wsdl:part>

</wsdl:message>

<wsdl:message name="InvalidRequestFaultMsg">

<wsdl:part name="faultPart" element="pref:InvalidRequestFault">

</wsdl:part>

</wsdl:message>

<wsdl:message name="OUNotFoundFaultMsg">

<wsdl:part name="faultPart" element="pref:BONotFoundFault">

</wsdl:part>

</wsdl:message>

<wsdl:message name="PersonNotFoundFaultMsg">

<wsdl:part name="faultPart" element="pref:BONotFoundFault">

</wsdl:part>

</wsdl:message>

<wsdl:message name="BackendNotAvailableFaultMsg">

<wsdl:part name="faultPart" element="pref:BackendNotAvailableFault">

</wsdl:part>

</wsdl:message>

<wsdl:message name="InconsistentDataFaultMsg">

<wsdl:part name="faultPart" element="pref:InconsistentDataFault">

</wsdl:part>

</wsdl:message>

<wsdl:message name="TooManyResultsFaultMsg">

<wsdl:part name="faultPart" element="pref:TooManyResultFault">

</wsdl:part>

</wsdl:message>

<wsdl:portType name="OrganizationServices">

<wsdl:operation name="getOUInfo">

<wsdl:input message="tns:GetOUInfoRequestMsg" name="getOUInfoRequest"/>

<wsdl:output message="tns:GetOUInfoResponseMsg" name="getOUInfoResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:OUNotFoundFaultMsg" name="ouNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="searchOU">

<wsdl:input message="tns:SearchOURequestMsg" name="searchOURequest"/>

<wsdl:output message="tns:SearchOUResponseMsg" name="searchOUResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:OUNotFoundFaultMsg" name="ouNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="getOUHierarchy">

<wsdl:input message="tns:GetOUHierarchyRequestMsg" name="getOUHierarchyRequest"/>

<wsdl:output message="tns:GetOUHierarchyResponseMsg" name="getOUHierarchyResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:OUNotFoundFaultMsg" name="ouNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="getOUMembers">

<wsdl:input message="tns:GetOUMembersRequestMsg" name="getOUMembersRequest"/>

<wsdl:output message="tns:GetOUMembersResponseMsg" name="getOUMembersResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:OUNotFoundFaultMsg" name="ouNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="getPersonInfo">

<wsdl:input message="tns:GetPersonInfoRequestMsg" name="getPersonInfoRequest"/>

<wsdl:output message="tns:GetPersonInfoResponseMsg" name="getPersonInfoResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:PersonNotFoundFaultMsg" name="personNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="getPersonGroups">

<wsdl:input message="tns:GetPersonGroupsRequestMsg" name="getPersonGroupsRequest"/>

<wsdl:output message="tns:GetPersonGroupsResponseMsg" name="getPersonGroupsResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:PersonNotFoundFaultMsg" name="personNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

</wsdl:operation>

<wsdl:operation name="searchPerson">

<wsdl:input message="tns:searchPersonRequestMsg" name="searchPersonRequest"/>

<wsdl:output message="tns:searchPersonResponseMsg" name="searchPersonResponse"/>

<wsdl:fault message="tns:InvalidRequestFaultMsg" name="invalidRequestFault"/>

<wsdl:fault message="tns:PersonNotFoundFaultMsg" name="personNotFoundFault"/>

<wsdl:fault message="tns:BackendNotAvailableFaultMsg" name="backendNotAvailableFault"/>

<wsdl:fault message="tns:InconsistentDataFaultMsg" name="inconsistentDataFault"/>

<wsdl:fault message="tns:TooManyResultsFaultMsg" name="tooManyResultsFault"/>

</wsdl:operation>

<wsdl:operation name="getPeopleInfo">

<wsdl:input message="tns:GetPeopleInfoRequestMsg" name="getPeopleInfoRequest"/>

<wsdl:output message="tns:GetPeopleInfoResponseMsg" name="getPeopleInfoResponse"/>

<wsdl:fault name="invalidRequestFault" message="tns:InvalidRequestFaultMsg"/>

<wsdl:fault name="inconsistentDataFault" message="tns:InconsistentDataFaultMsg"/>

<wsdl:fault name="backendNotAvailableFault" message="tns:BackendNotAvailableFaultMsg"/>

<wsdl:fault name="personNotFoundFault" message="tns:PersonNotFoundFaultMsg"/>

</wsdl:operation>

<wsdl:operation name="getPeopleInfo_v2">

<wsdl:input message="tns:GetPeopleInfo_v2RequestMsg" name="getPeopleInfo_v2Request"/>

<wsdl:output message="tns:GetPeopleInfo_v2ResponseMsg" name="getPeopleInfo_v2Response"/>

<wsdl:fault name="invalidRequestFault" message="tns:InvalidRequestFaultMsg"/>

<wsdl:fault name="inconsistentDataFault" message="tns:InconsistentDataFaultMsg"/>

<wsdl:fault name="backendNotAvailableFault" message="tns:BackendNotAvailableFaultMsg"/>

<wsdl:fault name="personNotFoundFault" message="tns:PersonNotFoundFaultMsg"/>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="SoapBinding" type="tns:OrganizationServices">

<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

<wsdl:operation name="getOUInfo">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getOUInfo"/>

<wsdl:input name="getOUInfoRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getOUInfoResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="ouNotFoundFault">

<soap:fault name="ouNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="searchOU">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/searchOU"/>

<wsdl:input name="searchOURequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="searchOUResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="ouNotFoundFault">

<soap:fault name="ouNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getOUHierarchy">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getOUHierarchy"/>

<wsdl:input name="getOUHierarchyRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getOUHierarchyResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="ouNotFoundFault">

<soap:fault name="ouNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getOUMembers">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getOUMembers"/>

<wsdl:input name="getOUMembersRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getOUMembersResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="ouNotFoundFault">

<soap:fault name="ouNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getPersonInfo">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getPersonInfo"/>

<wsdl:input name="getPersonInfoRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getPersonInfoResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="personNotFoundFault">

<soap:fault name="personNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getPersonGroups">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getPersonRoles"/>

<wsdl:input name="getPersonGroupsRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getPersonGroupsResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="personNotFoundFault">

<soap:fault name="personNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="searchPerson">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/searchPerson"/>

<wsdl:input name="searchPersonRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="searchPersonResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="personNotFoundFault">

<soap:fault name="personNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="tooManyResultsFault">

<soap:fault name="tooManyResultsFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getPeopleInfo">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getPeopleInfo"/>

<wsdl:input name="getPeopleInfoRequest">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getPeopleInfoResponse">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="personNotFoundFault">

<soap:fault name="personNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

<wsdl:operation name="getPeopleInfo_v2">

<soap:operation soapAction="http://organization.raiffeisen.hu/Organization/getPeopleInfo_v2"/>

<wsdl:input name="getPeopleInfo_v2Request">

<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="getPeopleInfo_v2Response">

<soap:body use="literal"/>

</wsdl:output>

<wsdl:fault name="invalidRequestFault">

<soap:fault name="invalidRequestFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="personNotFoundFault">

<soap:fault name="personNotFoundFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="inconsistentDataFault">

<soap:fault name="inconsistentDataFault" use="literal"/>

</wsdl:fault>

<wsdl:fault name="backendNotAvailableFault">

<soap:fault name="backendNotAvailableFault" use="literal"/>

</wsdl:fault>

</wsdl:operation>

</wsdl:binding>

<wsdl:service name="OrganizationService">

<wsdl:port binding="tns:SoapBinding" name="SoapPort">

<soap:address location="http://was6dev1.develop.raiffeisen.hu:9080/OrganizationServicesRouter/services/SoapPort"/>

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

Leírása:

Ez egy izgalmas és technikai szöveg, de ha lehántjuk róla az informatikai sallangot, egy nagyon logikus rendszert látunk.

Képzeld el a WSDL fájlt úgy, mint egy éttermi étlapot és egy használati utasítást egyben. Leírja, mit rendelhetsz a bank (Raiffeisen) rendszerétől, hogyan kell azt kérned, és mit fogsz kapni válaszul.

Itt van a magyarázat közérthető nyelven:

1. Mi ez az egész? (A nagy kép)

Ez a konkrét fájl az "OrganizationServices", azaz a Szervezeti Szolgáltatások. Arra való, hogy a bank belső rendszerei (vagy engedélyezett külső programok) lekérdezhessék:

Ki dolgozik a bankban?
Milyen osztályok (szervezeti egységek) vannak?
Ki kinek a főnöke?
Milyen jogosultságai vannak egy adott embernek?

2. A fájl felépítése – Mit látunk a sorok között?

A) Az "Import" rész (Az elején)

Itt a program azt mondja: "Hé, a pontos definíciókat (hogy mi számít névnek, mi számít dátumnak) egy másik fájlban találod." Olyan ez, mint egy szakácskönyv elején a hivatkozás: "A rántás készítését lásd a 12. oldalon."

B) "Messages" – A borítékok

A wsdl:message részek írják le, hogyan nézzenek ki a "levelek". Mindennek van egy Request (Kérés) és egy Response (Válasz) párja.

Kérés: Amit te küldesz a banknak (pl. "Kérem Kovács János adatait").
Válasz: Amit a bank visszaküld (pl. "Kovács János, hitelezési osztály, budapesti iroda").

C) "PortType" és "Operation" – Az étlap

Ez a legfontosabb rész egy ember számára. Itt sorolják fel, milyen műveleteket végezhetünk. Íme a legfontosabbak lefordítva:

getOUInfo: Adott szervezeti egységről (osztályról) kér információt.
searchOU: Osztályok közötti keresés (pl. "Melyik osztály foglalkozik lakáshitellel?").
getOUHierarchy: Ki mutatja meg a "családfát" (melyik igazgatóság alá melyik főosztály tartozik).
getOUMembers: Kik dolgoznak az adott osztályon?
getPersonInfo: Egy konkrét személy adatait adja ki (név, telefon, e-mail).
getPersonGroups: Milyen csoportoknak (pl. "adminisztrátorok", "fiókvezetők") a tagja az illető.

D) "Fault messages" – Amikor porszem kerül a gépezetbe

A WSDL előre felkészül a hibákra is. Ha rossz kódot küldesz, a rendszer ezeket a hibaüzeneteket dobja vissza:

OUNotFoundFault: Nem találom ezt az osztályt.
PersonNotFoundFault: Nincs ilyen nevű dolgozó.
BackendNotAvailable: Sajnálom, a központi adatbázis épp nem elérhető.

E) "Binding" és "Service" – A szállítási mód

Itt dől el, hogyan "utazik" az adat. Ebben a fájlban a SOAP protokollt használják, ami olyan, mint az ajánlott levél: lassabb, de nagyon precíz és biztonságos. A legvégén (a soap:address résznél) látszik a cím, ahová a kérést küldeni kell (egy konkrét webcím a Raiffeisen hálózatán belül).

3. Hogyan néz ki ez a gyakorlatban? (Példa)

Tegyük fel, hogy a banknál egy új szoftvert fejlesztenek, amibe be kell lépnie egy dolgozónak. A szoftver a következőképpen használja ezt a WSDL-t:

A program megnézi az étlapot: "Aha, van egy getPersonInfo művelet."
Összeállít egy digitális levelet (Request): "Kedves Szervezeti Szolgáltatás! Küldöm az 'U12345' azonosítót, kérlek, add meg az adatait!"
A rendszer megkapja, kikeresi, és visszaküldi a választ (Response): "Íme: Az illető Nagy Éva, a Győri fiókban dolgozik."
Ha a program véletlenül 'U99999'-et ír, ami nem létezik, a rendszer a WSDL-ben leírt PersonNotFoundFault hibaüzenettel válaszol: "Sajnálom, ilyen azonosító nincs."

Összegezve:

Ez a fájl egy szabálygyűjtemény. Biztosítja, hogy két teljesen különböző számítógépes program (például egy mobilapp és a bank központi szervere) félreértések nélkül tudjon beszélni egymással a banki dolgozók és az irodák adatairól. Olyan, mint egy szótár és protokollkönyv keveréke.