Общие сведения

Для датасетов предусмотрена возможность обновления данных без необходимости пересоздания датасета.

Обновление данных возможно только для датасета, созданного из источников с ярлыком «Источник», см. Коннекторы.

Данные объединенного датасета обновляются автоматически при изменении данных в датасетах, из которых он создан.

В настройках датасета для работы с обновлением предусмотрена вкладка "Обновление датасета":

Обновление

Данная функциональность позволяет вручную запустить моментальное обновление данных датасета. В реестре датасетов нажмите кнопку действий  для соответствующего датасета и выберите в меню вариант «Обновить».

Или ручное обновление можно запустить со вкладки «Обновление датасета» страницы настройки датасета. Для запуска обновления следует нажать на кнопку "Запустить" в блоке "Ручное обновление".

Нотификация в правом нижнем углу экрана сообщает о запуске обновления.

Когда датасет обновляется, в меню действий отображается вариант «Отменить обновление». Выберите его, чтобы отменить текущее обновление датасета.

Если обновление датасета отменено вручную, для него в реестре датасетов, в строке «Состояние», отображается иконка . При этом можно продолжать пользоваться этим датасетом: если датасет содержал данные до начала обновления, эти данные сохраняются.

Автоматическое обновление

Автоматические обновления настраиваются на вкладке «Обновление датасета» страницы настройки датасета. На вкладке включите ползунок «Автообновление» и укажите параметры обновления. По завершении настройки кликните кнопку «Сохранить» внизу страницы справа.

Запуск обновления по расписанию

Перед настройкой расписания обновления необходимо указать дату и время, с которой начнут действовать настройки автообновления, в блоке "Запуск".

Тип обновления – период

Чтобы обновление датасета запускалось с определенной периодичностью, выберите в поле «Тип автообновления» вариант «Период». Вы можете добавлять столько периодов, сколько требуется. Если несколько периодов указывают на одно время, будет выполнено только одно обновление. Время ближайшего запуска обновления сообщается справа от ползунка включения автоматического запуска, после сохранения настройки.

Тип обновления – временной интервал

Чтобы обновление датасета запускалось через определенный временной интервал, выберите в поле «Тип автообновления» вариант «Временной интервал». Может использоваться только один интервал. Время ближайшего запуска обновления сообщается справа от ползунка включения автоматического запуска, после сохранения настройки.

Предобновление датасета

Предобновление датасета - тип ручного обновления датасета, при котором загружаемые из источника данные не записываются в датасет, а выводятся пользователю для предпросмотра. Также выводится возможность предпросмотра проектов, использующих данных датасет, с обновленными данными без фактического обновления проекта.

Предобновление выполняется со вкладки «Обновление датасета» страницы настройки датасета. Для выполнения предобновления следует нажать на кнопку "Запустить" в блоке "Предобновление".

Нотификация о запуске в данном случае будет отличаться.

После выполнения предобновления на вкладке обновления отобразятся блоки:

• Предпросмотр датасета. Таблица предпросмотра демонстрирует, какие данные будут записаны в датасет после обновления. По умолчанию отображаются первые 100 загруженных строк. 
• Предпросмотр проектов. В блоке выводятся все проекты, где используется данный датасет. По нажатию на кнопку осуществляется переход к предпросмотру проекта с виджетами, перестроенными согласно предобновленным данным.

После открытия проекта на предпросмотр он помечается в списке предпросмотра проектов как просмотренный:

Для записи предобновленных данных в датасет следует нажать на кнопку "Опубликовать". Данные будут записаны в датасет, и виджеты в проектах перестроятся соответствующим образом. Для отмены записи данных следует нажать "Отмена".

После записи данных в датасет или отмены ссылка на предпросмотр проекта становится неактуальной, и вместо предпросмотра отображается страница-заглушка:

Выполнение обновления датасета

Когда датасет обновляется либо предобновляется, для него в реестре датасетов, в колонке «Статус», отображается иконка ожидания . 

Блокировка датасета на время обновления

На время обновления либо предобновления датасета блокируется возможность изменения некоторых его параметров на странице настройки, а именно выполнение:

• добавления или удаления колонки;
• форматирования колонки;
• настройки прав доступа;
• настройки автообновления;
• SQL-запроса. 

Кнопки для соответствующих действий – «Добавить колонку», «Удалить колонку», «Сохранить», «Выполнить запрос» – становятся неактивны на время обновления.

Также на время обновления либо предобновления датасета в режиме просмотра блокируется возможность изменения записей.

После завершения обновления в уведомления приходит сообщение об этом событии. Уведомление получают все пользователи, которые имеют право доступа к датасету.

Особенности обновления датасетов

Обновление датасета из источника с типом «Р7-Офис»

При создании датасета из источника с типом «Р7-Офис» для выбора доступны корневые и вложенные файлы и папки из папки источника «Общие», кроме файлов и папок, доступ к которым запрещен учетной записи пользователя источника (далее – пользователь источника), которая используется для соединения с источником в Polymatica Dashboards.

При этом в работе с файлами источника с типом «Р7-Офис» есть следующие особенности.

• Если пользователь источника является создателем файла, то независимо от папки, в которую может быть перемещен файл, обновление датасета происходит успешно.
• Если пользователю источника разрешен доступ к файлу в рамках прав доступа источника, то независимо от папки, в которую может быть перемещен файл, обновление датасета происходит успешно.
• Если пользователь источника НЕ является создателем файла, то при переносе файла из папки «Общие» обновление датасета завершается ошибкой.
• Переименование файла ни при каких условиях не влияет на обновление.
• Если файл в источнике удален в корзину (файл НЕ удален окончательно), то:
  • если пользователь источника является создателем файла, обновление датасета происходит успешно;
  • если пользователь источника НЕ является создателем файла, обновление датасета при любом доступе завершается ошибкой.
• Если после полного удаления файла в источнике (файл удален окончательно) загрузить новый файл с такими же названием, расширением и набором названий колонок, обновление датасета происходит успешно, с учетом условий выше.