Формат действия и получение действий по записи
Общие поля действия и получение доступных действий через клиентский Records API.
Описание формата
Поле |
Тип |
Описание |
|---|---|---|
|
String |
Идентификатор действия. Для обращения через Records используется полная ссылка |
|
String / MLText |
Название действия: строка или объект локализаций, например |
|
String / MLText |
Название для нескольких записей. Если не задано, используется |
|
String |
Идентификатор зарегистрированного обработчика, например |
|
String |
Код иконки, например |
|
String |
Тема оформления действия. |
|
Object |
Параметры выбранного типа. Например, |
|
Object |
Применимость: |
|
Object |
Заголовок, сообщение или форма подтверждения; исходные данные формы и перенос введённых значений в конфигурацию. |
|
String |
URL модуля предобработки. |
|
Number |
Размер пакета при групповом выполнении; значение |
|
Number |
Настройка обработки пакетов. Значение |
|
Object |
Настройки выполнения запроса. |
|
Object |
Серверные условия доступности действия. Фронтенд получает результат их проверки; правила зависят от серверной конфигурации. См. Предикаты. |
|
String |
Ключ для серверной фильтрации действий. Общий механизм выполнения фронтенда не использует его для выбора исполнителя — для этого служит |
Подробности подтверждения, подстановок и предобработки см. в разделе Общие настройки.
Получение действий по записи
Текущий клиент ecos-ui запрашивает источник uiserv/record-actions. Ниже приведён вызов JavaScript Records API с сокращённой схемой атрибутов:
const result = await Records.queryOne(
{
sourceId: 'uiserv/record-actions',
query: {
records: [
'emodel/someType@bb617ee9-e085-4a3a-8fbf-df2d9534eadb',
'emodel/someType@74c11ef8-8c63-40c1-b119-94feefd7f885'
],
actions: ['uiserv/action@edit', 'uiserv/action@delete']
}
},
{
records: 'records[]?num',
actions: 'actions[]{id,name,icon,type,config:config?json,features:features?json}'
}
);
Пример результата этого вызова:
{
"records": [3, 2],
"actions": [
{
"id": "uiserv/action@edit",
"name": "Редактировать",
"icon": "icon-edit",
"type": "edit",
"config": {},
"features": {"execForRecord": true}
},
{
"id": "uiserv/action@delete",
"name": "Удалить",
"icon": "icon-delete",
"type": "delete",
"config": {},
"features": {"execForRecord": true, "execForRecords": true}
}
]
}
Массив records содержит числовые маски доступности в порядке запрошенных записей. Бит 1 << actionIndex соответствует позиции действия в массиве actions. В примере маска 3 разрешает оба действия для первой записи, а 2 — только второе для второй.
Рабочий клиент дополнительно запрашивает pluralName, preActionModule, confirm и настройки пакетного выполнения и запроса. Полный список находится в ACTION_INNER_ATTRIBUTES файла src/components/core/Records/actions/recordActionsApi.js.
Сервис recordActions.getActionsForRecords(records, actions, context) преобразует этот ответ в группы forRecord, forRecords и forQuery, проверяет возможности исполнителей и контекст. Это уже клиентская модель, отличающаяся от результата Records.queryOne.
При вызове recordActions.getActionsForRecord(record) без явного списка действий клиент сначала загружает _type?id записи, затем _actions[]?id её типа и запрашивает доступность найденных действий.