Fehler systematisch eingrenzen

Beginne mit einer konkreten Eingabedatei und der erwarteten Ausgabe. Ein fehlendes Webbild kann an einer Schaltpfadbindung liegen; eine gar nicht abgeholte Datei hat andere Ursachen. Ändere deshalb nicht sofort Format, Größe und Eingang gleichzeitig.

Voraussetzungen und erste Sicherung

Du kennst den Kunden, den Eingangszeitpunkt und den verwendeten Ordner. Sichere die ursprüngliche Datei außerhalb der Überwachung und halte fest, welches Ergebnis fehlt oder abweicht. Lösche keine Fehlerdateien, bevor die Meldungen ausgewertet sind. Bei Änderungen gilt Bearbeiten und aktivieren.

1. Datei bleibt im Eingang liegen

1. Vergleiche den tatsächlichen Ablageort mit root und mainFolder.inbox der eingelesenen Kunden-JSON. Die Beispielnamen entry und Eingang sind keine verbindlichen Installationspfade.
2. Prüfe, ob der Kunde überhaupt aktiv eingelesen ist. Eine JSON im Unterordner deaktiviert nimmt ihn aus der Überwachung; Änderungen benötigen einen Neustart.
3. Prüfe, ob der Unterordner mit $ beginnt. Solche Eingangsordner werden einschließlich ihrer Unterordner ignoriert.
4. Kontrolliere, ob die Übertragung fertig ist. ImageConvert versucht eine noch nicht vollständig übertragene bzw. nicht verschiebbare Datei später erneut. Lege keine zweite identische Datei daneben, solange der erste Auftrag ungeklärt ist.
5. Prüfe die Programmanzeige: Bei direktem Start ohne Sofortwandlung muss die Wandlung mit Umwandlung starten begonnen werden. Bei laufendem Betrieb zeigt der Monitor gegebenenfalls eine Warteschlange.

Ergebnisprüfung: Die richtige Datei wird abgeholt und die erwarteten Ausgänge erscheinen. Das Verschwinden aus dem Eingang allein reicht nicht.

2. Ein bestimmter Ausgang fehlt

1. Suche den konkreten Eintrag in mainFolder.print.subFolder[], web.subFolder[] oder video.subFolder[].
2. Prüfe active. Bei Schaltpfaden muss zusätzlich der tatsächliche Eingangsunterordner passen.
3. Bei fehlendem Print: War die Eingangsrolle noprint oder reentry_noprint? Prüfe außerdem minPixelEdge und behaviorIfTooSmall; die Einstellung 0 kann zu kleine Bilder von der Druckausgabe ausschließen.
4. Bei einem Eingang über refresh: Die ersten vier Standard-Webziele haben eine besondere Ablage, und die reguläre Info-Datei entfällt. Das bedeutet nicht, dass ausschließlich vier Dateien entstehen: Weitere aktive Web- und Printausgaben sind möglich. Verwende refresh nicht zur verlässlichen Unterdrückung von Printbildern.
5. Lies die Hinweise im Kundenfehlerordner. Ein einzelner nicht erzeugbarer Ausgang kann als Hinweis protokolliert sein, ohne die Datei im Hauptzähler als fehlerhaft zu zählen.

Lösung: Korrigiere nur die unpassende Aktivierung, Zuordnung oder Qualitätsregel. Übernimm die Änderung per Neustart und prüfe das zuvor fehlende Ziel. Siehe Web-/Printausgänge.

3. Das Bild hat falsche Größe oder unerwartete Ränder

1. Vergleiche widthPx, heightPx und specialSize am tatsächlichen Ausgang. Zwei positive Kanten mit specialSize: "no" sind Maximalgrenzen, keine Zusage exakter Außenmaße.
2. Prüfe kundenweite und lokale limitImageToSourceSize-Werte. Eine kleine Rasterquelle kann die Ausgabe begrenzen.
3. Prüfe noTrim, die Pfadregel trim, Transparenz-/Weißbeschnitt und den Eingangsunterordner nocrop.
4. Prüfe zusätzliches canvas und die Regel fixed oder square. Neuer Leerraum ist nicht mit einem unerwünscht erhaltenen Quellrand gleichzusetzen.
5. Wenn Transparenz fehlt, prüfe Format, Export-Transparenz und flatten. Eine PNG-Endung allein garantiert keine transparenten Bildbereiche.

Lösung und Ergebnisprüfung: Lege erst fest, ob das Motiv, die ganze Quellfläche oder eine feste Außenfläche erhalten werden soll. Ändere die entsprechende Regel und kontrolliere anschließend Außenmaße und Motivlage. Siehe Größe/Qualität und Freistellung/Canvas.

4. Datei wird als fehlerhaft behandelt oder Photoshop wartet

