ज़ेन रिपोर्ट्स और Caché में एक्सेल रिपोर्ट जनरेट करने के लिए XML.Writer%

जैसा कि आप जानते हैं, नवीनतम संस्करणों के एमएस एक्सेल xml प्रारूप में दस्तावेज़ संरचना के विवरण का समर्थन करते हैं। यह परिस्थिति आपको xml फ़ाइलों की पीढ़ी का उपयोग करके Excel में रिपोर्ट बनाने की अनुमति देती है। Caché DBMS में xml बनाने के कई तरीके हैं। यह आलेख दो चर्चा करेगा, संभवतः सबसे सुविधाजनक, एमएस एक्सेल में कुशल प्रोग्राम बनाने वाली रिपोर्ट के तरीके: ज़ेन रिपोर्ट्स का उपयोग करके और% XML.Writer वर्ग का उपयोग करके।

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

सामान्य रिपोर्टिंग योजना

कैश में, मैन्युअल रूप से रिपोर्ट तैयार करने के कई तरीके हैं (यहां हम दीपसी पर आधारित अर्ध-स्वचालित विधानसभा की संभावनाओं पर विचार नहीं करेंगे)। सबसे सुविधाजनक तरीका ZEN में लागू किया गया है और इसमें एक उपकरण शामिल है जो XHTML और PDF प्रारूप में रिपोर्ट बनाने की प्रक्रिया का एक पूरा चक्र प्रदान करता है। इस प्रक्रिया का विवरण प्रलेखन में पाया जा सकता है। हालांकि, हमारी समस्या को हल करने के लिए, इस पद्धति का केवल आंशिक रूप से उपयोग किया जा सकता है।
ZEN तकनीक और अन्य Caché सुविधाओं (नीचे आंकड़ा देखें) का उपयोग करके MS Excel प्रारूप में एक रिपोर्ट बनाने के लिए सामान्य तंत्र पर विचार करें।

Xls डॉक्यूमेंट जनरेट करने की इस योजना में तीन चरण शामिल हैं: 1) डेटाबेस से डेटा ज़ेन रिपोर्ट्स तकनीक या Caché मानक तकनीक का उपयोग करके एक xml फ़ाइल (इनपुट xml) में परिवर्तित किया जाता है; 2) एक्सएसएल परिवर्तन तंत्र (एक्सटेन्सिबल स्टाइलशीट लैंग्वेज) के माध्यम से, एक्सएमएल प्रारूप में एक पूर्व-तैयार रिपोर्ट टेम्पलेट को संशोधित किया गया है; 3) एक्सेल डॉक्यूमेंट (xls) xml रिपोर्ट टेम्पलेट को भरने से उत्पन्न होता है, जिसे XSL आवेषण के साथ इनपुट xml के डेटा के साथ विस्तारित किया जाता है।

इनपुट xml फ़ाइल संरचना

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

• पाठ्यक्रम का नाम
• संपूर्ण पाठ्यक्रम के लिए नियंत्रण के रूपों का योग: परीक्षा; ऑफसेट; पाठ्यक्रम परियोजनाएं; टर्म पेपर
• पाठ्यक्रम के सभी विषयों में घंटे का योग: एक परीक्षा के साथ कुल; राज्य शैक्षिक मानकों (राज्य शैक्षिक मानक) के अनुसार कुल; कक्षा के घंटे; डीएसी (एक कोर्स प्रोजेक्ट या काम पर स्वतंत्र काम); स्वतंत्र काम के घंटे
• पाठ्यक्रम के प्रत्येक सेमेस्टर के लिए प्रत्येक अनुशासन के लिए घंटों का योग: एक व्याख्यान के लिए घंटे; प्रयोगशाला के काम के लिए घंटे; व्यावहारिक अभ्यास के लिए घंटे; डीएसी पर देखता है
• संपूर्ण पाठ्यक्रम के लिए क्रेडिट (WE) का योग

पाठ्यक्रम में Cicl चक्र भी होते हैं, जिनमें से प्रत्येक में अपने स्वयं के तत्व होते हैं। एक्सएमएल फ़ाइल की शेष शाखाओं को एक समान तरीके से वर्णित किया जाता है, नीचे विषयों और उनकी विशेषताओं के लिए।

स्रोत xml पीढ़ी

स्रोत xml फ़ाइल प्राप्त करने के दो तरीकों पर विचार करें:% XML.Writer वर्ग का उपयोग करके और ज़ेन रिपोर्ट इंजन का उपयोग करना।

