Атрибуты

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

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

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

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

  1. Выберите тип.
  2. В правой части окна нажмите Создать.
  3. Заполните поля Отображаемое имя и Имя. Подробнее см. Параметры атрибутов.
  4. В раскрывающемся списке выберите тип атрибута. Подробнее см. Типы атрибутов.
  5. Отметьте является ли атрибут объекта:
  6. Отметьте, если атрибут является служебным.
  7. Если необходимо, произведите дополнительные настройки:

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

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

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

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

Тип атрибута Описание типа атрибута Дополнительные параметры
Строка

Тип содержит значения в виде произвольных последовательностей символов.

Настройка дополнительных параметров позволяет:

Дата и время Тип содержит значения даты, времени или даты и времени.

Настройка дополнительных параметров позволяет:

Целое число

Позволяет вводить в карточке элемента целые числа.

 

Вещественное число.

Позволяет вводить в карточке элемента вещественные числа в формате десятичной дроби.

 
Десятичный (денежная единица)

Позволяет вводить в карточке элемента его стоимость и настраивать формат денежных единиц.

Описание формата денежных единиц
Нумератор

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

Нет поля Дополнительные параметры, настройка осуществляется в поле Описание. Подробнее:

Настройка автоматической нумерации

Состояние

Атрибуты этого типа используются для:

 

Нет поля Дополнительные параметры, настройка осуществляется через Управление группами состояний.
Организационная единица Позволяет выбрать элемент Организационной структуры: пользователей, подразделения и группы для заполнения им поля карточки. Дополнительные параметры атрибута Организационная единица
Справочник элементов Позволяет настроить добавление на элемент и на задание ссылок для перехода к вложениям и к связанным файлам.

Подробнее:

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

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

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

Параметр Описание параметра Значения Описание значения
Отображаемое имя

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

Обязательный параметр.

Строка Значение может не быть уникальным. Могут быть использованы любые символы.
Имя

Имя атрибута используется для скриптов автоматизации, модулей расширения и т.д.

Обязательный параметр.

Строка

Уникальное значение может содержать только латинские буквы, цифры и знак "_"

Число строк в карточке

Количество строк в поле карточки.

Только для атрибута типа Строка.

Целое число Высота поля в карточке элемента соответствует указанному количеству строк.
Свойства

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

Отображать атрибут в названиях

Значение атрибута будет выведено в Обозреватель элементов рядом с названием элемента.

Обязательный для заполнения

Для создания элемента необходимо обязательно заполнить поле, определённое таким атрибутом.

Группировать с предыдущим

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

Служебный Служебный атрибут не отображается в поиске и умных папках. Доступ к служебным атрибутам осуществляется через специальный функционал клиента или с помощью расширений.
Уникальность   Не проверять Уникальность создаваемого элемента не будет проверяться.
Показывать предупреждение При попытке создания элемента-дубликата появится окно Проверка повторной регистрации с возможностями: Перейти к найденному элементу, Продолжить создание или Отмена.
Запрещать создание дубликатов При попытке создания элемента-дубликата появится окно Проверка повторной регистрации с единственной возможностями Перейти к найденному элементу или Отмена.
Редактирование доступно...   Всем Редактировать поле может любой пользователь.
Выбор пользователей или организаций из Организационной структуры Редактировать поле могут только выбранные пользователи.
Дополнительные параметры Позволяют расширить поведение элементов с такими атрибутами в клиентском приложении. Описание конфигурации

Подробнее в разделе

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

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

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

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

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

Пример

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