Создание таблицы записи
Таблицу записи можно создать на листе, добавляя измерения, меры и редактируемые столбцы по мере необходимости. После создания таблицы записи в приложении все пользователи, у которых есть доступ к этому приложению и разрешения на таблицу записи, могут делать изменения в редактируемых столбцах. Изменения затем можно экспортировать во внешние системы.
Создание таблицы записи
Добавьте таблицу записи на свой лист.
Выполните следующие действия.
-
На панели ресурсов откройте Диаграммы.
-
В разделе Визуализацииперетащите Таблицу записи на лист.
Щелкните команду Добавить измерение и выберите измерение или поле.
Добавьте дополнительные столбцы измерений и мер. Для этого нажмите
в разделе Данные на панели свойств. Откроется раскрывающийся список. Выберите один из следующих вариантов:- Поля и основные элементы: открывает диалоговое окно с функцией поиска, в котором отображаются все поля и основные элементы. На свой выбор можно добавить любой элемент в качестве измерения или меры.
- Пользовательское выражение: открывает диалоговое окно, где можно ввести выражение или открыть редактор выражения
.
Добавьте редактируемые столбцы, нажав
в разделе Данные на панели свойств и выбрав Редактируемый столбец.Определите один или несколько первичных ключей для таблицы. В таблице записи, в редактируемом столбце, нажмите Определить и выберите один или несколько столбцов измерения, которые будут использоваться в качестве первичных ключей.
Информацию о первичных ключах см. в разделе Первичный ключ.
Нажмите Сохранить.
В созданной таблице записи можно разрешить другим пользователям взаимодействовать с ней и делать изменения в редактируемых столбцах. Кроме того, можно изменить внешний вид таблицы записи и ее свойства. См. Настройка свойств таблицы записи.
Извлечение и использование изменений
Данные, добавленные пользователями в редактируемые столбцы, не применяются к модели данных приложения. Они являются временными: изменения хранятся в хранилище изменений, управляемом Qlik, в течение 90 дней, после чего они удаляются.
Эти изменения можно получить через API для отслеживания изменений. Изменения могут использоваться для разных целей, в том числе:
-
Загрузка изменений в файлы QVD или приложения для постоянного хранения и использования в Qlik Cloud.
-
Извлечение изменений через внешние системы, такие как электронные таблицы Excel или базы данных SQL.
-
Динамическая интеграция данных в автоматизированные процессы, такие как рассылка электронных писем или закупка.
-
Создание собственных приложений и интеграция вызовов к API для отслеживания изменений в операционные рабочие процессы.
Необходимые условия
Для доступа к данным, сохраненным в хранилище изменений, требуется доступ к API для отслеживания изменений. Этот доступ может предоставляться через:
-
Ключ API для клиента Qlik Cloud. См. Управление ключами API.
-
Разрешения, необходимые для работы с таблицами записи, назначаются администратором клиента. См.:
-
Настройка разрешений для таблиц записи (подписки на основе объема)
-
Настройка разрешений для таблиц записи (подписки на основе пользователей)
-
-
Идентификатор хранилища изменений. После создания таблицы записи идентификатор отображается на листе. См. Хранилище изменений.
Доступные инструменты для извлечения изменений
Для извлечения и использования изменений из API для отслеживания изменений можно использовать следующие инструменты:
-
Qlik Automate
-
REST-коннектор, доступный с инструментами Qlik для работы со скриптами и для подготовки данных.
Примеры и варианты использования:
Основные понятия
В этом разделе приводятся основные понятия, связанные с таблицей записи.
Редактируемый столбец
В таблице записи редактируемые столбцы позволяют пользователям вводить данные непосредственно во время анализа. При сохранении изменений в редактируемом столбце изменения записываются в хранилище изменений, из которого их могут получить разработчики приложений и интеграторы.
Информацию о том, где можно создать редактируемые столбцы, см. Создание таблицы записи.
После того как был добавлен редактируемый столбец, его можно изменить в зависимости от задачи.
Выполните следующие действия.
-
В панели свойств в разделе Данные нажмите редактируемый столбец.
Откроется окно свойств столбца.
-
Можно изменить любое из следующих свойств:
-
Заголовок: измените заголовок столбца, заданный по умолчанию.
-
Показать содержимое: измените способ редактирования данных в таблице пользователями. Доступны следующие возможности:
-
Единственная выборка: задайте набор значений, доступный при изменении ячейки. Например, для статусов заказов это может быть В процессе и Просрочено. Пользователи смогут использовать только эти значения при комментировании записей данных.
-
Ввод пользователем вручную: пользователи могут вводить данные в ячейки вручную.
-
-
Показать столбец: переключение видимости столбца.
-
Ширина столбца: задайте ширину столбца.
-
Хранилище изменений
Хранилище изменений — это управляемое Qlik хранилище, в котором хранятся изменения, сделанные пользователями в редактируемых столбцах таблицы записи. Хранилище изменений — это временное хранилище: изменения хранятся в течение 90 дней, после чего удаляются.
Хранилище изменений для таблицы записи уже настроено для клиента и доступно через API для отслеживания изменений. Идентификатор хранилища изменений можно использовать в запросах API и автоматизациях для синхронизации изменений, сделанных пользователем, с постоянным хранилищем, таким как электронная таблица или база данных. Для получения дополнительной информации см. раздел Извлечение и использование изменений.
Идентификатор хранилища изменений можно скопировать двумя способами:
-
В режиме редактирования листа после создания таблицы записи. На панели свойств, в разделе Хранилище изменений> Идентификатор хранилища изменений, нажмите
.Копирование идентификатора хранилища изменений из панели свойств.
-
В режиме анализа при просмотре таблицы записи. Нажмите на значок
в нижнем правом углу. Нажмите , чтобы скопировать идентификатор хранилища изменений.Копирование идентификатора хранилища изменений при просмотре таблицы записи.
Первичный ключ
Чтобы добавить редактируемые столбцы в таблицу записи, необходимо определить хотя бы один первичный ключ.
Первичный ключ — это поле, связывающее изменения в редактируемых столбцах с исходными данными из модели данных. С помощью первичных ключей можно сопоставить записи в таблице записи, представляющие данные из модели данных, и изменения, которые пользователи вносят в редактируемые столбцы.
Первичный ключ может быть простым, включающим одно поле, или составным, состоящим из нескольких полей.
Первичные ключи, определенные в таблице записи, можно изменить в любой момент. На панели свойств, в меню Изменить хранилище > Первичные ключи, нажмите Изменить.
Первичный ключ также играет важную роль при извлечении изменений из API для отслеживания изменений.
Использование инструментов Qlik Cloud для извлечения изменений из таблиц записи
Извлечение изменений из таблицы записи с помощью Qlik Automate
Изменения, сохраненные в хранилище изменений, можно извлечь с помощью блоков Change Store в коннекторе Qlik Cloud Services в Qlik Automate. Этот коннектор автоматически подключается к учетной записи Qlik владельца автоматизации, поэтому дополнительных шагов для аутентификации не требуется.
Дополнительную информацию о Qlik Automate см. в разделе Qlik Automate.
Доступ к блокам Qlik Automate для извлечения изменений из таблиц записи
Вывод текущих изменений из хранилища изменений
Блок List Current Changes From Change Store использует конечную точку API /changes/tabular-views и возвращает только последнее значение каждой ячейки (другими словами, он возвращает текущие значения). Эти значения выводятся в виде списка объектов, в котором каждый объект содержит первичные ключи и значения изменений. К каждой записи добавляется метка времени updatedAt, которая соответствует дате и времени последнего обновления записи, а также добавляется идентификатор пользователя updatedBy, соответствующий пользователю, сделавшему это изменение.
Блок List Current Changes From Change Store в Qlik Automate
Этот блок также имеет инкрементный вариант List Current Changes From Change Store Incrementally. Этот вариант работает следующим образом:
-
При первом запуске блок извлекает все записи.
- При последующих запусках блок извлекает только новые и обновленные значения в формате, в котором они представлены в записи.
- Если в записи было обновлено только одно значение, блок вернет только это значение (вместе с первичными ключами и параметрами updatedAt и updatedBy). Если одна и та же ячейка в промежутке между двумя запусками этого блока была обновлена несколько раз, блок вернет только последнее («текущее») значение.
Вывод истории хранилища изменений
Блок List Change Store History использует конечную точку API /changes и возвращает полную историю для каждой ячейки. Если ячейка обновлялась несколько раз, блок вернет все значения, userId и метку времени updatedAt для каждого обновленное значения.
Блок List Change Store History в Qlik Automate
Разрешения
Для создания таблиц записи и взаимодействия с API для отслеживания изменений требуются определенные разрешения. Для получения дополнительной информации см. раздел Разрешения для таблицы записей.