Import/Export

Unter System/Import/Export kannst Du verschiedene Prozesse für den Import und Export von Daten in die VARIO Cloud sowie die Ausführung von Skriptverarbeitungen verwalten. Die Vorgänge sind in unterschiedliche Reiter unterteilt, die Dir jeweils eine Übersicht über die bisher durchgeführten Prozesse bieten.

Der Status jedes Vorgangs wird direkt in der Übersicht angezeigt und hilft Dir, eventuelle Fehler schnell zu erkennen. Durch Auswahl eines Eintrags erhältst Du eine detaillierte Ansicht der Prozessschritte. Hier kannst Du nachvollziehen, wie der Vorgang abgelaufen ist. Diese Informationen sind besonders hilfreich, um Fehlerquellen zu identifizieren oder Datenimporte/-exporte zu analysieren.

Folgende Prozesse stehen Dir zur Verfügung:

• Mehrstufige Verarbeitung: Hierbei werden mehrere Import-, Export- oder Skriptvorgänge gebündelt verarbeitet und als ein zusammenhängender Vorgang in der Übersicht dargestellt. Die einzelnen Teilprozesse lassen sich innerhalb dieses Hauptvorgangs nachvollziehen.
• Manuelle und automatisierte Datenimporte: Externe Datensätze aus einer CSV- oder Excel-Datei können entweder manuell Schritt für Schritt oder vollständig automatisiert in die VARIO Cloud importiert werden.
• Manuelle und automatisierte Datenexporte: Bestehende Datensätze aus der VARIO Cloud lassen sich manuell oder automatisiert in eine CSV-Datei exportieren.
• Manuelle und automatisierte Skriptverarbeitung: Externe Datensätze aus einer CSV- oder Excel-Datei können entweder manuell Schritt für Schritt oder vollständig automatisiert anhand eines JavaScript-basierten Skripts in die VARIO Cloud importiert werden.

In den folgenden Abschnitten stellen wir Dir die einzelnen Prozesse unter den jeweiligen Reitern dar. Die einzelnen Schritte innerhalb der Vorgänge basieren auf demselben Prinzip, das wir anhand des manuellen Imports näher erläutern werden.

Manuelle Datenimport

Hier kannst Du externe Datensätze aus einer CSV- oder Excel-Datei manuell Schritt für Schritt in die VARIO Cloud importieren.

Auch die Vorgabedaten-Importe, also der von VARIO bereitgestellten Daten wie Aufgabentypen, -status und -prioritäten, können im Reiter “Manuelle Datenimporte” eingesehen und nachgeprüft werden. Weitere Informationen zu den Vorgabendaten findest Du hier.

Ein Importvorgang in VARIO Cloud besteht grundsätzlich aus fünf Schritten:

1. Datei hochladen: Jeder Importvorgang beginnt mit dem Hochladen einer Quelldatei (CSV oder Excel). Diese Datei dient als Grundlage für den Datenimport.
2. Quellspalten: In diesem Schritt wird analysiert, welche Spalten in der Quelldatei vorhanden sind. Anschließend ordnest Du die Spalten den passenden Feldern in VARIO Cloud zu.
3. Zielspalten: In diesem Schritt kannst Du die Daten aus der Quelldatei anpassen oder erweitern, bevor sie importiert werden. Du hast dabei unter anderem die Möglichkeit, bestimmte Werte zu ersetzen, Festwerte zu definieren oder neue Spalten hinzuzufügen.
4. Validierung: Die Daten werden vor dem eigentlichen Import geprüft – z. B. auf Pflichtfelder, Datenformate oder doppelte Einträge. Eventuelle Fehler werden entsprechend ausgewiesen und können vor dem Import korrigiert werden.
5. Abschluss: Nach dem erfolgreichen Import kannst Du die importierten Datensätze einsehen.
   Zudem kannst Du zu vorherigen Schritten zurückkehren, um diese bei Bedarf noch einmal zu überprüfen.

Importvorgang starten

Mit einem Klick auf den Button “+Datenimport” kannst Du einen neuen Import erstellen. Es öffnet sich eine Auswahl der verschiedenen Bereiche in VARIO Cloud – z. B. Adressen oder Artikel, aus der Du den Bereich auswählen kannst, in dem die zu importierende Daten importiert werden sollen. Diese Auswahl legt fest, welche Zielfelder Dir im nächsten Schritt für die Feldzuordnung zur Verfügung stehen. Alternativ kannst Du über die Option “Aus Vorlage erstellen” auch einen neuen Import aus einer Vorlage erstellen. Weitere Informationen dazu findest Du im Abschnitt “Vorlagen”.

Neben Hauptbereiche wie Adressen oder Artikel kannst Du auch zugehörige Unterbereiche auswählen, z. B. Ansprechpartner oder Zusatzadressen.

Sofort nach dem Anlegen wird der Importvorgang mit Zeitstempel in der Übersicht gespeichert, und Du gelangst direkt in den ersten Schritt des Imports – die Dateiauswahl.

1. Datei hochladen

Der erste Schritt des Imports ist das Hochladen der Quelldatei. Dazu kannst Du entweder auf die Upload-Fläche klicken und die gewünschte Datei aus Deinem Dateisystem auswählen oder die Datei per Drag & Drop direkt in die Fläche ziehen.

Nach Auswahl der Datei aus dem Dateisystem wird der Importvorgang direkt mit dem zweiten Schritt “Quellspalten” fortgesetzt.

Wenn Du die Quelldatei wechseln möchtest, kannst Du entweder über den Button “Zurück” oder durch Klick auf den Dateinamen in der Schrittauswahl wieder zur Dateiauswahl zurückkehren.

