Руководство администратора

Обратная связь

Вызов методов API и веб-сервисов из JS-вставок

Из JS-вставок можно инициировать вызовы методов приложения, используемых для выполнения таких действий как создание задач, написание комментариев, изменение значений ДП и множества других востребованных вещей, что расширяет возможности сложных автоматизаций для нестандартных кейсов.

Использование методов Valhalla

warning_icon API веб-сервиса можно посмотреть, добавив в браузере к адресу вашего приложения "Первая Форма" строку /swagger:

https://<your_1forma>/swagger

Для методов Valhalla самым простым способом вызова является использование jQuery методов $.get() и $.post(), они используются для http и ajax запросов.

Конкретный метод jQuery выбирается на основании типа используемого метода приложения (указано в описании самого метода).

В качестве первого параметра передается адрес самого метода (можно использовать относительные, а не абсолютные ссылки).

В качестве второго параметра передаются сами данные для обработки в формате json (необходимая конструкция присутствует в описании самого метода).

Пример использования методов Valhalla

Еще пример использования вызова метода:

Повышение приоритета задачи (вызов метода Valhalla)

Использование методов TCWebService

API веб-сервиса можно посмотреть, добавив в браузере к адресу вашего приложения "Первая Форма" строку /tcwebservice.asmx: https://<your_1forma>/tcwebservice.asmx

Для методов TCWebService можно использовать jQuery метод $.ajax(), позволяющий более тонко настроить отправляемый запрос.

Методы $.get() и $.post() по сути являются сокращенной формой записи метода $.ajax(), поэтому метод $.ajax() применим и для вызова Valhallа методов.

Методы TCWebService используют данные в формате xml, поэтому требуется явное указание типа передаваемых данных.

•webServiceURL — адрес вызываемого метода (можно использовать относительные, а не абсолютные ссылки),

•soapMessage — данные для обработки в формате SOAP-запроса (необходимая конструкция присутствует в описании самого метода),

•OnSuccess — функция, вызываемая при получении успешного ответа от веб-сервиса (опционально),

•OnError — функция, вызываемая при получении ошибки от веб-сервиса (опционально).

Пример использования методов TCWebService