====== Краткое пошаговое руководство получению отчётов о информировании абонентов ======

В качестве клиента используем бесплатную программу [[https://www.soapui.org|SOAP UI]], но принцип работы сохраняется и при использовании других продуктов. В том числе и при разработке ПО на .NET ([[https://en.wikipedia.org/wiki/SOAP#History|Microsoft придумала стандарт SOAP]] и их средства как никакие другие подходят для этого). Программа существует под все популярные платформы и не имеет ограничений использования.\\
\\
Руководство по программе можно найти [[https://www.soapui.org/soap-and-wsdl/getting-started.html|на официальном сайте]]\\
\\
В SOAP UI создаём новый проект и в качестве Initial WSDL используем ссылку из [[products:kmis:project_documentation:server|документации]]: [[http://kmis.callbox.biz/?wsdl]]\\
\\
В этот момент SOAP UI (как и библиотека .NET) выгрузит из WSDL все приложения. Их три:
  - //get_report// - получение статистики
  - //notification// - оповещение абонента
  - //upload_audio// - загрузка файла на сервис

Также программа выгрузит все методы для всех приложений. На текущий момент в каждом приложении 1 метод.\\
\\
При переходе к редактированию метода //Request// приложения //get_report// откроется полный текст запроса с комментариями к нему:
<code>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:kmis="kmis.services" xmlns:ser="services.custom_types" xmlns:sch="http://spyne.io/schema">
   <soapenv:Header/>
   <soapenv:Body>
      <kmis:get_report>
         <kmis:request_data>
            <ser:customer_id>?</ser:customer_id>
            <ser:request_ids>
               <!--1 or more repetitions:-->
               <sch:request_id>?</sch:request_id>
            </ser:request_ids>
         </kmis:request_data>
      </kmis:get_report>
   </soapenv:Body>
</soapenv:Envelope>
</code>
Вопросительные знаки требуют ввода данных.\\
\\
Первая строка с вопросительным знаком идентифицирует пользователя системы:
<code><ser:customer_id>?</ser:customer_id></code>
Вместо вопросительного знака необходимо в данную строку подставить UUID, выданный администратором системы. Пример корректного заполнения:
<code><ser:customer_id>394ffb3b-20f5-4046-b6b2-758103698fe7</ser:customer_id></code>
Следующий блок определяет все UUID запросов, по которым необходимо получить информацию.
<code></code>
Пример корректного заполнения блока:
<code>
            <ser:request_ids>
               <!--1 or more repetitions:-->
               <sch:request_id>7a9ef363-1977-437e-b134-cfdffec658f7</sch:request_id>
            </ser:request_ids>
</code>
В ответ на этот запрос сервер сообщит статус этого запроса:
<code>
<soap11env:Envelope xmlns:s0="services.custom_types" xmlns:soap11env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="kmis.services">
   <soap11env:Body>
      <tns:get_reportResponse>
         <tns:get_reportResult>
            <s0:audio_reports>
               <s0:CallReport>
                  <s0:request_id>7a9ef363-1977-437e-b134-cfdffec658f7</s0:request_id>
                  <s0:recipient_phone>7212921006</s0:recipient_phone>
                  <s0:status>success</s0:status>
                  <s0:attempt_count>1</s0:attempt_count>
                  <s0:received_date>2017-08-11T17:22:41.091847+06:00</s0:received_date>
                  <s0:last_attempt>2017-08-13T17:44:58.703631+06:00</s0:last_attempt>
                  <s0:call_duration>14</s0:call_duration>
               </s0:CallReport>
            </s0:audio_reports>
            <s0:ts_reports/>
         </tns:get_reportResult>
      </tns:get_reportResponse>
   </soap11env:Body>
</soap11env:Envelope>
</code>
Разберём ответ по строкам:\\
Первая строка возвращает ID запроса:
<code><s0:request_id>7a9ef363-1977-437e-b134-cfdffec658f7</s0:request_id></code>
Вторая строка возвращает номер абонента, для которого было адресовано это оповещение:
<code><s0:recipient_phone>7212921006</s0:recipient_phone></code>
Третья строка возвращает статус оповещения:
<code><s0:status>success</s0:status></code>
Подробнее статусы описаны [[products:kmis:project_documentation:status|в документации]]\\
Следующая строка показывает количество совершённых попыток:
<code><s0:attempt_count>1</s0:attempt_count></code>
Следующая строка показывает точное время получения запроса на оповещение:
<code><s0:received_date>2017-08-13T17:44:41.091847+06:00</s0:received_date></code>
Сделующая строка показывает точную дату и время последней попытки:
<code><s0:last_attempt>2017-08-13T17:44:58.703631+06:00</s0:last_attempt></code>
Последняя строка показывает общую продолжительность разговора:
<code><s0:call_duration>14</s0:call_duration></code>