Атрибут типа "Агрегирующий атрибут"

Описание атрибута

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

Агрегирующий атрибут объединяет в себе два атрибута типа "Ссылка на бизнес–объект":

  • Атрибут-ссылка на объект класса "Сотрудник" (employee) и атрибут-ссылка на объект класса "Отдел" (ou).

    Значением атрибута будет являться комбинация ФИО сотрудника и название отдела сотрудника: "Сотрудник"/"Отдел".

  • Атрибут-ссылка на объект класса "Сотрудник" (employee) и атрибут-ссылка на объект класса "Команда" (team).

    Значением атрибута будет являться комбинация ФИО сотрудника и название его команды: "Сотрудник"/"Команда".

Название каждого объекта в значении атрибута является ссылкой на его карточку (сотрудника, отдела или команды). Подробнее в разделе Атрибут типа "Ссылка на бизнес–объект".

Агрегирующий и агрегируемые атрибуты

При добавлении атрибута в системе создается сам агрегирующий атрибут и набор агрегируемых атрибутов, в том же классе/типе, где создан агрегирующий атрибут:

  • агрегируемый атрибут типа "Ссылка на бизнес-объект" класса "Сотрудник" (employee) (создается всегда).
  • агрегируемый атрибут типа "Ссылка на бизнес-объект" класса "Отдел" (ou).
  • агрегируемый атрибут типа "Ссылка на бизнес-объект" класса "Команда" (team).

Особенности агрегируемых атрибутов:

  • Название агрегируемого атрибута формируется по правилу: "Название агрегирующего атрибута (Класс объединяемого атрибута)".
  • Код агрегируемого атрибута формируется по правилу: "Код агрегирующего атрибута _em(сотрудник)/ou(отдел)/te(команда)/".
  • Набор агрегируемых атрибутов при редактировании агрегирующего атрибута не изменяется.
  • Агрегируемые атрибуты нередактирумые, необязательные и неуникальные.
  • Редактирование значений агрегируемых атрибутов в скриптах (например, при создании/редактировании объекта методами API) необходимо выполнять только через обращение к самому агрегирующему атрибуту, см. Редактирование значения агрегирующего атрибута.
  • При удалении пользовательского агрегирующего атрибута, вместе с ним удаляются агрегируемые им атрибуты.

Настройки атрибута

Параметры атрибута заполняются при добавлении и редактировании атрибута.

