Дата последней модификации страницы: 20.03.2026

Для разработчика механизм асинхронного получения данных позволяет не отвлекаться на механику транспорта. На вход прикладной разработчик получает идентификатор обработчика и двоичные данные, которые разбирает и формирует нужные данные в ответ.

Обработка для эмуляции асинхронного получения данных АсинхронноеПолучениеДанных.epf встроена в Демо-конфигурацию Библиотеки технологии сервиса.

В механизме не используется ролевая модель платформы 1C:Предприятие, по этому данный транспорт может использоваться только в направлении "Внешняя система" → "Сервис 1С:Фреш", где пользователь , под которым инициируется получение данных является служебным, представляющим эту внешнюю систему, а не конкретного человека. При этом разработчик прикладного решения может реализовать свою собственную ролевую модель.

Методы программного интерфейса

Расположены в общем модуле АсинхронноеПолучениеДанных.

Функция НовыйОписаниеВозвращаемыхДанных

Возвращает новую структуру описания возвращаемых данных. Может использоваться при встраивании подсистемы для подготовки структуры описания отчета для метода АсинхронноеПолучениеДанныхПереопределяемый.УстановитьДоступныеВозвращаемыеДанные.

Возвращаемое значение:

  • Структура - описание отчета:
    • МодульМенеджер - ОбщийМодуль, МодульМенеджераОбъекта - модуль менеджера модуль менеджера получения данных, из которого будет вызван метод ВозвращаемыеДанные .
    • Наименование - Строка - наименование возвращаемых данных.
    • Описание - Строка - подробное описание возвращаемых данных.
    • ТипыРезультата - Массив из Строка - типы возвращаемых данных.

Функция ДоступныеВозвращаемыеДанные

Возвращает перечень доступных данных.

Возвращаемое значение:

  • Соответствие - перечень доступных возвращаемых данных.
    • Ключ - Строка - идентификатор данных
    • Значение - Структура - описание данных(см. АсинхронноеПолучениеДанных.НовыйОписаниеВозвращаемыхДанных)

Переопределяемые методы программного интерфейса

Расположены в общем модуле  АсинхронноеПолучениеДанныхПереопределяемый .

Процедура АвторизоватьЗапрос

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

Метод должен использоваться, если прикладной разработчик реализует собственную ролевую модель доступа к данным.

Параметры:

  • ИдентификаторДанных - Строка - идентификатор данных. Может быть переопределено при обработке. Указывается в качестве имени файла, возвращаемом в результате.
  • Параметры - ДвоичныеДанные - переданные параметры получения данных.
  • Отказ - Булево - Возвращаемый параметр. Признак отказа в авторизации. При отказе в авторизации устанавливать в Отказ = Истина.
  • СообщениеОбОшибке - Строка - Возвращаемый параметр. Текст сообщения об ошибке при отказе в авторизации. 

Процедура УстановитьДоступныеВозвращаемыеДанные

Вызывается при формировании списка доступных отчетов и при получении данных отчета. Определяет список отчетов, подключенных к подсистеме.

Параметры:

  • ДоступныеВозвращаемыеДанные - Соответствие из КлючИЗначение
    • Ключ - Строка - идентификатор данных
    • Значение - см. АсинхронноеПолучениеДанных.НовыйОписаниеВозвращаемыхДанных

Методы, возвращающие стандартные кодов возвратов по имени метода

Предполагается использование при формировании ответов при подготовке данных в прикладных объектах.
Методы находятся в общем модуле АсинхронноеПолучениеДанныхСловарь .

  • КодВозвратаОшибкаДанных
  • КодВозвратаВнутренняяОшибка
  • КодВозвратаВыполненоСПредупреждениями
  • КодВозвратаВыполнено
  • КодВозвратаНеНайдено

Возвращаемое значение

  • Число - стандартный код возврата по имени метода

Методы, возвращающие типы файлов возвращаемых данных

Методы предполагается использовать при подготовке данных в прикладных решениях для формирования имени файлов результатов и для использования в условиях.
Методы находятся в общем модуле АсинхронноеПолучениеДанныхСловарь .

  • ТипJSON
  • ТипXLSX
  • ТипPDF

Реализация программного интерфейса в прикладной конфигурации

Подключение обработчиков получения данных к подсистеме реализуется 2-мя методами.

Процедура УстановитьДоступныеВозвращаемыеДанные

Заполняет перечень доступных возвращаемых данных. Процедура должна вызываться из переопределяемого модуля АсинхронноеПолучениеДанныхПереопределяемый.УстановитьДоступныеВозвращаемыеДанные.

Параметры:

  • ДоступныеВозвращаемыеДанные - Соответствие из КлючИЗначение:
    • Ключ - Строка - идентификатор данных
    • Значение - см. АсинхронноеПолучениеДанных.НовыйОписаниеВозвращаемыхДанных

Функция ВозвращаемыеДанные

Возвращает данные по идентификатору данных
Параметры:

  • ИдентификаторДанных - Строка - идентификатор данных. Указывается в качестве имени файла, возвращаемом в результате. Может быть переопределен.
  • Параметры - ДвоичныеДанные - переданные параметры получения данных.
  • КодВозврата - Число - код возврата обработчика получения данных (по умолчанию - 10200).
  • Ошибка - Булево - признак ошибки (по умолчанию - Ложь)
  • СообщениеОбОшибке - Строка - подробности ошибки (по умолчанию не заполнено).

Возвращаемое значение:

  • ДвоичныеДанные - возвращаемые данные.

Логика по разбору параметров и формированию возвращаемых данных остается за прикладным разработчиком.