👎🏼 🕍 👩‍💼 Excel में डेटा अनलोड करें। सभ्य बनाना 😔 🏉 ☝🏿

आईटी उद्योग में ऐसे कार्य हैं जो बड़े डेटा , मशीन लर्निंग , ब्लॉकचेन और अन्य फैशन रुझानों में सफलताओं की पृष्ठभूमि के खिलाफ हैं, पूरी तरह से बदसूरत दिखते हैं, लेकिन दशकों तक डेवलपर्स की एक पूरी सेना के लिए प्रासंगिक नहीं रह गए हैं। यह एक्सेल-दस्तावेजों को बनाने और अपलोड करने के विश्व कार्य के रूप में पुराने के बारे में होगा, जिन्होंने उन सभी का सामना किया, जिन्होंने कभी व्यापार के लिए आवेदन लिखे हैं।

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

VBA मैक्रोज़। आजकल, सुरक्षा कारणों से, मैक्रोज़ का उपयोग करने का विचार सबसे उपयुक्त नहीं है।
एपीआई के माध्यम से बाहरी कार्यक्रम के साथ एक्सेल स्वचालन। एक्सेल रिपोर्ट बनाने वाले प्रोग्राम के रूप में उसी मशीन पर एक्सेल की आवश्यकता होती है। ऐसे समय में जब क्लाइंट मोटे थे और डेस्कटॉप विंडोज अनुप्रयोगों के रूप में लिखे गए थे, यह विधि उपयुक्त थी (हालांकि यह गति और विश्वसनीयता में भिन्न नहीं थी), वर्तमान वास्तविकताओं में यह शायद ही एक प्राप्त करने योग्य मामला है।
XML- एक्सेल फाइल को सीधे जनरेट करें। जैसा कि आप जानते हैं, Excel दस्तावेज़ को सहेजने के लिए XML प्रारूप का समर्थन करता है, जो कि XML के साथ काम करने के किसी भी माध्यम का उपयोग करके संभावित रूप से उत्पन्न / संशोधित किया जा सकता है। इस फ़ाइल को एक्सटेंशन .xls के साथ सहेजा जा सकता है, और हालांकि, कड़ाई से बोलते हुए, यह एक xls फ़ाइल नहीं है, एक्सेल इसे अच्छी तरह से खोलता है। यह दृष्टिकोण काफी लोकप्रिय है, लेकिन नुकसान में यह तथ्य शामिल है कि एक्सएमएल-एक्सेल प्रारूप के सीधे संपादन पर आधारित कोई भी समाधान एक बार "हैक" सामान्यता से रहित है।
अंत में, ओपन सोर्स लाइब्रेरीज़ का उपयोग करके एक्सेल फाइलों को जेनरेट करना संभव है, जिनमें से Apache POI विशेष रूप से ज्ञात है। Apache POI डेवलपर्स ने रिवर्स इंजीनियरिंग बाइनरी एमएस ऑफिस दस्तावेज़ स्वरूपों पर एक टाइटैनिक काम किया है, और वर्षों से इस पुस्तकालय को बनाए रखना और विकसित करना जारी रखता है। इस रिवर्स इंजीनियरिंग का परिणाम, उदाहरण के लिए, एमएस ऑफिस के साथ संगत प्रारूपों में दस्तावेजों के संरक्षण को लागू करने के लिए ओपन ऑफिस में उपयोग किया जाता है।

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

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

लेकिन यह पूरी तरह से अलग हो सकता है। Apache POI के आधार पर बनाए गए LGPL के तहत Xylophone प्रोजेक्ट एक ऐसे विचार पर आधारित है, जिसका अनुमानित 15 साल का इतिहास है। जिन परियोजनाओं में मैंने भाग लिया था, उनका उपयोग विभिन्न प्रकार के प्लेटफार्मों और भाषाओं के संयोजन में किया गया था - और, विभिन्न प्रकार की परियोजनाओं में इसकी मदद से बनाए गए रूपों की विविधता के कारण, संभवतः पहले से ही हजारों हैं। यह एक जावा परियोजना है जो कमांड लाइन उपयोगिता और लाइब्रेरी के रूप में काम कर सकती है (यदि आपके पास जेवीएम भाषा में कोड है, तो आप इसे मावेन निर्भरता के रूप में जोड़ सकते हैं )।

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

