Кастомные настройки приложения¶

ℹ️ Кастомные настройки приложения — это список ключей, их значений, описаний и источников.

Управление записями¶

Создать — нажмите + Создать и заполните поля. Добавлять можно только ключи из списка ниже.
Изменить — кликните на запись в списке, внесите правки, нажмите Сохранить. Кнопка Сбросить отменит изменения, Назад — вернёт к списку.
Удалить — кнопка Удалить в окне редактирования или пункт контекстного меню строки.

ℹ️ В качестве нового значения можно добавить только ключи из списка доступных настроек (см. ниже).

`AddUserLoginToSignedFiles`¶

Тип: bool · По умолчанию: false

Позволяет добавлять к наименованию файла электронной подписи SIG логин пользователя-акцептанта.

`Appointments_TimeTryToReacreateMins`¶

Тип: int · По умолчанию: 10

Время (в минутах), в течение которого система будет повторять попытки отправить (пересоздать) встречу в EWS при возникновении сбоя.

`AppointmentsToExternal_HandleOpenExternalConnection`¶

Тип: bool · По умолчанию: false

Включение обработки события открытия соединения с Exchange.

`AppointmentsToExternal_NotSyncedAppointmentsLimit`¶

Тип: int · По умолчанию: 100

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

Рекомендуется сократить до 10.

`AppointmentsToTasks_NotSyncedAppointmentsLimit`¶

Тип: int · По умолчанию: 50

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

Рекомендуется сократить до 10.

`AppointmentsToTasks_FutureDaysLimit`¶

Тип: int · По умолчанию: 180

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

`AppointmentsToTasks_OccurrencesCountLimit`¶

Тип: int · По умолчанию: 50

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

`AppointmentsToTasks_OccurrencesDaysLimit`¶

Тип: int · По умолчанию: 180

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

`AppointmentsToTasks_OccurrencesPastDaysLimit`¶

Тип: int · По умолчанию: —

Количество дней в прошлое от текущей даты. Начиная с этой даты будут создаваться задачи-повторения (см. настройка повторений в пользовательском интерфейсе).

`AuthConfig`¶

Тип: JSON · По умолчанию: —

Управление доступными способами входа на форме авторизации. Подробнее о настройке способов входа здесь.

Формат:

{
  "AuthTypes": [
    {
      "Type": "string",
      "IsDefault": bool,
      "AllowRegister": bool,
      "AutoRegister": bool,
      "PrivacyLink": "string",
      "HideProviders": bool,
      "Visibility": "string",
      "RegisterPrivacyLink": "string",
      "RegistrationType": "string"
    }
  ]
}

Параметры: - Type — тип авторизации. Возможные значения: login-pass — вход по логину и паролю, phone-code — вход по номеру телефона, email-code — вход по почте, external-provider — приоритетный вход через внешнего провайдера (например, KeyCloak). При выборе этого типа отображается отдельный экран с кнопками внешних провайдеров без формы логина и пароля. - IsDefault — тип авторизации по умолчанию. При входе в систему пользователь увидит тип, для которого IsDefault: true. Если таких типов больше одного, на форме появится кнопка переключения. - AllowRegister — разрешить регистрацию по указанному типу. При true будет доступна кнопка регистрации. - AutoRegister — автоматическая регистрация. - PrivacyLink — ссылка на пользовательское соглашение при входе. Если не пустой, отображается обязательная опция «Я принимаю условия пользовательского соглашения». - HideProviders — скрыть провайдеры. При true выбор провайдера будет недоступен. - Visibility — отображение типа авторизации: all (для всех устройств), mobile (только мобильная версия), web (только веб-версия). - RegisterPrivacyLink — пользовательское соглашение при регистрации. Принимает массив объектов с параметрами: - linkUrl — ссылка на соглашение. - linkTitle — текст соглашения. Если не задан, используется «Я принимаю условия пользовательского соглашения». - RegistrationType — тип регистрации: all (телефон и почта), phone (только телефон), email (только почта).

ℹ️ Параметры в AuthTypes обязательно должны быть указаны с заглавной буквы.

Пример:

{
  "AuthTypes": [
    {
      "Type": "phone-code",
      "IsDefault": true,
      "AllowRegister": true,
      "AutoRegister": true,
      "PrivacyLink": null,
      "HideProviders": true,
      "Visibility": "all",
      "RegisterPrivacyLink": null,
      "RegistrationType": "email"
    },
    {
      "Type": "email-code",
      "IsDefault": false,
      "AllowRegister": false,
      "AutoRegister": true,
      "PrivacyLink": null,
      "HideProviders": true,
      "Visibility": "mobile",
      "RegisterPrivacyLink": null,
      "RegistrationType": "email"
    },
    {
      "Type": "login-pass",
      "IsDefault": true,
      "AllowRegister": true,
      "AutoRegister": false,
      "PrivacyLink": null,
      "HideProviders": false,
      "Visibility": "web",
      "RegisterPrivacyLink": null,
      "RegistrationType": "phone"
    }
  ]
}

`BackgroundQueueMaxConcurrency`¶

Тип: int · По умолчанию: 50

Максимальное число фоновых задач, выполняемых одновременно в QueuedHostedService. При значении 1 задачи обрабатываются последовательно (поведение как до версии 2.268).

`BackgroundQueueTaskTimeoutMinutes`¶

Тип: int · По умолчанию: 10

Таймаут выполнения одной фоновой задачи в QueuedHostedService (в минутах). По истечении времени задача прерывается.

BrandSettings¶

Тип: JSON · По умолчанию: —

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

Генерируется при обновлении значений настроек:

Горизонтальный логотип, светлая тема.
Вертикальный логотип, светлая тема.
Горизонтальный логотип, темная тема.
Вертикальный логотип, темная тема.
Ширина логотипа (SPA) вертикальная панель.
Высота логотипа (SPA) вертикальная панель.
Ширина логотипа (SPA) горизонтальная панель.
Высота логотипа (SPA) горизонтальная панель.

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

Формат:

{
  "BackgroundLoginPagePath": "string",
  "FaviconPath": "string",
  "IconKioskScreenLoadingPath": "string",
  "IconSpaAppPath": "string",
  "Logo": {
    "AuthPage": {
      "General": { "Path": "" }
    },
    "HorizontalPanel": {
      "Dark": { "Path": "" },
      "Height": 0,
      "Light": { "Path": "" },
      "Width": 0
    },
    "VerticalPanel": {
      "Dark": { "Path": "" },
      "Height": 0,
      "Light": { "Path": "" },
      "Width": 0
    }
  }
}

Параметры: - BackgroundLoginPagePath — путь к фону на странице авторизации. - FaviconPath — путь к favicon. - IconKioskScreenLoadingPath — путь к обложке киоска. - IconSpaAppPath — путь к иконке приложения SPA.

Секция Logo: - AuthPage — путь к логотипу на странице авторизации.

Секция HorizontalPanel: - Light — путь к логотипу (SPA) горизонтальная панель. - Dark — путь к логотипу (SPA) горизонтальная панель, тёмная тема. - Width — ширина логотипа (SPA) горизонтальная панель. - Height — высота логотипа (SPA) горизонтальная панель.

Секция VerticalPanel: - Light — путь к логотипу (SPA) вертикальная панель. - Dark — путь к логотипу (SPA) вертикальная панель, тёмная тема. - Width — ширина логотипа (SPA) вертикальная панель. - Height — высота логотипа (SPA) вертикальная панель.

`CalendarExtParams`¶

Тип: JSON · По умолчанию: —

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

Формат:

{
  "allDayExtParamId": 0,
  "conferenceExtParamId": 0,
  "freeBusyStatusIDExtParamId": 0,
  "fromExtParamId": 0,
  "locationIdExtParamId": 0,
  "meetingCommentIDExtParamId": 0,
  "participantIDExtParamId": 0,
  "taskExtParamId": 0,
  "toExtParamId": 0,
  "typeIdExtParamId": 0
}

Пример:

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

`CalendarPopupMenuSubcats`¶

Тип: array · По умолчанию: —

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

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

`CalendarRequestTimeoutInMilliseconds`¶

Тип: int · По умолчанию: 30000 (30 секунд)

Определяет максимальное время ожидания (таймаут) в миллисекундах для выполнения запросов к календарю EWS.

`CalendarSyncMinAppoinmentEndDaysBack`¶

Тип: int · По умолчанию: —

Минимальное количество дней назад от текущей даты, до которых учитываются завершённые встречи при синхронизации с Exchange.

`ChangeLanguageInAppBar`¶

Тип: bool · По умолчанию: —

Отображает кнопку переключения языка интерфейса в верхней панели приложения.

`CKEditorCustomConfigPath`¶

Тип: string · По умолчанию: —

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

`CommitTransactionAfterSubcatIDChange`¶

Тип: bool · По умолчанию: false

Определяет стратегию работы с транзакциями при переносе задачи между категориями, в ходе которого вызывается хранимая процедура dbo.UpdateTaskSubcatIDIsClosed.

Если значение true, то обновление ДП при переносе задачи делается вне транзакции.

`CompressDSSettings`¶

Тип: bool · По умолчанию: true

Управление форматом хранения настроек табличного вида списка задач категорий.

При включённом сжатии (true) настройки сохраняются в сжатом GZip формате в атрибуте ValueGZip таблицы DataSourceSettings. При отключении сжатия (false) настройки сохраняются в несжатом JSON в поле Value.

Система обеспечивает обратную совместимость: при загрузке настроек сначала проверяется наличие сжатых данных в ValueGZip, затем — JSON в поле Value. Если оба поля пусты, применяются настройки по умолчанию.

`ConferenceDefaultUserRoomSettings`¶

Тип: JSON · По умолчанию: —

