Устаревшее |
---|
Обработка шаблона и его ключей настраивается в коде приложения. Любые изменения, вносимые в шаблон, должны строго соответствовать тому, что заложено в коде приложения. Редактирование шаблона обычно производится специалистами ТП "Первой Формы". В процессе развития приложения и расширения его возможностей набор ключей для существующих шаблонов может расширяться. Однако при обновлении платформы "Первая Форма" новые ключи для существующих шаблонов не добавляются автоматически, и при необходимости их надо добавлять вручную, в соответствии с эталонными настройками. |
---|
Преднастроенные шаблоны
Id |
Описание |
Ключи |
---|---|---|
contactsFolder |
Шаблон для папки с выбранными контактами |
•fallBackTitle •headerBackgroundColor •widthRatio |
dashboard |
Шаблон экрана рабочего стола. Выбор плиток по порядку |
•bgImage •bgImageURL •cellCounterFontSize •cellIconSize •cellTextFontSize •cellTitleFontSize •containerBackgroundColor •fallBackTitle •groups •headerBackgroundColor •heightMultiplier •icon •iconColor •rightBarButtons •showNotificationsBarButton •showStyle •showTileBorderShadow •textColor •tileCornerRadius •tileSpacing •titleColor •verticalGradientColor •widthRatio |
dashboardBanner |
Скрываемый баннер с кастомной ссылкой |
•actionStyle •headerBackgroundColor •heightMultiplier •icon •objectId •text •textColor •title •titleColor •urlPath •userHideGuid •widthRatio |
dashboardCustomURL |
Шаблон для блока со ссылкой, прописанной в интерфейсе администрирования |
•allowPreviewInteraction •autoHeight •bgImageURL •fallBackTitle •headerBackgroundColor •heightMultiplier •icon •iconColor •isButton •openInBrowser •phone •previewURL •titleColor •URLPath •verticalGradientColor •widthRatio |
dashboardItem |
Шаблон одной плитки рабочего стола |
•actionStyle •autoHeight •badgeItemColor •bgImageUploadId •bgImageURL •cellCounterFontSize •cellIconSize •cellStyle •cellTitleFontSize •click •context •emptyContentTitle •fallBackTitle •footerTitle •forbidCreateTask •groups •headerBackgroundColor •heightMultiplier •hideCounter •hideOnZeroCount •icon •iconColor •leftEdgeColor •slideShow •subcatId •taskFilter •textColor •tileCornerRadius •tileSpacing •titleColor •titleExtParamId •verticalGradientColor •widthRatio |
dashboardItemUserExtParamList |
Шаблон списка пользователей, сгруппированного или отсортированного по одному из расширенных полей профиля, заданному в шаблоне |
•barColor •barWidth •bgImageURL •circleColor •detailsKey •fallBackText •fallBackTitle •headerBackgroundColor •heightMultiplier •icon •isAnimated •isAscendingSortOrder •listDescription •showExtraInfo •showRatingBars •showWithMe •textColor •titleColor •userExtFieldKey •userGroups •usersCount •verticalGradientColor •widthRatio |
dashboardSignatures |
Плитка подписей с возможным ограничением на группы |
•actionStyle •badgeItemColor •excludeSubcatIds •fallBackTitle •headerBackgroundColor •heightMultiplier •hideOnZeroCount •icon •iconColor •includeSubcatIds •showAcceptAll •showCategoryFilter •textColor •tileCornerRadius •tileSpacing •titleColor •verticalGradientColor •widthRatio |
dashboardStack |
Стек элементов дашборда (элемент палитры — Папка) |
•cellTitleFontSize •colCount •groups •headerBackgroundColor •heightMultiplier •separatorColor •showIconCircle •showSeparators •style •tileCornerRadius •widthRatio |
dashboardSubcatMultiFilter |
Иерархический показ категории по нескольким ДП, в конце открываем ссылку из ДП |
•extParamFilters •extParamLink •fallBackTitle •headerBackgroundColor •heightMultiplier •icon •widthRatio |
menu |
Шаблон экрана меню |
•containerBackgroundColor •fallBackTitle •rightBarButtons •showStyle |
menuItem |
Шаблон одного пункта меню |
•cellStyle •context •groups •icon •title |
menuSeparator |
Шаблон разделительной линии между пунктами меню. Не содержит данных и выглядит как пустая ячейка меню высотой 20px |
нет |
orgStructureItem |
Шаблон орг. структуры |
•fallBackTitle •headerBackgroundColor •heightMultiplier •icon •orgId •widthRatio |
settings |
Контейнер настроек |
нет |
settingsItem |
Элемент настроек |
•type •value |
tasksFeed |
Контейнер для задания содержимого и вида лент задач |
•badgeItemColor •cellStyle •fallBackTitle •feedType •groups •headerBackgroundColor •heightMultiplier •icon •searchType •showCreateButton •showSearchButton •showTabMenuButton •tickerAlias •viewMode •widthRatio |
taskSourceDashboardItem |
Плитка источника данных с возможностью выбора типа отображения списка |
•actionStyle •autoHeight •bgImageUploadId •bgImageURL •cellCounterFontSize •cellIconSize •cellStyle •cellTitleFontSize •click •context •dataSourceUrl •emptyContentTitle •fallBackTitle •footerTitle •forbidCreateTask •groups •headerBackgroundColor •heightMultiplier •hideCounter •hideOnZeroCount •icon •iconColor •leftEdgeColor •objectId •parentTaskId •showSingleTask •showTaskOrCreate •slideShow •subcatId •taskTemplateName •textColor •tileCornerRadius •tileSpacing •titleColor •urlPath •verticalGradientColor •widthRatio |
toolbar |
Шаблон нижнего меню (меню вкладок) |
•badgeItemColor •containerBackgroundColor •itemColor •selectedItemColor |
toolbarItem |
Шаблон кнопки нижнего меню |
•badgeItemColor •context •fallBackTitle •icon •isDefault •onLongTap •onRepeatedTap •onTap |
userAreaFolder |
Шаблон элемента с информацией об аккаунте: имя пользователя, аватар и название "Первой Формы" |
•title |
Ключи в шаблонах
Ключ |
Описание |
Возможные значения |
---|---|---|
actionStyle |
стиль отображения при нажатии |
Возможные значения: •push (переход), •popup (всплывающее окно) |
allowPreviewInteraction |
•0 •1 |
|
autoHeight |
высота определяется автоматически по контенту |
•0 •1 |
badgeItemColor |
цвет элемента значка |
строка |
barColor |
строка |
|
barWidth |
число |
|
bgImage |
изображение фона |
строка |
bgImageURL |
URL андрес на изображение фона с анонимным доступом |
строка |
bgImageUploadId |
число |
|
cellCounterFontSize
|
размер шрифта счетчика |
по умолчанию 20 |
cellIconSize |
размер иконки |
по умолчанию 24 |
cellStyle |
стиль ячейки |
Возможные значения: •default — для всех задач в списке применяется единый шаблон по умолчанию, •custom — если в категории настроен свой шаблон, то он будет использоваться для вывода задачи; если шаблон в категории не настроен, будет использоваться шаблон по умолчанию. Используется для вывода списка задач из источника данных (TaskSource), подробнее см. в разделе Источники данных задач |
cellTitleFontSize |
размер шрифта для заголовка |
по умолчанию 15 |
cellTextFontSize |
размер шрифта для текста задач |
|
click |
json описания нажатий на разные части плитки |
строка |
colCount |
число колонок |
строка |
containerBackgroundColor |
цвет фона контейнера в целом |
выражение вида #000000 или список для выбора таких преднастроенных значений если значение не указано — цвет остаётся белым |
context |
строка |
|
dataSourceUrl |
ссылка на публикацию |
строка |
detailsKey |
||
emptyContentTitle |
строка |
|
excludeSubcatIds |
список категорий для исключения из показа |
строка |
extParamFilters |
строка |
|
extParamLink |
число |
|
fallBackText |
вторая строка текста в плитке, после заголовка |
строка |
fallBackTitle |
заголовок плитки |
строка если поле оставлено пустым, то заголовок плитки может формироваться автоматически исходя из названия категории, профиля пользователя или иных источников данных |
feedType
|
типы лент задач |
Возможные значения: •All •Owner •Performer •Favorites •Overdue •Discussions •Created •New •Likes
|
footerTitle |
текст подвала (нижней части) |
строка |
forbidCreateTask |
признак запрела на создание задач |
0 — запрета на создание задач нет, 1 — запрет на создание задач есть |
groups |
группы, для которых виджет должен отображаться |
ID групп через запятую. если значения нет, то плитка отображается для всех групп |
headerBackgroundColor |
цвет фона заголовка |
выражение вида #000000 если значение не указано — цвет будет прозрачным |
heightMultiplier |
высота плитки в условных единицах |
целое или десятичное число 1 условная единица — это 1/3 ширины экрана в режиме "портрет" |
hideCounter |
возможность скрыть счётчик |
0 — не включено 1 — включено |
hideOnZeroCount |
признак, который определяет, будет ли плитка отображаться на рабочем столе при нулевом счетчике |
0 — отображается только при ненулевом счетчике, 1 — отображается всегда |
icon |
название одного из преднастроенных значков, который будет отображаться на плитке |
|
iconColor |
цвет иконки |
строка |
includeSubcatIds |
список категорий для показа |
строка |
isAnimated |
0 — не включено 1 — включено |
|
isAscendingSortOrder |
строка |
|
isButton |
кнопка |
Используется в шаблоне dashboardCustomURL. 0 — по нажатию на блок ссылка открывается, 1 — по нажатию на блок ссылка выполняется (имеет смысл, если в качестве ссылки задан адрес публикации с пакетом действий) |
isDefault |
вкладка по умолчанию |
0 — не включено 1 — включено |
itemColor |
цвет вкладки |
строка |
leftEdgeColor |
цвет левой границы ячеек дашбоарда |
строка |
listDescription |
строка |
|
onLongTap |
удерживание нажатия |
строка |
onRepeatedTap |
двойное нажатие |
строка |
onTap |
строка |
|
openInBrowser |
открытие ссылок вне МП |
0 — не включено 1 — включено |
orgId |
строка |
|
parentTaskId |
задача шаблон, из которой копировать ДП |
число |
phone |
номер телефона для звонка в формате +74951234567 |
строка |
previewURL |
ссылка для отображения webView в плитке |
строка |
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 — создать новую задачу и отобразить ее |
showTileBorderShadow |
отображение тени для виджета на рабочем столе |
0 — не отображать 1 — отображать |
showWithMe |
строка |
|
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 |
радиус закругления углов плиток |
число |
title |
название |
строка |
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 |