🌭 🚣🏽 👨‍🏭 मुद्रण टेम्पलेट्स का निर्माण और प्रसंस्करण 🎽 🧠 👨🏾‍🚒

जैसा कि ईआरपी सिस्टम के साथ अभ्यास दिखाया गया है, कॉर्पोरेट अनुप्रयोगों में 30% रिपोर्ट शामिल हैं। ऐसे अनुप्रयोगों के लिए एक विशिष्ट स्थिति कुछ डेटा पर एक रिपोर्ट का निर्माण करना है।

रिपोर्ट बनाने के लिए, आप ReportBuilder या किसी अन्य रिपोर्टिंग सिस्टम का उपयोग कर सकते हैं। इस लेख में मैं असोस.वॉर्ड्स का उपयोग करके एमएस वर्ड 2003 (और बाद में) में रिपोर्ट बनाने पर विचार करना चाहता हूं, क्योंकि संपादन करना आसान है, विकसित करना सुविधाजनक है, रिपोर्टिंग सिस्टम दिग्गजों के साथ काम करने के लिए विशेष कौशल की आवश्यकता नहीं है, आदि।

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

इस समाधान का लाभ यह है कि जो व्यक्ति मुद्रित रूप को विकसित करता है, उसे SQL या डेटा स्रोतों का कोई ज्ञान नहीं हो सकता है। वह केवल एमएस ऑफिस वर्ड के साथ काम करने में सक्षम होना चाहिए। ऐसा लगता है कि सब कुछ सरल है , लेकिन हमारे मामले में यह माना जाता है कि:

एक रिपोर्ट टेम्प्लेट का निर्माण और रिपोर्ट स्वयं एक कंप्यूटर पर हो सकती है जहां एमएस ऑफिस स्थापित नहीं है। यह COM का उपयोग करने की क्षमता को काट देता है;
रिपोर्ट टेम्प्लेट डॉक्टर प्रारूप में हैं, डॉक्स नहीं, जो काफी सुविधाजनक होगा ;

समस्या का बयान

सर्वर पर जहां उत्पाद घूम रहा है - सुश्री वर्ड और अन्य जैसे इसे स्थापित नहीं किया जाना चाहिए
यह वर्ड 2003 होना चाहिए, धन्यवाद 95 नहीं
सुविधाजनक, और समस्या का सबसे महत्वपूर्ण त्वरित समाधान
रिपोर्ट टेम्प्लेट इतने सरल होने चाहिए कि वे अंतिम व्यावसायिक उपयोगकर्ता द्वारा बनाए जा सकें।

तो, कार्य स्पष्ट है, आगे बढ़ें।

मुद्रण रूपों के मुख्य तत्व साधारण डेटा फ़ील्ड और डेटा टेबल हैं। सुविधा के लिए, हम एक टेम्पलेट में फ़ील्ड्स के एक सेट के निर्माण और अलग-अलग तरीकों में एक टेबल के निर्माण को विभाजित करेंगे।

/// <summary>      </summary> /// <param name="additionalFields"> ///  -   ,  -    ///    (  ) /// </param> /// <returns>  </returns> public static MemoryStream CreateNewTemplate(Dictionary<string, string> additionalFields) { var doc = new Document(); var docBuilder = new DocumentBuilder(doc); docBuilder.MoveToDocumentEnd();//    ,       foreach (var field in additionalFields) { docBuilder.Font.Bold = true; docBuilder.InsertHtml(string.Format("{0}: ", field.Value)); docBuilder.Font.Bold = false; //  ,   -  ,  - ,   ,   Word docBuilder.InsertField(string.Format(@"MERGEFIELD {0} \* MERGEFORMAT", field.Key), field.Key); docBuilder.InsertHtml("<br>"); } var stream = new MemoryStream(); doc.Save(stream, SaveFormat.Doc); //      stream.Position = 0; return stream; } /// <summary>     </summary> /// <param name="stream">   </param> /// <param name="tableSysName">  (       )</param> /// <param name="additionalFields">   ( -   ,  -    ) </param> /// <param name="tableRusName">  </param> /// <returns>  </returns> public static MemoryStream AddTable(Stream stream, string tableSysName, Dictionary<string, string> additionalFields, string tableRusName) { var doc = new Document(stream); var docBuilder = new DocumentBuilder(doc); docBuilder.MoveToDocumentEnd(); docBuilder.Font.Bold = true; docBuilder.Font.Size = 14; docBuilder.Writeln(tableRusName); docBuilder.Font.Size = 12; docBuilder.StartTable(); docBuilder.InsertCell(); foreach (var field in additionalFields) { docBuilder.Writeln(field.Value); if (field.Key != additionalFields.Last().Key) { docBuilder.InsertCell(); } } docBuilder.EndRow(); docBuilder.Font.Bold = false; docBuilder.InsertCell(); docBuilder.InsertField(string.Format("MERGEFIELD TableStart:{0}", tableSysName), "{"); foreach (var field in additionalFields) { docBuilder.InsertField(string.Format(@"MERGEFIELD {0} \* MERGEFORMAT", field.Key), field.Key); if (field.Key != additionalFields.Last().Key) { docBuilder.InsertCell(); } } docBuilder.InsertField(string.Format("MERGEFIELD TableEnd:{0}", tableSysName), "}"); docBuilder.Writeln(); docBuilder.EndTable(); docBuilder.Writeln(); stream.Close(); var newStream = new MemoryStream(); doc.Save(newStream, SaveFormat.Doc); newStream.Position = 0; return newStream; }

