Versions Compared

Key

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

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

...

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

 

Настройки:

Настройка

Описание

Значение

Пример

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

[];

  isVisible: string | boolean;

  field: string;

}

label – заголовок группы

fieldList – массив Системных имен

] - массив Системных имен (internal_name)

атрибутов ТЭ, входящих в группу

атрибутов ТЭ, входящих в группу;

  "isVisible": string | boolean

isVisible

– 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

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

...

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

Настройки: 

Настройка

Описание

Значение

Пример

listId

id списка


id списка, элементы которого надо отобразить. 

guid

guid

"02b4fda6-01b9-4ddb-a7cd-7a56fa415f11"

viewId

id

Вида списка

вида списка

guid

"cb2843bb-5a23-49f4-94b2-30665b778c78"

addContentTypeList

Список ТЭ доступных для создания через кнопку «Добавить»

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

{

"id": string – guid типа элемента,

"viewId

": string,"field

": string

}

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

viewId

– guid вида карточки типа элемента,

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

хранится

указаны ТЭ для создания. Необязательный параметр, используется если не задан id.

}


[

  {

    "id": "092edc08-4f91-a8c2-9cae-a6f9248dc294",

    "viewId": "f2f5edd4-08cb-4b72-9eaa-c46ccbc1e610"

  }

]

linkField

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

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

"content_type"

linkCriterionList

Список поисковых критериев, по которым происходит отбор элементов из списка. Используется, если необходимо указать несколько linkField. В качестве значения valueList в критерии подставляется формула “item.id”, которая вернет id текущего элемента.


Пример использования: на вкладке Связи нужно отобрать все элементы списка Связь, у которых Источник (source) или Назначение (destination) равны текущему элементу.

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

{

"internalName": string - системное имя атрибута,

  "valueList": [any

[

]

,

  "condition": number,

  "operator": number

}

internalName - системное имя атрибута

valueList

- список значений, это может быть строка, число, guid и т.д.,

  "condition": number - код условия (равно/не равно/содержит и т.д., полный список кодов указан в конце таблицы),

  "operator": number - код оператора (и/или, см. в конце таблицы)

}


[

  {

    "internalName": "source",

    "valueList":

    [

      "item.id"

    ],

    "condition": 1,

    "operator": 1

  },

  {

    "internalName": "destination",

    "valueList":

    [

      "item.id"

    ],

    "condition": 1,

    "operator": 1

  }

]

label

Заголовок

Строка

Атрибуты

isInlineEdit

Доступно ли инлайн-редактирование ячеек в табличном виде

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

false

dock

Масштабирование компонента внутри вкладки

Строка.

В данный момент принимает единственное значение – «fill», которое растягивает компонент на всю высоту вкладки

“fill”

isAddDialogAutoClosed

Скрывать ли форму добавления нового элемента (по кнопке «Добавить») после его сохранения

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

true

disabledActionList

Список кодов действий недоступных для вызова. Для редактирования и добавления (через кнопку Добавить) используются коды “edit” и “add” соответственно.

Массив кодов действий

[“add”, “delete”] – отключена возможность добавления и удаления элементов

view

Настройки центральной части вида списка. Используется если нужно изменить какие-то настройки вида, указанного во viewId

json со структурой как в атрибуте “Настройки центральной части” (Настройки центральной части) вида списка

{

  "columnList": {

    "columnListMode": "Custom",

    "visibleColumnList": [

      {

        "internalName": "principal.name",

        "name": "Пользователь"

      }

    ]

  }

}

isEnabled

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

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

false

isMultiAdd

Создание сразу нескольких элементов через кнопку Добавить. Если данная настройка включена, вместо формы появляется диалоговое окно для выбора элементов, с которыми необходимо создать связь по указанному атрибуту multiAddField


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

true/false

true

multiAddField

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

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

"destination"

addNewLinkField

Лукап атрибут, в который подставится id текущего элемента при создании через кнопку Добавить (если нужно указать отличный от linkField атрибут)

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

"destination"

refreshMode

Тип обновления таблицы после добавления/редактирования/удаления элементов.

Одно из 2-х значений:

row – построчно

page – полная перезагрузка

"row"

visibleFieldList 

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

Список видимых атрибутов на карточке, открывающейся по кнопке «Добавить»


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

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

hiddenFieldList

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

Список скрытых атрибутов на карточке, открывающейся по кнопке «Добавить»

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

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

actionList

(не используется, сейчас все настраивается через TЭ и disabledActionList , оставлено для совместимости)

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

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

{

"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"

}]

Коды условий (condition):

...

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

Настройки: 

Настройка

Описание

Значение

Пример

visibleFormula

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

Формула


stateList

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

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

{

 "state": string,

 "text": string,

 "visibleFormula": string,

 "actionList": [{

    "code": string,

    "style": string,

    "isEnabled": boolean

 }]

}

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

text – текст внутри плашки

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

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

{

    code – code действия

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

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

}

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


css классы для style

Название

Внешний вид

vitro-primary

Image Modified

vitro-outline-primary

Image Modified

vitro-outline-light

Image Modified

vitro-light

Image Modified

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 

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

...

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

Настройки:

Настройка

Описание

Значение

Пример

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

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

...