Атрибуты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

*Локальные роли являются локальными по отношению к какому-либо типу. Например, Задача или Замечание. Это атрибуты типа Организационная единица, принадлежащие этому типу.

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

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

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

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

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

Пример

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