Opret et velformateret Word-dokument i C# på macOS fra JSON

Dynamisk Word-dokumentgenerering fra JSON Data

Brug af en skabelonbaseret tilgang med pladsholdere, implementeret i C# til macOS i .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!");
    }
}

Generer Word-dokumenter programmatisk uden skabeloner

Brug af en ren kodebaseret tilgang med Open XML SDK i 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!");
    }
}

Almindelige spørgsmål om automatisering af Word-dokumenter

1. Hvad er det bedste bibliotek til at arbejde med Word-dokumenter i C#?
2. De Open XML SDK betragtes bredt som den mest robuste mulighed for at manipulere Word-dokumenter programmatisk.
3. Hvordan erstatter jeg pladsholdere i en Word-skabelon?
4. Du kan bruge Text.Replace at lokalisere og erstatte pladsholdere såsom {FirstName} med dynamisk indhold.
5. Hvad sker der, hvis min JSON-fil indeholder uventede data?
6. Bruger JsonConvert.DeserializeObject med validering sikrer, at dine JSON-data behandles korrekt, selvom de indeholder uventede felter.
7. Kan jeg tilføje billeder til mit Word-dokument programmatisk?
8. Ja, du kan integrere billeder vha ImagePart i Open XML SDK for at tilføje logoer eller fotos dynamisk.
9. Hvordan kan jeg sikre, at mit dokument matcher virksomhedens branding?
10. Forbered en forudformateret skabelon, der inkluderer brugerdefinerede typografier, skrifttyper og farver, som dit script kan bruge til at generere dokumenter.
11. Er det muligt at håndtere indlejrede JSON-data?
12. Du kan forbehandle JSON for at udjævne indlejrede objekter eller bruge loops til dynamisk at udfylde flere pladsholdere i Word-dokumentet.
13. Hvilken tilgang er bedre til komplekse dokumenter: skabeloner eller kodebaseret?
14. Skabeloner er generelt bedre til komplekse designs, mens kodebaserede tilgange er ideelle til enklere strukturer eller høj tilpasning.
15. Hvordan forhindrer jeg overskrivning af den originale skabelon?
16. Bruge File.Copy for at gemme outputtet som en ny fil, ved at bevare din originale skabelon.
17. Kan jeg generere flere Word-dokumenter på én gang?
18. Ja, du kan iterere over dine JSON-data og oprette et nyt dokument for hver indgang ved hjælp af en loop i dit script.
19. Hvad er den bedste IDE til denne arbejdsgang?
20. Mens du kan bruge Visual Studio eller Visual Studio Code, er sidstnævnte let og fungerer godt med macOS.

Udarbejdelse af dynamiske Word-dokumenter med JSON og C#

Den skabelonbaserede tilgang skiller sig ud for sin fleksibilitet og brugervenlighed, især til at skabe veldesignede, professionelle dokumenter. Ved at kombinere manuel formatering og automatiseret dataindsættelse kan du spare tid og samtidig bevare kvalitet og konsistens. 📝

Alternativt giver programgenerering af et Word-dokument fra bunden større tilpasning, men kræver mere indsats for detaljeret formatering. Med værktøjer som Open XML SDK er denne metode fremragende til ligetil eller gentagne dokumenter med minimale stiljusteringer. Vælg den metode, der passer til din arbejdsgang. 🚀