Создание действия

1. В настройках пространства Центр администрирования в разделе Списки по двойному клику ЛКМ перейти на список Действия
2. Создать элемент с типом Вызов внешнего сервиса
3. На вкладке Информация заполнить Атрибуты:

Привязка действия к типу элемента

1. В настройках пространства Центр администрирования в разделе Списки по двойному клику ЛКМ перейти на список Действие типа элемента
2. Создать элемент с типом Действие типа элемента
3. На вкладке Информация заполнить атрибуты:

Вызов действия

При вызове действия отправляется POST запрос на указанный в действии URL.
В заголовке Authorization передается токен пользователя.

В теле запроса передается JSON вида:

{
    itemIdList: [...] - массив id выбранных элементов
}

Обработка ответа

Доступны два варианта обработки полученного при вызове сервиса ответа:

1. Отображение информации об ошибке

Для отображения текста ошибки, ответ должен приходить в виде строки, либо в формате JSON вида:

{
    exception: {
	    message: 'Текст ошибки'
    }
}

2. Переход по ссылке

Для перехода по ссылке в ответе должно соблюдаться два условия:

  1. Код ответа должен 200 ОК
  2. В заголовках ответа должен присутствовать один из двух вариантов:
    1. Link-Open + ссылка (откроется в этой же вкладке)
    2. Link-Open-New-Tab + ссылка (откроется в новой вкладке)

Если в браузере вызывается сервис, который расположен на хосте отличном от хоста страницы, то в браузере включается механизм CORS (Cross-Origin Resource Sharing). Этот механизм накладывает ряд ограничений, в частности не позволяет со страницы прочитать заголовки ответа. В этом случае нужно на внешнем сервере явно указать, какие именно заголовки будут доступны. Для этого в заголовке ответа от внешнего сервиса нужно добавить:
"Access-Control-Expose-Headers": "Link-Open, Link-Open-New-Tab"

"Access-Control-Allow-Origin": "адрес портала, с которого вызывается внешний сервис"