Wertelisten aus Business Central übernehmen
Themen:
| Richtung | Business Central → Customer Engagement |
| Wann | alle 2 Minuten |
| Betrifft | fünf Wertelisten, je ein eigener Abgleich |
| Technisch | Jobs countriesfrombc (110), languagesfrombc (115), salutationsfrombc (120), customerdiscountgroupsfrombc (125), positionsfrombc (135) |
Der sechste Wertelisten-Abgleich, der Verkäufer (130), hat wegen einer Besonderheit eine eigene Seite.
Was passiert hier?
Jeder dieser fünf Abgleiche holt eine Werteliste aus Business Central nach Customer Engagement — Kürzel und Bezeichnung. Danach kann die Integration in den Belegketten aus einem BC-Kürzel eine echte Verknüpfung machen.
Alle fünf sind gleich aufgebaut: Sie kommen mit drei bis vier Feldern aus, erkennen Einträge über die BC System-ID, laufen im Zwei-Minuten-Takt und übertragen nur, was sich seit dem letzten Lauf geändert hat. Es gibt keinen Rückweg und keine Löschverarbeitung.
Länder
Job countriesfrombc (110) · Zieltabelle Land (wysa_country)
| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Name | Name |
| ISO-Code | ISO 3166-1 alpha-2 |
Die einzige Werteliste mit einem vierten Feld: Neben dem BC-Kürzel kommt der ISO-Code mit. Damit lassen sich Länder in CE auch dort korrekt darstellen, wo eine normierte Kennung gebraucht wird — etwa in Serienbriefen oder Exporten.
Gebraucht wird die Liste für das Feld Land an Firma, Kontakt und Lead.
Dieser Abgleich hat als einziger einen zusätzlichen Filter: Länder ohne Kürzel werden nicht übertragen. Ein Ländereintrag ohne Code wäre in CE nutzlos, weil die Zuordnung aus den Belegen genau über dieses Kürzel läuft.
Sprachen
Job languagesfrombc (115) · Zieltabelle Sprache (wysa_language)
| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Name | Name |
Gebraucht wird die Liste für das Feld Sprache am Kontakt und am Lead — und darüber hinaus für die Anredebildung: Anredevorlagen und Titel hängen jeweils an einer Sprache.
Anreden
Job salutationsfrombc (120) · Zieltabelle Anrede (BC) (wysa_bcsalutation)
| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | Code |
| Beschreibung | Name |
Gebraucht wird die Liste für das Feld Anrede (BC) am Kontakt.
Die Lösung kennt zwei verschiedene Anrede-Konzepte:
- Anrede (BC) (
wysa_bcsalutation) — der Anredeschlüssel aus Business Central, den dieser Abgleich liefert. Er geht mit dem Kontakt nach BC zurück. - Anredevorlage (
wysa_salutation) — die Regeln, aus denen CE formelle, informelle und persönliche Anredetexte erzeugt. Reine CE-Stammdaten, kein Abgleich.
Beide sind unabhängig voneinander zu pflegen. Siehe Anrede, Titel und Sprache.
Debitorrabattgruppen
Job customerdiscountgroupsfrombc (125) · Zieltabelle Debitorrabattgruppe (BC)
(wysa_bccustomerdiscountgroup)
| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Beschreibung | Name |
Gebraucht wird die Liste für das Feld Debitorrabattgruppe an der Firma. Dieses Feld gehört zu denen, die nur aus BC kommen und nie zurückgeschrieben werden — siehe Firma.
Organisationsebenen
Job positionsfrombc (135) · Zieltabelle Position (BC) (wysa_bcposition)
| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | Code |
| Beschreibung | Name |
Gebraucht wird die Liste für das Feld Position (BC) am Kontakt und am Lead — die Entscheidungsebene eines Ansprechpartners.
Am Kontakt gibt es Position (Standardfeld, freier Text, die Funktion) und Position (BC) (Verweis auf diese Werteliste). Sie laufen sogar in entgegengesetzte Richtungen — siehe Kontakt.
Worauf zu achten ist
Gelöschte Einträge bleiben in CE stehen
Keiner dieser Abgleiche hat eine Löschverarbeitung. Wird eine Anrede oder ein Land in Business Central gelöscht, bleibt der Eintrag in Customer Engagement bestehen und weiterhin auswählbar. Bei Firma, Kontakt und Produkt gibt es dafür eigene Löschjobs — bei den Wertelisten nicht.
Änderungen am Kürzel sind unkritisch
Weil die Zuordnung über die BC System-ID läuft und nicht über das Kürzel, überlebt ein Eintrag eine Umbenennung in BC: Beim nächsten Lauf wird derselbe CE-Datensatz gefunden und sein Codefeld aktualisiert.
Die Belegketten lösen allerdings über das Kürzel auf. Wird ein Code in BC geändert, zeigen bestehende CE-Datensätze also weiter auf den richtigen Eintrag — neue Belege aus BC bringen aber das neue Kürzel mit, das nach dem Wertelisten-Abgleich ebenfalls stimmt. Weil die Wertelisten vor den Belegen laufen, greift das innerhalb desselben Durchlaufs.
Zwei Schreibweisen für das Codefeld
Länder, Sprachen und Debitorrabattgruppen legen das Kürzel in wysa_bccode ab, Anreden
und Organisationsebenen in wysa_code. Die Lookups in den Belegketten berücksichtigen
das — siehe Stammdaten.
Technische Details
Die vollständigen technischen Mapping-Tabellen mit Feldzuordnungen, Key-Auflösung und Transformationen stehen auf den technischen Seiten der einzelnen Jobs:
| Werteliste | Technische Seite |
|---|---|
| Länder | Technisches Mapping → countriesfrombc |
| Sprachen | Technisches Mapping → languagesfrombc |
| Anreden | Technisches Mapping → salutationsfrombc |
| Debitorrabattgruppen | Technisches Mapping → customerdiscountgroupsfrombc |
| Organisationsebenen | Technisches Mapping → positionsfrombc |