====== Краткое пошаговое руководство по работе с сервисом загрузки аудио-файлов ======

Данный сервис разработан для того, чтобы загружать аудио-файлы для последующего проигрывания абонентам.\\
\\
В качестве клиента используем бесплатную программу [[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 (как и библиотека .NET) выгрузит из WSDL все приложения. Их три:
  - get_report - получение статистики
  - notification - оповещение абонента
  - upload_audio - загрузка файла на сервис
Нас интересует метод upload_audio. При переходе к редактированию метода Request приложения upload_audio откроется полный текст запроса с комментариями к нему: 
<code>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:kmis="kmis.services">
   <soapenv:Header/>
   <soapenv:Body>
      <kmis:upload_audio>
         <!--Optional:-->
         <kmis:a_file>cid:1047733175167</kmis:a_file>
         <kmis:customer_id>?</kmis:customer_id>
      </kmis:upload_audio>
   </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>
Подробно передача файлов на сервер через программу SoapUI описана на официальном сайте:\\
[[https://www.soapui.org/resources/blog/working-with-ws-attachments-and-inline-files.html|Документация по передаче файлов в запросе SOAP UI]]\\
[[https://www.soapui.org/soap-and-wsdl/headers-and-attachments.html|Докуменатция по формированию заголовков в запросе SOAP UI]]\\
\\
Для загрузки файла требуется заполнение двух блоков в интерфейсе: Headers для передачи корректного заголовка запроса и Attachment для непосредственной передачи файла.\\
Для создания корректного заголовка запроса необходимо внизу окна нажать на вкладку Headers. Откроется окно создания заголовка:\\
{{:servers:kmis:headers.jpg?direct&400|}}\\
При нажатии символа + откроется диалог создания заголовка, куда необходимо ввести тег //content-type// и нажать Ок. Далее двойным кликом по полю //Value// созданного заголовка переходим к его редактированию вводим //audio/x-wav//\\
{{:servers:kmis:headers-2.jpg?direct&400|}}\\
Далее необходимо приложить файл к запросу перейдя на вкладку Attachment:\\
{{:servers:kmis:attachment.jpg?direct&400|}}\\
При нажатии + откроется стандартный диалог выбора и загрузки файла. После выбора файла система запросит подтверждение на кеширование файла в запросе, необходимо нажать Yes.\\
Далее необходимо в строке с именем файла двойным кликом перейти к редактированию столбца Part и выбрать из списка цифровую комбинацию, указанную в строке
<code><kmis:a_file>cid:1047733175167</kmis:a_file></code>
При этом значение поля Type сменится на CONTENT.Пример корректного заполнения:\\
{{:servers:kmis:attachment2.jpg?direct&400|}}\\
После этого запрос можно выполнить. Система сохранит файл в хранилице и вернёт UUID который можно будет использовать в дальнейшем для проигрывания этого файла абонентам.
<code>
<soap11env:Envelope xmlns:soap11env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="kmis.services">
   <soap11env:Body>
      <tns:upload_audioResponse>
         <tns:upload_audioResult>c9006b99-4cad-488d-9c09-1a73696fa11a</tns:upload_audioResult>
      </tns:upload_audioResponse>
   </soap11env:Body>
</soap11env:Envelope>
</code>