Раздел “Карточки”

В данном разделе содержится информация о создании, редактировании и просмотре типов карточек, типов карточек диалогов, типов карточек заданий и типов карточек файлов.

Действия, доступные для корневых элементов списка типов карточек (например, через контекстное меню, которое можно вызвать правой кнопкой мыши):

Действие	Сочетание клавиш	Команда в контекстном меню
Создание типа карточки	Ctrl + Shift + C	Добавить тип карточки
Создание типа диалога	Ctrl + Shift + D	Добавить тип диалога
Создание типа файла	Ctrl + Shift + F	Добавить тип файла
Создание типа задания	Ctrl + Shift + T	Добавить тип задания
Обновление списка	F5	Обновить

Действия, доступные для типов карточек:

Действие	Сочетание клавиш	Команда в контекстном меню
Добавление формы (только для типов карточек заданий)	Ctrl + Shift + M	Добавить форму
Добавление настройки завершения (только для типов карточек заданий)	Ctrl + Shift + O	Добавить настройки завершения
Добавление расширения	—	Добавить расширение
Добавление валидатора	—	Добавить валидатор
Экспорт типа	Ctrl + E	Экспортировать тип
Создание копии типа	Alt + C	Создать копию типа
Исправление типа	Ctrl + R	Исправить
Обновление типа	—	Обновить
Удаление	Del	Удалить

Note

Нажатие клавиши F5 обновляет сразу весь список, обновить конкретный тип карточки можно с помощью пункта Обновить контекстного меню.

Экспорт и импорт

В Tessa Admin в разделе “Карточки” можно экспортировать и импортировать типы карточек, а также импортировать карточки и создавать библиотеки карточек для импорта.

Note

Библиотека карточек - это файл с расширением *.jcardlib в формате json, содержащий в себе путь до набора карточек, которые могут быть расположены в разных подпапках. Используется для быстрого и удобного импорта большого количества карточек.

Note

В подпапке Sourсe папки сборки можно посмотреть пример скрипта для экспорта конфигурации - Export.bat. Ниже описано выполнение операций вручную.

Типы карточек

Для экспорта типа карточки необходимо выбрать в дереве нужный тип и далее с помощью пункта Экспортировать тип контекстного меню, кнопки панели инструментов или сочетания клавиш Ctrl + E выполнить экспорт.

Также экспорт можно выполнять с помощью команды ExportTypes консольной административной утилиты tadmin.

Импорт типов карточек выполняется с помощью сочетания клавиш Ctrl + I, либо с помощью кнопки на панели инструментов - в открывшемся контекстном меню нужно выбрать пункт Импортировать типы…. В открывшемся окне можно выбрать сразу несколько файлов типов карточек и выполнить их одновременный импорт. После импорта необходимо сохранить изменения.

Также импорт типов карточек можно выполнять с помощью команды ImportTypes консольной административной утилиты tadmin.

Карточки

Импорт карточек выполняется или с помощью сочетания клавиш Alt + I, либо с помощью кнопки на панели инструментов - в открывшемся контекстном меню нужно выбрать пункт Импортировать карточки….

В открывшемся окне импорта можно:

• Открыть библиотеку карточек из файла *.jcardlib с помощью кнопки или комбинации клавиш Ctrl + O.
• Добавить карточки и библиотеки в список для выбранных файлов *.jcard или *.jcardlib с помощью кнопки или комбинации клавиш Alt + A.

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

• Отметить все карточки с помощью кнопки или комбинации клавиш Ctrl + Q.
• Отменить выбор для всех карточек с помощью кнопки или комбинации клавиш Ctrl + E.
• Задать опции слияния для выделенных карточек с помощью кнопки , расположенной рядом с полем Опции, или с помощью комбинации клавиш Alt + O.
• Очистить опции слияния для выделенных карточек с помощью кнопки , расположенной рядом с полем Опции, или с помощью комбинации клавиш Alt + C.
• Выполнить импорт всех отмеченных в списке карточек с помощью кнопки Импортировать отмеченные карточки.

Note

Признак ( = библиотека) рядом с названием элемента списка означает, что он является библиотекой.

Note

Признак (++опции) рядом с названием элемента списка означает, что для него заданы опции слияния.

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

Поле Условие не учитывает регистр и поддерживает следующие значения (для других значений импорт пропускается):

• ms - импорт выполняется для СУБД Microsoft SQL Server;
• pg - импорт выполняется для СУБД PostgreSQL;
• поле не заполнено - импорт выполняется всегда.

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

Импорт карточек выполняется в режиме обновления (слияния с импортируемыми) существующих в базе данных карточек. Для контроля поведения логики слияния имеется возможность задать опции слияния, представляющие собой файл в формате json. Опции, указанные для библиотеки карточек, будут проигнорированы.

Note

Подробнее о механизме слияния и об использовании API слияния объектов можно узнать в Руководстве разработчика.

Опции слияния могут быть задействованы несколькими путями:

1. Явно указаны для карточки в диалоге импорта.
2. Явно указаны в библиотеке карточек (это можно сделать в диалоге импорта с последующим сохранением библиотеки карточек). В данном случае это должно быть сделано для каждой карточки, нуждающейся в опциях слияния.
3. Заданы в файле merge-options.json, находящимся в поддиректории относительно местонахождения файла карточки. Наименование поддиректории должно совпадать с именем файла карточки без расширения (например, если имя файла карточки CardForImport.jcard, то файл merge-options.json должен находиться в поддиректории с наименованием CardForImport).

Important

В первых двух случаях имена файлов опций слияния могут быть произвольными, в третьем случае файл опций слияния необходимо всегда называть merge-options.json.

Файл опций слияния имеет следующую структуру:

{
    "IgnoreDuplicateRows": false,
    "SkipIfCardExists" : false,
    "SectionsSettings": [
        {
            "Name": "Section1",
            "IgnoreDuplicateRows": null,
            "Ignored": false,
            "IncludedColumns": [
                "Column1",
                "Column2",
            ],
            "ExcludedColumns": [
                "Column1",
                "Column2",
            ],
            "IgnoredColumns": [
                "Column1",
                "Column2",
            ],
            "KeyColumns": [
                "Column1",
                "Column2",
            ],
            "UpdatedColumns": [
                "Column1",
                "Column2",
            ],
        },
        {
           "Name": "Section2",
           ...
        },
    ...
    ]
    "FileSettings" : {
        "KeyColumns" : [
            "Column1",
            "Column2"
        ],
        "IncludedColumns" : [
            "Column1",
            "Column2",
            "Column3"
        ],
        "ContentColumns" : [
            "Column4"
        ],
        "AlwaysUpdateContent" : false
    }
}

• IgnoreDuplicateRows - bool, false. Отвечает за логику в случае более одного совпадения по ключевым строкам в табличных секциях, true - дубликаты будут проигнорированы и не вставлены в результате слияния, false - логика зависит от реализации (например, дубликаты будут вставлены в результате слияния, а также будет показано предупреждение через ValidationResult о том, что был обнаружен дубликат). Действует для всей карточки.
• SkipIfCardExists - bool, false. При значении true слияния не произойдет в случае, если карточка уже имеется в системе. Т.е. либо будет произведен импорт карточки целиком, без слияния, если такой карточки еще не было в системе, либо не произойдет ничего. Таким образом, если данный параметр имеет значение true, остальные параметры слияния можно не указывать.

• SectionsSettings - object[], null. Содержит массив настроек для конкретных секций карточки.

  • Name - string. Наименование секции, для которой задаются параметры слияния. Параметр обязателен для заполнения.
  • IgnoreDuplicateRows - bool, null. Переопределяет общий параметр IgnoreDuplicateRows для конкретной секции.
  • Ignored - bool, false. Значение true указывает на то, что секция игнорируется при слиянии. Это означает, что любые изменения данной секции в импортируемой карточке будут проигнорированы.
  • IncludedColumns - string[], null. Включенные в сравнение колонки. Решение о том, равны ли строки (для табличных секций) или сами секции (для Entry секции), будет приниматься на основании указанных колонок.
  • ExcludedColumns - string[], null. Исключенные колонки. Сравнение значений строк (для табличных секций) или полей (для Entry секции) будет происходить за исключением указанных колонок. Данный параметр имеет приоритет перед параметром IncludedColumns, поэтому если они будут заполнены оба, параметр IncludedColumns будет проигнорирован, а в ValidationResult будет записано предупреждение об этом.
  • IgnoredColumns - string[], null. Игнорируемые колонки. Поведение такое же, как и у параметра ExcludedColumns, но в дополнение к логике параметра ExcludedColumns, колонки, указанные в IgnoredColumns, будут проигнорированы при обновлении секции.
  • KeyColumns - string[], null. Ключевые колонки. Если логика слияния не смогла сопоставить строки табличной секции по RowID, то они будут сопоставляться по указанным в данном параметре колонкам.