Дефолтные настройки для персональных ВКС-комнат пользователей. Применяются ко всем user-комнатам, у которых нет индивидуальных настроек. Подробнее о порядке fallback — в разделе Дефолтные настройки персональных комнат.

При невалидном JSON применяются хардкод-значения системы, ошибка записывается в лог.

Формат:

{
  "IsRecordingAllowed": true,
  "IsRecordingOnByDefault": false,
  "IsTranscribationAllowed": true,
  "IsTranscribationOnByDefault": false,
  "HasLobby": true
}

Параметры: - IsRecordingAllowed — разрешить запись ВКС. - IsRecordingOnByDefault — включать запись автоматически при старте. - IsTranscribationAllowed — разрешить транскрибацию. - IsTranscribationOnByDefault — включать транскрибацию автоматически при старте. - HasLobby — включить режим лобби.

`ConferenceRoomUrlTemplate`¶

Тип: string · По умолчанию: https://{origin}/{room}

Параметризация автоматически генерируемой ссылки на ВКС.

Шаблон по умолчанию: https://{origin}/{room}, где: - {origin} — Services.Conference.Domain. - {room} — сгенерированный ID комнаты.

Пример:

https://dev.1forma.ru/conference/?room={room}

`CreateIfNeeded`¶

Тип: JSON · По умолчанию: —

История наката кодовых миграций.

`CSVImportMaxThreadsCount`¶

Тип: int · По умолчанию: —

Управляет количеством потоков для обработки данных при импорте задач из CSV-файла. Увеличение числа потоков ускоряет загрузку, но может вызывать ошибки («Specified argument was out of the range of valid values»). Для избежания ошибок рекомендуется установить значение 1 — загрузка будет выполняться в один поток, что приведёт к более длительной, но безошибочной загрузке.

custom-app-settings¶

Список расширенных свойств приложения. Свойства перечисляются в формате JSON.

`AdminPath`¶

Тип: string · По умолчанию: —

Адрес хоста для перехода в режим администрирования.

`allowCSVGridFilter`¶

Тип: bool · По умолчанию: true

Отображение действий в контекстном меню (при клике на колонку) табличного представления категории: - Фильтр csv. - Удалить csv фильтр.

`allowDBAdminExport`¶

Тип: bool · По умолчанию: —

Отображает кнопку выгрузки схемы базы данных dbadmin в меню быстрых действий во вкладке «Администрирование» боковой панели. Нажатие на неё инициирует скачивание файла .sql или .pgsql в зависимости от выбора СУБД.

`AllowThemes`¶

Тип: bool · По умолчанию: —

Разрешает пользователям менять тему оформления интерфейса.

`backgroundTasks`¶

Тип: JSON · По умолчанию: —

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

Формат:

{
  "backgroundTasks": {
    "mailboxes / events": {
      "isEnabled": true,
      "interval": 0
    }
  }
}

Почтовые ящики:

{ "backgroundTasks": { "mailboxes": { "isEnabled": true, "interval": 60 } } }

Баннеры встреч:

{ "backgroundTasks": { "events": { "isEnabled": true, "interval": 60 } } }

`custom-admin-panel`¶

Тип: string · По умолчанию: —

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

`CustomTaskUsedAsEpBlocksExtSettings`¶

Тип: JSON · По умолчанию: —

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

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

Формат:

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

Пример:

{ "15": { "isCloseNewTaskAfterCreate": false } }

`customWorkersDictionarySP`¶

Тип: string · По умолчанию: —

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

`DataSourceAggregates`¶

Тип: JSON · По умолчанию: —

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

Формат:

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

Параметры:

{type}: - subcat — для категории. - taskUsed — для блока «Используется».

{id}: - для категории: ID категории. - для блока «Используется»: ID БИ из таблицы БД CustomTaskUsedAsEpBlockSettings.

{column}: - для ДП: ExtParam{ExtParamId} (пример: если ID ДП = 123, то ExtParam123). - для основных параметров: имя параметра (пример: «Общие плановые трудозатраты» = overallPlan, «Общие фактические трудозатраты» = overallFact).

Пример для категории:

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

Пример для блока «Используется»:

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

`DecodeBigTextEp`¶

Тип: bool · По умолчанию: —

Наличие ключа позволяет отображать эмодзи в ДП «Большой текст без/с форматированием». Ограничение ДП, к которым не будет применяться настройка, задаётся в ключе DecodeBigTextEpExcept.

`DecodeBigTextEpExcept`¶

Тип: array · По умолчанию: —

Список ДП, к которым не будет применяться настройка DecodeBigTextEp.

`DefaultConverterPdf`¶

Тип: string · По умолчанию: SautinSoft

Для преобразования документов в приложении используются конвертеры. Настройка позволяет выбрать конвертер по умолчанию для файлов с расширением .pdf.

Возможные значения: - Devexpress - SautinSoft (по умолчанию) - Aspose

Если не задан, проверяется ключ UseDevexpressDocToPdfConverter в системном файле appsettings.json. Если ни UseDevexpressDocToPdfConverter (или задан в false), ни DefaultConverterPdf не заданы — используется SautinSoft.

ℹ️ После добавления или изменения ключа требуется рестарт приложения.

`DisableAllCachesUpdate`¶

Тип: bool · По умолчанию: false

Отключение автоматического запуска обновления кэша после импорта конфигурации.

`EmptyFeedPlaceholderURL`¶

Тип: string · По умолчанию: —

Ссылка на изображение, которое отображается в ленте (задач, чатов, категории), когда в ней нет задач.

Пример:

"EmptyFeedPlaceholderURL": "https://contact.sk.ru/img-public/Guest/empty.png"

`EnableAllTabsNotifications`¶

Тип: bool · По умолчанию: —

Параметр влияет на отображение уведомлений.

true — уведомления отправляются во все вкладки, включая ситуацию, когда браузер находится в фоновом режиме.
false — уведомления отправляются только в активную вкладку.

По умолчанию, когда параметр не указан, уведомления показываются вне зависимости от активности вкладки с «Первой Формой» и того, свёрнут ли браузер.

`ganttExportPdfUrl`¶

Тип: string · По умолчанию: —

Полный адрес подключения к сервису pdfExport. Используется для экспорта проекта в PDF в проектном управлении «Первой Формы».

Предварительно требуется настройка сервиса экспорта PDF. Инструкция доступна в Руководстве по тех.обслуживанию.

`ganttImportMppUrl`¶

Тип: string · По умолчанию: —

Полный адрес подключения к сервису Mpp-Importer. Используется для загрузки файла проекта с расширением .mpp, созданного в Microsoft Project, в проектном управлении «Первой Формы».

Предварительно требуется настройка сервиса импорта Mpp-Importer. Инструкция доступна в Руководстве по тех.обслуживанию.

`ganttSubtaskDefaults`¶

Тип: JSON · По умолчанию: —

Конфигурация списка подзадач в представлении Диаграмма Ганта.

Формат:

[
  {
    "subcatId": 0,
    "subtaskSubcatId": 0
  }
]

Параметры: - subcatId — категория для постановки задач. - subtaskSubcatId — категория для постановки подзадач.

Пример:

[{ "subcatId": 1234, "subtaskSubcatId": 4567 }]

`GroupsInProfile`¶

Тип: bool · По умолчанию: —

Отображает список групп пользователя в его профиле.

`HelperCustomLink`¶

Тип: string · По умолчанию: —

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

`HideDefaultTags`¶

Тип: bool · По умолчанию: false

Скрыть теги в ленте комментариев. Если параметр отсутствует или false, то в качестве тегов по умолчанию отображается название категории и статус задачи.

`HideEmptyEpOnNtf`¶

Тип: bool · По умолчанию: true

Настройка «Скрыть на НТФ при пустом значении». Если true, то ДП в карточке создания задачи с включённой настройкой «Скрыть при пустом значении», не имеющие значений, будут скрыты.

`HideOldGantt`¶

Тип: bool · По умолчанию: —

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

`HideUserInfoButton`¶

Тип: bool · По умолчанию: false

Скрывает пункт «Инфо пользователя» в контекстном меню пользователя при клике на имя в комментариях, в ДП «Выбор пользователя» и «Адресаты Email».

`highCharts`¶

Тип: bool · По умолчанию: —

Использование по умолчанию библиотеки highCharts для отображения графиков и диаграмм. Если отключено, используется библиотека ApexCharts.

`hideSubcatSyndicateControls`¶

Тип: bool · По умолчанию: —

Скрывает элементы управления синдикацией в настройках категории.

`imageCompressionEngine`¶

Тип: JSON · По умолчанию: —

Компрессия изображений.

ℹ️ По умолчанию в системе используется Compressorjs.

Формат:

{
  "imageCompressionEngine": {
    "engine": "BrowserImageCompression | Squoosh | Compressorjs",
    "BrowserImageCompression": {
      "maxSizeMB": 1,
      "maxWidthOrHeight": 1920,
      "initialQuality": 0.8,
      "alwaysKeepResolution": false
    }
  }
}

`IsFeedsViewOnly`¶

Тип: bool · По умолчанию: false

При клике в Избранном на категории открывается представление Лента, а представление Таблица будет скрыто. Также в дереве «Мои задачи» будут отображаться «Заказчик», «Исполнитель», «Подписка», а скрыты «Согласования» и «Задачи подчинённых».

`IsOldSignTicker`¶

Тип: bool · По умолчанию: false

Позволяет открывать старый список подписей по соответствующему индикатору в интерфейсе SPA.

`isSpaAdminMode`¶

Тип: bool · По умолчанию: —

ℹ️ Начиная с версии 2.266 Дракон ключ не учитывается при работе с панелью администрирования — при определении ссылки из режима администрирования по умолчанию выбирается режим SPA.

