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

AppointmentsToExternal_HandleOpenExternalConnection

Флажок. Значение true включает обработку события открытия соединения с Exchange, а false — отключает

AppointmentsToExternal_NotSyncedAppointmentsLimit

Лимит встреч, которые нужно выгружать при обновлении внешних встреч по встречам, которые не были обновленны при стандартном процессе работы. Максимальное число необновленных календарных событий, которые синхронизируются из "Первой Формы" в Exchange при открытии соединения

По умолчанию — 100, рекомендуется сократить до 10.

AppointmentsToTasks_NotSyncedAppointmentsLimit

Лимит встреч, которые нужно выгружать при постановке задач по встречам, которые не были поставленны при стандартном процессе работы.

По умолчанию — 50, рекомендуется сократить до 10.

AppointmentsToTasks_FutureDaysLimit

Число дней, в течение которых синхронизируются календарные события между "Первой Формой" и Exchange (вперед, начиная с текущей даты). Календарные события, которые должны произойти после завершения данного периода, будут созданы позднее.

По умолчанию — 180

AppointmentsToTasks_OccurrencesCountLimit

Число повторений, которые создаются для повторяющегося календарного события, если в самой повторяющейся задаче в блоке "Продолжительность" выбрано "Без ограничений" (см. настройка повторений в пользовательском интерфейсе).

По умолчанию — 50

AppointmentsToTasks_OccurrencesDaysLimit

Число дней, в течение которых повторяется календарное событие, если в самой повторяющейся задаче в блоке "Продолжительность" выбрано "Без ограничений" (см. настройка повторений в пользовательском интерфейсе).

По умолчанию — 180

BrandSettings

Настройки корпоративного логотипа из общих настроек приложения:

•Путь к логотипу на странице авторизации

•Путь к логотипу (SPA) горизонтальная панель

•Ширина логотипа (SPA) горизонтальная панель

•Высота логотипа (SPA) горизонтальная панель

•Путь к логотипу (SPA) горизонтальная панель, темная тема

•Путь к логотипу (SPA) вертикальная панель, темная тема

•Путь к логотипу (SPA) вертикальная панель

•Ширина логотипа (SPA) вертикальная панель

•Высота логотипа (SPA) вертикальная панель

Структура ключа:

{

 "logo": {

   "authPage": {"general": {"path": string}},

   "horizontalPannel": {

     "width": int,

     "height": int

     "light": {"path": string},

     "dark": {"path": string},

   },

   "verticalPannel": {

     "width": int,

     "height": int

     "light": {"path": string},

     "dark": {"path": string},

   }

 }

}

Ключ не предполагает редактирование.

CalendarExtparams

Календарные ДП для планирования встреч из задач. Пример значения:

{ "allDayExtParamId": 1111,   "conferenceExtParamId": 1112,   "freeBusyStatusIDExtParamId": 1113,   "fromExtParamId": 1114,   "locationIdExtParamId": 1115,   "meetingCommentIDExtParamId": 1116,   "participantIDExtParamId": 1117,   "taskExtParamId": 1118,   "toExtParamId": 1119,   "typeIdExtParamId": 1120 }

CalendarPopupMenuSubcats

Массив ID категорий в формате [111,222...,NNN]. Перечисленные категории будут отображаться в контекстном меню календарных категорий — для быстрой постановки задачи.

Если ключ не задан, в контекстном меню будут отображаться пункты "Событие в календаре", "Задача в категории" и список всех календарных категорий (с включенной настройкой "Является календарем"), если такие категории есть.

CKEditorCustomConfigPath

Ссылка на файл с пользовательской конфигурацией редактора CKEditor (используется для ДП "Большой текст с форматированием"). См. здесь

custom-admin-pannel

Кастомный конфиг административной панели в SPA. Если ключ не пустой, при старте 257 приложения в корне www создается файл "custom-admin-panel.json" с содержимым из ключа.

CustomTaskUsedAsEpBlocksExtSettings

Позволяет не закрывать модальное окно после создания задачи из БИ.

Значение false для isCloseNewTaskAfterCreate означает, что после создания задачи из БИ будет открыта карточка созданной задачи (МТФ), если выбрано true — после создания задачи пользователь останется в БИ.

Формат значния:

{ $$TASKUSED_BLOCK_ID: { "isCloseNewTaskAfterCreate": false, ... }, ... }

Пример. значения:

{15: {"isCloseNewTaskAfterCreate": false}}

customWorkersDictionarySP

Хранимая процедура, которая используется как источник данных для справочника сотрудников вместо стандартного источника данных

DataSourceAggregates

