Чтение и запись файлов DBF

Aspose.Cells обеспечивает полную поддержку чтения и записи файлов DBF (dBASE). Вы можете загружать существующие файлы dBASE III и dBASE IV в объект Workbook, обрабатывать данные с помощью многофункционального API Aspose.Cells и сохранять рабочую книгу обратно в формат DBF для использования с устаревшими приложениями баз данных.

Введение

DBF (DataBase File) — это устаревший формат файлов баз данных, первоначально представленный dBASE в начале 1980-х годов. Несмотря на возраст формата, файлы DBF по-прежнему широко используются во многих отраслях для хранения структурированных данных, особенно в бухгалтерском учёте, ГИС и других специализированных приложениях. Aspose.Cells позволяет легко интегрировать эти устаревшие файлы в современные рабочие процессы с электронными таблицами на Node.js via C++.

Библиотека поддерживает как чтение, так и запись файлов DBF, предоставляя вам возможность:

Импортировать данные из существующих файлов DBF в объекты Workbook Aspose.Cells для дальнейшей обработки или преобразования в другие форматы.
Создавать новые файлы DBF с нуля или путём преобразования данных из других форматов электронных таблиц.
Сохранять определения полей, типы данных и структуры записей при передаче данных в формат DBF и обратно.

Файлы DBF также можно открывать непосредственно в Microsoft Excel и других приложениях для работы с электронными таблицами, что делает их удобным мостом между устаревшими системами и современными инструментами для работы с электронными таблицами.

Поддерживаемые версии DBF и функции

Aspose.Cells поддерживает следующие версии формата DBF:

dBASE III — оригинальный и наиболее широко поддерживаемый вариант формата DBF.
dBASE IV — расширенная версия, которая поддерживает дополнительные типы данных и поля большего размера.

Поддерживаемые функции

Библиотека обеспечивает комплексную поддержку следующих операций:

Чтение данных DBF в объект Workbook с сохранением всех записей и определений полей.
Запись данных рабочей книги обратно в формат DBF для экспорта в приложения, совместимые с dBASE.
Обработка распространённых типов данных, используемых в файлах DBF, включая символьные, числовые, поля дат и логические поля.
Сохранение определений полей, таких как имя поля, тип и длина, во время операций чтения/записи.

Ограничения и особенности

При работе с файлами DBF учитывайте следующие ограничения:

Максимальное количество полей в файле — 128.
Максимальный размер записи — 4000 байт.
Имена полей ограничены 10 символами, должны быть в верхнем регистре и не могут содержать пробелов.
Значения дат в файлах DBF хранятся в формате YYYYMMDD.
Кодировка символов может различаться в зависимости от исходного приложения (обычно Windows-1252 или OEM-кодировки).

Чтение файла DBF

Aspose.Cells упрощает загрузку данных из файла DBF в объект Workbook. Библиотека использует класс LoadOptions для указания исходного формата, обеспечивая правильную интерпретацию данных в процессе загрузки.

Чтение файла DBF с помощью Aspose.Cells

Чтобы прочитать файл DBF, необходимо создать экземпляр LoadOptions, установить его свойство LoadFormat в значение LoadFormat.Dbf и передать его в конструктор Workbook вместе с путём к файлу. После загрузки данные становятся доступными через коллекцию Worksheets, где вы можете перебирать ячейки, извлекать значения или обрабатывать данные по мере необходимости.

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

let sb = "";

const maxRow = cells.getMaxDataRow();
const maxCol = cells.getMaxDataColumn();

for (let i = 0; i <= maxRow; i++)
{
    for (let j = 0; j <= maxCol; j++)
    {
        const cell = cells.get(i, j);
        const value = cell.getStringValue();
        sb += "|" + value;
    }
    sb += "|" + "\n";
}

console.log(sb);

const outputPath = path.join(dataDir, "output.xlsx");
workbook.save(outputPath, AsposeCells.SaveFormat.Xlsx);

console.log("DBF file loaded successfully. Converted XLSX saved at: " + outputPath);

Вы можете открывать файлы DBF непосредственно в Microsoft Excel, выбрав файл в диалоговом окне открытия. Excel будет рассматривать файл DBF как электронную таблицу, отображая его записи в табличном виде. Это полезно для быстрой проверки данных после чтения или записи с помощью Aspose.Cells.

Запись файла DBF

Запись данных в файл DBF следует тому же шаблону, что и сохранение любого другого формата электронных таблиц с помощью Aspose.Cells. Вы создаёте или загружаете Workbook, заполняете рабочий лист данными, а затем вызываете метод save, указывая SaveFormat.Dbf в качестве целевого формата.

Запись файла DBF с помощью Aspose.Cells

Чтобы создать файл DBF, выполните следующие шаги:

Создайте новый экземпляр Workbook.
Получите доступ к первому рабочему листу из коллекции Worksheets.
Заполните рабочий лист данными, включая заголовки в первой строке и записи в последующих строках.
Вызовите метод workbook.save, передав путь к файлу и SaveFormat.Dbf в качестве параметров.

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

const AsposeCells = require("aspose.cells");
const path = require("path");
const fs = require("fs");