Влияет на отображение ссылок в меню администратора в SPA. В прежнем режиме в дереве отображаются ссылки вида /spa.aspx. Ключ учитывается, когда в базе данных нет записей в схеме dbadmin.

`matomo`¶

Тип: JSON · По умолчанию: —

Инициализирует код отслеживания Matomo для расчёта базовой аналитики.

Формат:

{
  "matomo": {
    "baseURL": "https://***/matomo.php",
    "serverAddress": "**.**.ru",
    "siteId": 5,
    "analyticGroups": []
  }
}

Параметры: - baseURL — базовый URL-адрес. - serverAddress — адрес сервера. - siteId — уникальный идентификатор сайта. - analyticGroups — аналитическая группа пользователей. Указываются идентификаторы групп через запятую. При наличии значений параметр запускает отслеживание данных указанных пользователей.

Пример:

{
  "matomo": {
    "baseURL": "https://matomo.1forma.ru/matomo.php",
    "serverAddress": "matomo.1forma.ru",
    "siteId": 2,
    "analyticGroups": [5350, 5360]
  }
}

newEpTable¶

Тип: JSON · По умолчанию: —

Отображает ДП «Таблица» в новом виде для определённых пользователей и категорий.

Формат:

[
  {
    "users": [],
    "subcat": []
  }
]

Параметры: - users — список ID пользователей, для которых необходимо включить новую таблицу. - subcat — список ID категорий, для которых необходимо включить новую таблицу.

Чтобы включить таблицу для всех пользователей или для всех категорий, в качестве значения нужно задать "*".

Пример:

[{ "users": [123, 456], "subcat": [1111, 2222] }]

Для всех пользователей и всех категорий:

[{ "users": "*", "subcat": "*" }]

`newTaskSpa`¶

Тип: JSON · По умолчанию: —

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

ℹ️ Обратите внимание: добавленные ранее вставки не будут корректно работать при переходе на новый НТФ в SPA.

Подробнее о правилах миграции JS-вставок со старой карточки задачи в SPA.

Формат:

{
  "newTaskSpa": {
    "excludeSubcats": [],
    "excludeUsers": [],
    "rules": [
      {
        "subcats": [],
        "users": []
      }
    ]
  }
}

Параметры: - excludeSubcats — список ID категорий, для которых нужно исключить отображение новой карточки создания задачи. - excludeUsers — список ID пользователей, которых нужно исключить из правила. - rules: - users — список ID пользователей, для которых нужно включить новую карточку. - subcats — список ID категорий, в которых нужно включить новую карточку для указанных пользователей.

Чтобы включить для всех пользователей или для всех категорий, в качестве значения задать "*".

Пример:

{
  "newTaskSpa": {
    "excludeSubcats": [6915, 9251, 44950],
    "excludeUsers": [29359],
    "rules": [{ "subcats": [8631, 5860], "users": "*" }]
  }
}

`ParseCommentsLinksJob_LastParsedCommentId`¶

Тип: int · По умолчанию: —

ID последнего обработанного комментария заданием по таймеру ParseCommentsLinksJob.

`PasswordRecoveryText`¶

Тип: string (Markdown) · По умолчанию: —

Кастомный текст, отображаемый на странице восстановления пароля (/spa/entry/password-recovery). Поддерживает Markdown-форматирование.

`personalDynSignaturesOnly`¶

Тип: array · По умолчанию: —

Позволяет отключить отображение динамических подписей в указанных категориях. В качестве значения принимает массив SubcatID (ID категории).

`ProjectReferenceTableExtParamId`¶

Тип: int · По умолчанию: —

Хранит ID сквозного ДП-таблицы (Reference Table ExtParam), используемого для проектов.

Используется в readonly-режиме Ганта: когда Гант отображается не в проектной категории, данные берутся из EP-таблицы по этому ID, а не через gantt/data. Также используется в task-card.component.ts для определения, есть ли у задачи проектная привязка через сквозной ДП.

Если параметр указан и задача содержит соответствующее значение сквозного ДП, в тулбаре карточки задачи появляется кнопка «Проектный гант». Доступ к Ганту определяется двухуровнево: сначала проверяются права на задачу проекта, затем — на ДП-таблицу. При открытии карточки задачи сам сквозной ДП автоматически скрывается.

Подробнее о настройке

Пример:

"ProjectReferenceTableExtParamId": 86611

`ProjectTableJSONExtParamID`¶

Тип: int · По умолчанию: —

Вывод в карточку проектной задачи дополнительной кнопки «Проектный гант» для перехода в новый проектный интерфейс.

Актуально для нового проектного интерфейса. В качестве значения ключа задаётся ID ДП с типом «Таблица».

Подробнее о настройке этого ДП

Пример:

"ProjectTableJSONExtParamID": 86610

`refreshGridEvents`¶

Тип: JSON · По умолчанию: —

Отключение автообновления списка задач категории.

ℹ️ Работает начиная с версии 2.254.

Формат:

{
  "refreshGridEvents": {
    "tabActivate": false,
    "refreshMTF": false
  }
}

Если refreshGridEvents.tabActivate = false, то при активации вкладки список задач категории не обновляется.
Если refreshGridEvents.refreshMTF = false, то список задач категории не обновляется при сигнале refreshMTF.

`requestTimeout`¶

Тип: int · По умолчанию: —

Timeout на http-запросы. Не используется, если не задано.

`requestTimeoutExcludeUrls`¶

Тип: array · По умолчанию: —

Timeout на http-запросы с исключением URL. Список исключаемых URL указывается через запятую.

`resourcesSubcatDefaults`¶

Тип: JSON · По умолчанию: —

Конфигурация представления категории «Ресурсы».

Формат:

[
  {
    "subcatId": 0,
    "newTaskSubcatId": 0,
    "postTaskMode": "newTaskForm",
    "ignoreCreateAllocation": false,
    "resourceExtendAddEnable": false,
    "performerExtParamId": 0,
    "DatetimeFromExtParamId": 0,
    "DatetimeToExtParamId": 0,
    "createOnly": false
  }
]

Параметры: - subcatId — ID категории в представлении «Ресурсы». - newTaskSubcatId — ID категории, в которой будут поставлены новые задачи. - postTaskMode — режим формы создания задачи. Значение newTaskForm — открывать карточку создания новой задачи. Если не задан, отображается стандартное окно добавления ресурсов. - ignoreCreateAllocation — при true возможность создания задач по кнопке в правой части представления недоступна. - resourceExtendAddEnable — при true в списке доступных действий по кнопке с многоточием станет доступен пункт «Расширенное добавление». - performerExtParamId — ID ДП с типом «Lookup», источником которого является категория со значениями исполнителей. - DatetimeFromExtParamId — ID ДП с типом «Дата и время», которое автоматически заполняется датой начала распределения ресурса. - DatetimeToExtParamId — ID ДП с типом «Дата и время», которое автоматически заполняется датой окончания распределения ресурса. - createOnly — при true доступно только создание и просмотр значений; изменение перетаскиванием краёв карточки ресурса запрещено.

Пример:

[{
  "subcatId": 61360,
  "newTaskSubcatId": [61430],
  "postTaskMode": "newTaskForm",
  "ignoreCreateAllocation": true,
  "resourceExtendAddEnable": true,
  "performerExtParamId": 96360,
  "DatetimeFromExtParamId": 96820,
  "DatetimeToExtParamId": 96830,
  "createOnly": true
}]

`resourceExtendAddEnable`¶

Тип: bool · По умолчанию: —

Включает расширенный режим добавления ресурсов в представлении «Ресурсы». При активации в каждой строке доступна кнопка добавления, даже если ресурсы уже назначены.

`SearchSubcategoryFolders`¶

Тип: bool · По умолчанию: —

Включает поиск по папкам (разделам) категорий в глобальном поиске.

`showAI`¶

Тип: bool · По умолчанию: false

Включение в системе инструментов AI: векторный поиск.

`showCalendarMessageCounter`¶

Тип: bool · По умолчанию: —

Отображает счётчик непрочитанных сообщений в иконке календаря.

`signal`¶

Тип: string · По умолчанию: —

Обеспечивает корректную совместную работу нового и старого функционала (.Net Core и Task Center). Позволяет корректно обновлять значения в новом списке задач категории, используя старую карточку задачи.

Параметр должен принимать значение "tc-core".

Предварительно необходимо в конфигурационном файле app-settings.json добавить ключ "SignalRMode": "Mixed".

Пример:

"signal": "tc-core"

`spaResources`¶

Тип: JSON · По умолчанию: —

Глобальные JS вставки. В ключе можно указать js-ресурсы, которые будут загружаться при инициализации или успешном входе в приложение.

Формат:

[
  {
    "type": "js",
    "src": "https://Адрес_ссылки.js"
  }
]

`taskLinkNoFrame`¶

Тип: bool · По умолчанию: —

Карточка задачи открывается по номеру задачи (из шапки карточки или из комментариев) в режиме noframe, без системной шапки приложения (логотип, панель навигации).

`tspUrl`¶

Тип: string · По умолчанию: —

URL-адрес TSP-сервиса (службы метки времени) для электронной подписи.

`useEditableEpTable`¶

Тип: bool · По умолчанию: —

Позволяет редактировать ДП «Таблица» нажатием на иконку и в отдельном модальном окне.

`useNewEpAndTaskUsed`¶

Тип: JSON · По умолчанию: —

Возможность включить новые ДП и БИ для определённых пользователей и категорий. Ключ также влияет на настройки в режиме администрирования.

Формат:

[
  {
    "subcats": [],
    "users": []
  }
]

