Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

title
German


Panel


Section


Column
width70%


Section


Column
width40%


Column
width60%

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


Note

Mit der 2.9 wurden einige Dialoge benutzerfreundlicher gestaltet. Um diese Funktion nutzen zu können, muss sie über eine Systemeinstellung freigeschaltet werden. Da diese Freischaltung allerdings bereits bestehende Importe beeinflussen könnte, kommen Sie gerne zuerst auf uns zu.

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




Column
width30%


Panel
bgColor#ECECEC

<< Mapping Administration

  • Auswahl einer Mapping Übersicht
  • Mapping anlegen
  • Mapping kopieren
  • Mapping bearbeiten
  • Mapping löschen
  • Übersicht der Verarbeitungsfunktionen
  • Datenimport Vorschau
Panel
title






ColSum


Section


Column
width100%

Summiert die in den Parametern angegebenen Spalten in die unter „Column" angegebene Spalte. Die Ergebnisspalte sollte leer sein, da diese Werte überschrieben werden.



Panel
titleParameter

Bei dieser Funktion werden die Parameter mit Semikolon getrennt z.B. 1;2;3 (summiert die Spalten 1,2 und 3 und gibt das Ergebnis in der Spalte, welche im Drop-Down-Menü hinterlegt ist, aus).


Panel
titleAb Version 2.9

Die Spalten können in einem separaten Dialog ausgewählt und hinzugefügt werden. Das Eingeben von Spaltenzahlen ist nicht mehr notwendig.


Panel
titleBeispiel


Expand
titleEin Beispiel für ColSum? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

Panel






ColSumRange


Section


Column
width100%

Summiert die Spalten von der als Parameter eingegebenen Anfangsspalte bis zu einer als Parameter eingegebenen Endspalte auf. Das Ergebnis wird in der Spalte gespeichert, welche im Drop-Down-Menü angegeben wird.



Panel
titleParameter

1,4 summiert die Spalten 1 bis 4


Panel
titleAb Version 2.9

Die Spalten können in einem separaten Dialog ausgewählt und hinzugefügt werden. Das Eingeben von Spaltenzahlen ist nicht mehr notwendig.


Panel
titleBeispiel


Expand
titleEin Beispiel für ColSumRange? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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

Also die Felder Q1 bis Q4.





Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

Panel






title

ColSumRangeVar


Section


Column
width100%

Funktioniert analog zur ColSumRange-Funktion. Außerdem bietet diese Funktion die Möglichkeit, die Parameter als Variablen anzugeben. Variablen können als Dokumentvariablen hinterlegt werden und zentral verändert werden.

Variablen müssen kenntlich gemacht werden, indem sie durch %-Zeichen eingerahmt werden: z.B. %Anfangsvariable%,%Endvariable%.



Panel
titleParameter

%Var1%,%Var4% bildet die Summe von Variable1 bis Variable4


Panel
titleBeispiel


Expand
titleEin Beispiel für ColSumRangeVar? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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

Also die Felder Q1 bis Q4.




Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

Paneltitle






ColSumVar


Section


Column
width100%

Funktioniert analog zur ColSum-Funktion. Außerdem bietet diese Funktion die Möglichkeit, die Parameter als Variablen anzugeben. Variablen können als Dokumentvariablen hinterlegt werden und zentral verändert werden. Variablen müssen kenntlich gemacht werden, indem sie durch %-Zeichen eingerahmt werden: z.B. %Variable1%;%Variable2%.



Panel
titleParameter

%Var1%;%Var2% addiert die Werte der Variablen 1 und 2


Panel
titleBeispiel


Expand
titleEin Beispiel für ColSumVar? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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

Also die Felder Q1 bis Q4.




Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

In der Positionsvorschau wird die Summe nun als Wert angezeigt.

Paneltitle






Fill


Section


Column
width100%

Füllt die Zeile des Wertes mit einem Zeichen bis zu einer bestimmten, selbst anzugebenen Länge auf.



Panel
titleParameter

Parameter 1: ganzzahliger Wert, der die neue Länge der Position festlegt

Parameter 2: Zeichen, welche den Positionswert bis zur angegeben Länge verlängern

Die Parameter müssen durch ein Komma getrennt werden.


Panel
titleBeispiel


Expand
titleEin Beispiel für Fill? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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

panel

title






Filter


Section


Column
width100%

Bietet verschiedene Filterfunktionen auf Basis eines frei wählbaren Textes an. Die Filterfunktion wird in der Parameterspalte über einen Operator festgelegt, welcher ohne Leerzeichen direkt vor den Text geschrieben wird.



Panel
titleParameter

Parameter 1: Operator der Filterfunktion

Parameter 2: beliebiger Text

Operatoren der Filterfunktionen:

  • „=“ zeigt alle Zeilen, die mit dem angegebenen Filtertext genau übereinstimmen
  • „<>“ zeigt alle Zeilen, die nicht mit dem angegebenen Filtertext genau übereinstimmen
  • „contains“ zeigt alle Zeilen, die den angegebenen Filtertext [an irgendeiner Stelle] enthalten
  • „notcontains“ zeigt alle Zeilen, die den angegebenen Filtertext nicht enthalten
  • Parameter können mit „and“ und „or“ verknüpft werden: =Filter1 or Filter2

Ab der Version 2.9.0.221 besteht zusätzlich die Möglichkeit, numerische Filterwerte anzugeben. So lassen sich Zahlen importieren, die größer oder kleiner als ein bestimmter Wert sind.

  • „<Zahl" zeigt alle Zeilen mit einem Wert, der größer als die angegebene Zahl ist. Ist der Wert in einer Zeile ein Text, wird er nicht berücksichtigt.
  • „<=Zahl" zeigt alle Zeilen mit einem Wert, der größer als oder gleich die angegebene Zahl ist. Ist der Wert in einer Zeile ein Text, wird er nicht berücksichtigt.
  • „>Zahl" zeigt alle Zeilen mit einem Wert, der kleiner als die angegebene Zahl ist. Ist der Wert in einer Zeile ein Text, wird er nicht berücksichtigt.
  • „>=Zahl" zeigt alle Zeilen mit einem Wert, der kleiner als oder gleich die angegebene Zahl ist. Ist der Wert in einer Zeile ein Text, wird er nicht berücksichtigt.