• FileSettings - object, null. Содержит настройки для слияния прикрепленных к карточке файлов.

  • KeyColumns - string[], null. Ключевые колонки. Если логика слияния не смогла сопоставить файлы по полю RowID, то они будут сопоставляться по указанным в данном параметре полям.
  • IncludedColumns - string[], null. Включенные в сравнение колонки. Решение о том, равны ли файлы, будет приниматься на основании указанных полей, иначе по умолчанию будут использованы поля Name, CategoryID, CategoryCaption, VersionRowID и Hash.
  • UpdatedColumns - string[], null. Обновляемые колонки. Значения узлов слияния, относящихся к данной секции, будут сравниваться только с учетом указанных в данном параметре колонок. Аналогично IncludedColumns, но обновление всех остальных колонок дополнительно производиться не будет.
  • ContentColumns - string[], null. На основании полей, указанных в данном параметре, будет приниматься решение об обновлении контента файла в случае, если логика слияния определит, что он был модифицирован. Если данный параметр не заполнен, по умолчанию будут использованы поля VersionRowID и Hash.
  • AlwaysUpdateContent - bool, false. При значении true контент файлов будет принудительно обновлен, параметр ContentColumns при этом игнорируется.

Important

Опции UpdatedColumns и IncludedColumns не следует заполнять одновременно, это не имеет практического смысла, и при слиянии будет выдана ошибка.

Note

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

Note

Параметры SectionsSettings следует заполнять только для тех секций, для которых это необходимо. Например, если опции необходимо указать только для секций SectionWithCustomOptions1 и SectionWithCustomOptions2, часть SectionsSettings в файле опций слияния должна выглядеть следующим образом:

{
    "IgnoreDuplicateRows": true,
    "SectionsSettings": [
        {
            "Name": "SectionWithCustomOptions1",
            ...
        },
        {
           "Name": "SectionWithCustomOptions2",
           ...
        }
    ]
}

Note

Остальные параметры следует указывать только в случае, если их значения отличаются от значений по умолчанию. Например, если необходимо игнорировать дубликаты строк при слиянии для всей карточки, а также сопоставлять строки в секции CustomKeySection по ключевым колонкам KeyColumn1 и KeyColumn2, то файл опций слияния должен выглядеть следующим образом:

``` json
{
    ...
    "SectionsSettings": [
        {
            "Name": "CustomKeySection",
            "KeyColumns": [
                "KeyColumn1",
                "KeyColumn2",
            ],
        }
    ]
}
```

Important

Если в карточке имеются секции с полем, для которого определен уникальный ключ, то для импорта таких карточек следует задать опции слияния. В опциях необходимо определить параметр KeyColumns для таких секций и указать имя уникального поля. Например:

``` json
{
    ...
    "SectionsSettings": [
        {
            "Name": "SectionWithUniqueField",
            "KeyColumns": [
                "UniqueFieldName"
            ]
        }
    ]
}
```

Example

Рассмотрим опции слияния для уникальных полей в секциях на примере конкретного типа карточек. В типе Правило доступа имеется несколько секций с уникальными полями, это секции: KrPermissionRoles с полем RoleID, KrPermissionStates с полем StateID и KrPermissionTypes с полем TypeID. Следовательно, опции слияния для типа Правило доступа должны выглядеть следующим образом:

{
    "SectionsSettings": [
        {
            "Name": "KrPermissionRoles",
            "KeyColumns": [
                "RoleID"
            ]
        },
        {
            "Name": "KrPermissionStates",
            "KeyColumns": [
                "StateID"
            ]
        },
        {
            "Name": "KrPermissionTypes",
            "KeyColumns": [
                "TypeID"
            ]
        }
    ]
}

Important

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

Для того, чтобы отключить сравнение и расчёт хешей при импорте карточек, необходимо использовать опции слияния с явно заданными списками IncludedColumns и ContentColumns - данные списки не должны содержать поле Hash.

Рекомендуемые поля для отключения расчета хешей:

- Для `IncludedColumns`: `Name`, `CategoryID`, `CategoryCaption` и `VersionRowID`.
- Для `ContentColumns`: `VersionRowID`.

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

Импорт карточек можно также выполнить с помощью команды ImportCards консольной административной утилиты tadmin.

Экспорт карточек выполняется в web-клиенте: нужно открыть карточку или представление с карточками и выполнить экспорт с помощью меню системы. При экспорте по умолчанию указано расширение .jcard.

Important

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

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

Экспорт карточек можно также выполнить с помощью команды ExportCards консольной административной утилиты tadmin.

Создание нового типа карточки

Cоздать новый тип карточки можно с помощью пункта Создать тип карточки контекстного меню или сочетания клавиш Ctrl + Shift + C.

Новый или измененный тип карточки выделяется в списке жирным шрифтом. Типы карточек/файлов/заданий/диалогов сгруппированы аналогично таблицам.

После создания типа карточки ему можно задать следующие настройки:

Название	Описание
Имя	Название типа карточки, которое будет отображаться в списке
Заголовок	Название типа карточки, которое будет отображаться пользователю
Группа	Группа, к которой принадлежит карточка
Формат дайджеста	Определение строки форматирования для дайджеста карточки, т.е. для названия, используемого в заголовке вкладки, истории действий и т.д. Для использования полей карточки доступна стандартная система плейсхолдеров. Наведя курсор на поле, можно посмотреть всплывающую подсказку с примером. Если поле не заполнено - вычисление дайджеста выполняется стандартным образом (например, это номер карточки, если она включена в типовое решение и в ней присутствует секция с номером)
Идентификатор типа	Идентификатор типа карточки. С помощью кнопок, расположенных справа от поля, можно скопировать идентификатор типа отдельно или вместе с именем для использования в расширениях
Административный	Установка данного флага определяет, что карточки данного типа будут доступны только администраторам
Разрешить загрузку всем пользователям	Установка данного флага разрешает для всех пользователей загружать карточки, в настройках типа которых указан флаг Административный, но только для чтения. При этом загружается список только тех файлов, в настройках типа которых не указан флаг Административный
Скрытый	Установка данного флага скрывает карточки данного типа
Разрешить задания	Установка данного флага разрешает выдавать задания по карточке
Фиксировать действия	Установка данного флага определяет, что любые действия с карточкой фиксируются в истории действий
Удалять в корзину	Установка данного флага определяет, что карточки данного типа будут удаляться с возможностью восстановления
Единственный экземпляр	Установка данного флага определяет, что карточка данного типа может существовать только в единственном экземпляре
Загружать при инициализации	Установка данного флага определяет, что карточка, существующая в единственном экземпляре, будет загружена и добавлена в кэш на клиенте в процессе загрузки web-клиента
Разрешить файлы	Установка данного флага определяет, что при загрузке карточки также загружается информация по файлам, принадлежащим карточке
Использовать конструктор форм	Установка данного флага определяет, что при открытии карточки будет использоваться пользовательский интерфейс, построенный в конструкторе форм
Разрешить теги	Установка данного флага разрешает использование тегов. Если флаг не установлен, то операции с тегами для всех карточек данного типа будут запрещены

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

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

Note

Поле ID можно выбрать вручную, не выбирая другие поля, это означает, что у карточки данная секция будет иметь только системные поля, такие как ID, RowID и ParentRowID в зависимости от типа секции Строковая, Коллекционная и Иерархическая соответственно.

Note

Колонка ID не отображается в крайнем правом столбце со списком выбранных колонок.

Important

Если для таблицы выбраны не все поля, то оставшиеся поля должны либо иметь значения по умолчанию, либо поддерживать значение null.

В узле Вкладки отображается интерфейс для редактирования формы карточки.

Форма карточки разделена на вкладки, в которых расположены блоки, в которых, в свою очередь, расположены элементы интерфейса (контролы: поля карточки, таблицы и т.п.). Форма карточки всегда имеет как минимум одну вкладку и создаётся с ней.

Чтобы добавить ещё одну вкладку, необходимо нажать на вкладку с иконкой +, также можно вставить ранее скопированную вкладку.

Для работы с блоками используются следующие кнопки:

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

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

Свойства блока:

