xBase в 1С: что это и как работать с DBF-файлами

xBase в 1С — это встроенный объект платформы, предназначенный для чтения и записи файлов формата DBF (dBase, FoxPro, Clipper). Объект позволяет программно открывать DBF-таблицы, перебирать записи, изменять поля, создавать новые файлы и строить индексы — всё это без внешних компонентов и драйверов, прямо из кода на встроенном языке 1С.

Формат DBF появился задолго до 1С и до сих пор встречается в обменах с государственными системами, банками, старым ПО и кассовым оборудованием. Если контрагент присылает прайс или реестр в DBF, а рядом лежит файл индексов CDX/MDX — работать с ним удобнее всего именно через объект xBase, а не через сторонние конвертеры.

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

Что представляет собой объект xBase и когда он нужен

Объект создаётся конструктором Новый XBase(ПутьКФайлу, ПутьКИндексам) и даёт доступ к записям таблицы последовательно или через поиск по индексу. Каждая запись — это набор полей, обращение к которым идёт по имени: БД.FAM, БД.SUMMA и так далее.

Типичные сценарии применения: загрузка классификаторов и справочников из внешних систем, приём реестров платежей из банков, выгрузка данных для налоговых и статистических программ, миграция данных из учётных систем на FoxPro при переходе на 1С. Во всех этих случаях DBF выступает промежуточным форматом, заданным внешней стороной, и повлиять на него нельзя.

Важно понимать: xBase — это не СУБД и не замена запросам 1С. Это низкоуровневый доступ к файлу. Никаких транзакций, ссылочной целостности и конкурентного доступа здесь нет. Если оба варианта возможны, для обмена между современными системами лучше выбрать XML, JSON или CSV — DBF оправдан только требованиями внешней стороны.

Как открыть и прочитать DBF-файл

Минимальный сценарий чтения выглядит так: создать объект, открыть файл, проверить, что записи есть, и пройти по ним в цикле. Перед чтением полезно проверить свойство КоличествоЗаписей() и факт успешного открытия.

БД = Новый XBase("C:\Обмен\sprav.dbf");
БД.Кодировка = КодировкаXBase.OEM;
Если Не БД.Открыта() Тогда
    Сообщить("Не удалось открыть файл");
    Возврат;
КонецЕсли;
БД.Первая();
Пока Не БД.ВКонце() Цикл
    Сообщить(Строка(БД.CODE) + " | " + БД.NAME);
    БД.Следующая();
КонецЦикла;
БД.ЗакрытьФайл();

Методы навигации: Первая(), Последняя(), Следующая(), Предыдущая(), Перейти(НомерЗаписи). Признаки границ — ВНачале() и ВКонце(). Пропуск проверки ВКонце() в условии цикла — частая причина зацикливания или обращения к несуществующей записи.

После работы файл нужно закрыть методом ЗакрытьФайл(). Пока файл открыт объектом xBase, он заблокирован: другой процесс не сможет его перезаписать, а повторное открытие из того же сеанса может дать ошибку.

Кодировка: главный источник «крякозябр»

DBF-файлы исторически хранят текст в однобайтовых кодировках. Российские файлы чаще всего идут в DOS-кодировке (OEM, CP866) или в Windows-ANSI (CP1251). Если кодировку не указать или указать неверно, русские буквы при чтении превратятся в нечитаемые символы.

За кодировку отвечает свойство Кодировка со значениями перечисления КодировкаXBase: OEM или ANSI. Устанавливать его нужно сразу после создания объекта, до чтения данных. Практический приём: если при OEM текст нечитаем — переключитесь на ANSI и наоборот; других вариантов у классического DBF почти нет.

Запись и изменение данных в DBF

Для изменения существующей записи используется связка: найти запись, присвоить полям новые значения, вызвать Записать(). Для добавления — Добавить(), заполнение полей, затем Записать(). Без вызова Записать() изменения не попадут в файл.

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

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

Создание нового DBF-файла и работа с индексами

Новый файл создаётся описанием структуры: через свойство Поля добавляют поля методом Добавить(Имя, Тип, Длина, Точность), затем вызывают СоздатьФайл(Путь). Типы указываются однобуквенно: «S» — строка, «N» — число, «D» — дата, «L» — логическое, «F» — число с плавающей точкой.

Индексы нужны для быстрого поиска методом Найти() и для сортировки. Индекс описывается через коллекцию Индексы (выражение, имя, уникальность) и создаётся методом СоздатьИндексныйФайл(Путь). При открытии существующего файла путь к индексному файлу передаётся вторым параметром конструктора.

1. 1
   Создайте объект: БД = Новый XBase() без параметров
2. 2
   Добавьте поля через БД.Поля.Добавить() с типами и длинами
3. 3
   При необходимости опишите индексы в БД.Индексы
4. 4
   Вызовите БД.СоздатьФайл() с указанием пути
5. 5
   Заполните записи: Добавить() → присвоить поля → Записать()
6. 6
   Вызовите СоздатьИндексныйФайл() и закройте файл

Ограничения формата и типичные ошибки

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

Даты в DBF не хранят время — только календарный день. Если в обмене критично время операции, его передают отдельным строковым или числовым полем. Логический тип имеет особенность: кроме «истина/ложь» там возможно третье состояние — неопределённое значение, что при невнимательной обработке даёт сюрпризы в условиях.

Альтернативы xBase и когда их выбрать

Если формат обмена не задан жёстко, DBF стоит рассматривать последним вариантом. Современные альтернативы проще в отладке и не имеют ограничений на длину строк и имена полей.

Вывод простой: xBase — инструмент выживания в мире унаследованных форматов, а не выбор по умолчанию. Но в своей нише он незаменим: ничего другого для нативной работы с DBF из кода 1С не требуется.

Частые вопросы