CFU в 1С: расшифровка, назначение и практическое применение в платформе 1С:Предприятие

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

На практике CFU (или КФУ в русскоязычной документации) — это не просто технический жаргон, а ключевой элемент архитектуры 1С, который отвечает за конвертацию форматов данных при обмене между разными системами. Без правильной настройки CFU многие интеграции (например, с 1С:EDT, EnterpriseData или сторонними API) просто не будут работать. В этой статье мы подробно разберём:

• 🔹 Что такое CFU и как расшифровывается аббревиатура
• 🔹 Где применяется в типовых и нетиповых конфигурациях 1С
• 🔹 Как настроить CFU для обмена данными с внешними системами
• 🔹 Типичные ошибки и способы их устранения

1. Расшифровка CFU: что скрывается за аббревиатурой

Аббревиатура CFU расшифровывается как Conversion Format Unit (в русскоязычных источниках — Конвертер Форматов Универсальный). Это встроенный механизм платформы 1С:Предприятие 8, предназначенный для преобразования данных из одного формата в другой при обмене между системами.

Проще говоря, CFU выполняет роль "переводчика" между:

• 📄 Внутренним форматом 1С (например, данные в виде объектов конфигурации: справочники, документы, регистры)
• 📥 Внешними форматами (JSON, XML, CSV, Protobuf и др.)
• 🔄 Форматами других систем 1С (например, при обмене между 1С:УТ 11 и 1С:БП 3.0)

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

⚠️ Внимание: В документации 1С термин CFU может упоминаться как часть Библиотеки стандартных подсистем (БСП) или модуля EnterpriseData. Если в вашей конфигурации этих компонентов нет, функционал CFU может быть ограничен или отсутствовать.

2. Где используется CFU в 1С: типовые сценарии

Механизм CFU активно применяется в следующих случаях:

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

Пример из практики: если вы настраиваете выгрузку товаров на сайт, то без CFU данные придётся конвертировать вручную через ЗаписьJSON или ЗаписьXML, что занимает в разы больше времени и чревато ошибками.

3. Структура CFU: из чего состоит конвертер форматов

Механизм CFU в 1С состоит из нескольких ключевых компонентов:

1. Описание формата (Format Description) — шаблон, определяющий структуру данных (например, какие поля объекта 1С соответствуют полям в JSON).
2. Правила конвертации (Conversion Rules) — логика преобразования типов данных (например, как конвертировать Дата 1С в строку ISO 8601).
3. Обработчики событий — пользовательский код, который выполняется на этапах чтения/записи данных (например, для валидации или трансформации значений).
4. Настройки связей — определение, как объекты 1С сопоставляются с объектами внешней системы (например, справочник Контрагенты → таблица Customers в базе PostgreSQL).

Визуально структуру CFU можно представить так:

┌───────────────────────┐    ┌───────────────────────┐
│   Данные 1С           │    │   Внешний формат      │
│ (Справочники,         │    │ (JSON, XML, Protobuf) │
│  Документы, Регистры) │    │                       │
└──────────┬────────────┘    └───────────┬───────────┘
│                            │
▼                            ▼
┌───────────────────────────────────────────┐
│               CFU (Конвертер)             │
│  ┌─────────────┐    ┌─────────────────┐  │
│  │ Описание    │    │ Правила          │  │
│  │ формата     │    │ конвертации      │  │
│  └─────────────┘    └─────────────────┘  │
│  ┌─────────────┐    ┌─────────────────┐  │
│  │ Обработчики │    │ Настройки связей │  │
│  │ событий     │    │                  │  │
│  └─────────────┘    └─────────────────┘  │
└───────────────────────────────────────────┘
│                            │
▼                            ▼
┌───────────────────────┐    ┌───────────────────────┐
│   Преобразованные     │    │   Данные во внешней   │
│   данные 1С           │    │   системе             │
└───────────────────────┘    └───────────────────────┘

В 1С:EDT описание CFU хранится в отдельных файлах с расширением .cfu (например, Catalogs.cfu для справочников). В классической конфигурации настройка ведётся через объекты метаданных или программно.

4. Пошаговая инструкция: как настроить CFU в 1С

Рассмотрим процесс настройки CFU на примере выгрузки справочника Номенклатура в формат JSON для интеграции с сайтом. Инструкция актуальна для конфигураций на управляемых формах (8.3.10+).

Создать резервную копию базы|Проверить наличие прав администратора|Убедиться, что в конфигурации подключена БСП или EnterpriseData|Подготовить описание структуры данных для внешней системы-->

Шаг 1. Создание описания формата

Откройте конфигуратор и перейдите в ветку Общие → КонвертацияДанных → ОписанияФорматов. Создайте новый объект:

1. Укажите имя, например JSON_НоменклатураДляСайта.
2. В поле Тип формата выберите JSON.
3. В разделе Структура опишите соответствие полей:

   
   {
   "Номенклатура": {
   "id": "Ссылка.УникальныйИдентификатор()",
   "name": "Наименование",
   "article": "Артикул",
   "price": "ЦенаПродажи"
   }
   }
       

