Как изучить типы данных SOAP?

Никогда раньше не работавший с SOAP, теперь я пытаюсь следовать этому руководству, чтобы узнать о сервисе SOAP государственного земельного реестра Нидерландов (kadaster.nl):

>>> from SOAPpy import WSDL
>>> server = WSDL.Proxy('http://www1.kadaster.nl/1/schemas/kik-inzage/20141101/verzoekTotInformatie-2.1.wsdl')
/Library/Python/2.7/site-packages/wstools/XMLSchema.py:1280: UserWarning: annotation is ignored
  warnings.warn('annotation is ignored')
/Library/Python/2.7/site-packages/wstools/XMLSchema.py:1217: UserWarning: Not keeping schema component.
  warnings.warn("Not keeping schema component.")
>>> server.methods.keys()
[u'VerzoekTotInformatie']
>>> callInfo = server.methods['VerzoekTotInformatie']
>>> callInfo.inparams[0].name
u'body'
>>> callInfo.inparams[0].type
(u'http://www.kadaster.nl/schemas/kik-inzage/20141101', u'VerzoekTotInformatieRequest')

Итак, теперь я понимаю, что мне нужно вызвать метод VerzoekTotInformatie (что переводится как RequestForInformation) с сообщением типа VerzoekTotInformatieRequest.

Но отсюда я немного потерялся. Как построить такой VerzoekTotInformatieRequest? Как я могу глубже погрузиться в это VerzoekTotInformatieRequest?

Буду очень признателен за любые советы о том, как действовать отсюда.

пс. Если мне придется использовать другую библиотеку (но я предпочитаю Python), это тоже нормально. Я читал хорошие отзывы о suds, но так как у него не было коммита более 3 лет я считал его заброшенным. Я также попробовал pysimplesoap, который кажется хорошим, но я не знал, как использовать его для самоанализа службы SOAP.


python soap soap-client soappy pysimplesoap
person kramer65    schedule 24.04.2015    source источник

Ответы (1)


arrow_upward
3
arrow_downward

Ваши наблюдения на этот счет верны. Но я бы сначала изучил WSDL с помощью клиентского инструмента SOAP, чтобы понять его структуру и ссылки. Когда вы посмотрите на WSDL, обратите внимание, как типы определены в схеме, на которую ссылаются, .xsd с именем verzoekTotInformatie-2.1.xsd. Затем эта схема ссылается и включает 20 других файлов схемы:

Изображение в высоком разрешении — нажмите здесь.

введите здесь описание изображения

Очевидно, что в вашем случае становится кошмаром следить за всем, просто читая себя (WSDL в любом случае не предназначен для чтения человеком, но ваш очень, очень вложен).

Поэтому я предлагаю вам импортировать этот WSDL в интерфейс SOAP (это бесплатно, это то, что я используется на снимке экрана выше) и создайте новый проект, используя URL-адрес WSDL:

http://www1.kadaster.nl/1/schemas/kik-inzage/20141101/verzoekTotInformatie-2.1.wsdl