Название	Описание
Заголовок	Название блока, которое будет отображаться в форме
Алиас	Системное имя
Количество колонок	Максимальное количество полей на одной строке
Вертикальный интервал между контролами	Вертикальный интервал между полями блока
Горизонтальный интервал между контролами	Горизонтальный интервал между полями блока
Не оптимизировать блок	Установка данного флага определяет, что при указании единственной колонки в настройках блок будет выведен без оптимизации
Скрывать блок	Установка данного флага скрывает блок целиком
Свёрнут по умолчанию	Установка данного флага определяет, что блок при открытии карточки по умолчанию будет свёрнут
Не сворачивать с верхним блоком	Установка данного флага определяет, что блок не будет свёрнут при сворачивании расположенного выше блока. Актуально, если у блока скрыт заголовок. Если у блока заголовок не скрыт, то не зависимо от этого флага блок не будет сворачиваться при сворачивании верхнего блока
Заголовки слева	Установка данного флага определяет, что заголовки будут располагаться слева от элементов управления. Если не установлен, то заголовки будут расположены сверху
Растягивать по вертикали	Установка данного флага определяет, что элемент управления будет растянут на максимальную возможную высоту в блоке. Актуально, если элемент управления является единственным в блоке и отключена настройка Не оптимизировать блок. Если в блоке больше одного элемента управления, то настройка игнорируется.
Скрывать заголовок	Установка данного флага скрывает заголовок поля

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

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

Блоки и контролы также можно копировать и вставлять.

Дополнительно в тип карточки можно добавить:

• Расширения - платформенные настраиваемые расширения, с помощью которых можно указать специфичное поведение для полей.
• Валидаторы - специальные проверки наличия и уникальности значений в полях.

Добавление полей в карточку

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

Вещественное число

Данный тип поля предназначен для указания вещественных чисел в карточке, для него доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки поля
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Минимальное значение	Минимальное значение, которое принимает поле. Можно использовать алиас min для задания минимального возможного системного значения
Максимальное значение	Максимальное значение, которое принимает поле. Можно использовать алиас max для задания максимального возможного системного значения
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Вкладки

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Включить прокрутку	Установка данного флага включает область прокрутки внутри вкладки. Имеет смысл выставлять, если нет прокрутки снаружи вкладки (в самой карточке), т.е. если используется форма Расположение блоков, в которой блок растянут по вертикали на какое-то количество пропорций (поле Высота не пустое). В этом случае контрол Вкладки будет растянут по вертикали на весь блок и для любой из вкладок будет внутренняя прокрутка для лежащих там контролов, но только в том случае, если флаг Включить прокрутку выставлен. Если прокрутка снаружи от контрола Вкладки включена, то, независимо от флага, внутри вкладки прокрутки не будет, прокручиваться будет контрол целиком
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля
Вкладки	Редактор для настройки вкладок, идентичен редактору вкладок основного окна

Выбор цвета

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Палитра	Алиас палитры, которая будет использована при выборе цвета (подробнее см. Настройки цветов палитры). Поле не является обязательным. Если палитра не указана, то вместо выбора из выпадающего набора цветов палитры, цвет будет выбираться при помощи инструмента подбора цвета
Цвет текста	Цвет вводимого текста (текстовое название выбранного цвета, при выборе в контроле цвета, данный текст формируется автоматически)
Стиль текста	Стиль вводимого текста (текстовое название выбранного цвета, при выборе в контроле цвета, данный текст формируется автоматически)
Использовать всё пространство	Установка данного флага определяет, что будет использована вся возможная ширина для отображения контрола. При снятом флаге контрол отображается в стандартном размере
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Разрешить пустое значение	Установка данного флага определяет, что данное поле разрешено оставлять пустым
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Дата и время

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки поля
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Тип	Режим использования поля: дата и время, дата, время, интервал
Игнорировать часовой пояс	Установка данного флага определяет, что часовой пояс пользователя будет игнорироваться
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Разрешить пустое значение	Установка данного флага определяет, что данное поле разрешено оставлять пустым
Скрывать поле	Установка данного флага скрывает поле
Скрывать секунды	Установка данного флага скрывает секунды при отображении даты и времени
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Десятичное число

Данный тип поля предназначен для указания в карточке десятичных чисел, для него доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки поля
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Минимальное значение	Минимальное значение, которое принимает поле. Можно использовать алиас min для задания минимального возможного системного значения
Максимальное значение	Максимальное значение, которое принимает поле. Можно использовать алиас max для задания максимального возможного системного значения
Знаков после запятой	Количество используемых знаков после запятой
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Кнопка

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки кнопки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Минимальная ширина кнопки	Минимальная ширина нажимаемой области кнопки в пикселях. 0 - не ограничивать минимальную ширину; пустая строка - рекомендуемая минимальная ширина
Текст	Текст кнопки
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Использовать всё пространство	Установка данного флага определяет, что будет использована вся возможная ширина для отображения контрола. При снятом флаге контрол отображается в стандартном размере
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Контейнер

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки кнопки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Включить прокрутку	Установка данного флага включает область прокрутки внутри контейнера. Имеет смысл выставлять, если нет прокрутки снаружи контейнера (в самой карточке), т.е. если используется форма Расположение блоков, в которой блок растянут по вертикали на какое-то количество пропорций (поле Высота не пустое). В этом случае контрол Контейнер будет растянут по вертикали на весь блок и для лежащих в нём контролов будет внутренняя прокрутка, но только в том случае, если флаг Включить прокрутку выставлен. Если прокрутка снаружи от контрола Контейнер включена, то, независимо от флага, внутри контейнера прокрутки не будет, прокручиваться будет контрол целиком
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля
Блоки и контролы	Редактор для настройки контейнера, идентичен редактору вкладки основного окна

Метка (заданный текст)

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Текст	Отображаемый текст метки
Ссылка или команда	Ссылка или команда, выполняемая при нажатии на гиперссылку. Актуально, если выбран тип гиперссылка
Цвет текста	Цвет отображаемого текста
Стиль текста	Стиль шрифта отображаемого текста
Граница и фон	Настройки границы и фона текстового поля
Тип	Настройки режима работы данного контрола
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Для метки можно выбрать один из следующих типов работы:

Название	Описание
Текст	Стандартный режим работы для отображения текста
Эмодзи (смайлы)	Режим поддержки рендеринга эмодзи (смайлов)
Гиперссылка	Режим кликабельной гиперссылки

Для метки существуют следующие настройки границы и фона:

Название
Цвет фона	Цвет фона отображаемого текста
Толщина рамки	Толщина рамки вокруг отображаемого текста
Радиус скругления	Радиус скругления рамки
Цвет рамки	Цвет рамки вокруг отображаемого текста
Внутренний отступ	Отступ отображаемого текста от рамки

Нумератор

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

Для данного типа поля доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Секция карточки	Секция, в которой будут храниться записи
Номер	Поле, в котором будет храниться полный номер документа
Порядковый номер	Поле, в котором будет храниться порядковый номер карточки, выделенный из последовательности
Последовательность	Поле, в котором будет храниться название последовательности, из которой для карточки был выделен номер
Тип номера	Тип номера из расширений. Влияет на действия, которые инициируются из контрола нумератора: по освобождению номера и по выделению нового номера. Это не влияет на отображение номера. В типовом решении доступны следующие типы номеров: Primary - используются поля Number/FullNumber/Sequence в секции DocumentCommonInfo. Secondary - используются поля SecondaryNumber/SecondaryFullNumber/SecondarySequence в секции DocumentCommonInfo. Указанный тип номера - это своего рода алиас для того, какую роль выполняет номер, Primary - текущий (проектный или регистрационный), Secondary - всегда проектный. В проектном решении можно добавить другие типы номеров в расширениях и задействовать их в контроле. Также типы номеров Primary/Secondary можно переназначить на другие секции и поля, причём как глобально, так и в пределах отдельно взятых типов карточек
Максимальная длина	Максимальная длина полного номера. Ограничение актуально для номеров, вводимых вручную. Для автоматического определения длины в соответствии со схемой данных следует оставить данное поле пустым
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Цвет текста	Цвет отображаемого текста
Стиль текста	Стиль шрифта отображаемого текста
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Обсуждения

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

Note

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

Для обсуждения доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Тип обсуждений	Тип обсуждений. Служит для фильтрации обсуждений, например, из расширений. По умолчанию Default
Минимальная высота	Минимальная высота данного контрола
Максимальная высота	Максимальная высота данного контрола. Если содержимое не помещается в предоставленную область, то появляется полоса прокрутки
Автофокус	Установка данного флага определяет, что при открытии карточки фокус автоматически будет выставлен в область ввода сообщений. Актуально, если выставлен флаг Единственное обсуждение
Всегда отображать в полный размер	Установка данного флага определяет, что контрол будет занимать всю предоставленную ему область
Единственное обсуждение	Установка данного флага определяет, что в данном контроле может быть отображено/добавлено только одно обсуждение
Обратный порядок сообщений	Установка данного флага определяет, что в списке обсуждений, внутри обсуждений и в результатах поиска сообщения будут выводиться от более новых к более старым
Растянуть по вертикали	Установка данного флага определяет, что поле будет растянуто по вертикали настолько, насколько это потребуется для отображения всей информации. Настройки Максимальная высота и Минимальная высота при этом учитываться не будут
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Отображение html

Данный вид поля предназначен для отображения произвольного html, который может находиться в секции карточки либо задаваться через расширение “Шаблон файла в контроле html”.