Dort kannst Du mit einem erneuten Klick auf die Fläche eine neue Datei aus Deinem System auswählen. Beachte jedoch, dass dabei alle Änderungen in den folgenden Schritten verloren gehen. Wenn nötig, kannst Du die Datei über den Button “Herunterladen” erneut herunterladen.

Bezeichnung anpassen

Über das Stift-Symbol neben der Bezeichnung des Imports kannst Du den Namen jederzeit ändern. Dies ist in allen Schritten des Importvorgangs möglich – bis der Import endgültig abgeschlossen ist.

2. Quellspalten

Im zweiten Schritt des Datenimports ordnest Du die Quellspalten aus Deiner Datei den entsprechenden Feldern aus dem Bereich in VARIO Cloud zu.

Als Beispiel haben wir eine Excel-Datei mit Adressdaten hochgeladen. Die Spaltenüberschriften und Spalteninhalte aus dieser Datei werden unter Quellspalten angezeigt.

• Die erste Zeile enthält die Spaltenüberschriften der Importdatei und wird mit dem Symbol gekennzeichnet.
• Das Symbol markiert die Zeile, ab der die zu importierenden Daten beginnen – in diesem Fall die Adressen.

Spaltenzuordnung

Um die Spalten aus der Quelldatei zu den Feldern in VARIO Cloud zuzuordnen gehe wie folgt vor:

Nach der erfolgreichen Zuordnung aller Spalten aus unserer Beispiel-Quelldatei sehen die Quellspalten wie folgt aus:

Spalten zu spezifischen Feldern zuordnen

In manchen Fällen ist nicht sofort ersichtlich, wie die Bezeichnung des Feldes in VARIO Cloud lautet, zu dem eine Spalte aus der Quelldatei zugeordnet werden soll. Dies liegt daran, dass bestimmte Angaben von weiteren Feldern oder Einstellungen abhängig sein können.

Beispiel Feld “Telefon”

Ein Beispiel dafür ist die in der hochgeladenen Beispiel-Datei enthaltene Spalte “Handy”, welche die Telefonnummern der Kunden enthält. In VARIO Cloud werden Telefonnummern in der Adresse unter den Kontaktinformationen gespeichert.

Hier bestimmt jedoch die Angabe des Kontakttyps, ob das Feld “Telefon” oder z. B. “E-Mail” im Datensatz zur Verfügung steht. Das Feld “Telefon” und dessen Inhalt sind somit vom gewählten Kontakttyp abhängig und stehen nur dann zur Verfügung, wenn der entsprechende Typ angegeben wird.

Aus dem Grund ist bei der Spaltenzuordnung im Import kein Feld mit der Bezeichnung “Telefon” zu finden. Stattdessen muss das Feld “Wert” ausgewählt werden. Dieses dient als universelles Eingabefeld für alle Kontaktinformationen – unabhängig davon, ob es sich um eine Telefonnummer, E-Mail-Adresse oder eine andere Kontaktart handelt. Das Feld “Wert” ist in der Gruppierung Adressen/Kontaktinformationen zu finden.

Für die Bestimmung des entsprechenden Kontakttyps muss im nächsten Schritt eine zusätzliche Spalte unter den Zielspalten hinzugefügt werden. Wie Du dabei vorgehst, zeigen wir Dir im Abschnitt “Operation Fester Wert“.

Beispiel Feld “Land” bzw. “Ländercode”

Ähnlich wie bei der Spalte “Handy” kann auch die Spalte “Land” in unsere Quelldatei nicht direkt einem gleichnamigen Feld in VARIO Cloud zugeordnet werden. In den Adressdaten von VARIO Cloud existiert nämlich kein Feld “Land”. Stattdessen wird in der Anschrift der Ländercode gespeichert.

Aus diesem Grund ist bei der Spaltenzuordnung kein Feld “Land” in der Suche vorhanden. Stattdessen erscheinen die Felder “ISO ALPHA-2” und “ISO ALPHA-3“. In VARIO Cloud wird standardmäßig ISO ALPHA-2 als Länderkennzeichnung für Adressen verwendet (z. B. DE, AT, CH). Deshalb kann für den Import das Feld “ISO ALPHA-2” ausgewählt werden.

Die Länderangaben in Deiner Quelldatei müssen dabei an das ausgewählte Länderkennzeichen (hier ISO ALPHA-2) angepasst werden. Ist dies nicht der Fall, wie in unsere Beispiel-Quelldatei, kannst Du diese im nächsten Schritt – den Zielspalten – für die gesamte Spalte anpassen. Wie Du dabei vorgehst, zeigen wir Dir im Abschnitt “Operation Ersetzen“.

Originale Feldbezeichnungen für die Spaltenzuordnung verwenden

Wenn bei der Suche nach dem passenden Feld in der Spaltenauswahl des Imports die Bezeichnung nicht sofort eindeutig ist, kann es hilfreich sein, die interne bzw. originale Bezeichnung des Feldes direkt in VARIO Cloud nachzusehen.

So gehst Du vor – am Beispiel der Adress-Stammdaten:

Quelldaten manuell bearbeiten

Durch das Anklicken einer Zeile in der Tabelle kannst Du die darin enthaltenen Daten manuell bearbeiten.
Die vorgenommenen Änderungen werden direkt in den Quellspalten gespeichert und automatisch in den weiteren Importvorgang übernommen.

Quelldatei-Einstellungen

Oben rechts in der Ansicht der Quellspalten findest Du den Button “Quelldatei-Einstellungen”. Hier kannst Du verschiedene Einstellungen zur Quelldatei anpassen, z. B. in welcher Zeile sich die Kopfzeile Deiner Quelldatei befindet.

In den Quelldatei-Einstellungen stehen Dir folgende Optionen zur Verfügung:

Datensätze ab/Datensätze bis – Mit diesen Feldern kannst Du festlegen, welche Datensätze importiert werden sollen. Standardmäßig ist hier die zweite Zeile als Startpunkt eingetragen. Diese ist mit dem Symbol in der Vorschau markiert.