Параметры: - users — список ID пользователей, для которых необходимо включить новые ДП и БИ. - subcats — список ID категорий, для которых необходимо включить новые ДП и БИ.

Пример:

[{ "subcats": [1], "users": [2, 3] }]

`UseNewExtParamsAndTaskUsed`¶

Тип: JSON · По умолчанию: —

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

Формат:

[
  {
    "subcats": [],
    "users": []
  }
]

Параметры: - users — список ID пользователей, для которых необходимо включить новые ДП. - subcats — список ID категорий, для которых необходимо включить новые ДП.

Пример:

[{ "subcats": [5574], "users": [6736] }]

`useNewExtendedSearch`¶

Тип: bool · По умолчанию: false

Включает новый расширенный поиск по задачам в SPA.

`useNewFRReports`¶

Тип: bool · По умолчанию: —

Использование новых отчётов FastReport.

`useNewMTF`¶

Тип: JSON · По умолчанию: —

Новый МТФ. Включает отображение новой карточки задачи с новыми ДП для указанных пользователей и категорий.

ℹ️ Обратите внимание: добавленные ранее вставки не будут корректно работать при переходе на новый МТФ в SPA.

Подробнее о правилах миграции JS-вставок со старой карточки задачи в SPA.

Формат:

{
  "useNewMTF": {
    "subcats": [],
    "users": [],
    "allUsers": false,
    "allSubcats": false,
    "excludeUsers": [],
    "excludeSubcats": []
  }
}

Параметры: - subcats — список ID категорий, для которых необходимо включить новый МТФ. - users — список ID пользователей, для которых необходимо включить новый МТФ. - allUsers — включить новый МТФ для всех пользователей системы. - allSubcats — включить новый МТФ для всех категорий системы. - excludeUsers — включение нового МТФ для всех пользователей, кроме указанных. - excludeSubcats — включение нового МТФ для всех категорий, кроме указанных.

Пример:

{
  "useNewMTF": {
    "subcats": [],
    "users": [],
    "allUsers": true,
    "allSubcats": true,
    "excludeUsers": [8142],
    "excludeSubcats": [8881]
  }
}

`userProfileInfoExts`¶

Тип: JSON · По умолчанию: —

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

Поведение кастомных полей: 1. Если поле пустое, оно не выводится в профиле. 2. Если поле не пустое, оно выводится в профиле отдельной секцией в блоке «О себе».

Формат:

{ "userProfileInfoExts": { "fields": ["имя_поля1", "имя_поля2"] } }

Пример:

{ "userProfileInfoExts": { "fields": ["Zoom", "JobTitle"] } }

`useTaskLoader`¶

Тип: bool · По умолчанию: —

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

`useTaskOneScroll`¶

Тип: bool · По умолчанию: —

Включает режим единой прокрутки в карточке задачи (без разделения на области).

`MobileAppSettings`¶

Настройки мобильного приложения.

`mspaByDefault`¶

Тип: bool · По умолчанию: —

Отображение в мобильной версии кнопки «Перейти в Desktop версию» в разделе «Настройки» бокового меню.

`openInBrowserDomains`¶

Тип: array · По умолчанию: —

Добавление доменов для открытия ссылок в браузере мобильного устройства вместо встроенного браузера WebView внутри приложения.

Массив должен содержать список доменов, которые будут открыты из МП в браузере устройства. Домены указываются без протокола https://.

Пример:

"openInBrowserDomains": ["2ip.ru", "ya.ru"]

`MigrationExportSettings`¶

Тип: string · По умолчанию: —

Исключение типов объектов из экспорта конфигурации.

В качестве значения указывается полный путь до типа данных. Для нескольких типов — перечислите через запятую.

Пример отключения экспорта прав доступа групп к категории:

{ "ExcludeTypes": ["TCDataAccess.Kernel.Domain.Entities.Groups.GroupPermissionEntity"] }

`MaxExcelExportRows`¶

Тип: int · По умолчанию: 50000

Глобальный лимит строк для экспорта в Excel. Проверяется до формирования файла: если запрошено больше строк, чем задано в ключе, система вернёт ошибку. Значение также передаётся на фронтенд.

Для ограничения непосредственно при формировании Excel-файла используйте MaxGridExcelExportRows.

`MaxGridCsvExportRows`¶

Тип: int · По умолчанию: —

Лимит строк при фактическом формировании CSV-файла (обработчик CsvHelper). Проверяется в момент записи данных в файл. Если не задан — лимит не применяется.

Отличие от MaxExcelExportRows: тот ключ — предварительная глобальная проверка, этот — ограничение конкретно на этапе записи CSV.

`MaxGridExcelExportRows`¶

Тип: int · По умолчанию: —

Лимит строк при фактическом формировании Excel-файла (обработчик ClosedXML). Проверяется в момент записи данных в файл. Если не задан — лимит не применяется.

Отличие от MaxExcelExportRows: тот ключ — предварительная глобальная проверка, этот — ограничение конкретно на этапе записи Excel.

`MaxScriptsToCombine`¶

Тип: int · По умолчанию: 10

Ограничение максимального количества скриптов для объединения.

`MaxSMSLength`¶

Тип: int · По умолчанию: 189

Максимально допустимое количество символов в отправляемом из «Первой Формы» SMS-сообщении. Символы, выходящие за указанный лимит, будут обрезаны.

`NewCustomGrid.FromUtpTableFirstOrderSubcats`¶

Тип: JSON · По умолчанию: —

Управляет порядком таблицы прав в SQL-запросе нового грида для указанных категорий. Аналог FromUtpTableFirstOrderSubcats для нового табличного представления.

`NewCustomGrid.UtpTableApplyOnSummarys`¶

Тип: JSON · По умолчанию: —

Применяет таблицу прав (utp) к сводным разделам в новом табличном представлении.

`NewsSettings`¶

Тип: JSON · По умолчанию: —

Настройки модуля новостей. Определяет служебные категории, используемые для хранения и отображения новостей в системе.

`NoValidateFixLengthPlan`¶

Тип: bool · По умолчанию: —

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

`OfficeOnlineEditor`¶

Тип: JSON · По умолчанию: —

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

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

Формат:

{
  "editor": "string",
  "settings": {
    "serverAddress": "string",
    "allowedIPs": []
  }
}