Для контрола доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Безопасный html	Установка данного флага определяет, что санитайзинг html выполняться не будет. Устанавливается, если формирование html полностью контролируется и есть уверенность в том, что html не содержит вредоносных скриптов
Отображать в iframe	Установка данного флага определяет, что html будет отображен в iframe
Отображать изображения	Установка данного флага определяет, что вложенные изображения по умолчанию будут отображены
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Предпросмотр файлов

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Минимальная высота	Минимальная высота области предпросмотра в ситуации, когда её нельзя разместить на всю возможную высоту. Чтобы не ограничивать высоту, следует указать пустую строку
Максимальная высота	Максимальная высота области предпросмотра. Чтобы не ограничивать высоту, следует указать пустую строку
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Представление

С помощью данного типа поля можно отображать представление в карточке. Для контрола доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Алиас представления	Алиас отображаемого в элементе управления представления
Алиас параметра CardID	Алиас параметра представления, в который будет передаваться идентификатор карточки
Маппинг представления	Стандартный редактор маппинга параметров представления, позволяющий указать источники значений для параметров представления
Алиас мастер-контрола	Алиас элемента управления “Представление”, который является главным для данного дочернего представления. При изменении параметров или выбранной пользователем строки будет обновляться текущее представление
Алиас настроек	Алиас для сохранения настроек в хранилище пользователя. Если алиас не задан, то настройки сохраняются по уникальной строке, составленной из алиаса типа, алиаса контрола и алиаса представления. Это рекомендуемое поведение. Алиас является глобально уникальной строкой для всех контролов представлений во всех типах. Этой строке ставятся в соответствие ширина и расположение колонок, скрытые колонки, направление сортировки и другие настройки, которые пользователь может сохранить через меню
Высота	Высота представления. Если значение больше 0, отображаемый размер таблицы будет ограничен по высоте. В данном случае в контроле могут отображаться полосы прокрутки
Минимальная высота строки	Минимальная высота строки представления в пикселях. По умолчанию 0 - не ограничивать минимальную высоту
Режим открытия ссылок	Режим открытия карточек по ссылкам: По умолчанию - при открытии карточки из модального окна она также открывается в модальном окне; Вкладка - карточка всегда открывается в виде новой вкладки основного окна; Диалог - карточка всегда открывается в режиме диалога; Не открывать - ссылка не открывается
Автоматически выделять первую строку	Установка данного флага определяет, что первая строка представления будет автоматически выделена после обновления. Настройку рекомендуется включить, если у данного представления есть detail представление
Запрет расчёта ширины столбцов	Установка данного флага отключает автоматический расчёт ширины столбцов элемента управления
Отключить при создании карточки	Установка данного флага определяет, что запросы данных представления не будут отправляться до сохранения карточки (в том числе и через добавление параметров или кнопку обновления)
Разрешить прокрутку	Установка данного флага определяет, что прокрутка мышью будет прокручивать строки внутри представления, а не область с карточкой
Разрешить сохранение настроек	Установка данного флага включает возможность сохранения настроек отображения для элемента управления, в том числе настроек скрытых колонок, группировки, ширины и порядка колонок, используемой сортировки. Для корректной работы опции у элемента управления должен быть указан Алиас представления, а если в типе есть несколько элементов управления с тем же алиасом, то в поле Алиас должен быть указан уникальный алиас элемента управления. Для более гибкой настройки используется значение Алиас настроек
Сворачивать группы	Установка данного флага определяет, что группы в представлении будут свёрнуты после обновления
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Окно настроек маппинга представления открывается по кнопке в поле Маппинг представления. В этом окне можно настроить фильтрацию представления, указанного в параметре Алиас представления, на основе данных о карточке.

Каждое условие маппинга добавляется как параметр запроса к представлению, указанному в параметре Алиас представления, и содержит следующие настройки:

Название	Описание
Тип поля	Тип поля для маппинга: Поле карточки, Идентификатор карточки, Тип карточки, Имя типа карточки, Текущий пользователь, Константа, Ссылка. Тип поля Ссылка позволяет настраивать ссылку на значение из мастер-представления, в зависимости от значения поля Тип ссылки: Parameter - ссылка на параметр, заданный в мастер-представлении; Column – ссылка на значение столбца из текущей выбранной строки в мастер-представлении
Параметр представления	Имя параметра представления, на которое осуществляется маппинг
Набор параметров	Связь маппинга дочернего представления с выбранным столбцом мастер-представления в режиме выделения. Значение — имя столбца мастер представления или пустая строка для использования параметров по умолчанию
Оператор сравнения	Оператор сравнения, который будет применён для добавляемого параметра. Если выбран тип поля Поле карточки, то до тех пор, пока не указано поле карточки, доступны для выбора все операторы сравнения, применимые к одиночным параметрам. После указания поля карточки станут доступны только те операторы сравнения, которые подходят для данного поля. Если к моменту указания поля карточки уже выбран оператор сравнения и он не подходит для данного поля, то оператор сравнения будет сброшен на EqualsTo. Для типа поля Константа доступность указания и допустимые операторы сравнения определяются на основе выбранного типа константы
Поле карточки	Поле карточки. Доступно, только если выбран тип поля Поле карточки. При привязке к коллекционным секциям система передаёт в параметры представления список значений по всем записям коллекционной секции. При обработке коллекционной секции внутри формы редактирования строки в параметр будет передаваться значения только для текущей строки. Если же внутри формы редактирования строки используется маппинг на дочернюю коллекционную секцию (секцию, в которой есть ссылка на родителя), то передаются только значения строк, у которых родителем является текущая строка
Формат текста	Формат отображаемого значения для параметра. Доступно только если выбран тип поля Поле карточки. Если в поле карточки указан идентификатор из комплексной колонки, то можно использовать стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: {0}, - {1}. Номера в указателях указываются в порядке следования физических колонок. Если формат не указан, то для отображаемого значения выбирается первое текстовое поле из комплексной колонки
Не добавлять параметр для NULL	Установка данного флага определяет, что параметр не будет создан, если значение столбца равно NULL. Если флаг не установлен, то будет добавлен параметр с отбором по IsNull

Список (несколько автодополняемых значений)

С помощью данного типа поля можно хранить ссылки на поля таблицы базы данных. Для контрола доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Поле для сортировки	Поле, в котором хранится порядок записей
Формат поля	Формат выводимого значения. Используются стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: \{0}, - \{1}. Номера в указателях указываются в порядке следования физических колонок. Строки стандартного формата аналогичны форматированию custom format в плейсхолдерах
Поле для ручного ввода	Поле карточки для хранения текста, введенного вручную. Поле должно находиться внутри комплексной референсной колонки
Алиас представления	Алиас представления (записей таблицы, на которую ссылается поле)
Алиас параметра	Алиас параметра представления
RefSection	Алиас или разделённые пробелами алиасы секций, из которых допускается выбор значений. Параметр позволяет вывести только те представления, у которых есть ссылка с RefSection, равным хотя бы одному значению параметра
Префикс референса	Алиас префикса для определения используемого референса, предоставляемого представлениями
Маппинг представления	Настройки маппинга представления, указанного в параметре Алиас представления
Максимальное отображаемое количество результатов	Максимальное отображаемое количество результатов, выводимых в popup
Задержка поиска	Задержка перед началом поиска значения. Если не указано, то 125 мс
Режим поиска	Условие, передаваемое в параметр представления
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Настройки popup	Настройки выпадающего popup
Режим открытия ссылок	Режим открытия карточек по ссылкам: По умолчанию - при открытии карточки из модального окна она также открывается в модальном окне; Вкладка - карточка всегда открывается в виде новой вкладки основного окна; Диалог - карточка всегда открывается в режиме диалога; Не открывать - ссылка не открывается
Кнопка очистки значения	Установка данного флага включает отображение кнопки, при нажатии на которую поле очищается
Отключить локализацию	Установка данного флага отключает локализацию отображаемых значений, даже если она включена в настройках
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Перенос строк	Установка данного флага разрешает перенос строк
Разрешить ручной ввод	Установка данного флага разрешает ввод в поле произвольного значения
Расширенная локализация	Установка данного флага включает использование локализации с форматированием строк вида {$...}
Скрывать кнопку выбора	Установка данного флага скрывает кнопку …
Скрывать поле	Установка данного флага скрывает поле, чтобы его можно было показать в расширениях
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Настройка маппинга представления описана выше.

Настройки popup:

Название	Описание
Ширина popup	Максимальная ширина popup в процентном соотношении от ширины экрана
Элементы popup	Номера полей представления, перечисленные через запятую, которые будут отображаться в окне с вариантами подстановки для каждого элемента
Соотношение ширин колонок popup	Соотношение ширин колонок popup в обычном режиме при превышении максимальной ширины popup в процентном соотношении от ширины экрана

Important

