Zum Inhalt

ACT-01 – Aktionen/Skripte für alle Bilder eines Kunden vor oder nach Verarbeitung

Was macht die Funktion?

Kundenweite Listen ersparen das Wiederholen derselben Nachbearbeitung an jedem Ausgang. Eine Photoshop-Aktion wird mit ihrem Aktionsnamen und der Aktionsgruppe aufgerufen. Ein Skript wird als Datei auf dem gerade aktiven Photoshop-Dokument ausgeführt. Das ist keine Video- oder Nichtbildbearbeitung.

Wo wird sie konfiguriert?

Im Wurzelobjekt der Kunden-JSON, neben name. Die Gruppe für DoAction kommt aus diesem Kundennamen; es gibt hier kein frei ergänzbares JSON-Feld from zur individuellen Setauswahl.

Feld Form / Wert Dokumentierte Aufgabe und Sourcegrenze
customerActions[] Liste exakter Aktionsnamen Nachbearbeitung auf Kundenebene; tatsächlich auch im frühen ApplyActions(0) verwendet
customerActionsVor[] Liste exakter Aktionsnamen Vorbearbeitung laut Handbuch; wird gelesen, aber kein ausführender DoAction-Verbraucher dieser Liste im untersuchten Source belegt
customerScripts[] Liste vorhandener Dateinamen mit .js/.jsx Kundenweiter Skriptaufruf über ApplyScripts
customerScriptsVor[] Liste vorhandener Dateinamen Früher Skriptaufruf über ApplyScriptsVor, außerdem vor einzelnen Printstufen aufrufbar

Je Liste werden maximal zehn zusammenhängende Einträge ab Index 0 übernommen. [] beauftragt keine Aufrufe. Die Listenreihenfolge bestimmt innerhalb eines durchlaufenen Handlers die Reihenfolge; aus der Feldreihenfolge folgt keine gemeinsame Reihenfolge aller Aktionen und Skripte.

Voraussetzungen und Vorgehen

  1. Prüfe in Photoshop den exakten Aktionsnamen und die Gruppe. Ein vorhandenes .atn auf der Festplatte ist noch keine in Photoshop geladene, vollständig auflösbare Aktion.
  2. Prüfe bei Skripten die tatsächliche Datei unter js im Programmverzeichnis und ihre Wirkung auf das aktive Dokument. Siehe ACT-05.
  3. Wähle die Kundenebene nur, wenn alle betroffenen Ausgaben die Bearbeitung benötigen. Für einen einzelnen Webausgang ist ACT-03 meist enger.
  4. Prüfe alle überlappenden Listen auf Doppelbelegung. Kunden-, Typ- und Ausgangsebene sind keine gegenseitigen Overrides.
  5. Sichere die Konfiguration und übernimm Änderungen nach Konfiguration bearbeiten. Kontrolliere am Ergebnis die beabsichtigte Wirkung sowie unverändert gewünschte Merkmale.

Beispiel

Rootfragment einer vorhandenen Kunden-JSON, keine vollständige Startkonfiguration:

{
  "customerActions": [],
  "customerActionsVor": [],
  "customerScripts": ["Pfade-entfernen.js"],
  "customerScriptsVor": []
}

Pfade-entfernen.js existiert im geprüften Ressourcenbestand. Sein Inhalt activeDocument.pathItems.removeAll(); entfernt sämtliche Pfade des aktiven Dokuments, nicht nur den Beschneidungspfad. Das Beispiel ist nur geeignet, wenn diese breite Wirkung gewünscht und die Datei in der Installation vorhanden ist. Es ist kein Downloadangebot und kein unschädlicher Musteraufruf.

Ablauf und Grenzen

Das Handbuch nennt Kundenebene → Print-/Webebene → Ausgangsebene. Der gelesene Source ruft jedoch bereits vor der Ausgabe ApplyActions(0) auf; dieser Handler verwendet customerActions statt customerActionsVor. Spätere Ausgangsaufrufe können die Kundenaktion erneut anwenden. Ein nicht idempotenter Effekt kann sich dadurch summieren. Die Vorlisten von Aktionen sind nicht allein durch ihr Einlesen als wirksam belegt; Skriptvorlisten haben einen eigenen Handler. Keine einheitliche „einmal vorher / einmal nachher“-Garantie ableiten.

Aktionsname, Gruppe und benötigte externe Aktionen müssen zusammenpassen. Bei der vorhandenen Ressource Kunde.atn wurde das Set Kunde 1 mit logo_grau, ausgeblendete loeschen, sichtbare auf eine Ebene und hintergrundebene loeschen strukturell identifiziert. Das ist kein Photoshop-Lade- oder Wirkungsnachweis. Externe DefaultActions-Referenzen sind nicht automatisch durch ähnlich benannte Einträge im Set aufgelöst. Eingebaute Photoshop-Befehle und Referenzen einer gespeicherten Aktion sind ebenfalls nicht dasselbe.

Verifizierter Projektstand

Für eine sichtbare Aktionswirkung wurde am 23.10.2026 ein Prüfvertrag zugelassen, der keinen exakten Calltrace verlangt. Ein solcher Vertrag ist noch kein ausgeführter Lauf. Selbst eine bestätigte idempotente Grau-/Deckkraftwirkung würde weder den Nachzeitpunkt noch den Ausschluss eines zusätzlichen frühen Aufrufs beweisen. Diese Seite behauptet deshalb keinen aktuellen allgemeinen Aktions-PASS.

Quellen und Einordnung

ImageConvert-4.pdf, 09.10.2026, PDF-S. 33–34 (gedruckt 29–30). IC/Form1.cs 561–568, 1652–1682, 2080–2095, 2173–2192, 2268–2287, 3950–3953; Quellstand. Original Pfade-entfernen.js, Zeile 1. Ressourcenidentität: bestehender ATN-Strukturbefund coordinator/user-resources-20261011/ATN_FORMAT_EVIDENCE.md; methodische Entscheidung 23.10.2026 ist kein Laufbefund.

Weiter: Typweite Listen · Einzelner Ausgang · Zuordnungsanleitung · Aktionen und Skripte.