Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Вид карточки типа элемента, определяет то, как будет отображаться детальная информация об элементе данного типа, а также связанных с ним объектах. С помощью настройки видов типов элементов (ТЭ), можно определять какие атрибуты элемента и в каком порядке будут отображаться в карточке элемента, создавать новые вкладки определять их видимость для разных групп пользователей, выводить информацию об элементах связанных с текущим и определять перечень возможных для них действий. 

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

Примеры разных видов типов элементов:

  1. Карточка ТЭ "Замечание"
    Image Removed
  2. Карточка ТЭ "Задача план-графика"
    Image Removed
  3. Карточка ТЭ "Вызов внешнего сервиса"
    Image Removed

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

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

Image Removed

Открыв двойным кликом список, нажмите на кнопку Создать и выберите Вид карточки типа элемента.

Image Removed

В появившемся окне задайте название для создаваемого вида. 

Image Removed

Настройка представления карточки типа элемента

Настройки вида карточки типа элемента представляют из себя JSON - текст в формате ключ: значение. 

...

Ключ

Описание

Значение

Пример

name

Название вкладки

Текст или формула

"Файлы" - в качестве названия вкладки будет использован заданный текст

"This(\"contenttype.name\")" – в качестве названия вкладки будет использовано название типа текущего элемента. 

permission

Права, которые должны быть у пользователя на элемент для отображения вкладки

Атрибут code элемента списка Права

permission.manage - вкладка будет показана только тем пользователям, у которых есть право "Управление версиями" для текущего элемента. 

Полный список прав и их коды можно посмотреть в списке Права: Центр администрирования → Настройки → Списки → Права

isVisible

Видимость вкладки

true/false или формула

"IsNotNull(Parent(\"8ec1df0c-cb97-4bea-9831-7e11c916a765\"))" – формула для вкладки Привязки на списке ТЭ, вернет true для ТЭ, которые являются дочерними от ТЭ Процесс.

Формула должна возвращать true или false

isAdmin

Должна ли вкладка быть видна только администратору

true/false (значение по умолчанию – false)

true - вкладка будет видна только пользователям с правами администратора.

isEnabled

Доступна ли вкладка для редактирования

true/false или формула