Позволяет осуществить вывод и автоматический подсчет итогов (сумма, среднее значение) числовых и денежных полей отдельной строкой в списке задач категории и в блоке "Используется".

Формат значения:

[{"type": "{type}", "id": {id}, "gridTotalColumns": { "{column}": ["sum","avg", "min", "max"]}}]

{type}:

•для категории: subcat

•для блока "Используется": taskUsed

{id}:

•для категории: ID категории

•для блока "Используется":  ID блока из таблицы "CustomTaskUsedAsEpBlockSettings".

{column} :

•для ДП: ExtParam{ExtParamId}, где ExtParamId= ID ДП (Пример: если ID ДП=123, то ExtParam123)

•для основных параметров: имя параметра (Пример: "Общие плановые трудозатраты" = "overallPlan", "Общие фактические трудозатраты" = "overallFact")

Пример. значения для категории:

[{"type": "subcat", "id": 5574, "gridTotalColumns": { "ExtParam65930": ["sum", "avg"]}}]

Пример. значения для блока "Используется":

[{"type": "taskUsed", "id": 39, "gridTotalColumns": { "ExtParam1709": ["sum", "avg"]}}]

DecodeBigTextEp

Наличие ключа позволяет отображать эмодзи в ДП Большой текст с форматированием

DiadocLogEnabled

Включение логирования ответов для интеграции с сервисом "Диадок". По умолчанию отключено.

DSUpdateCSVPermissions

Ключ влияет на право "Создание/обновление из CSV", при отсутствии права у текущего пользователя в списке задач не будут отображаться соответствующие кнопки.

Пример значения:

[{"subcats": [41380], "groups":[1620]}]

DoNotSelectedTaskInSummary

Наличие ключа позволяет ограничить добавление задач в сводных разделах в запрос

EnabledLocalizedSearch

Позволяет учитывать локализованные значения при поиске в списке задач категории

EveryTagExtParams

EWSDoNotCheckUserRight

ExchangeSubscriptionsToLog

В значении true включает запись в журнал ошибок при создании подписок.

ExchangeSemaphoreWait

Время ожидания семафора в миллисекундах (таймаут). По умолчанию — 0.

ExchangeSemaphoreCount

Количество одновременно обрабатывающихся конкурентных запросов в семафоре. По умолчанию — 50.

ExchangeConnectionLifetime

Время существования соединения с подписками. По умолчанию — 1.

ExchangePermissionsCacheLifeTime

Время жизни кеширования Exchange. По умолчанию 5 минут. Значение ключа указывается в минутах.  

ExperimentalMultilookupEpIds

Экспериментальный функционал: список (через запятую) ID ДП "Выбор нескольких задач из категории" (multilookup), у которых в табличном виде и в окне выбора значений при активированной опции "Чекбоксы для групп в мультилукапе" есть возможность выбирать элементы развернутых/неразвернутых групп

ExportAgGridAsCsv

Позволяет экспортировать список задач категории в формат .csv по кнопке "В Excel".

ExportAgGridAsCsv: true

По умолчанию выключен. Если ключ отсутствует или принимает значение false, по кнопке "В Excel" в панели инструментов списка задач файл будет экспортирован в формате .xlsx

ExtendedSubcatSettings

Позволяет отключить вопросы для категории, а также требования комментария на Вопрос не мне. Формат настройки:

{ $SUBCAT_ID: { "commentQuestionsAllow": bool, "commentNotMeAnswerRequired": bool } }

•commentQuestionsAllow — если указано значение false, то запрещено помечать вопросом комментарий в данной задаче/чате

•commentNotMeAnswerRequired — если указано значение false, то в данной задаче не требуется написание комментария при выборе "Вопрос не мне"

ExtParamExtraSettings

Устанавливает для ДП "Файл" режим, при котором разрешено только сканирование файла без возможности осуществить вложение (в пользовательском интерфейсе будет доступна только кнопка "Сканировать").

Формат настройки:

{"ExtParamID": {"scanOnly": boolean}}

Пример:

{"125": {"scanOnly": true}, "6020": {"scanOnly": true}}

ExtParamTableLookUpTextLength

Задает максимально доступное значение символов для отображения значения в ячейке ДП "Таблица" с типом "Lookup поле". Если количество символов превышает значение ключа, последующие символы будут обрезаны.
Если ключ не указан, по умолчанию максимально допустимое значение — 100.

FirstCommentIdWithNoRecipients

ID комментария, начиная с которого адресаты комментария больше не хранятся в теле комментария.

Ключ действует начиная с релиза 2.240. Он создан для большей совместимости интерфейса SPA и задания по таймеру ClearCommentRecipientsArchiveJob. Ключ рекомендуется использовать компаниям, которые работают в интерфейсе SPA.