Если ссылочный контрол связан с секцией, у которой нет первичного ключа, то ключом ссылки считается первая физическая колонка внутри комплексной колонки, на которую настроен контрол.

Note

Если в контроле не задан формат отображения и не найдено ни одного текстового поля в комплексной колонке, то контрол отображает значение [EMPTY]. Если есть поле для отображения, но представление не предоставило необходимых данных, то в контроле отображается [NULL].

Tip

Механизм выбора референса представлений в контроле работает по принципу приоритета настроек. Наивысший приоритет имеет настройка Префикс референса. Если указан Префикс референса, то выбирается референс, у которого ColPrefix соответствует указанному Префиксу референса. Если Префикс референса не указан, по приоритету далее следует настройка RefSection и контрол будет искать в представлении первый референс, содержащий в своих настройках хотя бы одно общее значение параметра RefSection. А если не указаны обе предыдущие настройки, то используется первый референс, у которого в списке секций есть секция, на которую ссылается комплексная колонка контрола.

Список файлов

Данный контрол предназначен для хранения файлов карточки, для него доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Сортировка	Вид сортировки, которая будет отображаться по умолчанию пользователям при открытии карточки документа. Пользователь может выбрать другой вид сортировки в карточке документа, но этот выбор запомнится только для текущей открытой карточки, при переоткрытии карточки снова отобразится вид по умолчанию. Доступные значения: Name - для сортировки по имени; Size - для сортировки по размеру; Modified - для сортировки по дате изменения
Направление сортировки	Направление выбранной сортировки
Настройки группировки	Наличие и признак свёрнутости и развёрнутости для группировки по умолчанию
Группировка	Вид группировки, которая будет отображаться по умолчанию пользователям при открытии карточки документа. Пользователь может выбрать другой вид группировки в карточке документа, но этот выбор запомнится только для текущей открытой карточки, при переоткрытии карточки снова отобразится вид по умолчанию. Актуально, если в поле Настройки группировки указан любой режим кроме группировка отключена. Доступные значения: Copy - для группировки по копии файлов; Category - для группировки по категории. Если для типа документа необходимо использовать группировку по циклам, то данное поле не заполняется, т.к. указанный в нём вид группировки приоритетней настроек группировки по циклам, указанным в карточке настроек типового решения. Подробнее о видах группировки можно прочитать в Руководстве пользователя
Алиас предпросмотра	Алиас контрола предпросмотра файлов (если используется отдельный контрол)
Представление категорий	Представление, из которого запрашиваются доступные категории. По умолчанию указывается типовое представление FileCategoriesFiltered. Данное представление выводит полный список категорий (посмотреть список категорий и создать новые можно в представлении Администратор -> Справочники -> Категории файлов). Если необходимо ограничить список доступных категорий в зависимости от типа или состояния документа, то данные условия прописываются в коде представления (или создаётся новое представление и прописывается в этом поле)
Маппинг представления	Настройки маппинга представления категорий
Запретить добавлять категории	Установка данного флага запрещает ручной ввод категории в диалоге выбора категорий
Запретить файлы без категории	Установка данного флага запрещает добавлять файлы без указания категории
Игнорировать существующие категории	Установка данного флага отключает отображение категорий, уже добавленных пользователями в текущую карточку, при добавлении новых файлов. Актуально, если не стоит флаг Запретить добавлять категории
Использовать категории	Установка данного флага включает функциональность категорий для данного списка файлов
Скрывать поле	Установка данного флага скрывает поле
Сохранять порядок категорий	Установка данного флага сохраняет порядок следования категорий из представления в диалоге выбора категорий
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Настройка маппинга представления описана выше.

Important

К используемому в данном контроле представлению (по умолчанию FileCategoriesFiltered) предъявляются следующие требования: представление должно возвращать идентификатор (Guid) и имя категории (string) именно в такой последовательности. Любые нарушения указанных требований приведут к нарушению работы с категориями, на это следует обращать особое внимание при модификации данного представления или указании другого представления для данного контрола.

Ссылка (поле с автодополнением)

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Формат поля	Формат выводимого значения. Используются стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: \{0}, - \{1}. Номера в указателях указываются в порядке следования физических колонок. Строки стандартного формата аналогичны форматированию “custom format” в плейсхолдерах
Всплывающая подсказка	Текст всплывающей подсказки поля
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Поле для ручного ввода	Поле карточки для хранения текста, введенного вручную. Поле должно находиться внутри комплексной референсной колонки
Алиас представления	Алиас представления (записей таблицы, на которую ссылается поле)
Алиас параметра	Алиас параметра представления
RefSection	Алиас или разделённые пробелами алиасы секций, из которых допускается выбор значений. Параметр позволяет вывести только те представления, у которых есть ссылка с RefSection, равным хотя бы одному значению параметра
Алиас представления выпадающего списка	Алиас представления (записей таблицы, на которую ссылается поле) в режиме работы, как выпадающий список
Префикс референса	Алиас префикса для определения используемого референса, предоставляемого представлениями
Маппинг представления	Настройки маппинга представления, указанного в параметре Алиас представления
Максимальное отображаемое количество результатов	Максимальное отображаемое количество результатов, выводимых в popup
Задержка поиска	Задержка перед началом поиска значения. Если не указано, то 125 мс
Режим поиска	Условие, передаваемое в параметр представления
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Настройки popup	Настройки выпадающего popup
Режим открытия ссылок	Режим открытия карточек по ссылкам: По умолчанию - при открытии карточки из модального окна, она также открывается в модальном окне; Вкладка - карточка всегда открывается в виде новой вкладки основного окна; Диалог - карточка всегда открывается в режиме диалога; Не открывать - ссылка не открывается
Выпадающий список	Установка данного флага включает работу в режиме выпадающего списка
Кнопка очистки значения	Установка данного флага включает отображение кнопки, по нажатию на которую поле очищается
Отключить локализацию	Установка данного флага отключает локализацию отображаемых значений, даже если она включена в настройках
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Разрешить ручной ввод	Установка данного флага разрешает ввод в поле произвольного значения
Расширенная локализация	Установка данного флага включает использование локализации с форматированием строк вида {$...}
Скрывать кнопку выбора	Установка данного флага скрывает кнопку …
Скрывать поле	Установка данного флага скрывает поле, чтобы его можно было показать в расширениях
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Настройка маппинга представления описана выше.

Настройки popup:

Название	Описание
Ширина popup	Максимальная ширина popup в процентном соотношении от ширины экрана
Элементы popup	Список номеров полей представления, разделённых запятыми, для отображения в окне с вариантами подстановки для каждого элемента
Соотношение ширин колонок popup	Соотношение ширин колонок popup в обычном режиме при превышении максимальной ширины popup в процентном соотношении от ширины экрана
Элементы popup выпадающего списка	Список номеров полей представления, разделённых запятыми, для отображения в окне с вариантами подстановки для каждого элемента. Используется при работе в режиме выпадающего списка
Соотношение ширин колонок popup выпадающего списка	Соотношение ширин колонок popup в режиме Выпадающий список при превышении максимальной ширины popup в процентном соотношении от ширины экрана

Important

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

Tip

Механизм выбора референса представлений в контроле работает по принципу приоритета настроек. Наивысший приоритет имеет настройка Префикс референса. Если указан Префикс референса, то выбирается референс, у которого ColPrefix соответствует указанному Префиксу референса. Если Префикс референса не указан, далее по приоритету следует настройка RefSection, и контрол будет искать в представлении первый референс, содержащий в своих настройках хотя бы одно общее значение параметра RefSection. А если обе предыдущие настройки не указаны, то используется первый референс, у которого в списке секций есть секция, на которую ссылается комплексная колонка контрола.

Note

Если в контроле не задан формат отображения и не найдено ни одного текстового поля в комплексной колонке, то контрол отображает значение [EMPTY]. Если есть поле для отображения, но представление не предоставило необходимых данных, то в контроле отображается [NULL].

Tip

При очистке поля со ссылкой можно очищать связанные поля при помощи карточного расширения Очистка связанных полей.

Строка (редактируемое поле)

Данный вид поля предназначен для хранения простого текста, например, темы документа, а также уникальных идентификаторов. Для строки доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Формат поля	Формат выводимого значения. Используются стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: \{0}, - \{1}. Номера в указателях указываются в порядке следования физических колонок. Строки стандартного формата аналогичны форматированию “custom format” в плейсхолдерах
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Минимум строк	Минимальное количество занимаемых строк
Максимум строк	Максимальное количество строк, на которое можно расширить поле
Максимальная длина	Максимальное количество символов (укажите значение, соответствующее типу поля в базе данных )
Цвет текста	Цвет вводимого текста
Стиль текста	Стиль вводимого текста
Тип	Тип текстового редактора. Позволяет включить текстовый редактор с подсветкой синтаксиса
Настройки типа	Дополнительными настройки выбранного типа редактора
Кнопка разворачивания	Установка данного флага отображает кнопку для разворачивания текстового поля на весь экран (для удобства ввода большого текста)
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Перенос по словам	Установка данного флага разрешает перенос по словам
Проверять орфографию	Установка данного флага включает проверку орфографии в соответствии с текущим языком пользователя
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Таблица

