# Stapel-Verarbeitung

In **jedem Bereich** in VARIO kannst Du über das **Stapel-Verarbeitungs-Symbol** <img src="/files/FGfBJNniGj2Sd0KzrCTd" alt="" data-size="line"> oberhalb der C-Unit eine **Stapel-Verarbeitung** für den Bereich starten. Die Stapel-Verarbeitung kann nicht nur für Datensätze wie **Artikel**, **Adressen** oder **Belege** durchgeführt werden, sondern auch für Datensätze, die unter den **Einstellungen** oder **System** hinterlegt sind, wie z. B. **Belegarten**, **Aufgabentypen** und **Workflows**.

Dabei stehen Dir die **vier Optionen** zur Verfügung:

* **Vordefinierte Stapel-Aktionen:** Du kannst für die in der C-Unit selektierten Datensätze eine Stapel-Verarbeitung anhand eines der **Vorgabe-Skripte** durchführen, die im [**Menüpunkt System/Skripte** ](/vario-cloud-handbuch/system/skripte.md)verwaltet werden.
* **Individuelle Stapel-Aktion:** Du kannst für die in der C-Unit selektierten Datensätze eine Stapel-Verarbeitung mithilfe eines Skripts, das auf JavaScript basiert, durchführen.
* **Import-Verarbeitung**: Du kannst für die in der C-Unit selektierten Datensätze eine Stapel-Verarbeitung anhand von selbst definierter Quell- und Zielspalten durchführen.
* **Export-Verarbeitung:** Du kannst die in der C-Unit selektierten Datensätze anhand der eingestellten Parameter als **CSV-**, **JSON-** oder **XML-Datei** exportieren.

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!

Die Datensätze, die geändert werden sollen, müssen **vor** einer Stapel-Verarbeitung **selektiert** werden. Werden sie **nicht selektiert**, wirken sich die **Änderungen** der Stapel-Verarbeitung auf **alle im Bereich hinterlegten Datensätze** aus!

Weitere Informationen dazu findest Du im nächsten Abschnitt.
{% endhint %}

## Vorbereitung: Datensätze selektieren