% XML.Writer का उपयोग करके स्रोत xml बनाना

ऊपर वर्णित xml संरचना को XML.Writer वर्ग के माध्यम से प्राप्त किया जा सकता है, जो आपको निम्नलिखित की अनुमति देता है:

1. रूट एलीमेंट बनाएं
   fWriter करो । RootElement ( "मूल तत्व नाम" )
   fWriter करो । EndRootElement ()
2. आइटम बनाएं
   fWriter करो । तत्व ( "तत्व नाम" )
   fWriter करो । लिखें ( तत्व मान )
   fWriter करें । एंडइमेंट ()
   
3. विशेषता बनाएँ
   fWriter करो । WriteAttribute ( "विशेषता नाम" , "विशेषता मान" )

इसके अलावा, XML.Writer के पास एक ऐसा तरीका है जो आपको इसके पास दिए गए ऑब्जेक्ट से सभी डेटा को पुनः प्राप्त करने की अनुमति देता है।
लेखक। रूटऑब्जेक्ट ( "ऑब्जेक्ट नेम" )

एक पाठ्यक्रम रिपोर्ट बनाने के कार्य में, रूटऑब्जेक्ट विधि फिट नहीं हुई, क्योंकि अनुशासन वर्ग में स्वयं का संदर्भ होता है, और इस पद्धति का संचालन सही नहीं था। इस संबंध में, आउटपुट xml फ़ाइल के सभी तत्व मैन्युअल रूप से बनाए गए थे। ऐसा करने के लिए, spReport.spExcelWriter क्लास को बनाया गया था, जिसमें genWriterData मेथड (iDSelectCur As% Integer) शामिल है ताकि एक xml फाइल बनाई जा सके जिसमें चयनित पाठ्यक्रम की आईडी पास हो। इस पद्धति का उपयोग करते हुए, एसक्यूएल प्रश्नों का उपयोग करके, डेटा डेटाबेस से निकाला जाता है, और उन्हें सही जगह पर डाला जाता है। उसके बाद, आउटपुट xml फ़ाइल एक और OutputToFile विधि ("path \ filename.xml") का उपयोग करके उत्पन्न होती है।

जेन रिपोर्ट्स इंजन का उपयोग करके स्रोत xml बनाना

ज़ेन रिपोर्ट्स कैची डेटाबेस से डेटा निकालने और इसे xml में परिवर्तित करने के लिए एक उच्च-स्तरीय तंत्र है, जो कुछ सीमाएं लगाता है, जिसके बारे में नीचे चर्चा की जाएगी। इस विधि में ZEN.Report.reportPage से विरासत में प्राप्त कैच-स्टूडियो के माध्यम से ज़ेन रिपोर्ट क्लास बनाना शामिल है, जिसमें आपको XData ReportDefinition block भरना होगा। आप दस्तावेज़ में XML प्रतिनिधित्व के लिए SQL क्वेरी का उपयोग करके XData ReportDefinition block और fetch data बनाने के नियमों के बारे में अधिक पढ़ सकते हैं।

जेन रिपोर्ट एक्सएमएल के लिए डेटा संरचना का वर्णन करने के लिए अपने स्वयं के सिंटैक्स का उपयोग करने का सुझाव देती है - यह आउटपुट xml प्रारूप पर कुछ प्रतिबंध लगाता है। नतीजतन, परिणामस्वरूप xml फ़ाइल की संरचना ऊपर वर्णित से थोड़ी अलग है: Cicls और Blocks नोड्स, जिसमें Cicl और Block सबनॉड्स शामिल हैं, उत्पन्न xml फ़ाइल में जोड़े जाते हैं।
हम संबंधित डेटा के आउटपुट की कुछ विशेषताएं दिखाते हैं।

उदाहरण 1. चयनित पाठ्यक्रम की आईडी को एसक्यूएल अनुरोध तत्व में पास करना।
< रिपोर्ट sql = "का चयन करें * Sp.cCurriculum की आईडी कहां से =?" >

अगला, चर के मान के साथ पैरामीटर ..idCurr को उस स्थान पर पारित किया जाता है "?"
< पैरामीटर अभिव्यक्ति = '..idCurr' />

वेरिएबल ZenReport class का गुण है और जब रिपोर्ट जनरेशन मेथड कहलाता है, तो idCurr वैल्यू मेथड में पास किए गए करंट करंट के id पैरामीटर की वैल्यू लेता है।

