Fiddler

Руководство
Средний

Fiddler — это приложение прокси-сервера для регистрации, проверки и изменения трафика HTTP и HTTPS между компьютером и веб-сервером или серверами. Назначение Fiddler — предоставлять разработчикам возможность проверки запросов и ответов, включая HTTP-заголовки и метаданные (например, файлы cookie, кэширование и кодирование информации).

Fiddler рекомендуется использовать для тестирования запросов при интеграции c Creatio по протоколу OData 4 и OData 3.

Этапы работы с запросами в Fiddler:

  • Формирование запроса.
  • Выполнение запроса.

Коллекция запросов позволяет выполнять несколько запросов один за другим. Использование коллекций значительно сокращает время тестирования запросов.

Коллекция запросов к Creatio должна включать:

  1. POST-запрос к сервису аутентификации AuthService.svc. Работа с сервисом аутентификации подробно описана в статье Аутентификация.
  2. Пользовательский запрос для работы с данными.
Смотрите также
Аутентификация
OData
Ресурсы
Официальная документаци Fiddler
Выполнить запрос к Creatio в Fiddler
Средний

Пример. Используя сервис odata, добавить новую активность с колонками:

  • Заголовок (Title) — "Process the incomming website form request".
  • Ответственный (Owner) — [Id] текущего пользователя.
  • Заметки (Notes)— "Please, email to client@gmail.com and process the following request: clients request".

1. Сформировать запрос 

Для формирования запроса на добавление данных в Fiddler:

  1. Создайте новый запрос, нажав кнопку New Request.

  2. В выпадающем списке панели инструментов рабочей области Fiddler выберите метод запроса POST.

  3. В поле запроса панели инструментов рабочей области Fiddler введите строку запроса:

    Пример строки запроса
    http(s)://mycreatio.com/0/odata/Activity/
  4. Выберите версию 1.1 протокола HTTP.

  5. Перейдите на вкладку Headers и заполните заголовки запроса:

    • Content-Type : application/json.
    • Accept : application/json.
    • Cookie: BPMLOADER, .ASPXAUTH, BPMSESSIONID и BPMCSRF — cookie получены из запроса к сервису аутентификации.
    • BPMCSRF: "CSRF-токен BPMCSRF" — содержит значение одноименной cookie.
    Пример HTTP-заголовка запроса
    Accept:application/json
Content-Type:application/json
Cookie: BPMSESSIONID=cxa54p2dsb4wnqbbzvgyxcoo; BPMCSRF=6yCmyILSlIE8/toyQm9Ca.; BPMLOADER=rqqjjeqyfaudfyk4xu404j5f; .ASPXAUTH=697...A292D8164;
BPMCSRF: 6yCmyILSlIE8/toyQm9Ca.

  6. Перейдите на вкладку Body и заполните тело запроса.

    Пример тела запроса
    {
  "Title": "Process the incomming website form request",
  "Notes": "Please, email to client@gmail.com and process the following request: clients request",
  "OwnerId": "c4ed336c-3e9b-40fe-8b82-5632476472b4"
}

    Для справочной колонки в запросе необходимо к названию колонки добавить суффикс Id. В качестве значения указать идентификатор из таблицы базы данных. В приведенном примере используется справочная колонка Ответственный (Owner), для которой в запросе указывается идентификатор OwnerId. Значение идентификатора ответственного можно посмотреть в браузере, открыв соответствующую страницу контакта.

2. Выполнить запрос 

Чтобы выполнить запрос в Fiddler, на панели инструментов рабочей области нажмите кнопку Execute.

Результат выполнения 

В результате выполнения запроса:

  • В блоке Response отобразится код состояния ответа. На вкладке Body отобразится ответ от сервиса odata.

    В теле ответа содержится добавленная запись в формате JSON. Элемент "Id" содержит идентификатор добавленной активности, который можно использовать при составлении других запросов, например, на редактирование.

  • В раздел Активности (Activities) будет добавлена новая запись.