Виджет Choice Timeline

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

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

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

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

3. Дата и время начала – отображает время начала работы над задачей.

4. Общее время, проведенное в статусах – отображает общее время, проведенное во всех неисключенных статусах.

5. Дата и время окончания – отображает время, когда работа над задачей была завершена. Задача должна быть в неактивном режиме (Активно = false)

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

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

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

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

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

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

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

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

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

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

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

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

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

   {
       "title": "Title"
   }

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

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

   {
       "column": "column_name"
   }

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

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

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

   {
       "excludedStates": "choice_option.value"
   }

   Пример опций схемы

   Пример JSON

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

   На скриншоте показан настроенный виджет:

   

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

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

      {
          "minHeight": "600px",
          "title": "Task",
          "column": "state",
          "colorMap": [
              {"color": "#0086E5", "value":"1"},
              {"color": "red", "value":"-1"}
          ],
          "excludedStates": ["-2","7"]
      }

   5. Нажмите Сохранить, чтобы применить изменения.

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

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