Автообновление
При создании мэшапа, отображающего данные для критически важных систем, важны последние актуальные данные. Функцию автообновления можно использовать в соответствии с автоматическим обновлением данных через определенные интервалы времени. Чтобы отображать данные в мэшапе, используйте событие для выполнения сервиса во время выполнения. Возвращаемые данные из сервисов привязываются к виджетам. В зависимости от реализации сервисы обычно выполняются при загрузке мэшапа во время выполнения. Функцию автообновления можно использовать для автоматического выполнения сервиса на основе указанного значения времени.
По истечении заданного временного интервала инициируется событие Refresh, выполняются привязанные сервисы, а в виджет загружается последний набор данных.
Можно использовать функцию в качестве фонового сервиса в мэшапе без добавления виджетов, которые позволяют пользователям управлять функцией. Можно также привязать функцию к кнопке, кнопке переключения, флажку или другим виджетам входных данных. Это позволяет пользователям решать, включать или выключать автоматическое обновление, а также инициировать обновление данных в любое время.
Опции функции
Для функции автообновления можно задать следующие опции конфигурации:
• Описание - задает описание функции.
• Автообновление - включает автоматическое обновление функции.
• Интервал обновления - задает время между каждым обновлением в секундах.
Создание функции автообновления
1. На панели Функции щелкните значок 
. Откроется диалоговое окно Создать функцию.
. Откроется диалоговое окно Создать функцию.2. Выберите Автообновление в выпадающем списке.
3. Введите имя для функции, а затем щелкните Далее.
4. Чтобы функция обновлялась автоматически, установите флажок Автообновление.
5. В поле Интервал обновления введите числовое значение, определяющее число секунд между обновлениями.
6. Нажмите кнопку Готово.
Функция будет добавлена на панель Функции в категории Автообновление.
Рекомендации
• Убедитесь, что для интервала обновления задана длительность, превышающая время, необходимое для выполнения сервисов, привязанных к функции. Предположим, например, что для выполнения используется сервис данных, который занимает три секунды. Задание интервала обновления, равного 1 секунде, приведет к многократным вызовам сервера, что может повлиять на производительность. Кроме того, на некоторых пользователей могут повлиять более медленные сети, поэтому убедитесь, что вы ясно представляете время загрузки мэшапа, прежде чем задавать интервал обновления.
• Не задавайте интервал обновления, превышающий время ожидания для сессии пользователя на сервере.
• Если сервис данных не выполняется успешно, рассмотрите возможность отображать сообщения об ошибке. Можно также использовать значение свойства LastRefresh, чтобы показывать время последнего обновления данных.
Автоматическое обновление данных из сервиса
Чтобы автоматически обновлять сервис, возвращающий данные для виджета, выполните следующие действия.
1. Привяжите событие функции Refresh к сервису данных на панели Данные.
2. Убедитесь, что в диалоговом окне конфигурации функции установлен флажок Автообновление. Можно включать и выключать эту опцию во время выполнения, используя свойство AutoRefresh.
3. Укажите значение для интервала обновления в диалоговом окне функции или используйте привязку к свойству RefreshInterval.
Чтобы выполнить функцию с помощью событий из виджетов входных данных пользователя, добавьте кнопку, кнопку переключения или обе следующим образом:
• Чтобы обновить данные вручную, привяжите событие Clicked виджета "Кнопка" к сервису функции ActivateWidgetRefresh. Данные обновляются при нажатии кнопки во время выполнения.
• Чтобы разрешить пользователям включать или выключать автоматическое обновление во время выполнения, привяжите виджет свойства State виджета "Кнопка переключения" к свойству функции AutoReferesh.
На следующем изображении показаны привязки во время конструирования.
• Функция управляется с помощью двух виджетов: "Кнопка" и "Кнопка переключения".
• Событие обновления используется для запуска сервиса BarChartData, который возвращает значения данных для виджета "Столбчатая диаграмма" в мэшапе.
• Свойство LastRefresh привязано к виджету "Отображение значения".
После настройки автоматического обновления задаются уведомления об успешном завершении или об ошибке для обновленного сервиса. Например, можно показать сообщение о сбое, если сервис не может загрузить обновленные данные. Дополнительные сведения о включении уведомлений см. в разделе Добавление уведомлений сервиса данных.
Свойства функции
Функция автообновления содержит следующие свойства.
Свойство | Описание | Базовый тип | Значение по умолчанию | Доступно для привязки? (Да/Нет) | Локализуемое? (Да/Нет) |
|---|---|---|---|---|---|
ActivateWidgetRefresh | Связываемый сервис, который можно привязать к событию виджета для инициирования обновления вручную. Событие виджета инициирует событие Refresh функции. | Н/Д | Н/Д | Д | Н |
Refresh | Связываемое событие, которое можно привязать для запуска сервиса. Событие инициируется автоматически, если для AutoRefresh задано значение True. | Н/Д | Н/Д | Д | Н |
AutoRefresh | Логическое свойство, которое можно привязать для включения и выключения автоматического обновления во время выполнения. | BOOLEAN | False | Д | Н |
RefreshInterval | Связываемое свойство, которое задает время в секундах между каждым обновлением. | NUMBER | Н/Д | Д | Н |
LastRefresh | Связываемое свойство, которое содержит дату и время последнего автоматического обновления. | DATETIME | Н/Д | Д | Н |