Die numerischen Filterwerte sind ohne Hochkomma einzugeben!

Info

Dabei ist zu beachten, dass der NumberDecimalSeparator bei dem Filterkriterium (hier Zahl genannt) immer der Punkt ist. Bei den Werten hängt der NumberDecimalSeparator/NumberGroupSeparator von den Connector-Einstellungen / Systemeinstellungen ab

Für nicht numerische Filterwerte können folgende Filter gesetzt werden:

  • „<Text" zeigt alle Zeilen, deren Text in ihrer relativen Position in der alphabetischen Sortierreihenfolge nach dem angegebenen Filtertext kommen. Beispiel: „Wurzel < Zahn" ist wahr, „Wurzel < Wurzel" ist falsch
  • „<=Text" zeigt alle Zeilen, deren Text in ihrer relativen Position in der alphabetischen Sortierreihenfolge auf der gleichen Position oder nach dem angegebenen Filtertext kommen. Beispiel: „Wurzel <= Wurzel" ist wahr
  • „>Text" zeigt alle Zeilen, deren Text in ihrer relativen Position in der alphabetischen Sortierreihenfolge vor dem angegebenen Filtertext kommen. Beispiel: „Zahn > Wurzel" ist wahr, „Wurzel > Wurzel" ist falsch
  • „>=Text" zeigt alle Zeilen, deren Text in ihrer relativen Position in der alphabetischen Sortierreihenfolge auf der gleichen Position oder vor dem angegebenen Filtertext kommen. Beispiel: „Wurzel >= Wurzel" ist wahr

Nicht numerische Filterwerte sind mit Hochkomma einzugeben!


Panel
titleBeispiel

Parameter „Test“ – Alle Positionswerte mit „Test“ werden eingelesen

Parameter „contains(„Test")" – Alle Positionswerte, die „Test" enthalten, werden eingelesen


Expand
titleEin weiteres Beispiel für Filter? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

Für unsere zu importierende RFBILA haben wir bereits die Funktion „6237720" 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.



Section


Column
width40%

Image Modified


Column
width60%
Um dies zu realisieren verwenden wir für die Spalte „Name" die Funktion „Filter" mit dem Parameter „=""“.



Section


Column
width40%

Image Modified


Column
width60%

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 "6237720" mit dem Parameter „Konto" für das Feld „Name" realisieren.

panel

title







FilterNotEmpty


Section


Column
width100%

Selektiert nur Zeilen, in denen die zu filternde Spalte nicht leer ist.



Panel
titleParameter
Ein Parameter wird nicht benötigt.


Panel
titleBeispiel


Expand
titleEin Beispiel für FilterNotEmpty? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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

Panel







title

FilterNumeric


Section


Column
width100%

Selektiert nur Zeilen, in denen die zu filternde Spalte einen numerischen Wert enthält, z.B. Kontonummern.



Panel
titleParameter
Ein Parameter wird nicht benötigt.


Panel
titleBeispiel


Expand
titleEin Beispiel für FilterNumeric? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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

Dieses Beispiel soll den Unterschied zwischen „6237720" 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.


Info

Zur besseren Übersicht haben wir in der Datei die Zeile 5 angepasst und in der Datenquellenverwaltung als Überschrift definiert. Aus diesem Grunde gibt es in diesem Beispiel die Bezeichnung „column1, column2, etc ." nicht. Es werden die Bezeichnungen aus der Überschriftenzeile angezeigt.




Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






FilterVar


Section


Column
width100%

Variablen können als Dokumentvariablen hinterlegt werden und zentral verändert werden. Dies entspricht der normalen Filterfunktion mit der Möglichkeit zur Eingabe von Variablennamen.

Ein gutes Beispiel ist das Filtern nach Buchungskreis.



Panel
titleParameter
Variablen müssen kenntlich gemacht werden indem sie durch %-Zeichen eingerahmt werden z.B. =%Variable1% or %Variable2%.


Panel
titleBeispiel

Parameter „%Import%" – Nur die Elemente werden gezeigt, in denen der unter der Dokumentvariable Import hinterlegte Wert enthalten ist.


Expand
titleEin weiteres Beispiel für FilterVar? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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

panel

title






Index


Section


Column
width100%

Diese Funktion nummeriert eine ausgewählte Spalte fortlaufend von 1 bis n



Panel
titleParameter
Parameter sind nicht nötig (und auch nicht möglich).


Panel
titleBeispiel

Image Modified

panel

title



Join


Section


Column
width100%

Vereinigt die Werte der ausgewählten Spalte mit den Werten der Spalte des angegebenen Spaltenindex.



Panel
titleParameter
Als Parameter wird die Spalte als Zahlenwert angegeben, die mit der links im Drop Down Menü ausgewählten Spalte vereint werden soll.


Panel
titleAb Version 2.9

Die Spalten können in einem Drop Down Menü ausgewählt werden. Das Eingeben von Spaltenzahlen ist nicht mehr notwendig.


Panel
titleBeispiel

Parameter „3" – vereinigt die im Drop Down Menü ausgewählte Spalte mit Spalte 3


Expand
titleEin weiteres Beispiel für Join? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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


Info

Die beiden Schritten aus diesem Beispiel lassen sich auch mit der Funktion „6237720" zusammenfassen.

Panel







title

JoinVar


Section


Column
width100%

Funktioniert analog zur Join-Funktion. Außerdem bietet diese Funktion die Möglichkeit, den Parameter als Variable anzugeben. Die Variable muss als Dokumentvariable hinterlegt werden und kann dort zentral verändert werden.



Panel
titleParameter

Der Spaltenindex muss als ganzzahliger Wert (bis Version 2.9) oder als „column[Wert]" (ab 2.9)  hinterlegt werden. Die Variable muss kenntlich gemacht werden indem sie durch %-Zeichen eingerahmt wird z.B. %Variablenname%.


Panel
titleBeispiel


Expand
titleEin Beispiel für JoinVar? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%
Image Modified



Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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).