Kopfzeilenindex – Gibt die Zeile der Quelldatei an, die als Kopfzeile verwendet wird. Standardmäßig ist hier die erste Zeile eingetragen, die entsprechend mit dem Symbol markiert wird.

Datum: Muster – Definiert das Muster für die Datumsangaben. Damit der Import für alle Datensätze erfolgreich durchgeführt werden kann, müssen alle Datumsangaben in der Quelldatei den eingetragenen Muster entsprechen. Dabei steht die Angabe “yyyy” für das Jahr, “MM” für den Monat und “dd” für den Tag.

Datum und Uhrzeit: Muster – Entspricht dem Datums-Muster, erweitert um Uhrzeitangaben. Auch hier müssen alle Werte im gleichen Format vorliegen. Neben der Datumsangabe stehen die Angaben “HH” für die Uhrzeit, “mm” für die Minuten und “ss” für die Sekunden.

Zahl: Tausender-Trennzeichen – Hier gibst Du an, welches Zeichen für die Trennung von Tausendern verwendet wird.

Zahl: Dezimal-Trennzeichen – Hier definierst Du das Zeichen für Dezimalstellen.

Boolean: Wert für true – Definiert, welcher Wert in der Quelldatei für das booleschen Wert true (wahr) steht. In VARIO Cloud werden boolesche Werte meist als Toggles dargestellt – bei true ist der Toggle aktiviert.

Boolean: Wert für false – Definiert, welcher Wert in der Quelldatei für das booleschen Wert false (falsch) steht. In VARIO Cloud werden boolesche Werte meist als Toggles dargestellt – bei false ist der Toggle deaktiviert.

Regelwerk herunterladen/hochladen – Alle Anpassungen an den Quellspalten und Quelldatei-Einstellungen kannst Du als Regelwerk herunterladen und für spätere Importe mit gleichen Spaltenköpfen wiederverwenden. So sparst Du Zeit bei wiederkehrenden Importen.

Experten Modus – Führt die Schritte Quellspalten und Zielspalten zusammen. Dadurch stehen zusätzliche Möglichkeiten zur Datenmanipulation zur Verfügung. Details dazu findest Du im Abschnitt “Experten Modus”.

Muster	Beispiel	Beschreibung
yyyy-MM-dd	2015-10-21	ISO 8601-Format
dd.MM.yyyy	21.10.2015	deutsches Format, mit verpflichtenden führenden Nullen
d.M.yyyy	1.1.2015	deutsches Format, führende Nullen optional
MM/dd/yyyy	10/21/2015	US-Format
yyyy-MM-dd[‘T’HH:mm:ss]	2015-10-21T14:59:42	Der Zeitanteil wird hier einfach weggeschnitten
yyyy-MM-dd’T’HH:mm:ssZ	2015-10-21T14:59:42Z	ISO 8601 – Zeit in UTC

Export-Einstellungen

3. Zielspalten

Nachdem alle Spalten zugeordnet wurden, kannst Du mit dem dritten Schritt fortfahren. Klicke dazu auf “Weiter” oder direkt auf den Schritt “Zielspalten” in der oberen Leiste. In diesem Schritt kannst Du die Daten aus Deiner Quelldatei so anpassen, dass diese effizient und erfolgreich importiert werden. Dazu kannst Du beispielsweise neue Spalten hinzufügen und mit Festwerten füllen oder bestehende Werte über die Zielspalten Konfiguration gezielt ersetzen. Bereits bearbeitete Zielspalten werden mit einem Männchen-Symbol gekennzeichnet.

Mit einem Klick auf eine Zeile werden die Daten des einzelnen Datensatzes im Überblick angezeigt. Die Darstellung erfolgt dabei analog zu den Quellspalten.

Suche von Zieleinträgen

In den Zielspalten steht Dir oben links die Suche nach Zieleinträgen zur Verfügung. Damit kannst Du schnell bestimmte Datensätze aus Deinen Importdaten finden. Die Suche funktioniert unabhängig vom Feld – Du kannst sowohl nach der Adressnummer als auch nach dem Namen der Adresse oder anderen Angaben suchen.

Damit Suchergebnisse angezeigt werden, muss die Eingabe mindestens drei Zeichen umfassen. Die Ergebnisliste wird jedoch nach jeder Eingabe automatisch aktualisiert.

Zielspalten hinzufügen

Über die allgemeine Spaltensuche kannst Du – ähnlich wie bei den Quellspalten – nach Spalten suchen, die zu den Felder in VARIO Cloud entsprechen, um diese zu den bereits vorhanden Spalten hinzuzufügen. In Verbindung mit der Zielspalten Konfiguration hast Du so die Möglichkeit, fehlende Werte durch das Einfügen von Festwerten nachträglich zu ergänzen oder Inhalte aus einer Quellspalte auf mehrere Zielspalten aufzuteilen.

Im Abschnitt “Operation Fester Wert” zeigen wir Dir am Beispiel, wie Du durch das Hinzugefügen einer neuen Zielspalte den fehlendenden Kontakttyp für vorhandene Telefonnummern ergänzen kannst.

Wie Du die Werte aus einer Quellspalte in zwei separate Spalten aufteilst – z. B. um Straßenname und Hausnummer aus einer gemeinsamen Spalte zu trennen – erfährst Du im Abschnitt “Operation Ersetzen (Regex)”.

Zielspalten Konfiguration

Wenn Du unter “Zielspalten” auf eine Spaltenüberschrift klickst, öffnet sich ein Pop-up-Fenster. Dort stehen Dir im Feld “Typ” verschiedene Operationen zur Verfügung, mit denen Du die Inhalte der gewählten Spalte bearbeiten kannst. Auf diese Weise kannst Du die Daten genau so anpassen, wie Du sie für den Import benötigst.

