Если для выполнения бизнес-задачи в API нет готового метода, можно использовать публикации пакетов действий. Публикации используются также для интеграции "Первой Формы" со сторонними системами.
Чаще всего публикуются пакеты со смарт-действием HTTP ответ.
Пример
После загрузки карточки задачи отображается сообщение с именем и днем рождения лучшего друга пользователя. Лучший друг определяется как коллега, с которым пользователь чаще всего взаимодействует в "Первой Форме", для этого используется хранимая процедура.
Публикация пакета действий:
Публикация пакета действий и URL для вызова
Опубликованный пакет действий
Текст JS-вставки:
window.addEventListener('MTFMainLoadFinished', function() {
var userSelect = new ExtParam(123);
userSelect.change(function() {
var userId = userSelect.val();
console.log(userId);
$.ajax({
url: "/app/v1.2/api/publications/action/get-user-coworkerks?userid=" + userId,
type: "GET",
success: function(response) {
alert('Лучший друг пользователя: ' + response.name + '\nДень рождения лучшего друга: ' + response.birthdate);
}
});
});
});
|
Проверка
Перед тем, как использовать публикацию в JS-вставке, стоит проверить правильность ее работы. Для этого нужно скопировать URL с параметрами в адресную строку. Если публикация работает с ошибкой, она вернет пустое окно.
Проверка работы опубликованного пакета действий
Полезные ссылки
Публикации
Примеры публикации пакетов действий