Paneltitle






Multiply


Section


Column
width100%

Multipliziert den Wert mit einem ganzzahligen Faktor.



Panel
titleParameter
Ganzzahliger Wert


Panel
titleBeispiel

Parameter „2“ – Die Positionswerte werden mit „2“ multipliziert. Wert vorher: „3“, Wert nach der Verarbeitung: „6“


Expand
titleEin weiteres Beispiel für Multiply? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






Postfix


Section


Column
width100%

Schreibt einen bestimmten Text an das Ende vom Wert.



Panel
titleParameter

Parameter: beliebiger Text


Panel
titleBeispiel

Parameter „ – Konzern“ – Position vorher: „Aktiva“, Position nach der Verarbeitung: „Aktiva – Konzern“


Expand
titleEin weiteres Beispiel für PostFix? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






PostfixJoin


Section


Column
width100%

Die Funktion PostFixJoin vereint die Funktionen 6237720 und 6237720



Panel
titleParameter
Ein beliebiger Text kann als Postfix definiert werden. Für das Vereinen muss der Spaltenindex als ganzzahliger Wert hinterlegt werden.


Panel
titleBeispiel

Parameter „#,3" – Schreibt hinter die ausgewählten Positionen ein „#"und fügt die Inhalte aus Spalte 3 danach an.


Expand
titleEin weiteres Beispiel für PostFixJoin? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






Prefix


Section


Column
width100%

Schreibt einen bestimmten Text an den Anfang des Wertes.



Panel
titleParameter
Beliebiger Text


Panel
titleBeispiel

Parameter „Vorschau – „ – Position vorher: „Reiseabrechnung“, Position nach der Verarbeitung: „Vorschau – Reiseabrechnung“


Expand
titleEin weiteres Beispiel für Prefix? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

In diesem Beispiel enthält die Spalte „column2" die Angabe des Buchungskreises, die im späteren Verlauf an die Spalte „column1" angehängt werden soll.

Vorher soll dem Buchungskreis noch das Kürzel „BK" vorangestellt werden.



Section


Column
width40%

Image Modified


Column
width60%

Dazu wird für die Spalte „column2" die Funktion „Prefix" mit dem Parameter „BK" angelegt.



Section


Column
width40%

Image Modified


Column
width60%

Die Spalte „column2" enthält nun den Ausdruck „BK" und den Wert des Buchungskreises.

panel

title






Remove


Section


Column
width100%

Löscht einen bestimmten vorgegebenen Text[teil].



Panel
titleParameter
Beliebiger Text


Panel
titleBeispiel

Parameter „Vorschau – „ – Position vorher: „Vorschau – Reiseabrechnung“, Position nach der Verarbeitung: „Reiseabrechnung“


Expand
titleEin weiteres Beispiel für Remove? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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".



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

panel

title






RemoveUnsupportedCharacters


Section


Column
width100%

Entfernt nicht unterstützte Zeichen. Dazu zählen: \\/:*?“„<>'|



Panel
titleParameter
Wird nicht benötigt


Panel
titleBeispiel

Position vorher: „*Abrechnung*“, Position nach der Verarbeitung: „Abrechnung“


Expand
titleEin weiteres Beispiel für RemoveUnsupportedCharacters? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






Replace


Section


Column
width100%

Ersetzt einen bestimmten Text[teil] mit einem neuen Text.



Panel
titleParameter
Beliebiger Text, der ersetzt wird und beliebiger Text, der stattdessen eingefügt wird


Panel
titleBeispiel

Parameter „Vorschau, Finalversion“ – Position vorher: „Vorschau – Reiseabrechnung“, Position nach der Verarbeitung: „Finalversion – Reiseabrechnung


Expand
titleEin weiteres Beispiel für Replace? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






ReplaceEmptyWith


Section


Column
width100%

Ersetzt leere Inhalte mit einem neuen Text.



Panel
titleParameter
Beliebiger Text, der eingefügt wird


Panel
titleBeispiel

Finalversion“ – Position vorher: „“, Position nach der Verarbeitung: „Finalversion


Expand
titleEin weiteres Beispiel für ReplaceEmptyWith? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

panel

title






Sort


Section


Column
width100%

Sortiert eine Spalte auf- oder absteigend



Panel
titleParameter

asc = aufsteigend

dsc = absteigend


Panel
titleBeispiel

Parameter „asc" – die Werte werden aufsteigend sortiert


Expand
titleEin Beispiel für Sort? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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).



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Note

Die Sortierung hat für den eigentlichen Import keine wirklichen Auswirkungen, da sich die Anzeige der Positionen in der Periodenverwaltung nach jedem Feld sortieren lässt.

panel

title







Split


Section


Column
width100%

Trennt den Inhalt einer Spalte auf zwei (oder mehr) Spalten auf (z.B. [Kontonummer] - [Name]). Diese Funktion ist erst ab der Version 2.9 verfügbar.



Panel
titleParameter

Die Split-Funktion erwartet zwei Parameter (wie üblich durch Komma getrennt):

  • Das Split-Zeichen (1 Character mit oder ohne Anführungszeichen, z.B. "-")
  • Der Index aus dem Split-Array, der zurückgegeben werden soll.


Panel
titleBeispiel

