4.6 Einrichtung des Data Stores "3.4.1 PW Company Map"

4.6 Einrichtung des Data Stores "3.4.1 PW Company Map"


Der Data Store 3.4.1 PW Company Map ist eine Zuordnungstabelle (Map), die zu jeder Versicherungsgesellschafts-ID aus ProfessionalWorks (PW) den zugehörigen Klarnamen der Gesellschaft speichert. Er funktioniert nach demselben Prinzip wie die anderen Resolver-Maps im System, etwa 3.2.1 PW Insurance Map oder 3.3.1 PW PaymentType Map.

Wozu wird der Data Store benötigt?

Vertragsdatensätze aus PW enthalten nur die numerische Gesellschafts-ID (insurance_company_id), nicht den Namen der Versicherungsgesellschaft. Der Name wird aber sowohl für die Anzeige im Zusammenfassungs-E-Mail als auch für die Felder vu_name_alt / gesellschaft beim Schreiben nach NWZ benötigt. Der Data Store übersetzt die ID in den Namen, ohne dass bei jedem Vertrag die komplette PW-Firmenliste abgerufen werden muss.

Folgende Felder anlegen:

Feldname
TypHinweis
Key (Text)
-Info
wird automatisch angelegt
Alert
pw_company_id
Alert
Number (Nummer)
Info
Eindeutige Gesellschafts-ID aus ProfessionalWorks (Schlüssel für Upsert und Lookup)
Alert
name
Alert
Text (Nummer)
Info
Anzeigename der Versicherungsgesellschaft im NWZ, wie von PW geliefert

Fertig angelegter Data Store „3.4.1 PW Company Map"

WarningDieser Store muss nach dem Anlegen mit den tatsächlichen Mapping-Werten befüllt werden .

Wie wird der Data Store befüllt?

Über das eigenständige Szenario 3.4.1 Populate PW Company Map. Es besteht aus zwei Modulen:
1. ListInsuranceCompanys (PW-Verbindung) – liefert alle bei PW hinterlegten Versicherungsgesellschaften in einem Rutsch, ohne Paging.
2. datastore:UpdateRecord auf 170176 – schreibt jede Gesellschaft per Upsert (Key = PW-Gesellschafts-ID) in den Data Store.


Data Store „3.4.1 PW Company Map" nach Lauf des Popuate-Szenarios

Wie oft muss das Populate-Szenario laufen?

Einmalig vor der ersten Nutzung, um den Data Store initial zu befüllen. Da PW gelegentlich neue Gesellschaften ergänzt, empfiehlt sich zusätzlich ein wöchentlicher Zeitplan, damit der Map aktuell bleibt.


Hinweis zur Wartung

Das Populate-Szenario überschreibt bestehende Einträge nicht destruktiv (Upsert).

Ein erneuter Lauf aktualisiert lediglich geänderte Namen und ergänzt neue Gesellschaften.

Welche Szenarien greifen auf den Data Store zu?

Die Sub-Szenarien 3.0.1 (Insurance Contract) und 3.0.2 (Capital Contract) lösen den Gesellschaftsnamen jeweils im Modul [23] auf. Dort steht ein datastore:SearchRecord-Modul, das nach pw_company_id = {{2.data.insurance_company_id}} filtert und das Feld name zurückgibt. Der Name fließt anschließend in insgesamt sechs Stellen pro Sub-Szenario ein: vu_name_alt / gesellschaft bei Create und Update, insurance_company in beiden ReturnData-Modulen sowie die Fehler-E-Mail-Texte.

Notes
Warum ein Data-Store-Lookup statt eines Subscenario-Aufrufs?
Ursprünglich wurde der Gesellschaftsname über einen eigenen CallSubscenario-Aufruf aufgelöst, der pro Vertrag die vollständige PW-Firmenliste abrief. Durch die Verlagerung in den Data Store 3.4.1 entfallen sowohl der Subscenario-Aufruf als auch der wiederholte Voll-Listen-Abruf. Zusammen mit der analogen Inlining-Umstellung bei Vertragstyp und PayWay wurde dadurch die Anzahl der CallSubscenario-Module je Vertrags-Sub von 6 auf 3 reduziert – ein zentraler Baustein der Performance-Optimierung, die die Sync-Zeit für einen Kunden mit 20 Verträgen von rund 13 auf rund 4 Minuten senkte.


Notes
Checkliste

Abschluss-Check: Alles bereit?

  • Data Store 1.0.1 Sync Config angelegt (2 Felder) + 1 Eintrag mit last_sync
  • Data Store 3.2.1 PW Insurance Map angelegt (4 Felder) + alle Versicherungsarten eingetragen
  • Data Store 3.2.2 PW Capital Map  angelegt (4 Felder) + alle Versicherungsarten eingetragen
  • Data Store 3.3.1 PW PaymentType Map angelegt (3 Felder) + alle Zahlungsarten eingetragen
  • Data Store 3.3.2 PW DocumentType Map angelegt (4 Felder) + alle Dokumenttypen eingetragen
    • Data Store 3.4.1 PW Company Map angelegt (2 Felder) + alle Gesellschaften eingetragen

Quote

Anhang 👇