Попробуйте инновационную платформу для разработки и запуска бизнес-приложений Comindware Business Application Platform

Запросить демонстрацию

Добавление атрибутов

Содержание статьи:

 

Добавление атрибутов шаблона записи

Для настройки атрибутов шаблона записи необходимо: 

1. Перейти в раздел Атрибуты выбранного шаблона записи. Для этого кликните по иконке пользователя в правом верхнем углу, выберите «Глобальные настройки», перейдите в раздел Шаблоны , выберите нужный шаблон и перейдите в раздел  Атрибуты

Раздел "Атрибуты" выбранного шаблона записи

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

Новый шаблон записи по умолчанию содержит следующие системные атрибуты:

  • ИД (id) – автоматически заполняется уникальный идентификатор записи.
  • В архиве (_isDisabled) – флаг нахождения записи в архиве. По умолчанию при создании записи заполняется значение false.
  • Создан (_creator) – автоматически заполняется пользователь, создавший запись.
  • Дата создания (_creationDate) – автоматически заполняется дата и время создания записи.
  • Последний изменивший (_lastModifier) – автоматически заполняется пользователь, последний изменивший любые данные записи.
  • Последнее изменение (_lastWriteDate) – автоматически заполняется дата и время последнего изменения любых данных записи.

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

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

2. Для добавления нового атрибута необходимо нажать на кнопку «+Добавить». 

3. В открывшейся форме «Новый атрибут» присутствуют две вкладки «Основные настройки» и «Выражение». 

Создание нового атрибута - вкладка "Основные настройки"

Вкладка «Основные настройки» содержит настройки параметров атрибута. Вкладка «Выражение» становится доступна после того, как будет отмечен флаг «Вычисляемый». На вкладке «Выражение» вводится формула автоматического расчета для вычисляемого атрибута. Данные вычисляемого атрибута не сохраняются в базе данных.

 

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

Платформа поддерживает работу с атрибутами, имеющими следующие типы данных: 

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

Создание текстового атрибута

  • Число – атрибут содержит любые числовые значения. Для типа данных Число доступна следующая детализация:
    • Формат отображения (необязательное поле):
      • Целое – сохраненные данные в атрибуте отображаются в платформе в виде целого числа,
      • Десятичное – сохраненные данные в атрибуте отображается в виде числа с плавающей запятой,
      • Валюта – сохраненное число в атрибуте отображается в виде числа с разделителем разрядов и двумя знаками после запятой. 

Создание атрибута типа число

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

Создание атрибута типа длительность

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

Создание атрибута типа дата / время

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

Создание атрибута типа логический

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

Создание атрибута типа документ

  • Пользователь – атрибут содержит данные о выбранном пользователе Системы. Атрибут хранит идентификатор записи пользователя в качестве данных. Отображаемый атрибут настраивается в шаблоне записи, на который устанавливается ссылка. Для типа данных Пользователь доступна следующая детализация:
    • Целевой шаблон (необязательное поле): указывается один из шаблонов пользователей, которые созданы в системе. Необязательное поле. Если шаблон не указан, то атрибут будет ссылаться на системный справочник Пользователи (описано в документе «Руководство системного администратора»). При этом в качестве отображаемого значения в системном справочнике Пользователи используется поле (атрибут) Имя (fullName). 

Создание атрибута типа пользователь

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

Создание атрибута типа ссылка

  • Коллекция – атрибут позволяет хранить, отображать и управлять набором связанных записей, созданных в другом шаблоне. Атрибут хранит набор ссылок на связанную запись в другом шаблоне записи. Атрибут может быть пустым, содержать один или несколько элементов. Ссылки хранятся в виде уникальных идентификаторов записей. Отображаемые значения определяются настройкой связанного шаблона записи. Для типа данных Коллекция доступна следующая детализация:
    • Целевой шаблон (обязательное поле): указывается шаблон записи, с котором будет связан настраиваемый атрибут-коллекция.
    • Использовать существующую ссылку: флаг, позволяющий указать возможность выбора существующего атрибута ссылки или создать новый атрибут. Флаг доступен пользователю в том случае, если в выбранном целевом шаблоне уже существует хотя бы один созданный атрибут типа ссылка на текущий настраиваемый шаблон. Для примера, если необходимо на шаблоне записи Контрагенты добавить атрибут типа коллекция со ссылкой на шаблон записи Договоры для отображения перечня договоров, существующих с контрагентом, то флаг «Использовать существующую ссылку» будет доступен, если в шаблоне записи Договоры уже существует атрибут типа ссылка Контрагент, который будет ссылаться на текущий шаблон записи Договоры. Если атрибут создан не будет, то шаблон пользователю будет доступно лишь создание нового атрибута типа ссылка при создании атрибута-коллекции на шаблоне записи Контрагенты.
    • Имя для новой ссылки (обязательное поле): указывается наименование создаваемого атрибута-ссылки в целевом шаблоне. Доступно в случае, если флаг «Использовать существующую ссылку» отключен.
    • Системное имя коллекции (обязательное поле): указывается системное имя создаваемого атрибута-ссылки в целевом шаблоне. Доступно в случае, если флаг «Использовать существующую ссылку» отключен.
    • Существующая ссылка: выбирается среди атрибутов типа ссылка целевого шаблона, которые ссылаются на текущий настраиваемый шаблон записи. Это необходимо в случае, если в целевом шаблоне записи настроено несколько атрибутов ссылок на один шаблон записи. Например, для сущности Накладная необходимо указать несколько контрагентов: Плательщик, Грузополучатель, Грузоотправитель и т.д., которые являются одной или несколькими записями справочника Контрагенты.

