Befehle zur tabellarischen Transformation

Um DSV-Daten (Delimiter-Separated Values) für den Upload vorzubereiten, z. B. um Tabellendaten in das erforderliche Format zu bringen, fügen Sie einen Schritt in eine Kette ein, der einen Verbindungsbefehl für die Tabellentransformation verwendet. Zum Beispiel:

Aufteilung von Datensätzen basierend auf dem Inhalt eines Datensatzes
Filter auf der Grundlage von Regeln
Kombinieren Sie Datensätze aus verschiedenen Quellen

Um diese Befehle zu aktivieren, erstellt ein IT-Administrator zunächst einen Tabular Transformation Connector.

Kopfzeile hinzufügen

Um einer CSV-Datei (Comma-Separated Values) eine Kopfzeile hinzuzufügen, verwenden Sie den Befehl Add Header.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei ein, zu der die Kopfzeilen hinzugefügt werden sollen.
Trennzeichen	Wählen Sie das Trennzeichen, das zur Trennung von Spalten in der Eingabedatei verwendet wird.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Kopfzeile	Geben Sie den gesamten Inhalt der Kopfzeile ein. Trennen Sie jede Überschrift mit einem Trennzeichen, z. B. `Spalte1,Spalte2,Spalte3`.
Trennzeichen für die Kopfzeile	Geben Sie das Trennzeichen ein, das zur Trennung von Überschriften in der Kopfzeile verwendet wird, z. B. `,`

Ausgaben

Ausgabe	Ausgangstyp
CSV mit Kopfzeilen	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler

Zeilennummern hinzufügen

Um dem DSV in der ersten Spalte Zeilennummern hinzuzufügen, verwenden Sie den Befehl Add Row Numbers.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei ein, zu der Zeilennummern hinzugefügt werden sollen.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Geben Sie das Trennzeichen ein, das zur Trennung von Spalten in der Eingabedatei verwendet wird.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe von Zeilennummern hinzufügen	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Erweiterte Abfrage

Um eine SQL-Abfrage für eine oder mehrere CSV-Dateien auszuführen, verwenden Sie den Befehl Erweiterte Abfrage. Sie können auch andere Dateien verbinden, die Sie an diesen Befehl anhängen.

Hinweis: Dieser Befehl unterstützt `SELECT` Anweisungen und ergänzende `JOIN` Anweisungen, aber nicht Anweisungen wie `INSERT`, `UPDATE` oder `CREATE`. Zum Einfügen von Zeilen verwenden Sie den Befehl Stapeldateien, zum Aktualisieren von Zeilen den Befehl Suchen und Ersetzen.

Eigenschaften

Eigenschaft	Einzelheiten
Tabellen	Geben Sie alle Dateien ein, die in der Abfrage verwendet werden sollen, sowie deren Tabellennamen.
Abfrage	Geben Sie die auszuführende SQL-Abfrage ein, als SQLite-Syntax: Wenn Spaltennamen oder Bezeichner Leerzeichen oder Sonderzeichen enthalten, verwenden Sie Klammern. Zum Beispiel: `[Spalte A], [Spalte B]`. Um Daten mit zwei Dezimalstellen zu formatieren, verwenden Sie die Syntax `SELECT PRINTF('%.2f',(SUM(DATA))) AS EBITDA FROM HFMDat`. Um die erste Instanz eines Duplikats auszuwählen, z. B. wenn zwei Datensätze die gleiche `ID` haben, verwenden Sie die Syntax `select * from group by ID having MIN(ID) ORDER BY ID`. Um mehrere Zeichenketten miteinander zu verknüpfen, verwenden Sie den Operator `\|\|` wie z. B. `string1 \|\| string2 [ \|\| string_n ]`.
Eingabebegrenzer	Wählen Sie das Trennzeichen, das in Tabellen verwendet wird, sowie die Verknüpfungsdateien.
Begrenzungszeichen für die Ausgabe	Wählen Sie das Trennzeichen, das in den Abfrageergebnissen verwendet werden soll.
Vorschau	Um eine Vorschau der Abfrageergebnisse zu drucken, markieren Sie dieses Feld.