Je nach gewählter Operation kannst Du für eine Spalte auch mehrere weitere Operationen definieren und miteinander kombinieren. Auf diese Weise lassen sich verschachtelte Konfigurationen einrichten, mit denen auch komplexere Anforderungen im Importprozess abgebildet werden können.

Nach dem Speichern einer Zielspalten-Konfiguration kannst Du diese jederzeit durch erneutes Anklicken des Spaltenkopfs anpassen. Über den Button “Löschen” lässt sich die gesamte Konfiguration für die entsprechende Spalte entfernen – die ursprünglichen Werte aus der Quelldatei bleiben dabei unverändert erhalten.

Felder der Zielspalten Konfiguration (unabhängig der ausgewählte Operation):

Zielspalte – Auswahl des Feldes, dem die Daten aus der Quellspalte zugeordnet werden sollen. Dies entspricht der Spaltenzuordnung im Schritt “Quellspalten”. Je nach Zielspalte wird angezeigt, wie lang ein Wert sein darf bzw. ob er zwingend gefüllt sein muss, damit der Import erfolgreich durchgeführt werden kann.

Typ – Hier legst Du die gewünschte Operation fest. Standardmäßig ist “Aus Spalte auslesen” vorausgewählt, sodass die Daten direkt aus der unter “Spaltenbezeichnung” angegebenen Quellspalte übernommen werden. Je nach Operation kann diese auch über die drei Punkte rechts ausgewählt werden.

Spaltenbezeichnung – Auswahl der Quellspalte, aus der die Werte für die Operation übernommen werden sollen.

Erweiterte Einstellungen/Leerwerte – Lege fest, ob leere Werte aus der Quelldatei beim Import ignoriert werden oder ob sie bestehende Daten im System ersetzen sollen. Mit Leerwerten sind ausschließlich komplett fehlende Angaben gemeint – nicht Werte wie “0” oder Felder mit Leerzeichen. Das Ersetzen durch Leerwerte spielt insbesondere eine Rolle, wenn bereits vorhandene Datensätze durch den Import aktualisiert werden.

Gültige Werte – Je nach Zielspalte werden hier die vordefinierten Werte angezeigt, die zugeordnet werden können. Dies betrifft Felder mit fest in VARIO integrierten Werten, die nicht selbst angelegt werden können, z. B. Geschäftsbeziehungen, Artikelart oder Preisbasis. Beim Hoovern über einen Wert wird die jeweilige Übersetzung eingeblendet. Ein Beispiel dazu findest Du im Abschnitt Operation “Ersetzen”.

Konfiguration ändern oder entfernen

Nach dem Speichern einer Zielspalten Konfiguration kann diese jeder Zeit im Schritt “Zielspalten” durch erneutem Anklicken des Spaltenkopfs angepasst werden. Über dem Button “Löschen” kann die gesamte Konfiguration für die entsprechende Spalte entfernt werden, ohne dass die ursprünglichen Werten aus der Quelldatei verloren gehen.

Operation Aus Spalte auslesen

Die Operation “Aus Spalte auslesen” ist die Standardoperation. Dabei werden die Werte direkt aus der im Feld “Spaltenbezeichnung” angegebenen Quellspalte übernommen. Standardmäßig ist dies die Quellspalte, die im vorherigen Schritt der Zielspalte zugeordnet wurde. Falls erforderlich, kannst Du hier jedoch auch eine andere Quellspalte auswählen, aus der die Daten ausgelesen werden sollen.

Operation Coalesce (NULL-Ersetzung)

Mit der Operation “Coalesce (NULL-Ersetzung)” kannst Du fehlende Werte durch vordefinierte Werte ersetzen – ohne dabei bereits vorhandene Daten zu überschreiben. Dabei handelt es sich um nicht vorhandene Datenwerte – also leere Angaben, nicht um Inhalte wie Null oder Leerzeichen.

Wenn Du die Operation “Coelesce” (NULL-Ersetzung)” auswählst, erscheinen zwei ausklappbare Bereiche:

• Im ersten Bereich legst Du fest, welche Leerwerten ersetzt werden sollen.
• Im zweiten Bereich gibst Du mithilfe der entsprechende Operation den Wert an, durch den die Leerwerten ersetzt werden sollen.

Fehlt z. B. in einer Quelldatei bei allen Adressen aus Neuwied die Angabe der Stadt, kannst Du mit de Operation “Coalesce (NULL-Ersetzung)” den festen Wert “Neuwied” in die entsprechende Spalte einfügen.

Um die fehlende Werte mit einem festen Wert zu ergänzen, gehe wie folgt vor:

Operation Ersetzen

Mit der Operation “Ersetzen” kannst Du bestimmte Werten aus einer Spalte durch vordefinierte Werte ersetzen. Ein Beispiel ist das Ersetzen von Ländernamen durch Ländercodes, die im System für die Erkennung des Landes und die zugehörige Sprache benötigt werden.

Dafür stehen Dir folgende Felder zur Verfügung:

• Suchen nach: Gib hier den Wert ein, das ersetzt werden soll.
• Ersetzen durch: Gib hier den Wert ein, durch den der ursprüngliche Wert ersetzt werden soll.

Über das Pluszeichen kannst Du beliebig viele Werte hinzufügen, die innerhalb derselben Spalte ersetzt werden sollen. Wenn die bestehende Werte durch gültige Werte ersetzt werden müssen, erscheint im Feld “Ersetzen durch” einen Drop-Down-Menü. Über dieses kannst Du den entsprechenden gültigen Wert auswählen.

Zusatzoptionen zur Operation Ersetzen

Neben den Feldern “Suchen nach” und “Ersetzen durch” stehen Dir weitere Optionen zur Verfügung, um das Ersetzen von Werten genauer zu steuern:

