# Steuerung des automatisierten Mehrfachdrucks von Skizzen

Für das automatische Mehrfachdrucken wird eine **Steuerungsdatei** verwendet. In der Steuerungsdatei sind alle Informationen enthalten, die für das automatische Mehrfachdrucken benötigt werden. Die Steuerungsdatei hat die Endung **<span class="file">.db.json</span>** und ist im Ordner der [Benutzeranpassung](./aust40_04_01_autoskizzen_copy.md) gespeichert.

---

## Steuerungsdatei zuweisen

Damit die Anwendung weiß, welche Steuerungsdatei für das Mehrfachdrucken verwendet werden soll, muss diese über die **AutoSTAGE Optionen** mit dem <span class="cmd">ASOPT</span>-Befehl zugewiesen werden:  
![Steuerungsdatei zuweisen über die AutoSTAGE Optionen](/x/de/AuSt40_Report_Start_Json_Assign.png)

Ansicht der Optionen nach der Zuweisung der Steuerungsdatei. <span class="att">Speichern nicht vergessen!</span>  
![Ansicht der Optionen nach der Zuweisung der Steuerungsdatei](/x/de/AuSt40_Report_Start_Json_Assigned.png)

---

## Einrichtung der Steuerungsdatei

Für die Bearbeitung der Steuerungsdatei muss ein **Texteditor** verwendet werden. 

Wir empfehlen den kostenfreien Editor **Visual Studio Code** von Microsoft. 
Dieser Editor zeigt den Inhalt der Steuerungsdatei mit visuellen Formatierungen an, die beim Bearbeiten der Inhalte hilft.  <a href="https://code.visualstudio.com/Download" target="_blank">**Visual Studio Code** kann hier heruntergeladen werden</a>.

Nach der Installation von Visual Studio Code *(oder eines beliebig anderen Editors)* kann die Steuerungsdatei direkt aus <span class="app">AutoSTAGE</span> über den **Fairground Tab** mit dem Befehl <span class="cmd">ASFGPLANPLOT_JSON</span> angezeigt werden.  
![Steuerungsdatei zum Bearbeiten anzeigen](/x/de/AuSt40_Skizze_All_Start_Json.png)

Nach dem Öffnen der Steuerungsdatei sieht diese im Visual Studio Code Editor ungefähr so aus. Sehr gut zu sehen ist die visuelle Formatierung und Hervorhebung der einzelnen Bestandteile der Steuerungsdatei. Die Steuerungsdatei ist in mehrere Abschnitte unterteilt. Für das Mehrfachdrucken wird der Abschnitt benötigt, der mit **"skizzenplot": [** beginnt und mit der dazugehörigen **],** endet.  
![Anzeige der Steuerungsdatei im Editor](/x/de/AuSt40_Skizze_All_Start_Json_Show.png)

---

## Anpassung für dieses Tutorial

In der [Einrichtung](../aust40_05_00_report/aust40_05_01_report_copy.md) haben wir die [Beispielvorlage einer Benutzeranpassung](../aust40_02_00_user/aust40_02_01_templates.md) in den Ordner **<span class="file">C:\AutoSTAGE\MeineFairgroundAnpassung</span>** [kopiert](../aust40_02_00_user/aust40_02_02_copy.md). 

Die neuen Dateipfade nach dem Kopieren der Benutzeranpassung müssen in der Steuerungsdatei aktualisiert werden:  
![Anzeige der Steuerungsdatei im Editor](/x/de/AuSt40_Planplot_Start_Json_Show_Sample.png)

Der Name der Zeichnungen bleibt gleich und muss nicht verändert werden. Alle anderen Felder werden ebenfalls so übernommen.

!!!
Beim Einfügen *(z. B. mit Copy-Paste)* eines Pfads in die Steuerungsdatei markiert der Visual Studio Code Editor diesen als Fehler *(siehe oberes Bild)*.  <br/><br/>
Für den Editor ist das Windows **\\** *(Backslash)* als Trenner zwischen Dateiordnern ein unzulässiges Sonderzeichen.   <br/><br/>
Der Editor wünscht sich anstelle eines **\\** ein **/** *(Slash)* als Trenner zwischen Dateiordnern.  <br/><br/>
Diese Fehlermarkierung kann ignoriert werden, die Anwendung kann den Pfad richtig auflösen, unabhängig davon ob der Dateiordnertrenner als **\\** oder **/** ausgeführt ist.
!!!

---

## Datenfelder für das Mehrfachdrucken

Die Steuerungsdatei enthält eine Reihe von Datenfelder, die bestimmte Informationen für das Mehrfachdrucken speichert. Für die Formatierung gelten folgende Grundregeln:

