> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/stapel-verarbeitung.md).
# 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**](/vario-cloud-handbuch/system/skripte.md).
* **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"**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md)**.**
{% hint style="danger" %}
## Datensätze vor der Verarbeitung selektieren!
Prüfe **vor dem Start** die Selektion und ihre Filter. Der Aufruf über das **Symbol oberhalb der Tabelle** übernimmt die gefilterten Datensätze; **Checkbox-Markierungen begrenzen diesen Aufruf nicht**. Ohne passende Filter können deshalb auch Datensätze enthalten sein, die Du nicht verarbeiten möchtest.
Weitere Informationen dazu findest Du im nächsten Abschnitt.
{% endhint %}
## 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)**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units.md).
Um eine Selektion zu erstellen, gehe folgendermaßen vor:
{% stepper %}
{% step %}
**Selektion öffnen**
Um eine Selektion für den Bereich zu erstellen, klicke **links** im **grünen Tabellenkopf** auf das **Zahnrad-Icon.**
{% endstep %}
{% step %}
**Bezeichnung eintragen**
Gib im **Feld "Bezeichnung"** eine Bezeichnung für die Selektion ein.
{% endstep %}
{% step %}
**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 **Pluszeichen** mehrere **Filter** anlegen, anhand derer Du die Datensätze selektieren kannst.
Genauere Informationen zur Konfiguration von Selektionen findest Du auf unserer [**Handbuchseite "Selektionen konfigurieren".**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md)
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
### 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.
{% hint style="info" %}
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.
{% endhint %}
## Vordefinierte Stapel-Aktionen
Bei einer vordefinierten Stapel-Aktion verarbeitest Du die gefilterten Datensätze mit einem angebotenen Skript aus [**System/Skripte**](/vario-cloud-handbuch/system/skripte.md).
Um eine vordefinierte Stapel-Aktion durchzuführen, gehe folgendermaßen vor:
{% stepper %}
{% step %}
**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.
{% endstep %}
{% step %}
**Skript auswählen**
Wähle eines der angebotenen Skripte aus. Die Auswahl enthält Skripte aus **System/Skripte** mit der **Domäne »Import/Stapelverarbeitung«**.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% hint style="warning" %}
Gespeicherte Änderungen innerhalb der Skript-Verarbeitung wirken sich **nur** auf die **geöffnete Verarbeitung** aus, nicht auf das unter System/Skripte **hinterlegte Skript**.
{% endhint %}
Klicke auf **"Weiter"** oder auf den **Schritt "Validierung",** um mit der Skriptverarbeitung fortzufahren.
{% endstep %}
{% step %}
**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**.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
### 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.
{% stepper %}
{% step %}
**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](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/selektionen-konfigurieren.md).
{% hint style="warning" %}
Der Aufruf über das Stapel-Verarbeitungs-Symbol verarbeitet die gefilterte Selektion; Checkboxen begrenzen diesen Aufruf nicht. Für einzelne markierte Aufträge verwendest Du stattdessen die Optionen zur Auswahl, wie unter [Nur markierte Datensätze verarbeiten](/vario-cloud-handbuch/system/import-export/stapel-verarbeitung.md#nur-markierte-datensatze-verarbeiten) beschrieben.
{% endhint %}
{% endstep %}
{% step %}
**„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“.
{% endstep %}
{% step %}
**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“**.
{% endstep %}
{% step %}
**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“**.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
## 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.
{% hint style="info" %}
Eine ausführliche [**Anleitung zum Scripting**](https://developer.vario-software.de/documentation/scripting/introduction) einschließlich einer [**Scripting-Referenz**](https://developer.vario-software.de/scripting-reference/) findest Du in unseren [**Developer Docs**](https://developer.vario-software.de/).
{% endhint %}
Um eine individuelle Stapel-Aktion durchzuführen, gehe folgendermaßen vor:
{% stepper %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**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**](/vario-cloud-handbuch/system/skripte.md) 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 **Pluszeichen** 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«**.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
## 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:
{% stepper %}
{% step %}
**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.
{% endstep %}
{% step %}
**Bereich auswählen**
Wähle den entsprechenden Bereich aus – in unserem Beispiel den **Bereich "Artikel"**.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
### 2. Import-Verarbeitung durchführen
Die Import-Verarbeitung umfasst die Schritte **„Quellspalten“**, **„Zielspalten“**, **„Validierung“** und **„Abgeschlossen“**. Die Zuordnung funktioniert wie beim [manuellen Datenimport](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md) unter **System/Import**.
{% hint style="info" %}
## **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.
{% endhint %}
{% stepper %}
{% step %}
#### Quellspalten zuordnen
Im **Schritt „Quellspalten“** ordnest Du die Spalten der gefilterten Selektion den Feldern des gewählten Importbereichs zu.
{% hint style="info" %}
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.
{% endhint %}
Weitere Spalten kannst Du durch einen **Klick auf die Spaltenköpfe** zuordnen. Genauere Informationen zur Spaltenzuordnung findest Du [**hier**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md#spaltenzuordnung).
{% hint style="info" %}
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.
{% endhint %}
Klicke auf **"Weiter"** oder auf den **Schritt "Zielspalten",** um mit der Verarbeitung fortzufahren.
{% endstep %}
{% step %}
#### 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**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md#zielspalten-konfiguration).
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.
{% hint style="info" %}
## Voraussetzung
Lege den gewünschten Tag unter **Einstellungen/Allgemein/Tags** an. Er muss zum Datensatztyp passen oder ein allgemeiner Tag sein.
{% endhint %}
1. Füge die **Spalte "Bezeichnung"** aus dem **Objekt "Tags"** hinzu.
2. 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.
3. 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.
{% endstep %}
{% step %}
#### Ä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**](https://help.vario-software.de/vario-cloud-handbuch/system/import-export/pages/IX1kHpYyZS5zUIjdqC5h#id-4.-validierung).
{% endstep %}
{% step %}
#### 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:
{% endstep %}
{% endstepper %}
## 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](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units/bedienung-und-tagliche-nutzung.md#exportieren).
### 1. Export-Verarbeitung anlegen
Um eine Export-Verarbeitung anzulegen, gehe folgendermaßen vor:
{% stepper %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% step %}
**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.
{% hint style="info" %}
Die **Export-Einstellungen** kannst Du auch **nachträglich** innerhalb der **Spaltenzuordnung** anpassen 😉.
{% endhint %}
{% endstep %}
{% endstepper %}
### 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.
{% hint style="warning" %}
Wird ein Eintrag nicht mit **Enter** bestätigt, wird er **nicht gespeichert**!
{% endhint %}
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 **Pluszeichen** 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.
{% hint style="warning" %}
## Datensätze müssen dem ausgewählten Typ entsprechen
Die zugeordneten Werte müssen zum **gewählten Typ** passen. Wähle für Zahlenwerte den Typ **"Zahl"**. Für Artikelnummern und andere Kennungen eignet sich **"Text"**, insbesondere wenn Buchstaben oder führende Nullen erhalten bleiben sollen.
{% endhint %}
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: \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 **Pluszeichen**. Die Werte der Attribute ordnest Du anschließend über die Quellspalten zu.
{% hint style="warning" %}
Übernimm jeden neuen Attributnamen mit **Enter** oder dem **Pluszeichen**, bevor Du die Export-Einstellungen speicherst.
{% endhint %}
### 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:
{% stepper %}
{% step %}
**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**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md#originale-feldbezeichnungen-fur-die-spaltenzuordnung-verwenden) 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.
{% endstep %}
{% step %}
**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"**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md#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.
{% endstep %}
{% step %}
**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.
{% endstep %}
{% endstepper %}
## 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.vario-software.de/vario-cloud-handbuch/system/import-export/stapel-verarbeitung.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
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**](/vario-cloud-handbuch/system/skripte.md).
* **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"**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md)**.**
{% hint style="danger" %}
## Datensätze vor der Verarbeitung selektieren!
Prüfe **vor dem Start** die Selektion und ihre Filter. Der Aufruf über das **Symbol oberhalb der Tabelle** übernimmt die gefilterten Datensätze; **Checkbox-Markierungen begrenzen diesen Aufruf nicht**. Ohne passende Filter können deshalb auch Datensätze enthalten sein, die Du nicht verarbeiten möchtest.
Weitere Informationen dazu findest Du im nächsten Abschnitt.
{% endhint %}
## 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)**](/vario-cloud-handbuch/grundlagen-and-konzepte/konfigurierbare-tabellen-c-units.md).
Um eine Selektion zu erstellen, gehe folgendermaßen vor:
{% stepper %}
{% step %}
**Selektion öffnen**
Um eine Selektion für den Bereich zu erstellen, klicke **links** im **grünen Tabellenkopf** auf das **Zahnrad-Icon.**
in der **oberen Leiste** des **Skript-Editors** kannst Du Änderungen am Skript speichern.
