SPLITVALUES-Befehl
Konzept-Informationen
Teilt eine Tabelle in zwei oder mehrere Tabellen anhand der eindeutigen Werte in einem Schlüsselfeld auf. Ausgabetabellen verwenden den eindeutigen Wert als Tabellennamen, mit einem optionalen Textpräfix.
Hinweis
Die maximale Anzahl eindeutiger Schlüsselfeldwerte, die bei der Aufteilung einer Tabelle unterstützt werden, beträgt 450.
Syntax
SPLITVALUES ON Schlüsselfeld <PREFIX Präfixtext> {FIELDS Feldname <AS Neuer_Feldname> <...n>|FIELDS ALL} <Name_der_verbundenen_Tabelle.ALL <...n>> <IF Test> <TO Ordnername> <WHILE Test> <FIRST Bereich|NEXT Bereich>
Parameter
| Name | Beschreibung |
|---|---|
|
ON Schlüsselfeld |
Das für die Tabellenaufteilung zu verwendende Schlüsselfeld. Das Schlüsselfeld kann vom Typ „Zeichen“, „Numerisch“, „Datumzeit“ oder „Logisch“ sein. Wenn Sie mehrere Schlüsselfelder verwenden möchten, erstellen Sie ein berechnetes Feld, das die Schlüsselfelder verkettet, und verwenden Sie das berechnete Feld als Schlüsselfeld. Hinweis Das Schlüsselfeld wird automatisch in die Ausgabetabelle aufgenommen und muss nicht mit FIELDS angegeben werden. |
|
PREFIX Präfixtext Optional |
Eine alphanumerische Zeichenfolge, die als Präfix für alle Namen von Ausgabetabellen verwendet wird. Wenn Sie PREFIX nicht angeben, verwenden Ausgabetabellen nur den eindeutigen Schlüsselfeldwert als Tabellenname. Das Tabellennamenpräfix ist auf 32 alphanumerische Zeichen beschränkt. Tabellennamen sind insgesamt auf 64 alphanumerische Zeichen beschränkt. Wenn die Kombination aus einem Tabellennamenpräfix und einem Schlüsselfeldwert 64 Zeichen überschreitet, wird der Tabellenname von rechts abgeschnitten. Das Tabellennamenpräfix kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonder- oder Leerzeichen. Das Präfix darf nicht mit einer Ziffer beginnen. Tipp Verwenden Sie bei einem Schlüsselfeld vom Typ „Datumzeit“ oder „Numerisch“ ein Präfix wie D_ oder N_, um sicherzustellen, dass die erste Ziffer in den Schlüsselwerten in den Namen der Ausgabetabellen beibehalten wird. |
|
FIELDS Feldname | FIELDS ALL |
Die in die Ausgabe einzuschließenden Felder:
|
|
AS Neuer_Feldname Optional |
Nur gültig bei der Verwendung von FIELDS Feldname. Der neue physische Name und der Anzeigename (alternative Spaltentitel) für das Feld in der Ausgabetabelle. Alle Sonder- oder Leerzeichen, die Sie angeben, werden im Anzeigenamen beibehalten und im physischen Feldnamen im Tabellenlayout automatisch in Unterstriche (_) umgewandelt. Geben Sie Neuer_Feldname als eine in Anführungszeichen gesetzte Zeichenfolge an. Verwenden Sie zwischen den Wörtern ein Semikolon (;), wenn Sie die Zeilen in dem Anzeigenamen umbrechen möchten. |
| Name_der_verbundenen_Tabelle.ALL Optional |
Verwenden Sie alle Felder in der angegebenen verbundenen Tabelle. |
|
IF Test Optional |
Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird nur für Datensätze ausgeführt, welche die Bedingung erfüllen. Hinweis Der IF-Parameter wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsparametern (WHILE, FIRST, NEXT) in einer Tabelle übrig sind. |
|
TO Ordnername Optional |
Der Zielordner für die Ausgabetabellen. Wenn Sie TO nicht angeben, werden die Tabellen in dem Ordner mit dem Analytics-Projekt gespeichert. |
|
WHILE Test Optional |
Ein bedingter Ausdruck, der wahr sein muss, damit ein Datensatz verarbeitet wird. Der Befehl wird ausgeführt, bis die Bedingung falsch ist oder das Tabellenende erreicht wurde. Hinweis Wenn Sie WHILE zusammen mit FIRST oder NEXT verwenden, endet die Datensatzverarbeitung, sobald eine Grenze erreicht wird. |
|
FIRST Bereich | NEXT Bereich Optional |
Die Anzahl der zu verarbeitenden Datensätze:
Verwenden Sie Bereich, um die Anzahl der zu verarbeitenden Datensätze anzugeben. Wenn Sie FIRST und NEXT nicht angeben, werden standardmäßig alle Datensätze verarbeitet. |
Beispiele
Tabelle basierend auf einem Schlüsselfeld aufteilen
Sie generieren mehrere Ausgabetabellen basierend auf eindeutigen Werten im Feld Lieferantenname in der Tabelle VLL_Trans:
OPEN VLL_Trans
SPLITVALUES ON Lieferantenname PREFIX Lieferant_ FIELDS Lieferantennr Lieferantenstadt Rechnungsnr Rechnungsdatum Rechnungsbetrag Produktnr Anzahl Stückkosten TO "Lieferantentabellen"
Jede Ausgabetabelle enthält alle Datensätze, die denselben eindeutigen Schlüsselwert aufweisen. Die Tabellen heißen Lieferant_Lieferantenname. Eine Tabelle namens Lieferant_Koro_International enthält alle Datensätze, in denen Koro International der Wert für Lieferantenname ist.
Die Tabellen werden im Ordner Lieferantentabellen im Analytics-Arbeitsverzeichnis gespeichert.Analytics
Tabelle basierend auf mehreren Schlüsselfeldern aufteilen
Sie generieren mehrere Ausgabetabellen basierend auf eindeutigen Kombinationen aus Werten in den Feldern Lieferantenname und Rechnungsdatum in der Tabelle VLL_Trans.
Die Funktion ALLTRIM( ) entfernt nicht benötigte führende und nachgestellte Leerzeichen von den Lieferantennamenswerten. Wenn Sie die Leerzeichen nicht entfernen, werden sie in mehrere Unterstriche ( _ ) umgewandelt, wodurch der ohnehin begrenzte Platz in den Namen der Ausgabetabellen verschwendet wird.
Die Funktion DATE( ) konvertiert das Feld Rechnungsdatum in den Datentyp „Zeichen“, der für die Verkettung erforderlich ist.
OPEN VLL_Trans
SPLITVALUES ON ALLTRIM(Lieferantenname)+"_"+DATE(Rechnungsdatum; "MM/TT/JJ") FIELDS Lieferantennr Lieferantenname Rechnungsnr Rechnungsdatum Rechnungsbetrag Produktnr Anzahl Stückkosten TO "Lieferantendatumstabellen"
Jede Ausgabetabelle enthält alle Datensätze, die dieselbe eindeutige Kombination aus Schlüsselwerten aufweisen. Die Tabellen heißen Lieferantenname_Rechnungsdatum. Beispielsweise enthält eine Tabelle namens Koro_International_06_15_23 alle Datensätze, in denen Koro International der Wert für Lieferantenname und 06_15_23 der Wert für Rechnungsdatum ist.
Die Tabellen werden im Ordner Lieferantendatumstabellen im Analytics-Arbeitsverzeichnis gespeichert.Analytics
