मेल मर्ज में दस्तावेज़ डालें

परिचय

Aspose.Words for .NET के साथ दस्तावेज़ स्वचालन की दुनिया में आपका स्वागत है! क्या आपने कभी सोचा है कि मेल मर्ज ऑपरेशन के दौरान मुख्य दस्तावेज़ के भीतर विशिष्ट फ़ील्ड में दस्तावेज़ों को गतिशील रूप से कैसे सम्मिलित किया जाए? खैर, आप सही जगह पर हैं। यह ट्यूटोरियल आपको Aspose.Words for .NET का उपयोग करके मेल मर्ज फ़ील्ड में दस्तावेज़ सम्मिलित करने की प्रक्रिया के माध्यम से चरण-दर-चरण मार्गदर्शन करेगा। यह एक पहेली को एक साथ जोड़ने जैसा है, जहाँ प्रत्येक टुकड़ा पूरी तरह से अपनी जगह पर आ जाता है। तो, चलिए शुरू करते हैं!

आवश्यक शर्तें

आरंभ करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित हैं:

  1. .NET के लिए Aspose.Words: आप कर सकते हैंडाउनलोड का नवीनतम संस्करण यहां यदि आपको लाइसेंस खरीदने की आवश्यकता है, तो आप ऐसा कर सकते हैंयहाँ वैकल्पिक रूप से, आप एक प्राप्त कर सकते हैंअस्थायी लाइसेंस या इसे आज़माएँमुफ्त परीक्षण.
  2. विकास वातावरण: विजुअल स्टूडियो या कोई अन्य C# IDE.
  3. C# का बुनियादी ज्ञान: C# प्रोग्रामिंग से परिचित होने से यह ट्यूटोरियल आसान हो जाएगा।

नामस्थान आयात करें

सबसे पहले, आपको आवश्यक नेमस्पेस आयात करने की आवश्यकता होगी। ये आपके प्रोजेक्ट के निर्माण खंड की तरह हैं।

using System;
using Aspose.Words;
using Aspose.Words.MailMerging;
using System.Linq;

आइए इस प्रक्रिया को प्रबंधनीय चरणों में विभाजित करें। प्रत्येक चरण पिछले चरण पर आधारित होगा, जो आपको पूर्ण समाधान की ओर ले जाएगा।

चरण 1: अपनी निर्देशिका स्थापित करना

इससे पहले कि आप दस्तावेज़ डालना शुरू करें, आपको अपने दस्तावेज़ निर्देशिका का पथ परिभाषित करना होगा। यह वह जगह है जहाँ आपके दस्तावेज़ संग्रहीत हैं।

string dataDir = "YOUR DOCUMENT DIRECTORY";

चरण 2: मुख्य दस्तावेज़ लोड करना

इसके बाद, आप मुख्य दस्तावेज़ लोड करेंगे। इस दस्तावेज़ में मर्ज फ़ील्ड शामिल हैं जहाँ अन्य दस्तावेज़ डाले जाएँगे।

Document mainDoc = new Document(dataDir + "Document insertion 1.docx");

चरण 3: फ़ील्ड मर्जिंग कॉलबैक सेट करना

मर्जिंग प्रक्रिया को संभालने के लिए, आपको कॉलबैक फ़ंक्शन सेट करना होगा। यह फ़ंक्शन निर्दिष्ट मर्ज फ़ील्ड में दस्तावेज़ डालने के लिए ज़िम्मेदार होगा।

mainDoc.MailMerge.FieldMergingCallback = new InsertDocumentAtMailMergeHandler();

चरण 4: मेल मर्ज निष्पादित करना

अब मेल मर्ज को निष्पादित करने का समय आ गया है। यहीं पर जादू होता है। आप मर्ज फ़ील्ड और उस दस्तावेज़ को निर्दिष्ट करेंगे जिसे इस फ़ील्ड में डाला जाना चाहिए।

mainDoc.MailMerge.Execute(new[] { "Document_1" }, new object[] { dataDir + "Document insertion 2.docx" });

चरण 5: दस्तावेज़ को सहेजना

मेल मर्ज पूरा होने के बाद, आप संशोधित दस्तावेज़ को सहेज लेंगे। इस नए दस्तावेज़ में सम्मिलित सामग्री ठीक वहीं होगी जहाँ आप चाहते हैं।

mainDoc.Save(dataDir + "CloneAndCombineDocuments.InsertDocumentAtMailMerge.doc");

