Versions Compared

Key

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

Table of Contents

Общая структура

Настройки вида карточки типа элемента представляют из себя себя 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 - компонент, позволяющий отобразить карточку элемента, связанного с текущим.

ListView - компонент, позволяющий вывести список связанных элементов, с возможностью добавления нового. 

DetailAction - компонент, позволяющий вывести на вкладку уведомление с заданным текстом и набором возможных действий-кнопок.  

LookupPicker - компонент, позволяющий вывести контрол выбора элемента из списка.

WorkflowInitFileList - компонент, отображающий таблицу с файлами в окне запуска процесса.

Activity - компонент, отображающий историю изменений элемента.

Version Version - компонент, отображающий список версий файла.

Scope Scope - компонент, позволяющий управлять правами доступа к элементу.

WorkflowRoute  WorkflowRoute  - компонент, отображающий маршрут процесса. 

ChildItemList ChildItemList - компонент, отображающий дочерние элементы текущего.

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

FieldIterator

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

Guid: a29a30ca-2bf6-46ed-bea8-189b11891818

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

 Image Modified

Настройки:

Настройка

Описание

Значение

Пример

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

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

Guid: 92ab22bd-3420-43bf-b27f-2766b98c5e57

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

Image Modified

Настройки: 

...

Guid: 5685e905-a34c-4f41-941d-a37a2f8a8f50

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

Image Modified

Настройки: 

...

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

Настройки: 

Настройка

Описание

Значение

Пример

visibleFormula

Формула видимости всего компонента

Формула

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

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

stateList

Список состояний компонента

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

{

 "state": string – одно из 3-x значений: "success"/"error"/"warning". Влияет на цвет и иконку плашки зеленый/желтый/красный соответственно,

 "text": string– текст внутри плашки,

 "visibleFormula": string  – формула видимости состояния. Высчитывается сразу для всех состояний, отображается первое состояние, чья формула вернула true,

 "actionList": – список действий, которые будут отображаться в виде кнопок. Содержит массив объектов вида: [{

    "code": string  – код действия,

    "style": string – css класс, который определяет стиль кнопки (см. в конце таблицы),

    "isEnabled": boolean – true/false, определяет активна ли кнопка

 }]

}

Настройки вкладки «Файлы» вида Вид карточки задачи процесса "Согласование документации"


css классы для style

Название

Внешний вид

vitro-primary

vitro-outline-primary

vitro-outline-light

vitro-light

...

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

Настройки: 

Настройка

Описание

Значение

Пример

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 

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

...

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

Настройки:

Настройка

Описание

Значение

Пример

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

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

...