В этой статье вы узнаете про новый способ передачи данных из формы на удаленный URL адрес - Вебхук. С помощью вебхука можно обмениваться информацией со сторонними ресурсами. Например, сделать вызов своего отдельного URL-адреса или переслать на этот адрес данные из формы. 

Вебхуки позволяют интегрировать рабочие процессы между системами/сервисами/приложениями (включая вызовы между различными проектами внутри системы QuintaDB). Это отличное подспорье для организации бизнес-процессов и мы уверены, что вы найдете множество способов воспользоваться преимуществами вебхуков.

Содержание:

• Применение Вебхуков через поле "Действие"
  • Создание задачи
  • Настройки вебхука
  • Параметры заголовков
  • Параметры запроса
• Применение Вебхуков через "Действия по условию".

Примечание: Вебхуки в первую очередь ориентированы для связи с внешними сервисами. В большинстве случаев внутри системы QuintaDB можно обойтись стандартными средствами, такими как Связь и Субформа.

Использовать Вебхук можно с помощью:

- поля Действие;

- модуля Действие по условию.

Рассмотрим на примере как это работает. В качестве примера будем использовать приложение Контент-агенство, которое можно установить на странице шаблонов приложений.

Также, для демонстрации мы будем использовать сервис webhook.site. Это может быть любой ваш URL-адрес.

Скопируйте свой уникальный URL. Теперь перейдем к форме Статьи в нашем приложении Контент-агенство.

Рассмотрим первый способ - поле "Действие":

1. Добавьте на форму поле "Действие" (вкладка "Дополнительные");

2. Откройте страницу редактирования настроек поля. Перейдите во вкладку "Задачи" или выберите пункт "Что делать";

3. Создайте новую задачу. Выберите тип задачи - Вебхук;

4. Перейдите в раздел "Настройки".

Здесь необходимо вставить URL-адрес (в данном примере - это URL, полученный на сервисе webhook.site).

Выберите метод передачи данных (GET, POST, PATCH, DELETE). Подробнее о методах передачи данных, читайте документацию по API.

Выберите Content-Type (multipart/form-data, application/x-www-form-urlencoded, application/json).

В этом примере мы используем метод - POST и тип - application/json.

5. В разделе "Заголовки запроса" вы можете добавить заголовок и данные для авторизации (опционально);

6. В разделе Параметры запроса нужно указать название параметра и выбрать поле из формы напротив:

Также, вы можете выбрать из списка "Своё значение". Таким образом, вы передаете произвольный параметр, вместо значения из формы.

Обратите внимание: чтобы передать владельца текущей записи нужно добавить параметр: "copy_owners" с любым значением (например "1"), в разделе Параметры запроса. 

7. Нажмите кнопку "Создать".

8. Для тестирования нажимаем на "Действие" в таблице:

9. Проверяем результат передачи данных на сервисе Webhook:

Все данные успешно переданы.

Теперь рассмотрим другой метод передачи данных через Вебхук. А именно - модуль "Действия по условию".

Для демонстрации используем эту же форму. 

1. Перейдите в Конструктор формы и откройте вкладку "Действия". Создайте новое условное действие.

2. Выберите критерий выполнения действия (например, поле Название не пусто).

• Укажите название и когда выполнять действие (Форма отправлена, Запись обновлена, Платеж завершен или одновременно все).
• Действие - Вебхук.

Обратите внимание: в данном случае, при заполнении формы не происходит переход на другую страницу, а все данные параллельно сохраняются в вашей базе QuintaDB.

3. После создания действия нажмите на кнопку "Редактировать":

4. Нажмите на кнопку "Редактировать" напротив действия "Вебхук". Далее необходимо настроить вебхук аналогично настройкам в поле Действие.

Обратите внимание: каждый раз при передачи данных вы используете API вызов из ресурсов вашего аккаунта.