🚀 EspoCRM Validator - Quick Start

Installation bereits abgeschlossen ✅

Das Validierungs-Tool ist bereits installiert und einsatzbereit!

Verwendung

# Im EspoCRM-Root-Verzeichnis
python3 custom/scripts/validate_and_rebuild.py

Das war's! Das Script führt automatisch alle Checks durch und startet den Rebuild.

Tipp: Für nur Validierung ohne Rebuild: python3 custom/scripts/validate_and_rebuild.py --dry-run

Was wird geprüft?

✅ JSON-Syntax - Alle Custom-Dateien
✅ Relationships - Bidirektionale Link-Konsistenz
✅ Formula-Scripts - Korrekte Platzierung
✅ i18n - Vollständigkeit der Übersetzungen
✅ Layouts - Struktur-Validierung
✅ Dateirechte - Owner & Permissions
✅ Rebuild - Nur bei Fehlerfreiheit

Output verstehen

Symbol	Bedeutung	Aktion
✓ Grün	OK	Keine
⚠ Gelb	Warnung	Optional beheben
✗ Rot	Fehler	Muss behoben werden!

Beispiel

$ python3 custom/scripts/validate_and_rebuild.py

EspoCRM Custom Entity Validator & Rebuild Tool
Arbeitsverzeichnis: /var/lib/docker/volumes/vmh-espocrm_espocrm/_data

======================================================================
                      1. JSON-SYNTAX VALIDIERUNG                      
======================================================================

✓ Alle 547 JSON-Dateien sind syntaktisch korrekt

======================================================================
                      2. RELATIONSHIP-KONSISTENZ                      
======================================================================

✗ 4 Relationship-Fehler gefunden:
  • CMietobjekt.vmhRumungsklages → CVmhRumungsklage: 
    Foreign link 'mietobjekte' fehlt in CVmhRumungsklage
...

✗ REBUILD ABGEBROCHEN: Kritische Fehler müssen behoben werden!

Häufige Fehler beheben

Relationship-Fehler

// In CVmhRumungsklage.json HINZUFÜGEN:
{
  "links": {
    "mietobjekte": {
      "type": "hasMany",
      "entity": "CMietobjekt",
      "foreign": "vmhRumungsklages"
    }
  }
}

JSON-Syntax-Fehler

Mit einem JSON-Validator prüfen (z.B. python3 -m json.tool datei.json)
Auf fehlende Kommata, geschweifte Klammern achten

i18n-Warnung (optional)

// In i18n/de_DE/Entity.json ERGÄNZEN:
{
  "links": {
    "meinLink": "Mein Link"
  }
}

Mehr Infos

Ausführliche Doku: custom/scripts/VALIDATOR_README.md
EspoCRM-Doku: README.md
Custom-Struktur: custom/CUSTOM_DIRECTORY.md

Troubleshooting

Python3 nicht gefunden?

sudo apt-get install python3  # Ubuntu/Debian
sudo yum install python3       # CentOS/RHEL

Keine Berechtigung?

chmod +x custom/scripts/validate_and_rebuild.py

Script findet rebuild.php nicht?

# Ins richtige Verzeichnis wechseln
cd /var/lib/docker/volumes/vmh-espocrm_espocrm/_data
python3 custom/scripts/validate_and_rebuild.py

💡 Tipp: Führe das Script nach jeder Änderung an Custom-Dateien aus!

3.0 KiB Raw Blame History