Создание веб-перехватчиков для рабочих процессов
Веб-перехватчики позволяют использовать системные события Qlik Cloud как триггеры в рабочем процессе. Созданный веб-перехватчик автоматически отправляет запрос JSON в конечную точку веб-перехватчика каждый раз, когда происходит определенное системное событие. Веб-перехватчики можно использовать для отправки данных в любое приложение, которое может принимать данные JSON.
Свойства веб-перехватчика
Чтобы создать веб-перехватчик, необходимо настроить свойства веб-перехватчика и конечной точки, а затем выбрать типы событий Qlik Cloud.
Свойство | Описание |
---|---|
Имя | Имя веб-перехватчика. |
Описание (необязательно) | Описание веб-перехватчика. |
URL-адрес | URL-адрес для конечной точки веб-перехватчика. URL-адрес (конечная точка веб-перехватчика) должен быть полностью определенным именем домена (FDQN) и использовать протокол HTTPS. Конечная точка не может быть IP-адресом. |
Секрет (необязательно) | Секрет для проверки подлинности веб-перехватчика. Длина секрета не должна быть короче 32 символов и длиннее 64 символов. Если создается секрет веб-перехватчика, он является частью хэша, который добавляется к запросу HTTP как qlik-signature. |
Заголовки (необязательно) |
Заголовки, которые могут быть добавлены к запросу HTTP. |
Для каждого веб-перехватчика настраивается один или несколько типов событий.
Ресурс | Типы события |
---|---|
Приложения | Создано, Удалено, Данные обновлены, Перезагружено, Опубликовано, Экспортировано Примечание к информацииСобытие обновления данных относится к обновляемым данным. Событие перезагрузки относится к приложению Qlik Sense и связанным перезагружаемым таблицам данных. |
Пользователи | Создано, Удалено |
Веб-перехватчик ожидает одного из событий, и когда оно случается, то данные о событии передаются конечной точке веб-перехватчика. Данные передаются на URL-адрес конечной точки в виде запроса JSON.
Пример: Запрос JSON для типа события «приложение удалено»
Request
URL
https://api.blendr.io/v1/widgets/F502987A-AF89-4992-8127-F28794C5A74A?X-Execution-Token=xxxxx
Headers
{
"Content-Type": "application/json",
"Qlik-Signature": "446bd5e3f5b635f491d17557e4bec6ebc61b7bd2bc9cc7b612e4e",
"User-Agent": "Qlik Webhook"
}
Body
{
"cloudEventsVersion": "0.1",
"source": "com.qlik/engine",
"contentType": "application/json",
"eventId": "e65c1481-e8a-4be-a5ca-27dfcde077d7",
"eventTime": "2021-03-08T14:51:29Z",
"eventTypeVersion": "1.0.0",
"eventType": "com.qlik.v1.app.deleted",
"extensions": {
"ownerId": "vNRGrDZIypJzauw59BbpvkRhqbmI",
"tenantId": "oZcMPa_1PwH4FUdrh6839YHHdEJN",
"userId": "vNRGrDZIypJtcGTzauw59BbpqbmI"
},
"data": {
"attributes": {
"id": "0984fec4-aa8c-4253-b1d1-4fd4f9c78",
"name": "New App",
"createdDate": "2021-03-08T14:51:28.888Z",
"modifiedDate": "2021-03-08T14:51:29.316Z",
"owner": "auth0|b62a17c577a4abe6e807b07d18c4d82286352542d633d120100b03fb11",
"ownerId": "vNRGrDZIypJtcGTzauw59BbpvbmI",
"published": false,
"hasSectionAccess": false
}
}
}
Создание веб-перехватчика
Веб-перехватчики можно создавать в Консоль управления. Также веб-перехватчики можно создавать в интерфейсе Qlik Application Automation. Для получения дополнительной информации см. раздел Работа с веб-перехватчиками (только английский язык).
Можно создать не более 100 веб-перехватчиков для каждого клиента.
Выполните следующие действия.
-
В Консоль управления перейдите в раздел Веб-перехватчики.
-
В правом верхнем углу нажмите Создать.
-
В диалоговом окне Создание веб-перехватчика введите имя для веб-перехватчика.
-
Добавьте необязательное описание.
-
Введите URL-адрес для стороннего приложения интеграции.
-
Дополнительно укажите секрет для добавления к запросу HTTP.
-
Дополнительно укажите заголовки HTTP для добавления к запросу.
-
В разделе События выберите тип события для веб-перехватчика.
-
По окончании нажмите Создать.
Веб-перехватчики перечислены в таблице. Вновь созданные веб-перехватчики по умолчанию включены.
Изменение веб-перехватчика
Выполните следующие действия.
-
В Консоль управления перейдите в раздел Веб-перехватчики.
-
Нажмите кнопку в конце строки веб-перехватчика, который требуется изменить.
-
Нажмите Изменить.
Откроется панель редактирования с параметрами для изменения конфигурации веб-перехватчика.
-
Внесите необходимые изменения и нажмите кнопку Сохранить.
Удаление веб-перехватчика
Выполните следующие действия.
-
В Консоль управления перейдите в раздел Веб-перехватчики.
-
Выберите веб-перехватчик для удаления.
-
В правом верхнем углу нажмите Удалить.
-
Всплывающее диалоговое окно откроется для подтверждения выбора. Нажмите Удалить.
Просмотр истории веб-перехватчиков
История веб-перехватчиков доступна в разделе Веб-перехватчики в Консоль управления.
-
Чтобы просмотреть историю веб-перехватчика, нажмите кнопку в конце нужной строки.
Отобразится история веб-перехватчика.
-
Чтобы вручную повторно отправить доставку события, нажмите кнопку в конце строки этого события.
-
Чтобы просмотреть содержание ответа на событие, нажмите кнопку в конце строки события.