For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stapel-Verarbeitung

Mehrere Datensätze per Import oder Skript gesammelt verarbeiten und automatisiert anpassen.

Über das Stapel-Verarbeitungs-Symbol oberhalb einer konfigurierbaren Tabelle (C-Unit) kannst Du eine Stapel-Verarbeitung starten, wenn die Funktion dort angeboten wird. Sie ist für unterschiedliche Datensätze nutzbar, etwa Artikel, Adressen und Belege, aber auch Einträge unter Einstellungen oder System, beispielsweise Belegarten, Aufgabentypen und Workflows.

Dabei stehen Dir die vier Optionen zur Verfügung:

  • Vordefinierte Stapel-Aktionen: Verarbeite die gefilterten Datensätze mit einem angebotenen Skript aus System → Skripte.

  • Individuelle Stapel-Aktion: Verarbeite die gefilterten Datensätze mit einem eigenen JavaScript-Skript.

  • Import-Verarbeitung: Ändere die gefilterten Datensätze über selbst definierte Quell- und Zielspalten.

  • Export-Verarbeitung: Exportiere die gefilterten Datensätze anhand der eingestellten Parameter als CSV-, JSON- oder XML-Datei.

In den folgenden Abschnitten gehen wir die einzelnen Stapel-Verarbeitungen Schritt-für-Schritt durch. Der Ablauf basiert dabei auf dem Ablauf eines Datenimports, mit Abweichungen je nach Art der Verarbeitung. Aus dem Grund findest Du genauere Informationen zu den einzelnen Schritten auf der Seite Manuelle Datenimporte.

Datensätze vor der Verarbeitung selektieren!

Vorbereitung: Datensätze selektieren

Grenze die gewünschten Datensätze zuerst über die Filter der Selektion ein und prüfe die angezeigte Ergebnismenge. Die Verarbeitung über das Symbol oberhalb der Tabelle ist nicht auf die gerade sichtbare Tabellenseite beschränkt. Weitere Informationen findest Du unter Konfigurierbare Tabellen (C-Units).

Um eine Selektion zu erstellen, gehe folgendermaßen vor:

1

Selektion öffnen

Um eine Selektion für den Bereich zu erstellen, klicke links im grünen Tabellenkopf auf das Zahnrad-Icon.

2

Bezeichnung eintragen

Gib im Feld „Bezeichnung“ eine Bezeichnung für die Selektion ein.

3

Selektion konfigurieren

Nutze die verschiedenen Reiter in der Selektion, um die Datensätze anhand verschiedener Parameter zu konfigurieren. Im Reiter »Filter« kannst Du über das »+«-Zeichen mehrere Filter anlegen, anhand derer Du die Datensätze selektieren kannst.

Genauere Informationen zur Konfiguration von Selektionen findest Du auf unserer Handbuchseite Selektionen konfigurieren.

4

Selektion speichern

Verwende die Buttons »Speichern« und »Speichern und anwenden« unten rechts, um die Selektion zu speichern. Mit dem Button Speichern kann die Selektion zwischengespeichert werden, während mit dem Button Speichern und anwenden das Fenster nach dem Speichern direkt geschlossen wird.

Nur markierte Datensätze verarbeiten

Vordefinierte und individuelle Stapel-Aktionen kannst Du auch auf einzelne markierte Zeilen begrenzen, wenn Deine Tabelle diese Auswahlaktionen anbietet.

  1. Markiere die gewünschten Datensätze über die Checkboxen.

  2. Öffne die Optionen zur Auswahl über die drei Punkte bei den markierten Datensätzen.

  3. Wähle »vordefinierte Stapel-Aktionen« oder »individuelle Stapel-Aktion« und fahre mit dem passenden Ablauf unten fort.

Dieser Aufruf übernimmt nur die markierten Datensätze innerhalb der aktuellen Selektion. Prüfe die aufgelisteten Datensätze vor der Verarbeitung. Das Stapel-Verarbeitungs-Symbol oberhalb der Tabelle verwendet weiterhin alle gefilterten Treffer.