Parameter „-,1" – angewendet auf „4711 - mein Konto" liefert „4711"

Parameter „-,2" – angewendet auf „4711 - mein Konto" liefert „mein Konto"


Expand
titleEin weiteres Beispiel für Split? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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".



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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

Panel






title

Substring


Section


Column
width100%

Übernimmt eine bestimmte Menge von Zeichen ab einer bestimmten Stelle des Wertes.



Panel
titleParameter
Startstelle als ganzzahliger Wert, ganzzahliger Wert für die Menge der Zeichen


Panel
titleBeispiel

Parameter „3,6“ – Position vorher: „E-Bilanz“, Position nach der Verarbeitung: „Bilanz“


Expand
titleEin weiteres Beispiel für Expand? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

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

Paneltitle






Sum


Section


Column
width100%

Summiert alle numerischen Werte in der Wertespalte, gruppiert nach der Spalte, auf die die Sum-Funktion angewendet wird.



Panel
titleParameter
Wird nicht benötigt.


Panel
titleBeispiel


Expand
titleEin Beispiel für Sum? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

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.



Section


Column
width40%

Image Modified


Column
width60%

Um das gewünschte Ergebnis zu bekommen, müssen zwei Funktionen eingefügt werden:

Die Funktion „6237720" übernimmt die Werte der vorherigen Zeile, wenn kein Wert vorhanden ist. Dies soll für die Spalte „column1" geschehen. Ein Parameter ist nicht notwendig. Die Funktion muss an erster Stelle stehen (Verarb. Index = 0).

Die nachfolgende Funktion „Sum" summiert dann die Werte aller gleichnamiger Positionen in der Spalte „column1". In dem Beispiel wäre dies die Summe aller Sätze für „10H2", „50000000", usw.



Section


Column
width40%

Image Modified


Column
width60%

In der Vorschau wird nun jedes Gruppenelement mit der Summe (column5) aus allen Unterpositionen angezeigt.



Section


Column
width40%

Image Modified


Column
width60%

Ohne die Funktion „TakeOver" würde eine Gesamtsumme für die leeren Spalten (column1) gebildet.

Panel






title

TakeOver


Section


Column
width100%

Übernimmt die Werte der vorherigen Zeile, wenn kein Wert vorhanden ist.



Panel
titleParameter
Wird nicht benötigt.


Panel
titleBeispiel


Expand
titleEin Beispiel für TakeOver? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

In der vorliegenden Importdatei sind die Angaben für Konto (column1) und Bezeichnung (column2) nicht in jeder Zeile enthalten.

Da wir auch die einzelnen Unterpositionen benötigen, sollen die leeren Spalten mit den vorherigen Werten gefüllt werden.



Section


Column
width40%

Image Modified


Column
width60%

Die Funktion „TakeOver" benötigen wir in diesem Fall für die Spalten Konto (column1) und Bezeichnung (column2), jeweils ohne Parameter.



Section


Column
width40%

Image Modified


Column
width60%

In der Vorschau werden die übernommenen Werte nun angezeigt und später auch importiert.

Paneltitle






Trim


Section


Column
width100%

Entfernt Leerzeichen vor und hinter dem Positionswert.



Panel
titleParameter
Wird nicht benötigt.


Panel
titleBeispiel

Position vorher: „ Aktualisiert“, Position nach der Verarbeitung: „Aktualisiert“.


Expand
titleEin weiteres Beispiel für Trim? Lesen Sie mehr dazu ...


Section


Column
width40%

Image Modified


Column
width60%

In der Importdatei sind bei manchen Namensspalten (column2) ein oder mehrere Leerzeichen am Anfang.

Dies muss natürlich abgestellt werden, da keine Tabelle im späteren Dokument ordentlich zu gestalten wäre.



Section


Column
width40%

Image Modified


Column
width60%

Die Eingabe für die Namenspalte (column2) ist recht einfach. Als Funktion wird „Trim" ausgewählt, ein Parameter ist nicht notwendig.



Section


Column
width40%

Image Modified


Column
width60%

In der Vorschau und dem späteren Import haben die Werte in „column2" keine führenden Leerzeichen mehr und werden linksbündig angezeigt.

PanelborderColor#666666bgColor#ECECECborderWidth2










title
English



title
Panel


Section


Column
width70%


Section


Column
width40%


Column
width60%

In the following, the different functions in the data processing of the mapping are explained.


Note

With 2.9 some dialogues have been made more user-friendly. In order to use this function, it must be activated via a system setting. However, since this activation could affect already existing imports, please contact us first.

For each function we have given an example to explain the functions a little better.




Column
width30%


Panel
bgColor#ECECEC

<< Mapping Administration

  • Selecting a mapping overview
  • Create Mapping
  • Copy Mapping
  • Edit Mapping
  • Delete mapping
  • Overview of the processing functions
  • Data Import Preview
Panel





ColSum


Section


Column
width100%

Sums the columns specified in the parameters into the column specified under "Column". The result column should be empty, as these values will be overwritten.



Panel
titleParameter

With this function, the parameters are separated with semicolons, e.g. 1;2;3 (sums the columns 1,2 and 3 and outputs the result in the column that is stored in the drop-down menu).


Panel
titleAs of version 2.9

The columns can be selected and added in a separate dialogue. Entering column numbers is no longer necessary.


Panel
titleBeispiel


Expand
titleAn example for ColSum? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

This sample file contains items with values for quarters and the two half-years.

As a result, the sum of the half-year values per item is to be imported.



Section


Column
width40%

Image Modified


Column
width60%

The desired fields can be selected via the button "Create new entry".

In this example, a new entry was created for the field "Column 7" and the field "Column 8". The result is transferred to the column "Column (9)".




Section


Column
width40%

Image Modified


Column
width60%

The entry for the parameters is now "7;8". With a SmartNotes version < 2.9, these values must be entered manually.



