Перейти к основному содержимому

Расширенный вызов

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

Использование в 1С:Предприятие и OneScript​

Работа с расширенным вызовом в 1С и OneScript доступна через функции модуля OPI_РасширенныйВызов

  • ВызватьСНастройками — вызывает метод модуля ОПИ с передачей структуры расширенных настроек
  • ПолучитьДоступныеНастройки — возвращает текстовое описание доступных для выбранного метода ключей настроек

Пример вызова функции отправки сообщения в Telegram без и с расширенным вызовом:


// Обычный вызов

    Токен    = "3129457865:AAFyzNYOAFbu...";
    IDЧата   = "123456789";
    Текст    = "ТекстСообщения";

    Результат  = OPI_Telegram.ОтправитьТекстовоеСообщение(Токен, IDЧата, Текст);


// Расширенный вызов

    Параметры = Новый Массив;
    Параметры.Добавить("3129457865:AAFyzNYOAFbu...");
    Параметры.Добавить("123456789");
    Параметры.Добавить("ТекстСообщения");

    Настройки = Новый Структура;
    Настройки.Вставить("adv_response", Истина); // Добавляет код ответа и заголовки в результат функции
    Настройки.Вставить("timeout"     , 10000);  // Изменяет таймаут HTTP-запроса

    Результат = OPI_РасширенныйВызов.ВызватьСНастройками("OPI_Telegram"
        , "ОтправитьТекстовоеСообщение"
        , Параметры
        , Настройки);

Использование в CLI​

Для использования расширенного вызова в OInt CLI используется стандартная опция --config. В нее можно передать коллекцию дополнительных настроек в виде JSON объекта с соответствующими полями

oint telegram ОтправитьТекстовоеСообщение -t "31294578..." -c "123456789" -x "Text" --config "{'adv_response': true, 'timeout': 1000}"

Получить список доступных полей для конкретного метода можно в документации или вызвав интересующий метод с параметром --config без установки значения

oint telegram ОтправитьТекстовоеСообщение --config

Настройки расширенного вызова в документации​

Найти описание настроек расширенного вызова для конкретной функции библиотеки можно на ее странице документации, переключив вкладку в блоке Параметры/Расширенный вызов