*। ग्रूवी स्क्रिप्टलेट्स का उपयोग कर डॉक टेम्प्लेट

मेरे एक प्रोजेक्ट में, मुझे क्लाइंट्स के लिए कॉन्ट्रैक्ट डॉक्युमेंट्स को अपने आप जेनरेट करना था। अनुबंध लगभग 10 पृष्ठों की लंबाई के साथ एक कानूनी दस्तावेज है और एक टेम्पलेट है: एक विशिष्ट ग्राहक का डेटा सही स्थानों पर प्रतिस्थापित किया जाता है।

कार्य

प्राथमिक आवश्यकताएं इस प्रकार थीं:
एक जटिल शैली में डॉक्टर या डॉक्टर दस्तावेज़ में, चिह्नित स्थानों में आवश्यक जानकारी प्रदर्शित करें।

उन्हें और परिष्कृत और विस्तारित किया गया:

• एक जटिल शैली वाले डॉक दस्तावेज़ में, चिह्नित स्थानों में डेटा प्रदर्शित करें।
• आउटपुट मार्कअप को स्क्रिप्टलेट की तरह दिखना चाहिए: ${}, <%%>, <%=%> ।
• आउटपुट डेटा एक ऑब्जेक्ट हो सकता है। खेतों तक पहुंचने की क्षमता चाहिए।
• आउटपुट के लिए, स्क्रिप्टिंग भाषाओं में से एक का उपयोग करें: ग्रूवी, जावास्क्रिप्ट।
• तालिकाओं में वस्तुओं की सूची प्रदर्शित करने में सक्षम होना आवश्यक है, प्रत्येक सेल में फ़ील्ड प्रदर्शित करना।

मौजूदा समाधान

यह पता चला कि क्षेत्र में उपलब्ध उत्पाद (मैं जावा प्लेटफ़ॉर्म के बारे में बात कर रहा हूं) कार्य को हल नहीं करते हैं। नीचे उत्पादों का संक्षिप्त विवरण दिया गया है:

जैस्पर की रिपोर्ट

जैसा कि एक टेम्पलेट xml मार्कअप फ़ाइल * .jrxml का उपयोग करता है। दस्तावेज़ मार्कअप फ़ाइल + डेटा (डेटाबेस और मैप पैरामीटर दोनों से) प्रोसेसर को दिया जाता है, जो निम्न में से किसी भी प्रारूप को उत्पन्न करता है: पीडीएफ, एक्सएमएल, एचटीएमएल, सीएसवी, एक्सएलएस, आरटीएफ, TXT।
सूट नहीं किया:

• यह WYSIWYG नहीं है, यहां तक ​​कि iReport के साथ, jrxml फ़ाइलों को बनाने के लिए एक दृश्य उपकरण।
• एक जटिल टेम्पलेट बनाने और स्टाइल करने के लिए आपको जैस्पररीपोर्ट्स एपीआई का अच्छी तरह से अध्ययन करने की आवश्यकता है।
• वांछित प्रारूप में प्रदर्शित नहीं करता है। आप पीडीएफ भी कर सकते हैं, लेकिन मैं बाद में आउटपुट दस्तावेज़ को संपादित करने में सक्षम होना चाहूंगा।

Docx4java

जावा-एपीआई का उपयोग करते हुए डॉक्सएक्स, पीपीएक्स-, एक्सएलएक्स-दस्तावेजों के घटकों में हेरफेर करने के लिए एक उपकरण।
सूट नहीं किया:

• Docx4Java के लिए प्रलेखन में मेरी आवश्यकताओं के मिलान का कोई मामला नहीं है। XMLUtils.unmarshallFromTemplate फ़ंक्शन का एक संक्षिप्त उल्लेख है, जो सबसे सरल प्रतिस्थापन करता है।
• आउटपुट पुनरावृत्ति प्रसंस्करण XML स्रोतों के माध्यम से XPath, लिंक का उपयोग करके कार्यान्वित किया जाता है।

अपाचे POI

जावा एपीआई का उपयोग करते हुए डॉक्टर, पीपीटी-, xls- दस्तावेजों के घटकों में हेरफेर करने के लिए एक उपकरण। मूल रूप से इन प्रारूपों के दस्तावेजों से डेटा प्राप्त करने के लिए बनाया गया है।
सूट नहीं किया:

• कार्य का कोई हल नहीं है।

समस्या हल करना

यह दिलचस्प था :)

1. दस्तावेज़ की सामग्री को एक ज़िप संग्रह में संपीड़ित xml के रूप में संग्रहीत किया जाता है। पारंपरिक JDK 6 ज़िप स्पष्ट एन्कोडिंग (जाहिरा तौर पर फ़ाइल नाम) का समर्थन नहीं करता है, क्योंकि अनपैक करना मुश्किल है। जब यह संग्रह करने के लिए पीटा docx निकला। सामग्री पैक करते समय मुझे संबंधित पैरामीटर के साथ Groovy AntBuilder आवरण वर्ग का उपयोग करना पड़ा।