लाइन पर ध्यान दें

 docBuilder.InsertField(string.Format("MERGEFIELD TableStart:{0}", tableSysName), "{");

यहां, बाहरी चिह्न "{" के साथ मुख्य फ़ील्ड टेबलस्टार्ट को तालिका में जोड़ा जाता है, यह प्रतीक महत्वपूर्ण नहीं है, यह सिर्फ बाहरी रूप से फॉर्म पर बहुत कम जगह लेता है। इसके अलावा, अंत में "}" अक्षर के साथ एक टेबलइंड जोड़ा जाता है। ये फ़ील्ड तालिका की समान पंक्ति में होनी चाहिए। उनके बीच संलग्न क्षेत्र वर्तमान तालिका को संदर्भित करते हैं और डेटा सेट के लिए दोहराया जाएगा। यही है, अगर आपको कई लाइनों पर डेटा की व्यवस्था करने की आवश्यकता है, तो आपको एक त्रुटि मिलती है।

लेकिन एक चाल है: आप तीन स्तंभों की एक तालिका जोड़ सकते हैं, पहले कॉलम में शुरुआती चरित्र, अंतिम कॉलम में समापन चरित्र, और मध्य कक्ष में एक और तालिका सम्मिलित कर सकते हैं, जिसमें डेटा को आपकी पसंद के अनुसार व्यवस्थित किया जा सकता है। प्रत्येक डेटा सेट के लिए सम्मिलित तालिका दोहराई जाएगी। डिफ़ॉल्ट रूप से, यह जोड़ा नहीं गया है, क्योंकि यह शायद ही कभी आवश्यक है (कम से कम उन उद्देश्यों के लिए जहां यह अब लागू होता है)।

टेम्पलेट बनाने के लिए ये दो विधियाँ पर्याप्त हैं। इसके अलावा, यह टेम्प्लेट कॉन्फ़िगर किया गया है (फोंट, लेआउट, आदि) - हम इसमें बहुत रुचि नहीं रखते हैं। यह केवल मार्कअप को बनाए रखते हुए, डेटा के साथ तैयार टेम्पलेट को भरने के लिए रहता है। उन फ़ील्ड को भरने के लिए जो तालिका में नहीं हैं, सब कुछ सरल है:

 /// <summary>    </summary> /// <param name="stream">   () </param> /// <param name="fieldsToFill">    ( -   ,  -   ) </param> /// <returns>  </returns> public static MemoryStream FillTemplate(Stream stream, Dictionary<string, string> fieldsToFill) { var doc = new Document(stream); var firstArray = fieldsToFill.Select(keys => keys.Key).ToArray(); var secondArray = fieldsToFill.Select(a => (object)a.Value).ToArray(); /*    object.   ,           .        ,   ,  IFieldMergingCallback,     . */ doc.MailMerge.Execute(firstArray, secondArray); var newStream = new MemoryStream(); doc.Save(newStream, SaveFormat.Doc); newStream.Position = 0; stream.Close(); return newStream; }

