Page Comparison

Im folgenden werden die unterschiedlichen Funktionen in der Datenverarbeitung des Mappings erläutert.

Für jede Funktion haben wir ein Beispiel angegeben, um die Funktionen etwas besser zu erläutern.

Die vorliegende Beispieldatei enthält Positionen mit Werten zu Quartalen und den beiden Halbjahren.

Als Ergebnis soll die Summe der Halbjahreswerte pro Position eingelesen werden.

Über den Button „neuen Eintrag anlegen" können die gewünschten Felder ausgewählt werden.

In diesem Beispiel wurde je ein neuer Eintrag für das Feld „Column 7" und das Feld „Column 8" angelegt. Das Ergebnis wird in die Spalte „Column (9)" übernommen.

Der Eintrag für die Parameter lautet nun „7;8". Bei einer SmartNotes-Version < 2.9 sind diese Werte manuell einzutragen.

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

In diesem Beispiel wollen wir die Summe der Quartale ermitteln und übertragen.

Also die Felder Q1 bis Q4.

Durch Anklicken des Feldes „Parameter" erscheint der Dialog „Bereichsauswahl". In dieser wählen wir die „Von Spalte" und die „Bis Spalte" aus.

Der Eintrag für die Parameter lautet nun „column3,column6". Bei einer SmartNotes-Version < 2.9 ist der Ausdruck „3,6" manuell einzutragen.

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

In diesem Beispiel wollen wir die Summe der Quartale ermitteln und übertragen.

Also die Felder Q1 bis Q4.

Um dies zu realisieren, benötigen wir die Dokumentvariable Q1 (mit Wert column3) und Q4 (mit Wert column6). Bitte auf Groß- und Kleinschreibung achten.

Der Eintrag für die Parameter lautet „%Q1%,%Q4%".

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

In diesem Beispiel wollen wir die Summe der Quartale ermitteln und übertragen.

Also die Felder Q1 bis Q4.

Um dies zu realisieren, benötigen wir nun die Dokumentvariable Q1 (mit Wert column3), Q2 (mit Wert column4), Q3 (mit Wert column5)  und Q4 (mit Wert column6). Bitte auf Groß- und Kleinschreibung achten.

Der Eintrag für die Parameter lautet nun „%Q1%;%Q2%;%Q3%;%Q4%".

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

Die Spalte „column3" enthält Inhalte unterschiedlicher Länge. Da wir diese Spalte für einen späteren „Join6237720" benötigen, bringen wir die Felder auf eine einheitliche Länge.

Die Länge des Feldes soll 8 Zeichen betragen, die leeren Stellen wollen wir mit einem Unterstrich auffüllen. Die Eingabe für den Parameter lautet „8,_" und muss ohne Anführungsstriche erfolgen.

In der Übersicht „Verarbeitete Datenvorschau" wird die Änderung angezeigt.

Für unsere zu importierende RFBILA haben wir bereits die Funktion „FilterNumeric6237720" angewendet. Dadurch bekommen wir aus dem abgebildeten Auszug bereits nur noch die grün markierten Zeilen.

In diesem Import wollen wir ein Mapping für die Positionen ohne Kontonummer beginnen. Bei diesen stört uns nämlich das leere Namensfeld.

Wir verwenden also den Filter „Filter" und lassen uns alle Zeilen anzeigen, bei denen das Feld „Name" leer ist.

Als Ergebnis erhalten wir in der Vorschau nun alle Positionen, die statt der Kontonummer eine Bezeichnung haben.

Im nächsten Schritt würden wir dann in die leeren Felder „Name" den Inhalt aus „Konto" übernehmen.

Dies lässt sich ganz einfach mit der Funktion "Join6237720" mit dem Parameter „Konto" für das Feld „Name" realisieren.

Der abgebildete Auszug einer RFBILA zeigt, dass man für eine Importdatei manchmal sogar mehrere Mappings benötig um alle Daten zu importieren (In diesem Fall werden es zwei).

In diesem Beispiel sehen wir, dass einige Positionen zwar Werte aufweisen, aber keine Kontonummer besitzen.

Wir sehen aber auch Zeilen, bei denen in der Spalte Wert nichts eingetragen ist. Also auch kein Nullwert.

Da wir diese Zeilen nicht benötigen und uns eine bessere Übersicht für das weitere Mapping verschaffen wollen, fügen wir als erstes die Funktion „FilterNotEmpty" ein.

In unserem Beispiel wenden wir die Funktion „FilterNotEmpty" auf die Spalte „Wert (11)" an. Dieses enthält unsere Werte und darf natürlich nicht leer sein.

