%slice

Datenfelder einer CSV Datenzeile in separate Zeilen aufteilen

Verwendung

Mit dieser Funktion können Sie Datenfelder aus einer einzelnen CSV Zeile in mehrere separate Zeilen für die Ausgabe umbrechen.
Je nach slice Modus werden die neu erstellten Zeilen auf unterschiedliche Weise erstellt.

Allerdings entfaltet dieser Befehl seine volle Wirkung erst zusammen mit dem Befehl merge. Daten aus verschiedenen Dateien können je nach den Bedürfnissen des Benutzers zu nützlichen Datenzeilen geformt werden.

Schneiden/Einzelne: Das erste Feld oder die ersten Felder bleiben in jeder erzeugten Zeile gleich, gefolgt von zwei neuen Feldern: der jeweiligen Spaltenüberschrift und dem Inhalt.
Dieser Befehl kann nur zur Ausgabesteuerung verwendet werden, nicht zum Lesen einer CSV Datei.

%slice[startfield] %slice[startfield]=[titlecolumn_name],[valuecolumn_name]

%slice: Beginnend mit der zweiten Spalte werden alle nachfolgenden Felder in separate Zeilen aufgeteilt.
Jede Ausgabezeile besteht aus drei Feldern:
Feld[1], dem jeweiligen Spaltennamen in einer separaten Spalte und dem jeweiligen Feldinhalt in einer separaten Spalte.
%slice[4]: Beginnend mit der vierten Spalte (4) werden die nachfolgenden Felder in einzelne Zeilen unterteilt.
Jede Ausgabezeile besteht aus den vorangehenden Feldern [1]-[3], dem Spaltennamen in einer separaten Spalte und dem Feldinhalt in einer separaten Spalte.
%slice["Field Name"]: Beginnend mit der Spalte Field Name sind die nachfolgenden Felder in einzelne Zeilen unterteilt.
Jede Ausgabezeile besteht aus allen Feldern vor der Spalte Field Name, dem Spaltennamen in einer separaten Spalte und dem Feldinhalt in einer separaten Spalte.
%slice["Field Name"]=[NewColumnTitle],[NewValueTitle]: Beginnend mit der Spalte Field Name sind die nachfolgenden Felder in einzelne Zeilen unterteilt.
Jede Ausgabezeile besteht aus allen Feldern vor der Spalte Field Name, dem Spaltennamen in einer separaten Spalte namens [NewColumnTitle] und dem Feldinhalt in einer separaten Spalte namens [NewValueTitle].

Besonderes Merkmal

Da die neue Tabelle einige zusätzliche Spalten für jeden "aufgeschnittenen" Wert haben wird, gibt es eine Reihe von neuen generischen Spaltentiteln COLUMN_TITLE und COLUMN_VALUE während der Ausgabe erstellt.
Wenn der Befehl %merge verwendet wird, gibt es sogar neue Spalten für jede Spalte jeder zusammengeführten Datei. Siehe auch %merge.

Diese Spalten sollten nach Belieben umbenannt werden.
Verwenden Sie dazu zum Beispiel: +rename[COLUMN_TITLE]="Mein neuer Titel" +rename[COLUMN_VALUE]="Mein neuer Wert" um der Bedeutung der Spalten in der Ausgabedatei zu entsprechen.

Beispiel

Dies ist ein tabellarischer Wochenplan als csv:

Weekday	Breakfast	Lunch	Dinner
Monday	Muesli	Colorful garden salad	Noodle soup
Tuesday	Muesli	Sandwiches	Tomato soup
Wednesday	Muesli	Lamb's lettuce	Potato soup
Thursday	Bread rolls	Coleslaw	Chicken soup
Friday	2 rolls	Tomato salad	Fish soup

und nach der Anwendung

%slice

wird dies zu

Weekday	COLUMN_TITLE	COLUMN_VALUE
Monday	Breakfast	Muesli
Monday	Lunch	Colorful garden salad
Monday	Dinner	Noodle soup
Tuesday	Breakfast	Muesli
Tuesday	Lunch	Sandwiches
Tuesday	Dinner	Tomato soup
Wednesday	Breakfast	Muesli
Wednesday	Lunch	Lamb's lettuce
Wednesday	Dinner	Potato soup
Thursday	Breakfast	Bread roll
Thursday	Lunch	coleslaw
Thursday	Dinner	Chicken soup
Friday	Breakfast	2 rolls
Friday	Lunch	tomato salad
Friday	Dinner	fish soup

Hier sollten Sie der Vollständigkeit und besseren Lesbarkeit halber auch die Titel umbenennen.
Verwenden Sie dazu die folgenden Befehle: +rename[COLUMN_TITLE]=Tageszeit +rename[COLUMN_VALUE]=Mahlzeitwerden sinnvolle Spaltenüberschriften hinzugefügt.

Besondere Modi

Es gibt einige Besonderheiten, wenn Sie %slice zusammen mit %merge verwenden.
In diesem Fall wird für jede zusammengeführte Datei eine Spalte [Feldname] (Feldwert, %slicecompact) oder sogar zwei Spalten (Feldname und Wert, %slicedistinct) zu jeder Datenzeile hinzugefügt.
=> Eigene Seiten mit Beispielen!

%slice/distinct[Offset] beginnend nach [Offset] teilt alle Spalten in eigene Zeilen auf
(%slice ist das gleiche wie %slice[1] ist das gleiche wie %slicedistinct[1])
mit %merge: für jede Merge-Datei, beginnend mit Offset, für jede Merge-Datei zwei Spalten hinzufügen, mit Feldname und Feldwert
mit zwei Mergedateien: Sie müssen einen festen Start-Offset in jeder zusammengeführten Datei angeben: @slice/distinct[InputOffset]@[MergeOffset],[MergeOffset]
Dies ist für das Hinzufügen beliebiger Spalten aus der/den zusammengeführten Datei(en) gedacht.

%slice/compact[Feldname] beginnt nach [Feldname] und teilt alle Spalten in eigene Zeilen auf
(wenn ohne %merge verwendet, ist dies identisch mit %slice[Feldname] bzw. %slice/distinct[Feldname])
Dies funktioniert nur, wenn alle Spalten Spaltenüberschriften haben und wenn die Merge-Dateien die gleichen Spaltennamen enthalten!
Anwendungsbeispiel: Attribute in mehreren Sprachen

mit %merge: fügen Sie für jede zusammengeführte Datei eine Spalte [Feldname] mit dem Feldwert von [Feldname] hinzu
mit zwei Merge-Dateien: keine festen Offsets notwendig, da der Offset von [Feldname] jedes Mal neu ausgewählt wird
Dies dient dazu, Spalten aus der/den zusammengeführten Datei(en) mit demselben Namen zu kombinieren.