चरण 6: कॉलबैक हैंडलर बनाना

कॉलबैक हैंडलर एक ऐसा वर्ग है जो मर्ज फ़ील्ड के लिए विशेष प्रोसेसिंग करता है। यह फ़ील्ड मान में निर्दिष्ट दस्तावेज़ को लोड करता है और उसे वर्तमान मर्ज फ़ील्ड में सम्मिलित करता है।

private class InsertDocumentAtMailMergeHandler : IFieldMergingCallback
{
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (args.DocumentFieldName == "Document_1")
        {
            DocumentBuilder builder = new DocumentBuilder(args.Document);
            builder.MoveToMergeField(args.DocumentFieldName);

            Document subDoc = new Document((string)args.FieldValue);
            InsertDocument(builder.CurrentParagraph, subDoc);

            if (!builder.CurrentParagraph.HasChildNodes)
                builder.CurrentParagraph.Remove();

            args.Text = null;
        }
    }
}

चरण 7: दस्तावेज़ सम्मिलित करना

यह विधि निर्दिष्ट दस्तावेज़ को वर्तमान पैराग्राफ़ या तालिका सेल में सम्मिलित करती है।

private static void InsertDocument(Node insertionDestination, Document docToInsert)
{
    if (insertionDestination.NodeType == NodeType.Paragraph || insertionDestination.NodeType == NodeType.Table)
    {
        CompositeNode destinationParent = insertionDestination.ParentNode;
        NodeImporter importer = new NodeImporter(docToInsert, insertionDestination.Document, ImportFormatMode.KeepSourceFormatting);

        foreach (Section srcSection in docToInsert.Sections.OfType<Section>())
        foreach (Node srcNode in srcSection.Body)
        {
            if (srcNode.NodeType == NodeType.Paragraph)
            {
                Paragraph para = (Paragraph)srcNode;
                if (para.IsEndOfSection && !para.HasChildNodes)
                    continue;
            }

            Node newNode = importer.ImportNode(srcNode, true);
            destinationParent.InsertAfter(newNode, insertionDestination);
            insertionDestination = newNode;
        }
    }
    else
    {
        throw new ArgumentException("The destination node should be either a paragraph or table.");
    }
}

निष्कर्ष

और अब यह हो गया! आपने Aspose.Words for .NET का उपयोग करके मेल मर्ज ऑपरेशन के दौरान विशिष्ट फ़ील्ड में सफलतापूर्वक दस्तावेज़ डाले हैं। यह शक्तिशाली सुविधा आपको बहुत समय और प्रयास बचा सकती है, खासकर जब बड़ी मात्रा में दस्तावेज़ों से निपटना हो। इसे एक निजी सहायक के रूप में सोचें जो आपके लिए सभी भारी कामों का ध्यान रखता है। तो, आगे बढ़ें और इसे आज़माएँ। हैप्पी कोडिंग!

अक्सर पूछे जाने वाले प्रश्न

क्या मैं विभिन्न मर्ज फ़ील्ड में एकाधिक दस्तावेज़ सम्मिलित कर सकता हूँ?

हाँ, आप कर सकते हैं। बस उपयुक्त मर्ज फ़ील्ड और संबंधित दस्तावेज़ पथ निर्दिष्ट करेंMailMerge.Execute तरीका।

क्या सम्मिलित दस्तावेज़ को मुख्य दस्तावेज़ से भिन्न स्वरूपित करना संभव है?

बिल्कुल! आप इसका उपयोग कर सकते हैंImportFormatMode पैरामीटर मेंNodeImporter स्वरूपण को नियंत्रित करने के लिए.

यदि मर्ज फ़ील्ड का नाम गतिशील हो तो क्या होगा?

आप गतिशील मर्ज फ़ील्ड नामों को कॉलबैक हैंडलर में पैरामीटर के रूप में पास करके उन्हें संभाल सकते हैं।

क्या मैं इस विधि का उपयोग विभिन्न फ़ाइल स्वरूपों के साथ कर सकता हूँ?

हां, Aspose.Words DOCX, PDF, आदि सहित विभिन्न फ़ाइल स्वरूपों का समर्थन करता है।

दस्तावेज़ प्रविष्टि प्रक्रिया के दौरान मैं त्रुटियों को कैसे संभालूँ?

किसी भी संभावित अपवाद को प्रबंधित करने के लिए अपने कॉलबैक हैंडलर में त्रुटि प्रबंधन को कार्यान्वित करें।