Die Selektion muss die eindeutige Kennung der Datensätze als Spalte enthalten. In Kreuztabellen und bei Statement-Selektionen wird die Auswahlaktion nicht angeboten. Die individuelle Stapel-Aktion ist nur sichtbar, wenn sie für Dich freigeschaltet ist. Import- und Export-Verarbeitungen startest Du über das Symbol oberhalb der Tabelle; dieser Aufruf berücksichtigt die Markierung nicht.

Vordefinierte Stapel-Aktionen

Bei einer vordefinierten Stapel-Aktion verarbeitest Du die gefilterten Datensätze mit einem angebotenen Skript aus System → Skripte.

Um eine vordefinierte Stapel-Aktion durchzuführen, gehe folgendermaßen vor:

1

Vordefinierte Stapel-Aktion anlegen

Wähle über das Stapel-Verarbeitungs-Symbol rechts oberhalb der C-Unit die Option »vordefinierte Stapel-Aktion« aus, um eine Stapel-Verarbeitung für die selektierten Datensätze anzulegen.

2

Skript auswählen

Wähle eines der angebotenen Skripte aus. Die Auswahl enthält Skripte aus System → Skripte mit der Domäne Import/Stapelverarbeitung.

3

Selektierte Datensätze einsehen

Nach dem Anlegen der Verarbeitung sind die selektierten Datensätze anhand der Quellspalten zu sehen.

Klicke auf den Schritt »Skript«, um mit der Verarbeitung fortzufahren.

4

Skript überprüfen & ggf. anpassen

Im Schritt »Skript« kannst Du das ausgewählte Skript einsehen. Über den aufklappbaren Bereich Skript-Verarbeitung öffnest Du den Skript-Editor. Wenn die Bearbeitung für Dich freigeschaltet ist, kannst Du das Skript für diese Verarbeitung anpassen.

Sind für das Skript Parameter hinterlegt, fülle diese im unteren Bereich aus und klicke auf »Parameter speichern«. Prüfe nach eigenen Änderungen am Skript auch die Parameter; durch das Lösen der Verknüpfung zum Skript-Modul müssen benötigte Parameter gegebenenfalls neu angelegt werden.

Über das Disketten-Icon in der oberen Leiste des Skript-Editors kannst Du Änderungen am Skript speichern.

Klicke auf »Weiter« oder auf den Schritt »Validierung«, um mit der Skriptverarbeitung fortzufahren.

5

Verarbeitung validieren

Wechsle in den Schritt »Validierung« und klicke auf »Validierung starten«. Dabei wird das Skript für die gewählten Datensätze tatsächlich ausgeführt; die regulären Datenbankänderungen je Datensatz werden anschließend zurückgerollt. Es handelt sich daher nicht nur um eine Syntaxprüfung. Zusätzliche Skriptaktionen außerhalb dieser Transaktion werden dadurch nicht automatisch rückgängig gemacht. Kontrolliere die angezeigten Status und Fehlermeldungen.

6

Vordefinierte Stapel-Aktion abschließen

Nach erfolgreicher Validierung klicke unten rechts auf »Daten verarbeiten«, um die Anpassungen durchzuführen.

Nach der Verarbeitung kannst Du im Schritt »Abgeschlossen« die Ergebnisse einsehen. Prüfe die Status der einzelnen Datensätze und mögliche Fehlermeldungen; einzelne Datensätze können auch ignoriert oder fehlerhaft sein. Eine Verarbeitung im Status Abgeschlossen kannst Du einsehen, aber nicht weiter bearbeiten.

Beispiel: Aufträge gesammelt in Lieferscheine übernehmen

Du möchtest beispielsweise 50 geeignete Aufträge gesammelt in Lieferscheine übernehmen. Dafür verwendest Du die vordefinierte Stapel-Aktion „Beleg-uebernehmen“.

