Инструменты пользователя

Инструменты сайта


profitgroup:projects:kmis:upload_audio

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

Данный сервис разработан для того, чтобы загружать аудио-файлы для последующего проигрывания абонентам.

В качестве клиента используем бесплатную программу SOAP UI, но принцип работы сохраняется и при использовании других продуктов. В том числе и при разработке ПО на .NET (Microsoft придумала стандарт SOAP и их средства как никакие другие подходят для этого). Программа существует под все популярные платформы и не имеет ограничений использования.

Руководство по программе можно найти на официальном сайте

В этот момент SOAP UI (как и библиотека .NET) выгрузит из WSDL все приложения. Их три:

  1. get_report - получение статистики
  2. notification - оповещение абонента
  3. upload_audio - загрузка файла на сервис

Нас интересует метод upload_audio. При переходе к редактированию метода Request приложения upload_audio откроется полный текст запроса с комментариями к нему:

<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>

Вопросительные знаки требуют ввода данных. Далее необходимо построчно заполнить данный запрос.
Первая строка идентифицирует имя файла, которое будет загружаться в систему. Её заполнение рассмотрим ниже. Вторая строка с вопросительным знаком идентифицирует пользователя системы:

<ser:customer_id>?</ser:customer_id>

Вместо вопросительного знака необходимо в данную строку подставить UUID, выданный администратором системы. Пример корректного заполнения:

<ser:customer_id>394ffb3b-20f5-4046-b6b2-758103698fe7</ser:customer_id>

Подробно передача файлов на сервер через программу SoapUI описана на официальном сайте:
Документация по передаче файлов в запросе SOAP UI
Докуменатция по формированию заголовков в запросе SOAP UI

Для загрузки файла требуется заполнение двух блоков в интерфейсе: Headers для передачи корректного заголовка запроса и Attachment для непосредственной передачи файла.
Для создания корректного заголовка запроса необходимо внизу окна нажать на вкладку Headers. Откроется окно создания заголовка:

При нажатии символа + откроется диалог создания заголовка, куда необходимо ввести тег content-type и нажать Ок. Далее двойным кликом по полю Value созданного заголовка переходим к его редактированию вводим audio/x-wav

Далее необходимо приложить файл к запросу перейдя на вкладку Attachment:

При нажатии + откроется стандартный диалог выбора и загрузки файла. После выбора файла система запросит подтверждение на кеширование файла в запросе, необходимо нажать Yes.
Далее необходимо в строке с именем файла двойным кликом перейти к редактированию столбца Part и выбрать из списка цифровую комбинацию, указанную в строке

<kmis:a_file>cid:1047733175167</kmis:a_file>

При этом значение поля Type сменится на CONTENT.Пример корректного заполнения:

После этого запрос можно выполнить. Система сохранит файл в хранилице и вернёт UUID который можно будет использовать в дальнейшем для проигрывания этого файла абонентам.

<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>
profitgroup/projects/kmis/upload_audio.txt · Последнее изменение: 2018/09/11 19:55 — 127.0.0.1