Данные табличного типа должны храниться в виде записей отдельной таблицы базы данных. Для контрола доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Секция карточки	Таблица базы данных, в которой хранятся записи
Поле для сортировки	Поле, в котором хранится порядок строк
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Макс. строк для авторазмера столбцов	Максимальное количество строк, при которых таблица функционирует в режиме автоопределения размера столбцов. Если строк становится больше заданного количества, то автоопределение отключается, это позволяет отображать большое количество строк без потери производительности. Если задано отрицательное число, то автоопределение размера столбцов всегда выключено, а если указано max, то автоопределение всегда включено
Максимальная высота	Максимальная высота таблицы в точках (пикселях, зависимых от DPI). Чтобы не ограничивать высоту следует оставить поле пустым, в этом случае возможны проблемы с производительностью при большом количестве строк. Чтобы высота таблицы была минимальной, следует указать 0
Всегда показывать поиск и мультивыбор	Установка данного флага определяет, что панель под таблицей с окном поиска и кнопкой мультивыбора отображается всегда, даже если все другие кнопки на нижней панели скрыты
Разрешить мультивыбор	Установка данного флага разрешает множественный выбор строк
Разрешить прокрутку	Установка данного флага определяет, что прокрутка мышью будет прокручивать строки внутри таблицы, а не область с карточкой
Разрешить сортировку	Установка данного флага разрешает сортировку по колонкам таблицы
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля
Колонки и форма	Редактирование колонок и формы таблицы

Чтобы открыть редактор для настройки вывода данных в таблицу нужно нажать на кнопку Колонки и форма.

На вкладке Колонки следует добавить отображаемые поля выбранной таблицы с помощью кнопки . Далее нужно выделить добавленную колонку и задать необходимые параметры:

Название	Описание
Поля строки	Поля таблицы
Поля в дочерних строках	Поля дочерней секции, которые необходимо отобразить в данной колонке
Поле для сортировки дочерних строк	Поле, по которому будет отсортирован список значений полей в дочерней таблице. Можно указать только числовое поле (обычно это поле Order, если оно было добавлено для дочерней таблицы)
Агрегация дочерних строк	Дополнительная обработка списка дочерних строк. Более подробная информация находится во всплывающей подсказке на поле
Разделитель для дочерних строк	Разделитель между элементами дочерних строк. Более подробная информация находится во всплывающей подсказке на поле
Отображаемая длина	Максимальная отображаемая длина текста в колонке до того, как текст ограничивается троеточием
Ширина подсказки, символов	Примерное количество символов, которое ограничивает ширину подсказки, всплывающей на ячейках этой колонки. Если указано 0, то используется значение по умолчанию
Формат колонки	Формат поля. Строки стандартного формата аналогичны форматированию “custom format” в плейсхолдерах
Имя выбираемого контрола	Имя (алиас) контрола, который будет автоматически выбран при открытии строки по двойному клику по ячейке в этой колонке
Выравнивание	Способ выравнивания текста в колонке
Выравнивание заголовка	Способ выравнивания текста в заголовке колонки
Скрытая колонка	Установка данного флага скрывает колонку
Игнорировать часовой пояс	Установка данного флага определяет, что дата и время будут выведены без перевода в часовой пояс сотрудника, т.е. в режиме UTC. Если флаг не выставлен, то перед отображением дата/время переводятся в текущий часовой пояс пользователя (из настроек операционной системы). Данный флаг должен быть выставлен для любых колонок, содержащих дату без времени, поскольку, даже если отображается только дата, при переводе из UTC в часовой пояс пользователя внутри всё равно может измениться время (например, +3 часа по Москве). В некоторых часовых поясах при таком переводе дата может измениться (например, в отрицательных часовых поясах)
Не разрывать строки	Установка данного флага определяет, что контент ячеек в колонке будет выведен без разрывов строки
В одну строку	Установка данного флага определяет, что переводы строк будут заменены на пробелы. Если используется совместно с настройкой Не разрывать строки, то будут выставлены неразрывные пробелы, которые не могут переноситься на следующую строку при нехватке места
Без конечных пробелов	Установка данного флага определяет, что начальные и конечные пробельные символы или переводы строк будут удалены

Example

Например, такая настройка:

Даёт такой результат:

С помощью настройки Агрегация дочерних строк были выведены: текст Покупатели:, перенос строки, список значений всех строк дочерней секции (с помощью плейсхолдера {0}), перенос строки, текст Всего - и количество строк в дочерней секции (с помощью плейсхолдера {1}). Настройка Разделитель для дочерних строк позволила разделить значения полей дочерней секции между собой с помощью запятой и переноса строки. С помощью настройки Отображаемая длина были отображены только первые 90 символов, а настройка Формат колонки позволила задать формат выводимых значений: первая колонка (ФИО) - вторая колонка (дата без времени)

Important

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

Текст (поле только для чтения)

Данный контрол предназначен для вывода из секции текстового значения с применением к нему какого-либо оформления (пример такого поля можно посмотреть в карточке “Лицензия” - отображение количества доступных лицензий).

Для поля доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Формат поля	Формат выводимого значения. Используются стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: {0}, - {1}. Номера в указателях указываются в порядке следования физических колонок. Строки стандартного формата аналогичны форматированию “custom format” в плейсхолдерах
Цвет текста	Цвет отображаемого текста
Стиль текста	Стиль шрифта отображаемого текста
Тип	Настройки режима работы данного контрола
Граница и фон	Настройки границы и фона текстового поля
Скрывать поле	Установка данного флага скрывает поле
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Настройки типа:

Название
Текст	Стандартный режим работы для отображения текста
Эмодзи (смайлы)	Режим поддержки рендеринга эмодзи (смайлов)
Гиперссылка	Режим кликабельной гиперссылки

Настройки границы и фона:

Название
Цвет фона	Цвет фона отображаемого текста
Толщина рамки	Толщина рамки вокруг отображаемого текста
Радиус скругления	Радиус скругления рамки
Цвет рамки	Цвет рамки
Внутренний отступ	Отступ отображаемого текста от рамки

Текст с форматированием

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Минимальная высота	Минимальная высота данного контрола
Максимальная высота	Максимальная высота данного контрола. Если содержимое не помещается в предоставленную область, то будет отображена полоса прокрутки
Запретить добавление файлов	Установка данного флага запрещает добавление файлов в данный контрол
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Проверять орфографию	Установка данного флага определяет, что будет выполнена проверка орфографии в соответствии с текущим языком пользователя
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Warning

Контрол должен быть связан с колонкой типа String(Max) Null или String(Max) Not Null. Использование строки с ограниченной длиной будет приводить к ошибкам, связанным с отображением содержимого или даже с открытием карточки, поскольку при сохранении в базу данных могут быть записаны некорректные данные, “урезанные” на середине сериализованной строки в формате json в любом месте.

Warning

Контрол не должен быть привязан к тому же полю, к которому привязан другой контрол “Строка”, поскольку вводимые и выводимые данные не являются строкой текста, а содержат json с сериализованным html. Корректность отображения в этом случае не гарантируется.

Флажок

Контрол предназначен для отображения в карточке флагов, для него доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Цвет текста	Цвет отображаемого текста
Стиль текста	Стиль шрифта отображаемого текста
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Целое число

Данный тип поля предназначен для указания целых чисел в карточке. Для поля доступны следующие настройки:

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Поля в таблице базы данных, значение которых требуется отображать в поле карточки
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Вид отображения справки
Справка - значение	Значение для отображения справки
Поле не заполнено	Текст всплывающей подсказки при незаполненном обязательном поле
Минимальное значение	Минимальное значение, которое принимает поле. Можно использовать алиас min для задания минимального возможного системного значения
Максимальное значение	Максимальное значение, которое принимает поле. Можно использовать алиас max для задания максимального возможного системного значения
Цвет текста	Цвет отображаемого текста
Стиль текста	Стиль шрифта отображаемого текста
Отметить как обязательное	Установка данного флага определяет, что поле будет отмечено как обязательное для заполнения
Скрывать поле	Установка данного флага скрывает поле
Только для чтения	Установка данного флага отключает возможность редактирования поля
Скрывать заголовок	Установка данного флага скрывает заголовок поля
Растянуть по ширине	Установка данного флага задаёт отображение поля во всю ширину блока, независимо от количества колонок в блоке
Дополнительно	Дополнительные настройки отображения поля

Тип файла

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

Note

В системе используется тип файла File везде, кроме карточки шаблона файла, где используется тип файла TemplateFile. В проектах не рекомендуется использовать никакие другие типы файлов.

