Stammdaten

Die Wertelisten aus Business Central — Grundlage für fast jede Zuordnung in den Belegketten.

Bevor eine Firma, ein Kontakt oder ein Angebot abgeglichen werden kann, müssen die Wertelisten stimmen. Business Central schickt in seinen Belegen keine Klartexte, sondern Kürzel: DE für Deutschland, DEU für die Sprache, HERR für die Anrede, MM für den Verkäufer. Aus diesen Kürzeln macht die Integration in Customer Engagement echte Verknüpfungen — und das kann sie nur, wenn die passende Werteliste dort schon vorhanden ist.

Genau dafür gibt es die Stammdaten-Abgleiche. Sie laufen mit den Ordnungsnummern 110 – 190 und damit vor allen Belegketten.

OrderWas kommt anWird gebraucht für
110LänderFirma, Kontakt
115SprachenKontakt
120AnredenKontakt
125DebitorrabattgruppenFirma
130VerkäuferFirma, Kontakt, Verkaufschance, Angebot
135OrganisationsebenenKontakt
190KalkulationselementeVerkaufschance, Angebot
450Löschung von ProduktenProdukt

Die Kalkulationselemente sind fachlich ebenfalls ein Stammdaten-Abgleich, stehen aber bei der Verkaufschance, weil sie nur dort und im Angebot verwendet werden.

Warum die Reihenfolge zählt

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

Alle Stammdaten-Jobs laufen im selben Zwei-Minuten-Takt wie die Belegketten, aber mit niedrigerer Ordnungsnummer — sie sind innerhalb eines Durchlaufs also immer zuerst dran.

Alle Abgleiche folgen demselben Muster

Die sechs Wertelisten-Jobs sind bemerkenswert einheitlich aufgebaut:

Richtungimmer Business Central → Customer Engagement
Taktimmer alle 2 Minuten
Abgrenzungimmer über den Änderungszeitstempel lastModifiedDateTime
Erkennungsmerkmalimmer die BC System-ID
Felderdrei bis vier: System-ID, Kürzel, Bezeichnung
Löschverarbeitungkeine — in BC gelöschte Wertelisteneinträge bleiben in CE stehen

Es gibt keinen Rückweg: Wertelisten werden in Business Central gepflegt, Customer Engagement folgt. Ein in CE angelegter Ländereintrag bleibt dort und wird von keinem Job nach BC übertragen.

Zwei Namenskonventionen für dasselbe Feld

Beim Feld für das BC-Kürzel gibt es zwei Schreibweisen — je nach Werteliste:

Feld für das BC-KürzelWertelisten
wysa_bccodeLänder, Sprachen, Debitorrabattgruppen
wysa_codeAnreden, Verkäufer, Organisationsebenen

Das ist keine Kleinigkeit, denn die Belegketten müssen diese Unterscheidung mitmachen. Jeder Lookup nennt das Nachschlagefeld ausdrücklich:

Auflösung in der BelegketteNachschlagefeld
Landwysa_bccode
Sprachewysa_bccode
Debitorrabattgruppewysa_bccode
Anrede (BC)wysa_code
Verkäufer (BC)wysa_code
Position (BC)wysa_code

Was nicht abgeglichen wird

Nicht jede Tabelle des Datenmodells hat einen Abgleich. Diese hier werden von keinem aktiven Job gefüllt:

TabelleAnzeigenameZustand
wysa_bcClientMandant (BC)kein Job vorhanden — wird manuell gepflegt
wysa_bcProducerHersteller (BC)kein Abgleich — bleibt am Produkt leer
wysa_bcProductCategoryProduktkategorie (BC)kein Abgleich — bleibt am Produkt leer
productProduktkeine Artikel aus BC — nur Kalkulationselemente, siehe unten
wysa_titleTitelkein Abgleich — reine CE-Stammdaten
wysa_salutationAnredevorlagekein Abgleich — reine CE-Stammdaten

Der Mandant (BC) ist dabei der auffälligste Fall: Er wird an Firma, Kontakt, Verkaufschance und Angebot verwendet, kommt aber nicht aus Business Central. Da ihn auch kein Beleg-Mapping schreibt, bleibt das Feld an den übertragenen Datensätzen leer, wenn es nicht in CE gesetzt wird.

Die Produkttabelle wird nur teilweise gefüllt

Technische Zuordnung

Jobs und Mappings
OrderJobMappingZieltabelleFelder
110countriesfrombcBCCountrieswysa_country4
115languagesfrombcBCLanguageswysa_language3
120salutationsfrombcBCSalutationswysa_bcsalutation3
125customerdiscountgroupsfrombcBCCustomerDiscountGroupswysa_bccustomerdiscountgroup3
130salespersonsfrombcBCSalesPersonswysa_bcsalesperson, wysa_salesperson4
135positionsfrombcBCPositionswysa_bcposition3
190opportunityelementsfrombcBCOpportunityElementsproduct10
450productsfrombcdeleteBCProductsDeleteproduct3

Alle Quellen sind API Pages unter singhammerITConsulting/dyce/v2.0/; die Löschverarbeitung liest acdlogentries.

Key-Auflösung — einheitlich über die BC System-ID

Alle sechs Wertelisten-Jobs verwenden denselben Schlüssel:

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

Das unterscheidet sie von den Belegketten: Firma und Kontakt werden über die BC Kontaktnummer gefunden, das Angebot über die Angebotsnummer. Bei den Wertelisten ist der Schlüssel immer die technische System-ID — das Kürzel selbst ist nur ein Datenfeld und könnte sich in BC theoretisch ändern, ohne dass die Zuordnung verloren geht.

Ausnahme ist der Kalkulationselemente-Abgleich (190), der über den Code auflöst.


Wertelisten aus Business Central übernehmen

Länder, Sprachen, Anreden, Debitorrabattgruppen und Organisationsebenen kommen aus dem ERP nach Customer Engagement.

Verkäufer aus Business Central übernehmen

Die Verkäufer aus dem ERP kommen nach Customer Engagement und werden dort automatisch CRM-Benutzern zugeordnet.

Produkte deaktivieren

In Business Central gelöschte Artikel werden in Customer Engagement inaktiv gesetzt.