Da die Stapel-Verarbeitung anhand der in der C-Unit **aufgelisteten Datensätzen** durchgeführt wird, müssen diese **zuerst** durch eine **Selektion** gefiltert werden. Genauere Informationen zu C-Units und Selektionen findest Du auf der [**Handbuchseite "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.**

<figure><img src="/files/5NDaMQDIxukDrWrzNRvb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Bezeichnung eintragen**

Gib im **Feld "Bezeichnung"** eine Bezeichnung für die Selektion ein.

<figure><img src="/files/gKIHBtpsDhFBn63meNZx" alt=""><figcaption></figcaption></figure>
{% 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.&#x20;

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)

<figure><img src="/files/V5jXcSxHE1zjHXnUq932" alt="" width="563"><figcaption></figcaption></figure>
{% 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.

<figure><img src="/files/d9NpCtsERjJRpmJEL8yZ" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Vordefinierte Stapel-Aktionen

Bei einer vordefinierten Stapel-Aktion kannst Du für die in der C-Unit selektierten Datensätze eine Stapel-Verarbeitung anhand eines der **Skripte** durchführen, die im [**Menüpunkt System/Skripte** ](/vario-cloud-handbuch/system/skripte.md)hinterlegt sind.

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

{% stepper %}
{% step %}
**Vordefinierte Stapel-Aktion anlegen**&#x20;

Wähle über das **Stapel-Verarbeitungs-Symbol** ![](https://sites.gitbook.com/preview/site_kv9UA/~gitbook/image?url=https%3A%2F%2F534317722-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fa7nDlxyw1xkeHi7FnWgm%252Fuploads%252FadoDnNcHfVzTMo4HJ1yU%252Fimage.png%3Falt%3Dmedia%26token%3D8aa67b95-1440-46f4-95d2-767d56b8dd87\&width=42\&dpr=3\&quality=100\&sign=a690a956\&sv=2) rechts oberhalb der C-Unit die **Option "vordefinierte Stapel-Aktion"** aus, um eine Stapel-Verarbeitung für die selektierten Datensätze anzulegen.

<figure><img src="/files/I0atmtq1hLF5pbqcvxr9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Skript auswählen**

Wähle eines der aufgelisteten Skripte aus. Hier werden alle Skripte aus dem **Menüpunkt System/Skripte** aufgelistet, die der **Domäne "Import/Stapelverarbeitung"** zugeordnet sind.

<figure><img src="/files/lfCPC6gCDFz6T4grbC31" alt=""><figcaption></figcaption></figure>
{% 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.

<figure><img src="/files/U31UQPET2rlAAJZKsY24" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Skript überprüfen & ggf. anpassen**&#x20;

Im **Schritt "Skript"** kannst Du das ausgewählte Skript einsehen. Über das **Drop-Down-Feld "Skript-Verarbeitung"** kannst Du das Skript **aufklappen** und **bearbeiten**.&#x20;

Sind für das Skript **Parameter** hinterlegt, kannst Du diese im **unteren Bereich** ausfüllen und speichern.&#x20;

<figure><img src="/files/lm1BwWHiQyhCuUNpoY3X" alt=""><figcaption></figcaption></figure>

Über das **Disketten-Icon** <img src="/files/iP87UHHh7GrU1T00xIgY" alt="" data-size="line"> in der **oberen Leiste** des **Skript-Editors** kannst Du Änderungen am Skript speichern. &#x20;

<figure><img src="/files/hiv90iwxBFi3bhbU9bAc" alt=""><figcaption></figcaption></figure>

{% 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 den **Button "Validierung starten",** um zu überprüfen, ob die Datensätze problemlos verarbeitet werden können.

<figure><img src="/files/LHIOvpm7atJl32IdGu8E" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Vordefinierte Stapel-Aktion abschließen**

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

<figure><img src="/files/n4MDzxuasIE7GkaAPIqi" alt=""><figcaption></figcaption></figure>

Nachdem alle Datensätze bearbeitet wurden, erreicht die Verarbeitung den **Schritt "Abgeschlossen"**. Nach Abschluss der Verarbeitung können die durchgeführten Schritte eingesehen, aber nicht weiter bearbeitet werden.
{% endstep %}
{% endstepper %}

## Individuelle Stapel-Aktion

Bei einer individuellen Stapel-Aktion kannst Du für die in der C-Unit selektierten Datensätzen eine Stapel-Verarbeitung **anhand eines Skripts** durchführen.&#x20;

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

{% stepper %}
{% step %}
**Individuelle Stapel-Aktion anlegen**&#x20;

Wähle über das **Stapel-Verarbeitungs-Symbol** ![](https://sites.gitbook.com/preview/site_kv9UA/~gitbook/image?url=https%3A%2F%2F534317722-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fa7nDlxyw1xkeHi7FnWgm%252Fuploads%252FadoDnNcHfVzTMo4HJ1yU%252Fimage.png%3Falt%3Dmedia%26token%3D8aa67b95-1440-46f4-95d2-767d56b8dd87\&width=42\&dpr=3\&quality=100\&sign=a690a956\&sv=2) rechts oberhalb der C-Unit die **Option "individuelle Stapel-Aktion"** aus, um eine Stapel-Verarbeitung für die selektierten Datensätze anzulegen.

<figure><img src="/files/F5QkiV5wttFMTWXLgd5i" alt="Individuelle Stape-Verarbeitung anlegen"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Selektierte Datensätze einsehen**

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

Klicke auf den **Schritt "Skript",** um mit der Verarbeitung fortzufahren.&#x20;

<figure><img src="/files/oxCQEMDcwOXfFtQNyutL" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Skript bearbeiten**

Im **Schritt "Skript"** kannst Du das Skript für die Verarbeitung verfassen, anhand dessen die Datensätze verarbeitet werden.&#x20;

Im **Feld "Skript-Modul"** kannst Du alternativ eines der im [**Menüpunkt "Skripte"** ](/vario-cloud-handbuch/system/skripte.md)hinterlegten Skripte auswählen. Diese kannst Du für die geöffnete Verarbeitung individuell anpassen.&#x20;

<figure><img src="/files/EActXBEGvJXEoe5slNZi" alt=""><figcaption></figcaption></figure>

Im **unteren Bereich** kannst Du über das **Pluszeichen** rechts Parameter hinzufügen, die im Skript mitverwendet werden können.&#x20;

<figure><img src="/files/raefiI75TC0Iwkf1NfVi" alt=""><figcaption></figcaption></figure>

Nachdem Du das Skript fertig erstellt hast, klicke auf **"Weiter"** oder auf den **Schritt "Validierung",** um mit der Skriptverarbeitung fortzufahren. &#x20;
{% endstep %}

{% step %}
**Verarbeitung validieren**

Im **Schritt "Validierung"** klicke auf den **Button "Validierung starten",** um zu überprüfen, ob die Datensätze problemlos verarbeitet werden können.&#x20;

<figure><img src="/files/LHIOvpm7atJl32IdGu8E" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Individuelle Stapel-Aktion abschließen**

Klicke unten rechts auf **"Daten verarbeiten"**, um die Anpassungen durchzuführen.

<figure><img src="/files/e3djQyIYxbAJcb6OLqNl" alt=""><figcaption></figcaption></figure>

Nachdem alle Datensätze bearbeitet wurden, erreicht die Verarbeitung den **Schritt "Abgeschlossen"**. Nach Abschluss der Verarbeitung können die durchgeführten Schritte eingesehen, aber nicht weiter bearbeitet werden.
{% endstep %}
{% endstepper %}

## Import-Verarbeitung

Mit der Import-Verarbeitung kannst Du durch das Hinzufügen von Spalten Änderung an allen im geöffneten Bereich selektierten Datensätze durchführen.&#x20;

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

{% hint style="danger" %}

## Datensätze vor der Verarbeitung selektieren!

Die Datensätze, die geändert werden sollen, müssen **vor** einer Stapel-Verarbeitung **selektiert** werden. Werden sie **nicht selektiert**, wirken sich die **Änderungen** der Stapel-Verarbeitung auf **alle im Bereich hinterlegten Datensätze** aus!

Weitere Informationen dazu findest Du im nächsten Abschnitt.
{% endhint %}

### 1. Import-Verarbeitung anlegen

Um die Import-Verarbeitung, z. B. im **Menüpunkt "Artikel",** durchzuführen, gehe wie folgt vor:&#x20;

{% stepper %}
{% step %}
**Import-Verarbeitung anlegen**

Klicke im gewünschten Bereich auf das **Stapel-Verarbeitungs-Symbol** <img src="/files/FGfBJNniGj2Sd0KzrCTd" alt="" data-size="line"> rechts über dem Tabellenkopf und wähle die **Option "Import-Verarbeitung"** aus.&#x20;

<figure><img src="/files/OEPfjzObaBGLHgL90vv0" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Bereich auswählen**

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

<figure><img src="/files/V3oT5OqqPyNEhNNn2eSi" alt="" width="484"><figcaption></figcaption></figure>
{% 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.&#x20;

<figure><img src="/files/CGR6eq5IgwZJ3vsP39bG" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### 2. Import-Verarbeitung durchführen

Die Import-Verarbeitung gliedert sich, wie der [**manuelle Datenimport** ](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md)im **Menüpunkt "System/Import",** in **vier Schritte.** Im Folgenden zeigen wir Dir die Funktionen der einzelnen Schritte.

{% hint style="info" %}

## **Schritt Zielspalten statt Quellspalten**

Beim Anlegen der Import-Verarbeitung wird diese direkt im **Schritt "Zielspalten"** mit der bereits zugeordneten **Spalte ID** geöffnet. Falls erforderlich, kannst Du jedoch zum **Schritt "Quellspalten"** zurückkehren, um zusätzliche Spalten zuzuordnen.
{% endhint %}

{% stepper %}
{% step %}

#### Quellspalten zuordnen

Im **Schritt "Quellspalten"** kannst Du die selektierten Spalten **Feldern** zuordnen.&#x20;

{% hint style="info" %}
Standardmäßig wird die Spalte mit den **Artikeln-IDs** beim Anlegen der Import-Verarbeitung **automatisch zugeordnet**.
{% 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).

<figure><img src="/files/lJDKyGBN5QP3MuOjCtXb" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Anhand der zugeordneten Spalten werden die vorgenommenen **Änderungen** den selektierten **Datensätze zugeordnet**. Diese sind dann im **Schritt "Zielspalten"** zu sehen.&#x20;
{% endhint %}

Klicke auf **"Weiter"** oder auf den **Schritt "Zielspalten",** um mit der Verarbeitung fortzufahren.
{% endstep %}

{% step %}

#### Zielspalten konfigurieren

Im **Schritt "Zielspalten"** sind die Spalten zu sehen, die den Quellspalten zugeordnet wurden. Standardmäßig wird die **Spalte "Id"** angezeigt. Anhand dieser kannst Du die selektierten Datensätze einsehen.&#x20;

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

<figure><img src="/files/HoovGzH9TDFk1jlkXme7" alt=""><figcaption></figcaption></figure>

Nach dem Auswählen einer Spalte öffnet sich ein **Pop-Up-Fenster**, in dem Du den Eintrag der neuen Spalte bearbeiten kannst. Dieser wird dann für **alle Datensätze** übernommen.&#x20;

Weitere Informationen zur Spaltenkonfiguration und den einzelnen Operationen findest Du [**hier**](/vario-cloud-handbuch/system/import-export/manuelle-datenimporte.md#zielspalten-konfiguration).

<details>

<summary><mark style="color:$primary;"><strong>Beispiel:</strong></mark> neuen Tag hinzufügen</summary>

In diesem Beispiel kannst Du festlegen, dass allen selektierten Datensätzen ein **neuer Tag** hinzugefügt wird.&#x20;

{% hint style="info" %}

## Voraussetzung

Der gewünschte Tag muss bereits in **Einstellungen/Allgemein/Tags** angelegt sein.
{% endhint %}

1. Füge die **Spalte "Bezeichnung"** aus dem **Objekt "Tags"** hinzu. &#x20;

<figure><img src="/files/0PPbIdSRGTkuDahl4MpS" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/Mv1UTNuFBH9dMgDeIFfm" alt=""><figcaption></figcaption></figure>

3. Die angegebene **Tagbezeichnung** wird als **neuer Wert** in eine **neue Spalte** zu allen Datensätzen hinzugefügt.

<figure><img src="/files/3ssDN8QHKg1rahKU8N8K" alt=""><figcaption></figcaption></figure>

</details>

Für **jede weitere Änderung**, die an den Datensätzen vorgenommen werden soll, kannst Du eine **weitere Spalte** hinzufügen. Diese kann dann jeweils in der Zielspalten Konfiguration angepasst werden.

Nachdem alle Anpassungen hinzugefügt wurden, klicke auf **"Weiter"** oder auf den **Schritt "Validierung",** um auf diesen zu wechseln.
{% endstep %}

{% step %}

#### Änderungen validieren

In der Validierung kannst Du prüfen, ob die Änderungen für alle Datensätze problemlos durchgeführt werden können.

Klicke auf **"Validierung starten"**, um die Validierung durchzuführen. Es öffnet sich ein **Pop-Up-Fenster,** in dem Du angeben kannst, ob **alle Datensätze** oder nur **bestimmte Datensätze** überprüft werden sollen.

<figure><img src="/files/3ynqy10g5dh8QELdaJUh" alt=""><figcaption></figcaption></figure>

Nach der Validierung werden Dir alle Datensätze mit dem entsprechenden **Status** angezeigt, ob diese korrekt verarbeitet werden können oder nicht. Wird ein Datensatz als **fehlerhaft** angegeben, wird der Grund des Fehlers ebenfalls angezeigt.

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

Über den **Button "Daten importieren"** unten rechts kannst Du die Anpassungen durchführen.&#x20;

<figure><img src="/files/SleKMk3Zj5FFPHPJvDmG" alt=""><figcaption></figcaption></figure>

Nachdem alle Datensätze bearbeitet wurden, erreicht die Verarbeitung den **Schritt "Abgeschlossen"**.

<figure><img src="/files/DFTgo5AlT9zppDVrATrh" alt=""><figcaption></figcaption></figure>

<details>

<summary><mark style="color:$primary;"><strong>Beispiel:</strong></mark> neuen Tag hinzufügen</summary>

Im Fall unseres Beispiels ist nach **Abschluss** der Import-Verarbeitung zu sehen, dass den Datensätzen der entsprechender **Tag** hinzugefügt wurde:

<figure><img src="/files/fDheUjGgcre4y1acOdfX" alt=""><figcaption></figcaption></figure>

</details>
{% endstep %}
{% endstepper %}

## Export-Verarbeitung

Mit der Export-Verarbeitung kannst Du die in der C-Unit selektierten Datensätze als **CSV-**, **JSON-** oder **XML-Datei** exportieren. Über die vorgegebenen Parameter kannst Du das **Format** der zu exportierenden Datei definieren. Da diese etwas umfangreicher sind, gehen wir sie in einem eigenen Abschnitt einzeln darauf ein.&#x20;

Um eine **XLSX-Datei** mit den Datensätze aus der C-Unit zu erstellen, kanns Du diese über das **Export-Icon** rechts neben dem **Stapel-Verarbeitungs-Icon** exportieren. Weitere Informationen dazu findest Du [**hier**](/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**&#x20;

Wähle über das **Stapel-Verarbeitungs-Symbol** ![](https://sites.gitbook.com/preview/site_kv9UA/~gitbook/image?url=https%3A%2F%2F534317722-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fa7nDlxyw1xkeHi7FnWgm%252Fuploads%252FadoDnNcHfVzTMo4HJ1yU%252Fimage.png%3Falt%3Dmedia%26token%3D8aa67b95-1440-46f4-95d2-767d56b8dd87\&width=42\&dpr=3\&quality=100\&sign=a690a956\&sv=2) rechts oberhalb der C-Unit die **Option "Export-Verarbeitung"** aus, um einen Export mit den selektierten Datensätzen zu starten.

<figure><img src="/files/CTMFQJ1ekhAnOktxvrCe" alt=""><figcaption></figcaption></figure>
{% 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.

<figure><img src="/files/mvZQxal4leIlZjOGkZH1" alt="" width="479"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Export-Einstellungen anlegen**

Im neuen Pop-Up-Fenster kannst Du neben der **Bezeichnung der Datei** verschiedene **Parameter** festlegen, anhand derer die Datei erstellt wird. **Genauere Informationen** zu den einzelnen Parameter findest Du im **nächsten Abschnitt**.

<figure><img src="/files/kFQVqq4N0q16hPFYLroR" alt="" width="474"><figcaption></figcaption></figure>

Nachdem alle Parameter eingestellt wurden, kannst Du auf **"Anlegen"** klicken, um die Export-Verarbeitung zu erstellen. Im **Abschnitt "Export durchführen"** erklären wir Dir Schritt für Schritt, wie Du die **Spalten der Zieldatei** konfigurieren kannst.&#x20;
{% 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.

<figure><img src="/files/dPfgkChJPhyZtlc6N36e" alt="" width="476"><figcaption></figcaption></figure>

Hier einen Überblick über die einzelnen Parameter und deren Verwendung:

<details>

<summary>Dateiname</summary>

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

</details>

<details>

<summary>Zeichensatz</summary>

Wähle eine der **Zeichenkodierungen** aus, anhand dessen die Daten dargestellt werden sollen. Zur Auswahl stehen **ASCII**, **LATIN 1**, **UTF-8** und **UTF-8 BOM**. Die **Zeichenkodierungsstandards** eignen sich jeweils für **verschiedene Anwendunsfälle**.

</details>

#### **Parameter für das Dateiformat CSV**

<details>

<summary>Kopfzeile schreiben</summary>

Lege fest, ob die Datei eine **Kopfzeile** mit den zugeordneten Spalten enthalten soll.

</details>

<details>

<summary>Zeilenumbruch</summary>

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

</details>

<details>

<summary>Anführungszeichen &#x26; Trennzeichen</summary>

Trage die Zeichen ein, welche in der Zieldatei als **Anführungszeichen** und **Trennzeichen** verwendet werden sollen.&#x20;

Dabei werden **Anführungszeichen** für die **Abgrenzung von Satzzeichen** verwendet während das **Trennzeichen** für die **Trennung der einzelne Daten** eingesetzt wird.

</details>

<details>

<summary>CSV-Spalten hinzufügen</summary>

Gib die **Bezeichnungen** für die Spalten der Zieldatei ein. Durch das Bestätigen eines Eintrags mit **Enter** wird jeweils ein **neues Feld** eingeblendet in dem die nächste Spaltenbezeichnung eingetragen werden kann.

{% hint style="warning" %}
Wird ein Eintrag nicht mit **Enter** bestätigt, wird er **nicht gespeichert**!
{% endhint %}

<figure><img src="/files/Ro28bYYDIK5XSHbWAJKM" alt="" width="474"><figcaption></figcaption></figure>

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

</details>

#### **Parameter für das Dateiformat JSON**

<details>

<summary>Leserlich formatieren</summary>

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

</details>

<details>

<summary>Zeilenumbruch</summary>

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

</details>

<details>

<summary>JSON-Zielknoten - Name</summary>

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 Zielknote hinzufügen.&#x20;

<figure><img src="/files/gWhVa2nIyVdFunmJp7qd" alt="" width="443"><figcaption></figcaption></figure>

</details>

<details>

<summary>JSON-Zielknoten - Typ</summary>

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.

<figure><img src="/files/Jalkerh7ECz8OEE8PhX0" alt="" width="434"><figcaption></figcaption></figure>

{% hint style="warning" %}

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

Achte darauf, dass **alle Daten**, die dem Knoten zugeordnet werden sollen, **dem gewählten Typ entsprechen**. Wenn ein Zielknoten z. B. den **Typ "Zahl"** hat, dürfen die zugeordneten Werte, z. B. **Artikelnummern, nur aus Zahlen** bestehen.
{% endhint %}

Mit dem **Typ "Objekt"** kannst Du **Unterknoten** innerhalb eines Knoten hinzufügen. Das eignet sich zum Beispiel für den Export von **Kundeninformationen** und **Lieferanteninformationen** zu Adressen.&#x20;

Dabei können die einzelnen Angaben zur Adresse als **Kunde** bzw. **Lieferant** als **Unterknoten** konfiguriert werden.

<figure><img src="/files/xzkyP9UpyDhuvum1wjdy" alt="" width="431"><figcaption></figcaption></figure>

</details>

<details>

<summary>JSON-Zielknoten - Liste</summary>

Der **Toggle "Liste"** kann für Zielknoten aktiviert werden, die für Datentypen bestimmt sind, die **mehrere Werte** enthalten können, z. B. **Tags**. Damit kannst Du festlegen, dass **alle vorhandenen Werte** dieses Datentyps innerhalb des Knotens aufgelistet werden.

In Verbindung mit dem **Typ "Objekt"** der Zielknoten kannst Du auch **mehrere unterschiedliche Datentypen** anhand von Unterknoten innerhalb eines Knotens auflisten lassen.

<figure><img src="/files/L8bp1KJrw2JNLtOu3qMC" alt="" width="440"><figcaption></figcaption></figure>

</details>

#### **Parameter für das Dateiformat XML**

<details>

<summary>XML-Deklaration</summary>

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.&#x20;

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

</details>

<details>

<summary>Leserlich formatieren</summary>

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

</details>

<details>

<summary>Quell-Knoten</summary>

Gib die **Bezeichnung** des übergeordneten Quell-Knotens der XML-Datei an.

</details>

<details>

<summary>Knoten - Name</summary>

Gib die gewünschte **Bezeichnung** für die **Knoten der Zieldatei** an. Dabei kannst Du einen **Hauptknoten** definieren, z. B. **Artikel**, der mehrere **Unterknoten** enthält, z. B. **Art.-Bezeichnung** oder **Art.-Nummer**. Die **Unterknoten** können im **nächsten Schritt** den **Spalten** aus der C-Unit zugeordnet werden.

Alternativ kannst Du auch einen Hauptknoten **ohne Unterknoten** definieren und ihn einer **einzelnen Spalte** zuordnen.

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

<figure><img src="/files/WbDRSW758omjoN3FcD9N" alt="" width="442"><figcaption></figcaption></figure>

</details>

<details>

<summary>Knoten - Neues Attribut</summary>

Füge über das **Pluszeichen** ein oder mehrere **Attribute** zu den einzelnen Knoten hinzu. Durch das Bestätigen eines Eintrags mit **Enter** wird jeweils ein **neues Feld** eingeblendet, in das ein weiteres Attribut eingetragen werden kann.

{% hint style="warning" %}
Wird der Eintrag nicht mit **Enter** bestätigt, wird dieser **nicht gespeichert**!
{% endhint %}

<figure><img src="/files/3ypvePRnCtOszLMauiGn" alt="" width="439"><figcaption></figcaption></figure>

</details>

### 3. Export konfigurieren

Nachdem Du den Export mit den gewünschten Parameter angelegt hast, kannst Du die **konfigurierten Zielspalten aus den Parametern** den Spalten der **selektierten Datensätzen** zuordnen, um den Export anschließend durchzuführen. Wie Du dabei vorgehen kannst, zeigen wird Dir anhand eines Beispiels mit einem JSON-Export: &#x20;

{% 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.&#x20;

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

<figure><img src="/files/2MojTHB6jSIgrxVGIQ8V" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/o6m4SSWTTho8jOVanVOO" alt="" width="371"><figcaption></figcaption></figure>

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

<figure><img src="/files/bNvyq9BLDEOwJqxQMUxK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Zielspalten nach Bedarf konfigurieren**

Im **Schritt "Zielspalten"** kannst Du die Inhalte der einzelnen Spalte auch individuell konfigurieren.&#x20;

Mit einem **Klick auf einen der Spaltenköpfe** kannst Du die **Zielspalten Konfiguration** öffnen. Dort stehen Dir über verschiedene **Operationen** mehrere Konfigurationsmöglichkeiten zur Verfügung.&#x20;

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

<figure><img src="/files/zWHhlLr3qhb26p5zuQkj" alt=""><figcaption></figcaption></figure>

Zielspalten die **nicht** über die Quellspalten **zugeordnet** wurden, können über das **Feld "Nach Spalten suchen"** ausgewählt und mit **manuellen Werten** ausgefüllt werden. **Bereits zugeordnete Spalten** werden dabei als **angehakt** angezeigt.

Diese Funktion kannst Du verwenden, um **Werte zu ergänzen**, die in VARIO Cloud nicht vorhanden sind, oder um **abweichende Werte** für alle Datensätze zu exportieren. Ein Beispiel ist das Hinzufügen von **abweichenden Tags** zu den in der VARIO zugeordneten Tags.

<figure><img src="/files/KFxq3ZHY08m1pRO2Se8I" alt=""><figcaption></figcaption></figure>

In der **Zielspalten Konfiguration** kannst Du den Wert der neuen Spalte frei konfigurieren. Mit der **Operation "Fester Wert"** kannst Du beispielsweise einen bestimmten Wert eingeben, der zu allen Datensätzen hinzugefügt wird.

<figure><img src="/files/trYJ1KvcKAa9T6T0ZE5m" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Export abschließen**

Um die Datensätze anschließend zu exportieren, klicke unten auf **"Weiter".**&#x20;

<figure><img src="/files/lI1SywhgKBvqm5E8h7xh" alt=""><figcaption></figcaption></figure>

Nach dem **Export** wird die Verarbeitung auf den **Status "Abgeschlossen"** gesetzt und Dir werden die erfolgreich exportierten Datensätze aufgelistet.

<figure><img src="/files/8cDsFqka9eWDM6qCxOpf" alt=""><figcaption></figcaption></figure>

Die exportierte Datei findest Du anschließend im **Menüpunkt "DMS"** unter "CRM/DMS". Dort kannst Du die Datei über das **Export-Icon** ganz **rechts** in der Tabelle herunterladen.

<figure><img src="/files/DfKUmLLjavdi3rXtL6Gx" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.vario-software.de/vario-cloud-handbuch/system/import-export/stapel-verarbeitung.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.