Цифра ↔ 1С

cf_МодульСервер

Главный серверный модуль расширения. Отвечает за HTTP-взаимодействие с API Цифры, систему мониторинга заданий и автоматическую выгрузку при изменении справочников.

Функции модуля

ПолучитьОтветAPI(Адрес, Данные)

Базовая функция для отправки HTTP-запросов на сервер Цифры.

cf_Мониторинг (регулярный опрос)

Ключевая процедура — вызывается регулярным заданием (каждую минуту). Реализует polling-механизм:

  1. Получает секретный ключ из настроек
  2. Отправляет POST на /api/check с параметром SecretKey
  3. Проверяет ответ: если нет структуры с полем Tasks — записывает ошибку в журнал регистрации
  4. Для каждого элемента массива Tasks вызывает cf_Мониторинг_Задача

cf_Мониторинг_Задача (обработка одного задания)

Обрабатывает одно задание из очереди. Жизненный цикл задания:

  1. Статус «work» — сразу при получении, отправляется на /api/changeTaskStatus
  2. Выполнение — вызывает нужный модуль в зависимости от Элемент.Task
  3. Статус «done» или «failed» — по результату, отправляется на /api/changeTaskStatus

Маршрутизация заданий

TaskВызываемый модульНаправление
getCompaniescf_ВыгрузитьКонтрагенты1С → Цифра
getContractscf_ВыгрузитьДоговораКонтрагентов1С → Цифра
getProductscf_ВыгрузитьНоменклатура1С → Цифра
getSpecificationscf_ВыгрузитьРесурсныеСпецификации1С → Цифра
getCarscf_ВыгрузитьТранспортныеСредства1С → Цифра
getDriverscf_ВыгрузитьФизическиеЛица1С → Цифра
getInvoicescf_ВыгрузитьСчетаПокупателю1С → Цифра
getDeliveryZonescf_ВыгрузитьЗоныДоставки1С → Цифра
createContractcf_СоздатьДоговорЦифра → 1С
createCompanycf_СоздатьКонтрагентаЦифра → 1С
createCarcf_СоздатьТранспортныеСредстваЦифра → 1С
createOrdercf_СоздатьДокументЗаказЦифра → 1С
createApplicationcf_СоздатьДокументРеализацияЦифра → 1С

cf_Справочник_ПриЗаписи (подписка на события)

Срабатывает при записи любого справочника. Запускает фоновое задание для выгрузки изменённого элемента. Поддерживаемые типы:

СправочникУсловие выгрузкиМодуль
ОрганизацииОрганизация есть в МассивОрганизации из настроекcf_ВыгрузитьКонтрагенты
СоглашенияСКлиентамиУ подразделения установлен флаг cf_ВыгрузитьВЦифруcf_ВыгрузитьДоговораКонтрагентов
КонтрагентыВсегдаcf_ВыгрузитьКонтрагенты
НоменклатураВсегдаcf_ВыгрузитьНоменклатура
ТранспортныеСредстваВсегдаcf_ВыгрузитьТранспортныеСредства
ФизическиеЛицаВсегдаcf_ВыгрузитьФизическиеЛица
ЗоныДоставкиВсегдаcf_ВыгрузитьЗоныДоставки

Фоновая выгрузка запускается через ФоновыеЗадания.Выполнить в привилегированном режиме.

Вспомогательные функции