Тип файла дополнительно (помимо стандартных, описанных в разделе создания типа карточки) имеет следующую настройку:

• Не подписывать ЭП - установка данного флага определяет, что файлы этого типа не могут быть подписаны электронной подписью. Рекомендуется использовать эту настройку только для системных типов файлов, которые не должны поддерживать подписи, такие как “файл шаблона”.

Тип задания

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

Основные настройки

Для типа задания, как и для типа карточки, указываются:

• Секции - выбор таблиц и полей, которые будут выводиться в форму. Аналогично выбору секции в типе карточки.

• Формы - добавление форм для отображения задания. При создании нового типа задания этот список пуст. Дополнительные формы могут понадобиться для настройки внешнего вида задания при взятии его в работу или для отображения их при нажатии на кнопку завершения в задании. На форму могут быть добавлены любые контролы, как и в типе карточки, за исключением специфичных контролов, использующихся только в типе карточки, таких как контролы Представление или Предпросмотр файлов.

  Note

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

• Настройки завершения - кнопки для выполнения действий, которые будут отображаться в задании для автора или исполнителей.

• Расширения - платформенные настраиваемые расширения, с помощью которых можно указать специфичное поведение для полей.
• Валидаторы - специальные проверки заполненности и уникальности значений в полях.

Тип задания дополнительно (помимо стандартных, описанных в разделе создания типа карточки) имеет следующие настройки:

• Форма по умолчанию - позволяет выбрать одну из форм данного типа задания в качестве формы по умолчанию. Это форма, отображающаяся в задании сразу при взятии его в работу.
  Помимо форм, существующих в данном типе задания, может быть выбран вариант Пустая форма. В этом случае в качестве основной формы будет отображаться пустая форма с блоком информации о задании.

  Note

  В ситуации, когда вместо указания варианта Пустая форма для формы по умолчанию указана существующая пустая форма (без блоков/контролов), подразумевается, что данная форма будет наполнена контролами через расширение. В иных случаях предпочтительнее избегать подобной ситуации и для настройки пустой формы использовать вариант Пустая форма.

• Разрешить сохранение с файлами - признак того, что в системе разрешаются действия с заданиями вместе с сохранением содержимого файлов. Сохранение задания без выполнения действий (взятия в работу, завершения и др.) может выполняться одновременно с сохранением файлов, независимо от этого флага. Флаг проверяется только на клиенте при работе с UI и не влияет на код расширений, выполняющий сохранение карточки.

  Note

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

  Warning

  Этот флаг следует устанавливать только в том случае, когда этого явно требуют расширения в проекте.

• Автоматически брать в работу - признак того, что задания этого типа автоматически берутся в работу, т.е. исполнителю не нужно нажимать кнопку В работу. При выставлении флага задание будет взято в работу у всех исполнителей, если их несколько, но как только первый исполнитель изменит задание (создаст подзадачу, запросит комментарий и т.д.), оно будет зарезервировано за ним. Чтобы задание снова стало видно остальным исполнителям, зарезервировавшему нужно будет нажать Еще -> Вернуть на роль.

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

Настройки завершения

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

• Настройка завершения - из списка доступных выбирается вариант действия с заданием. Создать новую настройку завершения можно, добавив новую запись в таблицу CompletionOptions в разделе “Схема” приложения Tessa Admin.

  В новой записи указываются следующие данные:

  • ID - идентификатор настройки завершения, формируется автоматически.
  • Name - уникальное название настройки завершения.
  • Caption - отображаемое пользователю название кнопки действия с заданием. Можно указать строку локализации.

  • Библиотека - библиотека, в которой будет сохранена данная настройка завершения.

    Note

    По ID или Name настройки завершения можно написать обработку нажатия данной кнопки задания в скриптах маршрутов и процессов или в расширениях.

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

  

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

  

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

• Дополнительный вариант - признак того, что данная настройка завершения будет скрыта из основного списка доступных кнопок в задании. Найти её можно в меню под кнопкой .

• Не удалять задание - признак того, что задание на надо удалять при нажатии на кнопку данной настройки завершения. Например, в задании согласования при выборе варианта Запросить комментарии отправляется новое задание на комментирование, однако текущее задание на согласование не завершается.
• Функциональные роли - позволяет указать список функциональных ролей, которыми должен обладать пользователь (в контексте экземпляра данного типа задания), чтобы видеть данный вариант завершения и иметь возможность им воспользоваться.

Для настроек завершения можно указать валидаторы для полей задания, например, валидатор обязательности заполнения поля Комментарий в форме завершения задания. Валидатор добавляется с помощью контекстного меню на настройке завершения. 

Тип диалога

Тип диалога используется для создания интерфейса форм диалоговых окон на основе вкладки карточки. Тип диалога содержит редактор виртуальной схемы, в котором можно создавать виртуальные таблицы. Создаваемые виртуальные таблицы аналогичны виртуальным таблицам в основной схеме, но существуют только в рамках типа диалога, в котором созданы. Созданные в редакторе виртуальной схемы таблицы и колонки автоматически попадают в секции карточки. Тип диалога по умолчанию скрытый - карточку данного типа нельзя создать в клиентском приложении через кнопки меню карточки.

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

Tip

Пример отображения формы типа диалога можно найти в карточке “Автомобиль” (кнопка Показать диалог).

Интерфейс редактора виртуальной схемы аналогичен интерфейсу реактора обычной схемы в Tessa Admin.

Копирование элементов карточки

Элементы карточки (вкладки, блоки, контролы, колонки) можно копировать как в рамках одной карточки, так и между двумя разными карточками. Для копирования и вставки блоков, контролов и колонок можно использовать как команды Ctrl + C и Ctrl + V, так и кнопки и для копирования и вставки соответственно. Копирование и вставка вкладок осуществляется только при помощи контекстного меню.

Расширения типов

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

Расширение типа: Сортировка строк

Расширение типа карточки, диалога и задания для сортировки строк. Позволяет производить сортировку строк в табличной секции по указанному в настройке Сортировать по полю полю из строки этой секции. С помощью флага Локализовать строки можно производить локализацию значений перед сортировкой, чтобы отсортированные значения были упорядочены с учётом выбранного языка. По умолчанию сортировка происходит по возрастанию, но направление можно изменить, установив флаг Сортировать по убыванию.

Расширение типа: Очистка связанных полей

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

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

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

• Табличная секция является обычной секцией, никак не связанной с секцией, к которой принадлежит Отслеживаемая колонка. В этом случае при очистке Отслеживаемой колонки будут удалены все строки секции, которой принадлежат Очищаемые колонки.
• Табличная секция является той же самой секцией, которой принадлежит Отслеживаемая колонка. В этом случае будут просто очищаться значения в Очищаемых колонках в конкретной строке.
• Табличная секция является дочерней по отношению к табличной секции, которой принадлежит Отслеживаемая колонка (имеет ссылку на родителя). В этом случае будут очищаться записи в секции с Очищаемыми колонками, являющиеся дочерними по отношению к строке секции, которой принадлежит Отслеживаемая колонка.

Расширение типа: Запрет изменения

Расширение типа карточки для запрета изменения колонки (комплексной или физической) после первого сохранения карточки. Колонку, указанную в настройке Поле, можно будет редактировать только при создании карточки. После первого сохранения карточки все связанные с такой колонкой контролы будут доступны только для чтения. Данное расширение удобно использовать вместе с валидатором на обязательность заполнения данной колонки.

Расширение типа: Список файлов в представлении

Расширение типа карточки, диалога и задания, которое связывается с элементом управления “Представление” и наделяет его функциями, аналогичными элементу управления “Список файлов”, т.е. позволяет в табличной форме просматривать файлы в области предпросмотра, добавлять и редактировать их, а также выполнять любые другие функции “Списка файлов”.

Для корректной работы расширения необходимо добавить в карточку элемент управления “Представление” с уникальным алиасом. Флаг Автоматически выделять первую строку должен быть установлен. В поле Алиас представления задается уникальный алиас, указанный при создании контрола “Представление”.

Для включения постраничного отображения следует воспользоваться выпадающим списком Постраничное отображение. Дополнительно можно настроить ограничение количества строк на странице с помощью параметра Ограничение количества строк на странице (по умолчанию значение данного параметра равно 20).

Настройка Постраничное отображение имеет опции Да, Нет и Опционально. Опция Нет является значением по умолчанию.

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

Остальные настройки расширения аналогичны настройкам элемента управления “Список файлов”, где приведено их описание.

Note

При использовании расширения с типом диалога в коде при создании диалога необходимо указать параметры для инициализации файлового контейнера. Пример можно найти в UI-расширении для карточки “Автомобиль” - кнопка Запросить из внешней системы.

Расширение типа: Представление истории заданий

Расширение типа карточки, которое добавляет представлению функциональность стандартной вкладки История заданий.

