Stammdaten

• 1: Wertelisten aus Business Central übernehmen
• 2: Verkäufer aus Business Central übernehmen
• 3: Produkte deaktivieren

flowchart LR
  subgraph S["Stammdaten · 110 – 190"]
    A["Länder"]
    B["Sprachen"]
    C["Anreden"]
    D["Rabattgruppen"]
    E["Verkäufer"]
    F["Organisationsebenen"]
  end
  subgraph B1["Belegketten · ab 220"]
    G["Firma"]
    H["Kontakt"]
    I["Verkaufschance"]
    J["Angebot"]
  end
  S ==>|"Kürzel werden zu<br/>Verknüpfungen"| B1

{
  "KeyType": "CustomKey",
  "KeyName": "wysa_bcsystemidkey",
  "KeyValues": [
    { "keyName": "wysa_bcsystemid", "attributeName": "id", "rank": 1 }
  ]
}

1 - Wertelisten aus Business Central übernehmen

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)

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.

Sprachen

Job languagesfrombc (115) · Zieltabelle Sprache (wysa_language)

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)

Gebraucht wird die Liste für das Feld Anrede (BC) am Kontakt.

Debitorrabattgruppen

Job customerdiscountgroupsfrombc (125) · Zieltabelle Debitorrabattgruppe (BC) (wysa_bccustomerdiscountgroup)

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)

Gebraucht wird die Liste für das Feld Position (BC) am Kontakt und am Lead — die Entscheidungsebene eines Ansprechpartners.

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:

2 - Verkäufer aus Business Central übernehmen

Was passiert hier?

Business Central kennt Verkäufer als Kürzel — MM, SK, LB. Dieser Abgleich holt sie nach Customer Engagement, damit die Belegketten aus dem Kürzel eine echte Verknüpfung machen können.

Der Verkäufer ist die meistgenutzte Werteliste der Integration: Er wird an Firma, Kontakt, Verkaufschance und Angebot aufgelöst — und bei Firma und Kontakt sogar in beide Richtungen.

Die E-Mail-Adresse ist mehr als ein Datenfeld

Neben Kürzel und Bezeichnung überträgt dieser Abgleich die E-Mail-Adresse des Verkäufers. Sie ist der Schlüssel zu einer Automatik in Customer Engagement: Über die E-Mail-Adresse wird der BC-Verkäufer dem passenden CRM-Benutzer zugeordnet.

flowchart LR
  A["Verkäufer in BC<br/>Code + E-Mail"] --> B["Verkäufer (BC) in CE"]
  B -->|"Zuordnung über<br/>die E-Mail-Adresse"| C["CRM-Benutzer<br/>oder Team"]
  C --> D["Besitzer von Firma,<br/>Kontakt, Verkaufschance"]

Das ist der Grund, warum dieser Abgleich fachlich mehr Gewicht hat als die übrigen Wertelisten: Aus ihm folgt, wem ein Datensatz in CE gehört. Beschrieben ist die Automatik unter Stammdaten und Anzeige.

Welche Felder kommen an?

Die E-Mail-Adresse landet im Feld wysa_emailaddress. An diesem Feld hängt die automatische Benutzerzuordnung, siehe Datenmodell.

Die Telefonnummer wird nicht übertragen

Das Feld Telefon am Verkäufer (BC) ist nicht Teil dieses Mappings. Es kann in CE gepflegt werden und wird vom Abgleich nicht überschrieben.

Gelöschte Verkäufer bleiben stehen

Wie bei allen Wertelisten gibt es keine Löschverarbeitung. Ein in Business Central gelöschter Verkäufer bleibt in CE bestehen und weiterhin auswählbar.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → salespersonsfrombc.

3 - Produkte deaktivieren

Was passiert hier?

Wird in Business Central ein Artikel gelöscht, wird das zugehörige Produkt in Customer Engagement deaktiviert — es bleibt erhalten und wird nur inaktiv gesetzt.

Der Weg führt über das Änderungsprotokoll von BC, weil ein gelöschter Artikel in der normalen Schnittstelle nicht mehr auftaucht. Wiedererkannt wird das Produkt über die BC System-ID.

flowchart LR
  A["Artikel in BC gelöscht"] --> B["Eintrag im<br/>Änderungsprotokoll"]
  B --> C["Produkt in CE über die<br/>BC System-ID gefunden"]
  C --> D["Produkt wird <b>deaktiviert</b>"]

Damit folgt das Produkt dem Muster von Firma und Kontakt: deaktivieren, nicht löschen. An einem Produkt hängen Angebotspositionen und Verkaufschancenpositionen — ein hartes Löschen würde diese Historie zerstören.

Was sich am Produkt ändert

Artikel werden nicht übernommen

Artikel aus Business Central werden nicht nach Customer Engagement übertragen. Die Produkttabelle wird ausschließlich über die Kalkulationselemente aus BC (190) gefüllt; alles andere ist manuell erfasst. Dieser Schritt betrifft deshalb nur Produkte, die eine BC System-ID aus der Artikeltabelle tragen — in der Praxis also keine manuell erfassten Produkte und keine Kalkulationselemente.

Worauf zu achten ist

Reaktivieren erfolgt in CE

Ein in CE deaktiviertes Produkt wird vom Abgleich nicht wieder aktiviert. Soll es weiter verwendet werden, wird es in CE manuell reaktiviert.

Deaktivierte Produkte in bestehenden Positionen

Ein inaktives Produkt bleibt in bereits erfassten Verkaufschancen- und Angebotspositionen verknüpft. Es lässt sich nur nicht mehr neu auswählen. Das ist der Zweck des Deaktivierens gegenüber dem Löschen.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → productsfrombcdelete.