Der Befehl Advanced Query versucht automatisch, den Datentyp einer Spalte zu bestimmen. Um führende Nullen für einen Wert beizubehalten, den der Befehl fälschlicherweise für eine ganze Zahl hält, verwenden Sie die Befehle Suchen und Ersetzen - wobei Regex und Ersetzen nur ausgewählt sind -, um einfache Anführungszeichen (') um die Werte der Spalte hinzuzufügen und sie dann nach Abschluss des Befehls Erweiterte Abfrage zu entfernen:

Um einfache Anführungszeichen hinzuzufügen, suchen Sie (\d+) und ersetzen Sie durch '1 $'.
Um einfache Anführungszeichen zu entfernen, suchen Sie '(\d+)' und ersetzen Sie durch 1 $.

Wenn Regex ausgewählt ist, verwendet der Befehl Suchen und Ersetzen die Klammern (()), um die Gruppe oder Zeichen zu erfassen, und ersetzt sie dann als ersten Parameter $1. Um mehrere Erfassungen zu erstellen, verwenden Sie aufeinanderfolgende Sätze von Klammern und inkrementelle Werte wie $2.

Ausgaben

Ausgabe	Ausgangstyp
Ergebnis	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Begrenzungszeichen ändern

Um das Trennzeichen in einer CSV-Datei zu ändern, verwenden Sie den Befehl Change Delimiter.

Hinweis: Um der RFC-Spezifikation zu entsprechen, verwenden Sie stets nur ein einzelnes Zeichen als Trennzeichen, vorzugsweise ein Komma oder ein Tabulatorzeichen.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Eingabebegrenzer	Geben Sie das derzeit in der Eingabedatei verwendete Trennzeichen ein. Für ein Tabulatorzeichen geben Sie `\t` ein.
Begrenzungszeichen für die Ausgabe	Geben Sie das Begrenzungszeichen ein, das nach der Umwandlung verwendet werden soll. Für ein Tabulatorzeichen geben Sie `\t` ein.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Leere Zeilen beibehalten	Markieren Sie dieses Feld, um leere Zeilen in Ihrer Ausgabe zu erhalten. Sie werden standardmäßig entfernt.

Ausgaben

Ausgabe	Ausgangstyp
CSV-Ergebnis	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler

Zeilenumbrüche ohne Anführungszeichen bereinigen

Um zu versuchen, eine Datei zu bereinigen, die mit Ausnahme der nicht in Anführungszeichen gesetzten Zeilenumbrüche RFC-konform ist, verwenden Sie den Befehl Clean Unquoted Newlines. Verwenden Sie diesen Befehl zum Beispiel, um Datendateien mit inkonsistenten Zeichen für Wagenrücklauf oder Zeilenumbruch zu verarbeiten.

Hinweis: Dieser Befehl bereinigt nur neue Zeilen ohne Anführungszeichen. Andere, nicht konforme Probleme führen weiterhin zum Scheitern des Datensatzes.

Eigenschaften

Eigenschaft	Einzelheiten
Vorschau Ergebnis	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau des Ergebnisses im Protokoll des Befehls anzuzeigen.
Eingabedatei	Geben Sie die zu bereinigende Datei ein.
Datei-Begrenzungszeichen	Wählen Sie das Begrenzungszeichen für jede Spalte in der Eingabedatei.
Ungepaarte Anführungszeichen zulassen	Aktivieren Sie dieses Kontrollkästchen, damit Anführungszeichen in Feldern ohne Anführungszeichen und nicht doppelte Anführungszeichen in Feldern mit Anführungszeichen angezeigt werden.
Anhängenden Text anfügen	Um alle einspaltigen Zeilen ohne Trennzeichen in der Eingabedatei an den letzten Wert der letzten Spalte des vorherigen Datensatzes anzuhängen, markieren Sie dieses Feld.

Ausgaben

Ausgabe	Ausgangstyp
Bereinigte Ausgabe von Zeilenumbrüchen	Datei
Anzahl der Zeilen	Ganzzahl

Hinweis: Die Ausgabe Zeilenzählung liefert die Gesamtzahl der Datensätze - einschließlich der Kopfzeile - in der Ausgabe Bereinigte Zeilenumbrüche.

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Die Ausgabe der bereinigten Zeilenumbrüche konnte nicht erstellt werden

Spaltenfilter

Um die DSV-Spalten mit Überschriften zu filtern, die dem angegebenen Muster entsprechen, verwenden Sie den Befehl Column Filter.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Typ des Musters	Wählen Sie die Art des Musters, nach dem gefiltert werden soll: `Index` zum Filtern nach Spaltenindex `Exakt` zum Filtern nach einer durch Komma getrennten Liste von exakten Werten `Regex` zum Filtern nach einem regulären Ausdruck
Muster	Geben Sie das Muster ein, mit dem die Spalten abgeglichen werden sollen. Wenn Mustertyp `Index` ist, verwenden Sie Bereichsangaben wie `0:5,7:8,10:15`. Hinweis: Die erste Spalte hat den Indexwert „0“, nicht „1“.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Umgekehrt	Um die übereinstimmenden Spalten beizubehalten und alle anderen zu entfernen, markieren Sie dieses Feld.

Ausgaben

Ausgabe	Ausgangstyp
Ausgang des Spaltenfilters	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Dateien zusammenführen

Um mehrere Dateien mit tabellarischen Datenquellen horizontal in einem einzigen CSV-Datensatz zusammenzuführen, verwenden Sie den Befehl Concat Files.

Eigenschaften

Eigenschaft	Einzelheiten
Quelldateien	Geben Sie die zu verkettenden Dateien ein.
Vorschau Ergebnis	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau des Ergebnisses im Protokoll des Befehls anzuzeigen.
Datei-Begrenzungszeichen	Wählen Sie das Trennzeichen, das in Quelldateien verwendet wird.

Ausgaben

Ausgabe	Ausgangstyp
Zusammengeführte CSV	Datei
Anzahl der Datensätze	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	CSV-Generierung fehlgeschlagen

CSV in XLSX konvertieren

Um eine CSV-Datei in eine Microsoft Excel®-Arbeitsmappe (XLSX) zu konvertieren, verwenden Sie den Befehl CSV in XLSX konvertieren.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei ein, die in XLSX konvertiert werden soll.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Blattname	Geben Sie den Namen des zu erstellenden Blatts in der Excel-Arbeitsmappe ein.
Ausgabedatei	Geben Sie den Pfad an, unter dem die Datei gespeichert werden soll (optional). Bei Verwendung als Ausgabe für einen anderen Befehl in der Kette, leer lassen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe XLSX	Datei

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente

JSON in CSV umwandeln

Um eine JSON-Datei in eine CSV-Datei zu konvertieren, verwenden Sie den Befehl Convert JSON to CSV.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die JSON-Datei ein, die in CSV konvertiert werden soll.
Ausgabedatei	Geben Sie den Pfad an, unter dem die neue CSV-Datei gespeichert werden soll. Bei Verwendung als Ausgabe für einen anderen Befehl in der Kette, leer lassen.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe CSV	Datei

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente

In Kreuztabelle umwandeln

Um einen tabellarischen Datensatz, etwa die Ausgabe einer MDX-Abfrage aus Oracle Essbase®, in ein Kreuztabellen- oder Crosstab-Format zu konvertieren, verwenden Sie den Befehl In Kreuztabelle umwandeln. Dieser Befehl basiert das Kreuztabellenlayout auf den Spalten- und Zeilenköpfen, die als Tupel im eingegebenen Tabellendatensatz definiert sind.

Mit diesem Befehl wird zum Beispiel dieser Datensatz angezeigt:

(Measures, Product, Market) (Actual, Qtr1) (Actual, Qtr2) (Actual, Qtr3) (Actual, Qtr4) (Budget, Qtr1) (Budget, Qtr2) (Budget, Qtr3) (Budget, Qtr4) (Sales, 100–10, New York) 1995.0 2358.0 2612.0 1972.0 2249.0 2220.0 2470.0 1720.0 (Sales, 100–10, Massachusetts) 1456.0 1719.0 1905.0 1438.0 1360.0 1620.0 1800.0 1250.0 (Sales, 100–10, Florida) 620.0 735.0 821.0 623.0 570.0 690.0 770.0 530.0 (Sales, 100–10, Connecticut) 944.0 799.0 708.0 927.0 880.0 750.0 660.0 810.0 (Sales, 100–10, New Hampshire) 353.0 413.0 459.0 345.0 320.0 370.0 430.0 280.0 (Sales, 100–10, California) 1998.0 2358.0 2612.0 1972.0 2480.0 2940.0 3250.0 2530.0 (Sales, 100–10, Oregon) 464.0 347.0 345.0 370.0 570.0 420.0 420.0 470.0

kann zu einer tabulatorgetrennten Kreuztabelle werden:

 Actual Actual Actual Actual Budget Budget Budget Budget Qtr1 Qtr2 Qtr3 Qtr4 Qtr1 Qtr2 Qtr3 Qtr4 Sales 100–10 New York 1995.0 2358.0 2612.0 1972.0 2249.0 2220.0 2470.0 1720.0 Sales 100–10 Massachusetts 1456.0 1719.0 1905.0 1438.0 1360.0 1620.0 1800.0 1250.0 Sales 100–10 Florida 620.0 735.0 821.0 623.0 570.0 690.0 770.0 530.0 Sales 100–10 Connecticut 944.0 799.0 708.0 927.0 880.0 750.0 660.0 810.0 Sales 100–10 New Hampshire 353.0 413.0 459.0 345.0 320.0 370.0 430.0 280.0 Sales 100–10 California 1998.0 2358.0 2612.0 1972.0 2480.0 2940.0 3250.0 2530.0 Sales 100–10 Oregon 464.0 347.0 345.0 370.0 570.0 420.0 420.0 470.0

Beispielkonfiguration

Der Aufbau sieht in etwa so aus:

Eigenschaften

Eigenschaft	Einzelheiten
Vorschau Ergebnis	Markieren Sie dieses Feld, um eine Vorschau des Kreuztabellenformats anzuzeigen.
Eingabedatei	Geben Sie die Datei ein, die in ein Kreuztabellenformat konvertiert werden soll, wobei die Spalten- und Zeilenköpfe als Tupel definiert sind. Hinweis: Richten Sie die Eingabedatei so ein, dass die erste Spalte eine durch Trennzeichen abgegrenzte Gruppe von Werten ist, die horizontal zu verteilen sind, und die erste Zeile eine durch Trennzeichen abgegrenzte Gruppe von Werten, die vertikal zu verteilen sind.
Datei-Begrenzungszeichen	Wählen Sie das Trennzeichen für Spalten in der Eingabedatei.
Feldbegrenzer	Geben Sie das Zeichen ein, das zur Trennung der einzelnen Felder im Kreuztabellenformat verwendet werden soll.
Den Schlüssel weglassen (Zelle A1)	Aktivieren Sie dieses Kontrollkästchen, um die Zelle A1 der Eingabedatei aus dem Kreuztabellenformat auszuschließen. Wenn beispielsweise Zelle A1 (A,B) enthält, sind die Zellen A1 und A2 des Kreuztabellenformats leer; wenn nicht, enthalten sie A und B.

Ausgaben

Ausgabe	Ausgangstyp
Kreuztabellenbericht	Datei
Anzahl der Zeilen	Ganzzahl

Hinweis: Die Ausgabe Zeilenzahl liefert die Gesamtzahl der Zeilen im Kreuztabellenbericht, einschließlich aller Kopfzeilen.

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente

XLSX in CSV konvertieren

Die Version dieses Befehls für die tabellarische Transformation wurde eingestellt. Alle bestehenden Ketten, die diesen Befehl verwenden, funktionieren weiterhin, aber es können keine neuen Instanzen erstellt werden.

Stattdessen empfehlen wir, den Befehl Worksheet to CSV des Excel-Connectors zu verwenden.

Spalte kopieren

Um eine Spalte aus einer DSV-Datei zu kopieren, verwenden Sie den Befehl Copy Column.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Spaltenname	Geben Sie den Namen der zu kopierenden Spalte ein.
Neuer Spaltenname	Geben Sie den Namen der resultierenden Kopie der Spalte ein.
Index einfügen	Geben Sie den Spaltenindex ein, an dem die Kopie der Spalte eingefügt werden soll.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe der kopierten Spalte	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Wert extrahieren

Um einen Wert aus einer DSV-Datei anhand des Zeilen- und Spaltenindexes zu extrahieren, verwenden Sie den Befehl Extract Value.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Zeilenindex	Geben Sie die Zeilennummer ein, aus der der Wert extrahiert werden soll, wobei die erste Zeile in der Eingabedatei `1` lautet.
Spaltenindex	Geben Sie die Spaltennummer des Zeilenindex ein, aus dem extrahiert werden soll. Um die gesamte Zeile zu extrahieren, lassen Sie sie leer.

Ausgaben

Ausgabe	Ausgangstyp
Zeile	JSON
Wert	Zeichenfolge

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler

Zeilen filtern

Um Zeilen des DSV nach einem regulären Ausdruck (regex) oder einer exakten Übereinstimmung einer oder mehrerer Spalten in der Zeile zu filtern, verwenden Sie den Befehl Filter Rows.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Muster finden	Geben Sie das Muster ein, das für die Suche nach Übereinstimmungen verwendet werden soll.
Typ des Übereinstimmungsmusters	Wählen Sie aus, ob ein `Regex` oder `Exact` Muster verwendet werden soll.
Groß- und Kleinschreibung wird nicht berücksichtigt	Um die Groß- und Kleinschreibung des Textes zu ignorieren, markieren Sie dieses Feld.
Umgekehrt	Um alle übereinstimmenden Zeilen zu behalten und den Rest zu verwerfen, markieren Sie dieses Feld.
Spalten suchen	Geben Sie eine durch Kommata getrennte Liste von Spaltenindizes ein, auf die die Suche beschränkt werden soll.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Transformationsergebnisse anzuzeigen

Hinweis: Der Befehl Filter Rows erwartet eine ordnungsgemäße DSV-Datei mit Kopfzeilen. Um die erste Zeile einer Datei ohne Kopfzeilen herauszufiltern, verwenden Sie den Befehl `Find` von einer File Utilities-Verbindung.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe gefilterter Zeilen	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Suchen und ersetzen

Um Spaltenwerte in den Daten auf der Grundlage eines regulären Ausdrucks, einer Volltextzeichenfolge oder eines Spaltenindex zu suchen und zu ersetzen, verwenden Sie den Befehl Suchen und Ersetzen.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie an, ob die Originaldatei oder eine Kopie ausgegeben werden soll: Um die Originaldatei mit den aktualisierten Spaltenwerten auszugeben, geben Sie dieselbe Datei wie Eingabedatei ein. Um eine Kopie des Originals mit den aktualisierten Spaltenwerten auszugeben, geben Sie den Namen der neuen Datei ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Muster finden	Geben Sie den regulären Ausdruck, die Textzeichenfolge oder den Spaltenindex ein, der zur Identifizierung der zu ersetzenden Werte verwendet werden soll, basierend auf Match pattern type.
Typ des Übereinstimmungsmusters	Wählen Sie aus, wie die zu suchenden Spaltenwerte identifiziert werden sollen: Um Werte anhand eines regulären Ausdrucks zu suchen, wählen Sie `Regex`. Um Werte zu finden, die mit einer vollständigen Textzeichenfolge übereinstimmen, wählen Sie `Exakt`. Um Werte anhand ihrer Spalte zu finden, wählen Sie `Index`. Hinweis: `Exakt` entspricht der vollständigen Zeichenfolge in jeder Spalte. Um einen Teilwert innerhalb einer Spalte zu suchen und zu ersetzen, wählen Sie `Regex` und Nur Übereinstimmungen ersetzen.
Ersetzungswert	Geben Sie den Text ein, durch den die übereinstimmenden Werte ersetzt werden sollen. Hinweis: Wenn Abgleichsmustertyp `Index` ist, ersetzt der Ersatzwert alle Werte der übereinstimmenden Spalte.
Groß- und Kleinschreibung wird nicht berücksichtigt	Um die Groß- und Kleinschreibung des Textes zu ignorieren, markieren Sie dieses Feld.
Nur Übereinstimmungen ersetzen	Wenn Match pattern type `Regex` ist, markieren Sie dieses Feld, um nur den übereinstimmenden Text durch den Ersetzungswert zu ersetzen.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Spalten	Geben Sie eine durch Kommata getrennte Liste von Spalten ein, auf die der Befehl angewendet werden soll, mit `0` für die erste Spalte. Zum Beispiel beschränkt `0,1,2,3` den Befehl auf die ersten vier Spalten.

Hinweis: Um dieselbe Eingabe für Ersetzungswert auf mehrere Werte anzuwenden, verwenden Sie einen regulären Ausdruck als Eingabe für , z. B. `(?:Variance|Variance %|All Periods|FY15|YTD)`.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe von „Suchen und Ersetzen“	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Spalte einfügen

Um eine Spalte in eine DSV-Datei einzufügen, verwenden Sie den Befehl Spalte einfügen.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Text der Überschrift	Geben Sie den Namen der neuen Spaltenüberschrift ein.
Wert der Daten	Geben Sie den Text ein, der in die neue Spalte eingefügt werden soll.
Index einfügen	Geben Sie den Spaltenindex ein, an dem die neue Spalte eingefügt werden soll.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Hinweis: Um mehrere Spalten einzufügen, fügen Sie der Eingabedatei eine Spalte mit der Überschrift `EMPTY_REPLACED_HEADER`und dem Wert `EMPTY_REPLACED_VALUE`für jede Zeile hinzu. Mit der Verbindung File Utilities, verwenden Sie die Befehle `Suchen und Ersetzen`, um den Platzhalter für die Überschrift durch die gewünschte Spaltenüberschrift und den Platzhalter für den Wert durch eine Zeichenkette mit der gewünschten Anzahl von Kommas zu ersetzen.

Ausgaben

Ausgabe	Ausgangstyp
Spaltenausgabe einfügen	Datei
Anzahl der Datensätze	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Spalten verbinden

Um mehrere Spalten einer DSV-Datei zu verbinden und optional die verwendeten Spalten zu verwerfen, verwenden Sie einen Join Columns Befehl.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das Begrenzungszeichen der Eingabedatei.
Index der verbundenen Spalten	Geben Sie den Zahlenindex für die neue Spalte ein. Für die erste Spalte geben Sie `0` ein.
Typ des Übereinstimmungsmusters	Wählen Sie die Art des Musters aus, nach dem Sie Spalten suchen möchten: Um nach der Position der Spalte zu suchen, wählen Sie Index. Um eine durch Kommas getrennte Liste von Überschriften einzugeben, wählen Sie Exakt. Um regulären Ausdruck zu verwenden, wählen Sie Regex.
Muster abgleichen	Geben Sie das Muster oder den Index ein, mit dem die zu verbindenden Spalten gesucht werden sollen.
Verbundene Spaltenüberschrift	Geben Sie den Namen der neuen Spalte ein, die durch die Verknüpfung erstellt wird.
Text verbinden	Geben Sie den Text ein, der die Werte in der neuen Spalte zusammenfasst, z. B. `-`.
Verwerfen	Aktivieren Sie dieses Kontrollkästchen, um die Spalten zu entfernen, die zur neuen Spalte zusammengeführt wurden.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten 10 Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe der Join-Spalte	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Kopfzeilen zuordnen

Um eine Liste von Kopfzeilen durch eine andere Liste von Kopfzeilen zu ersetzen, verwenden Sie den Befehl Map Headers. Trennen Sie in den Listen die Überschriften durch Kommata, und achten Sie auf die Reihenfolge.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das Begrenzungszeichen der Eingabedatei.
Eingabe-Kopfzeilen	Geben Sie eine Liste der Kopfzeilen ein, die durch neue Werte ersetzt werden sollen, und zwar in derselben Reihenfolge wie Ausgabekopfzeilen.
Kopfzeilen der Ausgabe	Geben Sie eine Liste der neuen Kopfzeilen ein, die in die Ausgabe aufgenommen werden sollen, und zwar in der gleichen Reihenfolge wie Eingabekopfzeilen.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Indizes verwenden	Wenn Input headers numerische Indizes verwendet, markieren Sie dieses Feld.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe der Kopfzeilenzuordnung	Datei
Anzahl der Datensätze	Ganzzahl

Beendigungscodes

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeiner Fehler
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Pivottabelle

Um die Werte in einer Datenspalte als separate Spalten darzustellen, verwenden Sie den Befehl Pivot. Wenn Sie eine Spalte pivotieren, werden die eindeutigen Werte ihrer Zeilen zu neuen Spaltenüberschriften.

Nehmen wir zum Beispiel diese Daten:

YEAR,MEASURE,PRODUCT,MARKET,SCENARIO,Period,Amount FY20,Sales,100-10,Massachusetts,Actual,JAN,125 FY20,Sales,100-10,Massachusetts,Actual,FEB,225 FY20,Sales,100-10,Massachusetts,Actual,MAR,325 FY20,Sales,100-10,Massachusetts,Actual,APR,425 FY20,Sales,100-10,Massachusetts,Actual,MAY,525 FY20,Sales,100-10,Massachusetts,Actual,JUN,625 FY20,Sales,100-10,Massachusetts,Actual,JUL,725 FY20,Sales,100-10,Massachusetts,Actual,AUG,825 FY20,Sales,100-10,Massachusetts,Actual,SEP,925 FY20,Sales,100-10,Massachusetts,Actual,OCT,1025 FY20,Sales,100-10,Massachusetts,Actual,NOV,1125 FY20,Sales,100-10,Massachusetts,Actual,DEC,1225 FY20,COGS,100-10,Massachusetts,Actual,JAN,100 FY20,COGS,100-10,Massachusetts,Actual,FEB,200 FY20,COGS,100-10,Massachusetts,Actual,MAR,300 FY20,COGS,100-10,Massachusetts,Actual,APR,400 FY20,COGS,100-10,Massachusetts,Actual,MAY,500 FY20,COGS,100-10,Massachusetts,Actual,JUN,600 FY20,COGS,100-10,Massachusetts,Actual,JUL,700 FY20,COGS,100-10,Massachusetts,Actual,AUG,800 FY20,COGS,100-10,Massachusetts,Actual,SEP,900 FY20,COGS,100-10,Massachusetts,Actual,OCT,1000 FY20,COGS,100-10,Massachusetts,Actual,NOV,1100 FY20,COGS,100-10,Massachusetts,Actual,DEC,1200

Wenn Sie die Spalte MEASURE pivotieren, die Spalte Amount aggregieren und die übrigen Spalten als Zeilen angeben, ersetzt die Ausgabe die Spalte MEASURE durch Spalten für die Werte Umsatz und COGS und liefert die entsprechenden Beträge:

YEAR,PRODUCT,MARKET,SCENARIO,Period,Sales,COGS FY20,100-10,Massachusetts,Actual,APR,425,400 FY20,100-10,Massachusetts,Actual,AUG,825,800 FY20,100-10,Massachusetts,Actual,DEC,1225,1200 FY20,100-10,Massachusetts,Actual,FEB,225,200 FY20,100-10,Massachusetts,Actual,JAN,125,100 FY20,100-10,Massachusetts,Actual,JUL,725,700 FY20,100-10,Massachusetts,Actual,JUN,625,600 FY20,100-10,Massachusetts,Actual,MAR,325,300 FY20,100-10,Massachusetts,Actual,MAY,525,500 FY20,100-10,Massachusetts,Actual,NOV,1125,1100 FY20,100-10,Massachusetts,Actual,OCT,1025,1000 FY20,100-10,Massachusetts,Actual,SEP,925,900

Wenn Sie die Spalte Zeitraum aus den Zeilen ausschließen, werden alle Zeiträume für jede Kombination der übrigen Zeilen aggregiert:

YEAR,PRODUCT,MARKET,SCENARIO,Sales,COGS FY20,100-10,Massachusetts,Actual,8100,7800

Wenn Sie sowohl die Spalte MEASURE als auch die Spalte Period pivotieren, wird jede eindeutige Kombination ihrer Werte als eigene Spalte angezeigt, z. B. Sales-JAN, Sales-FEB, COGS-JAN usw.:

YEAR,PRODUCT,MARKET,SCENARIO,Sales-JAN,Sales-FEB,Sales-MAR,Sales-APR,Sales-MAY,Sales-JUN,Sales-JUL,Sales-AUG,Sales-SEP,Sales-OCT,Sales-NOV,Sales-DEC,COGS-JAN,COGS-FEB,COGS-MAR,COGS-APR,COGS-MAY,COGS-JUN,COGS-JUL,COGS-AUG,COGS-SEP,COGS-OCT,COGS-NOV,COGS-DEC FY20,100-10,Massachusetts,Actual,125,225,325,425,525,625,725,825,925,1025,1125,1225,100,200,300,400,500,600,700,800,900,1000,1100,1200

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei mit den zu pivotierenden Daten ein.
Trennzeichen	Wählen Sie das Trennzeichen, das zur Trennung der Felder in der Eingabedatei verwendet wird.
Aggregation	Wählen Sie aus, wie geschwenkte Werte aggregiert werden sollen: SUM, um Datensätze mit denselben Zeilenwerten zu einem einzigen Datensatz zusammenzufassen. Empfohlen. NONE, um mehrere Zeilen für einen einzigen Satz von gleichwertigen Werten zu erstellen. Jede Zeile der Pivot-Spalte wird aufgefüllt, aber andere können NULL enthalten.
Zu aggregierende Werte	Geben Sie die Spalte mit den Daten ein, die in die Zeilen der geschwenkten Spalten aufgenommen werden sollen, z. B. die Spalte `Betrag` im vorherigen Beispiel.
Pivot-Spalten	Geben Sie die Spalten mit Zeilenwerten ein, die als Spaltenüberschriften verwendet werden sollen. Wenn mehrere Spalten vorhanden sind, wird für jede eindeutige Kombination der Werte eine eigene Spalte angezeigt.
Spaltentrennzeichen	Wenn mehrere Pivot-Spalten vorhanden sind, geben Sie das Trennzeichen ein, mit dem die Werte in den neuen Spaltenüberschriften getrennt werden sollen.
Pivot-Reihen	Geben Sie die Spalten in der Eingabedatei ein, die beibehalten werden sollen. In der Ausgabe erscheint jede eindeutige Kombination der Werte dieser Spalten als Zeile. Geben Sie nicht die gleichen Spalten ein wie zu aggregierende Werte oder Pivot-Spalten.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der gepivoteten Daten zu erhalten.

Ausgaben

Ausgabe	Ausgangstyp
Pivotiertes Ergebnis	Datei

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Spalten neu anordnen

Um die Spalten einer DSV-Datei neu anzuordnen, verwenden Sie den Befehl Spalten neu anordnen. Sie können Spalten durch ihren Namen oder Index identifizieren.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Spaltenreihenfolgen	Geben Sie ein Array der einzelnen Spalten oder Bereiche aus der Eingabedatei in der Reihenfolge an, in der sie in der transformierten Datei erscheinen sollen. Um Spalten anzugeben, verwenden Sie deren Namen oder Index, beginnend mit `1`. Geben Sie zum Beispiel `4:6` oder `ColA:ColC` ein, um einen Bereich anzugeben, oder `7` oder `ColH` für eine einzelne Spalte. Hinweis: Alle Spalten in der Eingabedatei, die nicht in Spaltenreihenfolgen enthalten sind, erscheinen am Ende der Spalten in der transformierten Datei – in derselben Reihenfolge wie in der Eingabedatei.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der Ergebnisse - Kopfzeile und die ersten 10 Zeilen - in der Befehlsausgabe anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Umgewandelte Datei	Datei
Umgewandelte Zeilen	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen

Zeilen intelligent filtern

Um die Kriterien mehrerer Filtergruppen - basierend auf Text-, Datums- oder Zahlenwerten - auf die Zeilen einer DSV-Datei anzuwenden, verwenden Sie den Befehl Smart Filter Rows. Sie können Zeilen anhand eines regulären Ausdrucks oder einer exakten Übereinstimmung in einer oder mehreren Spalten filtern.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das in der Eingabedatei verwendete Trennzeichen.
Umgekehrt	Aktivieren Sie dieses Kontrollkästchen, um alle Zeilen, die mit Filters übereinstimmen, beizubehalten, anstatt sie zu entfernen.
Filter	Um die Text-, Zahlen- oder Datumsfilter einzurichten, die auf die Eingabedatei angewendet werden sollen, wählen Sie den Operator für die Filtergruppen - UND oder ODER - und konfigurieren Sie die Kriterien für jede Gruppe. Für eine Text-Filtergruppe: Geben Sie unter Column Name den Namen der zu filternden Spalte ein. Um die Groß-/Kleinschreibung von Column Name und Compare Text zu ignorieren, wählen Sie Case Insensitive. Geben Sie unter Bedingung und Text vergleichen die Kriterien für den Wert ein, nach dem die Spalte durchsucht werden soll, z. B. "Ist gleich [Text]" oder "Enthält [Text]". <!--To apply the inverse of the Condition input, such as to match text that does not equal or contain the Compare Text input, select Not.--> <!-- To remove any leading or trailing spaces from matched text, select Trim. --> Für eine Zahlen-Filtergruppe: Wählen Sie unter Format das Format der abzugleichenden Zahl - Ganzzahl oder Dezimal. Wenn es einer von beiden sein könnte, wählen Sie Dezimal. Geben Sie unter Column Name den Namen der zu filternden Spalte ein. Geben Sie unter Bedingung und Testnummer die Kriterien für den Wert ein, nach dem die Spalte durchsucht werden soll, z. B. "Ist gleich [Zahl]" oder "Ist kleiner als [Zahl]". <!--To apply the inverse of the Condition input, such as to match numbers that do not equal the Test Number input, select Not.--> <!-- To match numbers regardless of whether they're positive or negative, select Absolute Value. --> Für eine Datums-Filtergruppe: Geben Sie unter Format den 2. Januar 2006 im Format des abzugleichenden Datums ein, z. B. 2006-01-02. Geben Sie unter Column Name den Namen der zu filternden Spalte ein. Geben Sie unter Bedingung und Datum vergleichen die Kriterien für den Wert ein, nach dem die Spalte durchsucht werden soll, z. B. "Ist gleich [Datum]" oder "Ist kleiner als [Datum]". <!--To apply the inverse of the Condition input, such as to match dates that do not equal the Compare Date input, select Not.-->
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der Ergebnisse in der Befehlsausgabe anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe von intelligenten Filterzeilen	Datei
Anzahl der Datensätze	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Datei teilen

Um eine Datei auf der Grundlage einer Datensatzanzahl in mehrere Dateien aufzuteilen, verwenden Sie den Befehl Split File. Verwenden Sie zum Beispiel diesen Befehl, um kleinere Chunks parallel zu verarbeiten und so die Leistung zu verbessern

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei ein, die in mehrere Dateien aufgeteilt werden soll.
Datei-Begrenzungszeichen	Wählen Sie das Begrenzungszeichen für jede Spalte in der Eingabedatei.
Kopfzeile voranstellen	Aktivieren Sie dieses Kontrollkästchen, um die Kopfzeile der Eingabedatei in jedes erstellte Dateistück aufzunehmen.
Datensätze pro Datei	Geben Sie die maximale Anzahl der Datensätze an, die in jeden Datei-Chunk aufgenommen werden sollen.

Ausgaben

Ausgabe	Ausgangstyp
Geteilte Dateiblöcke	Datei
Anzahl der Chunks	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Die Datei-Chunks konnten nicht erstellt werden

Wert aufteilen

Um eine Spalte anhand eines Werttrennzeichens in mehrere Spalten aufzuteilen, verwenden Sie den Befehl Split Value.

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die zu transformierende Datei ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das Trennzeichen, das zur Trennung von Spalten in der Eingabedatei verwendet wird.
Neue Kopfzeilen	Geben Sie eine Liste der neuen Überschriften ein, die aus dem geteilten Wert erstellt werden sollen, und zwar in dieser Reihenfolge.
Spaltenname	Geben Sie die Überschrift der zu teilenden Spalte ein.
Wertbegrenzer	Geben Sie das Trennzeichen ein, durch das der Wert geteilt werden soll.
Spalte verwerfen	Um die Spalte, die geteilt wird, zu entfernen, markieren Sie dieses Feld.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe von geteilten Werten	Datei
Anzahl der Datensätze	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Dateien stapeln

Um die Werte aus einer Liste von DSV-Dateien (Delimiter-Separated Values) in einer bestimmten Reihenfolge übereinander zu stapeln, verwenden Sie den Befehl Stack Files. Die Kopfzeile aus der ersten Datei wird in die neue Datei übernommen.

Hinweis: Um Dateien mit diesem Befehl stapeln zu können, müssen sie alle die gleiche Anzahl von Spalten haben. Um asymmetrische Dateien zu stapeln, verwenden Sie den File Utils Connector und dessen Befehl Stack Files.

Eigenschaften

Eigenschaft	Einzelheiten
Dateien	Geben Sie die zu stapelnden DSV-Dateien ein.
Ausgabedatei	Geben Sie den Namen der Ergebnisdatei der Transformation ein.
Trennzeichen	Wählen Sie das Trennzeichen, das zur Trennung von Spalten in Dateien verwendet wird.
Eingabedatei	Geben Sie die zu stapelnden Dateien durch ein Komma getrennt ein. Hinweis: Wenn Sie eine Schleife verwenden, ist dieses Feld erforderlich (da die Dateien nicht in den Abschnitt Dateien hochgeladen werden). Der Befehl führt zu einer Fehlermeldung "Datei nicht gefunden", wenn er stattdessen in den Abschnitt Dateien eingefügt wird.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.

Ausgaben

Ausgabe	Ausgangstyp
Ausgabe von Stapeldateien	Datei
Anzahl der Datensätze	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Transponieren

Um alle Felder einer durch Trennzeichen getrennten Datei entlang ihrer horizontalen und vertikalen Achse zu drehen, so dass Zeilen zu Spalten werden und umgekehrt, verwenden Sie den Befehl Transpose. Mit diesem Befehl wird diese CSV-Datei beispielsweise:

id,1,2,3,4name, "Johnson, Smith, and Jones Co.", "Sam Smith",Barney & Co.,Johnson's Autoamount,345.33,933.40,0,2344remark,Pays on time,, "Great to work with.",

wird:

id,name,amount,remark 1,"Johnson, Smith, and Jones Co“,345.33,Pays on time 2,"Sam Smith“,933.40, 3,Barney & Co.,"Great to work with.“ 4,Johnson’s Auto,2344,

Eigenschaften

Eigenschaft	Einzelheiten
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der ersten zehn Zeilen und der Kopfzeile der Ergebnisse der Transformation anzuzeigen.
Eingabedatei	Geben Sie die zu transponierende Datei mit Trennzeichen ein.
Datei-Begrenzungszeichen	Wählen Sie das Begrenzungszeichen für jede Spalte der Eingabedatei.
Stückgröße	Geben Sie die maximale Größe - in MB - jeder zu verarbeitenden Arbeitsdatei an.

Ausgaben

Ausgabe	Ausgangstyp
Transponierte CSV-Datei	Datei
Anzahl der Datensätze	Ganzzahl

Hinweis: Anzahl der Datensätze liefert die Gesamtzahl der Zeilen in Transponierte CSV, nicht einschließlich der Kopfzeile.

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Transposition der Eingabedatei fehlgeschlagen

Unpivot

Um mehrere Datenspalten - z. B. Zeiträume in Finanzdaten - in einer einzigen Spalte mit mehreren Zeilen zu konsolidieren, verwenden Sie den Befehl Unpivot. Nehmen wir zum Beispiel diese Daten:

YEAR,MEASURE,PRODUCT,MARKET,SCENARIO,JAN,FEB,MAR,APR,MAY,JUN,JUL,AUG,SEP,OCT,NOV,DEC FY20,Sales,100-10,New York,Actual,100,200,300,400,500,600,700,800,900,1000,1100,1200 FY20,Sales,100-10,Massachusetts,Actual,125,225,325,425,525,625,725,825,925,1025,1125,1225

Sie können die monatlichen Beträge in die neuen Spalten Zeitraum und Betrag ausgliedern:

YEAR,MEASURE,PRODUCT,MARKET,SCENARIO,Period,Amount FY20,Sales,100-10,Massachusetts,Actual,JAN,125 FY20,Sales,100-10,Massachusetts,Actual,FEB,225 FY20,Sales,100-10,Massachusetts,Actual,MAR,325 FY20,Sales,100-10,Massachusetts,Actual,APR,425 FY20,Sales,100-10,Massachusetts,Actual,MAY,525 FY20,Sales,100-10,Massachusetts,Actual,JUN,625 FY20,Sales,100-10,Massachusetts,Actual,JUL,725 FY20,Sales,100-10,Massachusetts,Actual,AUG,825 FY20,Sales,100-10,Massachusetts,Actual,SEP,925 FY20,Sales,100-10,Massachusetts,Actual,OCT,1025 FY20,Sales,100-10,Massachusetts,Actual,NOV,1125 FY20,Sales,100-10,Massachusetts,Actual,DEC,1225 FY20,Sales,100-10,New York,Actual,JAN,100 FY20,Sales,100-10,New York,Actual,FEB,200 FY20,Sales,100-10,New York,Actual,MAR,300 FY20,Sales,100-10,New York,Actual,APR,400 FY20,Sales,100-10,New York,Actual,MAY,500 FY20,Sales,100-10,New York,Actual,JUN,600 FY20,Sales,100-10,New York,Actual,JUL,700 FY20,Sales,100-10,New York,Actual,AUG,800 FY20,Sales,100-10,New York,Actual,SEP,900 FY20,Sales,100-10,New York,Actual,OCT,1000 FY20,Sales,100-10,New York,Actual,NOV,1100 FY20,Sales,100-10,New York,Actual,DEC,1200

Eigenschaften

Eigenschaft	Einzelheiten
Eingabedatei	Geben Sie die Datei mit den auszugliedernden Daten ein.
Trennzeichen	Wählen Sie das Trennzeichen, das zur Trennung der Felder in der Eingabedatei verwendet wird.
Aggregation	Wählen Sie aus, wie unpivotierte Werte aggregiert werden sollen: SUM, um Datensätze zu aggregieren, wenn ihre Werte in allen Spalten gleich sind. Empfohlen. NONE, um doppelte Zeilen mit dem eindeutigen Datenwert aus jedem Datensatz zu erstellen.
Neue Spaltenbezeichnung	Geben Sie die Überschrift für die Spalte in der Ausgabe mit Zeilen ein, die auf den unpivotierten Spalten basieren. Im vorangegangenen Beispiel: `Zeitraum`.
Überschrift der Datenspalte	Geben Sie die Überschrift für die Spalte in der Ausgabe mit den Daten für die unpivotierten Spalten ein. Im vorigen Beispiel: `Betrag`.
Datenkopfzeilen	Um bestimmte Spalten zu entpivotieren, listen Sie deren Überschriften auf und drücken Sie zwischen den einzelnen Einträgen Eingabe. Im vorigen Beispiel: `JAN`, `FEB`, `MAR`, und so weiter.
Name der ersten Pivot-Spalte	Um einen Bereich von Spalten anhand der Kopfzeile zu entpivotieren, geben Sie den Namen der ersten Spalte des Bereichs ein. Im vorangegangenen Beispiel: `JAN`.
Name der Pivot-Spalte am Ende	Um einen Bereich von Spalten durch die Kopfzeile zu entpivotieren, geben Sie den Namen der letzten Spalte des Bereichs ein. Im vorangegangenen Beispiel: `DEC`. Hinweis: Wenn Sie Name der ersten Pivot-Spalte, aber keinen Namen der letzten Pivot-Spalte eingeben, entpivotiert der Befehl diese und alle Spalten rechts von Name der ersten Pivot-Spalte. Dies kann bei Daten aus rollierenden Prognosen nützlich sein.
Index der Startpivot-Spalte	Um einen Bereich von Spalten nach Position zu entpivotieren, geben Sie den Indexwert der ersten Spalte im Bereich ein. Verwenden Sie einen Null-basierten Index, bei dem die Spalten in der Eingabedatei mit 0 beginnen. Im vorherigen Beispiel ist `5`.
Index der Pivot-Spalte am Ende	Um einen Bereich von Spalten anhand der Position zu entpivotieren, geben Sie den Indexwert der letzten Spalte des Bereichs ein. Verwenden Sie einen Null-basierten Index, bei dem die Spalten in der Eingabedatei mit 0 beginnen. Im vorherigen Beispiel ist `16`. Hinweis: Wenn Sie Index der ersten Pivot-Spalte, aber keinen Index der letzten Pivot-Spalte eingeben, entpivotiert der Befehl diese und alle Spalten rechts von Index der ersten Pivot-Spalte. Dies kann bei Daten aus rollierenden Prognosen nützlich sein.
Vorschau der Ergebnisse	Aktivieren Sie dieses Kontrollkästchen, um eine Vorschau der unpivotierten Ausgabe zu erhalten.

Ausgaben

Ausgabe	Ausgangstyp
Unpivotiertes Ergebnis	Datei

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
1	Fehler	Ungültige Argumente
2	Fehler	Allgemeines Versagen
14	Fehler	Ungültiger Speicherort der Ausgabedatei
15	Fehler	Das in der Eingabedatei verwendete Escape-Zeichen, normalerweise ein `"`

Fehlersuche

Wenn ein Befehl fehlschlägt, prüfen Sie diese häufigen Probleme.

Falsches Begrenzungszeichen

Wenn bei der Konfiguration eines Transformationsbefehls ein falsches Trennzeichen gesetzt wird, wird die Transformation nicht wie erwartet ausgeführt.

Keine gültige CSV-Datei

Handelt es sich bei dem Tabellendatensatz nicht um ein ordnungsgemäßes CSV-Format, wird der Umwandlungsbefehl nicht ausgeführt, da vor der Verarbeitung der Eingabe geprüft wird, ob das Format mit RFC 4180 übereinstimmt. Eine richtige CSV:

Speichert Daten in Klartext unter Verwendung eines Zeichensatzes wie ASCII, Unicode (z. B. UTF-8), EBCDIC oder Shift JIS.
Besteht aus Datensätzen mit einem Datensatz pro Zeile. Die Datensätze sind in Felder unterteilt, die durch Trennzeichen getrennt sind – typischerweise durch ein einzelnes reserviertes Zeichen wie ein Komma, Semikolon oder einen Tabulator. Manchmal kann das Trennzeichen optionale Leerzeichen enthalten.
Hat die gleiche Abfolge von Feldern für jeden Datensatz
Ist in der Regel eine flache Datei oder ein relationaler Datenbericht

Inkonsistente Anzahl von Spalten in jedem Datensatz

Wenn die Datensätze in einem Tabellendatensatz unterschiedliche Spaltenanzahlen haben, erkennt der Umwandlungsbefehl, dass es sich nicht um eine richtige CSV-Datei handelt.

Unterschiedliche Spaltenzahlen

Das Kombinieren zweier korrekter CSV-Tabellendatensätze mit unterschiedlicher Spaltenanzahl funktioniert nicht, und der Befehl Dateien stapeln zeigt einen Fehler an.

Workiva Support Center

Kopfzeile hinzufügen

Eigenschaften

Ausgaben

Beendigungscodes

Zeilennummern hinzufügen

Eigenschaften

Ausgaben

Beendigungscodes

Erweiterte Abfrage

Hinweis: Dieser Befehl unterstützt SELECT Anweisungen und ergänzende JOIN Anweisungen, aber nicht Anweisungen wie INSERT, UPDATE oder CREATE. Zum Einfügen von Zeilen verwenden Sie den Befehl Stapeldateien, zum Aktualisieren von Zeilen den Befehl Suchen und Ersetzen.

Eigenschaften

Ausgaben

Beendigungscodes

Begrenzungszeichen ändern

Hinweis: Um der RFC-Spezifikation zu entsprechen, verwenden Sie stets nur ein einzelnes Zeichen als Trennzeichen, vorzugsweise ein Komma oder ein Tabulatorzeichen.

Eigenschaften

Ausgaben

Beendigungscodes

Zeilenumbrüche ohne Anführungszeichen bereinigen

Hinweis: Dieser Befehl bereinigt nur neue Zeilen ohne Anführungszeichen. Andere, nicht konforme Probleme führen weiterhin zum Scheitern des Datensatzes.

Eigenschaften

Ausgaben

Hinweis: Die Ausgabe Zeilenzählung liefert die Gesamtzahl der Datensätze - einschließlich der Kopfzeile - in der Ausgabe Bereinigte Zeilenumbrüche.

Codes beenden

Spaltenfilter

Eigenschaften

Ausgaben

Beendigungscodes

Dateien zusammenführen

Eigenschaften

Ausgaben

Codes beenden

CSV in XLSX konvertieren

Eigenschaften

Ausgaben

Codes beenden

JSON in CSV umwandeln

Eigenschaften

Ausgaben

Codes beenden

In Kreuztabelle umwandeln

Eigenschaften

Hinweis: Richten Sie die Eingabedatei so ein, dass die erste Spalte eine durch Trennzeichen abgegrenzte Gruppe von Werten ist, die horizontal zu verteilen sind, und die erste Zeile eine durch Trennzeichen abgegrenzte Gruppe von Werten, die vertikal zu verteilen sind.

Ausgaben

Hinweis: Die Ausgabe Zeilenzahl liefert die Gesamtzahl der Zeilen im Kreuztabellenbericht, einschließlich aller Kopfzeilen.

Codes beenden

XLSX in CSV konvertieren

Spalte kopieren

Eigenschaften

Ausgaben

Beendigungscodes

Wert extrahieren

Eigenschaften

Ausgaben

Beendigungscodes

Zeilen filtern

Eigenschaften

Hinweis: Der Befehl Filter Rows erwartet eine ordnungsgemäße DSV-Datei mit Kopfzeilen. Um die erste Zeile einer Datei ohne Kopfzeilen herauszufiltern, verwenden Sie den Befehl Find von einer File Utilities-Verbindung.

Ausgaben

Beendigungscodes

Suchen und ersetzen

Eigenschaften

Hinweis: Exakt entspricht der vollständigen Zeichenfolge in jeder Spalte. Um einen Teilwert innerhalb einer Spalte zu suchen und zu ersetzen, wählen Sie Regex und Nur Übereinstimmungen ersetzen.

Hinweis: Wenn Abgleichsmustertyp Index ist, ersetzt der Ersatzwert alle Werte der übereinstimmenden Spalte.

Hinweis: Um dieselbe Eingabe für Ersetzungswert auf mehrere Werte anzuwenden, verwenden Sie einen regulären Ausdruck als Eingabe für , z. B. (?:Variance|Variance %|All Periods|FY15|YTD).

Ausgaben

Beendigungscodes

Spalte einfügen

Eigenschaften

Ausgaben

Codes beenden

Spalten verbinden

Eigenschaften

Ausgaben

Beendigungscodes

Kopfzeilen zuordnen

Eigenschaften

Ausgaben

Hinweis: Dieser Befehl unterstützt `SELECT` Anweisungen und ergänzende `JOIN` Anweisungen, aber nicht Anweisungen wie `INSERT`, `UPDATE` oder `CREATE`. Zum Einfügen von Zeilen verwenden Sie den Befehl Stapeldateien, zum Aktualisieren von Zeilen den Befehl Suchen und Ersetzen.

Hinweis: Der Befehl Filter Rows erwartet eine ordnungsgemäße DSV-Datei mit Kopfzeilen. Um die erste Zeile einer Datei ohne Kopfzeilen herauszufiltern, verwenden Sie den Befehl `Find` von einer File Utilities-Verbindung.

Hinweis: `Exakt` entspricht der vollständigen Zeichenfolge in jeder Spalte. Um einen Teilwert innerhalb einer Spalte zu suchen und zu ersetzen, wählen Sie `Regex` und Nur Übereinstimmungen ersetzen.

Hinweis: Wenn Abgleichsmustertyp `Index` ist, ersetzt der Ersatzwert alle Werte der übereinstimmenden Spalte.

Hinweis: Um dieselbe Eingabe für Ersetzungswert auf mehrere Werte anzuwenden, verwenden Sie einen regulären Ausdruck als Eingabe für , z. B. `(?:Variance|Variance %|All Periods|FY15|YTD)`.