Перейти к основному содержимому
Версия: 1.22.3

Choice Timeline

Виджет временной шкалы Choice Timeline SA используется на формах таблицы Задачи (task) и ее дочерних таблиц. Он показывает, когда и как долго та или иная задача находилась в разных статусах, определяемых опциями конкретной колонки выбора.

Внешний вид виджета​

Виджет состоит из следующих элементов:

  1. Заголовок.
  2. Условные обозначения – сопоставление определенного цвета и значения статуса. Отображает только те статусы, в которых была запись.

  1. Дата и время начала – отображает время начала работы над задачей.
  2. Общее время, проведенное в статусах – отображает общее время, проведенное во всех неисключенных статусах.
  3. Дата и время окончания – отображает время, когда работа над задачей была завершена. Задача должна быть в неактивном режиме (Активно = false)

Порядок сегментов соответствует порядку изменения значений статуса. Также ширина сегмента соответствует времени нахождения в определенном статусе относительно общего времени.

При наведении курсора на определенный сегмент отображается подсказка с названием статуса и временем нахождения в этом статусе. Если время меньше 1 минуты, отображается <1м.

Ниже показано время начала и окончания этого статуса. Если текущий статус является последним сегментом, вместо времени окончания отображается значение Сейчас.

Настройка виджета​

Виджет временной шкалы может быть добавлен на форму записей таблицы Задачи и ее дочерних таблиц. По умолчанию он не отображается на форме.

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

Добавление виджета на форму​

Чтобы добавить виджет на форму, выполните следующие шаги:

  1. Перейдите на форму записи таблицы, на которую необходимо добавить виджет.
  2. В бургер-меню выберите Настроить → Форма → Макет.
  3. Из окна Доступно для выбора перенесите виджет Choice Timeline SA в окно Выбрано.
    • Нажмите на название виджета, чтобы настроить опции схемы в поле Значения опций схемы. Введите опции виджета в формате JSON.
  4. Нажмите Сохранить, чтобы применить изменения.
примечание

Если вы не настроите опции схемы, виджет будет иметь настройки по умолчанию:

  1. Название виджета = Временная шкала.
  2. Колонка выбора = Статус.
  3. Цвет = Набор по умолчанию из 21 цвета. Когда в виджете используются все 21 цвет, последующие цвета генерируются случайным образом.

Настройка опций схемы виджета​

Используйте окно Экземпляр виджета, чтобы указать опции виджета. Нажмите на название виджета при настройке представления формы, чтобы вызвать это окно.

В окне заполните поле Значения опций схемы. Введите параметры виджета в формате JSON. Если оставить поле пустым, будут применены значения по умолчанию.

  1. Измените заголовок виджета по умолчанию, определив новый:
{
     "title": "Название" 
}
подсказка

Лучше использовать заголовок, созданный в таблице Исходные сообщения (source_message), чтобы у него были переводы.

  1. Задайте колонку типа Choice:
{
     "column": "column_name"
}
  1. Если вам нужно использовать цвет, который не входит в список цветов по умолчанию для определенной опции выбора, укажите его следующим образом:
{
     "colorMap": [
                {"color": "#123456", "value": "choice_option.value"}
     ]
}
  1. Исключите некоторые статусы, чтобы они не отображались в виджете. Исключенные статусы отображаются серым цветом. Они занимают минимальную ширину и не учитываются в общем времени:
{
     "excludedStates": "choice_option.value"
}

  1. Вы можете задать минимальную высоту виджета в пикселях. При этом минимальная высота не может быть меньше высоты отображаемых элементов. Чтобы настроить минимальную высоту виджета, выполните следующие шаги:

    1. Перейдите на форму таблицы, где расположен виджет.
    2. Перейдите в Настроить → Форма → Макет.
    3. В окне Выбрано выберите виджет, чтобы вызвать окно Экземпляры виджета.
    4. Добавьте в поле Значения опций схемы минимальную высоту виджета через параметр minHeight, как показано в примере ниже.
    Значения опций схемы
    {
    "minHeight": "600px",
    "title": "Task",
    "column": "state",
    "colorMap": [
         {"color": "#0086E5", "value":"1"},
         {"color": "red", "value":"-1"}
    ],
    "excludedStates": ["-2","7"]
    }
    1. Нажмите Сохранить, чтобы применить изменения.

Пример виджета​

Следующие опции:

{
    "title": "Task",
    "column": "state",
    "colorMap": [
        { "color": "#000000", "value": "1" },
        { "color": "red", "value": "-1" }
    ],
    "excludedStates": ["-2", "7"]
}

настраивают следующий виджет:

Дополнительная информация​

Виджет отображается только на созданных записях. Данные об изменении статуса берутся из таблицы Истории (sys_history), данные о статусах и их переводы берутся из таблицы Опции выбора (sys_choice).

примечание
  • Если в Истории (sys_history) есть значения опций, которых нет в наборе опций для текущего дочернего элемента таблицы Задачи, виджет ищет подходящее в наборах ближайшего родителя этой таблицы (если таковой имеется).
  • Если в Опциях выбора (sys_choice) для текущей таблицы нет статусов, виджет получает доступ к статусам родительской таблицы.
  • Если нет переводов или самого статуса, выводится значение статуса из Истории (sys_history).