Lag et godt formatert Word-dokument i C# på macOS fra JSON

Dynamisk Word-dokumentgenerering fra JSON Data

Bruke en malbasert tilnærming med plassholdere, implementert i C# for 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 uten maler

Bruk av en ren kodebasert tilnærming 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!");
    }
}

Vanlige spørsmål om automatisering av Word-dokumenter

1. Hva er det beste biblioteket for å jobbe med Word-dokumenter i C#?
2. De Open XML SDK er allment ansett som det mest robuste alternativet for å manipulere Word-dokumenter programmatisk.
3. Hvordan erstatter jeg plassholdere i en Word-mal?
4. Du kan bruke Text.Replace for å finne og erstatte plassholdere som {FirstName} med dynamisk innhold.
5. Hva skjer hvis JSON-filen min inneholder uventede data?
6. Bruker JsonConvert.DeserializeObject med validering sikrer at JSON-dataene dine behandles riktig, selv om de inneholder uventede felt.
7. Kan jeg legge til bilder i Word-dokumentet mitt programmatisk?
8. Ja, du kan legge inn bilder ved hjelp av ImagePart i Open XML SDK for å legge til logoer eller bilder dynamisk.
9. Hvordan kan jeg sikre at dokumentet mitt samsvarer med bedriftens merkevarebygging?
10. Forbered en forhåndsformatert mal som inkluderer egendefinerte stiler, fonter og farger, som skriptet ditt kan bruke til å generere dokumenter.
11. Er det mulig å håndtere nestede JSON-data?
12. Du kan forhåndsbehandle JSON for å flate sammen nestede objekter eller bruke løkker til dynamisk å fylle ut flere plassholdere i Word-dokumentet.
13. Hvilken tilnærming er bedre for komplekse dokumenter: maler eller kodebasert?
14. Maler er generelt bedre for komplekse design, mens kodebaserte tilnærminger er ideelle for enklere strukturer eller høy tilpasning.
15. Hvordan forhindrer jeg overskriving av den originale malen?
16. Bruk File.Copy for å lagre utdataene som en ny fil, og bevare den opprinnelige malen.
17. Kan jeg generere flere Word-dokumenter samtidig?
18. Ja, du kan iterere over JSON-dataene dine, og lage et nytt dokument for hver oppføring ved å bruke en løkke i skriptet ditt.
19. Hva er den beste IDE for denne arbeidsflyten?
20. Mens du kan bruke Visual Studio eller Visual Studio Code, er sistnevnte lett og fungerer godt med macOS.

Lage dynamiske Word-dokumenter med JSON og C#

Den malbaserte tilnærmingen skiller seg ut for sin fleksibilitet og brukervennlighet, spesielt for å lage godt utformede, profesjonelle dokumenter. Ved å kombinere manuell formatering og automatisert datainnsetting kan du spare tid samtidig som du opprettholder kvalitet og konsistens. 📝

Alternativt kan programgenerering av et Word-dokument fra bunnen av tilby større tilpasning, men krever mer innsats for detaljert formatering. Med verktøy som Open XML SDK er denne metoden utmerket for enkle eller repeterende dokumenter med minimale stiljusteringer. Velg metoden som passer med arbeidsflyten din. 🚀