Создайте хорошо отформатированный документ Word на C# в macOS из JSON.

Динамическое создание документов Word из данных JSON

Использование подхода на основе шаблонов с заполнителями, реализованного на C# для macOS в .NET 8.

// Import necessary libraries
using System;
using System.IO;
using Newtonsoft.Json;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
// Define the data model for employees
public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string DateOfBirth { get; set; }
}
// Main program
class Program
{
    static void Main(string[] args)
    {
        // Load JSON data
        string jsonFilePath = "employees.json";
        var employees = JsonConvert.DeserializeObject<List<Employee>>(File.ReadAllText(jsonFilePath));
        // Define template path and output path
        string templatePath = "template.docx";
        string outputPath = "output.docx";
        // Open the Word template
        using (var wordDoc = WordprocessingDocument.Open(templatePath, true))
        {
            var body = wordDoc.MainDocumentPart.Document.Body;
            // Replace placeholders
            foreach (var employee in employees)
            {
                foreach (var text in body.Descendants<Text>())
                {
                    text.Text = text.Text.Replace("{FirstName}", employee.FirstName)
                                          .Replace("{LastName}", employee.LastName)
                                          .Replace("{DateOfBirth}", employee.DateOfBirth);
                }
            }
        }
        // Save as a new file
        File.Copy(templatePath, outputPath, true);
        Console.WriteLine("Document generated successfully!");
    }
}

Программное создание документов Word без шаблонов

Использование подхода, основанного исключительно на коде, с Open XML SDK на C#.

// Import necessary libraries
using System;
using System.IO;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using Newtonsoft.Json;
// Define the data model for employees
public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string DateOfBirth { get; set; }
}
// Main program
class Program
{
    static void Main(string[] args)
    {
        // Load JSON data
        string jsonFilePath = "employees.json";
        var employees = JsonConvert.DeserializeObject<List<Employee>>(File.ReadAllText(jsonFilePath));
        // Define output path
        string outputPath = "output_from_code.docx";
        // Create Word document
        using (var wordDoc = WordprocessingDocument.Create(outputPath, DocumentFormat.OpenXml.WordprocessingDocumentType.Document))
        {
            // Add a main document part
            var mainPart = wordDoc.AddMainDocumentPart();
            mainPart.Document = new Document();
            var body = mainPart.Document.AppendChild(new Body());
            // Add content for each employee
            foreach (var employee in employees)
            {
                var para = body.AppendChild(new Paragraph());
                var run = para.AppendChild(new Run());
                run.AppendChild(new Text($"Name: {employee.FirstName} {employee.LastName}, DOB: {employee.DateOfBirth}"));
            }
        }
        Console.WriteLine("Document generated successfully!");
    }
}

Общие вопросы об автоматизации документов Word

1. Какая библиотека лучше всего подходит для работы с документами Word на C#?
2. Open XML SDK широко считается наиболее надежным вариантом программного управления документами Word.
3. Как заменить заполнители в шаблоне Word?
4. Вы можете использовать Text.Replace для поиска и замены заполнителей, таких как {FirstName}, динамическим содержимым.
5. Что произойдет, если мой файл JSON содержит непредвиденные данные?
6. С использованием JsonConvert.DeserializeObject с проверкой гарантирует, что ваши данные JSON будут обработаны правильно, даже если они содержат непредвиденные поля.
7. Могу ли я программно добавлять изображения в документ Word?
8. Да, вы можете вставлять изображения, используя ImagePart в Open XML SDK для динамического добавления логотипов или фотографий.
9. Как я могу гарантировать, что мой документ соответствует корпоративному брендингу?
10. Подготовьте предварительно отформатированный шаблон, включающий пользовательские стили, шрифты и цвета, которые ваш сценарий может использовать для создания документов.
11. Можно ли обрабатывать вложенные данные JSON?
12. Вы можете предварительно обработать JSON, чтобы сгладить вложенные объекты, или использовать циклы для динамического заполнения нескольких заполнителей в документе Word.
13. Какой подход лучше для сложных документов: шаблонный или на основе кода?
14. Шаблоны, как правило, лучше подходят для сложных проектов, тогда как подходы на основе кода идеально подходят для более простых структур или широких возможностей настройки.
15. Как предотвратить перезапись исходного шаблона?
16. Использовать File.Copy чтобы сохранить результат в новом файле, сохранив исходный шаблон.
17. Могу ли я создать несколько документов Word одновременно?
18. Да, вы можете перебирать данные JSON, создавая новый документ для каждой записи, используя цикл в вашем скрипте.
19. Какая IDE лучше всего подходит для этого рабочего процесса?
20. Хотя вы можете использовать Visual Studio или Visual Studio Code, последний легкий и хорошо работает с macOS.

Создание динамических документов Word с помощью JSON и C#

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

Альтернативно, программное создание документа Word с нуля обеспечивает большую настройку, но требует больше усилий для детального форматирования. С такими инструментами, как Open XML SDK, этот метод отлично подходит для простых или повторяющихся документов с минимальной корректировкой стиля. Выберите метод, который соответствует вашему рабочему процессу. 🚀