const outputDir = "C:\\Output\\";
const filePath = path.join(outputDir, "output.dbf");

if (!fs.existsSync(outputDir)) {
    fs.mkdirSync(outputDir, { recursive: true });
}

const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
const cells = worksheet.getCells();

// Заголовки столбцов
cells.get(0, 0).putValue("ID");
cells.get(0, 1).putValue("Name");
cells.get(0, 2).putValue("Department");
cells.get(0, 3).putValue("Salary");
cells.get(0, 4).putValue("HireDate");

// Строка данных 1
cells.get(1, 0).putValue(101);
cells.get(1, 1).putValue("John Smith");
cells.get(1, 2).putValue("Engineering");
cells.get(1, 3).putValue(75000.50);
cells.get(1, 4).putValue(new Date(2020, 2, 15));

// Строка данных 2
cells.get(2, 0).putValue(102);
cells.get(2, 1).putValue("Jane Doe");
cells.get(2, 2).putValue("Marketing");
cells.get(2, 3).putValue(68000.75);
cells.get(2, 4).putValue(new Date(2019, 6, 22));

// Строка данных 3
cells.get(3, 0).putValue(103);
cells.get(3, 1).putValue("Bob Johnson");
cells.get(3, 2).putValue("Finance");
cells.get(3, 3).putValue(82000.00);
cells.get(3, 4).putValue(new Date(2021, 0, 10));

// Строка данных 4
cells.get(4, 0).putValue(104);
cells.get(4, 1).putValue("Alice Brown");
cells.get(4, 2).putValue("Human Resources");
cells.get(4, 3).putValue(71000.25);
cells.get(4, 4).putValue(new Date(2018, 10, 5));

// Строка данных 5
cells.get(5, 0).putValue(105);
cells.get(5, 1).putValue("Charlie Wilson");
cells.get(5, 2).putValue("Operations");
cells.get(5, 3).putValue(79500.80);
cells.get(5, 4).putValue(new Date(2022, 4, 30));

// Установка ширины столбцов для лучшей читаемости
worksheet.getCells().setColumnWidth(0, 8);
worksheet.getCells().setColumnWidth(1, 20);
worksheet.getCells().setColumnWidth(2, 20);
worksheet.getCells().setColumnWidth(3, 12);
worksheet.getCells().setColumnWidth(4, 14);

workbook.save(filePath, AsposeCells.SaveFormat.Dbf);

При записи данных в файл DBF убедитесь, что ваши данные соответствуют ограничениям формата. Имена полей не должны превышать 10 символов и не должны содержать пробелов. Записи, превышающие 4000 байт в общей сложности, не будут сохранены корректно. Даты должны быть допустимыми значениями дат, которые могут быть представлены в формате YYYYMMDD.

Особенности типов данных и форматирования

При передаче данных между Aspose.Cells и форматом DBF важно понимать, как типы данных сопоставляются между двумя системами, чтобы обеспечить целостность данных.

Типы ячеек и типы полей DBF

Значения ячеек Aspose.Cells автоматически преобразуются в соответствующие типы полей DBF при сохранении:

Строки сопоставляются с символьными (C) полями.
Числовые значения (целые числа и десятичные дроби) сопоставляются с числовыми (N) полями.
Значения дат сопоставляются с полями даты (D) в формате YYYYMMDD.
Логические значения сопоставляются с логическими (L) полями.

Кодировка

Файлы DBF могут использовать различные кодировки символов в зависимости от приложения, которое их создало. Aspose.Cells обрабатывает кодировку прозрачно в большинстве случаев, но если у вас возникают проблемы с отображением символов, возможно, потребуется проверить кодировку исходного файла.

Правила именования полей

Имена полей DBF должны соответствовать следующим правилам:

Максимальная длина — 10 символов.
Должны начинаться с буквы.
Не должны содержать пробелов или специальных символов.
Сохраняются в верхнем регистре независимо от регистра, использованного при вводе.

Проверка результата

После записи файла DBF вы можете проверить результат, открыв его в Microsoft Excel или любом другом приложении, совместимом с dBASE. Данные должны отображаться в табличном виде с именами полей в качестве заголовков столбцов и записями, заполненными в соответствии с предоставленными вами данными.

Преобразование между DBF и другими форматами

Одним из наиболее практичных вариантов использования чтения и записи файлов DBF с помощью Aspose.Cells является преобразование данных между форматом DBF и современными форматами электронных таблиц, такими как XLSX, XLS или CSV. Поскольку Aspose.Cells поддерживает широкий спектр форматов, вы можете легко загрузить файл DBF и сохранить его в любом другом поддерживаемом формате или наоборот.

Например, вы можете прочитать файл DBF, применить форматирование или вычисления с помощью API Aspose.Cells, а затем сохранить результат в виде файла XLSX для распространения среди пользователей, работающих с современными приложениями для работы с электронными таблицами. И наоборот, вы можете взять данные из файла XLSX или CSV и экспортировать их в формат DBF для интеграции с устаревшими системами.

Конвертация Excel в CSV, TSV и Txt через Node.js с помощью C++ Pdf с Node.js через C++