Добавление атрибута в классе или типе объектов приводит к повышенной нагрузке системы и занимает продолжительное время. Добавление атрибута рекомендуется выполнять во время минимальной нагрузки на систему или во время технологических блокировок.

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

  • Название

    Название атрибута на карточках объектов и формах, на которых размещен данный атрибут.

  • Скрывать название атрибута

    • флажок снят — название атрибута отображается в интерфейсе.

    • флажок установлен:

      В интерфейсе оператора:

      • В контентах "Параметры объекта", "Параметры связанного объекта", блок Подробнее в "Комментарии" отображается:

        • значение атрибута (если оно заполнено);
        • пользовательская кнопка (если она настроена для атрибута).

        Если значение атрибута не заполнено, то атрибут не отображается и пустого места под атрибут не остается.

      • В контенте "Параметры на форме" и других формах отображается только поле ввода значения. Если атрибут обязательный, то вместо заголовка отображается звездочка обязательности.

      • В контентах со списками, включая контент "Иерархическое дерево", название атрибута не отображается в названии колонки списка.

        Название атрибута отображается на форме настройки полей сложного списка и формах настройки фильтрации и сортировки списка.

      • На форме расширенного поиска (если атрибут выведен на нее) название отображается.

      В интерфейсе администратора название отображается серым цветом в контентах на вкладке "Карточка объекта", "Форма добавления", "Форма редактирования" и на форме просмотра настроек атрибута

  • Код

    Идентификатор атрибута в системе.

    Код должен быть уникален в рамках типа объектов, без учета регистра. Код может содержать от 1 до 14 символов, должен состоять только из символов латинского алфавита и цифр, начинаться с символа.

  • Определяемый по таблице соответствий

    • Флажок снят — значение атрибута редактируется в интерфейсе оператора.

    • Флажок установлен — значение атрибута автоматически вычисляется по таблице соответствий и не редактируется в интерфейсе оператора.

      Значение атрибута вычисляется при добавлении объекта. Для существующих объектов значение атрибута переопределяется при изменении хотя бы одного из определяющих атрибутов.

      • Правило определения

        Таблица соответствий, по которой вычисляется значение атрибута.

        При добавлении атрибута в поле установлено значение [не указано].

        При редактировании атрибута в поле выбирается таблица соответствий. Для выбора доступны таблицы соответствий, у которых данный атрибут указан как определяемый. Подробнее в разделе Справочник "Таблицы соответствий".

  • Редактируемый

    • Флажок снят — значение атрибута не редактируется в интерфейсе оператора.
    • Флажок установлен — значение атрибута можно изменять на формах добавления и редактирования объекта в интерфейсе оператора.

    Редактируемость атрибута не влияет на выполнение специальных действий, например, "Смена ответственного", "Смена типа".

    Для системных атрибутов значение параметра "Редактируемый" можно изменить, только если системное значение параметра "Редактируемый" = "Да".

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

  • Редактируемый в списках

    Доступен, если установлен флажок "Редактируемый".

    • Флажок снят (по умолчанию) — значение атрибута в списке объектов не изменяется.

    • Флажок установлен — значение атрибута можно изменять в списке объектов в интерфейсе оператора. При редактировании значения атрибута в ячейке списка будет использоваться представление для редактирования, указанное в параметре "Представление для редактирования".

      Описание см. Редактирование атрибута в списке объектов

  • Обязательный

    Обязательность системного атрибута можно изменить, если установлен флажок "Редактируемый" и системное значение параметра "Обязательный" = "нет". Пользовательские атрибуты по умолчанию являются необязательными.

    • Флажок снят — значение не обязательно для заполнения.

    • Флажок установлен — значение атрибута является обязательным для заполнения в системе.

      Проверка заполнения значения атрибута выполняется при редактировании или добавлении объекта скриптом и при восстановлении объекта из архива.

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

      Если обязательность атрибута устанавливается при наличии в базе данных ранее созданных не архивных объектов с незаполненным обязательным атрибутом, то при попытке сохранить изменение выводится сообщение о подтверждении действия. Если действие подтверждено, то проверка на заполнение значения атрибута будет выполняться: при добавлении новых объектов и при изменении ранее созданных объектов с незаполненным значением обязательного атрибута

    Формы, на которых выполняется проверка заполнения атрибута:

  • Обязательный для заполнения в интерфейсе

    Если флажок "Обязательный" установлен, то флажок "Обязательный для заполнения в интерфейсе" снят и недоступен для изменения.

    • Флажок установлен —значение атрибута является обязательным для заполнения на формах добавления и редактирования в интерфейсе оператора, если атрибут выведен на формы.
    • Флажок снят — значение не обязательно для заполнения.

    При переводе объекта в архив и любых действиях с архивными объектами заполнение значения атрибута не проверяется

    Формы, на которых выполняется проверка заполнения атрибута:

  • Уникальный

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

  • Агрегировать классы

    Классы объектов, которые объединяет атрибут.

    Возможные значения параметра:

    • "Сотрудник" и "Отдел" — сотрудник будет выбираться в рамках отдела, из дерева "отделы-сотрудники".
    • "Сотрудник" и "Команда" — сотрудник будет выбираться в рамках команды, из дерева "команды-сотрудники".

    • "Сотрудник", "Отдел", "Команда" — сотрудник будет выбираться как в рамках отдела, так и в рамках команды.

      В дереве для выбора значения агрегирующего атрибута учитываются ограничения по типам, установленные для агрегируемых атрибутов. Сотрудники недопустимого типа не доступны для выбора и отображаются серым цветом. Отдел или команда недопустимого типа не доступны для выбора, все вложенные в него сотрудники также не доступны для выбора, вне зависимости от их типов.

      При редактировании агрегирующего атрибута набор объединяемых атрибутов не изменяется

  • Фильтрация значений при редактировании

    • Флажок снят — ограничения возможных значений атрибута нет.

    • Флажок установлен — при редактировании атрибута в интерфейсе оператора список возможных значений визуально ограничен:

      • в поле выбора в виде раскрывающегося списка отображаются только допустимые объекты;
      • в поле выбора в виде дерева отображаются допустимые объекты и их вышестоящие по иерархии элементы: папки справочников, каталоги и родительские объекты, для выбора доступны только допустимые объекты.

      Условия фильтрации списка значений атрибута задаются в скрипте.

      Проверка выполнения условий фильтрации производится в момент редактирования атрибута. При заполнении атрибута его значением могут быть выбраны только те объекты, для которых выполнилось условие.

      Список доступных значений для агрегирующего атрибута может включать в себя следующие варианты:

      • сотрудник — доступен для выбора в рамках своего отдела и всех команд, в которых он является участником;
      • команда;
      • отдел;
      • команда и список сотрудников-участников команды;
      • отдел и список сотрудников отдела.

  • Вычисление значения при редактировании

    Параметр отображается, если установлен флажок "Редактируемый" и сняты флажки "Вычислимый", "Определяемый по таблице соответствий".

  • Представление для отображения

    Указывает, как выглядит атрибут в интерфейсе оператора.

    • "Ссылка на бизнес-объект" — отображается как "Сотрудник"/"Отдел" или "Сотрудник"/"Команда". Название объекта является ссылкой на карточку объекта

  • Скрывать при отображении, если не заполнен

    Отображается, если снят флажок "Обязательный".

    • Флажок снят — атрибут всегда отображается на карточке объекта.
    • Флажок установлен — если значение атрибута не указано, то атрибут не отображается в контентах "Параметры объекта", "Параметры связанного объекта", "Информация о пользователе".

    Значение параметра не влияет на отображение атрибута на формах добавления и редактирования

  • Представление для редактирования

    Вид поля выбора значения атрибута на формах добавления и редактирования объекта и вид поля значения атрибута по умолчанию на текущей форме.

    Представление для редактирования не влияет на вид поля для редактирования атрибутов в списке объектов, поле для редактирования в списке всегда имеет вид "поле ввода".

  • Скрывать при редактировании, если нет значений для выбора

    Отображается, если установлен флажок "Редактируемый". Параметр не отображается для системного атрибута "Контрагент" (client).

    • Флажок снят — атрибут всегда отображается на форме добавления объекта и формах редактирования.

    • Флажок установлен — если у атрибута нет доступных для выбора значений, то данный атрибут (его название и поле выбора значений) не отображается:

      • на форме добавления и форме редактирования объекта (в контентах "Параметры на форме", "Выбор родительского объекта"),
      • на форме смены статуса;
      • на форме смены привязки;
      • на форме смены типа объекта.

      Значение атрибута на форме считается неуказанным (пустым).

  • Описание

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

    Для ввода описания используется поле ввода "Текст в формате RTF".

    Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке контента, в котором отображается атрибут (параметр "Показывать описание атрибутов).

    Отображение описания атрибута в интерфейсе оператора (всплывающая подсказка или информационное поле в контенте) настраивается при настройке пользовательских форм:

    Описание атрибута может применяться в качестве контекстной справки по каждому атрибуту.

    Если значение параметра не указано, то описание атрибута в интерфейсе оператора не отображается.

    Пример. При реализации процесса проведения опросов, в атрибутах класса "Анкета" (questionary) описание атрибутов служит для расширенной формулировки вопросов.

  • Значение по умолчанию

    Используется для быстрого заполнения значений атрибутов при добавлении объекта в систему. В качестве значения по умолчанию рекомендуется выбирать наиболее вероятное значение атрибута.

    Значение по умолчанию не устанавливается для системно нередактируемых атрибутов и для атрибута "Ответственный" (responsible).

    Виды значения по умолчанию: фиксированное или вычислимое.

    Флажок "Вычислимое" (значение по умолчанию)

    Флажок "Вычислимое" (значение по умолчанию) отображается, если снят флажок "Вычислимый" (для атрибута)

    • Флажок снят — фиксированное значение по умолчанию:

      • указывается в поле "Значение", вид поля соответствует выбранному для атрибута представлению для редактирования;
      • отображается в списке атрибутов (столбец "По умолчанию") в выбранном для атрибута представлении для отображения;
      • отображается в контентах на карточке объекта или формах добавления и редактирования объекта (для пользовательских атрибутов).

    • Флажок установлен — вычислимое значение по умолчанию

    Правила использования значения по умолчанию:

    • Если атрибут размещен на форме добавления объекта, то при открытии формы добавления значение атрибута будет заполнено значением по умолчанию. Пользователь может изменить значение по умолчанию вручную.
    • Если атрибут отсутствует на форме добавления объекта, то при добавлении объекта значение атрибута автоматически заполняется значением по умолчанию.
    • Если атрибут скрыт с формы добавления объекта, так как набор допустимых значений данного атрибута пуст, то при добавлении объекта значение по умолчанию не устанавливается.

    • Если на форме добавления объекта изменяется тип объекта, то значение атрибута заменяется на значение по умолчанию, при выполнении следующих условий:

      • для атрибута в выбранном типе указано значение по умолчанию;
      • до этого момента пользователь не изменял значение по умолчанию вручную на форме добавления.
    • Если параметр "Значение по умолчанию" устанавливается для существующего атрибута, то значение данного атрибута у существующих объектов не меняется.
    • Если параметр "Значение по умолчанию" устанавливается для нового атрибута, то во всех ранее созданных объектах значение атрибута остается пустым.

    Особенность установки значения по умолчанию при применении скрипта фильтрации: если в результате выполнения скрипта фильтрации значение по умолчание не содержится в отфильтрованном списке, то значение по умолчанию не устанавливается и поле атрибута остается не заполненным

  • Расширенное редактирование связей

    Возможные значения:

    • "Выключено" (по умолчанию) — для выбора значения атрибута используется поле выбора, определенное в параметре "Представление для редактирования".

      Форма добавления связи и форма редактирования связи не используются, кнопка Добавить /Удалить связи на панели действий списка связанных объектов не активна.

    • "Плоский список" — для выбора значения атрибута может использоваться форма добавления связи, на которой размещен список объектов.

      На форме возможен поиск объектов класса "Сотрудник" (employee) и/или "Отдел" (ou), "Команда" (team). Поиск проводится по атрибутам для быстрого поиска объектов.

      Отображение объектов в списке на форме добавления связи зависит от:

      • ограничений по типам в агрегируемых атрибутах — в списках отображаются те объекты, которые удовлетворяют ограничениям по типам в соответствующих агрегируемых атрибутах;
      • настройки фильтрации значений при редактировании в агрегирующем атрибуте;
      • прав текущего пользователя: группа прав на изменение ответственного и группа прав на добавление объекта в классе (для атрибута "Ответственный" (responsible));
      • настройки передачи ответственности (для атрибута "Ответственный" (responsible)).

      Дополнительные поля:

      • Группа атрибутов в списке

        Группа атрибутов, которая определяет набор колонок в списке объектов на форме добавления связи.

        Группа выбирается для каждого класса агрегируемого объекта отдельно.

        Поля не обязательны для заполнения. Если группа не указана, то соответствующий список объектов на форме добавления связи не отображается.

      • Редактирование только через расширенную форму

        • Флажок снят (по умолчанию) — для выбора значения атрибута используется поле выбора, определенное в параметре "Представление для редактирования", или форма добавления связи.

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

  • Метки

    Одна или несколько меток, определяющих процессы, в которых используется данный атрибут. Метка устанавливается для пользовательских атрибутов основных классов и типов объектов. Подробное в разделе Метки.

Системные агрегирующие атрибуты

Системные агрегирующие атрибуты: