Mandantenwechsel und gespeicherte Amparex-Setups

Diese Seite erklärt, welche WP2Amparex-Einstellungen an einen verbundenen
Amparex-Mandanten gebunden sind und was beim Wechsel der Zugangsdaten
passiert.

Status

Filial- und Beraterbilder sind seit 2.3.0 mandantenbezogen gespeichert.
Seit 2.4.0 gilt das auch fuer Terminkategorien und Terminlogik. Die
manuelle Reihenfolge von Filialen und Berater:innen wird ebenfalls
mandantenbezogen gespeichert. Wenn Ihre Installation den Abschnitt
Gespeicherte Amparex-Setups noch nicht zeigt, ist die installierte Version
noch zu alt oder der entsprechende Release wurde noch nicht eingespielt.

Warum gibt es gespeicherte Setups?

WP2Amparex kann in einer Installation mit unterschiedlichen Amparex-Zugängen
verbunden werden. Das passiert zum Beispiel:

  • auf einer internen Testinstallation;
  • bei Kund:innen mit mehreren Websites und unterschiedlichen
    Amparex-Mandanten;
  • wenn ein technischer API-Benutzer ausgetauscht wird;
  • wenn ein Mandant vorübergehend gewechselt und später wieder verbunden wird.

Ohne mandantenbezogene Speicherung würden Einstellungen wie Terminkategorien
oder Bilder beim Wechsel überschrieben oder müssten neu gepflegt werden.

Was wird pro Amparex-Setup gespeichert?

Mandantenbezogen gespeichert werden:

  • angezeigte Terminkategorien;
  • Reihenfolge der Terminkategorien;
  • interne Kategorie-Texte;
  • angezeigte Kategorie-Bezeichnungen;
  • Kategorie-Icons;
  • Tagesbeginn im Terminkalender;
  • Tagesende im Terminkalender;
  • die Option Beraterschritte deaktivieren;
  • Filialbilder;
  • Beraterbilder;
  • Reihenfolge der Filialen im Frontend;
  • Reihenfolge der Berater:innen im Frontend.

Global bleiben weiterhin:

  • Design-Grundwerte;
  • E-Mail-Texte und Signatur;
  • Lizenzstatus und Lizenzschlüssel;
  • allgemeine Plugin-Optionen;
  • Support- und Debug-Einstellungen.

Woran erkennt WP2Amparex ein Setup?

WP2Amparex bildet einen internen Mandanten-Namespace aus der Amparex-API-URL
und der stabilsten verfügbaren Mandantenkennung aus den Amparex-Filialdaten.

Der Namespace basiert bewusst nicht nur auf dem technischen API-Benutzernamen.
Wenn ein Mandant also neue technische Zugangsdaten erhält, bleiben
mandantenbezogene Einstellungen erhalten, solange weiterhin dasselbe
Amparex-System mit derselben Mandantenkennung verbunden ist.

Als Mandantenkennung werden, je nach Verfügbarkeit, unter anderem diese
Amparex-Daten berücksichtigt:

  1. Umsatzsteuer-ID (vatNumber)
  2. Handelsregisterdaten
  3. Steuernummer
  4. Buchungsmandant (bookMandator)
  5. Firmenname (name1)
  6. ID der Hauptfiliale

Verhalten beim Mandantenwechsel

Wenn ein anderer Amparex-Mandant verbunden wird:

  • WP2Amparex lädt dessen eigenes Kategorie-, Terminlogik-, Bild- und
    Reihenfolge-Setup.
  • Gibt es für diesen Mandanten noch kein Setup, starten die
    mandantenbezogenen Bereiche leer bzw. mit den normalen Fallbacks.
  • Die Einstellungen des vorherigen Mandanten bleiben gespeichert.
  • Beim Zurückwechseln auf den vorherigen Mandanten werden dessen Kategorien,
    Terminlogik, Bilder und Reihenfolgen wiederhergestellt.

Bestehende globale Kategorie-Einstellungen aus älteren Versionen werden beim
ersten erkannten Mandanten einmalig diesem Setup zugeordnet. Dadurch gehen
vorhandene Kategorie-Konfigurationen beim Update nicht verloren.

Alte Setups löschen

Im Settings Center gibt es den Abschnitt Gespeicherte Amparex-Setups.

Dort zeigt WP2Amparex:

  • den erkannten Setup-Namen;
  • ob es das aktuell aktive Setup ist;
  • den internen Namespace;
  • wie viele Kategorien, Filialbilder, Beraterbilder, Filialpositionen und
    Beraterpositionen gespeichert sind;
  • welcher Tagesbeginn, welches Tagesende und welcher Beraterschritt-Status
    zum Setup gehören;
  • wann das Setup zuletzt erkannt wurde.

Avec Setup löschen können nicht mehr benötigte Setups entfernt werden.
Vor dem Löschen fragt WP2Amparex noch einmal nach.

Gelöscht werden nur mandantenbezogene Daten dieses Setups:

  • Terminkategorien;
  • Tagesbeginn und Tagesende im Terminkalender;
  • die Option Beraterschritte deaktivieren;
  • Filialbilder;
  • Beraterbilder;
  • Filial- und Beraterreihenfolgen;
  • der Registry-Eintrag des Setups.

Nicht gelöscht werden:

  • Amparex-Zugangsdaten des aktuell gespeicherten Plugins;
  • Lizenzdaten;
  • E-Mail-Texte;
  • Design;
  • Buchungsdaten;
  • andere Mandanten-Setups.

Empfehlung für Testinstallationen

Für zentrale Testinstallationen ist der Ablauf:

  1. Mandant A verbinden.
  2. Kategorien, Terminlogik, Bilder und Reihenfolgen prüfen oder pflegen.
  3. Einstellungen speichern.
  4. Mandant B verbinden.
  5. Kategorien, Terminlogik, Bilder und Reihenfolgen für Mandant B pflegen.
  6. Zurück zu Mandant A wechseln.
  7. Prüfen, ob Kategorien, Terminlogik, Bilder und Reihenfolgen von Mandant A
    wieder erscheinen.

Wenn viele Testmandanten ausprobiert wurden, können veraltete Setups im
Abschnitt Gespeicherte Amparex-Setups aufgeräumt werden.

Technische Referenz