Если значение ключа больше 0, то в пользовательском интерфейсе поддерживается форматирование комментариев

ForbidEmailAsLogin

Если ключ активен, вход в систему осуществляется только по логину, а вход по email становится невозможен.

По умолчанию "false".

FromUtpTableFirstOrderSubcats

Массив id категорий через запятую, для которых в запросе списка задач запрос прав будет первым в выражении FROM. Формат настройки:

FromUtpTableFirstOrderSubcats: [

"LookupSubcatIds": [123, 1234, …],

"LookupSummaryIds": [123, 1234, ..]

] 

где LookupSubcatIds — id категорий, а LookupSummaryIds — id категорий сводного раздела.

GantSettings

Настройка проектной Диаграммы Ганта. Формат настройки:

{"projectEpId":1234, "orderedDateEpId":5678}

где projectEpId — id ДП для связи проекта с задачами, а orderedDateEpId — id ДП с дополнительным сроком.

HideUserVoipToken

Позволяет скрыть VoipToken в отдаче данных о пользователях. Принимает значение true/false.

LogRefreshTokenRequests

Если ключ принимает значение true, действия пользователей логируются в таблице "LoginsLog" и отображаются в логах МП и журнале пользователя не только после входа в мобильное приложение, но и при обновлениях токена.

MaxExcelExportRows

Максимальное число задач доступное для экспорта в Excel. При попытке выгрузить большее число задач система вернет ошибку.

Если ключ не задан, по умолчанию максимальное число для экспорта — 50 000 строк.

MaxCsvExportRows

Максимальное число задач доступное для экспорта в CSV. При попытке выгрузить большее число задач система вернет ошибку.

Если ключ не задан, по умолчанию максимальное число для экспорта — 50 000 строк.

MaxSMSLength

Максимально допустимое количество символов в отправляемом из "Первой формы" SMS-сообщении. Символы, выходящие за указанный лимит, будут обрезаны. Значение по умолчанию — 189.

OnlyNameUsersSearch

Позволяет изменить логику того, по каким параметрам работает поиск сотрудников:

•если ключ принимает значение "true", то при поиске по сотрудникам учитываются только параметры "DisplayName" и "FullName".

•если ключ = "false" или нет, то в результатах поиска отображаются профили пользователей, у которых совпало имя, телефон или любой другой параметр с введенным значением.

OfficeOnlineEditor

Настройка редактора офисных файлов: замена сервера, кастомизация настроек редактора.

Для включения MS Web Apps в параметре "editor" необходимо указать значение "webApps", для Р7-Офис - "r7".

Пример значения:

{"editor": "r7", "settings": {"serverAddress":"https://r7.1forma.ru/", "editorConfig":{"customization":{"compactHeader":"true", "compactToolbar":"true", "uiTheme": "theme-light"}},"allowedIPs": []}}

NoValidateFixLengthPlan

Позволяет измененить плановые трудозатраты, если фактические списания превышают плановые

QueueEventsAmount

Число событий которые обрабатывает джоб за 1 запуск

Rebus_MaxParallelism

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

Rebus_NumberOfWorkers

Число потоков, в рамках которых идет разбор очереди шины сообщений. По умолчанию: 1

RegistrationFields

Набор обязательных полей на странице самостоятельной регистрации.

Структура ключа:

[{"Key": "RegistrationCode", "IsRequired": true/false, "IsHidden": true/false}]

где RegistrationCode — поле на странице регистрации, IsRequired — обязательное поле, IsHidden — скрытое поле.

Возможные значения для RegistrationCode:

•Email — Адрес почты

•CellPhone — Мобильный телефон

•Nick — Псевдоним

•FirstName — Имя

•LastName — Фамилия

•Gender — Пол

•City — Город

Пример значения:

[{"Key": "Email", "isRequired": false, "IsHidden": false},{"Key": "CellPhone", "isRequired": false, "IsHidden": false},{"Key": "Nick", "isRequired": false, "IsHidden": true}, {"Key": "FirstName", "isRequired": false, "IsHidden": false},{"Key": "Gender", "isRequired": true, "IsHidden": false},{"Key": "LastName", "isRequired": false, "IsHidden": false},{"Key": "City", "isRequired": false, "IsHidden": true}]

При регистрации среди полей не будет поля, которое было указано при получении кода верификации: "Телефон" или "Email", даже если оно не скрыто в ключе ("IsHidden": false).

Подробнее о настройках страницы самостоятельной регистрации здесь

ScDisableMail