!This(\"task_status.resolved\") – вернет true, если задача не завершена, используется на вкладке Файлы ТЭ Задача на согласование

list

Список Компонентов представлений, отображаемых на вкладке (таблица view_part)

Список вида

[

  {

    "id": …,

    "settings":{}

  }

]
 
 id – guid элемента списка Компоненты представлений

settings – объект с настройками

[

      {

          "id": "a29a30ca-2bf6-46ed-bea8-189b11891818",

          "settings": {

               "visibleFieldList": [

                    "name",

                    "document_status"

               ]

           }

      }

]

Более подробно см. описание компонентов представлений. 

Компоненты представлений.

FieldIterator - компонент, отвечающий за вывод атрибутов текущего элемента. 
Item - компонент, позволяющий отобразить карточку элемента, связанного с текущим.

...

ParentItem - компонент выбора родительского элемента. 

FieldIterator

Описание: Вывод атрибутов текущего элемента. 

...

Настройка

Описание

Значение

Пример

visibleFieldList

Список видимых атрибутов. Атрибуты, не указанные в списке, отображаться не будут.

Атрибуты отобразятся в том порядке, в котором они указаны в visibleFieldList.

Если настройка не задана, отобразятся все атрибуты ТЭ.


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

у типа элемента 20 атрибутов, а необходимо вывести только 2 из них. Эти 2 атрибута указываем в visibleFieldList -> будут показаны только заданные два атрибута.

Массив Системных имен (internal_name) атрибутов ТЭ

["item_id", "workflow_status", "name", "start_date_plan", "start_date_fact", "initiator"]

hiddenFieldList

Список скрытых атрибутов.

Атрибут, указанный и в visibleFieldList и в hiddenFieldList, отображаться не будет.


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

у типа элемента 20 атрибутов, необходимо вывести все, кроме 2 из них. Эти 2 атрибута указываем в hiddenFieldList, и не задаем visibleFieldList ->  будут показаны все атрибуты кроме указанных двух.

Массив Системных имен (internal_name) атрибутов ТЭ

["id", "project_scope","stamp_profile"]

rowFieldList

Список атрибутов, которые должны отобразиться в 1 строку.

Указанные атрибуты должны идти друг за другом в visibleFieldList (или привязаны в таком порядке к типу элемента, если visibleFieldList не задан). Указанные таким образом атрибуты будут размещены в строках попарно. 

Массив Системных имен (internal_name) атрибутов ТЭ

["item_id", "workflow_status", "start_date_plan", "start_date_fact", "initiator"]

maxVisibleCount

Количество видимых атрибутов, остальные свернутся в кнопку «Развернуть».

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

Число

4

groupList

Список групп атрибутов, которые отображаются/скрываются в зависимости от заданного условия (формулы)

Массив объектов вида

{

  "label": string -заголовок группы;

  "fieldList": [string] - массив Системных имен (internal_name) атрибутов ТЭ, входящих в группу;

  "isVisible": string | boolean – true/false или формула;

  "field": string – системное имя (internal_name)  атрибута, после которого отобразится группа;

}


[

  {

    "fieldList": [

      "time_range"

    ],

  "isVisible": "Id(This(\"Диапазон времени\")) ==   Id(Lookup(\"Типы диапазона   времени.Динамический\"))",

  "field": "time_range_type"

  },

  {

    "fieldList": [

      "time_range_start", "time_range_end",  "time_range_step"

    ],

    "isVisible": "Id(This(\"Диапазон времени\")) ==    Id(Lookup(\"Типы диапазона времени.Статический\"))",

    "field": "time_range_type"

  }

]

Item

Описание: Карточка элемента, связанного с текущим по указанному атрибуту. Если элемент не существует, отображается пустая карточка, после заполнения которой элемент будет создан.

...

Настройка

Описание

Значение

Пример

listId


id списка, в котором находится элемент

guid

"7747d7a8-6627-4203-a638-dd6eb1c65e3f"

contentTypeId

id типа элемента

guid

"59f35090-02d0-47da-83b6-f0dd2b1ed880"

viewId

id Вида карточки типа элемента

guid

"bf805e2a-afd9-46ea-9f03-d64e59c7da6a"

linkField

Лукап атрибут, в который подставится id текущего элемента

Системное имя (internal_name)  атрибута типа Lookup

"content_type"

ListView

Описание: Вид списка с возможностью добавления элементов (кнопка «Добавить»). Этим компонентом отображаются все табличные в детальном – на вкладке Связи, Файлы, Атрибуты и т.д.

...

Кода операторов (operator):

И — 0

ИЛИ — 1

DetailAction

Описание: Плашки уведомлений с кнопками действий

...

Название

Внешний вид

vitro-primary

vitro-outline-primary

vitro-outline-light

vitro-light

LookupPicker

Описание: Контрол выбора элемента из списка

...

Настройка

Описание

Значение

Пример

placeholder

Текст-подсказка, который отображается, когда значение не выбрано

Строка

"Выберите статус"

onChangeAction

Действие, которое выполнится после изменения значения

код действия

"workflow.task.reference.set.approval.status"

isEnabled

Доступен ли лукап на редактирование

true/false или формула

"!This(\"task_status.resolved\")"

component

Компонент, которым отображаются значения

Строка

"Icon"

list

id списка, из которого достаются значения

guid

"bb6d31b7-7ffa-485b-a90c-483c43b0cc81"

filterQuery

Формула фильтрации доступных для выбора значений

Формула

"Merge(Lookup(\"Статусы согласования.Согласовано\"), Lookup(\"Статусы согласования.Согласовано с замечаниями\"), Lookup(\"Статусы согласования.Отклонено\"))"

disabledFilterQuery

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

Формула

"if(All(GetList(\"02b4fda6-01b9-4ddb-a7cd-7a56fa415f11\", Format(\"i => new Guid[] {{ Guid(\\\"{0}\\\") }}.Contains(i.GetValueAsGuid(\\\"destination\\\")) && i.ContentTypeId == \\\"4bc42916-9e3c-4c96-a25d-8a1b9b4bbc35\\\"\", Join(\"\\\"), Guid(\\\"\", Select(Refs(\"Связь задачи на согласование\"), \"Id()\")))), \"This(\\\"source.Статус задачи.Название\\\")\", \"Закрыто\", \"Аннулировано\"), Merge(Lookup(\"Статусы согласования.Согласовано с замечаниями\"), Lookup(\"Статусы согласования.Отклонено\")), Merge(Lookup(\"Статусы согласования.Согласовано\")))"

internalName

Атрибут, в который подставится выбранное значение и передастся в обработчик действия

Системное имя (internal_name)  атрибута типа Lookup

"approval_status"

value

Формула, которая должна вернуть текущее выбранное значение (элемент) при повторном открытии карточки элемента. 

Формула

"if((This(\"package_approval_mode\") == \"true\") && !Any(GetList(\"02b4fda6-01b9-4ddb-a7cd-7a56fa415f11\", Format(\"i => i.ContentTypeId == Guid(\\\"70a8952c-539f-49a5-aa4b-31ff67d1663f\\\") && i.GetValueAsGuid(\\\"source\\\") == \\\"{0}\\\"\", Id()), false), \"This(\\\"Статус согласования.Название\\\")\", \"На рассмотрении\"), Select(GetList(\"02b4fda6-01b9-4ddb-a7cd-7a56fa415f11\", Format(\"i => i.ContentTypeId == Guid(\\\"70a8952c-539f-49a5-aa4b-31ff67d1663f\\\") && i.GetValueAsGuid(\\\"source\\\") == \\\"{0}\\\"\", Id()), false), \"Field(\\\"Статус согласования\\\")\"), \"\")"

displayFieldList

Отображаемые атрибуты

Массив Системных имен (internal_name) атрибутов

["name", "code "]

isMulti

Множественный выбор значений. По умолчанию false

true/false

true

filterMinLength

Минимальное количество символов для поиска

Число

0

WorkflowInitFileList

Описание: Таблица с файлами в окне запуска процесса.

...

Настройка

Описание

Значение

Пример

viewId

id Вида списка

guid

"7ad4be07-c646-428e-9cda-eaf365678f55"

isAddListSelectEnabled

Доступен ли выбор списка при добавлении элемента

true/false. По умолчанию true

false

isAddSiteSelectEnabled

Доступен ли выбор пространства при добавлении элемента

true/false. По умолчанию true

false

isGroupByParent

Группировать ли элементы в табличном по родителю (parent_id)

true/false. По умолчанию true

false

Activity 

Описание: компонент вкладки «Активность»

...

Пример отображения:

Настройки: нет

Version

Описание: список версий файла

...

Пример отображения:

Настройки: нет

Scope

Описание: Таблица для управления правами

...

Пример отображения:

Настройки: нет

WorkflowRoute

Описание: Маршрут процесса

...

Пример отображения:

Настройки: нет

ChildItemList

Описание: Таблица дочерних элементов

...

Настройка

Описание

Значение

Пример

actionList

Список действий контекстного меню строки. По умолчанию отображается список контекстных действий ТЭ

Массив значений вида

{

"code" - code действия

"isConfirm": boolean; - нужно ли подтверждение

"isShowAfterAction": boolean; - показать ли сообщение после завершения действия

"isShowProgress": boolean; - показать ли прогресс

"text": string; - текст действия

"data": any; - доп. данные

"image": string; - иконка

"permission": string; - права

"confirmText": string; - текст подтверждения если включен isConfirm

}

[{

"code": "link.copy";

"isConfirm": false;

"isShowAfterAction": false;

"isShowProgress": false;

"image": "054328ed-7944-45d9-96c7-bd938c18b3e3"

"permission": "read"

}]

ParentItem

Описание: Родительский элемент

...