Die Aufträge müssen die normalen Voraussetzungen für die Übernahme in einen Lieferschein erfüllen. Ob die Übernahme möglich ist, hängt unter anderem vom Belegstatus, der Zielbelegart und den für den Auftrag geltenden Freigaben und Sperren ab. Ein erforderlicher Kommissionierungsablauf wird durch die Stapel-Verarbeitung nicht umgangen.

1

Aufträge eingrenzen und ID-Spalte prüfen

Öffne die Verkaufsbelegübersicht und grenze die Liste über eine Selektion mit Filtern auf die gewünschten Aufträge ein. Prüfe, dass nur die Aufträge enthalten sind, die Du übernehmen möchtest.

Die Selektion muss die Spalte „ID“ der Belege enthalten. Ergänze sie bei Bedarf in der Konfiguration der Selektion.

2

„Beleg-uebernehmen“ auswählen

Wähle »vordefinierte Stapel-Aktionen« über das Stapel-Verarbeitungs-Symbol für alle gefilterten Aufträge oder über die Optionen zur Auswahl für markierte Aufträge. Wähle anschließend das Skript „Beleg-uebernehmen“.

3

Datensätze kontrollieren

Prüfe in der angelegten Verarbeitung die aufgelisteten Aufträge und ihre IDs. In unserem Beispiel sollten hier die 50 gewünschten Aufträge enthalten sein.

Wechsle anschließend in den Schritt »Skript«.

4

Zielbelegart als Parameter eintragen

Trage im unteren Bereich beim Parameter belegart die gewünschte Zielbelegart ein:

Parameter
Typ
Wert im Beispiel

belegart

string

„Lieferschein“

Der Wert muss der exakten Bezeichnung einer vorhandenen Belegart entsprechen. Heißt Deine Zielbelegart anders, verwende deren Bezeichnung.

Klicke auf »Parameter speichern«.

5

Verarbeitung validieren

Wechsle in den Schritt »Validierung« und klicke auf »Validierung starten«. Dabei wird die Belegübernahme für die gewählten Datensätze testweise ausgeführt; die regulären Datenbankänderungen je Datensatz werden anschließend zurückgerollt. Prüfe das Ergebnis und behebe angezeigte Fehler, bevor Du die Verarbeitung ausführst.

6

Lieferscheine erstellen und Ergebnis prüfen

Klicke nach erfolgreicher Validierung auf »Daten verarbeiten«. VARIO führt für die Aufträge die normale Belegübernahme in die angegebene Zielbelegart aus.

Prüfe anschließend das Verarbeitungsergebnis, mögliche Fehlermeldungen und die entstandenen Lieferscheine. Wie bei der Einzelübernahme hängt das Ergebnis von den Voraussetzungen und Einstellungen der jeweiligen Aufträge ab.

Individuelle Stapel-Aktion

Bei einer individuellen Stapel-Aktion kannst Du die gefilterten Datensätze mithilfe eines eigenen JavaScript-Skripts verarbeiten. Die Option und die Bearbeitung des Skripts stehen Dir zur Verfügung, wenn sie für Dich freigeschaltet sind.

Eine ausführliche Anleitung zum Scripting einschließlich einer Scripting-Referenz findest Du in unseren Developer Docs.

Um eine individuelle Stapel-Aktion durchzuführen, gehe folgendermaßen vor:

1

Individuelle Stapel-Aktion anlegen

Wähle über das Stapel-Verarbeitungs-Symbol rechts oberhalb der C-Unit die Option »individuelle Stapel-Aktion« aus, um eine Stapel-Verarbeitung für die selektierten Datensätze anzulegen.

Individuelle Stapel-Verarbeitung anlegen
2

Selektierte Datensätze einsehen

Nach dem Anlegen der Verarbeitung sind die selektierten Datensätze anhand der Quellspalten zu sehen.

Klicke auf den Schritt »Skript«, um mit der Verarbeitung fortzufahren.

3

Skript bearbeiten

Im Schritt »Skript« kannst Du das Skript für die Verarbeitung verfassen, anhand dessen die Datensätze verarbeitet werden.