अब हम तालिकाओं को भरने के लिए आते हैं। असोज में, इस मुद्दे पर बहुत अच्छी तरह से संपर्क किया गया है, जैसा कि आप जल्द ही देखेंगे।

 /// <summary> ///   /// </summary> /// <param name="stream"> </param> /// <param name="tableSysName"> </param> /// <param name="tableValues">  </param> /// <returns> </returns> public static MemoryStream FillTable(Stream stream, string tableSysName, List<Dictionary<string, string>> tableValues) { var doc = new Document(stream); // ,  var customersDataSource = new CustomerMailMergeDataSource(tableValues.ToArray(), tableSysName); //    ,  IMailMergeDataSource,     doc.MailMerge.ExecuteWithRegions(customersDataSource); var newStream = new MemoryStream(); doc.Save(newStream, SaveFormat.Doc); newStream.Position = 0; stream.Close(); return newStream; }

यहाँ सब कुछ बहुत सरल है, लेकिन आइए एक नज़र डालते हैं:

  /// <summary>     </summary> internal class CustomerMailMergeDataSource : IMailMergeDataSource { /// <summary>   </summary> private readonly Dictionary<string, string>[] tableValue; /// <summary>   </summary> private int recordIndex; /// <summary>  </summary> /// <param name="data">  </param> /// <param name="tableName">  </param> public CustomerMailMergeDataSource(Dictionary<string, string>[] data, string tableName) { tableValue = data; recordIndex = -1; TableNamePrivate = tableName; } /// <summary>   </summary> public string TableName { get { return TableNamePrivate; } } /// <summary>    </summary> private static string TableNamePrivate { get; set; } /// <summary>   </summary> private bool IsEof { get { return recordIndex >= tableValue.Count(); } } /// <summary> Aspose.Words   ,      </summary> /// <param name="fieldName">   </param> /// <param name="fieldValue">     </param> /// <returns>       </returns> public bool GetValue(string fieldName, out object fieldValue) { var containsKey = tableValue[recordIndex].ContainsKey(fieldName); fieldValue = containsKey ? tableValue[recordIndex][fieldName] : null; return containsKey; } /// <summary>        </summary> /// <returns>    ,   false </returns> public bool MoveNext() { if (!IsEof) { recordIndex++; } return !IsEof; } /// <summary>    </summary> /// <param name="tableName"> </param> /// <returns>  </returns> public IMailMergeDataSource GetChildDataSource(string tableName) { return null; } }

यह सब एक आवश्यक न्यूनतम है। मार्कअप में परिवर्तन नहीं होते हैं, खाली फ़ील्ड (जिसके लिए कोई डेटा नहीं है) बस मुद्रित रूप में गायब हो जाते हैं। मानों के साथ फ़ील्ड भरते समय, आपको ऑब्जेक्ट पास करने की आवश्यकता होती है, लेकिन यहां स्ट्रिंग को हर जगह पास किया जाता है। सिद्धांत रूप में, आप किसी भी डेटा प्रकार को स्थानांतरित कर सकते हैं, और फिर, IFieldMergingCallback को लागू करने के बाद, डेटा को संसाधित और प्रारूपित कर सकते हैं।

आप एक doc.MailMerge.FieldMergingCallback हैंडलर उदाहरण निर्दिष्ट करके अपने हैंडलर को पेंच कर सकते हैं। यही है, आप संभावित रूप से कई हैंडलर बना सकते हैं, जिनकी आपको आवश्यकता है
सभी अवसरों और सभी डेटा सेट। कॉल के साथ हैंडलर के असाइनमेंट को doc.MailMerge.ExecuteWithRegions () में बदलकर , हम और अधिक लचीली प्रोसेसिंग प्राप्त करते हैं।

संभव प्रश्न

क्या यह एक विज्ञापन है? नहीं, यह विज्ञापन नहीं है, मैंने सिर्फ परिणाम साझा करने का फैसला किया है
वास्तव में क्यों? ऐसा ही हुआ। आवश्यकताओं के तहत सबसे अधिक उम्मीद है।
क्या यह काम करने का विकल्प है? नहीं, यह एक सरलीकृत संस्करण है। आप एक विशेष संस्करण कह सकते हैं वास्तव में, सब कुछ थोड़ा अधिक जटिल है।
कोड पर टिप्पणियां कहां हैं? मुझे कोड में टिप्पणियाँ काफी व्यापक लगीं।

यहाँ स्रोत हैं

मुद्रण टेम्पलेट्स का निर्माण और प्रसंस्करण

समस्या का बयान

तो, कार्य स्पष्ट है, आगे बढ़ें।

संभव प्रश्न

More articles: