Dieses Dokumentation beschreibt, wie du dein bestehendes epilot-Portal auf das neue Spark-Design migrierst – inklusive aller Schritte, die nach der automatischen Migration manuell geprüft werden sollten.

1. Einführung

Seit einigen Monaten stellen wir euch ein neues Portal-Design zur Verfügung: die Spark-Portale. Diese lösen die bisherigen klassischen Portale ab und bieten eine modernere Benutzerführung, erweiterte Konfigurationsmöglichkeiten sowie eine bessere Performance.

Dieser Leitfaden erklärt:

• wie der Migrationsprozess abläuft
• wie du Spark sicher parallel zum Produktiv-Portal testen kannst
• welche Konfigurationen nach der Migration überprüft werden müssen
• welche bekannten Unterschiede zwischen altem und neuem Design bestehen
• wie du Support erhältst

2. Migrationsprozess im Überblick

Es gibt zwei Wege, wie die Migration zu Spark durchgeführt werden kann:

Die Migration zu Spark ist kein einmaliger, unwiderruflicher Schritt. Du kannst Spark im Portal Builder jederzeit aktivieren und wieder deaktivieren – so oft du möchtest. Das gibt dir die Freiheit, in deinem eigenen Tempo vorzugehen.

2.1 Wo soll ich die Migration durchführen?

Es gibt zwei Ausgangssituationen:

Du hast eine Sandbox, die auf dem gleichen Stand wie dein Produktiv-Portal ist → Führe die Migration und alle nachgelagerten Konfigurationen zuerst in der Sandbox durch. So kannst du alles uneingeschränkt testen, bevor du dein Live-Portal umstellst.

Du hast keine Sandbox (oder sie ist nicht aktuell) → Du kannst die Migration direkt im Produktiv-Portal durchführen. Die Migration selbst dauert nur wenige Sekunden. Danach hast du zwei Möglichkeiten:

2.2 Wie funktioniert der Migrations-Button? Schaltet das System direkt auf die neue Portal Welt?

Im Portal Builder findest du den Migrations-Schalter in den Einstellungen.

 Beim erstmaligen Aktivieren erscheint ein Dialog mit zwei Optionen:

Speichern und was Endkunden sehen sind zwei verschiedene Dinge!

Entscheidend ist immer, welches Design beim Speichern aktiv ist:

• Spark aktiv + Speichern → Endkunden sehen das neue Spark-Portal
• Altes Design aktiv + Speichern → Endkunden sehen wieder das alte Portal
• Deine Spark-Konfiguration bleibt dabei immer erhalten – egal wie oft du hin- und herwechselst.

Bitte schaue dir das folgende Video an, in welchem wir dir live zeigen, wie du das neue Portal im Hintergrund konfigurieren kannst, ohne dein aktuelles Live-Portal zu beeinflussen.

2.3 Blueprint als Sicherung erstellen

Bevor du die Migration startest, exportiere deinen aktuellen Portal-Stand als Blueprint. Das gibt dir eine Sicherungskopie – einen Wiederherstellungspunkt für den Fall, dass du nach der Migration zu einem früheren Zustand zurückkehren möchtest.

So erstellst du die Sicherung:

1. Gehe in epilot zu dem Bereich “Blueprints”. 
2. Klicke oben rechts auf “Neu erstellen” und wähle dann das entsprechende Portal aus.
3. Exportiere das Portal als Blueprint und speichere die Datei sicher ab. Danach kannst du diese wieder direkt importieren, sodass dieses in deiner Organisation als "
4. Führe die Konfiguration anschließend in deiner Sandbox-Umgebung durch – oder, falls keine Sandbox verfügbar oder nicht auf aktuellem Stand, direkt im Produktiv-Portal mit aktiviertem Wartungsmodus.

3. Schritt-für-Schritt: Migration selbst durchführen

Schritt 1 – Blueprint als Sicherung exportieren (optional) & Umgebung vorbereiten

Exportiere deinen aktuellen Portal-Stand als Blueprint. Das gibt dir einen Wiederherstellungspunkt, falls du nach der Migration zu einem früheren Stand zurückmöchtest. Beachte: Widgets auf der Startseite sind im Blueprint nicht enthalten (siehe Abschnitt 2.3).

Danach kannst du entscheiden, wo du die Migration durchführst (siehe Abschnitt 2.1):

• Sandbox verfügbar? → Starte dort.
• Kein Sandbox, du möchtest Endkunden während der Konfiguration sperren? → Aktiviere den Wartungsmodus in den Portal-Einstellungen.
• Kein Sandbox, Wartungsmodus nicht nötig? → Weiter mit Schritt 2. Beachte, dass Zwischenspeicherungen sofort live gehen.

Schritt 2 – Migration starten

Navigiere im Portal Builder zu deinem Portal und aktiviere das neue Portal Design. Wähle beim ersten Mal „Aktivieren & Migrieren". Die automatische Migration überträgt deine Konfiguration in das Spark-Format – Blöcke, Externe Links und Journey Actions werden dabei automatisch konvertiert.

Schritt 3 – Konfigurationen prüfen

Gehe jede Seite deines Portals durch und überprüfe die in Abschnitt 4 beschriebenen Punkte. Nutze das Attention Center im Portal Builder als Ausgangspunkt – es zeigt dir direkt, welche Konfigurationen nach der Migration Aufmerksamkeit benötigen.

Schritt 4 – Änderungen speichern

Erst wenn du auf „Speichern" klickst, werden alle Änderungen dauerhaft übernommen. Bis dahin kannst du jederzeit zurückgehen, ohne dass Endkunden Auswirkungen spüren. Das Live-Portal wird so lange nicht beeinflusst. 

Schritt 5 – Wartungsmodus deaktivieren (falls aktiviert)

Sobald du mit der Konfiguration zufrieden bist und gespeichert hast, deaktiviere den Wartungsmodus, damit dein Portal wieder für Endkunden erreichbar ist.

4. Konfigurationen nach der Migration prüfen

Nach der automatischen Migration solltest du folgende Bereiche manuell überprüfen. Nutze dafür das Attention Center im Portal Builder: Es listet nach der Migration zentral alle Konfigurationsprobleme auf und zeigt dir direkt, was Aufmerksamkeit braucht – du musst nicht mehr manuell jede Seite einzeln durchsuchen.

Wir arbeiten gerade intensiv an einer komplett neuen Dokumentation zu den neuen Portalen für dich. Eine erste Durchführung mit den wichtigsten Portalkonfigurationen findest du hier: Neues Portaldesign

4.1 Logo

Das Logo wird nicht automatisch migriert. Du musst es manuell hochladen.

• Wo: Auf einer beliebigen Seite im Portal → Globale Konfiguration
• Du kannst ein Logo für den Light-Mode und eines für den Dark-Mode hinterlegen.

4.2 Öffentliche Seiten (Login & Registrierung)

Im neuen Spark-Design gibt es einige strukturelle Unterschiede:

4.3 Startseite

4.4 Dokumentenseite

Die Dokumentenseite wird in der Regel korrekt migriert.

• Empfehlung: Aktiviere die Suche nach Dokumententitel in den Blockeinstellungen– dieser sollte als Standard eingeschaltet sein.

4.5 Anfragen-Seite (Requests)

4.6 „Mein Konto" / Persönliche Daten

Der Bereich „Mein Konto" nutzt im neuen Design einen einheitlichen Entitäts-Attribute-Block. In dem neuen Design findest du diese Informationen unter “Mein Konto” - “Kontaktdetails” Prüfe:

• Werden alle relevanten Felder angezeigt (z. B. Kontaktdaten, Adresse, Konzessions-Gruppe)?
• Wenn bestimmte Feldgruppen auf separaten Tabs angezeigt werden sollen: Lege zusätzliche Tabs mithilfe der Registerkarten an und weise die Feldgruppen entsprechend zu.

4.7 Auftrags- und Opportunity-Details

Die Detailseiten werden in der Regel korrekt migriert. Typischer Aufbau nach der Migration:

• Titelzeile mit Auftragsnummer und Status
• Workflow-Übersicht (aktuelle Aufgabe wird hervorgehoben)
• Attribute (Entitäts-Attributes-Block)
• Dokumente (falls vorhanden)

5. Mögliche Probleme & Lösungen

6. Checkliste: Empfohlene Vorgehensweise

Vorbereitung

• Sandbox verfügbar? Wenn ja: Migration dort zuerst durchführen.
• Kein Sandbox? Wartungsmodus im Produktiv-Portal aktivieren.
• Blueprint exportieren als Sicherung (Wiederherstellungspunkt vor der Migration).

Migration

• Im Portal Builder: Spark aktivieren und „Aktivieren & Migrieren" wählen (nur beim ersten Mal).

Prüfung nach Migration

• Hinweisbereich geöffnet und alle gemeldeten Probleme geprüft?
• Logo hochgeladen? (Portal-Einstellungen → Globale Konfiguration)
• Öffentliche Seiten (Login, Registrierung) geprüft?
• Startseite: Blöcke, Teasers, Externe Links, Journey Actions und Reihenfolge korrekt?
• Startseite: Metering-Block vorhanden?
• Dokumentenseite: Suche aktiviert?
• Anfragen-Seite: Anzeige-Attribute und Suche konfiguriert?
• Mein Konto: Alle Felder sichtbar?
• Auftragsdetails geprüft?

Abschluss

• Änderungen gespeichert?
• Wartungsmodus deaktiviert (falls aktiviert)?

7. Support & Unterstützung

Hinweis zur automatischen Zwangsmigration

In Zukunft ist geplant, alle noch nicht migrierten Portale auf Spark umzustellen. Kunden werden rechtzeitig informiert.

Anhang: Kurzreferenz – Was migriert automatisch?