Атрибуты

Атрибуты и их порядок, заданные для типа в Pilot-myAdmin, определяют поля карточки и порядок полей для элемента этого типа в клиентском приложении (кроме служебных атрибутов).

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

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

Для создания нового атрибута в Pilot-myAdmin откройте базу данных, перейдите на вкладку Типы, затем:

Выберите тип.
В правой части окна нажмите Создать.
Заполните поля Отображаемое имя и Имя. Подробнее см. Параметры атрибутов.
В раскрывающемся списке выберите тип атрибута. Подробнее см. Типы атрибутов.
Отметьте является ли атрибут объекта:

отображаемым в названиях объектов, данного типа;
обязательным для заполнения.

Отметьте, если атрибут является служебным.
Если необходимо, произведите дополнительные настройки:
- добавьте конфигурацию в поле Описание для атрибута типа Нумератор;
- выберите Группу состояний или перейдите к Управлению группами состояний для атрибута типа Состояние;
- добавьте конфигурацию в поле Дополнительные параметры для остальных типов атрибутов.

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

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

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

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

Параметры атрибутов

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

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

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

Дополнительные параметры атрибута

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

Произведите настройку в Pilot-myAdmin:

Откройте базу данных и перейдите на вкладку Типы.
Выберите тип. В списке атрибутов типа выберите атрибут.
Нажмите Редактировать на панели инструментов списка атрибутов или в контекстном меню.
В появившемся окне Редактирование атрибута :
- добавьте конфигурацию в поле Описание для атрибута типа Нумератор;
- добавьте конфигурацию в поле Дополнительные параметры для остальных типов атрибутов.

Настройка Дополнительных параметров недоступна для атрибута типа Состояние.

Пример

Поле карточки Заказчик элемента Проект в демонстрационной базе pilot-ice_ru определено необязательным атрибутом customer c именем Заказчик. Тип атрибута Справочник элементов. Атрибут виден в карточке элемента и в виде ссылки в правой части дерева элементов и не отображается в названиях. Уникальность не проверяется, редактирование доступно всем. В Дополнительных параметрах настроено подключение справочника Контрагенты.