2. एमएस वर्ड में दर्ज किए गए किसी भी टेक्स्ट को प्रोग्राम द्वारा टुकड़ों में तोड़ा जा सकता है और xml टैग के अलग-अलग समूहों में डाला जा सकता है। इस प्रकार, मुझे पहले टेम्पलेट को xml गैसकेट से सफाई करने की समस्या को हल करना था। इस कार्य के लिए मैंने regex अभिव्यक्तियों का उपयोग किया, वे मुझे SAX पार्सर की तुलना में अधिक तेज़ लग रहे थे (हालाँकि मैंने प्रदर्शन को नहीं मापा था)।

3. मैंने अपनी सादगी, जावा प्रकृति और कोर में शामिल टेम्पलेट प्रोसेसर की वजह से ग्रूवी को एक स्क्रिप्टिंग भाषा के रूप में उपयोग करने का फैसला किया। उसे भी दिलचस्प कठिनाइयाँ हुईं। यह पता चला कि 10-शीट वाले छोटे दस्तावेज़ में भी, आप आसानी से दो स्क्रिप्ट के बीच की रेखा की सीमा पर चल सकते हैं। मुझे उन सभी टेक्स्ट को बदलना पड़ा जो UUID स्ट्रिंग्स के साथ स्क्रिप्टलेट्स के बीच जाते हैं, Groovy टेम्पलेट प्रोसेसर चलाते हैं, और केवल बाहर निकलने पर UUID स्ट्रिंग्स को मूल XML टुकड़ों से बदल देते हैं।

इन कठिनाइयों को पार करते हुए, मैंने वास्तविक जीवन में परियोजना की कोशिश की। यह अच्छी तरह से निकला!

मैंने एक अंग्रेजी-भाषा परियोजना स्थल बनाया और इसे प्रकाशित किया।
परियोजना का पता: snowindy.github.com/scriptlet4docx

एपीआई उपयोग उदाहरण

 HashMap<String, Object> params = new HashMap<String, Object>(); params.put("name", "John"); params.put("sirname", "Smith"); DocxTemplater docxTemplater = new DocxTemplater(new File("path_to_docx_template/template.docx")); docxTemplater.process(new File("path_to_result_docx/result.docx"), params); 

आप परियोजना वेबसाइट पर आपको संबोधित कर यहां समाप्त कर सकते हैं ...
लेकिन समझ में सुधार करने के लिए, मैं "स्क्रिप्टलेट प्रकार स्पष्टीकरण" के सबसे दिलचस्प खंड का अनुवाद करूंगा।

स्क्रिप्टलेट के प्रकार, अधिक विवरण

डिस्क्लेमर: टेम्प्लेट के साथ काम करते समय, ग्रूवी टेम्पलेट प्रोसेसर ग्रूवी कोड में सभी स्क्रिप्टलेट का अनुवाद करता है, और स्क्रिप्ट के बीच का पाठ इस तरह प्रदर्शित होता है: out.print('template_text')

$ {डेटा}

डेटा आउट करने के लिए समतुल्य: out.print(data)

<% = डेटा%>

डेटा आउट करने के लिए समतुल्य: out.print(data)

<% any_code%>

किसी स्क्रिप्ट के अंदर निष्पादन कोड कुछ भी प्रदर्शित नहीं करता है। यह सशर्त उत्पादन के लिए इस्तेमाल किया जा सकता है:

 <% if (cond) { %>    ,  "cond == true" <% } else { %>    ,  "cond != true" <% } %> 

$ [@ listVar.field]

यह सबसे दिलचस्प तरह की पटकथा है! इसका उपयोग एक डॉक्स दस्तावेज़ के अंदर एक तालिका में वस्तुओं की सूची प्रदर्शित करने के लिए किया जाता है। एक टेबल सेल के अंदर इस्तेमाल किया जाना चाहिए।
उदाहरण के लिए, हमारे पास व्यक्तिगत वस्तुओं की एक सूची है। ऑब्जेक्ट के दो फ़ील्ड हैं: 'नाम' और 'एड्रेस'। हम दो स्तंभों की तालिका में एक सूची प्रदर्शित करना चाहते हैं।

1. इनपुट वैल्यू मैप में 'personList' पैरामीटर बनाना ऑब्जेक्ट्स की सूची को संदर्भित करता है।
2. डॉक्स दस्तावेज़ में दो कॉलम और एक पंक्ति के साथ एक तालिका बनाना।
3. पहली सेल में $[@person.name] दर्ज किया जाना चाहिए; $[@person.address] - दूसरे में।
4. सब कुछ तैयार है, व्यक्ति सूची सूची तालिका में मुद्रित की जाएगी।

लाइव टेम्पलेट उदाहरण

यहाँ झूठ: लिंक ।

परियोजना का विकास

अगर मैंने वास्तव में डॉक्स टेम्प्लेट के प्रसंस्करण के लिए एक नया दृष्टिकोण का आविष्कार किया है, तो मैं इसे लोकप्रिय बनाना चाहूंगा।
परियोजना के लिए प्रयास करने के लिए बहुत कुछ है:

• पूर्ण कैशिंग
• सूचियों में स्क्रिप्ट समर्थन
• स्ट्रीमिंग एपीआई को लागू करें

मुझे अंग्रेजी बोलने वाले दर्शकों में परियोजना के वितरण में सलाह देने में खुशी होगी!