ACT-05 – JavaScript anstelle einer Photoshop-Aktion ausführen¶

Was macht die Funktion?¶

ImageConvert kann JavaScript-Dateien in Photoshop ausführen. Statt eines Aktionsnamens enthält die Konfiguration den Namen einer vorhandenen .js- oder .jsx-Datei. Die Datei arbeitet auf dem aktiven Dokument; ihre Wirkung kann deutlich weiter reichen als ein einzelner Exportparameter.

Wo wird sie konfiguriert?¶

Gewünschter Scope	Tatsächlich gelesene Skriptlisten	Besonderheit
Kunde	`customerScripts`, `customerScriptsVor`	Kundenweite Reichweite; mehrere Aufrufphasen möglich
Eingang	`mainFolder.inbox.subFolder[].scripts`, `scriptsVor`	Eingangsbindung und Nachaufruf nicht als zuverlässig qualifiziert; ACT-04
Print	`mainFolder.print.subFolder[].scripts`, `scriptsVor`	Slot 1 speist zusätzlich globale Printlisten; ACT-02
Web-global	`mainFolder.web.scripts`, `scriptsVor`	Typweite Listen, tatsächliche Phase getrennt prüfen
Webausgang	`mainFolder.web.subFolder[].scripts`, `scriptsVor`	Nachhandler belegt; Vorwirkung nicht allein aus dem Reader zusagen

Listenwerte sind Dateinamen einschließlich Endung. Maximal zehn zusammenhängende Einträge werden übernommen. [] beauftragt keinen Skriptaufruf. Fehlend, null und leere Listen sind in der Feldreferenz nach dem Readerweg beschrieben; daraus folgt keine Startgarantie für eine insgesamt unvollständige Kunden-JSON.

Die Source bildet den Dateipfad als Application.StartupPath + js\ + Listenwert. In die Liste gehört daher beispielsweise Pfade-entfernen.js, nicht ein JavaScript-Programmtext. Verwende keine erfundenen Paketpfade oder eine beliebige externe URL.

Voraussetzungen und Vorgehen¶

Prüfe den realen Dateinamen und Inhalt des freigegebenen Skripts. Ein Name allein belegt weder Lieferung noch sichere Wirkung.
Stelle sicher, dass die Datei im js-Unterordner der tatsächlich verwendeten Installation liegt. Eine Projektkopie ist dort nicht automatisch installiert.
Wähle den engsten passenden Scope. Lies die Grenzen von Kundenebene, Ausgangsebene und Eingangsbindung, bevor du Vor-/Nachlisten überträgst.
Sichere die Konfiguration und das Eingangsbild. Prüfe nach abgestimmter Übernahme das konkrete Merkmal im geeigneten Ausgabeformat.
Bei ausbleibender Wirkung zuerst Dateiname, Ablage und erreichten Scope prüfen. Ein fehlendes Skript kann je Handler nur übersprungen oder protokolliert werden; ein unauffälliger Endstatus ist kein Wirkungsnachweis.

Beispiel und tatsächlich vorhandene Skripte¶

Fragment eines vorhandenen Webausgangs:

{
  "scripts": ["Pfade-entfernen.js"],
  "scriptsVor": []
}

Das real vorhandene Skript enthält:

activeDocument.pathItems.removeAll();

Es entfernt alle Pfade, nicht nur den gerade gesetzten Beschneidungspfad. Es enthält keine eigene Speicherung. Das Ergebnis hängt daher zusätzlich davon ab, welches Dokument aktiv ist und wie ImageConvert danach speichert.

Im lokalen Originalbestand gefunden	Direkt gelesene Aufgabe	Nicht daraus ableiten
`Pfade-entfernen.js`	Sämtliche `pathItems` des aktiven Dokuments entfernen	Nur ein bestimmter Pfad werde entfernt; Archive würden ebenfalls geändert
`Weiss_beschneiden.jsx`	Eckfarben prüfen und bei rein weißer Ecke mit `trim` beschneiden; Farbaufnehmer entfernen, Maßeinheit zurücksetzen	Ein nichtdestruktiver Test oder genereller Transparenztrim
`artboards.jsx`	Zeichenflächengruppen rekursiv erkennen und Anzahl als String zurückgeben	Zeichenflächenexport oder eine neue Bildausgabe

Diese Dateien sind im Projektbestand nachgewiesen. Die Seite stellt keinen Download bereit und behauptet nicht, dass sie Teil jeder Distribution sind. Das im Handbuch genannte Alle_Sichtbaren_Ebene_reduzieren.js wird hier nur als Herstellerbeispiel eingeordnet, nicht als nachgewiesen lieferbare Datei.

Ein Bild per Skriptpaar bearbeiten¶

Für einen gezielten Eingangsauftrag gibt es den separaten .script-Paarmechanismus: name.ext.script enthält Bildbytes, name.txt.script den Skriptdateinamen. Der beobachtete Auftrag Pfade-entfernen.js lief auf diesem Weg nach dem Öffnen. Das ist kein Nachweis derselben Phase für eine Ausgangsliste und kein Anlass, die Endung .script an eine JSON-Liste anzuhängen.

Verifizierter Projektstand¶

Am 27.08.2026 wurde die Pfadentfernung per Skriptpaar an geeigneten PSD-/TIFF-Ergebnissen bestätigt. Die Wiederholung mit Buildanzeige 20260915 bestätigte entfernten Beschneidungspfad bei erhaltenen vier Ebenen und Status OK; unveränderte Archivdateien waren davon zu unterscheiden. Der Abschlussbericht zu 20261009 führt den 4B-Skriptfall ebenfalls positiv. Diese Laufbefunde gelten für den geprüften Skriptpaarweg, nicht pauschal für alle JSON-Scopes oder deren Aufrufreihenfolge.

Feldlinks und Quellen¶

Kunde: scripts · scriptsVor.

Eingang: scripts · scriptsVor. Historische Rootanker scripts · scriptsVor sind keine gelesenen Rootfelder.

Print: scripts · scriptsVor. Historische globale Anker scripts · scriptsVor erklären die Slot-1-Abweichung.

Web-global: scripts · scriptsVor. Webausgang: scripts · scriptsVor.

Hersteller: ImageConvert-4.pdf, 09.10.2026, PDF-S. 10 und 34 (gedruckt 6 und 30). IC/Form1.cs 183, 2173–2363, 3698–3728, 3951–3972; Quellstand. Originaldateien im vorhandenen Ressourcenbestand coordinator/user-resources-20261011/originals/: Pfade-entfernen.js Zeile 1, Weiss_beschneiden.jsx 1–38, artboards.jsx 1–34. Historische Laufquellen: test-runs/full-minitest-20260915/RUN_LOG.md, Fortsetzung 4B, und docs/ABSCHLUSS_MINITEST_BUILD_20261009.md.

Weiter: Zuordnungsanleitung · Fehlerdiagnose · Aktionen und Skripte.