Если значение равно 0 или ключ не задан, то при создании категории настройка Не посылать почтовые сообщения по умолчанию автоматически выключена, а если 1 — то включена

SignaturesGridSettings

Настройка колонок списка активных подписей.

Формат значения:

{

 "columns": [

   {"key": "signatureOrderedTime", "type": "general", "isHidden": false},

   {"key": "description", "type": "general", "isHidden": true},

   {"key": "signatureAndText", "type": "general", "isHidden": false},

   {"key": "signatureAcceptants", "type": "general", "isHidden": false},

   {"key": "signatureInitializeDate", "type": "general", "isHidden": false},

   {"key": "subcatName", "type": "general", "isHidden": false},

   {"key": "ownerName", "type": "general", "isHidden": false},

   {"key": "responsiblePerformer", "type": "general", "isHidden": false},

   {"key": "requestorName", "type": "general", "isHidden": false},

   {"key": "timeToSign", "type": "general", "isHidden": false},

   {"key": "actions", "type": "general", "isHidden": false},

   {"key": "commentsFromMeCount", "type": "general", "isHidden": false},

   {"key": "commentsToMeCount", "type": "general", "isHidden": false},

   {"key": "isAnyUnAnswered", "type": "general", "isHidden": false},

   {"key": "taskId", "type": "general", "isHidden": false},

   {"key": "ExtParamId", "type": "extparam", "isHidden": false}

 ]

}

где:

•signatureOrderedTime — Срок

•description — Описание

•signatureAndText — Подпись и текст задачи

•signatureAcceptants — Согласующие

•signatureInitializeDate — Дата запроса

•subcatName — Категория

•ownerName — Заказчик

•responsiblePerformer — Исполнитель

•requestorName — Запросивший подпись

•timeToSign — Время на подпись

•actions — Действия

•commentsFromMeCount — Вопросы от меня

•commentsToMeCount — Вопросы мне

•isAnyUnAnswered — Мои вопросы

•taskId — Номер задачи

•ExtParamId — ID ДП

Пример значения:

{ "columns": [ {"key": "signatureOrderedTime", "type": "general", "isHidden": true}]}

SmartAction_ExecuteSql_CommandTimeout

Таймаут SQL-команды смарт-действия Выполнить SQL

SpaceSettings

Конфигурация "Пространство" (wiki). Пример значения:

{  "RootCatId": 3011,  "IsActive": true,  "ExtParams": { "SpecialSection": 76940,    "Parent": 76970,    "Extra": 76960,    "Content": 76950  }}

В качестве значений ключа используются соответствующие id, полученные в кодовой миграции:

•"Пространство — Спецраздел" — выпадающий список со значениями: "Вне меню", "Архив", "Корзина".

•"Пространство — Родительский элемент" — числовое поле.

•"Пространство — Содержимое страницы"

•"Пространство — Дополнительная информация"

Если в структуре ключа "SpaceSettings" указан параметр "RootCatId" (id системного раздела Пространств), в меню пространств будут отображаться только дочерние элементы, сам раздел будет скрыт.

Чтобы скрыть функционал пространств в левом боковом меню в ключе необходимо задать "IsActive": false.

Sync1CQueueMaxRetryCount

Количество повторных отправок при неудачной синхронизации из "Первой Формы" в 1С.

TableEpIdsOldUI

Список (через запятую) ID ДП "Таблица" в старом представлении, т.е. с отключенным флажком "Использовать новую таблицу", которые при загрузке карточки задачи должны открываться сразу в режиме редактирования. Остальные ДП "Таблица" в старом представлении загрузке карточки задачи отображаются в режиме чтения

ToDoListSettings

Конфигурация ДП "Выбор нескольких задач из категории (Multilookup)" со схемой оформления "To do list" (чек-лист).  Структура ключа:

{"templatesSubcatId": num, "templateTasksExtParamId": num, "TemplatesSubcatId": num}

где:

•TaskNotesExtParamId — id ДП "Комментарий к задаче" в категории "Задачи шаблонов ToDo list".

•TemplateTasksExtParamId — id ДП "Задачи шаблона ToDo list" в категории "Шаблоны ToDo list".

•TemplatesSubcatId — id категории "Шаблоны ToDo list".

Пример значения:

{"TaskNotesExtParamId":79580,"TemplateTasksExtParamId":79230,"TemplatesSubcatId":56680}

TopMenuItemsHidingSettings

Настраивает скрытие пунктов верхнего меню в пользовательском интерфейсе системы.

Значение ключа — JSON вида:

{"Contacts":false,"Create":false,"History":false,"ProfileLinks":false,"Reports":false,"SearchPanel":false}

Значение false означает, что пункт меню НЕ скрывается (отображается), значение true — что пункт меню скрыт.

