Groovy Scripts nach IX25 migrieren

❌ Groovy 2.5 (funktioniert NICHT mehr)

def users = ["Max", "Anna", "Tom"]
String firstUser = users[0]  // FEHLER!

✅ Groovy 3.0 (korrekt)

def users = ["Max", "Anna", "Tom"]
String firstUser = users.get(0)  // OK
// ODER: Alternative mit getAt()
String firstUser = users.getAt(0)

❌ Groovy 2.5 (funktioniert NICHT mehr)

class OrderService {
    class OrderValidator {  // FEHLER!
        boolean validate(Order order) {
            // ...
        }
    }
}

✅ Groovy 3.0 (korrekt)

class OrderService {
    static class OrderValidator {  // OK
        boolean validate(Order order) {
            // ...
        }
    }
}

❌ Groovy 2.5 (funktioniert NICHT mehr)

def users = ["Max", "Anna", "Tom"]
users.each { println it.toUpperCase() }  // FEHLER!

✅ Groovy 3.0 (korrekt)

def users = ["Max", "Anna", "Tom"]
users.each { user -> println user.toUpperCase() }  // OK

Schritt 1: Inventarisierung (1 Tag)

Ziel: Vollständige Liste aller Groovy-Scripts + Komplexitäts-Einschätzung

Vorgehen:

1. Ordner internal/cfg/groovy/ öffnen (alle .groovy Dateien)
2. Anzahl Scripts zählen (z.B. ls -1 *.groovy | wc -l)
3. Zeilen Code pro Script (wc -l *.groovy)
4. Komplexität einschätzen: Einfach (<100 Zeilen), Medium (100-500), Komplex (500+)
5. Dependencies identifizieren (externe JARs, Intrexx APIs)

Output: Excel/CSV mit [Script-Name | Zeilen | Komplexität | Dependencies]

Zeitaufwand: 4-8h (abhängig von Anzahl Scripts)

Schritt 2: Syntax-Check mit Groovy 3.0 (0.5 Tage)

Ziel: Alle Compiler-Fehler identifizieren

Vorgehen:

1. Groovy 3.0 Compiler installieren: brew install groovysdk (macOS) oder sdk install groovy 3.0 (Linux)
2. Jeden Script kompilieren: groovyc script.groovy
3. Fehler dokumentieren (Zeile, Fehler-Typ, Meldung)
4. Fehlertypen kategorisieren (Array-Zugriff, Inner Classes, etc.)

Output: Fehler-Report [Script | Zeile | Fehler-Typ | Message]

Zeitaufwand: 2-4h (je nach Anzahl Scripts)

Schritt 3: Automatische Konvertierung (1 Tag)

Ziel: 60-70% aller Fehler automatisch beheben

Tool-Optionen:

• Groovy 3.0 Migration Tool (GitHub Community-Projekt): Behebt Array-Zugriff, Inner Classes, Package-Importe automatisch
• IntelliJ IDEA Inspection: "Analyze → Inspect Code" → Quick-Fixes für deprecated APIs
• Custom Shell-Script: Regex-basierte Batch-Konvertierung (sed/awk)

Vorgehen:

1. Migration Tool herunterladen + konfigurieren
2. Tool auf alle Scripts anwenden
3. Diff-Report generieren (vorher/nachher)
4. Änderungen reviewen (nicht alle Änderungen sind korrekt!)
5. Backup erstellen (alte Scripts aufheben)

Zeitaufwand: 4-8h (inkl. Review)

Schritt 4: Manuelle Anpassungen (2-5 Tage)

Ziel: Verbleibende 30-40% Fehler manuell beheben

Fokus: Closure-Parameter, GString-Interpolation, AST-Transformationen, Metaprogrammierung

Vorgehen:

1. Fehler-Report (Schritt 2) abarbeiten
2. Pro Fehler: Code-Stelle öffnen, verstehen, korrigieren
3. Lokale Tests (Groovy Console): Script isoliert ausführen
4. Dokumentation: Änderungen tracken (für Rollback)

Zeitaufwand: 2-4h pro Script (komplex), 0.5-1h pro Script (einfach)

Schritt 5: Unit-Tests schreiben (2 Tage)

Ziel: Jeden Script mit automatisierten Tests absichern

Framework: Spock (Groovy Testing-Framework)

Vorgehen:

1. Spock Framework installieren (Gradle/Maven Dependency)
2. Test-Klasse pro Script erstellen (ScriptNameSpec.groovy)
3. Test-Szenarien definieren: Happy Path, Edge Cases, Error Cases
4. Tests ausführen (gradle test)
5. Test-Coverage analysieren (min. 70% Ziel)

Beispiel:

class SalesforceIntegrationSpec extends Specification {
    def "should sync customers to Salesforce"() {
        given:
        def customers = [new Customer(name: "Max", email: "max@test.com")]

        when:
        def result = new SalesforceIntegration().sync(customers)

        then:
        result.success == true
        result.syncedCount == 1
    }
}

Zeitaufwand: 8-16h (je nach Anzahl Scripts)

Schritt 6: Integration-Tests (1-2 Tage)

Ziel: End-to-End-Tests in IX25 Testumgebung

Vorgehen:

1. Migrierte Scripts in IX25 Testumgebung deployen
2. Workflows manuell triggern (z.B. Urlaubsantrag, Genehmigungsprozess)
3. REST APIs aufrufen (z.B. Salesforce-Sync, Mailchimp-Integration)
4. Batch-Jobs starten (z.B. nächtliche Datenbank-Sync)
5. Output validieren: Mit Intrexx 12 Output vergleichen
6. Logs checken: Fehler, Warnings, Performance

Test-Matrix: [Script | Test-Szenario | Expected Output | Actual Output | Status (✓/✗)]

Zeitaufwand: 8-16h

Schritt 7: Go-Live + Monitoring (1 Tag)

Ziel: Sichere Produktions-Migration mit Rollback-Plan

Vorgehen:

1. Deployment-Fenster wählen: Nachts/Wochenende (geringe Last)
2. Backup erstellen: Alte Groovy 2.5 Scripts als ZIP (für Rollback)
3. Scripts deployen: Neue Groovy 3.0 Scripts nach internal/cfg/groovy/ kopieren
4. Services neu starten: Intrexx Portal Manager → Services → Restart
5. Smoke-Tests: Kritische Workflows manuell triggern (5-10 Min.)
6. 24h-Monitoring: Logs checken, Fehler-Alerts einrichten (Email/Slack)
7. Rollback-Plan: Bei kritischen Fehlern alte Scripts wiederherstellen (< 15 Min.)

Zeitaufwand: 4-8h (Deployment + 24h Monitoring)