In der Gesch\u00e4ftswelt ist Reporting ein notwendiges \u00dcbel: Es wird akzeptiert bzw. muss gemacht werden, um ein besseres Ergebnis zu erzielen (z. B. organisatorische \u00dcbersicht, Standardisierung, Disziplin). Und als ob der Druck nicht so schon gro\u00df genug w\u00e4re, schreiben Aufsichtsbeh\u00f6rden immer mehr Auflagen vor.<\/p>\n
Ein gutes Beispiel daf\u00fcr ist die europ\u00e4ische Zahlungsdiensterichtlinie 2015\/2366 (siehe die offizielle Seite<\/a>, die Wikipedia-Seite<\/a> und den offiziellen Umsetzungsplan der EU<\/a>): Aufgrund des technologischen Wandels im Zahlungsverkehr zielt sie darauf ab\u201edie Verbraucher besser zu sch\u00fctzen, wenn sie online bezahlen, die Entwicklung und Nutzung innovativer Online- und mobiler Zahlungen zu f\u00f6rdern und grenz\u00fcberschreitende europ\u00e4ische Zahlungsdienste sicherer zu machen<\/em>.\u201c Im Klartext bedeutet dies, dass \u201eein einheitlicher, offener und sicherer europ\u00e4ischer technischer Standard f\u00fcr QR-Codes [that] entwickelt und umgesetzt werden soll, der die Akzeptanz und Interoperabilit\u00e4t von Sofortzahlungen f\u00f6rdern w\u00fcrde<\/em>.\u201c Die endg\u00fcltige Frist f\u00fcr die Umsetzung: 14. September 2019 (inoffiziell \u201ewegen der Pandemie\u201c verl\u00e4ngert).<\/p>\n F\u00fcr praktisch alle B2C-Unternehmen bedeutet dies, dass sie auf allen Rechnungen standardisierte Sicherheitsmerkmale (z. B. QR-Codes) anbringen m\u00fcssen. Dar\u00fcber hinaus bedeutet dies, dass die Zahlungssoftware aktualisiert werden muss, um den gesetzlichen Anforderungen gerecht zu werden und ein schlankeres Reporting zu erstellen, das den internen Anforderungen entspricht. Aber manche (sehr) alte Software l\u00e4sst sich nicht einfach aktualisieren, und man muss wieder ganz von vorne anfangen.<\/p>\n F\u00fcr einen Kunden aus dem Einzelhandelssektor haben wir ein ma\u00dfgeschneidertes Reporting-Tool entwickelt<\/strong>, das:<\/p>\n Zun\u00e4chst einmal braucht man Zeit, um den Umgang mit einem Reportgenerator und vor allem die Kommunikation mit dessen APIs zu erlernen. Daraus ergibt sich ein hoher Installationsaufwand (und m\u00f6glicherweise aufwendiges Warten zwischendurch).<\/p>\n Au\u00dferdem fallen die Kosten f\u00fcr einen wirklich guten, leistungsstarken Reportgenerator kaum h\u00f6her aus als die Kosten f\u00fcr ein benutzerdefiniertes Reporting-Tool.<\/p>\n Wenn Sie Ihr eigenes Tool entwickeln, k\u00f6nnen Sie sich auf Ihre spezifischen Anforderungen konzentrieren, ohne den Aufwand mit einer Komplettl\u00f6sung von der Stange zu haben. Dies f\u00fchrt zu h\u00f6herer Flexibilit\u00e4t (bei Design, Datenquellen usw.) und unvergleichlicher Leistungsf\u00e4higkeit.<\/p>[\/et_pb_text][\/et_pb_column][\/et_pb_row][et_pb_row use_custom_gutter=“on“ _builder_version=“4.7.7″ custom_margin=“||||false|false“ custom_padding=“6vh||||false|false“ border_color_left=“rgba(0,0,0,0)“][et_pb_column type=“4_4″ _builder_version=“4.4.1″][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“2em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||10px||false|false“ border_color_left=“#ff6317″] F\u00fcr den betreffenden Kunden hatten wir bereits ein Cashbox-Modul als ersten Teil eines gr\u00f6\u00dferen ERP-Systems entwickelt. Die Reporting-Funktionen waren eine nat\u00fcrliche Erweiterung in Form eines zus\u00e4tzlichen Microservices, der auch von anderen Modulen genutzt werden konnte.<\/p>\n F\u00fcr jeden ben\u00f6tigten Report haben wir einen dreistufigen Prozess entwickelt:<\/p>\n Zun\u00e4chst haben wir die Layouts mit HTML definiert, da dies die g\u00e4ngigste Sprache f\u00fcr die Beschreibung von Layouts ist. F\u00fcr jeden Reporttyp ben\u00f6tigten wir drei HTML-Dateien: einen Hauptteil, eine Kopfzeile und eine Fu\u00dfzeile. (Der Grund daf\u00fcr ist, dass die verschiedenen Reports des Kunden alle unterschiedliche Kopfzeilen, Textk\u00f6rper und Fu\u00dfzeilen ben\u00f6tigten.) Wir konnten die Report-Modelle leicht allein in HTML erstellen und \u00e4ndern, um bereits in der Anfangsphase n\u00fctzliches Feedback vom Kunden einzuholen.<\/p>\n Nachdem wir das Layout definiert hatten, bestand der n\u00e4chste Schritt darin, die dynamischen Daten einzuf\u00fcgen. Wir verwendeten eine heterogene Datenquelle (SQL-Tabellen, json-Dateien und In-Memory-Daten). Als die Daten zur Verf\u00fcgung standen, haben wir Razor als Template-Engine verwendet, um die Daten in HTML einzubinden.<\/p>\n Um Razor in unsere Software zu integrieren, haben wir das NuGet-Paket verwendet und RazorEngine 3.10.0 installiert. Unten sehen Sie ein Beispiel daf\u00fcr, wie Razor in einer HTML-Datei verwendet wird. In diesem Beispiel erstellt der Code eine Artikeltabelle mit drei Spalten, der Position des Artikels, dem Code des Artikels und dem Preis.<\/p>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“|300|||||||“ text_font_size=“1em“ text_line_height=“1.3em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“1em“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ background_color=“#f8f8f8″ custom_margin=“||35px|20px|false|false“ custom_padding=“||||false|false“ border_color_left=“rgba(0,0,0,0)“ border_style_left=“none“ locked=“off“] @Model stellt die Wurzel des Modells dar, in der Razor die Daten sucht. Im Code weisen wir Razor an, das angepasste ReportModel, C#-Objekt als @Model zu verwenden.<\/p>\n Wir nennen die Razor-Methode RunCompile mit den folgenden Parametern:<\/p>\n Diese Methode liefert den HTML-String mit den eingespeisten Daten als endg\u00fcltiges HTML-Ergebnis.<\/p>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“|300|||||||“ text_font_size=“1em“ text_line_height=“1.3em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“1em“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ background_color=“#f8f8f8″ custom_margin=“||35px|20px|false|false“ custom_padding=“||||false|false“ border_color_left=“rgba(0,0,0,0)“ border_style_left=“none“ locked=“off“] Das Ergebnis dieser Arbeitsschritte ist eine vollst\u00e4ndige HTML-Datei, die im letzten Schritt in einen PDF-Report umgewandelt wird.<\/p>\n Die Umwandlung von HTML in PDF mag wie ein einfacher Vorgang klingen, und das Internet bietet eine Menge kostenloser Tools, die genau das tun. Aber ein Report ist nicht einfach nur eine PDF-Datei, sondern viel mehr als das. Er verf\u00fcgt \u00fcber Funktionen wie das Hinzuf\u00fcgen von Kopf- und Fu\u00dfzeilen, Paginierung und Druckunterst\u00fctzung.<\/p>\n\n
Warum eigene Reports erstellen, wenn es auch fertige Reportgeneratoren gibt?<\/h2>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||35px||false|false“ border_color_left=“#ff6317″]
Unsere L\u00f6sung<\/h2>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||35px||false|false“ border_color_left=“#ff6317″]
\n
<table>\n @foreach(var article in @Model.Items){\n <tr>\n <td>\n <span> @article.Position<\/span>\n <span> @article.Code<\/span>\n <\/td>\n <td>\n <span> @article.Price \u20ac<\/span>\n <\/td>\n <\/tr>\n }\n<\/table><\/pre>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||35px||false|false“ border_color_left=“#ff6317″]\n
var result = Engine.Razor.RunCompile(File.ReadAllText(htmlPath), templateIdentifier,typeof(ReportModel), reportModel);<\/pre>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||35px||false|false“ border_color_left=“#ff6317″]ReportModel sieht wie folgt aus:[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“|300|||||||“ text_font_size=“1em“ text_line_height=“1.3em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“1em“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ background_color=“#f8f8f8″ custom_margin=“||35px|20px|false|false“ custom_padding=“||||false|false“ border_color_left=“rgba(0,0,0,0)“ border_style_left=“none“ locked=“off“]
public class ReportModel\n{\n \n public List<Item> Items {get; set;}\n}\n \npublic class Item\n{\n public int Position {get; set;}\n public double Price {get; set;}\n public string Code {get; set;}\n}<\/pre>[\/et_pb_text][et_pb_text _builder_version=“4.7.7″ text_font=“||||||||“ text_font_size=“1.1em“ text_line_height=“1.6em“ quote_font=“|700|||||||“ quote_text_align=“left“ quote_font_size=“16px“ header_2_text_color=“#ff6317″ header_2_font_size=“1.5em“ header_2_line_height=“0.9em“ header_3_font_size=“23px“ header_4_font=“||||||||“ header_4_font_size=“16px“ header_4_line_height=“1.5em“ header_5_font_size=“14px“ custom_margin=“||||false|false“ custom_padding=“||35px||false|false“ border_color_left=“#ff6317″]