Параметры: - editor — указывает используемый редактор. Доступные значения: webApps, r7, OnlyOffice. - serverAddress — адрес сервера (например, https://r7.1forma.ru/ или https://1f.domain/office/). - allowedIPs — список разрешённых IP-адресов или подсетей. Может быть пустым.

ℹ️ В версиях 2.264 Кассиопея и ниже для Р7-Офис и OnlyOffice необходимо указывать значение "r7". Начиная с версии 2.265 Цефей доступно значение "OnlyOffice" для одноимённого редактора.

Пример:

{ "editor": "r7", "settings": { "serverAddress": "https://r7.1forma.ru/", "allowedIPs": [] } }

`OktellIntegration`¶

Тип: JSON · По умолчанию: —

Настройки интеграции с телефонной системой Oktell.

`OnlyNameUsersSearch`¶

Тип: bool · По умолчанию: false

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

true — при поиске по сотрудникам учитываются только параметры DisplayName и FullName.
false — в результатах поиска отображаются профили пользователей, у которых совпало имя, телефон или любой другой параметр с введённым значением.

`OrgStructure_AllowNonUniqueOrgUnitNames`¶

Тип: bool · По умолчанию: true

Установка ограничения на создание нескольких организационных единиц с одинаковыми названиями внутри одной ветки дерева.

true — ограничение не установлено.
false — ограничение установлено.

`PatMaxExpirationDays`¶

Тип: int · По умолчанию: 365

Задаёт максимально допустимый срок действия PAT-токена в днях. Значение 0 означает, что разрешено создавать бессрочные токены. Если параметр не задан, максимальный срок действия составляет 1 год (365 дней).

`PatMaxTokensPerUser`¶

Тип: int · По умолчанию: 10

Определяет максимальное количество активных (не отозванных) PAT-токенов, которые может иметь один пользователь. Если параметр не указан, по умолчанию действует лимит в 10 токенов.

`PostMarkAsAnsweredWithUserType`¶

Тип: bool · По умолчанию: false

Комментарий «Как отвеченный» для вопросов по умолчанию становится пользовательского типа. Если ключ не задан или false, комментарии «Как отвеченный» относятся к системным.

`QuartzRunInClusterMode`¶

Тип: bool · По умолчанию: false

Включение кластера Quartz. По умолчанию Quartz отключён.

`QueueEventsAmount`¶

Тип: int · По умолчанию: —

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

`Rebus_BackoffTimes`¶

Тип: string · По умолчанию: 500,1000,2000,4000

Управление интервалами между опросами очереди сообщений в Rebus. Строка с последовательностью таймаутов в миллисекундах, разделённых запятыми.

Примеры: - "100" — опрос очереди каждые 100 миллисекунд. - "100,200,500,1000" — если через 100 мс нет сообщений, следующий опрос через 200 мс, и так далее до 1000 мс.

`Rebus_MaxParallelism`¶

Тип: int · По умолчанию: 5

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

`Rebus_NumberOfWorkers`¶

Тип: int · По умолчанию: 1

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

`RecurrenceTasksMaterializationDays`¶

Тип: int · По умолчанию: —

Количество дней вперёд от текущей даты, на которое система заблаговременно материализует (создаёт) повторяющиеся задачи.

`RedefiningIdentity`¶

Тип: bool · По умолчанию: false

Определяет механизм смещения автоинкремента строк таблиц сущностей и работает в связке с dbo.Settings.Serveridkey.

RegistrationFields¶

Тип: JSON · По умолчанию: —

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

ℹ️ Приоритет пользовательского ключа выше, чем настройка «Обязательные поля профиля пользователя» в общих настройках приложения!

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

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

Формат:

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

Параметры: - Key — поле на странице регистрации. Возможные значения: - Email — адрес почты. - CellPhone — мобильный телефон. - Nick — псевдоним. - FirstName — имя. - LastName — фамилия. - Gender — пол. - City — город. - Password — пароль. - Note — текстовое примечание. Поддерживаются HTML-теги. Дополнительные параметры: title (отображаемый текст) и Color (цвет поля). - IsRequired — обязательное поле. - IsHidden — скрытое поле.

Для пароля задаётся секция PasswordSettings: - MinNumberOfChar — минимальное количество символов. - MaxNumberOfChar — максимальное количество символов. - UpperLowercaseRequired — обязательно наличие заглавных и строчных букв. - AcceptableLanguage — допустимый язык (пример: ru-RU). - MinNumberOfDigits — минимум цифр. - NoSpaces — без пробелов. - MinNumberOfSpecialChar — минимум спецсимволов. - DisallowLoginOrBirthdayPattern — запретить повторение логина или последовательности цифр по дате рождения. По умолчанию false. - DisallowedSequenceLength — запретить последовательности из N и более букв и цифр подряд. - DisallowedRepeatingPatternLength — запретить повторяющиеся комбинации из N и более букв и цифр. - NumberOfPreviousPasswordsToCheck — пароль не должен совпадать с не менее чем N ранее используемыми. Рекомендуемое значение — не менее 10. - MinCharPasswordDifference — пароль должен отличаться от ранее используемого не менее чем на N символов. Рекомендуемое значение — не менее 5.

ℹ️ Требования к паролям в RegistrationFields учитываются только для формы самостоятельной регистрации. Для создания пользователей из режима администрирования и при сбросе пароля — параметры задаются в блоке «Настройки требований к паролям» в общих настройках приложения.

Пример:

[
  { "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 }
]

Пример с настройкой пароля:

[
  { "Key": "FirstName", "isRequired": false, "IsHidden": false },
  { "Key": "LastName", "isRequired": false, "IsHidden": false },
  {
    "Key": "Password",
    "isRequired": false,
    "IsHidden": false,
    "PasswordSettings": {
      "MinNumberOfChar": 1,
      "MaxNumberOfChar": 2,
      "UpperLowercaseRequired": true,
      "AcceptableLanguage": "ru-RU",
      "MinNumberOfDigits": 3,
      "NoSpaces": true,
      "MinNumberOfSpecialChar": 4,
      "DisallowLoginOrBirthdayPattern": true,
      "DisallowedSequenceLength": 3,
      "DisallowedRepeatingPatternLength": 4,
      "NumberOfPreviousPasswordsToCheck": 5,
      "MinCharPasswordDifference": 6
    }
  }
]

Пример с настройкой примечания:

[
  { "Key": "FirstName", "isRequired": false, "IsHidden": false },
  { "Key": "LastName", "isRequired": false, "IsHidden": false },
  {
    "Key": "Note",
    "isRequired": false,
    "IsHidden": false,
    "title": "Примечание",
    "Color": "red"
  }
]

`SautinSoftLicenseKey`¶

Тип: string · По умолчанию: —

Лицензионный ключ библиотеки SautinSoft.PdfMetamorphosis, используемой для конвертации документов в PDF (см. DefaultConverterPdf).

Если ключ не заполнен или отсутствует — лицензия не активируется, конвертер SautinSoft работает в ограниченном (пробном) режиме.

ℹ️ После добавления или изменения ключа требуется рестарт приложения.

`SaveExecuteJobLogForEmailJobSyncFolders`¶

Тип: bool · По умолчанию: false

Логирование синхронизации папок почтовых ящиков в журнал выполненных заданий по таймеру.

SbisLastEventsId¶

Тип: JSON · По умолчанию: —

Идентификатор последних событий СБИС. Наличие ключа является обязательным условием для интеграции.

Формат:

{
  "LastEvents": [
    {
      "EventId": 0,
      "ServiceId": 0
    }
  ]
}

Параметры: - EventId — ID события. - ServiceId — ID сервиса.

Пример:

{ "LastEvents": [{ "EventId": null, "ServiceId": 23 }] }

`ScDisableMail`¶

Тип: 0/1 · По умолчанию: 0

Автоматическое включение настройки категории «Не посылать почтовые сообщения».

`SearchEncryptedTasks`¶

Тип: bool · По умолчанию: false

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

`SignaturesGridSettings`¶

Тип: JSON · По умолчанию: —

(Устаревшее, не используется начиная с версии 2.266 Дракон)

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

ℹ️ Скрытые колонки будут недоступны для вывода даже из списка доступных колонок.

ℹ️ Если колонка явно не указана в ключе, то она будет доступна, как если бы было задано "isHidden": false.

Формат:

{
  "columns": [
    { "key": "taskText", "type": "general", "isHidden": false },
    { "key": "signatureReason", "type": "general", "isHidden": false },
    { "key": "signatureOrderedTime", "type": "general", "isHidden": false },
    { "key": "description", "type": "general", "isHidden": false },
    { "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 },
    { "key": "taskState", "type": "general", "isHidden": false },
    { "key": "activeSubtasks", "type": "general", "isHidden": false },
    { "key": "totalSubtasks", "type": "general", "isHidden": false },
    { "key": "subtasksRes", "type": "general", "isHidden": false },
    { "key": "taskPriority", "type": "general", "isHidden": false },
    { "key": "signatureCreatedTask", "type": "general", "isHidden": false }
  ]
}

Параметры: - taskText — текст задачи. - signatureReason — причина запроса подписи. - signatureOrderedTime — срок. - description — описание. - signatureAndText — подпись и текст задачи. - signatureAcceptants — согласующие. - signatureInitializeDate — дата запроса. - subcatName — категория. - ownerName — заказчик. - responsiblePerformer — исполнитель. - requestorName — запросивший подпись. - timeToSign — время на подпись. - actions — действия. - commentsFromMeCount — вопросы от меня. - commentsToMeCount — вопросы мне. - isAnyUnAnswered — мои вопросы. - taskId — номер задачи. - ExtParamId — ID ДП. - taskState — статус. - activeSubtasks — активных подзадач. - totalSubtasks — всего подзадач. - subtasksRes — подзадачи. - taskPriority — приоритет. - signatureCreatedTask — дата создания задачи.

В списке запрошенных подписей помимо системных параметров можно вывести и дополнительные. Для этого в качестве типа необходимо указать "extparam", а в параметре "key" задать ID нужного ДП. Не влияет на информационные ДП, которые отображаются в виде серых блоков под строкой подписи.

Пример скрытия колонки:

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

Пример добавления ДП:

{ "columns": [{ "key": 1234, "type": "extparam", "isHidden": false }] }

`SimpleSearchByTasks.PhonesSubcatIDs`¶

Тип: string · По умолчанию: —

Список ID подкатегорий (через запятую) для поиска по телефонным номерам. Если пользователь не указал конкретную подкатегорию, а введённый запрос состоит только из цифр и знаков +, -, (, ) длиной не более 10 символов — поиск ограничивается указанными подкатегориями. Если ключ не задан или пуст — фильтрация не применяется. Если цифр не более 3 — результат всегда пустой.

Пример: 123,456,789

`SimpleSearchByTasks_ExecLog`¶

Тип: 0/1 · По умолчанию: 0

Логирование выполнения хранимой процедуры SimpleSearchByTasks.

`ShowCommentsFeed_ExecLog`¶

Тип: 0/1 · По умолчанию: 0

Логирование выполнения хранимой процедуры ShowCommentsFeed.

`ShowTasksFeed_ExecLog`¶

Тип: 0/1 · По умолчанию: 1

Логирование выполнения хранимой процедуры ShowTasksFeed.

`SmartAction_ExecuteSql_CommandTimeout`¶

Тип: int · По умолчанию: —

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

`SmartScriptJSEngineTimeoutMinutes`¶

Тип: int · По умолчанию: 15

Таймаут выполнения JavaScript SmartScript в движке Jint (в минутах). Применяется к таймауту выполнения скрипта и к PromiseTimeout. Изменение вступает в силу без перезапуска сервера.

`SmartScriptLogLevel`¶

Тип: string · По умолчанию: Error

Задаёт минимальный уровень логирования выполнения Смарт-скриптов. Если настройка не задана или значение не распарсилось, используется Error.

Поддерживаемые значения (без учёта регистра): Debug, Info, Error.

Debug — в журнал записываются все сообщения (отладочные, информационные, ошибки).
Info — информационные сообщения и ошибки.
Error — только ошибки.

Настройка влияет как на обычное выполнение скрипта, так и на запуск из редактора.

`socialNetworksSettings`¶

Тип: JSON · По умолчанию: —

Конфигурация социальных сетей.

Формат:

{
  "RootCategoryId": 0,
  "PersonalPublicationsSubcatId": 0,
  "HeaderStyle": 0,
  "GroupsForPublicationsId": 0,
  "GroupsForClosedPublicationsId": 0,
  "ArticlesSubcatId": 0,
  "ExtParams": {
    "ExtParamCoverId": 0
  }
}

Параметры: - RootCategoryId — ID системного раздела «Социальные сети». - PersonalPublicationsSubcatId — ID служебной категории «Личные публикации» с типом «Группы соц.сетей». Категория должна находиться в разделе «Социальные сети». - HeaderStyle — стиль отображения шапки группы соц.сети. Необязательный параметр. 0 — в шапке только аватар группы (по умолчанию), 1 — в шапке отображается имя автора и его аватар. - GroupsForPublicationsId — ID служебной категории «Группы для публикаций». - GroupsForClosedPublicationsId — ID служебной категории «Группы для закрытых публикаций». - ArticlesSubcatId — ID системной категории «Статьи» для хранения статей, создаваемых из формы написания поста. - ExtParamCoverId — ID ДП с типом «Файл» для хранения обложки (задаётся в секции ExtParams).

Пример:

{
  "RootCategoryId": 4441,
  "PersonalPublicationsSubcatId": 62720,
  "HeaderStyle": 1,
  "GroupsForPublicationsId": 62730,
  "GroupsForClosedPublicationsId": 62900,
  "ArticlesSubcatId": 62830,
  "ExtParams": { "ExtParamCoverId": 100020 }
}

`SpaceSettings`¶

Тип: JSON · По умолчанию: —

Конфигурация «Пространство» (wiki).

Формат:

{
  "ExtParams": {
    "Content": 0,
    "Cover": 0,
    "CoverPreview": 0,
    "Extra": 0,
    "Parent": 0,
    "SpecialSection": 0
  },
  "IsActive": true,
  "RootCatId": 0
}

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

SpecialSection — «Пространство - Спецраздел» (Выпадающий список). Список служебных разделов: «Вне меню», «Архив», «Корзина».
Content — «Пространство - Содержимое страницы» (Большой текст с форматированием).
Extra — «Пространство - Дополнительная информация» (Большой текст с форматированием).
Parent — «Пространство - Родительский элемент» (Число). ID родительского пространства.
Cover — «Пространство - Обложка» (Файл). Пропорции по умолчанию 22:6.
CoverPreview — «Пространство - Превью обложки» (Файл). Пропорции по умолчанию 16:9.

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

Чтобы скрыть пространства в левом боковом меню, задать "IsActive": false.

Пример:

{
  "ExtParams": {
    "Content": 76950,
    "Cover": 100130,
    "CoverPreview": 100140,
    "Extra": 76960,
    "Parent": 76970,
    "SpecialSection": 76940
  },
  "IsActive": true,
  "RootCatId": 3021
}

`StageExtParamId`¶

Тип: int · По умолчанию: —

ID дополнительного параметра, используемого как «этап» при загрузке файлов. Применяется для разграничения файлов по стадиям процесса.

`StartCalendarSyncFromDate`¶

Тип: string · По умолчанию: —

Дата начала синхронизации событий календаря с Exchange. События раньше этой даты синхронизироваться не будут.

`Sync1CQueueMaxRetryCount`¶

Тип: int · По умолчанию: —

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

`SyncOrgStructure1C`¶

Тип: bool · По умолчанию: —

Включает синхронизацию организационной структуры из 1С в «Первую Форму».

`TableEpIdsOldUI`¶

Тип: array · По умолчанию: —

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

`TC1C_CatID`¶

Тип: int · По умолчанию: —

ID категории, используемой для интеграции с 1С (служебная категория синхронизации).

`TC1C_DaysLogKept`¶

Тип: int · По умолчанию: —

Количество дней хранения журнала синхронизации с 1С.

`TC1C_ServiceAppAddress`¶

Тип: string · По умолчанию: —

Указывается адрес, который задан в настройках синхронизации с 1C в TCServerName. В качестве значения допускается использовать как доменное имя, так и конкретный IP-адрес сервера.

`TC1C_SystemUser`¶

Тип: string · По умолчанию: —

Логин системного пользователя, от имени которого выполняются операции синхронизации с 1С.

ToDoListSettings¶

Тип: JSON · По умолчанию: —

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

Формат:

{
  "TaskNotesExtParamId": 0,
  "TemplateTasksExtParamId": 0,
  "TemplatesSubcatId": 0
}

Параметры: - TaskNotesExtParamId — ID ДП «Комментарий к задаче» в категории «Задачи шаблонов ToDo list». - TemplateTasksExtParamId — ID ДП «Задачи шаблона ToDo list» в категории «Шаблоны ToDo list». - TemplatesSubcatId — ID категории «Шаблоны ToDo list».

ℹ️ Если параметр TemplatesSubcatId не задан или имеет пустое значение, кнопка «Добавить по шаблону» не будет отображаться в ДП для пользовательских категорий. В системной категории кнопка недоступна по умолчанию.

Пример:

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

`TemplateParser`¶

Тип: string · По умолчанию: —

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

`TopMenuItemsHidingSettings`¶

Тип: JSON · По умолчанию: —

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

false — пункт меню не скрывается, true — скрыт.

Формат:

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

Параметры: - Contacts — пункт «Сотрудники». - Create — пункт «Создать» вместе со всеми пунктами подменю. - History — пункт «История». - ProfileLinks — все пункты внутри меню «Профиль» кроме «Профиль», «Выйти» и «Админ». - Reports — пункт «Отчёты». - SearchPanel — окно поиска.

`TranslationService`¶

Тип: string · По умолчанию: —

По умолчанию сервис TranslateService используется для асинхронного автоматического перевода локализованных значений с использованием AI-сервиса. Настройка позволяет вернуться к использованию Azure Cognitive Services.

Значение: azure

`ui-custom-palette`¶

Тип: JSON · По умолчанию: —

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

Подробнее о брендировании

Пример:

{
  "hazel": {
    "hazel-50": { "description": "", "value": "#fff8f7" },
    "hazel-100": { "description": "", "value": "#fff2f0" },
    "hazel-150": { "description": "", "value": "#f9e4cf" },
    "hazel-200": { "description": "", "value": "#ffd5ab" }
  }
}

`ui-custom-tokens`¶

Тип: JSON · По умолчанию: —

Стилевые переменные для темизации. Содержимое ключа сливается с содержимым файла ui-variables-base.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 можно задать кастомные цвета активным элементам, ссылкам, иконкам и кнопкам:

"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" }
}

`UseLegacyLookupQuery`¶

Тип: bool · По умолчанию: —

Включает устаревший алгоритм запроса данных для ДП типа Lookup. Используется для обратной совместимости при возникновении проблем с новым алгоритмом.

`UseNewGrid`¶

Тип: JSON · По умолчанию: —

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

Параметры объекта правила: - subcats (int[]) — список ID категорий. Игнорируется, если allSubcats: true. - users (int[]) — список ID пользователей, к которым применяется правило. - allUsers (bool, по умолчанию false) — применить правило ко всем пользователям. - allSubcats (bool, по умолчанию false) — включить новый грид для всех категорий. - myTasks (bool, по умолчанию false) — включить новый грид в разделе «Мои задачи». - tickers (bool, по умолчанию false) — включить новый грид для тикеров (индикаторов).

Логика: правило срабатывает для пользователя, если users содержит его ID или allUsers: true. Если хотя бы одно подходящее правило имеет allSubcats: true — новый грид включается для всех категорий. Иначе — объединяются subcats из всех подходящих правил.

Пример (все пользователи, все категории, включая «Мои задачи» и тикеры):

[{ "subcats": [], "users": [], "allUsers": true, "allSubcats": true, "myTasks": true, "tickers": true }]

Пример (конкретные пользователи и категории):

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

`UseOldSurveys`¶

Тип: 0/1 · По умолчанию: —

Выбор редактора опросов.

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

`UseSearchYofication`¶

Тип: bool · По умолчанию: true

Включает использование ёфикации (буквы «е» и «ё» считаются идентичными при поиске). Управляет процессом нормализации букв «е» и «ё» в поисковом запросе.

`UseSmtpLog`¶

Тип: bool · По умолчанию: false

Управляет логированием SMTP-команд в журнале Сессии почтовых джобов.

`UseSystemTickersCache`¶

Тип: bool · По умолчанию: false

Определяет режим расчёта системных индикаторов (счётчиков). Рекомендуется устанавливать true для активации механизма кеширования системных счётчиков пользователя.

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

При false система выполняет прямой запрос к БД через хранимую процедуру GetSystemTickers каждый раз при необходимости обновления счётчиков.

`UseTrigramInSimpleSearch`¶

Тип: 0/1 · По умолчанию: 0

Включение возможности нечёткого поиска по тексту с учётом опечаток в окне быстрого поиска в панели инструментов.

0 — полнотекстовый поиск.
1 — триграмм поиск.

UseMailToLinksForSignaturesFromEmails¶

Тип: 1/0 · По умолчанию: —

Использовать mailto-ссылки в письмах с запросом подписи.

Ссылка mailto — специальный тип гиперссылки, которая при клике открывает почтовый клиент для создания нового письма с заранее заполненными данными.

Значение 1 позволяет акцептантам выносить резолюции по подписям, не заходя в интерфейс «Первой Формы», а отправляя письмо на служебный ящик.

При значении 1 ссылки будут иметь формат: mailto:<адрес>?subject=<тема ответа>&Body=<текст ответа>, где:
<адрес> — адрес почтового ящика для ответов.
<тема ответа> — тема письма с уведомлением (TaskSignatureID + ResolutionKey=).
<текст ответа> — текст комментария к резолюции.

По клику будет отправляться письмо на адрес, указанный в Общих настройках приложения в параметре «Почтовый ящик для ответов» или «Внешний почтовый ящик для ответов». Письмо будет обработано заданием ServiceMailBoxesJob, и по подписи будет вынесена выбранная резолюция. В системной категории «Уведомления о прочтении» будет создаваться задача с текстом вида TSID=59354|A=Accept.

При значении 0 или пустом значении ссылки будут иметь формат обычной адресной строки, и по клику будет открываться интерфейс «Первой Формы».

ℹ️ Если включена отправка резолюций на почту, то в системной категории «Уведомление о прочтении» на вкладке «Почтовые ящики» должен быть настроен ящик, указанный в Общих настройках приложения в параметре «Почтовый ящик для ответов».

`UserAuthenticationProviderVerificationJob_EnablePasswordScan`¶

Тип: bool · По умолчанию: —

Активация проверки паролей для задания по таймеру UserAuthenticationProviderVerificationJob.

`usersDefaultUseNewTaskCard`¶

Тип: 0/1 · По умолчанию: —

Если ключ принимает значение 0, то при создании пользователя в системе (вручную в режиме администрирования, с помощью смарт-действий или при синхронизации с AD) для них будет установлено отображение прежней (устаревшей) формы карточки задачи.

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

`WinAppLinks_ColumnIds`¶

Тип: array · По умолчанию: —

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

`WriteEwsRequestDurationToAutomationLog`¶

Тип: bool · По умолчанию: false

Управляет логированием длительности выполнения запросов EWS в журнал автоматизации. При включении настройки система будет записывать в лог время, затраченное на выполнение каждого запроса к EWS.

DiadocLastEventsId¶

Тип: JSON · По умолчанию: —

Идентификатор последних событий Диадок. Наличие ключа является обязательным условием для интеграции.

Формат:

{
  "LastEvents": [
    {
      "BoxId": "string",
      "ClientId": " ",
      "Timestamp": 1704067200
    }
  ]
}

Параметры: - BoxId — идентификатор организации. Можно посмотреть в веб-интерфейсе системы Диадок. - ClientId — уникальный строковый идентификатор клиента. Получается после заключения договора на использование API Диадок. - Timestamp — количество тиков в наносекундах от начальной даты 01.01.0001 до момента, когда в «Первую Форму» должен прийти первый документ. При значении 0 автоматически устанавливается дата первого подключения к Диадок.

`DiadocLogEnabled`¶

Тип: bool · По умолчанию: false

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

`DisableSmtpChunking`¶

Тип: bool · По умолчанию: false

Отключение разбиения на фрагменты (chunks) для SMTP. При включении система будет передавать всё тело письма как один монолитный блок данных вместо использования механизма чанкования.

`DoNotSelectedTaskInSummary`¶

Тип: bool · По умолчанию: —

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

`DSUpdateCSVPermissions`¶

Тип: JSON · По умолчанию: —

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

Формат:

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

Параметры: - groups — список ID групп, для пользователей которых необходимо включить кнопки. - subcats — список ID категорий, для которых необходимо включить кнопки.

Пример:

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

`EdsSettings`¶

Тип: JSON · По умолчанию: —

Настройки электронной подписи (ЭП) в системе.

`EnableCipherInUniversalApiCallbackUrls`¶

Тип: bool · По умолчанию: false

Включить шифрование в URL-адресах обратного вызова UniversalAPI.

`EnabledLocalizedSearch`¶

Тип: bool · По умолчанию: —

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

`EnableEwsCalendarInboxAccess`¶

Тип: bool · По умолчанию: —

Управление обращением к папке Inbox при синхронизации с Exchange в функционале календаря.

`EnableEwsEmailSubscriptions`¶

Тип: bool · По умолчанию: —

Управление подпиской на события в почтовом ящике Inbox при синхронизации с Exchange.

`EnableEwsSetDirectSyncDisabledWhenEwsErrorsOccurs`¶

Тип: bool · По умолчанию: —

Управление функционалом, при котором в случае возникновения ошибок Exchange (ServiceError.ErrorNonExistentMailbox, ServiceError.ErrorItemNotFound, ServiceError.ErrorFolderNotFound, ServiceError.ErrorInvalidFolderId, ServiceError.ErrorInvalidSmtpAddress) у пользователя увеличивается счётчик ошибок синхронизации.

`EnableEwsSubscriptions`¶

Тип: bool · По умолчанию: —

Управление подпиской на события Exchange.

`EveryTagExtParams`¶

Тип: array · По умолчанию: —

Необходимо для интеграции с файловым провайдером EveryTag. Содержит массив ID ДП. При обработке запросов на скачивание/просмотр файлов из этих ДП в EveryTag отправляется информация для установки метки времени.

`EveryTagSubcats`¶

Тип: array · По умолчанию: —

Необходимо для интеграции с файловым провайдером EveryTag. Содержит массив ID категорий. При обработке запросов на скачивание/просмотр файлов из этих категорий в EveryTag отправляется информация для установки метки времени.

`EWSDoNotCheckUserRight`¶

Тип: bool · По умолчанию: —

Влияет на возможность просмотра всех событий календаря другого пользователя, даже если у текущего пользователя нет доступа в Exchange. Такие события отображаются в виде пустого блока без названия и деталей, если EWSDoNotCheckUserRight = false и EWSShowBusyStatus = true.

Возможные комбинации:

EWSShowBusyStatus = false + EWSDoNotCheckUserRight = false — пользователи имеют доступ к событиям других, используя права системной учётной записи.
EWSShowBusyStatus = true + EWSDoNotCheckUserRight = false — разрешается видимость только занятости между двумя EWS; пользователи без доступа видят только слоты занятости без деталей.
EWSShowBusyStatus = true + EWSDoNotCheckUserRight = true — между двумя EWS видна только занятость, проверка прав внутри каждого EWS отключена.
EWSShowBusyStatus = false + EWSDoNotCheckUserRight = true — все пользователи имеют доступ ко всем событиям без проверки прав.

`EWSShowBusyStatus`¶

Тип: bool · По умолчанию: —

Используется совместно с EWSDoNotCheckUserRight. Подробнее см. описание выше.

`ExcludeSystemSubstitutes`¶

Тип: bool · По умолчанию: true

Установка запрета акцепта подписей замещаемых пользователей для заместителей. Запрошенные подписи не будут отображаться в таблице «Ожидающие вашей подписи» и не будут учитываться в счётчике подписей у заместителей.

При запросе подписи заместители не добавляются в акцептанты, если данная настройка включена (true) и активна опция подписи на переходе «Запретить подписывать заместителю».

`ExchangeConnectionLifetime`¶

Тип: int · По умолчанию: 1

Время существования соединения с подписками в минутах (от 1 до 30).

`ExchangeConnectionPoolSize`¶

Тип: int · По умолчанию: —

Размер пула, допустимое количество одновременных соединений. Пользователь берёт соединение из пула, выполняет запрос и возвращает обратно. При заполнении пула выполнение приостанавливается до освобождения. Максимальное значение — 100.

`ExchangeNotification_ConnectionLifetime`¶

Тип: int · По умолчанию: 30

Время действия соединения при обновлении событий из Exchange, задаётся в минутах от 1 до 30. Применяется после переподключения.

`ExchangePermissionsCacheLifeTime`¶

Тип: int · По умолчанию: 5

Время жизни кеширования Exchange в минутах.

`ExchangeSemaphoreCount`¶

Тип: int · По умолчанию: 50

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

`ExchangeSemaphoreWait`¶

Тип: int · По умолчанию: 0

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

`ExchangeSubscriptionsToLog`¶

Тип: bool · По умолчанию: —

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

`ExperimentalMultilookupEpIds`¶

Тип: array · По умолчанию: —

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

`ExportAgGridAsCsv`¶

Тип: bool · По умолчанию: false

Позволяет экспортировать список задач категории в формат .csv по кнопке «В Excel». Если ключ отсутствует или false, файл экспортируется в формате .xlsx.

`ExtendedSubcatSettings`¶

Тип: JSON · По умолчанию: —

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

Формат:

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

Параметры: - commentQuestionsAllow — если false, запрещено помечать вопросом комментарий в данной задаче/чате. - commentNotMeAnswerRequired — если false, в данной задаче не требуется написание комментария при выборе «Вопрос не мне».

`ExtParamExtraSettings`¶

Тип: JSON · По умолчанию: —

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

Формат:

{ "ExtParamID": { "scanOnly": true } }

Пример:

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

`ExtParamTableLookUpTextLength`¶

Тип: int · По умолчанию: 100

Задаёт максимально доступное значение символов для отображения значения в ячейке ДП «Таблица» с типом «Lookup поле». Символы сверх лимита обрезаются.

`ExtParams_CalendarEventChangeLog`¶

Тип: bool · По умолчанию: true

Включает логирование изменений событий в календаре.

`FileIdToStartOcr`¶

Тип: int · По умолчанию: —

Минимальный ID файла (из таблицы БД FileStorageFiles), с которого начинается обработка файлов заданиями по таймеру OcrJob и TikaJob (каждые 15 минут в течение дня).

OcrJob — распознавание текста в изображениях (img, jpg, png).
TikaJob — распознавание текста в документах (pdf, doc, docx, xsl, xslx, ppt, pptx, txt, xml, html, eml, sql, pgsql, xml, json).

`FirstCommentIdWithNoRecipients`¶

Тип: int · По умолчанию: —

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

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

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

`ForbidAuthByPhone`¶

Тип: bool · По умолчанию: —

Запрещает авторизацию по номеру телефона.

`ForbidEmailAsLogin`¶

Тип: bool · По умолчанию: false

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

`ForbidPhoneAsLogin`¶

Тип: bool · По умолчанию: —

Запрещает использование номера телефона в качестве логина при входе.

`ForbidSubcatRightsInheritanceToDirector`¶

Тип: 1/0 · По умолчанию: 1

Руководители по умолчанию не наследуют право на просмотр всех задач категории от своих подчинённых.

1 — права не наследуются.
0 — права наследуются.

Учитывает только право «Просмотр всех задач» в настройках доступа категории для групп. Отдельно можно выдать запрет для руководителя на наследование через опцию в общих настройках приложения «Руководитель наследует право на просмотр задач, где его подчинённые заказчики или исполнители».

`ForbidTCLogin`¶

Тип: 1/0 · По умолчанию: 0

Опциональная проверка входа в приложение TaskCenter (работает на платформе .NET Framework).

1 — доступ к приложению будет проверяться при попытке входа.
0 — в приложение TaskCenter сможет войти любой пользователь.

`FromUtpTableFirstOrderSubcats`¶

Тип: JSON · По умолчанию: —

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

Формат:

{
  "LookupSubcatIds": [],
  "LookupSummaryIds": []
}

Параметры: - LookupSubcatIds — ID категорий. - LookupSummaryIds — ID категорий сводного раздела.

`GantSettings`¶

Тип: JSON · По умолчанию: —

Настройка проектного управления в представлении Диаграммы Ганта. Актуально для версий 2.256 — 2.261.

Формат:

{
  "projectEpId": 0,
  "orderedDateEpId": 0
}

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

Пример:

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

`HideUserVoipToken`¶

Тип: bool · По умолчанию: —

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

`ImapTimeout`¶

Тип: int · По умолчанию: 40000 (40 секунд)

Таймаут на выполнение IMAP операции при синхронизации в миллисекундах.

`LazyJobsNumberOfItemsToProcessInBatch`¶

Тип: int · По умолчанию: —

Позволяет задать значение количества записей, которые будут единоразово обработаны в задании по таймеру LazyUpdatableCachesUpdateJob.

`LazyJobsShowDetailedLog`¶

Тип: bool · По умолчанию: —

Выводит более подробные данные в сообщении задания по таймеру LazyUpdatableCachesUpdateJob: ключи и полученные значения.

`LDAP_AdGlobalCatalogHosts`¶

Тип: string · По умолчанию: —

Список доменов, для которых все LDAP-запросы (включая синхронизацию пользователей и навигацию по дереву AD) направляются через порты глобального каталога Active Directory: 3269 (LDAPS) и 3268 (LDAP) вместо стандартных 636/389.

Ускоряет запросы, однако глобальный каталог содержит не все атрибуты — часть из них может отсутствовать при синхронизации. Если это критично, используйте LDAP_AdGlobalCatalogHostsNavigate.

Если ни LDAP_AdGlobalCatalogHosts, ни LDAP_AdGlobalCatalogHostsNavigate не заданы, запросы идут через стандартные порты 636/389. Значения задаются в виде доменных имён через запятую.

`LDAP_AdGlobalCatalogHostsNavigate`¶

Тип: string · По умолчанию: —

Список доменов, для которых порты глобального каталога Active Directory (3269/3268) используются только при построении дерева навигации. Для остальных операций, в том числе синхронизации пользователей, применяются стандартные порты 636/389.

Используйте этот ключ вместо LDAP_AdGlobalCatalogHosts, если в глобальном каталоге отсутствуют атрибуты, необходимые для синхронизации, но навигация по дереву AD должна работать быстро. Значения задаются в виде доменных имён через запятую.

`LogPlanExecution`¶

Тип: int · По умолчанию: —

Позволяет задать порог логирования для анализа производительности запросов. Значение — время в миллисекундах.

Если длительность выполнения SQL-запроса превышает значение, установленное в настройке, то автоматически формируется план выполнения, который записывается в колонку «План запроса» в логе автоматизации.

Функция доступна только для СУБД PostgreSQL. Работает только при включённом логировании SQL-запросов в общей настройке приложения.

`LogRefreshTokenRequests`¶

Тип: bool · По умолчанию: —

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

ℹ️ В прежнем интерфейсе режима администрирования Кастомные настройки приложения можно открыть из Общих настроек приложения по клику на кнопку Редактировать.

Кастомные настройки приложения¶

Управление записями¶

AddUserLoginToSignedFiles¶

Appointments_TimeTryToReacreateMins¶

AppointmentsToExternal_HandleOpenExternalConnection¶

AppointmentsToExternal_NotSyncedAppointmentsLimit¶

AppointmentsToTasks_NotSyncedAppointmentsLimit¶

AppointmentsToTasks_FutureDaysLimit¶

AppointmentsToTasks_OccurrencesCountLimit¶

AppointmentsToTasks_OccurrencesDaysLimit¶

AppointmentsToTasks_OccurrencesPastDaysLimit¶

AuthConfig¶

BackgroundQueueMaxConcurrency¶

BackgroundQueueTaskTimeoutMinutes¶

BrandSettings¶

CalendarExtParams¶

CalendarPopupMenuSubcats¶

CalendarRequestTimeoutInMilliseconds¶

CalendarSyncMinAppoinmentEndDaysBack¶

ChangeLanguageInAppBar¶

CKEditorCustomConfigPath¶

CommitTransactionAfterSubcatIDChange¶

CompressDSSettings¶

ConferenceDefaultUserRoomSettings¶

ConferenceRoomUrlTemplate¶

CreateIfNeeded¶

CSVImportMaxThreadsCount¶

custom-app-settings¶

AdminPath¶

allowCSVGridFilter¶

allowDBAdminExport¶

AllowThemes¶

backgroundTasks¶

custom-admin-panel¶

CustomTaskUsedAsEpBlocksExtSettings¶

customWorkersDictionarySP¶

DataSourceAggregates¶

DecodeBigTextEp¶

DecodeBigTextEpExcept¶

DefaultConverterPdf¶

DisableAllCachesUpdate¶

EmptyFeedPlaceholderURL¶

EnableAllTabsNotifications¶

ganttExportPdfUrl¶

ganttImportMppUrl¶

ganttSubtaskDefaults¶

GroupsInProfile¶

HelperCustomLink¶

HideDefaultTags¶

HideEmptyEpOnNtf¶

HideOldGantt¶

HideUserInfoButton¶

highCharts¶

hideSubcatSyndicateControls¶

imageCompressionEngine¶

IsFeedsViewOnly¶

IsOldSignTicker¶

isSpaAdminMode¶

matomo¶

newEpTable¶

newTaskSpa¶

ParseCommentsLinksJob_LastParsedCommentId¶

PasswordRecoveryText¶

personalDynSignaturesOnly¶

ProjectReferenceTableExtParamId¶

ProjectTableJSONExtParamID¶

refreshGridEvents¶

requestTimeout¶

requestTimeoutExcludeUrls¶

resourcesSubcatDefaults¶

resourceExtendAddEnable¶

SearchSubcategoryFolders¶

showAI¶

showCalendarMessageCounter¶

signal¶

spaResources¶

taskLinkNoFrame¶

tspUrl¶

useEditableEpTable¶

useNewEpAndTaskUsed¶

`AddUserLoginToSignedFiles`¶

`Appointments_TimeTryToReacreateMins`¶

`AppointmentsToExternal_HandleOpenExternalConnection`¶

`AppointmentsToExternal_NotSyncedAppointmentsLimit`¶

`AppointmentsToTasks_NotSyncedAppointmentsLimit`¶

`AppointmentsToTasks_FutureDaysLimit`¶

`AppointmentsToTasks_OccurrencesCountLimit`¶

`AppointmentsToTasks_OccurrencesDaysLimit`¶

`AppointmentsToTasks_OccurrencesPastDaysLimit`¶

`AuthConfig`¶

`BackgroundQueueMaxConcurrency`¶

`BackgroundQueueTaskTimeoutMinutes`¶

`CalendarExtParams`¶

`CalendarPopupMenuSubcats`¶

`CalendarRequestTimeoutInMilliseconds`¶

`CalendarSyncMinAppoinmentEndDaysBack`¶

`ChangeLanguageInAppBar`¶

`CKEditorCustomConfigPath`¶

`CommitTransactionAfterSubcatIDChange`¶

`CompressDSSettings`¶

`ConferenceDefaultUserRoomSettings`¶

`ConferenceRoomUrlTemplate`¶

`CreateIfNeeded`¶

`CSVImportMaxThreadsCount`¶

`AdminPath`¶

`allowCSVGridFilter`¶

`allowDBAdminExport`¶

`AllowThemes`¶

`backgroundTasks`¶

`custom-admin-panel`¶

`CustomTaskUsedAsEpBlocksExtSettings`¶

`customWorkersDictionarySP`¶

`DataSourceAggregates`¶

`DecodeBigTextEp`¶

`DecodeBigTextEpExcept`¶

`DefaultConverterPdf`¶

`DisableAllCachesUpdate`¶

`EmptyFeedPlaceholderURL`¶

`EnableAllTabsNotifications`¶

`ganttExportPdfUrl`¶

`ganttImportMppUrl`¶

`ganttSubtaskDefaults`¶

`GroupsInProfile`¶

`HelperCustomLink`¶

`HideDefaultTags`¶

`HideEmptyEpOnNtf`¶

`HideOldGantt`¶

`HideUserInfoButton`¶

`highCharts`¶

`hideSubcatSyndicateControls`¶

`imageCompressionEngine`¶

`IsFeedsViewOnly`¶

`IsOldSignTicker`¶

`isSpaAdminMode`¶

`matomo`¶

`newTaskSpa`¶

`ParseCommentsLinksJob_LastParsedCommentId`¶

`PasswordRecoveryText`¶

`personalDynSignaturesOnly`¶

`ProjectReferenceTableExtParamId`¶

`ProjectTableJSONExtParamID`¶

`refreshGridEvents`¶

`requestTimeout`¶

`requestTimeoutExcludeUrls`¶

`resourcesSubcatDefaults`¶

`resourceExtendAddEnable`¶

`SearchSubcategoryFolders`¶

`showAI`¶

`showCalendarMessageCounter`¶

`signal`¶

`spaResources`¶

`taskLinkNoFrame`¶

`tspUrl`¶

`useEditableEpTable`¶

`useNewEpAndTaskUsed`¶

`UseNewExtParamsAndTaskUsed`¶

`useNewExtendedSearch`¶

`useNewFRReports`¶

`useNewMTF`¶

`userProfileInfoExts`¶