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.
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:
Selektion öffnen
Um eine Selektion für den Bereich zu erstellen, klicke links im grünen Tabellenkopf auf das Zahnrad-Icon.

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

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.

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.
Markiere die gewünschten Datensätze über die Checkboxen.
Öffne die Optionen zur Auswahl über die drei Punkte bei den markierten Datensätzen.
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.
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:
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.

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

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.

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

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.
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.
„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“.
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«.
Zielbelegart als Parameter eintragen
Trage im unteren Bereich beim Parameter belegart die gewünschte Zielbelegart ein:
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«.
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.
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.
Um eine individuelle Stapel-Aktion durchzuführen, gehe folgendermaßen vor:
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.

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.

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

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

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

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.
Quellspalten zuordnen
Im Schritt »Quellspalten« ordnest Du die Spalten der gefilterten Selektion den Feldern des gewählten Importbereichs zu.
Weitere Spalten kannst Du durch einen Klick auf die Spaltenköpfe zuordnen. Genauere Informationen zur Spaltenzuordnung findest Du hier.

Klicke auf »Weiter« oder auf den Schritt »Zielspalten«, um mit der Verarbeitung fortzufahren.
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.
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.
Ä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.
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.

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

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.

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.
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:
Parameter für das Dateiformat „CSV“
Parameter für das Dateiformat „JSON“
Parameter für das Dateiformat „XML“
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:
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.

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.

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?