Im Feld „Skript-Modul“ kannst Du alternativ eines der angebotenen Skripte aus System → Skripte auswählen. Änderst Du dessen Inhalt im Editor, wird daraus ein eigenes Skript für diese Verarbeitung. Dabei wird die Verknüpfung zum Modul gelöst; prüfe danach benötigte Parameter und lege sie gegebenenfalls neu an.

Im unteren Bereich kannst Du über das »+«-Zeichen Parameter hinzufügen, die Dein Skript verwendet. Trage deren Werte ein und klicke auf »Parameter speichern«.

Speichere Deine Skriptänderungen über das Disketten-Icon im Editor. Klicke anschließend auf »Weiter« oder auf den Schritt »Validierung«.

4

Verarbeitung validieren

Klicke im Schritt »Validierung« auf »Validierung starten« und kontrolliere die Status und Fehlermeldungen. Wie bei der vordefinierten Stapel-Aktion wird das Skript tatsächlich ausgeführt; die regulären Datenbankänderungen je Datensatz werden zurückgerollt. Zusätzliche Aktionen außerhalb dieser Transaktion werden dadurch nicht automatisch rückgängig gemacht.

5

Individuelle Stapel-Aktion abschließen

Klicke nach der Kontrolle der Validierungsergebnisse unten rechts auf »Daten verarbeiten«, um das Skript auf die Datensätze anzuwenden.

Prüfe anschließend im Schritt »Abgeschlossen« die Ergebnisse je Datensatz und mögliche Fehlermeldungen. Einzelne Datensätze können auch ignoriert oder fehlerhaft sein. Eine Verarbeitung im Status Abgeschlossen kannst Du einsehen, aber nicht weiter bearbeiten.

Import-Verarbeitung

Mit der Import-Verarbeitung kannst Du die durch eine Selektion gefilterten Datensätze gesammelt ändern. Dazu ordnest Du vorhandene Quellspalten den Zielfeldern zu oder ergänzt Zielspalten mit festen Werten und weiteren Operationen.

In den folgenden Abschnitten stellen wir Dir Schritt für Schritt dar, wie Du eine Import-Verarbeitung durchführen kannst.

1. Import-Verarbeitung anlegen

Um die Import-Verarbeitung, z. B. im Menüpunkt Artikel, durchzuführen, gehe wie folgt vor:

1

Import-Verarbeitung anlegen

Klicke im gewünschten Bereich auf das Stapel-Verarbeitungs-Symbol rechts über dem Tabellenkopf und wähle die Option »Import-Verarbeitung« aus.

2

Bereich auswählen

Wähle den entsprechenden Bereich aus – in unserem Beispiel den Bereich Artikel.

3

Import-Verarbeitung anlegen

Nach dem erfolgreichen Anlegen wird Dir die Import-Verarbeitung mit den entsprechenden Schritten angezeigt.

Wie Du die Schritte der Import-Verarbeitung einzeln durchführen kannst, zeigen wir Dir im folgenden Abschnitt.

2. Import-Verarbeitung durchführen

Die Import-Verarbeitung umfasst die Schritte »Quellspalten«, »Zielspalten«, »Validierung« und »Abgeschlossen«. Die Zuordnung funktioniert wie beim manuellen Datenimport unter System → Import.

Schritt »Zielspalten« statt »Quellspalten«

Die Verarbeitung öffnet sich bei vorhandener Zuordnung im Schritt »Zielspalten«. Enthält die Selektion die zum gewählten Importbereich passende ID-Spalte, ordnet VARIO diese automatisch zu. Prüfe die Zuordnung: Über sie werden die bestehenden Datensätze für die Änderung identifiziert. Bei Bedarf kannst Du unter »Quellspalten« weitere Spalten zuordnen.

1

Quellspalten zuordnen

Im Schritt »Quellspalten« ordnest Du die Spalten der gefilterten Selektion den Feldern des gewählten Importbereichs zu.

Die automatische Zuordnung gilt für die zum Importbereich passende ID-Spalte, beispielsweise die Artikel-ID beim Artikelimport. Fehlt sie in der Selektion, ergänze die passende ID-Spalte vor dem Anlegen der Verarbeitung.