Nur gesamten Wert ersetzen

Mit dem Toggle kannst Du bestimmen, ob nur ganze Werte ersetzt werden sollen oder auch einzelne Bestandteil davon, wie z. B. ein Buchstabe, eine Zahl oder ein Wort.

Groß/Kleinschreibung beachten

Mit dem Toggle legst Du fest, ob die Groß- und Kleinschreibung beim Ersetzen berücksichtigt werden soll. Ist der Toggle deaktiviert, werden alle Werte ersetzt – unabhängig davon, ob sie groß- oder kleingeschrieben sind.

Fallback verwenden, wenn kein Ausdruck passt

Im darunterliegenden Feld kannst Du einen Fallback-Wert angeben, der eingesetzt wird, wenn keiner der definierten Werten zutrifft. Beachte jedoch, dass in diesem Fall alle Werte ersetzt werden – auch solche, die möglicherweise unverändert bleiben sollten. Lässt Du das Feld “Fallback” bei aktiviertem Toggle leer, werden alle nicht ersetzten Werte automatisch entfernt.

Geschäftsbeziehungen mit Gültigen Werten ersetzen

Einige Werte müssen durch die unter “Gültige Werte” aufgeführten Einträge ersetzt werden, damit sie erfolgreich importiert und den Datensätzen korrekt zugeordnet werden können. Dabei handeln sich größtenteils um fest in der Software integrierte Werte wie z. B. Geschäftsbeziehungen oder Artikelarten. Damit diese erkannt werden, müssen die unter “Gültige Werte” aufgelisteten originalen Bezeichnungen verwendet werden. Diese entsprechen den Bezeichnungen, wie sie in VARIO Cloud systemintern geführt und verarbeitet werden.

Fehlen in einer Spalte die Originalbezeichnungen bzw. gültigen Werte, wird dies spätestens im Schritt “Validierung” deutlich gekennzeichnet. Anschließend kannst Du einfach zu den Zielspalten zurückkehren und die Angaben entsprechend anpassen.

Um die in der Quelldatei verwendeten Werte – z. B. die Geschäftsbeziehung – durch Gültige Werte zu ersetzen, gehe folgendermaßen vor:

Operation Ersetzen (Regex)

Mit der Operation “Ersetzen (Regex)” können Werte anhand von regulären Ausdrücken (Regex) ersetzt oder aufgeteilt werden. Reguläre Ausdrücke sind Zeichenketten, mit sich bestimmte Muster in Text beschreiben lassen. Damit kannst Du z. B. Zahlen von Buchstaben unterscheiden und dadurch Werte gezielt trennen oder anpassen.

Wenn z. B. in einer Spalte sowohl der Straßenname als auch die Hausnummer zusammengeführt sind – wie in unserer Beispiel-Quelldatei –, kannst Du mit der Operation “Ersetzen (Regex)” beide Werte voneinander trennen. So gehst Du vor:

Operation Fester Wert

Mit der Operation “Fester Wert” kannst Du einen bestimmten Wert für die gesamte Spalte einfügen. Diese Operation ist besonders nützlich für neu hinzugefügte Zielspalten, die nur mit einem einzigen Wert gefüllt werden müssen.

Typische Anwendungsfälle sind Werte, die für die Vollständigkeit der Daten oder für die Zuordnung zu bestehenden Angaben erforderlich sind – z. B. der Kontakttyp zu den jeweiligen Kontaktinformationen.

Um mit der Operation “Fester Wert” einen Kontakttyp zu allen Adressen hinzuzufügen, gehe wie folgt vor:

Operation Großschreibung

Operation Kleinschreibung

Operation Trimmen

Mit der Operation “Trimmen” werden Leerzeichenam Anfang und Ende der Werte aus der Quelldatei entfernt. Leerzeichen innerhalb eines Wertes, z. b. im Name einer Adresse, bleiben dabei erhalten.

Im einfachsten Fall musst Du in der Zielspalten Konfiguration für die gewünschte Spalte lediglich im Feld “Typ” die Operation “Trimmen” auswählen und die Konfiguration speichern. Dadurch werden die überflüssigen Leerzeichen bei allen Werten dieser Spalte automatisch entfernt.

Je nach Umfang und Struktur der Quelldatei – insbesondere bei Dateien mit sehr vielen Datensätzen – kann es sinnvoll sein, die Operation “Trimmen” grundsätzlich in allen Spalten einzusetzen. So stellst Du sicher, dass die Daten sauber und ohne störende Leerzeichen importiert werden.

Wie sich diese Operation mit anderen kombinieren lässt, erfährst Du im nächsten Abschnitt zur Operation “Verketten”.

Operation Verketten

Mit der Operation “Verketten” kannst Du mehrere verschiedene Operationen miteinander kombinieren. Das ist besonders nützlich für Operationen, die in allen Spalten angewendet werden sollten, wie z. B. das Trimmen von Leerzeichen, um diese mit weiteren Operationen wie “Ersetzen” oder “Coalesce (NULL-Ersetzung)” zu verbinden.

Eine Verkettung muss mindestens zwei Operationen enthalten. Außerdem können auch weitere Verkettungen innerhalb einer Verkettung eingebaut werden, um komplexere Abläufe abzubilden.

Nach Auswahl der Operation “Verketten” steht Dir ein Feldbereich zur Verfügung, in dem Du die erste Operation im Feld “Typ” festlegst. Standardmäßig ist – wie bei anderen Operationen – der Typ “Aus Spalte auslesen” vorausgewählt.

Durch das Hoovern über die drei Punkte ober- oder unterhalb einer Operation kannst Du mit dem Pluszeichen (+) weitere Operationen hinzufügen.