उदाहरण 2. एक पैरामीटर पारित करना जो SQL क्वेरी को निष्पादित करने के परिणाम पर निर्भर करता है, उदाहरण के लिए, रिश्ते को ब्लॉक करने के लिए एक लूप:
< समूह sql = "चयन करें * sp.cCicl से कहाँ करें पाठ्यक्रम =?" >
< पैरामीटर अभिव्यक्ति = '..idCurr' />
< समूह sql = "चयन करें * Sp.cBlock से यहां Cicl =?" ब्रेकऑनफिल्ड = "आईडी" >
< पैरामीटर फ़ील्ड = "आईडी" />
</ समूह >
</ समूह >

यहां, विशेषता ब्रेकऑनफिल्ड = "आईडी" का उपयोग करके "आईडी" का स्थानांतरण किया जाता है।
हम "चक्र" के लिए समूहीकरण के निष्पादन को दिखाते हैं।
< समूह का नाम = "Cicls" sql = "का चयन करें * Sp.cCicl से कहाँ पाठ्यक्रम =?" >
< पैरामीटर अभिव्यक्ति = '..idCurr' />
< समूह का नाम = "Cicl" >
< विशेषता नाम = "CiclName" फ़ील्ड = "नाम" />
< विशेषता नाम = "CodeOfCicl" फ़ील्ड = "CodeOfCicl" />
...
</ समूह >
...
</ समूह >

ब्लॉकों को समान रूप से समूहीकृत किया जाता है।
उत्पन्न XML फ़ाइल के संशोधित प्रारूप में अब निम्न रूप है।

 <?xml version="1.0" encoding='utf-8'?> … <Cicls> <Cicl> <Blocks> <Block> <Disciplines>…</Disciplines> </ Block> </ Blocks> </Cicl> … <Cicl> <Blocks> <Block> <Disciplines>…</Disciplines> </ Block> </ Blocks> </Cicl> … </Cicls> 

इसके अलावा, XSL ट्रांसफ़ॉर्मेशन के दौरान लूप की कॉल बदल जाएगी (XSL ट्रांसफ़ॉर्मेशन को लागू करने का सामान्य तरीका नीचे वर्णित है):

  <xsl:for-each select = ”./Cicls/Cicl”><xsl:for-each> 

हम कुछ नियम तैयार करते हैं जिन्हें आउटपुट डेटा की संरचना को डिज़ाइन करते समय विचार किया जाना चाहिए।

1. तालिका 1 से नाम फ़ील्ड लिया जाएगा:
   < रिपोर्ट sql = "तालिका 1 से नाम का चयन करें" >
   < तत्व नाम = "ए" फ़ील्ड = "नाम" />
2. नाम फ़ील्ड में कोई त्रुटि होगी:
   < रिपोर्ट sql = "तालिका 1 से नाम का चयन करें" >
   < विशेषता नाम = "ए" फ़ील्ड = "नाम" />
3. नाम फ़ील्ड Table2 से प्राप्त किया जाता है:
   < रिपोर्ट sql = "तालिका 1 से नाम का चयन करें" >
   < समूह का नाम = "नाम" sql = "तालिका 2 का चयन नाम जहां ..." >
   < तत्व नाम = "ए" फ़ील्ड = "नाम" />
4. नाम फ़ील्ड Table1 से प्राप्त किया गया है:
   < रिपोर्ट sql = "तालिका 1 से नाम का चयन करें" >
   < समूह का नाम = "नाम" sql = "तालिका 2 का चयन नाम जहां ..." >
   < विशेषता नाम = "ए" फ़ील्ड = "नाम" />

एक्सेल टेम्पलेट बनाएँ

XSL परिवर्तन करने से पहले, आपको एक Excel दस्तावेज़ टेम्पलेट बनाना होगा जिसमें xml से डेटा डाला जाएगा। एक्सेल टेम्पलेट बनाने की प्रक्रिया में तीन चरण होते हैं।
चरण संख्या 1। एक्सेल रिपोर्ट की उपस्थिति बनाता है।
चरण संख्या 2। टेम्पलेट xml तालिका प्रारूप में सहेजा गया है।

उपरोक्त स्निपेट से पता चलता है कि पहले शैलियों की एक सूची बनाई गई है, जो तब कोशिकाओं को प्रारूपित करने के लिए उपयोग की जाती है। उदाहरण के लिए:

  <Style ss:ID="s374"> <Alignment ss:Horizontal="Center" ss:Vertical="Bottom"/> <Font ss:FontName="Arial Cyr" x:CharSet="204" x:Family="Swiss" ss:Bold="1" ss:Italic="1"/> <Protection/> </Style> 

