Перейти к содержанию

Виджет Календарь

В блоке Календарь отображаются данные в привязке к дате: при выборе даты в календаре меняется список под календарем. Если выбран только месяц, в списке отображаются данные за весь месяц. Если в списке больше 20 записей, отображаются первые 20. Обычно в списке выводятся задачи, но могут выводиться и другие данные (например, пользователи с днями рождения).

Блок Календарь в пользовательском интерфейсе

Для настройки календаря из общих настроек блока перейдите по ссылке "Открыть дополнительные настройки".

Принцип настройки блока Календарь — такой же, что и для блока Smart Html. Сначала создается или выбирается готовое смарт-выражение для отбора данных — оно возвращает данные, которые должны отображаться в блоке. Для настройки визуального представления данных настраивается шаблон ).

Настройки блока:

Параметр

Описание

Дата начала

Начальная и конечная дата периода, отображаемого в календаре. Поля могут использоваться для тестирования настроек: выберите нужные вам даты, после чего обновятся данные в блоке JSON данные и вы увидите их отображение в блоке Предпросмотр в соответствии с настроенным шаблоном

Дата окончания

Поле с датой

Поле с датой должно содержать название поля типа "Дата" или "ДатаВремя" — это поле обязательно должно содержаться в наборе данных, возвращаемых смарт-выражением. По этому полю осуществляется привязка задач к дате в календаре. Например, чтобы по клику на дату в календаре в списке под календарем отображались задачи, у которых срок назначен на эту дату, надо в Поле с датой указать OrderedTime

Смарт

В смарт-выражении для блока Календарь можно использовать два параметра: \@dateFrom и \@dateTo — при первой загрузке блока они устанавливаются на начало и конец текущего месяца, потом значения зависят от выбора пользователя: если выбрана дата, то оба параметра принимают значение выбранной даты, если выбран месяц — начало и конец выбранного месяца.

Пример смарт-выражения для блока Календарь

Пример T-SQL:

select top 100
TaskID
 ,TaskText
 ,extparam12187nativevalue as dateVal
from tasksinsubcat5574denormalized t
where t.isclosed = 0
AND extparam12187nativevalue >= @DateFrom
 AND extparam12187nativevalue <= @DateTo
order by t.extparam12187nativevalue desc
Стили отображаемых дат

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

Смарт-выражение должно возвращать две колонки: колонку для даты (формат "Дата" или "Дата и время") и колонку для класса текстового типа. Доступные цвета для класса:

  • success — Зеленый

  • warning — Оранжевый

  • danger — Красный

  • default — Серый

Пример T-SQL:

select top 100
  cast(extparam12187nativevalue as date) as dateColumn,
  case
    when extparam12187nativevalue > getdate() then 'info'
  else 'danger'
  end as colorColumn
from tasksinsubcat5574denormalized t
where t.isclosed = 0
AND extparam12187nativevalue >= @DateFrom
 AND extparam12187nativevalue <= @DateTo
order by t.extparam12187nativevalue desc
Колонка даты

Псевдоним (алиас) колонки даты в смарт-выражении из поля Стили отображаемых дат

Колонка класса

Псевдоним (алиас) колонки класса в смарт-выражении из поля Стили отображаемых дат

Шаблон

Шаблон виджета

JSON данные

JSON данные виджета

Предпросмотр

Предварительный просмотр внесенных изменений в настройках

ℹ️ Обратите внимание: для данного типа виджета не поддерживается настройка фильтрации данных

Описание виджета Календарь в прежнем интерфейсе администрирования Полезные ссылки

Блок Smart Html

Отображение задач и календарных событий