Weitere Spalten kannst Du durch einen Klick auf die Spaltenköpfe zuordnen. Genauere Informationen zur Spaltenzuordnung findest Du hier.

Die Zuordnungen und konfigurierten Operationen bestimmen die Werte, die im Schritt »Zielspalten« als Vorschau angezeigt werden. Durch die Zuordnung allein werden die Datensätze noch nicht geändert.

Klicke auf »Weiter« oder auf den Schritt »Zielspalten«, um mit der Verarbeitung fortzufahren.

2

Zielspalten konfigurieren

Im Schritt »Zielspalten« siehst Du die zugeordneten Zielfelder und die daraus ermittelten Werte. Prüfe insbesondere die ID-Zuordnung, damit die Änderungen die gewünschten bestehenden Datensätze betreffen.

Über das Feld „Nach Spalten suchen“ kannst Du weitere Spalten hinzufügen, über die die gewünschten Änderungen konfiguriert werden können.

Nach dem Auswählen einer Zielspalte öffnet sich ein Dialog für ihre Konfiguration. Mit der Operation Fester Wert verwendest Du denselben Wert für alle Datensätze der Verarbeitung; andere Operationen können Werte aus den Quellspalten übernehmen oder berechnen.

Weitere Informationen zur Spaltenkonfiguration und den einzelnen Operationen findest Du hier.

Beispiel: neuen Tag hinzufügen

In diesem Beispiel ergänzt Du bei allen Datensätzen der Verarbeitung einen bereits vorhandenen Tag. Bestehende Tags bleiben erhalten.

Voraussetzung

Lege den gewünschten Tag unter Einstellungen → Allgemein → Tags an. Er muss zum Datensatztyp passen oder ein allgemeiner Tag sein.

  1. Füge die Spalte „Bezeichnung“ aus dem Objekt Tags hinzu.

  1. Wähle im Feld „Typ“ die Operation Fester Wert aus und gib im Feld „Wert“ die Bezeichnung des gewünschten Tags ein. Speichere anschließend die Konfiguration.

  1. Die Tagbezeichnung erscheint in der Vorschau als Wert der neuen Zielspalte bei allen Datensätzen. Zugeordnet wird der Tag erst beim Ausführen der Import-Verarbeitung.

Für jede weitere Änderung kannst Du eine zusätzliche Zielspalte hinzufügen und in der Zielspalten-Konfiguration anpassen.

Nachdem alle Anpassungen hinzugefügt wurden, klicke auf »Weiter« oder auf den Schritt »Validierung«, um auf diesen zu wechseln.

3

Änderungen validieren

Mit der Validierung prüfst Du die konfigurierten Änderungen in einem Testlauf. Die geprüften Änderungen werden dabei noch nicht dauerhaft gespeichert.

Klicke auf »Validierung starten«. Im Dialog kannst Du alle Datensätze oder einen Bereich „Von“/„Bis“ prüfen lassen. Ein eingeschränkter Prüfbereich begrenzt nur die Validierung; beim anschließenden Import wird der konfigurierte Datenbereich der Verarbeitung ausgeführt.

Nach der Validierung siehst Du den Prüfstatus der Datensätze. Prüfe insbesondere fehlerhafte, ignorierte und noch nicht geprüfte Einträge. Bei Fehlern kannst Du die Meldungen am Datensatz einsehen und die Konfiguration vor der Ausführung korrigieren.

Weitere Informationen zur Validierung findest Du hier.

4

Import-Verarbeitung abschließen

Prüfe vor dem Start die Zielwerte und das Validierungsergebnis. Klicke anschließend unten rechts auf »Daten importieren« und bestätige die Ausführung, um die Änderungen dauerhaft durchzuführen.

Prüfe im Schritt »Abgeschlossen« das Ergebnis für jeden Datensatz. Die Übersicht unterscheidet erfolgreiche, fehlerhafte, ignorierte und noch nicht verarbeitete Einträge; der aufgerufene Ergebnisschritt allein bestätigt noch keinen vollständig erfolgreichen Lauf.

