Типы атрибутов

Comindware Business Application Platform поддерживает работу с атрибутами, имеющими следующие типы данных: 

• Текст
• Число
• Длительность
• Дата / Время
• Логический
• Документ
• Пользователь
• Ссылка
• Коллекция

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

• Формат отображения (необязательное поле):
  • Обычный текст — сохраненные данные в атрибуте отображаются в платформе без форматирования;
  • Размеченный текст — сохраненные данные в атрибуте отображаются в виде текста с форматированием (содержит небольшой набор настроек для формирования структуры текста);
  • HTML текст — сохраненные данные в атрибуте отображаются в виде текста с форматированием (содержит широкий набор настроек для работы с текстом).

Число — атрибут содержит любые числовые значения. Для типа данных «Число» доступна следующая детализация:

• Формат отображения (необязательное поле):
  • Как есть — сохраненные данные в атрибуте отображаются в платформе как изначально прописаны;
  • 0 / 1 / 2 / 3 / 4 / 5 / 6 — сохраненные данные в атрибуте отображается в виде числа с одним из выбранных чисел, означающих количество знаков после запятой.
• Флаг «Группировать разряды чисел» — автоматически проставляется, позволяет отделять разряды чисел (при необходимости, флаг можно снять).

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

• Формат отображения (необязательное поле):
  • Дней, Часов, Минут, Секунд — сохраненные данные в атрибуте отображаются в платформе в следующем виде: «00д: 00ч: 00м: 00с»;
  • Дней, Часов, Минут (24-х часовой день) — сохраненные данные в атрибуте отображаются в платформе в следующем виде: «00д: 00ч: 00м», с учетом того, что день равен 24 часам;
  • Дней, Часов, Минут (8-ми часовой день) — сохраненные данные в атрибуте отображаются в платформе в следующем виде: «00д: 00ч: 00м», с учетом того, что день равен 8 часам (рабочий день);
  • Часов, Минут, Секунд — сохраненные данные в атрибуте отображаются в платформе в следующем виде: «00ч: 00м: 00с»;
  • Часов, Минут — сохраненные данные в атрибуте отображаются в платформе в следующем виде: «00ч: 00м»;
  • а также два формата отображения сохраненных данных в атрибуте без указания единиц времени: «00:00» и «00:00:00».

Дата / Время — атрибут содержит данные о дате и времени. Для типа данных «Дата / Время» доступна следующая детализация:

• Формат отображения (необязательное поле): указывается один из форматов отображения сохраненных данных в платформе. Форматы отображения изображены в виде примеров отображаемых дат. 

Логический — атрибут-флаг содержит значения «true» или «false». 

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

• Формат отображения (необязательное поле):
  • Вложение — сохраненные данные в атрибуте отображаются на форме в виде прикрепленного документа;
  • Встроенный — сохраненные данные в атрибуте отображаются в виде прикрепленного документа и текста в документе (пока доступен только формат .txt).
• Фильтр расширений файлов (необязательное поле) — ограничивает перечень расширений, которые возможно будет сохранить в атрибуте. Если не выбрано ни одного расширения, то к атрибуту можно будет прикладывать файлы любого расширения.
• Флаг «Несколько значений» — автоматически проставляется, позволяет прикреплять несколько документов (при необходимости, флаг можно снять).

Пользователь — атрибут содержит данные о выбранном пользователе Системы. Атрибут хранит идентификатор записи пользователя в качестве данных. Для типа данных «Пользователь» доступна следующая детализация:

• Целевой шаблон (необязательное поле) — указывается один из шаблонов пользователей, которые созданы в системе. Если шаблон не указан, то атрибут будет ссылаться на системный справочник Пользователи. При этом в качестве отображаемого значения используется атрибут Имя (fullName). 
• Флаг «Несколько значений» — автоматически проставляется, позволяет выбирать несколько пользователей (при необходимости, флаг можно снять).

Ссылка — атрибут позволяет хранить ссылку на запись в другом шаблоне записи. Атрибут всегда содержит в качестве сохраняемого значения идентификатор записи (значение атрибута id), на которую он ссылается. Отображаемое значение настраивается в шаблоне записи, на которую устанавливается ссылка. Для типа данных «Ссылка»  доступна следующая детализация:

• Формат отображения  (необязательное поле):
  • Показывать как ссылка — данные отображаются в виде гиперссылки с возможностью перейти на экранную форму выбранной записи;
  • Показывать как текст — данные отображаются в виде текстовой строки в выпадающем списке и не позволяют перейти на связанную запись.
• Целевой шаблон (обязательное поле) — указывается шаблон записи, с которым будет связан настраиваемый атрибут с типом данных «Ссылка»;
• Флаг «Сделать связь взаимной» — позволяет создать атрибут с типом данных «Коллекция» в выбранном целевом шаблоне. Это может понадобиться в том случае, если в записи целевого шаблона необходимо будет отображать набор связанных с записью элементов текущего настраиваемого шаблона записи; 
  • Имя коллекции (обязательно в случае, если выбран флаг «Сделать связь взаимной») — наименование создаваемого атрибута с типом данных «Коллекция» в целевом шаблоне;
  • Системное имя коллекции (обязательно в случае, если выбран флаг «Сделать связь взаимной») — уникальное текстовое имя создаваемого атрибута с типом данных «Коллекция» в целевом шаблоне. Может содержать только буквы латинского алфавита, цифры и знак «_». Заполняется автоматически.

Коллекция — атрибут позволяет хранить, отображать и управлять набором связанных записей, созданных в другом шаблоне записи. Атрибут хранит набор ссылок на связанную запись в другом шаблоне записи. Атрибут может быть пустым, содержать один или несколько элементов. Ссылки хранятся в виде уникальных идентификаторов записей (значение атрибута id). Отображаемые значения определяются настройкой связанного шаблона записи. Для типа данных «Коллекция» доступна следующая детализация:

• Целевой шаблон (обязательное поле) — указывается шаблон записи, с котором будет связан настраиваемый атрибут с типом данных «Коллекция»;
• Флаг «Использовать существующую ссылку» — позволяет использовать уже существующий атрибут с типом данных «Ссылка» в указанном целевом шаблоне. Флаг доступен пользователю в том случае, если в выбранном целевом шаблоне существует хотя бы один созданный атрибут с типом данных «Ссылка» на текущий настраиваемый шаблон;
  • Существующая ссылка — выбирается среди атрибутов с типом данных «Ссылка» целевого шаблона, которые ссылаются на текущий настраиваемый шаблон записи;
• Имя для новой ссылки (обязательное поле) — наименование создаваемого атрибута с типом данных «Ссылка» в целевом шаблоне. Доступно в случае, если флаг «Использовать существующую ссылку» не доступен;
• Системное имя для новой ссылки (обязательное поле) — уникальное текстовое имя создаваемого атрибута с типом данных «Ссылка» в целевом шаблоне. Может содержать только буквы латинского алфавита, цифры и знак «_». Заполняется автоматически. Доступно в случае, если флаг «Использовать существующую ссылку» не доступен.

См. также: Добавление атрибутов, Флаги настройки атрибутов.