In der Vorschau und dem späteren Import ist die Zeile nun nicht mehr vorhanden.

Die abgebildete RFBILA hatten wir bereits in dem Beispiel „FilterNotEmpty6237720" für den Import angepasst.

Dieses Beispiel soll den Unterschied zwischen „FilterNotEmpty6237720" und „FilterNumeric" deutlich machen.

In der vorliegenden RFBILA gibt es Zeilen, bei denen das Feld „Wert" leer ist. Ebenso gibt es aber ein paar Zellen, die dort Text enthalten.

Mit der Funktion „FilterNotEmpty" würden die Zeilen mit dem Text ebenfalls übernommen. Die Funktion "FilterNumeric" blendet diese Zelle aus.

In unserem Beispiel wenden wir die Funktion „FilterNumeric" auf die Spalte „Wert (11)" an. Dieses enthält unsere Programmierung (Konten) und darf in unserem Fall nur Ziffern enthalten.

In der Vorschau und dem späteren Import sind weder leere Zellen noch welche mit Text mehr vorhanden.

Die Importdatei wurde um eine Spalte erweitert, weil nach einem Buchungskreis gefiltert werden soll.

Zum Filtern haben wir eine Dokumentvariable BK angelegt und diese mit dem Wert 200 versehen.

Das Filtern nach Variablen ist eine ideale Möglichkeit wenn Sie z.B. mit dem Factory-Modul arbeiten und für die Sub-Dokumente verschiedene Werte hinterlegen wollen.

Der Wert für den Buchungskreis ist in der Spalte "column2" enthalten.

Wir benötigen also die Spalte "column2", wählen die Funktion "FilterVar" und geben als Parameter den Ausdruck %BK% ein.

Die Datenvorschau zeigt als Ergebnis nun alle gefilterten Datensätze an.

In dem Beispiel soll der Buchungskreis (column2) an die Kontonummer (column1) angehängt werden. Zur optischen Trennung verwenden wir das Zeichen „#". Im Beispiel „Postfix6237720" haben wir dies bereits vorbereitet.

Die Funktion „Join" wird für die Spalte „column1" angelegt und als Parameter wird über das Auswahlmenü die Spalte „column2" ausgewählt.
Bei SmartNotes-Versionen < 2.9 gibt es das Auswahlmenü noch nicht. Der Paramter „column2" ist dort direkt einzutragen.

Die Spalte „column1" wurde nun um das Zeichen „#" und den Wert aus Spalte „column2" erweitert.

Für die weitere Verarbeitung sollen die Inhalte der Spalte „column4" and die der Spalte „column2" angehängt werden.

Um flexibel auf Änderung reagieren zu können definieren wir die Dokumentenvariable „BK_Erweiterung".
Bei der Nutzung des Factory-Moduls ist diese Methode besonders hilfreich, wenn in den einzelnen Sudokumenten unterschiedliche Felder angesprochen werden müssen.

Die Funktion „JoinVar" wird für die Spalte „column2" angelegt und als Parameter wird die Variable „%BK_Erweiterung%" eingetragen.

Die Spalte „column2" wurde nun um die Werte aus Spalte „column4" erweitert.
Dabei wurde „column4" über die Funktion „Fill" mit „0" auf 8 Stellen aufgefüllt (Verab. Index 1).

In diesem Fall benötigen wir neben der Kontonummer (column1) und dem Namen (column3) als Wert die Spalte „column11".

Die Werte der Spalte „column11" sind jedoch in TSD€ angegeben und wir benötigen diese in Einheit 1.

Die Eingabe lautet in diesem Fall also Spalte „column11" mit Funktion „Multiply" und dem Parameter „1000".

Die Werte werden nun in der Vorschau korrekt angezeigt und beim späteren Import entsprechend übernommen.

In der vorliegenden Importdatei werden in Spalte 1 (column1) die Kontonummern dargestellt. In einem späteren Schritt wollen wir diese mit dem Buchungskreis (column2) verknüpfen.

Im ersten Schritt benötigen wir hinter der Kontonummer ein optisches Trennzeichen für die spätere Verknüpfung. Als Zeichen wollen wir das „#" (Doppelkreuz/Hash) verwenden.

Folgende Einträge sind dafür notwendig. Die Spalte ist „column1" die Funktion „Postfix" und der Parameter lautet „#".

Die Spalte „column1" ist nun um den Eintrag „#" erweitert.