Die Operationen werden in der angegebenen Reihenfolge für die Spalte ausgeführt. Im folgenden Beispiel werden zunächst die leeren Werte mit der Operation “Coalesce (NULL-Ersetzung)” ersetzt. Anschließend entfernt die Operation “Trimmen” die überflüssigen Leerzeichen in allen Werten der Spalte.

Mit dem Symbol rechts kannst Du die einzelnen Operationen jederzeit verschieben und neu anordnen, um die gewünschte Reihenfolge festzulegen.

4. Validierung

Nachdem Du die Konfigurierung der Zielspalten abgeschlossen hast, kannst Du über den Button “Weiter” oder durch Klick auf den Schritt “Validierung” in der oberen Leiste zur Validierung wechseln.

Mit dem Button “Validierung starten” führst Du die Validierung durch. Bevor Du diese startest, kannst Du jedoch über den Button “Relationsverhalten” zusätzliche Einstellungen vornehmen – mehr dazu ehrfährst Du im untenstehenden Abschnitt.

Beim Start der Validierung wird der Validierungsvorgang in VARIO Cloud als Task angelegt. Mit einem Klick auf Dein Profilbild und anschließend auf den Button “Benutzertasks” kannst Du den Verlauf Deiner Benutzertasks einsehen.

Nach Abschluss der Validierung erscheint eine entsprechende Meldung:

Die Validierung kann beliebig oft durchgeführt werden, solange die Datensätze noch nicht endgültig importiert wurden. So kannst Du sie nach jeder nachträglichen Anpassung erneut ausführen. Über den Button “Zurück” oder durch Auswahl eines vorherigen Schritts in der oberen Leiste kannst Du jederzeit zu einem früheren Schritt zurückkehren und dort Änderungen vornehmen.

Links neben dem Button “Relationsverhalten” wird angezeigt, wie viele Datensätze ignoriert, wie viele als korrekt und wie viele als fehlerhaft ausgewertet wurden. Ein Klick auf die jeweilige Zahl filtert die Datensätze entsprechenden. Es wird ebenfalls aufgelistet welche Datensätze bereits importiert wurden und welche noch ausstehen. Diese können mit einem erneuten Klick auf “Daten importieren” auch nachträglich im gleichen Importvorgang importiert werden.

Fehlerhafte Datensätze werden mit einem roten Drop-Down-Symbol markiert. Beim Aufklappen erhältst Du detaillierte Hinweise darüber, warum der Datensatz als fehlerhaft validiert wurde. Über den Button “Validierungsfehler” kannst Du zudem eine Gesamtübersicht aller Fehlermeldungen einsehen.

Alle als korrekt validierten Datensätzen können mit einem Klick auf “Daten importieren” in Deine VARIO Cloud übernommen werden. Über das Hackensymbol unterhalb der Datensätze kannst Du alle markieren.

Relationsverhalten

Über die Relationsverhalten-Einstellungen kannst Du festlegen, ob beim Import die Datensätze neu hinzugefügt oder aktualisiert werden sollen, oder beides.

Die Werte sind nach Kategorien gegliedert, die den Spaltengruppierungen entsprechen. So kannst Du datenspezifisch festlegen, welche Datensätze neu eingefügt und welche aktualisiert werden sollen. Je nach gewählter Kategorie, stehen Dir folgende Optionen zur Verfügung:

• Aktualisieren: Es werden nur bereits vorhandene Datensätze aktualisiert. Dafür muss ein eindeutiger Datenwert, z. B. Kundennummer oder Adressnummer, vorhanden sein, über den die Datensätze in VARIO Cloud anhand der Werte unter “Felder zum Identifizieren” erkannt und zugeordnet werden können.
• Einfügen: Es werden ausschließlich neue Datensätze hinzugefügt.
• Einfügen oder Aktualisieren: Es werden sowohl bereits vorhandene Datensätze aktualisiert als auch neue hinzugefügt. Bereits vorhandene Datensätze werden anhand der Werte unter “Felder zum Identifizieren” erkannt.
• Laden: Bereits vorhandene Datensätze werden aus der Datenbank übernommen. Diese Option steht standardmäßig bei Datensätzen aus den Einstellungen zur Verfügung, z. B. Tags oder Rechtsformen.
• Einfügen oder Laden: Bereits vorhandene Datensätze werden übernommen oder – falls sie nicht existieren – neu hinzugefügt. Diese Optionen steht ebenfalls standardmäßig bei Datensätzen aus den Einstellungen zur Auswahl, z. B. Tags oder Rechtsformen.

Bei den Optionen “Aktualisieren”, “Einfügen und Aktualisieren” und “Einfügen und Laden” muss mindestens ein Feld zur Identifizierung angegeben werden. Als Felder zum Identifizieren werden die Felder aus der Kategorie ausgewählt, anhand derer bereits vorhandene Datensätze erkannt werden sollen, z. B. die ID oder Adressennummer. Anhand dieser Felder kann das System die bestehende Datensätze eindeutig identifiziert und die entsprechende Datensätze aktualisiert oder laden. Nach Auswahl eines Feldes wird automatisch ein weites Feld hinzugefügt, sodass Du bei Bedarf mehrere Identifikationsfelder definieren kannst.

Bedingungen zum Ignorieren

Nach dem Aufklappen des Bereich kannst Du über das Pluszeichen (+) Bedingungen hinzufügen, nach denen eine gesamte Datenkategorie (Objekt) ignoriert werden soll. Im Gegensatz zur Option “Ignorieren” innerhalb der Zielspalten Konfiguration, betrifft diese Einstellung nicht nur einzelne Werte aus einer Spalte, sondern alle Daten der jeweiligen Kategorie, die zu einem Datensatz gehören, z. B. alle Werte zur Kontaktinformation. Fügst Du also eine Bedingung zum Hauptobjekt hinzu, wird der gesamte Datensatz vom Import ausgeschlossen.