Отображение будет оптимальным при следующих настройках:

• В узле Вкладки в группе настроек Стандартная форма -> Расположение блоков значение параметра Высота равно единице.
• В форму добавлен единственный колоночный блок, выставлен флаг Растягивать по вертикали.
• В блок добавлен единственный контрол “Представление”.

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

Для удобства просмотра представления, содержащего большое количество строк, в настройках контрола “Представление” можно выставить флаг Разрешить прокрутку.

В настройке расширения Алиас параметра для передачи токена безопасности необходимо указать параметр представления, в который будет передаваться токен безопасности. В представлении, которое будет использоваться для отображения истории заданий, должен быть определен параметр, использующий тип данных String. Данный параметр не может быть использован в тексте SQL-запроса представления. Использование токена безопасности позволяет предотвратить просмотр истории заданий карточки пользователем, у которого нет прав на просмотр содержимого карточки. Для данного параметра рекомендуется использовать алиас Token, как в представлении TaskHistory.

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

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

Расширение типа: Скрыть вкладку

Расширение типа карточки и диалога, которое скрывает указанную в поле Название вкладки вкладку.

Tip

Для скрытия стандартной вкладки История заданий необходимо указывать алиас .TaskHistoryViewModel.

Расширение типа: Таблица в представлении

Расширение типа карточки, диалога и задания, которое позволяет отображать строки секции в контроле “Представление” аналогично контролу “Таблица”. С данным расширением представление содержит все функции контрола таблицы, а также поддерживает маппинг, master-detail и все возможные модификации (в коде), которые можно произвести с контролом “Представление”, например, добавление тегов или анимации.

Для корректной работы расширения необходимо добавить в карточку элемент управления “Представление” с уникальным алиасом. В настройке Алиас контрола представления должен быть введен уникальный алиас, указанный при создании контрола “Представление”.

При связи master-dеtail detail-таблица должна отображать строки дочерней секции master-таблицы. Для задания связи достаточно указать в настройках detail-представления алиас master-представления, маппинг настраивать не требуется.

Доступна возможность отображать флаг, привязанный к полю строки типа Boolean, в первой колонке таблицы с помощью настройки Колонка флажок.

Расширение типа: Открыть карточку из представления

Расширение типа карточки и задания, позволяющее открывать карточки из элемента управления “Представление” по двойному щелчку левой кнопкой мыши по соответствующей строке.

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

• Алиас контрола представления - уникальный псевдоним (алиас) соответствующего элемента управления формы карточки или задания. Поле является обязательным для заполнения.
• Префикс референса - строка префикс (см. ColPrefix в руководстве разработчика), для которой расширение будет анализировать колонки представления в приоритетном порядке для определения подходящей пары значений (идентификатор - имя). Поле не является обязательным для заполнения.
• Имя диалога - служебное имя диалога для обеспечения возможности работы с ним из расширений, используется только при открытии карточки в диалоговом режиме. Поле не является обязательным для заполнения.
• Режим открытия ссылок - режим открытия карточек по ссылкам:
  По умолчанию - при открытии карточки из модального окна, она также открывается в модальном окне;
  Вкладка - карточка всегда открывается в виде новой вкладки основного окна;
  Диалог - карточка всегда открывается в режиме диалога;
  Не открывать - ссылка не открывается.

Расширение типа: Шаблон файла в контроле html

Tip

Данное расширение работает только для web-клиента.

Расширение типа карточки, диалога или задания, которое позволяет отображать вместо указанного контрола произвольный html, сгенерированный по шаблону файла на сервере. Расширение содержит следующие настройки:

• Идентификатор шаблона файла - идентификатор шаблона файла, по которому будет сгенерирован html. Получить идентификатор можно, открыв структуру карточки шаблона файла и скопировав содержимое поля ID.
• Алиас контрола для отображения - алиас контрола отображения html карточки, диалога или задания, в котором будет отображен сгенерированный по шаблону html.

Расширение типа: Переместить колонку с тегами влево

Расширение для типа карточки, которое в контроле представления с указанной позицией тегов В колонке перемещает колонку с тегами влево. Применяется, если пользователь не задал иное положение колонки в настройках контрола. Алиас контрола представления, в котором требуется изменить положение колонки с тегами, следует указать в поле Алиас контрола представления настроек расширения.

Валидаторы

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

Валидаторы: Непустая секция/Непустое поле

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

Валидатор Непустое поле нужен для указания обязательности заполнения полей.

Валидаторы содержат следующие настройки:

• Проверяемая секция/Проверяемое поле - секция/поле, обязательные для заполнения.

• Сообщение об ошибке - сообщение об ошибке или предупреждение при попытке сохранить карточку с незаполненной указанной секцией или полем. В данном поле можно указать строку локализации вида $Localization_String или ключ валидации вида #RoleNameIsNotUnique. Если поле оставить пустым, то выводится универсальное сообщение с указанием имени секции/колонки.

  Note

  Ключ валидации - это ключ сообщения об ошибке или предупреждения. Он может задаваться в коде платформы, расширениях типового или проектного решений, где ключу валидации сопоставляются строки локализации. В расширении по данному ключу можно “отлавливать” такие ошибки и предупреждения и обрабатывать по необходимости: удалять, производить дополнительные проверки и прочее.

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

Валидатор: Уникальное поле

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

• Проверяемое поле - поле, которое будет проверяться на уникальность. Может быть в строковой секции - тогда проверяется уникальность в рамках карточки в базе данных. Если поле из коллекционной секции, то проверяется уникальность в рамках текущей карточки.
• Поле для сортировки - поле для сортировки в проверяемой коллекционной секции. Указывается в случае, если выставлен флаг Автоматически удалять строки-дубликаты и проверяемая секция упорядочена, причём порядковый номер строки хранится в поле для сортировки. Если поле задано, то для корректной работы все строки, отображаемые контролом, должны иметь отличные от Null значения в этом поле. В схеме данных рекомендуется использовать поле Not Null (например, Int32 Not Null), причём для учёта существующих строк можно установить Default value = 0. Тип поля может быть Null, но для всех строк в структуре карточки должны быть валидные числовые значения.
• Родительское поле, ограничивающее уникальность - поле, в рамках которого отслеживается уникальность проверяемого поля, т.е. если значения в родительском поле разные, то дубли в проверяемом поле разрешены. Например, это идентификатор строки в родительской секции - значит дубли разрешены в разных родительских строках. В строковой секции это, например, уникальность по имени подразделения - когда в поле Родительское поле, ограничивающее уникальность указана ссылка на родительское подразделение, получается, что в пределах одного родительского подразделения дубли по имени запрещены, а для разных – разрешены.

• Сообщение об ошибке – текст предупреждения или ошибки, который выводится пользователю при возникновении дубля. Используется, если не включено автоудаления срок-дубликатов. В данном поле можно указать строку локализации вида $Localization_String или ключ валидации вида #RoleNameIsNotUnique. Если поле оставить пустым, то выводится универсальное сообщение с указанием имени колонки с неуникальным значением.

  Note

  Ключ валидации - это ключ сообщения об ошибке или предупреждения. Он может задаваться в коде платформы, расширениях типового или проектного решений, где ключу валидации сопоставляются строки локализации. В расширении по данному ключу можно “отлавливать” такие ошибки и предупреждения и обрабатывать по необходимости: удалять, производить дополнительные проверки и прочее.

• Предупреждение вместо ошибки – установка данного флага позволяет вывести не ошибку, блокирующую сохранение карточки, а только информационное сообщение. Карточка при этом успешно сохраняется. Актуально, если не выставлен флаг Автоматически удалять строки-дубликаты.

• Автоматически удалять строки-дубликаты – вместо ошибок или предупреждений строка автоматически будет удаляться в момент закрытия строки коллекционной секции (или на сервере в момент сохранения). Не работает для строковых секций.

Контекстная справка в карточках

Для каждого контрола или формы (вкладки) карточки можно настроить отображение справочного сообщения, подсказки. Для этого в поле Справка нужно выбрать вид отображения справки и в поле Справка - значение указать значение для отображения справки.

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

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

Варианты отображения справки

• Без справки - справка не отображается.

• Всплывающая подсказка - при наведении на знак вопроса будет отображаться всплывающая подсказка.

  Note

  Выводимый текст зависит от настройки Всплывающая подсказка. Если подсказка есть, а справки нет, то вопрос отображается с текстом подсказки. Если и справка, и подсказка заданы, то в подсказке, всплывающей на кнопке со знаком вопроса, будет содержаться текст справки и текст всплывающей подсказки, разделённые пробелом.

• Открытие ссылки - ссылка открывается приложением по умолчанию для данного типа ссылок.

• Раздел справки - отображается диалог с карточкой типа Раздел справки. В качестве значения нужно указать уникальный код карточки раздела справки.