====== Excel Exporter ======

K dispozici je nástroj příkazové řádky s názvem Excel Exporter, který umožňuje vytvářet plně přizpůsobitelné reporty ve formátu Microsoft Excel z dat uložených v Mervis DB.

Funguje na základě šablonových XLSX souborů, do kterých lze pomocí speciální syntaxe vkládat hodnoty z Mervis DB.

Pro více informací kontaktujte [[cs:help:energocentrum-plus|obchodní oddělení]].

===== Příklad =====

V tomto příkladu si ukážeme, jak exportovat jednu proměnnou do Excel souboru.

Syrová data z databáze můžete zobrazit zde: [[https://db.mervis.info/viewer2/#/graphView?shortId=f864dc|Mervis DB Viewer]].

{{ :en:mervis-db:excel_exporter_viewer.png?direct&800 |}}

==== Konfigurační soubor ====

Nejprve je potřeba vytvořit konfigurační XML soubor, ve kterém definujete mapování mezi sadou klíčů (identifikujících konkrétní proměnnou v Mervis DB) a názvem proměnné, který budete používat v Excel šabloně.

Lze také určit název výstupního souboru a zda se má soubor jen aktualizovat, nebo přepsat.

<code xml ExcelDemo.xml><?xml version="1.0" encoding="utf-8"?>
<RcWareDbExporterVariableTemplateFile>
     <exportTemplate>exceldemo.xlsx</exportTemplate>
     <exportOutput>exceldemo_[yyyy-MM-dd_HH-mm].xlsx</exportOutput>
	 <fillIncrementaly>false</fillIncrementaly>
     <variables>
          <variable name="OutsideTemperature">
               <keyValuePairs>
                    <keyValuePair key="DPGuid" value="338E2882-D72B-4D17-A241-73E8BC30F458" isId="true" />
                    <keyValuePair key="StationName" value="ENERGO" isId="true" />
               </keyValuePairs>
          </variable>
          <variable name="HereCouldBeSomeOtherVariable">
               <keyValuePairs>
                    <keyValuePair key="DPGuid" value="338E2882-D72B-4D17-A241-73E8BC30F458" isId="true" />
                    <keyValuePair key="StationName" value="ENERGO" isId="true" />
               </keyValuePairs>
          </variable>
     </variables>
</RcWareDbExporterVariableTemplateFile></code>

==== Excel šablona ====

Pomocí jednoduchého šablonovacího jazyka můžete určit, jaké hodnoty z Mervis DB se mají na jaké místo ve výstupním Excel souboru vložit.

<code>[YEAR:2016|MONTH:1|DAY:15|HOUR:12|MINUTE:0|VARIABLE:OutsideTemperature]</code>

Kterákoli z časových částí může být vynechána a nahradí se aktuálním časem, nebo hodnotou předanou z příkazové řádky.

{{ :en:mervis-db:excel_exporter_template.png?direct&800 |}}

==== Spuštění exportu ====

<code bat runExcelDemo.bat>.\ESG.RcWareDb.DataExporter\ESG.RcWareDb.DataExporter.exe tmpPath:"ExcelDemo.xml" srvUrl:"http://db.mervis.info/db/energocentrum/RcWareDbAccess" srvUser:"exceldemo" srvPsw:"pfi4cj4qrj" timeTolerance:300 toleranceType:before</code>

Další možnosti a parametry zjistíte pomocí:  
<code>.\ESG.RcWareDb.DataExporter\ESG.RcWareDb.DataExporter.exe --help</code>

==== Výstup ====

Název výstupního souboru je určen v XML konfiguračním souboru. Ukázka výsledného souboru může vypadat takto:

{{ :en:mervis-db:excel_exporter_output.png?direct&800 |}}

==== Stažení plného příkladu ====

Stáhnout: {{ :en:mervis-db:excelexporterdemo.zip |}}