Im folgenden Beispiel wird mit einer Bedingung festgelegt, dass, wenn das Feld ID leer ist, der gesamte Datensatz vom Import ausgeschlossen werden soll.

Folgende Felder stehen Dir für die Definition der Bedingungen zur Verfügung:

Feld – Wähle das Feld aus, anhand dessen bestimmt werden soll, ob der Datensatz ignoriert werden soll.

Vergleichsoperator – Bestimmt, welcher Teil des im Feld “Vergleichswert” angegebenen Werts oder welches Kriterium für den Abgleich verwendet wird.

Vergleichswert – Gib den Wert an, anhand dessen die Datensätze erkannt werden, die beim Import ignoriert werden sollen.

5. Abgeschlossen

Nachdem Du die Validierung abgeschlossen und alle notwendigen Anpassungen vorgenommen hast, kannst Du über den Button “Daten importieren” die Datensätze in Deine VARIO Cloud übernemmen.

Dabei wird ebenfalls ein Task gestartet, der vom VARIO Task-Manager gesteuert wird. Mit einem Klick auf Dein Profilbild und anschließend auf den Button “Benutzertasks” kannst Du den Verlauf Deiner Benutzertasks einsehen.

Nach Abschluss des Import erscheint eine entsprechende Meldung:

Nachdem alle Datensätze importiert wurden, werden diese im Schritt “Abschluss” aufgelistet. Auch nach Abschluss des Imports kannst Du über die oben angeordneten Schritte weiterhin auf die vorherigen Abschnitte zugreifen.

Zwar sind nachträgliche Änderungen dann nicht mehr möglich, jedoch können so die getroffenen Einstellungen und Zuordnungen innerhalb des Imports auch im Nachhinein eingesehen werden.

Auch wenn nur ein Teil der Datensätze korrekt validiert wurde, können diese dennoch – ohne die fehlerhaften Datensätze – importiert werden. In diesem Fall erhält der Importvorgang den Status “Fehlerhaft”. Nach entsprechender Anpassung können die fehlerhaften Datensätze auch nachträglich über den Button “Daten importieren” im Validierungsschritt importiert werden.

Experten Modus

Durch das Aktivieren des Experten Modus werden die Schritte “Quellspalten” und “Zielspalte” miteinander verschmolzen. Dadurch stehen Dir erweiterte Möglichkeiten sowie zusätzliche Operationen zur Verfügung, die im normalen Importvorgang nicht vorhanden sind.

Mit aktiviertem Expertenmodus ändert sich die Ansicht der Spalten. Links werden die Bezeichnungen der Spalten aus der Quelldatei angezeigt, rechts die Zuordnung zu den entsprechenden Feldern in VARIO Cloud.

Beim Auswählen einer Spaltenzuordnung in der neuen Ansicht, öffnet sich die Zielspalten Konfiguration, in der – wie auch im Schritt “Zielspalten” – die gewünschten Operationen bearbeitet werden können.

Zusätzliche Funktionen im Experten Modus:

• Quellspalten verwalten – Hier kannst Du die Zuordnung der Quellspalten-Bezeichnungen zu den mit Buchstaben gekennzeichneten Excel-Spalten einsehen und bearbeiten.
  • Mit dem Mülleimer-Symbol lassen sich vorhandene Quellspalten löschen.
  • Über “+Quellspalte” kannst Du zusätzliche Quellspalten hinzufügen. Diese müssen anschließend über “+Zuordnung” einer Zielspalte zugeordnet werden, um in der Übersicht zu erscheinen.
• +Zuordnung – Mit dieser Option kannst Du weitere Spalten hinzufügen. Im Feld “Zielspalte” wählst Du das Feld aus, dem die neue Spalte zugeordnet werden soll. Die weiteren Einstellungen entsprechen den Feldern aus der allgemeinen Zielspalten Konfiguration.

Operation Objektbildung

Mit der Operation “Objektbildung” kannst Du Zusammensetzungen aus mehreren Spalten innerhalb einer Spaltengruppierung erstellen. Dazu wählst Du im ersten Feld “Zielspalte” entweder eine Spalte oder eine komplette Spaltengruppierung über den Kreis aus.

Wenn Du z. B. die Gruppierung “Kundeninformationen” auswählst, kannst Du in den Unteroperationen eine der darin enthaltenen Spalten als Zielspalte angeben. Durch das Hinzufügen mehrerer Unteroperationen lassen sich auch mehrere Spalten derselben Gruppierung auswählen und befüllen. Wie Du weitere Operationen hinzufügen kannst, erfährst Du hier.

Ein Beispiel für den Einsatz der Objektbildung ist der Import von mehreren Kontaktinformationen – etwa einer Telefonnummer und einer E-Mail-Adresse. Wie Du dabei vorgehst, zeigen wir Dir im folgenden Abschnitt.

Mehrere Kontaktinformationen importieren

Der Expertenmodus ist hilfreich, wenn in der Quelldatei mehrere Angaben für dieselbe Feldbezeichnung vorhanden sind – z. B. zwei unterschiedliche Kontaktinformationen wie Telefonnummer und E-Mail-Adresse.

Um den Experten Modus einzusetzen und mehrere Kontaktinformationen zu importieren, gehe folgendermaßen vor:

Operation Zeilenindex

Hiermit lässt sich eine Spalte zeilenweise mit einem Zeilenindex füllen. Die erste Datenzeile erhält die Ziffer “1” und darauffolgende Zeilen erhalten aufsteigende Ziffern.

Vorlagen

Vorlagen erstellen

Mit einem Rechtsklick auf einen bestehenden Importvorgang oder eine Skriptverarbeitung stehen Dir zwei Optionen zu Verfügung:

