Scripte

Scripte erweitern ERP² um Abläufe, die genau auf deinen Betrieb zugeschnitten sind – etwa eine Prüfung beim Speichern eines Belegs, eine nächtliche Bereinigung oder das Erzeugen von Etiketten. Sie gehören zu deiner Installation (dem Mandanten) und werden unter Optionen → Grundeinstellungen → Scripte verwaltet.

Scripte greifen direkt in den Datenbestand ein

Ein Script kann Daten anlegen, ändern und löschen – ohne Rückfrage. Scripte schreibt und pflegt deshalb deine ERP²-Betreuung. Ändere den Inhalt eines Scripts nur, wenn du genau weißt, was es tut, und ziehe vorher eine Datensicherung.

Die Felder eines Scripts

Feld	Bedeutung
Bezeichnung	Name des Scripts in der Liste.
Kürzel	Eindeutiger Kurzname. Über das Kürzel wird das Script an anderer Stelle eingebunden, etwa in einer Belegart.
intern	Ein internes Script gehört zum Lieferumfang und lässt sich nicht löschen.
Sprache	PHP, PHP-Script im Dateisystem oder SQL.
Info	Beschreibung, was das Script tut.
Script	Der eigentliche Inhalt. Der Editor zeigt Zeilennummern an.

Die Werkzeugleiste

In einem geöffneten Script:

Schaltfläche	Wirkung
Script ausführen	Führt das Script sofort einmal aus und meldet, ob es geklappt hat.
Script kopieren	Legt eine Kopie mit der Bezeichnung „… (Kopie)" und dem Kürzel „…_kopie" an. Eine Kopie ist nie intern.
Exportieren	Speichert das Script als Datei (JSON), etwa um es in eine andere Installation zu übertragen.

In der Liste der Scripte:

Schaltfläche	Wirkung
neu anlegen (F9)	Neues Script.
Scripte planen	Legt fest, welches Script wann regelmäßig läuft – siehe Cronjobs.
Importieren	Liest eine exportierte Script-Datei (JSON) als neues Script ein.

Wann ein Script läuft

Ein Script läuft nur, wenn es irgendwo eingebunden ist:

• Von Hand über Script ausführen.
• Zeitgesteuert über Scripte planen (Cronjobs).
• Bei Belegen über den Reiter Scripte der Belegart – etwa beim Speichern einer Position oder beim Weiterführen eines Belegs.
• Bei Adressen und Artikeln über ein festes Kürzel: Gibt es ein Script mit dem Kürzel adresse_neu bzw. adresse_update, läuft es beim Anlegen bzw. Ändern einer Adresse; artikel_neu und artikel_update entsprechend bei Artikeln.

Erst kopieren, dann ändern

Soll ein bestehendes Script angepasst werden, arbeite an einer Kopie und teste sie mit Script ausführen. Erst wenn sie tut, was sie soll, tauschst du die Kürzel. So läuft im Betrieb nie ein halbfertiges Script.