In der vorliegenden Importdatei werden in Spalte 1 (column1) die Kontonummern dargestellt, in Spalte 2 der Buchungskreis. Beide Werte sollen verknüpft werden und als optischen Trenner das Zeichen „#" erhalten.

Folgende Einträge sind dafür notwendig. Die Spalte ist „column1" die Funktion „PostfixJoin" und der Parameter lautet „#,2". 

Die Spalte „column1" ist nun um den Eintrag „#" und dem Inhalt aus Column2 erweitert.

In unsere Importdatei hat sich bei ein paar Kontenbezeichnungen „column3" der Ausdruck „xcr" eingeschlichen. Bis die Ursache geklärt und abgestellt ist, entfernen wir diesen Ausdruck mit Hilfe der Funktion „Remove".

Dazu wird für die Spalte „column3" die Funktion „Remove" mit der Parameter „xcr" angelegt.

Der Ausdruck „xcr" wird nun im Ergebnis nicht mehr angezeigt.

In der Importdatei sind im Namen (column2) Steuerzeichen in Form von „\\" enthalten.

Um diese zu entfernen wird für die Spalten „column3" die Funktion „RemoveUnsupportedCharacters" verwendet.

In der Vorschau und dem Import sind die Steuerzeichen nicht mehr enthalten.

Nach einer Umstellung im Vorsystem enthält die Importdatei bei einigen Namen nun den Ausdruck „Scores" statt wie vorher „Results". Die soll so nicht in den Bericht importiert werden. Der Begriff soll ersetzt werden.

Für die betroffene Namensspalte „column3" wird die Funktion „Replace" mit dem Parameter „Scores,Results" anlegt.

In der Vorschau und dem späteren Import enthalten die betroffenen Zeilen nun den Ausdruck „Results".

In der Importdatei hat eine Position keine Bezeichnung „column3". Anhand der Kontonummer ist feststellbar, dass es sich um die Bezeichnung "Result" handeln muss.

Für die Namensspalte „column3" wir die Funktion „ReplaceEmptyWith" mit dem Parameter „Result" angelegt.

In der Vorschau und dem späteren Import enthält die betroffene Zeile nun den Ausdruck „Result".

Die gelieferte Importdatei wird seit einem Update im Vorsystem nach Bezeichnung (column3) sortiert geliefert.

Für die Bearbeitung des weiteren Mappings möchten wir die Sortierung nach Kontonummer (column1).

Als ersten Eintrag in der Datenverarbeitung wird dazu ein Eintrag für Kontonummer (column1) mit der Funktion „Sort" und dem Parameter „asc" angelegt.

Die weitere Bearbeitung des Mappings können wir nun mit sortierten Kontonummern (column1) durchführen.

In der Importdatei enthält der Name (column3) bei einigen Positionen den Eintrag „- BKnnn". 
Der Eintrag soll entfernt werden, zumal die Angabe für den Buchungskreis in der Spalte „column2" vorhanden ist.

Wir wollen den Namen ab dem Trennzeichen „-" trennen. Durch die Trennung entstehen zwei Ausdrücke, von denen wir den ersten Ausdruck benötigen.

Die Eingabe für die Spalte "column1" lautet also Funktion „Split" mit dem Parameter „-,1".

In der Vorschau werden nun die Namen ohne den zweiten Teil „- BKnn" angezeigt.

Natürlich kann von den getrennten Teilen auch der zweite Teil verwendet werden. In diesem Beispiel wäre das Ergebnis allerdings nicht sinnvoll.

In der vorliegenden Importdatei beginnen die Namensspalten (column2) mit den Ausdrücken „DACH" oder „EMEA". Diese wollen wir nicht importieren.

Da die Ausdrücke am Anfang die gleiche Länge aufweisen, können wir die Namensspalte ab dem sechsten Zeichen übernehmen. Da die Bezeichnungen nicht sehr lang sind, wählen wir die 40 Zeichen danach aus.

Die Eingabe für die Spalte „column2" lautet daher: Funktion „Substring" mit dem Parameter „6,40". 

Die Anzahl der zu übernehmenden Zeichen kann länger gewählt werden als tatsächliche Zeichen vorhanden sind. Es ist also nicht notwendig, die exakte Länge zu bestimmen.

In der Vorschau und dem späteren Import sind die ungewünschten Ausdrücke nun nicht mehr vorhanden.

In der Importdatei werden für die Positionen in „column1" die Werte pro Unterposition „column3" geliefert.

Als Ergebnis soll die Summe aller Werte pro Hauptposition ausgewiesen werden.