- Alle Daten müssen von Anführungsstrichen umschlossen sein.
- Jede Zeile wird mit einem Komma abgeschlossen.
- Ausgenommen davon ist die letzte Zeile in Listen wie bei **zeichnungen** und **ansicht**.
- Groß- und Kleinschreibung wird bei der Auswertung ignoriert.

### logname
- Beim Erstellen der Plots wird eine Logdatei erstellt. 
- Hier wird der Name der Logdatei festgelegt.

### fehler_anzeigen
- Wenn der Wert auf 1 steht, dann wird ein Fenster mit einer Fehlermeldung angezeigt. Der Ausdruck wird damit abgebrochen.
- Wenn der Wert auf 0 steht, wird keine Fenster mit einer Fehlermeldung gezeigt. Die Fehler werden in der Logdatei vermerkt, alle anderen Ausdrucke werden erstellt.

### ausgabe_pfad
- Ist der Dateipfad, in dem die Skizzen erstellt werden. 
- Wenn der Ordner nicht vorhanden ist, dann wird dieser automatisch erstellt.

### zeichnungen_pfad
- Ist der Dateipfad, aus dem die Zeichnungen für das Mehrfachdrucken geladen werden. 

### zeichnungen
- Definiert die Liste der Zeichnungen, die geladen werden.
- Es werden nur die hier angegebenen Zeichnungen für den Mehrfachdruck verwendet,  
auch wenn andere Zeichnungen im Zeichnungspfad vorhanden sind.
- Der Zeichnungsname wird ohne Dateierweiterung angegeben. 
- Es können beliebig viele Zeichnungen angegeben werden.
- Ein **?** am Anfang des Zeichnungsname bewirkt, dass die Zeichnung für den Mehrfachdruck <span class="att">ignoriert</span> wird.  
Die Zeichnung **"?Fairground_Sample_Halle_2"** wird nicht gedruckt.
- <span class="att">Es muss mindestens eine Zeichnung angebeben werden!</span>

### flaechen
- Es stehen zwei Flächenarten zur Verfügung: **Messeflächen** und **Standflächen**.
- Für jede Flächenart können separate Layerstati und Ansichten definiert werden.
- Die Flächenarten werden jeweils von einem Satz geschweifter Klammern **{ }** definiert und müssen mit einem Komma vom nächsten Eintrag getrennt werden. Der letzte Eintrag darf jedoch kein Komma nach der Klammer **}** haben.

### name
- Name der Flächenart.
- <span class="att">Es dürfen nur die Namen **messeflaechen** oder **standflaechen** vorkommen!</span>
- <span class="att">Ein anderer Name ist nicht erlaubt.</span>

### alias
- Alternativer Name für die Flächenart.

### layerstatus
- Name des Layerstatus, der beim Vorbereitung des Layouts verwendet wird.  
![JSON layerstatus](/x/de/AuSt40_Skizze_All_AuStLayout_layerstatus_json.png)  
- Wenn der Layerstatus mit dem angegebenen Namen in der Zeichnung vorhanden ist, dann wird dieser aktiviert.  
Ansonsten wird der Layerstatus ignoriert.

### ansicht
- Weiter Ansichtsoptionen nur für **AuStFairgroundArea** Objekte *(Fairground Messe- und Standflächen)*. Diese Ansichtsoptionen gelten für alle Skizzen.

### raster
- Schaltet das Raster der Messe- und Standflächen bei der Skizzenerstellung ein (1) oder aus (0). 

### nummer
- Schaltet die Gang- und Standnummer der Messe- und Standflächen bei der Skizzenerstellung ein (1) oder aus (0).

### aussteller
- Schaltet den Ausstellernamen der Messe- und Standflächen bei der Skizzenerstellung ein (1) oder aus (0).

### rahmen
- Schaltet den Rahmen aller Fairground Messe- und Standflächen bei der Druckausgabe ein (1) oder aus (0).

### fuellung
- Schaltet die Füllung aller Fairground Messe- und Standflächen bei der Druckausgabe ein (1) oder aus (0).

### aussteller
- Schaltet die Anzeige der Quadratmeter aller Fairground Messe- und Standflächen bei der Druckausgabe ein (1) oder aus (0).

### flex_layout_nummer
- Definiert die Nummer der Flex-Layout Design-Vorlage. Es muss eine entsprechende Design-Vorlage vorhanden sein.  
Siehe dazu auch die allgemeine Anleitung zu [Skizzen](../aust40_03_00_skizzen/aust40_03_00_skizzen.md) sowie [Individuelle Layout-Nummer der Fläche](../aust40_03_00_skizzen/aust40_03_03_skizzen_conditions.md#individuelle-layout-nummer-der-fläche)
