Moduleinstellung, Installationsassistent und Deinstallation

Die Einstellungs-Endpunkte des Moduls, die Kriterien der Umgebungsprüfung, die sieben Schritte des Installationsassistenten, die registrierten Ereignisse und Zeitpläne und der Umfang der Deinstallation.

Die Einstellungsseite des Moduls speichert die Moduleinstellungen und führt nur für den Hauptadministrator die Umgebungsprüfung, den Installationsassistenten, die Bibliotheksinstallation, den Schema-Export und die installationsspezifischen Einstellungen aus.

Einstellungen speichern

Das Speichern schreibt das gesamte gesendete Formular über die vorhandenen Moduleinstellungen. Die NAV-Softwaredaten (URL, Software-ID, Name, Betrieb, Entwicklername, Kontakt, Steuernummer) sind Pflicht. Bedingung: Basisrecht modify auf der Einstellungsroute des Moduls.

Installationsassistent

SchrittVerhalten
checksucht blockierende Fehler mit der Umgebungsprüfung
composersynchronisiert das mitgelieferte Vendor-Verzeichnis oder führt composer install aus
schemawendet das Basisschema (install/schema/baseline.sql) mit den Seed-Tabellen an, sonst den eingebauten Installer
migratewendet die Migrationen automatisch an
defaultsStandardeinstellungen und das Zeitplaner-Geheimnis
registerEreignisse (Lader, linkes Menü, Kopfzeile), eingebaute Zeitpläne (Rechnungsabruf und Kontierung), HUF als Standardwährung, Fehlerprotokoll eingeschaltet, Startup-Einträge
finishInstallationsstatus done, Ergänzung der Routenrechte des Hauptadministrators

Kriterien der Umgebungsprüfung: PHP mindestens 8.0.0 (empfohlen 8.2.0), Framework 4.0.2.x, Speicherplatz mindestens 300 MB (empfohlen 1 GB), Bibliotheken, PHP-Erweiterungen, Programme, Netzwerk, Schema; Ergebnis als HTML-Tabelle.

Weitere Endpunkte

  • croncommand: der Kommandozeilen- (php cron.php) und der Web-Befehl (masterdata/cronqueue.run mit Geheimnis) des Zeitplaners.
  • exportschema: lädt baseline.sql herunter.
  • tenantsave: speichert oder löscht eine installationsspezifische JSON-Einstellung je Schlüssel.
  • install: Standardeinstellungen, Installationsstatus pending. uninstall: Entfernungsschritt des Modells und Löschen der eigenen Ereignisse, Zeitpläne und der beiden Startup-Einträge; Geschäftsdaten werden nicht gelöscht.

Berechtigungen

  • Assistent, Umgebungsprüfung, Bibliotheksinstallation, Cron-Befehl, Export und installationsspezifische Einstellungen: isSetupAdmin() = Basisrecht modify und user_group_id = 1.
  • install und uninstall: Basisrecht modify auf der Erweiterungsverwaltung.
  • Im Seed steht die list-Zeile des Moduls nur in der Berechtigungseingabe, ohne Einstufung.

Verwendete Daten

Die Tabellennamen tragen in der Datenbank das eigene Präfix der Installation.

setting (Modul- und installationsspezifische Einstellungen), event (Ereignisbehandler), die Zeitplaner- und die Startup-Liste des Frameworks.