Konfiguration bearbeiten und aktivieren

ImageConvert liest globale und kundenspezifische JSON-Dateien ein. Die Dialoge Allgemein und Kunden zeigen diese Daten an; das Herstellerhandbuch bezeichnet die Bearbeitung über diese Dialoge als derzeit nicht möglich. Änderungen erfolgen deshalb im Texteditor. Geänderte Kundendaten benötigen einen Programmneustart.

Voraussetzungen

Du brauchst Schreibberechtigung, die Zuordnung der Dateien zu dieser Installation und einen abgestimmten Zeitpunkt für den Neustart. Sichere die zuletzt funktionierenden Dateien außerhalb der eingelesenen JSON-Ordner. Eine Sicherung mit der Endung .json in JsonKunden könnte als weiterer Kunde gezählt werden.

Das Handbuch nennt JsonGeneral und JsonKunden unterhalb des Programmverzeichnisses; eine FAQ nennt zusätzlich /Settings/JsonGeneral. Ermittle daher zuerst den tatsächlich verwendeten Ort deiner Installation. Lege nicht vorsorglich einen zweiten Konfigurationsordner an.

Änderung vorbereiten

1. Unterscheide die Dateien: Globale Einstellungen wie other.startConversionImmediately betreffen alle Kunden. Die Kunden-JSON enthält root, Eingänge und Ausgänge eines Kunden.
2. Notiere den konkreten Zielpfad des Feldes, etwa mainFolder.web.subFolder[].widthPx. [] bedeutet einen vorhandenen Listeneintrag, keinen wörtlichen Feldnamen.
3. Sichere die vollständige Datei und ändere zunächst nur die benötigten Werte. Erhalte die Reihenfolge und die übrigen Einträge. Besonders Eingangsrollen und die Print-Originalablage dürfen nicht durch ein verkürztes Beispiel ersetzt werden.
4. Prüfe JSON-Syntax: Zeichenketten in doppelten Anführungszeichen, boolesche Werte als true/false, Windows-Backslashes als \\. Verwechsle false, null, fehlende Felder und leere Listen nicht miteinander.

Die kommentierten Herstellerbeispiele sind keine unmittelbar kopierbaren strikten JSON-Dateien. Für eine Syntaxkontrolle beschreibt das Handbuch das separate Werkzeug jsoncheck. Wenn es in deiner Installation vorhanden ist, prüfe zunächst eine Arbeitskopie außerhalb der eingelesenen Ordner mit jsoncheck "Pfad-zur-Arbeitskopie.json"; ersetze den Beispielpfad durch den tatsächlichen Dateipfad. Das Werkzeug meldet JSON syntax OK oder JSON SYNTAX ERROR mit einer Fehlermeldung. --fix erzeugt laut Handbuch eine zusätzliche Datei name.fixed.json ohne Kommentare; prüfe auch diese Ausgabe, bevor sie übernommen wird. Verwende --dump nicht für eine unbereinigte Weitergabe: Der erzeugte Inhaltsdump kann auch Zugangsdaten enthalten. Syntaxprüfung allein bestätigt weder Feldnamen noch fachliche Gültigkeit.

Aktivieren und nachsehen

1. Stimme den Stopp mit dem Betreiber ab. Falls ImageConvert läuft, ist Beenden der dokumentierte Weg zum Abschluss nach bereits begonnenen Wandlungen. Der Monitor kann ImageConvert erneut starten; seine Beteiligung muss im vorgesehenen Betriebsablauf berücksichtigt werden.
2. Ersetze die betreffende Konfigurationsdatei durch die geprüfte vollständige Fassung. Verwende nicht die Fragmente dieser Website als komplette Kunden-JSON.
3. Starte ImageConvert über den vorgesehenen Startweg neu. Das Handbuch verlangt einen Neustart bei geänderten, hinzugefügten oder entfernten Kundendaten; bloßes Speichern ist keine Aktivierungsbestätigung.
4. Wenn ein direkter Start ohne Sofortwandlung vorgesehen ist, prüfe die eingelesenen Werte unter Allgemein bzw. Kunden, bevor du Umwandlung starten betätigst. Bei Monitorstart oder aktivem Sofortstart ist diese Ansicht nicht als vorgeschalteter Bearbeitungsschritt verfügbar.
5. Verarbeite eine freigegebene Bildkopie nach dem Schnellstart. Prüfe genau das geänderte Ergebnis und die Meldungen. Eine erfolgreiche Syntaxprüfung ersetzt diesen Abgleich nicht.

Bei unerwünschten Ergebnissen stelle die gesicherte Datei über denselben abgestimmten Neustartablauf wieder her. Ändere nicht mehrere unbekannte Felder gleichzeitig, um einen Fehler zu überdecken.

Ausgänge und Kunden getrennt schalten

Ein vorhandener Ausgabe-Eintrag wird mit active: false abgeschaltet und mit active: true wieder zugelassen. Zusätzlich können Schaltpfade seine Erzeugung begrenzen. Siehe active am Webausgang.

Ein ganzer Kunde lässt sich laut Handbuch aus der Überwachung nehmen, indem seine JSON-Datei in den Unterordner deaktiviert von JsonKunden verschoben wird. Das ist etwas anderes als ein deaktivierter Ausgang. Änderungen an der Kundenmenge ebenfalls per Neustart übernehmen und danach die Kundenanzeige kontrollieren.

Quellen

Herstellerhandbuch ImageConvert, Stand 09.10.2026, ImageConvert-4.pdf: gedruckte S. 2–3 (PDF-S. 6–7), S. 9 (PDF-S. 13), S. 17–18 (PDF-S. 21–22), S. 49 (PDF-S. 53), FAQ S. 66–67 (PDF-S. 70–71), History S. 74–76 (PDF-S. 78–80; Settings-Unterordner und jsoncheck). Sicherung und begrenzte Einzeländerung sind redaktionelle Sicherheitsregeln. Sie ersetzen keine installationsspezifische Betriebsanweisung für den Monitor.