Создание атрибута типа коллекция

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

  • Имя (обязательное поле) – указывается наименование атрибута.
  • Системное имя (обязательное поле) – указывается системное имя (синоним) атрибута для дальнейших ссылок в запросах и скриптах. Системное имя должно быть уникально в рамках настройки одного шаблона записи. Системное имя атрибута серриализуется в графовую модель данных на уровне базы данных и может использоваться для доступа к данным при написании запросов как внутри платформу, так и с помощью REST API.
  • Описание (необязательное поле) – заполняется дополнительное текстовое описание назначения атрибута в случае необходимости. Рекомендуется заполнять и планируется использовать для генерации автодокументации в платформе.

 

Флаги настройки атрибута

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

ОпцияДействие
Отображаемый атрибут Атрибут будет по умолчанию отображаться в ссылках на шаблон записи. Если в качестве отображаемого не выбран ни один атрибут, в качестве такового используется формат «#id записи». 
Уникальный Значение атрибута будет проверяться на уникальность в границах текущего шаблона записи при сохранении записи. 
Отслеживание изменений для атрибута  Все изменения значения атрибутов сохраняются в журнале истории изменений в платформе. Для просмотра истории изменений атрибута нужно нажать на кнопку настроек на форме и выбрать вкладку «История» в выпадающем списке. 
Вычисляемый Значение атрибута будет вычисляться на основании заданного выражения. Вычисляемый атрибут недоступен для изменения пользователем и не хранится в базе данных. Его значение вычисляется в момент отображения на интерфейсе пользователя. 
Удалять связанный объект Показывает действие, выполняемое при удалении ссылки на связанный объект. Если флаг указан, то объект будет удаляться. Если флаг не установлен, то при удалении ссылки будет рваться связь.

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

Тип данных атрибутаОтображаемый атрибутУникальныйОтслеживание изменений атрибутаУдалять связанный объектВычисляемый
Текст + + + - +
Число + + + - +
Длительность + - + - +
Дата / время + - + - +
Логический - - + - +
Документ - - + + -
Пользователь + - + - +
Ссылка - - + + +
Коллекция - - + + -
Вложения
У этой статьи нет вложений.
Обратная связь
Security Code
Статьи по теме
Урок 2. Мой первый реестр данных
Просмотрено 199 раз с Tue, Mar 3, 2020

Настройка SSO аутентификации
Просмотрено 39 раз с Mon, Aug 17, 2020

Сигнатура глобальной функции
Просмотрено 74 раз с Wed, Mar 11, 2020

Восстановление из резервной копии
Просмотрено 94 раз с Thu, Mar 5, 2020

Навигационная статья
Просмотрено 98 раз с Mon, May 18, 2020

Настройка диаграммы бизнес-способностей
Просмотрено 15 раз с Mon, Aug 31, 2020

Поиск последней даты изменения работы или подработы, относящейся к общему плану
Просмотрено 44 раз с Tue, May 19, 2020

Управление версиями схемы процесса
Просмотрено 64 раз с Thu, Mar 12, 2020

Финальная настройка процесса «Создание заявки на командировку» 
Просмотрено 22 раз с Mon, Aug 3, 2020

Выдача привилегий пользователям
Просмотрено 97 раз с Fri, Mar 6, 2020


Исследования осуществляются <br>ООО «Колловэар» при грантовой <br>поддержке Фонда «Сколково»
Comindware