Извлечение изменений из таблиц записи

Когда пользователи добавляют данные в редактируемые столбцы в таблицы для записи, их изменения не применяются к модели данных приложения. Они также носят временный характер — изменения хранятся в хранилищах изменений, управляемых Qlik, в течение 90 дней, после чего они удаляются.

Эти изменения можно получить через API для отслеживания изменений. Изменения могут использоваться для разных целей, в том числе:

• Загрузите изменения в файлы QVD или приложения для постоянного хранения и использования в Qlik Cloud.

• Извлечение изменений через внешние системы, такие как электронные таблицы Excel или базы данных SQL.

• Динамическая интеграция данных в автоматизированные процессы, такие как рассылка электронных писем или закупка.

• Создание собственных приложений и интеграция вызовов к API для отслеживания изменений в операционные рабочие процессы.

Необходимые условия

Для доступа к данным, сохраненным в хранилище изменений, требуется доступ к API для отслеживания изменений. Этот доступ может предоставляться через:

• Ключ API для клиента Qlik Cloud. См. Управление ключами API.

• Разрешения, необходимые для работы с таблицами записи, назначаются администратором клиента. См.:

  • Настройка разрешений для таблиц записи (подписки на основе объема)

  • Настройка разрешений для таблиц записи (подписки на основе пользователей)

• Идентификатор хранилища изменений. После создания таблицы записи идентификатор отображается на листе. См. Работа с хранилищами изменений.

Доступные инструменты для извлечения изменений

Для извлечения и использования изменений из API для отслеживания изменений можно использовать следующие инструменты:

• Qlik Automate

• REST-коннектор, доступный с инструментами Qlik для работы со скриптами и для подготовки данных.

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

• Извлечение изменений из таблицы записи с помощью Qlik Automate

• Извлечение изменений из таблицы записи с помощью коннектора REST

• Сценарии использования таблиц записи

Извлечение изменений из таблицы записи с помощью Qlik Automate

Изменения, сохраненные в хранилище изменений, можно извлечь с помощью блоков Change Store в коннекторе Qlik Cloud Services в Qlik Automate. Этот коннектор автоматически подключается к учетной записи Qlik владельца автоматизации, поэтому дополнительных шагов для аутентификации не требуется.

Дополнительная информация о Qlik Automate доступна по адресу Qlik Automate.

Вывод текущих изменений из хранилища изменений

Блок List Current Changes From Change Store использует конечную точку API /changes/tabular-views и возвращает только последнее значение каждой ячейки (другими словами, он возвращает текущие значения). Эти значения выводятся в виде списка объектов, в котором каждый объект содержит первичные ключи и значения изменений. К каждой записи добавляется метка времени updatedAt, которая соответствует дате и времени последнего обновления записи, а также добавляется идентификатор пользователя updatedBy, соответствующий пользователю, сделавшему это изменение.

Вывод истории хранилища изменений

Блок List Change Store History использует конечную точку API /changes и возвращает полную историю для каждой ячейки. Если ячейка обновлялась несколько раз, блок вернет все значения, userId и метку времени updatedAt для каждого обновленное значения.

Работа с шаблонами

Вы также можете начать с шаблона автоматизации, если вы извлекаете данные в базу данных MySQL. Следующие шаблоны доступны в разделе Insights to Action:

• Extract Change Store Data to a MySQL Database

• Extract Change Store Data to a MySQL Database in Bulk

Эти шаблоны упорядочивают блоки Change Store (описанные выше) с другими блоками, чтобы помочь вам быстрее извлекать данные. Просто настройте параметры блока для подключения к вашим ресурсам. Подробное описание см. в этой статье сообщества.

Извлечение изменений из таблицы записи с помощью коннектора REST

В этом примере показано, как можно настроить подключение REST к API для отслеживания изменений. Это подключение можно использовать для извлечения данных из API и загрузки изменений обратно в приложение или сохранения их в QVD в Qlik Cloud.

Выполните следующие действия.

1. В Qlik Cloud Analytics создайте новое подключение к коннектору REST. См. Добавление подключений к данным.

2. Задайте следующие параметры подключения:

   • URL: your_tenant_base_URL/api/analytics/change-stores/your change store id/changes/tabular-views

   • Additional request parameters

     • Query parameters

       • Limit (Key): 100 (Value)

     • Query headers

       • Authorization (Key): Bearer your_API_token (Value)

   • Pagination type: Next URL

     • 'Next url' path: links/next/href