OrgService_XSD

XSD:

 

 

A GetPeopleInfo_v2 a modernebb és szigorúbb változata a lekérdezésnek. Ahhoz, hogy tudd, mit kell megadnod, az XSD-ben a minOccurs és use="required" jelzéseket kell figyelned.

Hogyan olvassuk az XSD-t a kötelező mezőkhöz?

1. minOccurs="1": Ez azt jelenti, hogy az elemnek legalább egyszer szerepelnie kell. Ha nincs odaírva semmi, az alapértelmezett érték szintén 1.

2. minOccurs="0": Ez azt jelenti, hogy a mező opcionális (elhagyható).

3. use="required": Ez az attribútumokra vonatkozik (amik a kezdő tag-en belül vannak). Ha ezt látod, az attribútum kötelező.

---

1. GetPeopleInfo_v2 REQUEST (A kérés)

Az XSD-ben a GetPeopleInfo_v2Request típusnál ezeket látjuk:

• context: minOccurs="1" → KÖTELEZŐ

• personIdType: minOccurs="1" → KÖTELEZŐ

• personIds: minOccurs="1" és maxOccurs="unbounded" → KÖTELEZŐ (legalább egyet meg kell adni)

• operationVersion (attribútum): type="pref:operationVersionType" (itt nincs explicit required, de a v2 logikája miatt elvárt).

Példa Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:org="http://organization.types.raiffeisen.hu/OrganizationData"
                  xmlns:com="http://common.types.raiffeisen.hu/common">
   <soapenv:Header/>
   <soapenv:Body>
      <org:GetPeopleInfo_v2Request operationVersion="2.0">
         
         <org:context>
            <com:serviceID>WIKI_READER</com:serviceID>
            <com:requestID>REQ-98765</com:requestID>
         </org:context>
         
         <org:personIdType>AD_USER</org:personIdType>
         
         <org:dataGroup>02</org:dataGroup>
         
         <org:personIds>creznek</org:personIds>
         
      </org:GetPeopleInfo_v2Request>
   </soapenv:Body>
</soapenv:Envelope>

---

2. GetPeopleInfo_v2 RESPONSE (A válasz)

A válasznál az XSD-ben ezek a kötelező elemek:

• context: minOccurs="1" → A válaszban is visszaküldik a hívási környezetet.

• returnCode: minOccurs="1" → Siker/Hiba kódja.

• people: minOccurs="1" → A lista maga (még ha üres is, a tag kell).

• serviceRelease és operationVersion: use="required" → Ezek kötelező attribútumok a válasz fejlécében.

Példa Response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:org="http://organization.types.raiffeisen.hu/OrganizationData">
   <soapenv:Body>
      <org:GetPeopleInfo_v2Response serviceRelease="1.1" operationVersion="2.0">
         
         <org:context>
            </org:context>
         
         <org:returnCode>
            <code>OK</code>
         </org:returnCode>
         
         <org:givenTime>2026-01-06T12:50:00</org:givenTime>
         
         <org:people>
            <org:peopleItem>
               <org:personId>creznek</org:personId>
               
               <org:personDetails>
                  <org:personalData>
                     <org:fullName>Creznek Gábor</org:fullName>
                     <org:firstName>Gábor</org:firstName>
                  </org:personalData>
                  
                  <org:identifiers>
                     <org:ADUserId>creznek</org:ADUserId>
                     <org:workforceId>W12345</org:workforceId>
                  </org:identifiers>
                  
                  <org:contactInfo>
                     <org:email>gabor.creznek@raiffeisen.hu</org:email>
                  </org:contactInfo>
               </org:personDetails>
               
            </org:peopleItem>
         </org:people>
         
      </org:GetPeopleInfo_v2Response>
   </soapenv:Body>
</soapenv:Envelope>

Miért fontos ez neked?

Amikor programozol vagy tesztelsz (pl. SoapUI-ban), ha kihagysz egy olyan mezőt, ahol minOccurs="1" van, a szerver egyből elutasítja a kérést egy "Schema Validation Error" üzenettel, mielőtt még egyáltalán megnézné, ki az a creznek.

A v2-es verzióban látható, hogy a personDetails_v2 belsejében lévő négy fő csoport (personalData, organizationalData, identifiers, contactInfo) mindegyike minOccurs="0". Ez azért van, mert előfordulhat, hogy egy dolgozónak csak a nevét tudjuk, de a telefonszámát vagy a főnökét nem – így a rendszer rugalmas marad.

Mehet ez az összefoglaló is a wikidbe, vagy ránézzünk a getOUMembers-re is, ami hasonló logikával működik, de osztályokra?