Beispiel: Neuen Tag hinzufügen

Bei erfolgreich verarbeiteten Datensätzen kannst Du anschließend prüfen, dass der gewünschte Tag ergänzt wurde:

Export-Verarbeitung

Mit der Export-Verarbeitung kannst Du die gefilterten Datensätze als CSV-, JSON- oder XML-Datei exportieren. Über die Parameter legst Du das Format der Datei fest. Die einzelnen Einstellungen erklären wir im Abschnitt „Parameter einstellen“.

Für eine XLSX-Datei mit den Datensätzen der C-Unit verwendest Du den Tabellenexport über das Export-Icon rechts neben dem Stapel-Verarbeitungs-Icon. Weitere Informationen findest Du im Abschnitt Exportieren.

1. Export-Verarbeitung anlegen

Um eine Export-Verarbeitung anzulegen, gehe folgendermaßen vor:

1

Export-Verarbeitung anlegen

Wähle über das Stapel-Verarbeitungs-Symbol rechts oberhalb der C-Unit die Option »Export-Verarbeitung« aus, um einen Export mit den selektierten Datensätzen zu starten.

2

Datei-Format auswählen

Wähle im Pop-Up-Fenster das Dateiformat der zu exportierenden Datei aus. In unserem Beispiel wählen wir das Format XML aus.

3

Export-Einstellungen anlegen

Im neuen Fenster legst Du den Dateinamen und die Export-Parameter fest. Genauere Informationen zu den einzelnen Parametern findest Du im nächsten Abschnitt.

Nachdem Du alle Parameter eingestellt hast, klicke auf »Anlegen«. Im Abschnitt „Spalten zuordnen“ erfährst Du, wie Du die Inhalte der Zieldatei festlegst.

Die Export-Einstellungen kannst Du auch nachträglich innerhalb der Spaltenzuordnung anpassen 😉.

2. Parameter einstellen

Beim Anlegen einer Export-Verarbeitung stehen Dir verschiedene Parameter zur Verfügung, mit denen Du festlegen kannst, wie die Zieldatei formatiert werden soll.

Hier findest Du einen Überblick über die einzelnen Parameter und ihre Verwendung:

Dateiname

Gib hier die Bezeichnung der zu exportierenden Datei ohne Dateiendung ein.

Zeichensatz

Wähle die Zeichenkodierung für die Exportdatei. Zur Auswahl stehen ASCII, LATIN 1, UTF-8 und UTF-8 BOM. Richte Dich dabei nach den Anforderungen des Programms, das die Datei einlesen soll.

Parameter für das Dateiformat „CSV“

»Kopfzeile schreiben«

Lege fest, ob die CSV-Datei eine Kopfzeile mit den konfigurierten Spaltennamen enthalten soll.

Zeilenumbruch

Wähle das Format für die Zeilenumbrüche in der Exportdatei. Es stehen Dir die Optionen CR (\r), CR_LF (\r\n) und LF (\n) zur Auswahl.

Anführungszeichen & Trennzeichen

Trage jeweils ein Zeichen ein, das in der Zieldatei als Anführungszeichen beziehungsweise Trennzeichen verwendet werden soll.

Das Trennzeichen trennt die einzelnen Felder einer Zeile. Das Anführungszeichen schließt Feldinhalte bei Bedarf ein, etwa wenn sie selbst das Trennzeichen oder einen Zeilenumbruch enthalten.

CSV-Spalten hinzufügen

Gib die Bezeichnungen der Zielspalten ein. Bestätige jede neue Spaltenbezeichnung mit Enter, bevor Du die nächste eingibst.

Die eingetragenen Spalten können im nächsten Schritt den Spalten der C-Unit zugeordnet werden.

Parameter für das Dateiformat „JSON“

»Leserlich formatieren«

Ist diese Option aktiviert, wird die JSON-Datei übersichtlich formatiert dargestellt.

Zeilenumbruch