• Als Vorlage für neuen Import verwenden: Kopiert die Einstellungen des gewählten Vorgangs, um daraus einen neuen Import oder eine neue Skriptverarbeitung zu erstellen. Dabei werden Eigenschaften wie Spaltenzuordnungen und weitere Einstellungen aus dem ursprünglichen Vorgang übernommen.
• Als Vorlage anlegen: Erstellt eine dauerhafte Vorlage auf Basis des aktuellen Vorgangs. Diese kann später bei neuen Importen oder Skriptverarbeitungen verwendet werden. Wie Du eine solche Vorlage verwenden kannst, erfährst Du im nächsten Abschnitt.

Vorlagen verwenden

Mit der Option “Aus Vorlage erstellen” kannst Du einen Importvorgang oder eine Skriptverarbeitung auf Basis einer bereits angelegten Vorlage durchführen.

Im Schritt “Datei hochladen” lädst Du eine neue Quelldatei hoch. Wenn das Dateiformat und den Spaltenaufbau mit der ursprünglichen Quelldatei übereinstimmen, werden alle Einstellungen der Vorlage – einschließlich Feldzuordnungen und Eigenschaften – automatisch übernommen. Diese Option eignet sich besonders, wenn Du regelmäßig gleich strukturierte Dateien importierst oder verarbeitest.

Manuelle Datenexporte

Hier werden Dir die manuell durchgeführten Exporte aus einem der VARIO Cloud Bereiche aufgelistet. Wählst Du einen Export aus, werden Dir die einzelnen Schritte und die exportierten Datensätze angezeigt.

Manuelle Skriptverarbeitung

Nutze ein JavaScript-basiertes Skript, um den Importvorgang individuell zu steuern. Im Gegensatz zum manuellen Datenimport, wählst Du beim Starten des Vorgangs keinen festen Bereich aus – stattdessen definierst Du den Zielbereich direkt im Skript. So kannst Du den Import flexibel an komplexe Anforderungen anpassen. Neben den Dateiformaten XLSX und CSV können auch JSON-Dateien hochgeladen werden.

Die Importschritte entsprechen weitgehend denen eines manuellen Datenimports. Mit einer Ausnahme: Der Schritt “Zielspalten” entfällt und wird durch den Schritt “Skript” ersetzt. Dort legst Du per JavaScript fest, welche Felder wie zugeordnet werden sollen, was Dir maximale Flexibilität bei komplexeren Importanforderungen bietet.

Dabei bietet Dir der Skript-Editor mehrere Optionen, die Dir bei der Verfassung helfen können:

Option	Beschreibung
	Deine zuletzt vorgenommenen Änderungen am Skript werden dauerhaft gespeichert. Alle Änderungen müssen gespeichert werden, bevor Du zum nächsten Schritt wechseln kannst. Gespeicherte Änderungen bleiben erhalten auch wenn Du den Tab oder das Browserfenster schließt.
	Ungespeicherte Änderungen können rückgängig gemachen werden – und zwar vollständig bis zum letzten Speichervorgang. Aus diesem Grund empfiehlt es sich, regelmäßig zwischenzuspeichern. So vermeidest Du außerdem, dass größere Anpassungen versehentlich verloren gehen – z. B. durch ein versehentliches Schließen des Tabs oder Browserfensters.

Stapel-Verarbeitung

In jedem Bereich in VARIO kannst über den Stapel-Verarbeitung-Symbol eine Stapel-Verarbeitung zu dem Bereich starten. Dabei stehen Die die zwei Optionen zur Verfügung:

• Skript-Verarbeitung: Du kannst eine Stapel-Verarbeitung anhand eines Skriptes, der auf JavaScript basiert, durchführen.
• Import-Verarbeitung: Du kannst eine Stapel-Verarbeitung anhand von selbst definierten Quell- und Zielspalten durchführen.

Nützliche Import-Skripte

Datensätze löschen/deaktivieren

In bestimmten Fällen kann es sinnvoll sein, Datensätze gezielt per Skript zu deaktivieren oder vollständig zu löschen – zum Beispiel bei Datenbereinigungen oder zur Pflege veralteter Datensätze.

Mit folgendem Skript kannst Du anhand einer Artikelnummer gezielt einen Artikel auswählen und entweder deaktivieren oder löschen:

• articleService.deactivate(…) – Deaktiviert den Artikel – nützlich für Artikel, zu denen bereits weitere Datensätze bestehen. In solchen Fällen kann der Artikel nicht gelöscht werden.
• articleService.deleteById(…) – Löscht den Artikel endgültig aus dem System. Wenn bereits verknüpfte Datensätze existieren, schlägt der Löschvorgang beim Import fehl.

Das Skript kann flexibel für unterschiedliche Verwaltungen, Datensätze und Einsätze angepasst und erweitert werden – z. B. für die Massenbearbeitung mehrerer Datensätze, die Filterung nach bestimmten Eigenschaften oder die Kombination mit weiteren Prüfungen. Das Skript kann ebenfalls im Benutzerskript im Workflow verwendet werden, wenn es entsprechend angepasst wird.

Tags in Adressen anpassen

Mithilfe des folgenden Import-Skripts kannst Du in der Adressverwaltung einen bestimmten Tag bei allen Adressen, die diesen enthalten, durch einen neuen, vordefinierten Tag ersetzen.

const OLD_TAG_LABEL – Bezeichnung des bestehenden Tags, der ersetzt werden soll – z. B. “Interessent”

const NEW_TAG_ID – Interne ID des neuen Tags, das zugewiesen werden soll. Die ID kann über die Spalte ID im Datagrid unter Einstellungen/Allgemein/Tags eingesehen werden.

Das Skript kann flexibel für unterschiedliche Verwaltungen, Datensätze und Einsätze angepasst und erweitert werden – z. B. können statt von Adressen die Tags mehrere Artikel oder Aufgaben geändert werden.

Themenüberblick

• Datenmigration aus VARIO 8