Исполнение скриптов посредством HTTP-запросов

Material from ADGroupWiki
Go to navigation Go to search

Исполнение скриптов посредством HTTP-запросов

Файл:Http request sample.rar

В случае необходимости получения данных из программы для дальнейшей обработки или передачи (к примеру, интеграция с 1С), предусмотрен механизм исполнения скриптов посредством запросов HTTP. Для того, чтобы иметь возможность пользоваться этой функциональностью, вам понадобится совершить ряд предварительных действий:

  • Для включения работы HTTP сервера программы, ее следует запустить на "главном" компьютере с ключом server (ccalc.exe -server).
Обнаружив этот ключ при запуске, программа начинает прослушивание порта 4480.
Для вашей внутренней сети адрес доступа к сервису может иметь вид http://192.168.0.111:4480,
где 192.168.0.111 - IP-адрес компьютера на котором запущена программа с включенным режимом http-сервис,
а 4480 - порт, через который происходит обращение к ней.
  • Разрешить пользователю с полномочиями Администратора "Выполнение скриптов через командную строку и http-сервис", установив галочку напротив соответствующего пункта в окне "Редактор пользователя" на вкладке "Общие".
ВАЖНО! Запомните Имя и Пароль пользователя из этого окна для дальнейшего процесса аутентификации.

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

Построение запроса с помощью программы RESTDebugger

Запускаем RESTDebugger.
На вкладке Request:

Сразу после завершающего слэша ("/") вставляем подготовленный текст скрипта не содержащий символов перевода строки.

XXX.XXX.XXX.XXX - ip-адрес или адрес сервера к которому происходит обращение.

На вкладке Authentication:

  • значение списка Method устанавливаем в BASIC
  • в поля Username и Password вписываем значения, запомненные ранее при настройке разрешений у пользователя из программы.

Нажатие кнопки Send Request произведет обращение к программе и в нижней части окна вы сможете увидеть ответ сервера.
Если в процессе исполнения произошли ошибки, они будут отображены текстом красного цвета под строкой запроса в области Response.

Корректно работающий запрос полезно сохранить в файл нажатием кнопки Save Request.
Позже этот или любой другой сохраненный запрос с расширением .json можно будет загрузить воспользовавшись кнопкой Load Request.

Запрос из браузера

Введя в адресную строку браузера http-запрос (в сохраненном json-файле это секция url) вы получите от сервера аналогичный ответ. При этом вам может понадобиться ввести данные в форму аутентификации пользователя в браузере.