Wähle das Format der Zeilenumbrüche für die leserliche Formatierung: CR (\r), CR_LF (\r\n) oder LF (\n). Die Einstellung wirkt, wenn »Leserlich formatieren« aktiviert ist.

JSON-Zielknoten - Name

Gib den Namen der einzelnen Zielknoten für die JSON-Datei ein. Die Zielknoten können im nächsten Schritt den Spalten der C-Unit zugeordnet werden.

Über das »+«-Zeichen kannst Du weitere Zielknoten hinzufügen.

JSON-Zielknoten - Typ

Wähle den Typ des Inhalts für den jeweiligen Zielknoten aus. Z. B. kannst Du für das Erstellungsdatum den Typ Datum auswählen, während sich für den Verkaufspreis der Typ Zahl eignet.

Datensätze müssen dem ausgewählten Typ entsprechen

Mit dem Typ Objekt kannst Du Unterknoten innerhalb eines Knotens anlegen. So lassen sich beispielsweise Kunden- oder Lieferanteninformationen einer Adresse zusammenfassen.

Die einzelnen Angaben des Kunden oder Lieferanten konfigurierst Du dabei als Unterknoten und ordnest ihnen die gewünschten Quellspalten zu.

JSON-Zielknoten - Liste

Aktiviere den Toggle »Liste«, wenn ein Zielknoten mehrere zugeordnete Werte enthalten soll, zum Beispiel mehrere Tags. Ohne diese Option wird nur der erste Wert ausgegeben. Welche Werte exportiert werden, legst Du über die Spaltenzuordnung und Zielspalten-Konfiguration fest.

In Verbindung mit dem Typ Objekt entsteht eine Liste von Objekten. Jedes Objekt kann mehrere Angaben in seinen Unterknoten enthalten.

Parameter für das Dateiformat „XML“

»XML-Deklaration«

Lege fest, ob die XML-Datei eine XML-Deklaration enthalten soll. Diese ist optional, wird aber empfohlen, da sie Angaben wie XML-Version und Zeichenkodierung enthält.

Beispiel: <?xml version="1.0" encoding="UTF-8"?>

»Leserlich formatieren«

Ist diese Option aktiviert, wird die XML-Datei übersichtlich formatiert dargestellt.

Quell-Knoten

Gib im Feld „Quell-Knoten“ den Namen des gemeinsamen Wurzelknotens der Exportdatei ein, zum Beispiel ArtikelListe. Er umschließt die einzelnen exportierten Datensätze.

Knoten - Name

Lege den Knoten für einen einzelnen Datensatz fest, zum Beispiel Artikel. Dieser wird für jeden exportierten Datensatz innerhalb des gemeinsamen Wurzelknotens ausgegeben. Ergänze darunter die gewünschten Unterknoten, zum Beispiel Bezeichnung und Artikelnummer, und ordne ihnen anschließend die Quellspalten zu.

Ein Knoten ohne Unterknoten kann direkt einen Wert enthalten. Ordne die gewünschte Quellspalte dazu dem Inhalt dieses Knotens zu.

Über den Button »+Knoten« kannst Du Unterknoten hinzufügen, die ebenfalls weitere Unterknoten enthalten können.

Knoten - Neues Attribut

Trage die Attributnamen für den jeweiligen Knoten ein. Übernimm jeden Namen mit Enter oder dem »+«-Zeichen. Die Werte der Attribute ordnest Du anschließend über die Quellspalten zu.

3. Spalten zuordnen

Nach dem Anlegen der Export-Verarbeitung ordnest Du die Quellspalten der selektierten Datensätze den konfigurierten Zielspalten zu. Das folgende Beispiel zeigt einen JSON-Export:

1

Quellspalten zuordnen

Nach dem Anlegen der Export-Verarbeitung werden Dir die selektierten Datensätze im Schritt »Quellspalten« aufgelistet.

Klicke auf einen der Spaltenköpfe, um die jeweilige Spalte zuzuordnen. Die Spaltenköpfe sind dabei mit den originalen Feldbezeichnungen versehen.