Он импортирует все и создаст для вас образец запроса. Для меня он даже попытался добавить некоторые образцы данных lorem-ipsum на основе типов полей:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.kadaster.nl/schemas/kik-inzage/20141101" xmlns:v20="http://www.kadaster.nl/schemas/kik-inzage/ip-aanvraag/v20141101">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:VerzoekTotInformatieRequest>
         <v20:Aanvraag>
            <v20:berichtversie>4.7</v20:berichtversie>
            <v20:klantReferentie>cum murmure</v20:klantReferentie>
            <v20:productAanduiding>aeoliam venit</v20:productAanduiding>
            <!--Optional:-->
            <v20:Gebruiker>
               <v20:identificatie>ventos tempestatesqu</v20:identificatie>
            </v20:Gebruiker>
            <v20:Ingang>
               <!--You have a CHOICE of the next 3 items at this level-->
               <v20:Object>
                  <!--You have a CHOICE of the next 2 items at this level-->
                  <v20:IMKAD_OZLocatie>
                     <v20:adres>
                        <v20:BAG_NummerAanduiding>
                           <v20:postcode>temper</v20:postcode>
                           <v20:huisnummer>turbine corripuit</v20:huisnummer>
                           <!--Optional:-->
                           <v20:huisletter>r</v20:huisletter>
                           <!--Optional:-->
                           <v20:huisnummertoevoeging>frem</v20:huisnummertoevoeging>
                        </v20:BAG_NummerAanduiding>
                     </v20:adres>
                     <!--Optional:-->
                     <v20:bijOfTegenover>ferant rapidi</v20:bijOfTegenover>
                  </v20:IMKAD_OZLocatie>
                  <v20:IMKAD_KadastraleAanduiding>
                     <!--Optional:-->
                     <v20:gemeente>sceptra tenens</v20:gemeente>
                     <v20:sectie>turbine corripuit scopuloque</v20:sectie>
                     <v20:perceelnummer>flamm</v20:perceelnummer>
                     <!--Optional:-->
                     <v20:appartementsindex>prof</v20:appartementsindex>
                     <!--Optional:-->
                     <v20:deelperceelnummer>nubi</v20:deelperceelnummer>
                     <!--Optional:-->
                     <v20:AKRKadastraleGemeenteCode>ac vi</v20:AKRKadastraleGemeenteCode>
                  </v20:IMKAD_KadastraleAanduiding>
               </v20:Object>
               <v20:PersoonsIngang>
                  <v20:Persoon>
                     <!--You have a CHOICE of the next 4 items at this level-->
                     <v20:BSN>100</v20:BSN>
                     <!--Optional:-->
                     <v20:KVKNummer>rapidum</v20:KVKNummer>
                     <!--Optional:-->
                     <v20:RSIN>caelumque</v20:RSIN>
                     <v20:kadastraleIdentificatie>100</v20:kadastraleIdentificatie>
                  </v20:Persoon>
                  <!--Optional:-->
                  <v20:Restrictie>
                     <v20:maximumAantalObjecten>100</v20:maximumAantalObjecten>
                  </v20:Restrictie>
               </v20:PersoonsIngang>
               <v20:Brondocument>
                  <v20:IMKAD_DeelEnNummer>
                     <v20:deel>circu</v20:deel>
                     <v20:nummer>coniu</v20:nummer>
                     <!--Optional:-->
                     <v20:reeks>arce sceptra</v20:reeks>
                     <v20:ipa_registerCodeSub>circum claustra fremunt</v20:ipa_registerCodeSub>
                  </v20:IMKAD_DeelEnNummer>
               </v20:Brondocument>
            </v20:Ingang>
         </v20:Aanvraag>
      </ns:VerzoekTotInformatieRequest>
   </soapenv:Body>
</soapenv:Envelope>

После того, как все будет импортировано, вы можете развернуть проект, а затем щелкнуть правой кнопкой мыши привязку VezorekToInformatieBinding и выбрать Show Interface Viewer, чтобы изучить любые типы (включая запрос), необходимые для дальнейшего анализа, которые определены в схемах, на которые ссылаются.

Имея полное определение в вашем распоряжении, будет гораздо легче проводить самоанализ. В вашем случае должна быть возможность импортировать WSDL и сначала «расширить» все включения/ссылки, а затем начать самоанализ, когда у вас будет вся картина. Если такой опции нет, вам, возможно, придется следовать ссылкам и включать одну за другой.

Надеюсь, это поможет в качестве отправной точки. Удачи!

person Plamen Petrov    schedule 24.04.2015
comment
Это круто! Ваш ответ намного лучше, чем я надеялся! Бесконечно благодарен! - person kramer65; 24.04.2015
comment
Привет @PlamenPetrov. После потрясающей помощи, которую вы мне дали по моему вопросу здесь, я столкнулся с проблемой с возвращенным xml, создающим TypeError в pysimplesoap (TypeError: Tag: IMKAD_Perceel invalid (type not found)). Я создал новый вопрос об этом здесь: stackoverflow.com/ вопросы/30258321/ . Возможно, вы знаете что-нибудь о том, как исправить эту ошибку типа? - person kramer65; 15.05.2015
comment
@kramer65 Привет! Я посмотрел, но, к сожалению, я понятия не имею, почему это происходит. Это очень специфично - может быть какое-то несоответствие между wsdl и ответом. Извините, что не могу помочь. - person Plamen Petrov; 15.05.2015