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

В данном разделе можно создавать, редактировать и просматривать типы карточек, типы карточек заданий и типы карточек файлов:

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

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

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

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

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

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

Note

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

Note

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

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

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

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

Импорт типов карточек выполняется с помощью кнопки на панели инструментов Импорт → Импортировать типы…:

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

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

Карточки

Импорт карточек выполняется с помощью кнопки на панели инструментов Импорт → Импортировать карточки…:

В открывшемся окне выбрать или библиотеку карточек *.jcardlib/*.cardlib, содержимое которой будет выведено в виде списка, или список отдельных файлов карточек *.jcard/*.card и библиотек:

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

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

Поле “Условие” поддерживает следующие значения (регистр не важен):

• Пусто - Импорт выполняется всегда.

• ms - Импорт выполняется для СУБД Microsoft SQL Server.

• pg - Импорт выполняется для СУБД PostgreSQL.

• Для других значений импорт пропускается.

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

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

Note

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

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

1. Явно указать опции для карточки в диалоге импортирования.

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

3. Создать файл с наименованием merge-options.json в поддиректории относительно местонахождения файла карточки, наименование поддиректории должно быть именем файла карточки без расширения (например, если имя файла карточки CardForImport.jcard, то файл merge-options.json должен находиться в поддиректории с наименованием CardForImport).

В двух первых случаях имена файлов опций слияния могут быть произвольными. В третьем случае файл опций слияния необходимо всегда называть 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. Т.е. в том случае, если параметры ExcludedColumns и IncludedColumns заполнены одновременно, то параметр IncludedColumns будет проигнорирован. Также в ValidationResult будет записно предупреждение об этом.

  • IgnoredColumns - string[], null. Игнорируемые колонки. Поведение такое же, как и у параметра ExcludedColumns (дополняют друг друга), но в дополнение к логике параметра ExcludedColumns, колонки, указанные в данном параметре, будут проигнорированы при обновлении секции.

  • 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, то файл опций слияния должен выглядеть следующим образом:

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

Important

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

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

Tip

Рассмотрим опции слияния для уникальных полей в секциях на примере конкретного типа карточек. В типе Правило доступа имеется несколько секций с уникальными полями, это секции: 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.

Экспорт карточек выполняется в Tessa Client: найти нужную карточку/представление с карточками и выполнить экспорт с помощью левого меню системы. При экспорте по умолчанию указано расширение .jcard, однако вручную можно указать другое расширение - .card.

Note

Формат карточек .card - это бинарный формат, который более эффективен для карточек с большим количеством файлов.

Important

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

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

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

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

Чтобы создать новый тип карточки воспользуйтесь пунктом контекстного меню “Создать тип карточки” или сочетанием клавиш [Ctrl]+[Shift]+[C].

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

Выделите созданную карточку:

Задайте нужные настройки.

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

Перейдите к выбору секций типа карточки:

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

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

Note

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

Important

Если для таблицы выбрано только поле ID, или выбраны не все поля, то остальные невыбранные поля данной таблицы либо должны иметь значения по умолчанию, либо поддерживать значение 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 – ссылка на значение столбца из текущей выбранной строки в мастер-представлении
Параметр представления	Имя параметра представления, на которое осуществляется маппинг
Набор параметров	Позволяет указать для дочернего представления, у которого мастер представление работает в режиме выделения столбца, к какому выбранному текущему столбцу в мастер представлении относится данный маппинг. По сути является именем столбца мастер представления или пустой строкой для дефолтного набора параметров. Дефолтный набор параметров применяется если отсутствует явно заданный набор параметров для выбранного в мастер представлении столбца
Поле карточки	Поле карточки. Доступно только, если выбран тип поля – “Поле карточки”
Не добавлять параметр для Null	Если флаг выставлен и в значении столбца будет Null, то параметр не будет создан. Если флаг не установлен, то в этом случае будет добавлен параметр с отбором по IsNull.

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

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

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

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

Настройки popup:

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

Important

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

Tip

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

Tip

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

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

Данный контрол предназначен для хранения файлов карточки.

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

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

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

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”. А если обе предыдущие настройки не указаны, то используется первый референс, у которого в списке секций есть секция, на которую ссылается комплексная колонка контрола.

Tip

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

Tip

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

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

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

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

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

Таблица

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

Для добавления таблицы на форму выберите тип “Таблица” и нажмите кнопку добавления элемента.

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

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

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

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

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

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

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

Название	Описание
Заголовок	Название поля, которое будет отображаться на форме
Алиас	Системное имя
Поля карточки	Нажмите, чтобы выбрать поля в таблице БД, значение которых требуется отображать в поле карточки.
Всплывающая подсказка	Текст всплывающей подсказки
Справка	Выбрать вид отображения справки
Справка - значение	Указать значение для отображения справки
Формат поля	Формат выводимого значения. Используются стандартные правила форматирования строк с применением специальных указателей для размещения колонок комплексной колонки. Например: “{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:

  

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

  • ID - идентификатор настройки завершения, формируется автоматически.

  • Name - уникальное название настройки завершения.

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

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

    Note

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

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

  

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

  

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

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

  

• Не удалять задание - признак того, что задание на надо удалять при нажатии на кнопку данной настройки завершения. Например, в задании согласования при выборе варианта “Запросить комментарии” отправляется новое задание на комментирование, однако текущее задание на согласование не завершается.

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

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

Тип диалога

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

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

Tip

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

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

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

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

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

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

Добавить расширение типа можно из контекстного меню, вызываемого кликом правой кнопки мыши на типе карточки, пункт “Добавить расширение”:

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

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

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

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

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

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

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

• Табличная секция является обычной секцией, никак не связанной с секцией, к которой принадлежит “Отслеживаемая колонка”. В этом случае при очистке “Отслеживаемой колонки” будут удалены все строки секции, которой принадлежат “Очищаемые колонки”.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• В блок добавить единственный контрол “Представление”.

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

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

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

В настройке расширения “Алиас параметра для передачи токена безопасности” необходимо указать параметр представления, в который будет передаваться токен безопасности. В представлении, которое будет использоваться для отображения истории заданий, должен быть определен параметр, использующий тип данных 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

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

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

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

Создание разделов справки

Управление разделами справки осуществляется в master-detail представлении Администратор → Справочники → Разделы справки.

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

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

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

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

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

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

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

• Код - уникальный код раздела справки. Этот код должен указываться в поле Справка - значение в настройках вкладки и элементов управления типа в TessaAdmin.
• Язык - один из языков локализации, поддерживаемых системой. Если язык не указан, то данный раздел справки будет отображаться для всех языков, для которых отсутствуют специфичные для языка разделы справки с таким же значением поля Код.
• Заголовок - текст заголовка раздела справки, который будет отображаться при открытии окна справки.
• Текст раздела - текст раздела справки.

Important

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

Important

Пара значений Код и Язык должны быть уникальны. Если карточка раздела справки для данных значений уже существует, система не даст сохранить карточку.

Important

При изменении значения поля Код у существующей карточки раздела справки, будут автоматически переименованы все карточки, содержащие это значение поля Код для всех языков. Важно помнить, что операция переименования может быть выполнена только тогда, когда в целевом (новом) коде справки отсутствуют все языки, присутствующие в исходном коде справки.
Например, есть разделы справки с кодом Ab и языками null, ru; Bc с языком null и Cd с языком en. Тогда переименовать Ab в Bc нельзя, т.к. в разделе Bc уже есть язык null, но можно в Cd или любой другой, отсутствующий раздел, т.к. конфликтов по языкам нет.

Note

Поля Заголовок и Текст раздела должны содержать текст на указанном в поле Язык языке.

Note

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