Choice Timeline

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

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

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

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

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

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

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

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

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

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

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

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

---

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

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

примечание

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

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

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

---

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

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

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

{
     "title": "Название" 
}

подсказка

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

2. Задайте колонку типа Choice:

{
     "column": "column_name"
}

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

{
     "colorMap": [
                {"color": "#123456", "value": "choice_option.value"
}

4. Исключите некоторые статусы, чтобы они не отображались в виджете. Исключенные статусы отображаются серым цветом. Они занимают минимальную ширину и не учитываются в общем времени:

{
     "excludedStates": "choice_option.value"
}

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

---

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

{
    "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).