Обработка шаблона и его ключей настраивается в коде приложения. Любые изменения, вносимые в шаблон, должны строго соответствовать тому, что заложено в коде приложения. Редактирование шаблона обычно производится специалистами ТП "Первой Формы". В процессе развития приложения и расширения его возможностей набор ключей для существующих шаблонов может расширяться. Однако при обновлении платформы "Первая Форма" новые ключи для существующих шаблонов не добавляются автоматически, и при необходимости их надо добавлять вручную, в соответствии с эталонными настройками. |
---|
Преднастроенные шаблоны
contactsFolder
Шаблон для папки с выбранными контактами
Общие ключи |
Описание |
---|---|
fallBackTitle |
заголовок |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000. Если значение не указано — цвет будет прозрачным |
widthRatio |
ширина в условных единицах |
dashboard
Шаблон экрана рабочего стола. Выбор плиток по порядку.
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
fallBackTitle |
заголовок плитки |
groups |
группы, для которых плитка должна отображаться. В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000. Если значение не указано — цвет будет прозрачным |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке. icon переопределяется в плитке, и если значение не задано, то значения для него берется из template целого дашбоарда |
iconColor |
цвет иконки. Если цвет не задан, то он автоматически подтягивается от цвета текста заголовка плитки titleColor |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка в блоке, выражение вида #000000 |
titleColor |
вертикальный градиент в плитке |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
bgImage |
изображение фона |
cellCounterFontSize |
URL адрес на изображение фона с анонимным доступом |
cellIconSize |
размер шрифта счетчика, по умолчанию 15. Если не заданы в плитке, то берутся из настроек контейнера. |
cellIconSize |
размер иконки, по умолчанию 16. Если не заданы в плитке, то берутся из настроек контейнера. |
cellTextFontSize |
размер текста внутри ячейки (плитки) |
cellTitleFontSize |
размер заголовка ячейки (плитки), по умолчанию 15 |
containerBackgroundColor |
цвет фона контейнера в целом |
rightBarButtons |
JSON onTap действий |
showStyle |
тип анимации. Возможные значения: •expand — элемент возникает •push — элемент появляется снизу •swipe •background — фон |
showTileBorderShadow |
отображение тени для виджета на рабочем столе |
tileCornerRadius |
радиус углов плиток, по умолчанию 6 pt |
tileSpacing |
отступ от края экрана |
dashboardItem
Шаблон одной плитки рабочего стола
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
fallBackTitle |
заголовок плитки |
footerTitle |
текст подвала (нижней части) |
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп. В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000. Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
iconColor |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка плитки. выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
actionStyle |
стиль отображения при нажатии. Возможные значения: •push (переход), •popup (всплывающее окно) |
autoHeight |
высота определяется автоматически по контенту |
bgImageUploadId |
изображение фона |
bgImageURL |
URL адрес на изображение фона с анонимным доступом |
cellCounterFontSize |
размер шрифта счетчика |
cellIconSize |
размер иконки, значение по умолчанию: 16 Если не заданы в плитке, то берутся из настроек контейнера. |
cellStyle |
стиль ячейки. Возможные значения default/custom. если не задано — то default. Если в task source стоит cellStyle = default, то мы его открывает ровно как сейчас — типовые ячейки Если же cellStyle = custom, то мы должны каждую ячейку показать согласно ее шаблону CELL (краткое представление в шаблонизаторе). |
cellTitleFontSize |
размер шрифта для заголовка, по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста плитки |
click |
json описания нажатий на разные части плитки |
context |
контекст, который будет браться из настроенного динамического шаблона |
disabled |
выключение нажатия на плитку. если 1, то нажатие на плитку ничего не делает. если 0, то обычное нажатие и дальнейшее проваливание в плитку |
emptyContentTitle |
|
forbidCreateTask |
признак запрета на создание задач 0 — запрета на создание задач нет, 1 — запрет на создание задач есть |
hideCounter |
возможность скрыть счётчик. 0 — не включено 1 — включено Если цвет не задан, то он автоматически подтягивается от цвета текста заголовка плитки titleColor Счетчик идет слева от иконки. если иконки нет — счетчик сдвигается на ее место. Счетчик отображается в виде тикера — в круге/овале, цвет фона тикера берется как цвет текста счетчика с альфой 0.3 |
hideOnZeroCount |
признак, который определяет, будет ли плитка отображаться на рабочем столе при нулевом счетчике 0 — отображается только при ненулевом счетчике, 1 — отображается всегда |
onTapAlert |
сообщение при нажатии неактивной плитки. Связано с параметром needConfirm. при нажатии на плитку появляется алерт с данным текстом (если disabled = 0, то чисто формально показывается алерт и переходим в плитку) |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
needConfirm |
ключ, отвечающий за отображение кнопок Отменить/Подтвердить под баннером с текстом с onTapAlert. если значение равно 1 и onTapAlert не пустая строка, то вместо алерта показываем конферм с текстом onTapAlert, две кнопки "Отменить" и "Подтвердить". После нажатия Подтвердить просизодит переход в плитку |
slideShow |
признак автоматического прокручивания элементов в виде "карусели" |
subcatId |
ID категории для создания задачи |
taskFilter |
фильтр (json для task/feeds) |
tileCornerRadius |
радиус углов плиток (по умолчанию 6 pt) |
tileSpacing |
отступ от края экрана |
Настройка вертикального стека для информационной плитки
Внутри вертикального стека плиток есть возможность настроить 1+ вложенный блок, указать некоторое число задач для получения с сервера, а также отметить параметр "Специальный шаблон".
В такой конфигурации в отдаче сервера придет указанное(или меньшее) количество задач для отображения в настраиваемом блоке. В случае чекбокса МП получает данные по задачам с их настроенными шаблонами для каждого блока.
Особенности логики отображения:
•Если приходит пустой массив в блоке, то рисуется 1 ячейка в стеке, в качестве текста берется значение параметра fallBackTitle.
•Если для плитки внутри стека стоит hideOnZeroCount = 1 и в отдаче приходит нулевой счетчик(нет задач), то такой блок скрывается и не тоображается в МП. Соответственно, если у всех плиток в стеке стоит hideOnZeroCount = 1 и у всех элементов в отдаче приходит нулевой счетчик(нет задач), то такая папка скрывается целиком при отрисовке дэша.
•Если в плитке пришел не пустой массив задач и hideOnZeroCount = 1, то размеры блока подстраивается под пришедшее количество задач. Ячейки и их размеры под контент задач идентичны.
•При нажатии на ячейку такого рода происходит переход на МТФ задачи.
dashboardBanner
Скрываемый баннер с кастомной ссылкой
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000. Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
title |
заголовок |
titleColor |
цвет заголовка плитки. выражение вида #000000 или список для выбора таких преднастроенных значений |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
actionStyle |
стиль отображения при нажатии. Возможные значения: •push (переход), •popup (всплывающее окно) |
objectId |
id объекта для открытия |
urlPath |
ссылка, которая будет открываться по нажатию на плитку. Если не указана, то плитка не кликабельна |
text |
текст, накладываемый поверх медиа контента |
userHideGuid |
позволяет пользователю прятать просмотренные баннеры локально |
dashboardCustomURL
Шаблон для блока с ссылкой, прописанной в интерфейсе администрирования
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
footerTitle |
заголовок плитки |
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп. В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
iconColor |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка плитки, выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
allowPreviewInteraction |
С помощью данного параметра мы определяем взаимодействие с контентом. Если 1, то пользователь может взаимодействовать с контентом (previewURL) внутри фрейма (блока на дэше). Любые нажатия будут происходить внутри фрейма, даже переходы по ссылкам. |
autoHeight |
высота определяется автоматически по контенту |
bgImageUploadId |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
bgImageURL |
высота плитки в условных единицах |
cellTitleFontSize |
название одного из преднастроенных значков, который будет отображаться на плитке |
isButton |
если 1, то значит при нажатии на плитку мп не переходит по ссылке URLPath, а просто запускает асинхронный запрос по указанной ссылке (это для post публикаций делается, чтобы запустить какой-то фоновый процесс на бэке). Иначе просто дает переход по URLPath |
openInBrowser |
открытие ссылок вне МП (в браузере) |
phone |
номер телефона для звонка в формате +74951234567 |
previewURL |
ссылка для отображения webView внутри плитки (может и совпадать с URLPath) Вся верстка будет приходить в таком случае с сайта по указанной ссылке |
URLPath |
ссылка, которая будет открываться по нажатию на плитку. Если не указана, то плитка не кликабельна |
dashboardSignatures
Плитка подписей с возможным ограничением на группы
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
fallBackTitle |
заголовок плитки |
footerTitle |
текст подвала (нижней части) |
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
iconColor |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка плитки, выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
actionStyle |
стиль отображения при нажатии. Возможные значения: •push (переход), •popup (всплывающее окно) |
autoHeight |
высота определяется автоматически по контенту |
bgImageUploadId |
изображение фона |
bgImageURL |
URL адрес на изображение фона с анонимным доступом |
cellCounterFontSize |
размер шрифта счетчика |
cellIconSize |
размер иконки, значение по умолчанию: 16 Если не заданы в плитке, то берутся из настроек контейнера. |
cellStyle |
стиль ячейки. Возможные значения: default/custom. Если не задано — то default. |
cellTitleFontSize |
размер шрифта для заголовка, по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста плитки |
click |
json описания нажатий на разные части плитки |
context |
контекст, который будет браться из настроенного динамического шаблона |
emptyContentTitle |
|
excludeSubcatIds |
список категорий для исключения из показа |
forbidCreateTask |
признак запрета на создание задач. 0 — запрета на создание задач нет, 1 — запрет на создание задач есть |
hideCounter |
возможность скрыть счётчик 0 — не включено 1 — включено Если цвет не задан, то он автоматически подтягивается от цвета текста заголовка плитки titleColor Счетчик идет слева от иконки, если иконки нет — счетчик сдвигается на ее место. Счетчик отображается в виде тикера — в круге/овале, цвет фона тикера берется как цвет текста счетчика с альфой 0.3 |
hideOnZeroCount |
признак, который определяет, будет ли плитка отображаться на рабочем столе при нулевом счетчике 0 — отображается только при ненулевом счетчике, 1 — отображается всегда |
includeSubcatIds |
список категорий для показа |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
showAcceptAll |
показ кнопки "Подписать все" в списке подписей (кнопка отображается если подписей больше 1). По нажатию кнопки выносится резолюция "Согласовать" по всем подписям, которые в момент нажатия отображаются в списке (например, если включен отбор по категориям, то будут согласованы только отобранные подписи). После нажатия кнопки запрашивается дополнительное подтверждение |
showCategoryFilter |
показ кнопки отбора подписей по категориям.можно выбрать одну или несколько категорий, и тогда в списке останутся только подписи, запрошенные в этих категориях |
slideShow |
признак автоматического прокручивания элементов в виде "карусели" |
subcatId |
ID категории для создания задачи |
taskFilter |
фильтр (json для task/feeds) |
tileCornerRadius |
радиус углов плиток (по умолчанию 6 pt) |
tileSpacing |
отступ от края экрана |
dashboardStack
Стек элементов дэшборда (объект палитры — Папка). Используется для создания иерархии вложенных элементов
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
iconColor |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка плитки, выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
cellTitleFontSize |
размер шрифта для заголовка, по умолчанию 1 |
colCount |
число колонок |
separatorColor |
задание цвета сепаратора в квадратном стеке |
showIconCircle |
показ круга вокруг иконки |
showSeparators |
показ разделителей между элементами |
style |
вертикальный/горизонтальный |
tileCornerRadius |
радиус углов плиток (по умолчанию 6 pt) |
tileSpacing |
отступ от края экрана |
Особенности при настройке dashboardStack
Общая логика рисования иконки и круга:
Если круга нет, то рисуются просто иконки, но чаще всего при настройке указывают сразу иконку.
Параметры шаблона для UI любого элемента, которые попадают в стек:
fallBackTitle — заголовок в плитке (максимум 2 строки)
headerBackgroundColor — цвет фона ячейки (по умолчанию пустой, определяется цветом стека в целом)
icon — название иконки, хранящейся в БД
cellIconSize — размер иконки
iconColor — цвет иконки
titleColor — цвет текста (если не задан, то берем из titleColor стека)
Вертикальный блок
Особенности настройки блока по параметрам:
В текущем кейсе style = vertical
showSeparators — 1/0 — небходимость рисовать тонкие разделители между элементами по вертикали
heightMultiplier — высота стека, будет являться суммой всех блоков внутри папки.
headerBackgroundColor — цвет фона стека в целом, если не задано, то белый по умолчанию.
Обратите внимание: в вертикальном стеке headerBackgroundColor применяется только к фону иконки, а не к ячейке в целом.
cellTitleFontSize — размер заголовков в ячейках таблицы, может быть переопределен в самом блоке
titleColor — цвет текста в ячейках, по умолчанию черный
Внутри папки может быть любое число блоков. Блок может быть абсолютно любой, как и в общем дереве дэша. |
---|
Есть возможность настроить вертикальный блок, где созданные задачи будут выступать вложенными блоками папки. Для этого нужно задать при редактировании папки количество задач, которые будут отображаться в вертикальном стеке.
В таком случае МП будет подстраивать отображаемый стек под количество задач из источника и названиями таких плиток будут выступать названия этих же задач.
Вариант настройки на примере плитки Ближайшая ВКС встреча
Горизонтальный блок
В текущем кейсе style = horizontal
Внутри папки может быть от 1 до 4 блоков (не более)
Блок может быть абсолютно любой, как в общем дереве дэша.
Выравнивание в стеке идет по центральной линии. Положение иконки фиксированное. Блоки в стеке распределяются равноудаленно.
Есть возможность настроить действие при нажатии на стек через onTap.
menu
Шаблон экрана меню.
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
fallBackTitle |
заголовок |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
containerBackgroundColor |
заголовок |
rightBarButtons |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
showStyle |
ширина в условных единицах |
menuItem
Шаблон одного пункта меню.
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
title |
заголовок |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
cellStyle |
стиль ячейки. Возможные значения default/custom, если не задано — то default |
context |
контекст, который будет браться из настроенного динамического шаблона |
menuSeparator
Шаблон разделительной линии между пунктами меню. Не содержит данных и выглядит как пустая ячейка меню высотой 20px
settings
Контейнер настроек
settingsItem
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
type |
тип ключа настроек |
value |
значение ключа настроек |
tasksFeed
Контейнер для задания содержимого и вида лент задач.
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
fallBackTitle |
заголовок плитки |
footerTitle |
текст подвала (нижней части) |
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
topTitle |
альтернативный заголовок в верхнем баре. Если он не задан, то берется заголовок такой же, как в заголовке нижнего бара |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
addButton |
|
catId |
ID категории |
cellStyle |
стиль ячейки. Возможные значения default/custom, если не задано — то default. |
feedType |
тип ленты задач. Возможные значения: •All •Owner •Performer •Favorites •Overdue •Discussions •Created •New •Likes •LastCommented •PinnedToChat •PrivateChat •GroupChat |
interactions |
|
searchType |
Тип поиска по тексту задачи Возможные значения: •like •fullText •contains |
showCreateButton |
показывать кнопку создания задачи |
showSearchButton |
показывать иконку лупы, кнопку поиска |
showTabMenuButton |
кнопка показа popup меню из таббара |
subcatId |
ID категории для создания задачи |
tickerAlias |
название счетчика. Возможные значения: •overDueTasksCount •myQuestionsCount •unreadCommentsCount •questionsCount •questionsCount •signaturesCount •directorSignaturesCount •overdueSigns •missedCalls •milestones •unreadChatCommentsCount •badge •allTasksUserOwns •allTasksUserPerforms •95 |
viewMode |
Возможные значения: •default •calendar |
taskSourceDashboardItem
Плитка источника данных с возможностью выбора типа отображения списка
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
fallBackTitle |
заголовок плитки |
footerTitle |
текст подвала (нижней части) |
groups |
группы, для которых виджет должен отображаться. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
iconColor |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
textColor |
цвет текста в блоке, выражение вида #000000 |
titleColor |
цвет заголовка плитки, выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
actionStyle |
стиль отображения при нажатии. Возможные значения: •push (переход), •popup (всплывающее окно) |
autoHeight |
высота определяется автоматически по контенту |
bgImageUploadId |
изображение фона |
bgImageURL |
URL адрес на изображение фона с анонимным доступом |
cellCounterFontSize |
размер шрифта счетчика |
cellIconSize |
размер иконки, значение по умолчанию: 16 Если не заданы в плитке, то берутся из настроек контейнера. |
cellStyle |
стиль ячейки. Возможные значения default/custom, если не задано — то default. |
cellTitleFontSize |
размер шрифта для заголовка, по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста плитки |
click |
json описания нажатий на разные части плитки |
context |
контекст, который будет браться из настроенного динамического шаблона |
disabled |
выключение нажатия на плитку. если 1, то нажатие на плитку ничего не делает. если 0, то обычное нажатие и дальнейшее проваливание в плитку |
dataSourseUrl |
ссылка на публикацию |
emptyContentTitle |
|
forbidCreateTask |
признак запрета на создание задач 0 — запрета на создание задач нет, 1 — запрет на создание задач есть |
hideCounter |
возможность скрыть счётчик. 0 — не включено 1 — включено Если цвет не задан, то он автоматически подтягивается от цвета текста заголовка плитки titleColor Счетчик идет слева от иконки. если иконки нет — счетчик сдвигается на ее место. Счетчик отображается в виде тикера — в круге/овале, цвет фона тикера берется как цвет текста счетчика с альфой 0.3 |
hideOnZeroCount |
признак, который определяет, будет ли плитка отображаться на рабочем столе при нулевом счетчике 0 — отображается только при ненулевом счетчике, 1 — отображается всегда |
needConfirm |
ключ, отвечающий за отображение кнопок Отменить/Подтвердить под баннером с текстом с onTapAlert если значение равно 1 и onTapAlert не пустая строка, то вместо алерта показываем конферм с текстом onTapAlert, две кнопки "Отменить" и "Подтвердить". После нажатия Подтвердить просизодит переход в плитку |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
objectId |
ID объекта для открытия |
onTapAlert |
сообщение при нажатии неактивной плитки. Связано с параметром needConfirm. При нажатии на плитку появляется алерт с данным текстом (если disabled = 0, то алерт отображается формально и совершается переход в плитку) |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
objectId |
ID объекта для открытия |
onTapAlert |
сообщение при нажатии неактивной плитки. Связано с параметром needConfirm. При нажатии на плитку появляется алерт с данным текстом (если disabled = 0, то алерт отображается формально и совершается переход в плитку) |
parentTaskId |
задача-шаблон, из которой копируется ДП |
showSingleTask |
признак, определяющий отображение плитки, если в списке содержится всего одна задача 0 — отображается плитка со списком из одной задачи, 1 — отображается сама задача |
showTaskOrCreate |
признак, который определяет поведение при отсутствии задач для отображения 0 — ничего не отображать 1 — создать новую задачу и отобразить ее |
showTaskOrNTF |
признак, который определяет поведение при отсутствии задач для отображения showTaskOrCreate у нас имел смысл автоматического создания задачи в категории сорса и открытия ее МТФ. А showTaskOrNTF означает открыть задачу или же ее НТФ чтобы явно создать эту задачу. Есть у тебя плитка "подать заявку", первый раз ты создашь заявку. а дальше будет уже ее открывать и следить за статусом |
slideShow |
признак автоматического прокручивания элементов в виде "карусели" |
subcatId |
ID категории для создания задачи |
taskTemplateName |
название шаблона задач, содержащихся в отдачи данного источника данных Возможные значения: •План развития •Чеклист •Событие |
taskFilter |
фильтр (json для task/feeds) |
tileCornerRadius |
радиус углов плиток, по умолчанию 6 pt |
tileSpacing |
отступ от края экрана |
UrlPath |
ссылка, которая будет открываться по нажатию на плитку. Если не указана, то плитка не кликабельна |
toolbar
Шаблон нижнего меню (меню вкладок)
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
containerBackgroundColor |
цвет фона контейнера в целом |
itemColor |
цвет элемента на таббаре |
selectedItemColor |
цвет выделенного элемента |
toolbarItem
Шаблон кнопки нижнего меню
Общие ключи шаблона:
Общие ключи |
Описание |
---|---|
badgeItemColor |
цвет элемента значка |
fallBackTitle |
заголовок плитки |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
addButton |
|
context |
контекст, который будет браться из настроенного динамического шаблона |
interactions |
|
objectId |
ID объекта для открытия |
parentTaskId |
задача-шаблон, из которой копируется ДП |
isDefault |
вкладка по умолчанию |
showTabMenuButton |
показ кнопки popup в таб меню |
topTitle |
альтернативный заголовок в верхнем баре. Если он не задан, то берется заголовок такой же, как в заголовке нижнего бара |
onLongTap |
json описывающий модалку при длинном нажатии на элемент таббара |
onTap |
json onTap actions |
userAreaFolder
Шаблон элемента с информацией об аккаунте: имя пользователя, аватар и название "Первой Формы"
Ключ: title — заголовок
userProfile
Шаблона для представлений профиля пользователя
Специфичные ключи (характерные для данного шаблона):
Специфичные ключи |
Описание |
---|---|
bgImageURL |
URL адрес на изображение фона с анонимным доступом |
cellIconSize |
размер иконки, значение по умолчанию: 16 Если не заданы в плитке, то берутся из настроек контейнера. |
cellTitleFontSize |
размер шрифта для заголовка, по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста плитки |
fallbackTitle |
заголовок плитки |
groups |
ID групп через запятую. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка, выражение вида #000000 Если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
icon |
признак автоматического прокручивания элементов в виде "карусели" |
iconColor |
ID категории для создания задачи |
showVCardQR |
показать QR код VCard на профиль текущего пользователя. showVCardQR = 1 дает нам понять, что нужно открывать при нажатии QR коде с визиткой Если showVCardQR = 0, то просто открывается профиль для аккаунта данного дэша. |
tileCornerRadius |
радиус углов плиток, по умолчанию 6 pt |
tileSpacing |
отступ от края экрана |
titleColor |
цвет заголовка плитки, выражение вида #000000 или список для выбора таких преднастроенных значений |
verticalGradientColor |
вертикальный градиент в плитке, строка вида #00000066 (или #0006) |
widthRatio |
ширина в условных единицах |
Ключи в шаблонах
Ключ |
Описание |
Возможные значения |
---|---|---|
addButton |
json для обозначения действий onTap при нажатии на иконку плюса в категории. |
"addButton": [ {"action": "openNewTask", "id": 3020, "context": "cat+text"}] |
actionStyle |
стиль отображения при нажатии |
Возможные значения: •push (переход), •popup (всплывающее окно) |
allowPreviewInteraction |
С помощью данного параметра мы определяем взаимодействие с контентом. Если 1, то пользователь может взаимодействовать с контентом (previewURL) внутри фрейма (блока на дэше). Любые нажатия будут происходить внутри фрейма, даже переходы по ссылкам. |
•0 •1 |
autoHeight |
высота определяется автоматически по контенту |
•0 •1 |
badgeItemColor |
цвет элемента значка |
строка |
bgImage |
изображение фона |
строка |
bgImageURL |
URL андрес на изображение фона с анонимным доступом |
строка |
bgImageUploadId |
UploadId хранящегося на сервере изображения фона с анонимным доступом |
число |
cellCounterFontSize
|
размер шрифта счетчика |
по умолчанию 15 Если не заданы в плитке, то берутся из настроек контейнера. |
cellIconSize |
размер иконки |
по умолчанию 16 Если не заданы в плитке, то берутся из настроек контейнера. |
cellStyle |
стиль ячейки |
Возможные значения default/custom. если не задано — то default. Если в task source стоит cellStyle = default, то мы его открывает ровно как сейчас — типовые ячейки Если же cellStyle = custom, то мы должны каждую ячейку показать согласно ее шаблону CELL (краткое представление в шаблонизаторе). |
cellTitleFontSize |
размер шрифта для заголовка |
по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста задач |
|
click |
json описания нажатий на разные части плитки |
строка |
colCount |
число колонок |
строка |
containerBackgroundColor |
цвет фона контейнера в целом |
выражение вида #000000 или список для выбора таких преднастроенных значений если значение не указано — цвет остаётся белым |
context |
контекст, который будет браться из настроенного динамического шаблона |
строка |
dataSourceUrl |
ссылка на публикацию |
строка |
emptyContentTitle |
строка |
|
excludeSubcatIds |
список категорий для исключения из показа |
строка |
extParamFilters |
строка |
|
extParamLink |
число |
|
fallBackText |
вторая строка текста в плитке, после заголовка |
строка |
fallBackTitle |
заголовок плитки |
строка если поле оставлено пустым, то заголовок плитки может формироваться автоматически исходя из названия категории, профиля пользователя или иных источников данных |
feedType
|
типы лент задач |
Возможные значения: •All •Owner •Performer •Favorites •Overdue •Discussions •Created •New •Likes •LastCommented •PinnedToChat •PrivateChat •GroupChat |
footerTitle |
текст подвала (нижней части) |
строка |
forbidCreateTask |
признак запрела на создание задач |
0 — запрета на создание задач нет, 1 — запрет на создание задач есть |
groups |
группы, для которых виджет должен отображаться |
ID групп через запятую. Если значения нет, то плитка отображается для всех групп В плитках может приходить не пустой массив id групп для параметра groups. Если он непустой, то МП определяет пересечение групп текущего сессионного пользователя и массива groups. Если пересечение пустое, то такие элементы не отображаются на экране. |
headerBackgroundColor |
цвет фона заголовка |
выражение вида #000000 если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
целое или десятичное число1 условная единица — это 1/3 ширины экрана в режиме "портрет". В случае шаблона dashboardStack значение параметра определяется как сумма всех блоков внутри папки |
hideCounter |
возможность скрыть счётчик |
0 — не включено 1 — включено Если цвет не задан, то он автоматически подтягивается от цвета текста заголовка плитки titleColor Счетчик идет слева от иконки. если иконки нет — счетчик сдвигается на ее место. Счетчик отображается в виде тикера — в круге/овале, цвет фона тикера берется как цвет текста счетчика с альфой 0.3 |
hideOnZeroCount |
признак, который определяет, будет ли плитка отображаться на рабочем столе при нулевом счетчике |
0 — отображается только при ненулевом счетчике, 1 — отображается всегда |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
icon and iconColor переопределяются в плитке, и если не заданы, то их значения смотрит в template уровня выше |
iconColor |
цвет иконки |
строка |
includeSubcatIds |
список категорий для показа |
строка |
isAnimated |
0 — не включено 1 — включено |
|
isButton |
кнопка |
Используется в шаблоне dashboardCustomURL. 0 — по нажатию на блок ссылка открывается, 1 — по нажатию на блок ссылка выполняется. Имеет смысл, если в качестве ссылки задан адрес публикации с пакетом действий (запускается асинхронный запрос по указанной ссылке) |
isDefault |
вкладка по умолчанию |
0 — не включено 1 — включено |
itemColor |
цвет вкладки |
строка |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
строка |
listDescription |
строка |
|
objectId |
id объекта для открытия |
|
onLongTap |
удерживание нажатия |
строка |
onRepeatedTap |
двойное нажатие |
строка |
onTap |
json для обозначения действий при нажатии на ячейку задачи в категории |
"onTap": {"action": "openTask", "context": "cat+text"} |
openInBrowser |
открытие ссылок вне МП (в браузере) |
0 — не включено 1 — включено |
parentTaskId |
задача шаблон, из которой копировать ДП |
число |
phone |
номер телефона для звонка в формате +74951234567 |
строка |
previewURL |
ссылка для отображения webView внутри плитки (может и совпадать с URLPath) Вся верстка будет приходить в таком случае с сайта по указанной ссылке |
строка |
rightBarButtons |
JSON onTap |
строка |
searchType |
тип поиска по тексту задачи |
Возможные значения: •like •fullText •contains |
selectedItemColor |
цвет выделенной вкладки |
строка |
separatorColor |
задание цвета сепаратора в квадратном стеке |
выражение вида #000000 |
showAcceptAll |
показ кнопки "Подписать все" в списке подписей (кнопка отображается если подписей больше 1). по нажатию кнопки выносится резолюция "Согласовать" по всем подписям, которые в момент нажатия отображаются в списке (например, если включен отбор по категориям, то будут согласованы только отобранные подписи). после нажатия кнопки запрашивается дополнительное подтверждение |
Используется в шаблоне dashboardSignatures. 0 — не включено 1 — включено |
showCategoryFilter |
показ кнопки отбора подписей по категориям. можно выбрать одну или несколько категорий, и тогда в списке останутся только подписи, запрошенные в этих категориях |
0 — не включено 1 — включено |
showCreateButton |
показ кнопки "создать" |
0 — не включено 1 — включено |
showExtraInfo |
показ доп. информации в рейтинге |
0 — не включено 1 — включено |
showIconCircle |
показ круга вокруг иконки |
0 — не включено 1 — включено |
showNotificationsBarButton |
показа панели уведомлений |
строка |
showRatingBars |
показ рейтинга |
строка |
showSearchButton |
показ кнопки поиска |
0 — не включено 1 — включено |
showSeparators |
показ разделителей между элементами |
0 — не включено 1 — включено |
showSingleTask |
признак, определяющий отображение плитки, если в списке содержится всего одна задача |
0 — отображается плитка со списком из одной задачи, 1 — отображается сама задача |
showStyle |
тип анимации |
Возможные значения: •expand — элемент возникает •push — элемент появляется снизу |
showTabMenuButton |
показ кнопки popup в таб меню |
0 — не включено 1 — включено |
showTaskOrCreate |
признак, который определяет поведение при отсутствии задач для отображения |
0 — ничего не отображать 1 — создать новую задачу и отобразить ее |
showTaskOrCreate |
признак, который определяет поведение при отсутствии задач для отображения |
showTaskOrNTF означает открыть задачу или же ее НТФ, чтобы создать эту задачу. |
showTileBorderShadow |
отображение тени для виджета на рабочем столе |
0 — не отображать 1 — отображать |
showVCardQR |
показать QR код VCard на профиль текущего пользователя |
0 — не включено 1 — включено |
slideShow |
признак автоматического прокручивания элементов в виде "карусели" |
0 — не включено 1 — включено |
style |
для шаблона dashboardStack — расположение элементов в блоке |
Возможные значения: •vertical •horizontal •square |
subcatId |
ID категории для создания задачи |
число |
taskFilter |
фильтр (json для task/feeds) |
строка |
taskTemplateName |
название шаблона задач, содержащихся в отдачи данного источника данных |
Возможные значения: •План развития •Чеклист •Событие |
text |
текст, накладываемый поверх медиа контента |
строка |
textColor |
цвет текста в блоке |
выражение вида #000000 |
tickerAlias |
название счетчика |
Возможные значения: •overDueTasksCount •myQuestionsCount •unreadCommentsCount •questionsCount •overDueTasksCount •signaturesCount •directorSignaturesCount •overdueSigns •missedCalls •milestones •unreadChatCommentsCount •badge •allTasksUserOwns •allTasksUserPerforms •95 |
tileCornerRadius |
радиус углов плиток (по умолчанию 6 pt) |
строка |
tileSpacing |
отступ от края экрана |
строка |
title |
заголовок |
строка |
titleColor |
цвет заголовка виджета |
выражение вида #000000 или список для выбора таких преднастроенных значений |
tileCornerRadius |
радиус закругления углов плиток |
число |
topTitle |
альтернативный заголовок в верхнем баре. Если он не задан, то берется заголовок такой же, как в табе нижнего бара |
строка |
type |
тип ключа настроек |
|
URLPath |
ссылка, которая будет открываться по нажатию на плитку |
строка со ссылкой относительно приложения |
userExtFieldKey |
строка |
|
userGroups |
строка |
|
userHideGuid |
позволяет пользователю прятать просмотренные баннеры локально |
строка |
usersCount |
строка |
|
value |
значение ключа настроек |
строка |
verticalGradientColor |
вертикальный градиент в плитке |
строка вида #00000066 (или #0006) |
viewMode |
режим отображения |
Возможные значения: •default •calendar |
widthRatio |
ширина в условных единицах |
Всего в один ряд по горизонтали можно расположить не более трех плиток. Поэтому 1 условная единица — это 1/3 ширины экрана в режиме "портрет". Возможные значения для ширины плитки: •1 — плитка в 1/3 ширины экрана; •1.5 — плитка в 1/2 ширины экрана; •2 — плитка в 2/3 ширины экрана; •3 — плитка в полную ширину экрана; •4 — плитка в полную ширину дашборда. Может быть больше ширины экрана, и тогда используется "листание". Используется, например, для плитки "карусель" ("барабан"). По умолчанию значение равно 1 |