Шаг 2. Настройка правил конвертации

Перейдите в Общие → КонвертацияДанных → ПравилаКонвертации и создайте новое правило:

• 📌 Укажите источник: справочник Номенклатура.
• 📌 Выберите целевой формат: JSON_НоменклатураДляСайта (созданный на шаге 1).
• 📌 Настройте преобразование типов:
  • Для поля ЦенаПродажи укажите формат числа с 2 знаками после запятой.
  • Для поля Ссылка добавьте обработчик, который преобразует ссылку 1С в строковый GUID.

Шаг 3. Реализация обмена данными

Создайте обработку с следующим кодом для выгрузки данных:

Процедура ВыгрузитьНоменклатуруВJSON(КаталогВыгрузки)

// 1. Получаем данные из 1С
Выборка = Справочники.Номенклатура.Выбрать();
ДанныеДляВыгрузки = Новый Массив();

Пока Выборка.Следующий() Цикл
ДанныеДляВыгрузки.Добавить(Выборка.Ссылка);
КонецЦикла;

// 2. Создаём конвертер
Конвертер = КонвертацияДанных.СоздатьКонвертер();
Конвертер.ДобавитьПравило("Правило_НоменклатураВJSON");

// 3. Выгружаем в файл
ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.ОткрытьФайл(КаталогВыгрузки + "номенклатура.json");
Конвертер.ЗаписатьДанные(ДанныеДляВыгрузки, ЗаписьJSON);
ЗаписьJSON.Закрыть();

КонецПроцедуры

Для обратной загрузки (импорта данных из JSON в 1С) используйте метод Конвертер.ПрочитатьДанные().

5. Типичные ошибки при работе с CFU и их решения

При настройке CFU разработчики часто сталкиваются со следующими проблемами:

Если ошибка не устраняется, проверьте:

• 🔍 Логи обмена: включите запись логов в настройках CFU (параметр ВключитьПротоколирование).
• 🔍 Совместимость версий: в старых версиях 1С (до 8.3.10) функционал CFU может отличаться.
• 🔍 Права доступа: убедитесь, что у пользователя есть права на чтение/запись объектов, участвующих в обмене.

⚠️ Внимание: При обмене данными между разными версиями 1С (например, 8.3.15 и 8.3.20) могут возникать ошибки из-за изменений в метаданных. В этом случае используйте промежуточный формат (например, XML с явным описанием структуры).

6. CFU vs альтернативные способы обмена данными

CFU — не единственный способ интеграции 1С с внешними системами. Рассмотрим альтернативы и их особенности:

Выбор метода зависит от задачи:

• 🔹 Для внутреннего обмена между базами 1С подойдёт УниверсальныйОбменДанными.
• 🔹 Для интеграции с сайтом или CRM оптимален CFU или REST API.
• 🔹 Для одноразовой миграции данных можно использовать ЗагрузкаДанныхИзТабличногоДокумента.

7. Продвинутые возможности CFU: что умеет механизм

Помимо базовой конвертации, CFU поддерживает ряд продвинутых функций:

• 🔹 Преобразование коллекций: автоматическая обработка массивов и таблиц значений. Например, выгрузка табличной части документа в массив JSON.
• 🔹 Поддержка версионности: можно сохранять несколько версий описаний форматов для обратной совместимости.
• 🔹 Валидация данных: проверка корректности данных перед конвертацией (например, обязательность полей).
• 🔹 Расширения через код: подключение собственных обработчиков на 1С или C# (в 1С:EDT).
• 🔹 Кэширование: ускорение повторной конвертации за счёт сохранения промежуточных результатов.

Пример расширенного использования: если вам нужно выгрузить не только справочник Номенклатура, но и связанные с ним Цены и Остатки, можно создать композитное правило конвертации, которое объединит несколько объектов в один JSON-документ:

{
"products": [
{
"id": "Номенклатура.Ссылка.УникальныйИдентификатор()",
"name": "Номенклатура.Наименование",
"prices": [
{
"type": "ТипЦен.Наименование",
"value": "Цены.Цена"
}
],
"stock": {
"quantity": "Остатки.Количество",
"warehouse": "Остатки.Склад.Наименование"
}
}
]
}

Для работы с такими сложными структурами может потребоваться написание кастомных обработчиков на встроенном языке 1С.

8. Будущее CFU: что меняется в новых версиях 1С

В последних версиях платформы 1С:Предприятие 8.3.20+ механизм CFU претерпевает следующие изменения:

• 🔹 Улучшенная поддержка Protobuf: более эффективная сериализация данных для высоконагруженных систем.
• 🔹 Интеграция с 1С:EDT: визуальный редактор правил конвертации (аналог XSLT для XML).
• 🔹 Автоматическое генерирование схем: для JSON Schema и OpenAPI на основе метаданных 1С.
• 🔹 Поддержка асинхронного обмена: для интеграций с системами, требующими неблокирующих запросов.

{
"image": {
"data": "Картинка.ПолучитьДвоичныеДанные()",
"format": "base64"
}
}