निम्नलिखित सेल इस शैली को संदर्भित करता है:

 <Cell ss:MergeAcross="66" ss:StyleID="s374"><Data ss:Type="String">     </Data></Cell> 

वर्कशीट तत्व एक एक्सेल वर्कबुक में शीट बनाता है, उदाहरण के लिए:

 <Worksheet ss:Name=""> . . . </Worksheet> 

तालिका तत्व एक तालिका बनाता है। तालिका में "पंक्ति" पंक्तियाँ होती हैं, और पंक्तियाँ, "सेल" कोशिकाएँ होती हैं।
चरण 3. किसी भी पाठ संपादक का उपयोग करते हुए, अनावश्यक विशेषताओं को हटाकर xml संरचना में परिवर्तन किए जाते हैं। हमारे मामले में, विशेषताएँ हटा दी जाती हैं: ss: ExpandedColumnCount = "67"; ss: ExpandedRowCount = "45"; x: FullColumns = "1"; x: FullRows = "1", क्योंकि पाठ्यक्रम में विषयों की एक मनमानी संख्या है, और यदि "तालिका" तत्व इन विशेषताओं को बरकरार रखता है, तो पंक्तियों और स्तंभों की संख्या के बेमेल होने के कारण एक Excel दस्तावेज़ बनाते समय एक त्रुटि उत्पन्न होगी। Ss को हटाने की भी सलाह दी जाती है: <Rowss: AutoFitHeight = "0" ss: Height = "13.5"> पर ऊँचाई विशेषता, क्योंकि यदि रेखा बहुत लंबी है और बॉक्स कहता है "वर्ड रैप, तो वर्ड रैप नहीं होगा।" एक्सेल दस्तावेज़ उत्पन्न।

XSL परिवर्तन

Xml डेटा में xml डेटा में परिवर्तन की मानक विधि (वर्ग% XML.XSLT.Transformer में) का उपयोग करने के लिए, अंतर्निहित XSL निर्माण के साथ एक विशेष xml ब्लॉक तैयार करना आवश्यक है। हमारे मामले में, पिछले पैराग्राफ में तैयार एक्सेल टेम्पलेट को XSL के आधार के रूप में लिया गया है। निम्नलिखित XSL निर्माण का उपयोग करके इस टेम्पलेट को परिष्कृत किया जाना चाहिए:

1.  <xsl:for-each select = ""> </xsl:for-each> 

2.  <xsl:value-of select = ""/> 

<Xsl: for-प्रत्येक select = ""> </ xsl: for-प्रत्येक> निर्माण का उपयोग किसी दिए गए सेट के प्रत्येक xml तत्व को चुनने के लिए किया जाता है। <Xsl: select = "" /> निर्माण का मान आपको चयनित नोड के मूल्यों को प्रदर्शित करने की अनुमति देता है। निम्नलिखित एक एक्सेल टेम्पलेट में XSL डालने का एक सरल उदाहरण है:

 <Table> <xsl:for-each select="Curriculum"> <xsl:for-each select="./Cicl"> <Row> <Cell> <Data ss:Type="String"><xsl:value-of select="./CiclName"/></Data> </Cell> </Row> <xsl:for-each select="./Block"> <Row> <Cell> <Data ss:Type="String"><xsl:value-of select="./BlocName"/></Data> </Cell> </Row> <xsl:for-each select="./Disciplines/Discipline"> <Row> <Cell> <Data ss:Type="String"><xsl:value-of select="./DiscName"/></Data> </Cell> </Row> </xsl:for-each> </xsl:for-each> </xsl:for-each> </xsl:for-each> </Table> 

उपरोक्त उदाहरण से पता चलता है कि एक्सेल तालिका में, नेस्टेड लूप में, सभी "Cicl" तत्व एक्सेस किए जाते हैं, फिर प्रत्येक चक्र में (विषयों का विस्तृत समूह) सभी "ब्लॉक" तत्व, फिर प्रत्येक ब्लॉक में / अनुशासन / अनुशासन तत्वों तक और उसके बाद यह जानकारी निर्दिष्ट फ़ील्ड <xsl: value -seselect = "./ DiscName" />, i.e. विषयों के नाम।
आपके द्वारा टेम्पलेट में XSL तत्वों को सही स्थानों पर सम्मिलित करने के बाद, आप रिपोर्ट तैयार करने की प्रक्रिया शुरू कर सकते हैं। ऐसा करने के लिए, आप एक वर्ग में एक विशेष विधि बना सकते हैं जो तैयार किए गए एक्सेल टेम्पलेट का उपयोग करके xml प्रारूप से डेटा को xls में बदल देगा जिसे उसी कक्षा के XData ब्लॉक में रखा जा सकता है (नीचे उदाहरण में, XData ब्लॉक को "xsl" कहा जाता है)। इस विधि का एक उदाहरण नीचे दिया गया है।