दस्तावेज़ टेम्पलेट (xls / xlsx टेम्पलेट) कुछ इस तरह दिखता है:

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

जब "डिज़ाइन" कार्य किया जाता है, तो डेवलपर रहता है

XML प्रारूप में आवश्यक डेटा डाउनलोड करने के लिए एक प्रक्रिया बनाएं।
एक डिस्क्रिप्टर बनाएँ जो एक्सएमएल फ़ाइल के तत्वों को ट्रेस करने और परिणामी रिपोर्ट के टेम्प्लेट के टुकड़े कॉपी करने के लिए प्रक्रिया का वर्णन करता है
XPath एक्सप्रेशन का उपयोग करके XML फ़ाइल के तत्वों को टेम्पलेट सेल बाँधें ।

XML पर अपलोड करने के साथ, सब कुछ कम या ज्यादा स्पष्ट है: फ़ॉर्म को भरने के लिए आवश्यक डेटा के उचित XML प्रतिनिधित्व का चयन करें। विवरणक क्या है?

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

<element name="root"> <output range="A1:Z100"/> </element>

यहां रूट हमारी XML डेटा फ़ाइल के मूल तत्व का नाम है, और रेंज A1: Z100 टेम्पलेट से कोशिकाओं की आयताकार श्रेणी है जिसे परिणाम में कॉपी किया जाएगा। इसके अलावा, जैसा कि पिछले उदाहरण से देखा जा सकता है, वाइल्डकार्ड फ़ील्ड जिनके मानों को XML फ़ाइल से डेटा के साथ बदल दिया जाता है, उनमें प्रारूप ~{XPath-} (टिल्ड, घुंघराले ब्रैकेट, वर्तमान XML तत्व के सापेक्ष XPath अभिव्यक्ति, घुंघराले ब्रैकेट को बंद करना) होता है।

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

लाल वर्ग उन कोशिकाओं को चिह्नित करते हैं जो अगले आयताकार टुकड़े के ऊपरी बाएं कोने होंगे जो रिपोर्ट जनरेटर डॉकिंग है।

तत्वों को दोहराने के लिए एक और संभावित विकल्प है: एक्सेल वर्कबुक में शीट। ऐसी पुनरावृत्ति को व्यवस्थित करने की क्षमता भी उपलब्ध है।

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

उपयोगकर्ता को उतारने के लिए वर्षों की सीमा का चयन करने दें, इसलिए इस रिपोर्ट में दोनों पंक्तियों और स्तंभों को गतिशील रूप से बनाया गया है। ऐसी रिपोर्ट के लिए डेटा का XML प्रतिनिधित्व इस तरह दिख सकता है:

testdata.xml

 <?xml version="1.0" encoding="UTF-8"?> <report> <column year="2016"/> <column year="2017"/> <column year="2018"/> <item name=" 1"> <year amount="365"/> <year amount="286"/> <year amount="207"/> </item> <item name=" 2"> <year amount="95"/> <year amount="606"/> <year amount="840"/> </item> <item name=" 3"> <year amount="710"/> <year amount="437"/> <year amount="100"/> </item> <totals> <year amount="1170"/> <year amount="1329"/> <year amount="1147"/> </totals> </report>

हम आपकी पसंद के अनुसार टैग के नाम चुनने के लिए स्वतंत्र हैं, संरचना भी मनमानी हो सकती है, लेकिन रिपोर्ट में रूपांतरण की आसानी के साथ। उदाहरण के लिए, मैं आमतौर पर शीट में प्रदर्शित मूल्यों को विशेषताओं में लिखता हूं, क्योंकि यह XPath अभिव्यक्तियों को सरल करता है (यह सुविधाजनक है जब वे @ तरह दिखते हैं)।

इस तरह की रिपोर्ट के लिए टेम्पलेट इस तरह दिखेगा (एक्सपीथ एक्सप्रेशंस की तुलना संबंधित टैग के विशेषता नामों के साथ):