Section


Column
width40%

Image Modified


Column
width60%

In the position preview, the sum is now displayed as a value.

Panel






ColSumRange


Section


Column
width100%

Sums up the columns from the start column entered as a parameter to an end column entered as a parameter. The result is saved in the column specified in the drop-down menu.



Panel
titleParameter

1.4 sums columns 1 to 4


Panel
titleAs of version 2.9

The columns can be selected and added in a separate dialogue. Entering column numbers is no longer necessary.


Panel
titleBeispiel


Expand
titleAn example for ColSumRange? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In this example, we want to determine and transfer the sum of the quarters.

So the fields Q1 to Q4.




Section


Column
width40%

Image Modified


Column
width60%

By clicking on the "Parameter" field, the "Range Selection" dialogue appears. In this we select the "From column" and the "To column".



Section


Column
width40%

Image Modified


Column
width60%

The entry for the parameters is now "column3,column6". With a SmartNotes version < 2.9, the expression "3,6" must be entered manually.



Section


Column
width40%

Image Modified


Column
width60%

In the position preview, the sum is now displayed as a value.

Panel






title

ColSumRangeVar


Section


Column
width100%

Functions analogously to the ColSumRange function. In addition, this function offers the possibility of specifying the parameters as variables. Variables can be stored as document variables and can be changed centrally.

Variables must be identified by framing them with % signs: e.g. %start variable%,%end variable%.



Panel
titleParameter

%Var1%,%Var4% forms the sum of Variable1 to Variable4


Panel
titleBeispiel


Expand
titleAn example for ColSumRangeVar? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In this example, we want to determine and transfer the sum of the quarters.

So the fields Q1 to Q4.




Section


Column
width40%

Image Modified


Column
width60%

To realise this, we need the document variables Q1 (with value column3) and Q4 (with value column6). Please pay attention to upper and lower case.



Section


Column
width40%

Image Modified


Column
width60%

The entry for the parameters is "%Q1%,%Q4%".



Section


Column
width40%

Image Modified


Column
width60%

In the position preview, the sum is now displayed as a value.

Paneltitle






ColSumVar


Section


Column
width100%

Works analogously to the ColSum function. In addition, this function offers the possibility of specifying the parameters as variables. Variables can be stored as document variables and can be changed centrally. Variables must be identified by framing them with % signs: e.g. %Variable1%;%Variable2%.



Panel
titleParameter

%Var1%;%Var2% adds the values of the variables 1 and 2


Panel
titleBeispiel


Expand
titleAn example for ColSumVar? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In this example, we want to determine and transfer the sum of the quarters.

So the fields Q1 to Q4.




Section


Column
width40%

Image Modified


Column
width60%

To realise this, we now need the document variables Q1 (with value column3), Q2 (with value column4), Q3 (with value column5) and Q4 (with value column6). Please pay attention to upper and lower case.



Section


Column
width40%

Image Modified


Column
width60%

The entry for the parameters is now "%Q1%;%Q2%;%Q3%;%Q4%".



Section


Column
width40%

Image Modified


Column
width60%

In the position preview, the sum is now displayed as a value.

Paneltitle






Fill


Section


Column
width100%

Fills the line of the value with a character up to a certain length that you specify yourself.



Panel
titleParameter

Parameter 1: Integer value that sets the new length of the position

Parameter 2: Characters which extend the position value up to the specified length

The parameters must be separated by a comma.


Panel
titleExample


Expand
titleAn example for Fill? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

The column "column3" contains contents of different lengths. Since we need this column for a later "6237720", we bring the fields to a uniform length.



Section


Column
width40%

Image Modified


Column
width60%

The length of the field should be 8 characters, we want to fill the empty spaces with an underscore. The entry for the parameter is "8,_" and must be made without inverted commas.



Section


Column
width40%

Image Modified


Column
width60%

The change is displayed in the "Processed data preview" overview.

panel

title






Filter


Section


Column
width100%

Offers various filter functions based on a freely selectable text. The filter function is specified in the parameter column via an operator, which is written directly in front of the text without spaces.



Panel
titleParameter

Parameter 1: Filter function operator

Parameter 2: any text

Operators of the filter functions:

  • "=" shows all lines that exactly match the specified filter text.
  • "<>" shows all lines that do not exactly match the specified filter text.
  • "contains" shows all lines that contain the specified filter text [at any position].
  • "notcontains" shows all lines that do not contain the specified filter text.

Parameters can be linked with "and" and "or": =Filter1 or Filter2

The numerical filter values must be entered without apostrophes!


As of version 2.9.0.221, it is also possible to specify numerical filter values. This allows numbers to be imported that are larger or smaller than a certain value.

  • "<Number" shows all rows with a value greater than the specified number. If the value in a row is text, it is not included.

  • "<=Number" shows all rows with a value greater than or equal to the specified number. If the value in a row is a text, it is not taken into account.

  • ">Number" shows all rows with a value that is less than the specified number. If the value in a row is a text, it is not taken into account.

  • ">=Number" shows all rows with a value that is less than or equal to the specified number. If the value in a row is a text, it is not taken into account.


Info

Please note that the NumberDecimalSeparator for the filter criterion (here called number) is always the point. For the values, the NumberDecimalSeparator/NumberGroupSeparator depends on the Connector Settings / System Settings.


For non-numeric filter values, the following filters can be set:

  • "<Text" - shows all lines whose text comes after the specified filter text in their relative position in the alphabetical sort order. Example: "Root < Tooth" is true, "Root < Root" is false.

  • "<=Text" - shows all lines whose text comes in their relative position in the alphabetical sort order at the same position or after the specified filter text. Example: "Root <= Root" is true.

  • ">text" - shows all lines whose text comes before the specified filter text in their relative position in the alphabetical sort order. Example: "Tooth > Root is true", "Root > Root" is false.

  • ">=text" - shows all lines whose text comes at the same position or before the specified filter text in their relative position in the alphabetical sort order. Example: "Root >= Root" is true.