ClassMethod generateReportStadyPlan ( % फ़ाइल के रूप में आउटफाइलनाम ) % स्थिति के रूप में
{
xslStream = ## वर्ग ( % Dictionary.CompiledXData ) सेट करें। % OpenId (.. % ClassName (1) _ "|| xsl" )। डेटा
xmlStream = ## वर्ग ( % FileBinaryStream ) सेट करें। % नया ()
xmlStream सेट करें । फ़ाइल नाम = "xml फ़ाइल का पथ"

सेट आउटस्ट्रीम = ## क्लास ( % FileCharacterStream )। % नया ()
सेट आउट । TranslateTable = "UTF8"
सेट आउट । फ़ाइल नाम = outFileName

sc = ## वर्ग ( % XML.XSLT.Transformer )। TransformStream ( xmlStream , xslStream ; OutStream )

अगर $$$ ISERR ( sc ) ने sc छोड़ दिया

बाहर छोड़ो । % बचाओ ()
}

Xdata xsl
{
< xsl: स्टाइलशीट संस्करण = "1.0" xmlns: xsl = " www.w3.org/1999/XSL/Transform"
xmlns = "कलश: स्कीमा-माइक्रोसाॅम-कॉम: कार्यालय: स्प्रेडशीट"
xmlns: o = "कलश: स्कीमा-माइक्रोसॉफ़्ट-कॉम: कार्यालय: कार्यालय"
xmlns: x = "urn: स्कीमा-माइक्रोसॉफ़्ट-कॉम: ऑफ़िस: एक्सेल"
xmlns: ss = "urn: schemas-microsoft-com: कार्यालय: स्प्रेडशीट" >
< xsl: टेम्पलेट मिलान = "/" >
< xsl: संसाधन-निर्देश नाम = "mso-application" >
< xsl: पाठ > progid = "Excel.Sheet" </ xsl: पाठ >
</ xsl: प्रसंस्करण-निर्देश >

<! —— एक्सेल टेम्पलेट प्रविष्टि स्थान ->
</ xsl: टेम्पलेट >
</ xsl: स्टाइलशीट >
}

ज़ेन रिपोर्ट और% XML.Writer की तुलना

तंत्र	लाभ	कमियों
ज़ेन की रिपोर्ट	1. अनावश्यक दिनचर्या के काम को खत्म करता है 2. संरचना का विवरण अधिक संक्षिप्त है, कोई अनावश्यक बवासीर नहीं है 3. धारणा की आसानी	आउटपुट xml की संरचना बदतर रूप से नियंत्रित है, आपको कुछ नियमों का पालन करना होगा
% XML.Writer	आप बिल्कुल किसी भी xml संरचना का निर्माण कर सकते हैं	संरचना के विवरण की जटिलता

MAC UUP आर्किटेक्चर की बारीकियों के आधार पर, जिसमें Caché वर्गों के लिए जावा अनुमान बनाए जाते हैं, आप% sp .eport.spExcelWriter, जो% XML की अतिरिक्त लाभ के लिए एक रिपोर्ट उत्पन्न करता है, को प्रोजेक्ट करने की क्षमता जोड़ सकते हैं। इसके विपरीत, ज़ेन रिपोर्ट में% ZEN.Report.reportPage से विरासत में प्राप्त रिपोर्ट वर्ग का एक प्रक्षेपण प्राप्त करना असंभव है, इस तथ्य के कारण कि इसके तरीके धाराओं के साथ काम करते हैं।
इस प्रकार, XML.riter का उपयोग आउटपुट xml फ़ाइल की संरचना पर कठोर आवश्यकताओं के मामले में सलाह दी जाती है, और जटिल रिपोर्ट बनाते समय ज़ेन रिपोर्ट तंत्र के उपयोग की सिफारिश की जाती है, जिसमें पहली बार में स्पष्ट विवरण और श्रम तीव्रता में कमी की आवश्यकता होती है।