अब सबसे दिलचस्प हिस्सा आता है: एक हैंडल बनाना। चूंकि यह लगभग पूरी तरह से गतिशील रूप से इकट्ठी रिपोर्ट है, इसलिए विवरणक जटिल है, व्यवहार में (जब हमारे पास दस्तावेज़ का केवल "हेडर" है, इसकी लाइनें और "पाद") सब कुछ आमतौर पर बहुत सरल है। यहाँ इस मामले में विवरणकर्ता की आवश्यकता है:

descriptor.xml

 <?xml version="1.0" encoding="UTF-8"?> <element name="report"> <!--   --> <output worksheet="" sourcesheet="1"/> <!--        --> <iteration mode="horizontal"> <element name="(before)"> <!--        --> <output range="A1"/> </element> <element name="column"> <output range="B1"/> </element> </iteration> <!--  :     ,   --> <iteration mode="vertical"> <element name="item"> <!--    -   --> <iteration mode="horizontal"> <element name="(before)"> <!--   --> <output range="A2"/> </element> <!--         --> <element name="year"> <output range="B2"/> </element> </iteration> </element> </iteration> <iteration> <element name="totals"> <iteration mode="horizontal"> <element name="(before)"> <!--   --> <output range="A3"/> </element> <!--         --> <element name="year"> <output range="B3"/> </element> </iteration> </element> </iteration> </element>

प्रलेखन में पूरी तरह से वर्णनकर्ता तत्व वर्णित हैं। संक्षेप में, एक डिस्क्रिप्टर के मूल तत्वों का अर्थ निम्न है:

तत्व - एक XML फ़ाइल के एक तत्व के पढ़ने के लिए संक्रमण। यह या तो विवरणक का मूल तत्व हो सकता है, या iteration अंदर हो सकता है। name विशेषता का उपयोग तत्वों के लिए विभिन्न फिल्टर सेट करने के लिए किया जा सकता है, उदाहरण के लिए
- name="foo" - टैग नाम फू के साथ तत्व
- name="*" - सभी तत्व
- name="tagname[@attribute='value']" - एक विशिष्ट नाम और गुण मान वाले तत्व
- name="(before)" , name="(after)" - "आभासी" तत्व जो पुनरावृत्ति से पहले और पुनरावृति को बंद करते हैं।
पुनरावृति - पुनरावृत्ति मोड में संक्रमण। यह केवल element अंदर हो सकता है। विभिन्न मापदंडों को सेट किया जा सकता है, उदा।
- mode="horizontal" - mode="horizontal" आउटपुट मोड (डिफ़ॉल्ट रूप से लंबवत)
- index=0 - पहले तत्व का सामना करने के लिए पुनरावृत्ति को प्रतिबंधित करें
आउटपुट - आउटपुट मोड पर स्विच करें। मुख्य विशेषताएं इस प्रकार हैं:
- sourcesheet - टेम्प्लेट बुक शीट जिसमें से आउटपुट रेंज ली जाती है। यदि निर्दिष्ट नहीं है, तो वर्तमान (अंतिम उपयोग किया गया) शीट लागू किया जाता है।
- range - परिणामस्वरूप दस्तावेज़ में कॉपी किए जाने वाले टेम्पलेट की श्रेणी, उदाहरण के लिए, "A1: M10", या "5: 6", या "C: C"। (क्षैतिज आउटपुट मोड में टाइप "5: 6" प्रकार की पंक्ति श्रेणियों का उपयोग करना और ऊर्ध्वाधर आउटपुट मोड में "C: C" प्रकार के कॉलम रेंज में त्रुटि होगी)।
- worksheet - यदि परिभाषित किया गया है, तो आउटपुट फ़ाइल में एक नई शीट बनाई जाती है और आउटपुट पोजीशन को इस शीट के सेल A1 में स्थानांतरित कर दिया जाता है। एक स्थिर या XPath अभिव्यक्ति के बराबर इस विशेषता का मूल्य, नई शीट के नाम से प्रतिस्थापित किया जाता है।

वास्तव में, डिस्क्रिप्टर में कई और विकल्प हैं, प्रलेखन देखें।