1. Prüfe die Dateigröße. Eine leere Datei wird unabhängig von ihrer Endung als Fehler behandelt. Fordere die vollständige Quelle erneut an.
2. Öffne eine gesicherte Kopie bei abgestimmter, ruhender Verarbeitung in Photoshop. Prüfe, ob Dateiendung und Inhalt zusammenpassen oder ein Dialog erscheint. Arbeite dabei nicht im von ImageConvert gerade verwendeten Dokument.
3. Bei einem geschützten PDF: Fordere eine für die Verarbeitung freigegebene, ohne interaktive Kennworteingabe nutzbare Fassung an. ImageConvert bietet in dieser Anleitung keine belegte Schnittstelle zur Übergabe eines PDF-Kennworts.
4. Bei wiederholten Startproblemen lasse die Zuordnung von Photoshop und Interop.Photoshop.dll durch den Betreiber prüfen. Das Handbuch warnt vor einem Absturz, wenn die zur DLL gehörende Photoshop-Version fehlt. Tausche die DLL nicht versuchsweise gegen eine beliebige Datei aus.
5. Für eine betreute Diagnose kann other.showPhotoshopWindow: true das Photoshop-Fenster sichtbar halten. Das ist eine globale Einstellung; sichere sie und nimm sie nach der Diagnose über denselben Aktivierungsablauf zurück.

Ergebnisprüfung: Die Quelle lässt sich öffnen, der blockierende Dialog ist erklärt und eine erneute freigegebene Verarbeitung liefert die erwarteten Dateien. Wiederholte Neustarts ohne Ursachenklärung sind keine Lösung.

5. Skriptwirkung, Video oder Nichtbildablage fehlen

• Skript: Dateiname einschließlich Endung, Ablage unter js und Geltungsbereich kontrollieren. Bei Aktionen zusätzlich Aktionsgruppe passend zu name prüfen. Die konkrete Wirkung am Bild kontrollieren, nicht nur den Status. Zuordnung von Aktionen und Skripten.
• Video: Endungslisten und externe Werkzeuge prüfen. Verwende die korrigierten Schlüssel framesPersec und imageFormat. Prüfe Ausgang und Vorschaubild getrennt. Videoverarbeitung.
• Nichtbild: Bekannte Endung und Kennzahl prüfen. Bei unbekannter Endung ist die Ablage unter other ohne Info-Datei vorgesehen; verwechsle dies nicht mit einem verlorenen Log.

Die richtigen Meldungen lesen

Fundstelle	Zweck
Konfiguriertes mainFolder.logFolder	Info-Datei zur Bild-/Videoverarbeitung; Feld 16 ist der Status.
Nichtbildlog aus mainFolder.nopicture.log	Info-Dateien bekannter Nichtbilder.
Kundenfehlerordner mainFolder.errorFolder	Hauptfehlerlog und Hinweislog zur Verarbeitung. Das Handbuch nennt ImageConvert_day.log und ImageConvert_Info_day.log; day steht für den Tag im Jahr. Suche in der tatsächlichen Ablage nach den passenden Tagesdateien.
log/Logdatei.txt und log/Messagedatei.txt im Programmordner	Hinweise zu Programmablauf und Meldungen.

Eine Datei in log_tmp ist kein fertiges erfolgreiches Übergabeergebnis. Das Handbuch beschreibt zunächst Status Error und erst nach erfolgreicher Wandlung die Ausgabe mit OK im regulären Log. refresh und unbekannte Nichtbilder sind ausdrücklich Ausnahmen von der regulären Info-Datei.

Für eine Weitergabe an den Betreiber notiere Eingangszeit, Kunde, genaue Eingangsrolle, betroffenen Ausgang, beobachtetes Ergebnis und die dazugehörige Fehlermeldung. Ergänze Programm-/Photoshop-Angaben nur so, wie sie tatsächlich angezeigt werden. Gib keine Passwörter und keine unbereinigten globalen Konfigurationsdateien weiter. Verlasse dich nicht auf eine erwartete Fehlermail: Der Versand kann mit no:: deaktiviert sein.

Details: Fehlerlogs · Info-Datei · errorFolder.

Quellen

Herstellerhandbuch ImageConvert, Stand 09.10.2026, ImageConvert-4.pdf: gedruckte S. 1–3 und 6–9 (PDF-S. 5–7 und 10–13), S. 10, 17–18 und 22–26 (PDF-S. 14, 21–22 und 26–30), S. 42–49 (PDF-S. 46–53), FAQ S. 65–68 (PDF-S. 69–72), History S. 69 (PDF-S. 73). Sicherung und begrenzte Einzeländerungen sind redaktionelle Vorsichtsmaßnahmen. Zur Einschränkung von refresh: vorliegender Programmquelltext IC/Form1.cs, Zeilen 3958 ff. und 7323–7329, sowie die getrennt beschriebenen Bestandsbefunde auf IN-07. Daraus wird keine feste Ausgabemenge für jede Installation abgeleitet.