Bei dem CSV Export handelt es sich um eine Datenbank Abfrage bei der “Views” und “Schemas” genutzt werden um dem Kunden bestimmte Daten bereitzustellen.
Da die Views fest definiert sind, muss man bei einer Kundenanfrage überprüfen ob die vorhandenen Views die Anforderungen erfüllen oder eine neue View in der Datenbank erstellen.
Das Modul nutzt die Swagger Doku, um Abfragen vom Kunden zu ermöglichen und simple Eingrenzungen in der Abfrage durchzuführen.
Weiteres dazu findet Ihr in der Anleitung im Sharepoint : https://matildafoodtech-my.sharepoint.com/:b:/r/personal/thuan_vo_matildafoodtech_com/Documents/cloudMenu%20and%20MBS/Matilda%20-%20Csv%20-%20Export.pdf?csf=1&web=1&e=pn4Ija Dieses Tool benötigt die Aktivierung vom cM - Team. Danach befindet es sich wie die anderen Module in der linken Navigationsseite.
| Inhalt |
|---|
1. Wie Nutze ich das Tool?
Im Ersten Schritt muss man auf die blaue Leiste Klicken.
...
Dort kann nun der Button “Try it out” geklickt werden.
...
Dies führt dazu, dass nun der Export ausgewählt werden kann und die Suchparamater verändert werden können.
...
Durch einen Klick auf die “ansichten_uebersicht“ erscheint ein Dropdown mit den bisherigen Exportmöglichkeiten
...
Um eine Datenausgabe mit „allen“ Daten des Exports zur erstellen dürfen nur noch die geschweiften Klammern vorhanden sein
! ACHTUNG: !
Bei sehr großen Datenmengen kann es dazu kommen, dass die Suche sehr lange dauert oder abstürzt. Daher wird empfohlen, dass sie zu einem bestimmten Grad eingeschränkt wird
...
Durch einen Klick auf den „Execute“ Button wird nach einer kurzen Verzögerung das Ergebnis unten angezeigt und ein „Download“ Button bereitgestellt.
...
Bei der “ansichten_uebersicht“ handelt es sich um eine Auflistung der möglichen Exporte und der „Spalten“ nach denen Sortiert werden kann.
(Erster Wert: Ansicht, Zweiter Wert: Spalten, der Dritte Wert kann ignoriert werden)
Die “benutzer“ ansicht kann nach nachname, vorname, loginname, kostenstelle und der bestellwertgrenze gefiltert werden.
Dabei ist zu beachten, dass der Filterwert klein geschrieben werden muss und entweder zusammengeschrieben (kostenstelle) oder mit _ getrennt wird (menu_name)
(Beispiel:
•"benutzer";"nachname";"varchar"
•"benutzer";"vorname";"varchar"
•"benutzer";"loginname";"username"
•"benutzer";"kostenstelle";"varchar"
•"benutzer";"bestellwertgrenze";"int4"
•"co2";"menu_plan_name";"varchar"
•"co2";"menu_line_name";"varchar"
•"co2";"menu_name";"varchar"
•"co2";"datum";"date"
•"co2";"co2";"text" )
...
{
"bestelldatum" : "lte.2023-05-10",
"lieferanten_name" : "like.chef"
}
→ Diese Suche beschränkt das Bestelldatum und den Lieferanten Namen.
•Bei der Suche muss die dargestellte Form Beachtet werden.
-Die Spalte nach der Sortiert wird in Einführungszeichen
-Doppelpunkt
-Operator und Filterwert von einem Punkt getrennt in Einführungszeichen
-Beim starten eines zweiten Filterwertes muss ein Komma die erste Zeile beenden
•Es ist NICHT möglich Bestelldaten 2 mal zu verwenden und somit einen Zeitraum festzulegen.
Dafür gibt es den „between“ Operator.
2. Operatoren
Mögliche Operatoren:
Eq => Werte sind Gleich
Lt => kleiner als
Lte => kleiner gleich
Gt => größer als
Gte => größer gleich
Between => Werte liegen dazwischen
Like => für Textbegriffe wobei nur ein Teil des Textes genügt
Der Between Operator:
Der “between“ – Operator kann genutzt werden um einen Bereich einzugrenzen
{
“bestelldatum“ : “between.2023-02-01.2023-03-01“
}
Diese Suche begrenzt das Ergebnis auf solche, dessen Bestelldatum zwischen dem 1. Februar 2023 und dem 1. März 2023 liegen. Bei manchen Datensätzen wird dazu geraten den 1.März statt dem letzten Tag im Februar zu nehmen, weil Daten in der Datenbank teilweise mit angefangen Tagen zum nächsten Tag gezählt werden.
ACHTUNG: Der erste Wert muss immer kleiner oder früher als der zweite Wert sein und sie werden mit einem PUNKT voneinander getrennt
Da es sich um ein vorläufiges Frontend handelt kommt es zu Verlangsamungen bei großen Anfragen
ES IST ZWINGEND NOTWENDIG das Fenster zu aktualisieren nachdem Download der gewünschten CSV Datei stattgefunden hat, damit der Speicher sich leert und der Browser somit nicht abstürzt.
Um die Daten anderen Leuten bereit zustellen kann nun nachdem die Daten richtig gefiltert werden die URL verschickt werden. Dabei ist aber folgendes zu beachten. Die in der Dokumentation bereitgestellte URL beinhaltet ein „API“ zuviel. Wenn sie dieses entfernen und einem Benutzer zuschicken, welcher in cloudMenu eingeloggt ist, wird die CSV Export Datei direkt heruntergeladen.
3. Sonstiges für Entwickler
Es ist möglich sich ein Access Token aus der API zu generieren und via Skript dieses dem Header einer Url Anfrage hinzuzufügen, um somit den manuellen Login zu umgehen.
...
4. Csv-Datei in Excel öffnen/importieren
Um die erhaltene Datei in Excel zu öffnen, MUSS diese importiert werden, sodass Excel die Daten richtig interpretiert
•Excel öffnen und eine neue Datei erstellen
•Oben in der Symbolleiste Datei -> Importieren
•Dort erscheint dann folgendes Fenster
...
Da dann CSV-Datei auswählen und importieren klicken
Im Nächsten Fenster muss dann die heruntergeladene CSV-Datei ausgewählt werden
...
Nun muss man die Optionen mit Trennzeichen versehen auswählen und bei Dateiursprung Unicode(UTF-8) auswählen
...
Als Trennzeichen muss dann nur noch das Semikolon ausgewählt werden
...
In diesem Fenster könnte man die Importierung Zeile für Zeile anpassen, dies ist aber unnötig.
Wichtig!: Hier muss noch mal auf erweitert geklickt werden
...
Hier muss man das Dezimaltrennzeichen auswählen, in unserem Fall ist es ein Punkt. Und beim 1000er Trennzeichen die Leere Option wählen, dadurch werden die Werte nicht ins Datumsformat überführt.