•Contacts — пункт "Сотрудники",

•Create — пункт "Создать" вместе со всеми пунктами подменю,

•History — пункт "История",

•ProfileLinks — все пункты внутри меню "Профиль" кроме "Профиль", "Выйти" и "Админ",

•Reports — пункт "Отчеты",

•SearchPanel — окно поиска.

ui-custom-palette

Хранение палитры для темизации.  JSON-формат.

Пример значения:

{

"hazel": {

    "hazel-50": {

      "description": "",

      "value": "#fff8f7"

    },

    "hazel-100": {

      "description": "",

      "value": "#fff2f0"

    },

    "hazel-150": {

      "description": "",

      "value": "#f9e4cf"

    },

    "hazel-200": {

      "description": "",

      "value": "#ffd5ab"

    }

  }

}

Содержимое ключа сливается с содержимым файла "ui-palette-base.json" в ui.json. Файл доступен по адресу https://адрес_1Формы/ui.json

ui-custom-tokens

Стилевые переменные для темизации. JSON-формат.

Содержимое ключа сливается с содержимым файла "ui-variables-base.json" в ui.json.

С помощью ключа можно обновить настройки файла ui.json. Файл доступен по адресу https://адрес_1Формы/ui.json

Пример ключа:

{"colors":{"light":{"surfaceflatzerotone":{"zero":{"description":"","value":"coolgrey-100"},"one":{"description":"","value":"coolgrey-150","shadowMode":1},"two":{"description":"","value":"coolgrey-150","shadowMode":2},"three":{"description":"","value":"coolgrey-200","shadowMode":3}}}}}

В секции OnSurfaceExtra можно задать кастомные цвета активным элементам, ссылкам, иконкам и кнопкам. Пример секции внутри JSON:

"onsurfaceextra":{"primary":{"description":"","value":"yellow-300"},"link":{"description":"","value":"yellow-300"},"info":{"description":"","value":"blue-300"},"success":{"description":"","value":"green-300"},"warning":{"description":"","value":"orange-300"},"danger":{"description":"","value":"red-300"},"default":{"description":"","value":"coolgrey-300"}}

usersDefaultUseNewTaskCard

Если ключ принимает значение 0, то при создании пользователя в системе (вручную в режиме администрирования, с помощью смарт-действий или при синхронизации с AD), для них будет установлено отображение прежней формы карточки задачи: в таблице "Users" колонка "UseNewTaskCard" будет = "0" (для MS SQL), или "false" (для PG).

В обратном случае, если ключ в настройках не указан, для пользователей по умолчанию открывается новая карточка задачи ("UseNewTaskCard" в таблице "Users"= 1)

UseMailToLinksForSignaturesFromEmails

Использовать mailto ссылки в письмах с запросом подписи. Может принимать значение 1 или 0 (или пустое значение). Значение 1 позволит акцептантам выносить резолюции по подписям не заходя в интерфейс "Первой Формы", а отправляя письмо на служебный ящик.

Если при запросе подписи акцептантам отправляется письмо с кнопками для вынесения резолюций, то

•при значении UseMailToLinksForSignaturesFromEmails=1 ссылки будут иметь формат mailto: , и по клику на ссылку будет отправляться письмо на адрес, указанный в Общих настройках приложения в параметре "Почтовый ящик для ответов" или "Внешний почтовый ящик для ответов". Это письмо будет обработано заданием ServiceMailBoxesJob, и по подписи будет вынесена выбранная акцептантом резолюция. Текст ответного письма будет указан в качестве комментария к резолюции.
В системной категории "Уведомления о прочтении" будет создаваться задача с текстом вида "TSID=59354|A=Accept", где значение TSID — это ID запрошенной подписи (из таблицы БД TaskSignatures), а значение A — это ID вынесенной резолюции.

•при значении UseMailToLinksForSignaturesFromEmails=0 (или при пустом значении) ссылки будут иметь формат обычной адресной строки, и по клику на ссылку будет открываться интерфейс "Первой Формы".

UseOldSurveys

Если установлено значение 0, то в системе используется редактор опросов SurveyJS (рекомендуется), если 1 — редактор опросов SurveyProject (устаревший)

UseNewGrid

Включает новый грид для пользователей.

[{"subcats": [5574], "users": [6736], allUsers: false, allSubcats: false}]

allSubcats: true — включает новый грид для всех категорий

allUsers: true — включает новый грид для всех пользователей

WinAppLinks_ColumnIds

Список ID колонок ДП "Таблица" с типом "Файл". Файлы из этих колонок загружаются в распределенную систему хранения файлов "Космос"