Как открыть DBF файл в 1С

Формат DBF (dBase) до сих пор встречается в обмене данными: банковские выписки, выгрузки из старых учётных систем, справочники контрагентов и классификаторы часто приходят именно в нём. В 1С нет кнопки «открыть DBF» в стандартном меню «Файл», но платформа содержит встроенный объект XBase, который позволяет читать и записывать такие файлы программно.

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

Перед началом работы важно понять структуру файла: какие поля в нём есть, какого они типа и в какой кодировке записан текст. Большинство проблем при открытии DBF связано именно с кодировкой — старые файлы часто сохранены в DOS-кодировке (CP866), и при чтении без её указания русские буквы превращаются в нечитаемые символы.

Что такое DBF и когда он встречается в работе с 1С

DBF — это табличный формат базы данных, где каждый файл представляет одну таблицу с фиксированным набором полей. Поля имеют строгий тип: символьное (C), числовое (N), дата (D), логическое (L) и мемо (M). В отличие от Excel, структура жёсткая: длина символьного поля и число знаков после запятой заданы в заголовке файла.

На практике DBF приходит из банк-клиентов старых версий, из программ складского учёта, из государственных информационных систем и из конфигураций 1С:Предприятие 7.7, где обмен через DBF был штатным механизмом. Если вы мигрируете данные из семёрки или принимаете выгрузку от контрагента, вероятность столкнуться с DBF высока.

Открытие DBF через объект XBase: базовый код

Основной инструмент — объект XBase. Минимальный код для чтения файла выглядит так: создаётся объект, задаётся кодировка, файл открывается, затем записи перебираются в цикле. Ниже пример, который читает файл и выводит значения полей в сообщения.

ФайлДБФ = Новый XBase;
ФайлДБФ.Кодировка = КодировкаXBase.OEM; // для файлов в DOS-кодировке
ФайлДБФ.ОткрытьФайл("C:\Обмен\sprav.dbf");

Пока ФайлДБФ.Следующая() Цикл
    Наименование = ФайлДБФ.NAME;
    Код = ФайлДБФ.CODE;
    Сообщить(Код + " | " + Наименование);
КонецЦикла;

ФайлДБФ.ЗакрытьФайл();

Обращение к полям идёт по имени, как к свойствам объекта: ФайлДБФ.NAME. Метод Следующая() переводит указатель на следующую запись и возвращает Ложь, когда записи закончились. Если файл не существует или повреждён, метод ОткрытьФайл() вызовет исключение, поэтому в рабочем коде его оборачивают в попытку-исключение.

Для проверки структуры файла перед чтением полезно перебрать коллекцию полей: ФайлДБФ.Поля содержит описание каждого поля — имя, тип, длину и точность. Это позволяет написать универсальную обработку, которая выводит любой DBF без жёсткой привязки к именам колонок.

1. 1
   Создайте объект: ФайлДБФ = Новый XBase
2. 2
   Укажите кодировку: ФайлДБФ.Кодировка = КодировкаXBase.OEM или ANSI
3. 3
   Откройте файл методом ОткрытьФайл() с полным путём
4. 4
   Проверьте структуру через коллекцию ФайлДБФ.Поля
5. 5
   Переберите записи циклом Пока ФайлДБФ.Следующая() Цикл
6. 6
   Закройте файл методом ЗакрытьФайл() и проверьте загруженные данные

Просмотр DBF без программирования

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

Альтернатива — открыть файл сторонними средствами: LibreOffice Calc и Excel старых версий читают DBF напрямую. Это удобно для предварительной оценки: вы быстро видите структуру, количество записей и понимаете, какие поля нужны для загрузки. Однако сохранять файл обратно из Excel не стоит — он может потерять структуру полей или испортить кодировку, и последующая загрузка в 1С сломается.

Кодировка: почему появляются «кракозябры»

Самая частая проблема при открытии DBF — неправильная кодировка. Файлы, созданные в DOS-эпоху и в 1С 7.7 по умолчанию, используют OEM-кодировку (CP866). Файлы из Windows-приложений обычно в ANSI (Windows-1251). Если кодировка указана неверно, числа и даты читаются корректно, а русский текст превращается в бессмысленный набор символов.

В объекте XBase кодировка задаётся свойством Кодировка со значениями КодировкаXBase.OEM или КодировкаXBase.ANSI. Практический приём: откройте файл с одной кодировкой, прочитайте несколько записей и посмотрите на текстовые поля. Если символы нечитаемы — закройте файл, смените кодировку и откройте заново. Признаки читаемого текста видны сразу.

Загрузка данных из DBF в справочники 1С

Чтение файла — только половина задачи. Обычно данные нужно перенести в базу: создать элементы справочника, заполнить документы или регистр сведений. Типовой алгоритм: в цикле перебора записей ищется существующий элемент по коду или наименованию, при отсутствии создаётся новый, поля заполняются значениями из DBF, затем объект записывается.

Здесь важны три момента. Первый — типизация: числовое поле DBF может содержать значение с плавающей точкой, а в 1С ожидается строка или дата, поэтому используйте явные преобразования. Второй — помеченные на удаление записи: в DBF удалённые записи физически остаются в файле, и метод ЗаписьУдалена() позволяет их пропустить. Третий — производительность: при загрузке десятков тысяч записей оборачивайте запись объектов в транзакцию разумного размера.

Запись и создание DBF-файлов из 1С

Обратная задача — выгрузить данные из 1С в DBF — решается тем же объектом XBase. Сначала формируется структура: в коллекцию Поля добавляются описания полей с типом, длиной и точностью. Затем вызывается метод СоздатьФайл(), после чего записи добавляются через Добавить() с заполнением значений полей.

Ограничения формата нужно учитывать заранее: имена полей ограничены по длине (классически до 10 символов), символьные поля усекаются до заданной длины, типов «строка неограниченной длины» в DBF нет. Если 1С-строка длиннее поля, она обрежется без предупреждения — проверяйте длины до записи.

Типичные ошибки и их устранение

Отдельная группа проблем — права доступа и пути. На сервере 1С файл должен быть доступен учётной записи агента сервера, а не пользователю клиента. Код, выполняемый на сервере, не увидит файл на локальном диске C: пользователя. Решение — передавать файл на сервер через временное хранилище или размещать его в сетевом каталоге, доступном серверу.

Часто задаваемые вопросы