Anschließend werden Dir die in den Export-Einstellungen konfigurierten Zielspalten angezeigt. Wähle für alle benötigten Spalten die entsprechende Zielspalte aus. Dabei müssen nicht alle selektierten Spalten zugeordnet werden.

Alternativ kannst Du nicht zugeordnete Zielspalten im nächsten Schritt mit manuellen Werten hinzufügen.

Über den Button »Export-Einstellungen« kannst Du die Spalten für die Exportdatei nachträglich anpassen.

Bei Zielknoten mit dem Typ Objekt stehen die darin enthaltenen Unterknoten für die Zuordnung zur Auswahl.

Nachdem die gewünschten Spalten zugeordnet wurden, kannst Du unten rechts auf »Weiter« klicken, um zum nächsten Schritt fortzufahren.

2

Zielspalten nach Bedarf konfigurieren

Im Schritt »Zielspalten« kannst Du die Inhalte der einzelnen Spalten individuell konfigurieren.

Klicke auf einen der Spaltenköpfe, um die Zielspalten-Konfiguration zu öffnen. Dort stehen Dir verschiedene Operationen zur Verfügung.

Genauere Informationen zu diesen findest Du im Abschnitt Zielspalten Konfiguration auf unserer Handbuchseite zum manuellen Datenimport.

Zielspalten, die noch keiner Quellspalte zugeordnet sind, kannst Du über das Feld „Nach Spalten suchen“ hinzufügen und zum Beispiel mit festen Werten füllen. Bereits zugeordnete Spalten werden als angehakt angezeigt.

So kannst Du für die Exportdatei zusätzliche oder abweichende Werte festlegen. Diese Export-Konfiguration ändert die gespeicherten Datensätze in VARIO Cloud nicht.

In der Zielspalten-Konfiguration legst Du den Wert der neuen Spalte fest. Mit der Operation Fester Wert gibst Du beispielsweise einen Wert vor, der für alle Datensätze in dieser Exportspalte ausgegeben wird.

3

Export abschließen

Klicke unten auf »Weiter« und bestätige den Start des Exports. Prüfe anschließend das Verarbeitungsergebnis.

Nach dem Export erreichst Du den Schritt »Abgeschlossen«. Dort siehst Du das Ergebnis je Datensatz. Prüfe auch die Anzeigen für fehlerhafte, ignorierte oder noch nicht verarbeitete Datensätze.

Die erzeugte Datei findest Du unter CRM/DMS. Lade sie dort über das Download-Icon ganz rechts in der Tabelle herunter.

Abschluss und Fehlermeldungen

Die Abschlussmeldung bezieht sich auf den gesamten Lauf. Bei mehreren Teil-Tasks erscheint sie erst, wenn alle beendet sind und der Gesamtstatus feststeht. Bei einem Fehler oder Abbruch einer Skriptverarbeitung lautet die Meldung „Verarbeitung fehlgeschlagen“, bei einer Export-Verarbeitung „Export fehlgeschlagen“. Prüfe anschließend die Ergebnisse und Fehlermeldungen der einzelnen Datensätze.

Erscheint „Status des Laufs konnte nicht ermittelt werden. Bitte die Seite neu laden.“, lade die Seite neu, um den aktuellen Stand zu prüfen.

Häufige Fragen

Wie bearbeite ich viele Datensätze auf einmal, z. B. nach einem Import?

Lege eine Selektion an, die genau die betroffenen Datensätze filtert, beispielsweise anhand eines Nummernbereichs. Starte darauf eine Import-Verarbeitung und konfiguriere die gewünschte Zielspalte mit der Operation Fester Wert, wenn alle Datensätze denselben Wert erhalten sollen. Eine vordefinierte Stapel-Aktion verwendest Du, wenn ein angebotenes Skript die gewünschte Änderung unterstützt; sie arbeitet nach der Logik dieses Skripts. Prüfe vor dem Start die Datensätze und die Validierungsergebnisse und kontrolliere anschließend das Verarbeitungsergebnis.

Zuletzt aktualisiert

War das hilfreich?