Исполнение скриптов посредством HTTP-запросов
Исполнение скриптов посредством HTTP-запросов
В случае необходимости получения данных из программы для дальнейшей обработки или передачи (к примеру, интеграция с 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:
- в списке Method устанавливаем GET
- в поле URL вписываем http://XXX.XXX.XXX.XXX:4480/datasnap/rest/TServerMethods/script/
Сразу после завершающего слэша ("/") вставляем подготовленный текст скрипта не содержащий символов перевода строки.
XXX.XXX.XXX.XXX - ip-адрес или адрес сервера к которому происходит обращение.
На вкладке Authentication:
- значение списка Method устанавливаем в BASIC
- в поля Username и Password вписываем значения, запомненные ранее при настройке разрешений у пользователя из программы.
Нажатие кнопки Send Request произведет обращение к программе и в нижней части окна вы сможете увидеть ответ сервера.
Если в процессе исполнения произошли ошибки, они будут отображены текстом красного цвета под строкой запроса в области Response.
Корректно работающий запрос полезно сохранить в файл нажатием кнопки Save Request.
Позже этот или любой другой сохраненный запрос с расширением .json можно будет загрузить воспользовавшись кнопкой Load Request.
Запрос из браузера
Введя в адресную строку браузера http-запрос (в сохраненном json-файле это секция url) вы получите от сервера аналогичный ответ. При этом вам может понадобиться ввести данные в форму аутентификации пользователя в браузере.