Show/Hide Toolbars

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

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

Ссылки Назад Вверх Вперед

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

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

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

https://<your_1forma>/swagger

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Полезные ссылки