Non numerical filter values must be entered with apostrophes!


Panel
titleExample

Parameter „Test“ – All position values with "Test" are read in

Parameter „contains(„Test")" – All item values containing "Test" are read in


Expand
titleAnother example for Filter? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

For our RFBILA to be imported, we have already applied the function "6237720". As a result, we already get only the lines marked in green from the extract shown.

In this import we want to start a mapping for the positions without account number. For these, the empty name field bothers us.

So we use the filter "Filter" and display all lines where the field "Name" is empty.



Section


Column
width40%

Image Modified


Column
width60%
To realise this, we use the function "Filter" with the parameter "="" for the column "Name".



Section


Column
width40%

Image Modified


Column
width60%

As a result, we now get all items in the preview that have a name instead of the account number.

In the next step, we would then transfer the content from "Account" into the empty "Name" fields.

This can easily be done with the function "6237720" with the parameter "Account" for the field "Name".

panel

title






FilterNotEmpty


Section


Column
width100%

Selects only rows in which the column to be filtered is not empty.



Panel
titleParameter

A parameter is not required.


Panel
titleExample


Expand
titleAn example for FilterNotEmpty? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

The excerpt of an RFBILA shows that sometimes you even need several mappings for one import file to import all the data (in this case there will be two).

In this example we see that some items have values but no account number.

But we also see rows where there is nothing in the Value column. So there is no zero value either.

Since we do not need these rows and want to get a better overview for further mapping, we first insert the function "FilterNotEmpty".




Section


Column
width40%

Image Modified


Column
width60%

In our example we apply the function "FilterNotEmpty" to the column "Value (11)". This contains our values and of course must not be empty.



Section


Column
width40%

Image Modified


Column
width60%

In the preview and the later import, the lines are no longer present.

Panel







title

FilterNumeric


Section


Column
width100%

Selects only rows in which the column to be filtered contains a numeric value, e.g. account numbers.



Panel
titleParameter

A parameter is not required.


Panel
titleExample


Expand
titleAn example for FilterNumeric? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

We had already adapted the RFBILA shown in the example "6237720" for the import.

This example should make the difference between "6237720" and "FilterNumeric" clear.

In the present RFBILA, there are rows where the field "Value" is empty. However, there are also a few cells that contain text there.

With the function "6237720", the rows with text would also be taken over. The function "FilterNumeric" hides this cell.



Info

For a better overview, we have adapted line 5 in the file and defined it as a heading in the data source management. For this reason, the designation "column1, column2, etc ." does not exist in this example. The designations from the heading line are displayed.




Section


Column
width40%

Image Modified


Column
width60%

In our example, we apply the function "FilterNumeric" to the column "Value (11)". This contains our programming (accounts) and in our case may only contain numbers.



Section


Column
width40%

Image Modified


Column
width60%

In the preview and the later import, there are neither empty cells nor cells with text.

Paneltitle






FilterVar


Section


Column
width100%

Variables can be stored as document variables and changed centrally. This corresponds to the normal filter function with the possibility of entering variable names.

A good example is filtering by accounting area.



Panel
titleParameter

Variables must be identified by framing them with % signs, e.g. =%Variable1% or %Variable2%.


Panel
titleExample

Parameter „%Import%" – Only those elements are shown in which the value stored under the document variable Import is contained.


Expand
titleAnother example for FilterVar? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

The import file was extended by one column because it is to be filtered according to an accounting area.



Section


Column
width40%

Image Modified


Column
width60%

For filtering, we have created a document variable BK and given it the value 200.

Filtering by variables is an ideal option if you work with the Factory module, for example, and want to store different values for the sub-documents.



Section


Column
width40%

Image Modified


Column
width60%

The value for the company code is contained in the column "column2".

We therefore need the column "column2", select the function "FilterVar" and enter the expression %AE% as a parameter.



Section


Column
width40%

Image Modified


Column
width60%

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

panel

title






Index


Section


Column
width100%

This function numbers a selected column consecutively from 1 to n



Panel
titleParameter

Parameters are not necessary (and also not possible).


Panel
titleBeispiel

Image Modified

panel

title



Join


Section


Column
width100%

Combines the values of the selected column with the values of the column of the specified column index.



Panel
titleParameter

As a parameter, the column is specified as a numerical value that is to be combined with the column selected in the drop-down menu on the left.


Panel
titleAs of version 2.9

The columns can be selected in a drop-down menu. It is no longer necessary to enter column numbers.


Panel
titleExample

Parameter „3" – merges the column selected in the drop down menu with column 3


Expand
titleAnother example for Join? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the example, the company code (column2) is to be appended to the accounting area (column1). We use the character "#" for optical separation. We have already prepared this in the "6237720" example.



Section


Column
width40%

Image Modified


Column
width60%

The "Join" function is created for the column "column1" and the column "column2" is selected as a parameter via the selection menu.
SmartNotes versions < 2.9 do not yet have the selection menu. The parameter "column2" is to be entered there directly.



Section


Column
width40%

Image Modified


Column
width60%

The column "column1" has now been extended by the character "#" and the value from column "column2".

Info

The two steps from this example can also be combined with the function "6237720".

Panel







title

JoinVar


Section


Column
width100%

Functions analogously to the 6237720 function. In addition, this function offers the possibility of specifying the parameter as a variable. The variable must be stored as a document variable and can be changed centrally there.



Panel
titleParameter

The column index must be stored as an integer value (up to version 2.9) or as "column[value]" (from 2.9). The variable must be identified by framing it with % characters, e.g. %VariableName%.


Panel
titleExample


Expand
titleAn example for JoinVar? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

For further processing, the contents of column "column4" are to be appended to those of column "column2".



Section


Column
width40%

Image Modified


Column
width60%

In order to be able to react flexibly to changes, we define the document variable "AE_Extension".
When using the Factory module, this method is particularly helpful if different fields have to be addressed in the individual Sud documents.



Section


Column
width40%
Image Modified



Column
width60%

The function "JoinVar" is created for the column "column2" and the variable "%AE_Extension%" is entered as a parameter.



Section


Column
width40%

Image Modified


Column
width60%

The column "column2" has now been extended by the values from column "column4".
In doing so, "column4" was filled with "0" to 8 digits via the "6237720" function (Processing 1).

Paneltitle






Multiply


Section


Column
width100%

Multiplies the value by an integer factor.



Panel
titleParameter

Integer value


Panel
titleExample

Parameter „2“ – The position values are multiplied by "2". Value before: "3", value after processing: "6".


Expand
titleAnother example for Multiply? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In this case, in addition to the account number (column1) and the name (column3), we need the column "column11" as a value.

However, the values of column11 are in TSD€ and we need them in unit 1.



Section


Column
width40%

Image Modified


Column
width60%

In this case, the input is column "column11" with function "Multiply" and parameter "1000".



Section


Column
width40%

Image Modified


Column
width60%

The values are now correctly displayed in the preview and taken over accordingly during the later import.

Paneltitle






Postfix


Section


Column
width100%

Write a specific text at the end of the value.



Panel
titleParameter

Parameter: any text


Panel
titleExample

Parameter " - Group" - Position before: "Assets", Position after processing: "Assets - Group".


Expand
titleAnother example for PostFix? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the present import file, column 1 (column1) shows the account numbers. In a later step we want to link these with the accounting area (column2).

In the first step, we need an optical separator after the account number for the later link. We want to use the "#" (hash) as a character.



Section


Column
width40%

Image Modified


Column
width60%

The following entries are necessary for this. The column is "column1", the function is "Postfix" and the parameter is "#".



Section


Column
width40%

Image Modified


Column
width60%

The column "column1" is now extended by the entry "#".

Paneltitle






PostfixJoin


Section


Column
width100%

Die Funktion PostFixJoin vereint die Funktionen 6237720 und 6237720



Panel
titleParameter

Any text can be defined as a postfix. For unifying, the column index must be stored as an integer value.


Panel
titleExample

Parameter „#,3" – Write a "#" after the selected positions and add the contents from column 3 afterwards.


Expand
titleAnother example for PostFixJoin? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the present import file, the account numbers are shown in column 1 (column1), the company code in column 2. Both values are to be linked and receive the character "#" as a visual separator.



Section


Column
width40%

Image Modified


Column
width60%

For the column "column1", the function "PostfixJoin" is created with the parameter "#,2".



Section


Column
width40%

Image Modified


Column
width60%

In the data preview, the column "column1" is now linked to the column "Column2", visually separated by a "#".

Paneltitle






Prefix


Section


Column
width100%

Writes a specific text at the beginning of the value.



Panel
titleParameter

Any text.


Panel
titleExample

Parameter "Preview - " - position before: "Travel accounting", position after processing: "Preview - Travel accounting".


Expand
titleAnother example for Prefix? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In this example, the column "column2" contains the company code that is to be appended to the column "column1" later on.

Before that, the abbreviation "AE" is to be placed in front of the company code.



Section


Column
width40%

Image Modified


Column
width60%

For this purpose, the function "Prefix" with the parameter "AE" is created for the column "column2".



Section


Column
width40%

Image Modified


Column
width60%

The column "column2" now contains the expression "AE" and the value of the accointing area.

panel

title






Remove


Section


Column
width100%

Deletes a certain specified text [part].



Panel
titleParameter

Any text.



Panel
titleExample

Parameter "Preview - " - position before: "Preview - travel expense report", position after processing: "Travel expense report".


Expand
titleAnother example for Remove? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In our import file, a few account designations "column3" contain the expressions "BK100", "BK200", "BK300". We remove these expressions with the help of the function "Remove". 



Section


Column
width40%

Image Modified


Column
width60%

For this purpose, the function "Remove" with the parameter "BK100" is created for the column "column3".

Since we are dealing with three different expressions, we need another function for the parameters "BK200" and "BK300".



Section


Column
width40%

Image Modified


Column
width60%

The expressions "BK100", "BK200" and "BK300" are now no longer displayed in the result.

panel

title






RemoveUnsupportedCharacters


Section


Column
width100%

Removes unsupported characters. These include: \\/:*?""<>'|



Panel
titleParameter

Not needed


Panel
titleExample

Position before: "*Settlement*", Position after processing: "Settlement".


Expand
titleAnother example for RemoveUnsupportedCharacters? Read more about it ...


Section


Column
width40%

Image Modified


Column
width60%

In the import file, the name (column2) contains control characters in the form of "\\".



Section


Column
width40%

Image Modified


Column
width60%

To remove these, the function "RemoveUnsupportedCharacters" is used for the columns "column2", without Parameter.



Section


Column
width40%

Image Modified


Column
width60%

The control characters are no longer included in the preview and the import.

Paneltitle






Replace


Section


Column
width100%

Replaces a specific text [part] with a new text.



Panel
titleParameter

Any text to be replaced and any text to be inserted instead.


Panel
titleExample

Parameter "Preview, final version" - position before: "Preview - travel accounting", position after processing: "Final version - travel accounting".


Expand
titleAnother example for Replace? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

After a change in the previous system, the import file now contains the expression "Score" instead of "Result" for some names. This should not be imported into the report. The term should be replaced.



Section


Column
width40%

Image Modified


Column
width60%

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



Section


Column
width40%

Image Modified


Column
width60%

In the preview and the later import, the affected lines now contain the expression "Results".

Paneltitle






ReplaceEmptyWith


Section


Column
width100%

Replaces empty content with new text.



Panel
titleParameter

Any text that is inserted


Panel
titleBeispiel

"Finalversion“ – Position before: "", Position after processing: "Finalversion


Expand
titleAnother example for ReplaceEmptyWith? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the import file, an item does not have the name "column2". Based on the account number, it can be determined that it must be the name "Personnel Expenses".




Section


Column
width40%

Image Modified


Column
width60%

For the name column "column2", the function "ReplaceEmptyWith" is created with the parameter "Personnel Expenses".



Section


Column
width40%

Image Modified


Column
width60%

In the preview and the later import, the affected row now contains the expression "Personnel Expenses".

panel

title






Sort


Section


Column
width100%

Sorts a column in ascending or descending order



Panel
titleParameter

asc = ascending

dsc = descending


Panel
titleBeispiel

Parameter „asc" – the values are sorted in ascending order


Expand
titleAn example for Sort? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

Since an update in the previous system, the delivered import file is sorted by description (column3).

For the processing of the further mapping we would like the sorting by accounting area (column2).



Section


Column
width40%

Image Modified


Column
width60%

For this purpose, an entry for account number (column2) with the function "Sort" and the parameter "asc" is created as an entry in the data processing.



Section


Column
width40%

Image Modified


Column
width60%

We can now carry out further processing of the mapping with the sorted column (column1).

Note

The sorting has no real effect on the actual import, as the display of the items in the period management can be sorted by each field.

panel

title







Split


Section


Column
width100%

Splits the content of a column into two (or more) columns (e.g. [account number] - [name]). This function is only available as of version 2.9.



Panel
titleParameter

The split function expects two parameters (separated by commas as usual):

  • The split character (1 character with or without inverted commas, e.g. "-").
  • The index from the split array to be returned.


Panel
titleExample

Parameter „-,1" – applied to "4711 - my account" delivers "4711".

Parameter „-,2" – applied to "4711 - my account" provides "my account".


Expand
titleAnother example for Split? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the import file, the name (column3) contains the entry "- BKnnn" for some items. 
The entry is to be removed, especially since the company code is specified in the column "column2".



Section


Column
width40%

Image Modified


Column
width60%

We want to separate the name from the separator "-". The separation creates two expressions, of which we need the first expression.

The input for the column "column1" is therefore function "Split" with the parameter "-,1".



Section


Column
width40%

Image Modified


Column
width60%

The preview now shows the names without the second part "- BKnn".

Panel






title

Substring


Section


Column
width100%

Takes over a certain set of characters from a certain position of the value.



Panel
titleParameter

Start position as integer value, integer value for the set of characters


Panel
titleExample

Parameter „3,6“ – Position before: "E-balance sheet", Position after processing: "Balance sheet".


Expand
titleAnother example for Expand? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the present import file, the name columns (column2) start with the expressions "DACH" or "EMEA". We do not want to import these.



Section


Column
width40%

Image Modified


Column
width60%

Since the expressions have the same length at the beginning, we can take the name column from the sixth character. Since the names are not very long, we select the 40 characters after that.

The input for the column "column2" is therefore: Function "Substring" with the parameter "6,40". 

The number of characters to be taken over can be chosen longer than actual characters are present. It is therefore not necessary to determine the exact length.



Section


Column
width40%

Image Modified


Column
width60%

In the preview and the later import, the unwanted expressions are now no longer present.

Paneltitle






Sum


Section


Column
width100%

Sums all numeric values in the value column, grouped by the column to which the Sum function is applied.



Panel
titleParameter
Not needed


Panel
titleExample


Expand
titleAn example for Sum? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the import file, the values per sub-item "Position" are delivered for the items in "column1".

The result should be the sum of all values per main position.



Section


Column
width40%

Image Modified


Column
width60%

To get the desired result, two functions must be inserted:

The function "6237720" takes over the values of the previous row if there is no value. This is to be done for the column "Position". A parameter is not necessary. The function must be in the first position (Verarb. Index = 0).

The following function "Sum" then adds up the values of all items with the same name in the column "Position". In the example, this would be the sum of all records for "10H2", "50000000", etc.



Section


Column
width40%

Image Modified


Column
width60%

In the preview, each group element is now displayed with the sum (EUR) of all sub-items.



Section


Column
width40%

Image Modified


Column
width60%

Without the "TakeOver" function, a total sum would be formed for the empty columns (Programming).

Panel






title

TakeOver


Section


Column
width100%

Takes over the values of the previous line if there is no value.



Panel
titleParameter
Not needed


Panel
titleExample


Expand
titleAn example for TakeOver? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the present import file, the details for account (Position) and designation (Description) are not included in each row.

Since we also need the individual sub-items, the empty columns are to be filled with the previous values.



Section


Column
width40%

Image Modified


Column
width60%

In this case, we need the function "TakeOver" for the columns Account (column1) and Designation (column2), each without parameters.



Section


Column
width40%

Image Modified


Column
width60%

In the preview, the transferred values are now displayed and later also imported.

Paneltitle






Trim


Section


Column
width100%

Removes spaces before and after the position value.



Panel
titleParameter
Not needed


Panel
titleExample

Position before: " Updated", Position after processing: "Updated".


Expand
titleAnother example of Trim? Read more ...


Section


Column
width40%

Image Modified


Column
width60%

In the import file, some name columns (column2) have one or more spaces at the beginning.

This must of course be eliminated, as no table in the later document would have to be neatly arranged.



Section


Column
width40%

Image Modified


Column
width60%

The input for the name column (column2) is quite simple. Trim" is selected as the function, a parameter is not necessary.



Section


Column
width40%

Image Modified


In the preview and the later import, the values in "column2" no longer have leading spaces and are displayed left-justified.

PanelborderColor#666666bgColor#ECECECborderWidth2