Руководство администратора

В системе можно настраивать три вида шаблонов для каждой категории:

•NTF — вызывается при создании новой задачи (NTF — сокращение от New Task Form),

•MTF — вызывается при просмотре задачи (MTF — сокращение от Main Task Form),

•Cell — используется для краткого отображения задачи в списке задач (cell — это ячейка).

Эти шаблоны назначаются в настройках категории, на вкладке Вид, по кнопке Шаблонизация. Для редактирования динамического шаблона можно использовать JSON-редактор.

Каждый вид шаблона имеет свои особенности — в нем могут быть допустимы или недопустимы отдельные ключи и настройки.

Структура шаблона

В базовом варианте динамический шаблон задачи — это JSON трехуровневой структуры: sections -> blocks -> elements. Также может присутствовать необязательный раздел настроек settings, как для всего шаблона, так и для отдельных элементов.

{
   "sections": [
       {
           "name": "...",
           "blocks": [
               {
                   "name": "...",
                   "isExpandable": false,
                   "defaultIsExpanded": true,
                   "footer": "",
                   "header": "",
                   "elements": [
                       {
                           "name": "...",
                           "type": "...",
                           "dataKey": "...",
                           "viewMode": "...",

                           "settings": {...}  
                       },
                         ...

                   ]
               }
           ]
       },

    ...

   ],

   "settings": {...}
}

В шаблоне MTF раздел Sections соответствует вертикальным вкладкам (секциям), раздел blocks — горизонтальным блокам, раздел elements - элементам. В настоящее время блок в секции может быть только один.

Структура шаблона задачи.

Если шаблон NTF включает несколько секций, то они будут отображаться пользователю не одновременно в виде вкладок, а последовательно в виде отдельных экранов, имитируя пошаговое создание задачи. На каждом таком экране будет отображаться кнопка Далее, на последнем экране — кнопка Готово.

Последовательный ввод — секции в карточке новой задачи.

Секции (sections)

Шаблон содержит одну или несколько секций.

Каждая секция (из массива sections) содержит ключи:

Пример шаблона с двумя секциями:

{
   "sections": [
     {
          "name": "Вкладка 1",
          "blocks": []
     },
     {
          "name": "Вкладка 2",
          "blocks": []
     }
   ]
}

Блоки (blocks)

В настоящее время деление на горизонтальные блоки не поддерживается, поэтому в каждой вкладке (section) должен быть только один блок (block).

Каждый блок (из массива blocks) может содержит ключи:

Пример массива блоков:

"blocks": [
            {
               "name": "Название блока",
               "isExpandable": false,
               "defaultIsExpanded": true,
               "footer": "",
               "header": "",
               "elements": [...]
            }
         ]

Элементы (elements)

Каждый элемент (из массива elements) может содержать ключи:

Пример массива элементов с основными параметрами "Текст задачи" и "Заказчик задачи" и одним ДП с ID=182:

[

 {
      "name": "Договор",
      "type": "mainParam",
      "dataKey": "taskText",
      "viewMode": "normal"
 },

 {
      "name": "От",
      "type": "mainParam",
      "dataKey": "owner",
      "viewMode": "normal"
 },

 {
      "name": "Участники встречи",
      "type": "exparam",
      "dataKey": "182",
      "viewMode": "normal"
 }

]

Настройки (settings)

Настройки можно описать с помощью раздела settings. Общие настройки для всего шаблона должны идти перед или после раздела sections. Собственные настройки могут быть у каждого элемента.

В разделе settings могут настраиваться следующие ключи:

Список действий (options)

В шаблоне для задачи доступно меню со списком доступных действий. Это меню настраивается с помощью подраздела options в разделе settings. Если такого подраздела в шаблоне нет, будут доступны все возможные действия (т.е. с помощью options список доступных действий можно сократить, но не расширить).

Пример настройки подраздела options:

 "settings": {

         ...        

         "options": {
                 "createSubtask": true,
                 "createLinkedTask": true,
                 "createNewTask": true,
                 "changeTaskText": true,
         }

         ...

 }

Возможные действия:

Нажатие (onTap)

В шаблоне для задачи можно настроить действие, которое будет выполняться по нажатию на элемент. Это действие настраивается с помощью подраздела onTap в разделе settings данного элемента.

Возможные действия:

Пример настройки подраздела onTap - по нажатию на задачу открывается не карточка задачи, а блок "Используется". Такая настройка позволяет реализовать многоуровневый каталог.

{
  "settings": {
      "viewMode": "flat",
      "showTaskFilter": false,
      "onTap": {
          "action": "openUsedBlock",
          "id": 111
      }
  }

}

где 111 — это ID таблицы в блоке "Используется".

Агрегированные представления

В приложении поддерживаются также некоторые агрегированные представления данных, где элементы агрегируются по какому-то признаку. В настоящее время приложения поддерживает два таких представления — календарь (агрегирует задачи на дату) и карта (агрегирует объекты по координатам в кластере).

Для них перед секциями добавляются еще два раздела: templateClass и aggregate.

Раздел templateClass задает тип представления — calendar или map.

Раздел aggregate описывает параметр, по которому агрегируются данные (например, ДП), причем только ключи type и dataKey (без name и viewMode).

Пример шаблона с агрегацией:

{
  "templateClass": "calendar",
  "aggregate": {
      "element": {
                 "type": "extparam",
                 "dataKey": 4025
            }
  },
  "sections": [
     ...
  ]
}

Комментарии в шаблоне

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

Пример использования комментария:

 ...

 {
         "_name": "Клиент",
         "type": "extparam",
         "dataKey": 3973,
         "viewMode": "valueOnly"
 },

 ...