macOS 上の C# で JSON から適切にフォーマットされた Word ドキュメントを作成する

JSON データからの動的な Word ドキュメントの生成

プレースホルダーを使用したテンプレートベースのアプローチを使用し、.NET 8 の macOS 向け C# で実装

// 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 文書を生成する

C# の Open XML SDK による純粋なコードベースのアプローチの使用

// 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. C# で Word ドキュメントを操作するのに最適なライブラリは何ですか?
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 で適切に動作します。

JSON と C# を使用した動的な Word ドキュメントの作成

テンプレートベースのアプローチは、特に優れたデザインのプロフェッショナルなドキュメントを作成する場合に、その柔軟性と使いやすさで際立っています。手動フォーマットと自動データ挿入を組み合わせることで、品質と一貫性を維持しながら時間を節約できます。 📝

あるいは、プログラムによって Word 文書を最初から生成すると、カスタマイズ性が高まりますが、詳細な書式設定にはより多くの労力が必要になります。 Open XML SDK などのツールを使用すると、この方法は最小限のスタイル調整で単純なドキュメントや繰り返しのドキュメントに最適です。ワークフローに合った方法を選択してください。 🚀