खैर, अब ज़ाइलोफोन डाउनलोड करने और रिपोर्टिंग शुरू करने का समय आ गया है।
Bintray या Maven Central (NB: इस लेख को पढ़ने के समय, और अधिक हाल के संस्करण संभव हैं) से संग्रह को लें। / बिन फ़ोल्डर में एक शेल स्क्रिप्ट है, जब आप इसे मापदंडों के बिना चलाते हैं, तो आप कमांड लाइन के मापदंडों के बारे में संकेत देंगे। परिणाम प्राप्त करने के लिए, हमें पहले से तैयार किए गए सभी अवयवों में ज़ाइलोफोन को "फीड" करना होगा:

 xylophone -data testdata.xml -template template.xlsx -descr descriptor.xml -out report.xlsx

Report.xlsx फ़ाइल खोलें और सुनिश्चित करें कि हमें ठीक वही मिलेगा जो हमें चाहिए:

क्योंकि ru.curs: xylophone लाइब्रेरी LGPL लाइसेंस के तहत मावेन सेंट्रल पर उपलब्ध है , इसका उपयोग किसी भी JVM भाषा में कार्यक्रमों में समस्याओं के बिना किया जा सकता है। शायद सबसे कॉम्पैक्ट पूरी तरह से काम करने का उदाहरण ग्रूवी में प्राप्त हुआ है, कोड को टिप्पणियों की आवश्यकता नहीं है:

 @Grab('ru.curs:xylophone:6.1.3') import ru.curs.xylophone.XML2Spreadsheet baseDir = '.' new File(baseDir, 'testdata.xml').withInputStream { input -> new File(baseDir, 'report.xlsx').withOutputStream { output -> XML2Spreadsheet.process(input, new File(baseDir, 'descriptor.xml'), new File(baseDir, 'template.xlsx'), false, output) } } println 'Done.'

XML2Spreadsheet class में स्थैतिक process विधि के कई अतिभारित संस्करण हैं, लेकिन वे सभी रिपोर्ट तैयार करने के लिए आवश्यक समान "अवयवों" को स्थानांतरित करने के लिए उबलते हैं।

एक महत्वपूर्ण विकल्प जिसका मैंने अभी तक उल्लेख नहीं किया है, वह XML डेटा वाली फ़ाइल को पार्स करने के चरण में DOM और SAX पार्सर के बीच चयन करने की क्षमता है। जैसा कि आप जानते हैं, DOM पार्सर संपूर्ण फ़ाइल को मेमोरी में लोड करता है, अपनी ऑब्जेक्ट प्रतिनिधित्व बनाता है और अपनी सामग्री को अनियंत्रित तरीके से बायपास करना संभव बनाता है (एक ही तत्व को बार-बार वापस करने सहित)। SAX पार्सर पूरे डेटा फ़ाइल को मेमोरी में कभी नहीं डालता है, इसके बजाय, यह इसे तत्वों की "स्ट्रीम" के रूप में संसाधित करता है, इसे फिर से तत्व पर लौटने से रोकता है।

Xylophone में SAX मोड का उपयोग करना ( -sax कमांड-लाइन -sax माध्यम से या useSax विधि को XML2Spreadsheet.process करने के लिए) का उपयोग करने का पैरामीटर निर्धारित करना जब आप बहुत बड़ी फ़ाइलों को बनाने की आवश्यकता होती है, तो यह काफी उपयोगी हो सकता है। एसएएक्स पार्सर संसाधनों की गति और लाभप्रदता के कारण, फ़ाइल पीढ़ी की गति कई बार बढ़ जाती है। यह डिस्क्रिप्टर (प्रलेखन में वर्णित) पर कुछ छोटे प्रतिबंधों की कीमत पर दिया गया है, लेकिन ज्यादातर मामलों में रिपोर्ट इन प्रतिबंधों को संतुष्ट करती है, इसलिए मैं जहां भी संभव हो एसएएक्स मोड का उपयोग करने की सलाह दूंगा।

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

और अंत में, फिर से लिंक:

स्रोत यहां हैं: github.com/CourseOrchestra/xylophone
प्रलेखन यहाँ है: courseorchestra.imtqy.com/xylophone
इस लेख के सभी कोड उदाहरण यहाँ हैं: github.com/inponomarev/xylophone-example ।

Excel में डेटा अनलोड करें। सभ्य बनाना

More articles: