Zusammenhängende Kunden-JSON verstehen¶
Hier siehst du eine einzige fiktive Kundenkonfiguration im Zusammenhang: ein Kunde, neun positionsgebundene Eingänge, vier Printplätze, die vier Webgrundausgänge und ein deaktivierter Videoplatz. Die Datei ist als reines JSON zum Lesen/Herunterladen verfügbar. Das folgende Codebeispiel wird beim Website-Build direkt aus genau dieser Datei eingebettet, damit Text und Download nicht auseinanderlaufen.
Lernbeispiel, keine einsatzfertige Kundendatei
C:\IC\Beispielkunde\ ist ein fiktiver Windows-Pfad; example.invalid ist keine Mailadresse für den Versand. Nicht in JsonKunden kopieren: Jede dort abgelegte *.json kann bereits beim Scan eingelesen werden. Auch deaktivierte oder vermeintlich harmlose Plätze können Nebenwirkungen haben. Ordner, Photoshop, Formate, globale Einstellungen und die tatsächliche Programmversion müssen zur Installation passen. Das Beispiel ist syntaktisch geprüft und anhand der gelesenen Feldreferenz erläutert, nicht mit einer installierten EXE getestet.
Die gesamte Datei¶
Die anklickbaren Schlüssel führen zur genauen Feldbeschreibung (Werte, Wirkung, Grenzen). Das Zeichen ↗ daneben führt zur zugehörigen Funktion oder Anleitung. Innerhalb der Arrays bestimmen die Positionen die Rolle; die folgenden Links auf gleichen Schlüsseln gelten je Element.
{
"name": "Beispielkunde",
"root": ↗ "C:\\IC\\Beispielkunde\\",
"cutoutResult": ↗ false,
"customerMail": ↗ {
"customerAddress": ↗ "no::kunde@example.invalid",
"refereceLine": ↗ "Bildverarbeitung Beispielkunde",
"salutation": ↗ "Guten Tag",
"intro": ↗ "Ein Fehler ist aufgetreten."
},
"customerActions": ↗ [
],
"customerActionsVor": ↗ [
],
"customerScripts": ↗ [
],
"customerScriptsVor": ↗ [
],
"imageDefaults": {
"canvas": ↗ {
"widthPercent": ↗ 0,
"heightPercent": ↗ 0,
"horizontalAlignment": ↗ "Cntr",
"verticalAlignment": ↗ "Cntr"
},
"shadow": ↗ {
"opacityPercent": ↗ 50,
"angleDegrees": ↗ 120,
"distancePx": ↗ 10,
"spreadPercent": ↗ 15,
"sizePx": ↗ 10
},
"printQuality": ↗ {
"minPixelEdge": ↗ 200,
"behaviorIfTooSmall": ↗ 1,
"limitImageToSourceSize": ↗ false
},
"webQuality": ↗ {
"limitImageToSourceSize": ↗ false
}
},
"fileExtensions": ↗ {
"imageExtensions": ↗ [
"jpg",
"jpeg",
"png",
"tif",
"psd"
],
"printExtensions": ↗ [
"jpg",
"jpeg",
"png",
"tif",
"psd"
],
"nonImageExtensions": ↗ [
"txt\\5"
],
"videoExtensions": ↗ [
"mp4"
]
},
"webOptions": {
"switches": ↗ {
"trim": ↗ "no",
"useWeissBeschneiden": ↗ false,
"transparentBeschneiden": ↗ false
}
},
"mainFolder": {
"logFolder": ↗ "Log\\",
"errorFolder": ↗ "Error\\",
"inbox": ↗ {
"rootFolder": ↗ "Eingang\\",
"subFolder": ↗ [
{
"name": ↗ "temp\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "entry\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "reentry\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "entry_noprint\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "reentry_noprint\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "rotate_90\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "rotate_180\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "rotate_270\\",
"deleteFolders": ↗ false
},
{
"name": ↗ "refresh\\",
"deleteFolders": ↗ false
}
]
},
"nopicture": ↗ {
"rootFolder": ↗ "Nopicture\\",
"other": ↗ "other\\",
"log": ↗ "log\\"
},
"print": ↗ {
"rootFolder": ↗ "Print\\",
"subFolder": ↗ [
{
"originalFolder": ↗ "Original\\"
},
{
"name": ↗ "print1\\",
"active": ↗ true,
"widthPx": ↗ 1700,
"heightPx": ↗ 2500,
"specialSize": ↗ "no",
"resolution": ↗ 300,
"format": ↗ "jpg",
"colorProfil": ↗ "",
"limitImageToSourceSize": ↗ false
},
{
"name": ↗ "print2\\",
"active": ↗ false,
"widthPx": ↗ 900,
"heightPx": ↗ 1300,
"specialSize": ↗ "no",
"resolution": ↗ 300,
"format": ↗ "jpg",
"colorProfil": ↗ ""
},
{
"name": ↗ "print3\\",
"active": ↗ false,
"widthPx": ↗ 1200,
"heightPx": ↗ 1200,
"specialSize": ↗ "no",
"resolution": ↗ 300,
"format": ↗ "jpg",
"colorProfil": ↗ ""
},
{
"name": ↗ "print4\\",
"active": ↗ false,
"widthPx": ↗ 1000,
"heightPx": ↗ 700,
"specialSize": ↗ "no",
"resolution": ↗ 300,
"format": ↗ "jpg",
"colorProfil": ↗ ""
}
]
},
"web": ↗ {
"rootFolder": ↗ "Web\\",
"noTrim": ↗ false,
"colorProfil": ↗ "",
"subFolder": ↗ [
{
"name": ↗ "super\\",
"active": ↗ true,
"widthPx": ↗ 1600,
"heightPx": ↗ 1200,
"specialSize": ↗ "no",
"mindestens": ↗ false,
"format": ↗ "jpg",
"qualityJPG": ↗ 80,
"colorProfil": ↗ "",
"noTrim": ↗ false,
"flatten": ↗ false,
"schaltpfade": ↗ [
]
},
{
"name": ↗ "detail\\",
"active": ↗ true,
"widthPx": ↗ 900,
"heightPx": ↗ 700,
"specialSize": ↗ "no",
"mindestens": ↗ false,
"format": ↗ "jpg",
"qualityJPG": ↗ 80,
"colorProfil": ↗ "",
"noTrim": ↗ false,
"flatten": ↗ false,
"schaltpfade": ↗ [
]
},
{
"name": ↗ "list\\",
"active": ↗ true,
"widthPx": ↗ 480,
"heightPx": ↗ 360,
"specialSize": ↗ "no",
"mindestens": ↗ false,
"format": ↗ "jpg",
"qualityJPG": ↗ 80,
"colorProfil": ↗ "",
"noTrim": ↗ false,
"flatten": ↗ false,
"schaltpfade": ↗ [
]
},
{
"name": ↗ "thumb\\",
"active": ↗ true,
"widthPx": ↗ 240,
"heightPx": ↗ 180,
"specialSize": ↗ "no",
"mindestens": ↗ false,
"format": ↗ "jpg",
"qualityJPG": ↗ 80,
"colorProfil": ↗ "",
"noTrim": ↗ false,
"flatten": ↗ false,
"schaltpfade": ↗ [
]
}
]
},
"video": ↗ {
"rootFolder": ↗ "Video\\",
"subFolder": ↗ [
{
"name": ↗ "video_mp4\\",
"active": ↗ false,
"widthPx": ↗ 1280,
"heightPx": ↗ 720,
"framesPersec": ↗ 24,
"format": ↗ "mp4",
"imageFormat": ↗ "jpg",
"schaltpfade_v": ↗ [
]
}
]
}
}
}So liest du die Blöcke¶
| Im JSON | Wofür? | Werte, Varianten und Auswirkungen |
|---|---|---|
name, root |
Kunde und Basis für relative Ordner | Kundenbasis und exakter Readerpfad, Ablage/Aktivierung. Der gezeigte Pfad ist kein Standard. |
customerMail, customerActions*, customerScripts* |
Fehlerbenachrichtigung und kundenseitige Verarbeitung | customerAddress und no::, Aktionen auf Kundenebene. Leere Listen sind bewusst neutral; customerActionsVor nicht allein wegen des Namens für wirksam halten. |
fileExtensions |
Eingangsklassifizierung | Bild-, Print-, Nichtbild- und Videoendungen, Nichtbilder. txt\\5 ist die Endung samt Infoflag, nicht einfach txt und kein Rezept für alle Dateitypen. |
imageDefaults |
Gemeinsame Vorgaben für Canvas, Schatten und Qualität | Canvas-Ausrichtung Cntr, Qualitätsprüfung, Canvas. Zahlen im Beispiel sind gewählte Anschauungswerte, keine Standards. |
webOptions.switches |
Allgemeiner Beschnittweg | Alle trim-Werte und ihr Verhalten, Freistellung/Beschnitt. "no" bedeutet keine Pfadbeschneidung; das ist keine Freisteller-Aktivierung. |
mainFolder.logFolder, errorFolder, nopicture |
Protokolle, Fehler und Nichtbilder | Protokoll lesen, Nichtbildablage. Alle relativen Namen nur beispielhaft. |
mainFolder.inbox.subFolder |
Positionsgebundene Eingangsrollen | Index 0–8 und ihre Bedeutung, normaler Eingang, Ordnerrollen. deleteFolders: false ist eine bewusste Musterwahl, kein zugesichertes globales Sicherheitsnetz. |
mainFolder.print.subFolder |
Originalablage [0], vier benannte Plätze [1]–[4] |
Printplätze und Sonderrolle von Print 2, Format, Größe/specialSize, Profile. Deaktivierte Plätze bleiben als Positionsgerüst enthalten; colorProfil ist die gelesene Schreibweise, der leere Wert verlangt kein fremdes Profil. |
mainFolder.web.subFolder |
super, detail, list, thumb |
Webausgänge und Aktivierung, Pixelmaße, Format, JPEG-Qualität, Schaltpfade. schaltpfade: [] ist kein Filter; mindestens: false ist ausdrücklich gesetzt, auch wegen des bekannten Print/Web-Indexkonflikts. |
mainFolder.video |
Demonstriert die separat gelesenen Video-Keys | Video und Zielroot-Konflikt, Filtergrenze schaltpfade_v. rootFolder ist ein gefordertes Präfix, nicht die wirksame Videozielbasis. active: false ist kein Archivschutz; es ist keine Videoausführung empfohlen. |
Eine Änderung nachvollziehen¶
Du möchtest das detail-Webbild kleiner ausgeben? Suche im Beispiel mainFolder.web.subFolder[1] (zweiter Eintrag) und ändere nur in einer gesicherten Kopie widthPx/heightPx. Lies vorher Größe und Qualität und die Feldreferenz für widthPx. specialSize: "no" und mindestens: false sind hier bewusst gewählt: Ein Wert ohne den anderen erklärt das Ergebnis nicht vollständig. Prüfe anschließend mit der Anleitung zur Konfigurationsänderung die eigene Installation; diese Musterdatei selbst wird dabei nicht aktiviert.
Grenzen und Weiterarbeit¶
Das Beispiel deckt nicht alle 131 dokumentierten Kundenwertpfade oder Sonderformate ab. Für andere Zielgrößen, [fixed]/[square], Schaltpfade, Transparenz, AVIF/WEBP oder Aktionen führen die verlinkten Referenzen zu den tatsächlich gelesenen Einstellungen und bekannten Verbrauchergrenzen. Insbesondere können noTrim, mindestens und Videofilter nicht allein aus ihrem Keynamen sicher interpretiert werden. Die historischen drei unveränderten Beispieldateien sind keine Vorlage für diese aktuelle Readerrevision.
Quellen: Struktur, Indexrollen und Readerstand, Feldreferenz und Gültigkeit; Handbuch ImageConvert-4 vom 09.10.2026 und statisch gelesener Form1-Stand 20261013. Alle gezeigten Werte sind fiktive Beispiele, keine Installations- oder Laufbelege.