Technisches Mapping

• 1: 110 · countriesfrombc
• 2: 115 · languagesfrombc
• 3: 120 · salutationsfrombc
• 4: 125 · customerdiscountgroupsfrombc
• 5: 130 · salespersonsfrombc
• 6: 135 · positionsfrombc
• 7: 190 · opportunityelementsfrombc
• 8: 220 · accountsnewfromce
• 9: 221 · accountsresponsefrombc
• 10: 240 · contactsnewfromce
• 11: 241 · contactsresponsefrombc
• 12: 260 · opportunitiesnewfromce
• 13: 261 · opportunitiesresponsefrombc
• 14: 410 · accountsfrombc
• 15: 420 · accountsfrombcdelete
• 16: 430 · contactsfrombc
• 17: 440 · contactsfrombcdelete
• 18: 450 · productsfrombcdelete
• 19: 520 · accountupdatesfromce
• 20: 530 · contactupdatesfromce
• 21: 550 · serviceobjectsfrombc
• 22: 560 · servicecommitmentsfrombc
• 23: 610 · salesquotesfrombc
• 24: 620 · salescalculationelementsfrombc
• 25: 621 · salescalculationelementsfrombcdelete
• 26: 625 · activatesalesquotesfrombc
• 27: 690 · salesquotesfrombcdelete
• 28: 710 · opportunityproductsnewfromce
• 29: 750 · opportunityproductsupdatesfromce
• 30: 760 · opportunityproductsresponsefrombc

1 - 110 · countriesfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Wertelisten-Jobs

Alle fünf Wertelisten-Jobs (countriesfrombc, languagesfrombc, salutationsfrombc, customerdiscountgroupsfrombc, positionsfrombc) teilen dieselbe Konfiguration — Zeitplan, Quell- und Zielverbindung, Watermark und Basisfilter — und unterscheiden sich nur in Quelltabelle, Zieltabelle und Filter-Zusatz:

countriesfrombc ist der einzige der fünf Jobs mit einem Filter-Zusatz (code ne ''). Keines der fünf Mappings enthält eine Transformation.

Auflösung in den Belegketten

wysa_country wird über wysa_bccode aufgelöst — in Firma und Kontakt, je in beide Richtungen. Die BC→CE-Auflösung verwendet die Operation Lookup über den Alternate Key wysa_bccodekey, die CE→BC-Auflösung die Operation LookupValue mit UseCache: true.

2 - 115 · languagesfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Wertelisten-Jobs

Alle fünf Wertelisten-Jobs (countriesfrombc, languagesfrombc, salutationsfrombc, customerdiscountgroupsfrombc, positionsfrombc) teilen dieselbe Konfiguration — Zeitplan, Quell- und Zielverbindung, Watermark und Basisfilter — und unterscheiden sich nur in Quelltabelle, Zieltabelle und Filter-Zusatz:

Keines der fünf Mappings enthält eine Transformation.

Auflösung in den Belegketten

wysa_language wird über wysa_bccode aufgelöst — am Kontakt, in beide Richtungen. Die BC→CE-Auflösung verwendet die Operation Lookup über den Alternate Key wysa_bccodekey, die CE→BC-Auflösung die Operation LookupValue mit UseCache: true.

3 - 120 · salutationsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Wertelisten-Jobs

Alle fünf Wertelisten-Jobs (countriesfrombc, languagesfrombc, salutationsfrombc, customerdiscountgroupsfrombc, positionsfrombc) teilen dieselbe Konfiguration — Zeitplan, Quell- und Zielverbindung, Watermark und Basisfilter — und unterscheiden sich nur in Quelltabelle, Zieltabelle und Filter-Zusatz:

Keines der fünf Mappings enthält eine Transformation.

Auflösung in den Belegketten

wysa_bcsalutation wird über wysa_code aufgelöst — am Kontakt, in beide Richtungen. Die BC→CE-Auflösung verwendet die Operation Lookup über den Alternate Key wysa_bccodekey, die CE→BC-Auflösung die Operation LookupValue mit UseCache: true.

4 - 125 · customerdiscountgroupsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Wertelisten-Jobs

Alle fünf Wertelisten-Jobs (countriesfrombc, languagesfrombc, salutationsfrombc, customerdiscountgroupsfrombc, positionsfrombc) teilen dieselbe Konfiguration — Zeitplan, Quell- und Zielverbindung, Watermark und Basisfilter — und unterscheiden sich nur in Quelltabelle, Zieltabelle und Filter-Zusatz:

Keines der fünf Mappings enthält eine Transformation.

Auflösung in den Belegketten

wysa_bccustomerdiscountgroup wird über wysa_bccode aufgelöst — an der Firma, nur BC → CE, über die Operation Lookup mit dem Alternate Key wysa_bccodekey. Dieses Feld gehört zu denen, die nur aus BC kommen und nie zurückgeschrieben werden.

5 - 130 · salespersonsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Auflösung in den Belegketten

Das Nachschlagefeld ist stets wysa_code, nicht wysa_bccode:

Beobachtungen

Auffällig ist, dass BCContacts den Verkäufer nicht aus BC abholt, obwohl beide CE→BC-Mappings des Kontakts ihn senden.

6 - 135 · positionsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Wertelisten-Jobs

Alle fünf Wertelisten-Jobs (countriesfrombc, languagesfrombc, salutationsfrombc, customerdiscountgroupsfrombc, positionsfrombc) teilen dieselbe Konfiguration — Zeitplan, Quell- und Zielverbindung, Watermark und Basisfilter — und unterscheiden sich nur in Quelltabelle, Zieltabelle und Filter-Zusatz:

Keines der fünf Mappings enthält eine Transformation.

Auflösung in den Belegketten

wysa_bcposition wird über wysa_code aufgelöst — am Kontakt und am Lead, nur BC → CE, über die Operation Lookup mit dem Alternate Key wysa_bccodekey.

7 - 190 · opportunityelementsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bccode",
  "keyValues": [
    {
      "attributeName": "code",
      "keyName": "wysa_bccode",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Drei Vorgabewerte ohne Quellfeld:

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "946e49c5-b59d-41c6-b47a-da4ecbfa95fc" }
  }]
}

Die beiden GUIDs existieren nur in der Umgebung, für die das Mapping angelegt wurde, und müssen bei jedem Umgebungswechsel angepasst werden.

Beobachtungen

• Das Watermark-Feld heißt hier systemModifiedAt, nicht lastModifiedDateTime wie in den übrigen BC→CE-Jobs.
• Abweichend von den übrigen Mappings steht in keyName der Feldname wysa_bccode, nicht der Name eines Alternate Key wie wysa_bccodekey.

8 - 220 · accountsnewfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Filter",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "dataverseId",
      "rank": 1
    }
  ],
  "keyAttributeFromExisting": "id",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Filter im Detail

{
  "Operations": [
    { "Name": "IsNull", "Parameters": { "SourceField": "wysa_bcsystemid" } },
    { "Name": "OptionSetValue",
      "Parameters": { "SourceField": "wysa_sync2bc", "Value": 799840000 } }
  ]
}

Transformationen im Detail

Land (_wysa_address1_countryid → countryRegionCode) — Umkehrung des Lookups aus accountsfrombc: Die Dataverse-Referenz wird über das Feld wysa_bccode der Werteliste wysa_country zum BC-Code aufgelöst. UseCache: true sorgt dafür, dass die Werteliste je Lauf nur einmal gelesen wird.

{
  "Operations": [{
    "Name": "LookupValue",
    "Parameters": {
      "LookupType": "Attribute",
      "SourceField": "wysa_address1_countryid",
      "LookupTable": "wysa_country",
      "LookupField": "wysa_bccode",
      "UseCache": true
    }
  }]
}

Verkäufer (_wysa_bcsalespersonid → salespersonCode) — identisches Muster, Nachschlagetabelle wysa_bcsalesperson, Nachschlagefeld wysa_code.

Kontaktart und Anrede — ohne Quellfeld, feste Werte Company bzw. MANDANT per DefaultValue. Da CEAccountUpdates diese Felder nicht enthält, werden sie ausschließlich bei der Neuanlage gesetzt.

Beobachtungen

Die Alternate Key auf dataverseId macht den Job wiederholbar: Läuft er zweimal, bevor der Response-Job (accountsresponsefrombc) die wysa_bcsystemid zurückgeschrieben hat, entsteht in BC keine Dublette.

9 - 221 · accountsresponsefrombc

Feldzuordnung

Alternate Key

{
  "keyType": "PrimaryKey",
  "keyName": "_accountid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Die Operation ReadFromMessage ist parameterlos. Sie weist die DataBridge an, den Wert nicht aus einer Tabelle zu lesen, sondern aus der Antwortnachricht des vorangegangenen Aufrufs (accountsnewfromce):

{ "Operations": [{ "Name": "ReadFromMessage" }] }

Möglich ist die Primärschlüssel-Auflösung, weil CEAccounts die CE-GUID im BC-Feld dataverseId mitgeschickt hat. BC gibt sie in der Antwort zurück, und ReadFromMessage liest sie von dort als _accountid aus.

Vergleich mit anderen Jobs

IsActive = false ist bei Response-Jobs kein Hinweis auf einen abgeschalteten Job. Sie laufen nicht nach eigenem Zeitplan, sondern werden vom auslösenden Job gestartet und verarbeiten dessen Antwortnachricht. Dasselbe Muster findet sich bei mehreren Job-Paaren:

10 - 240 · contactsnewfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Filter",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "dataverseId",
      "rank": 1
    }
  ],
  "keyAttributeFromExisting": "id",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Die CE-GUID wird in das BC-Feld dataverseId geschrieben; ein bereits angelegter Datensatz wird über einen Filter auf dieses Feld wiedergefunden. Das macht den Job wiederholbar, ohne Dubletten zu erzeugen.

Weitere technische Details

Transformationen im Detail

Alle fünf LookupValue-Operationen arbeiten mit LookupType: Attribute und UseCache: true und unterscheiden sich nur in Nachschlagetabelle und -feld:

Beispiel übergeordnete Firma:

{
  "Operations": [{
    "Name": "LookupValue",
    "Parameters": {
      "LookupType": "Attribute",
      "SourceField": "parentcustomerid",
      "LookupTable": "account",
      "LookupField": "wysa_bccontactnumber",
      "UseCache": true
    }
  }]
}

Kontaktart — ohne Quellfeld, fester Wert Person per DefaultValue. Da CEContactsUpdates das Feld nicht enthält, wird es ausschließlich bei der Neuanlage gesetzt.

11 - 241 · contactsresponsefrombc

Feldzuordnung

Alternate Key

{
  "keyType": "PrimaryKey",
  "keyName": "_contactid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Möglich, weil contactsnewfromce die CE-GUID im BC-Feld dataverseId mitgeschickt hat. BC gibt sie in der Antwort zurück; die Operation ReadFromMessage liest sie von dort als contactid aus.

IsActive = false ist bei diesem Job kein Hinweis auf einen abgeschalteten Job — Response-Jobs laufen nicht nach eigenem Zeitplan, sondern werden vom auslösenden Job (contactsnewfromce, Order 240, über dessen Feld ResponseJob) gestartet.

Weitere technische Details

Vergleich mit anderen Jobs

Der Länder-Lookup (countryRegionCode → wysa_address1_countryid) ist identisch zu dem in contactsfrombc: Zieltabelle wysa_country, Schlüsselfeld wysa_bccode, Alternate Key wysa_bccodekey.

Dasselbe Response-Muster (auslösender Job → Response-Job) findet sich auch bei anderen Objekten:

Beobachtungen

Der Kontakt ist der einzige Bereich, in dem die Rückmeldung mehr als die Schlüssel zurückträgt (9 Feldzuordnungen statt 2–3 bei den anderen Objekten).

12 - 260 · opportunitiesnewfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Filter",
  "keyValues": [
    {
      "attributeName": "id",
      "keyName": "dataverseId",
      "rank": 1
    }
  ],
  "keyAttributeFromExisting": "Id",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Deep Link (_URL → dynamicsSalesLink) — die Operation LinkToRecord setzt aus einer Basisadresse und der GUID des Datensatzes eine aufrufbare URL zusammen. Sie kommt in der gesamten Integration nur hier vor.

{
  "Operations": [{
    "Name": "LinkToRecord",
    "Parameters": {
      "BaseUrl": "https://dsyr-salescentral.crm4.dynamics.com/main.aspx?appid=1fb84e94-89dd-ef11-8ee9-7c1e527610c5&pagetype=entityrecord"
    }
  }]
}

Umgebungsadresse und App-ID sind fest hinterlegt.

Firma und Kontakt — beide werden über die BC Kontaktnummer des jeweiligen Datensatzes aufgelöst. Business Central kennt Firmen und Personen in derselben Kontakttabelle, deshalb ist das Nachschlagefeld in beiden Fällen dasselbe:

Alle drei mit LookupType: Attribute und UseCache: true. Beispiel Kontakt:

{
  "Operations": [{
    "Name": "LookupValue",
    "Parameters": {
      "LookupType": "Attribute",
      "SourceField": "parentcontactid",
      "LookupTable": "contact",
      "LookupField": "wysa_bccontactnumber",
      "UseCache": true
    }
  }]
}

Ist eines der beiden Nachschlagefelder leer, kann die Zuordnung nicht gebildet werden — genau das verhindert die Freigaberegel.

Beobachtungen

• keyAttributeFromExisting steht hier auf Id mit großem I, in den Mappings von Firma und Kontakt auf id. Ob das eine Rolle spielt, hängt davon ab, wie die DataBridge den Wert auswertet.

13 - 261 · opportunitiesresponsefrombc

Feldzuordnung

Alternate Key

{
  "keyType": "PrimaryKey",
  "keyName": "_opportunityid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Jobs

Dasselbe Muster (Anlage-Job löst Response-Job über ResponseJob aus, PrimaryKey über eine per ReadFromMessage zurückgelesene GUID) findet sich bei mehreren Objekten:

Beobachtungen

• IsActive = false ist bei diesem Job kein Hinweis auf einen abgeschalteten Job — Response-Jobs laufen nicht nach eigenem Zeitplan, sondern werden vom auslösenden Job gestartet und verarbeiten dessen Antwortnachricht.
• Der PrimaryKey funktioniert nur, weil CEOpportunities die CE-GUID im BC-Feld dataverseId mitgeschickt hat. BC gibt sie in der Antwort zurück; die Operation ReadFromMessage liest sie von dort als opportunityid aus.

14 - 410 · accountsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bccodekey",
  "keyValues": [
    {
      "attributeName": "number",
      "keyName": "wysa_bccontactnumber",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Voraussetzungen der Lookups — Land (countryRegionCode), Debitorrabattgruppe (customerDiscountGroup) und Verkäufer (salespersonCode) setzen voraus, dass die jeweilige Stammdatentabelle bereits gefüllt ist:

Übergeordnete Firma (companyNumber → parentaccountid) — Lookup auf account selbst, mit SetNullIfEqualsValueOfField. Der Parameter setzt die Referenz auf leer, wenn companyNumber und number identisch sind — genau der Fall, in dem sich ein BC-Firmenkontakt selbst als Unternehmen einträgt.

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "SetNullIfEqualsValueOfField": "number",
      "TargetTable": "account",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_bccodekey",
        "KeyValues": [
          { "keyName": "wysa_bccontactnumber", "attributeName": "companyNumber", "rank": 1 }
        ]
      }
    }
  }]
}

Freigabe (wysa_sync2bc) — ohne Quellfeld, fester Wert 799840000 („Ja"):

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "799840000" }
  }]
}

15 - 420 · accountsfrombcdelete

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

statecode = 1 ist der Dataverse-Standardwert für Inaktiv:

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "1" }
  }]
}

Der Statusgrund statuscode = 799840001 stammt aus dem lösungseigenen Nummernbereich ab 799840000.

Vergleich mit anderen Jobs

Das Action-Feld dieses Jobs ist leer, deshalb wird deaktiviert statt gelöscht. Die Der Positions-Job salescalculationelementsfrombcdelete trägt dagegen Action = Delete und löscht tatsächlich. salesquotesfrombcdelete hat wie dieser Job kein Action-Feld und schließt das Angebot als Storniert.

16 - 430 · contactsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bccodekey",
  "keyValues": [
    {
      "attributeName": "number",
      "keyName": "wysa_bccontactnumber",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Identisch zum Vorgehen bei der Firma.

Weitere technische Details

Transformationen im Detail

Alle fünf Lookups folgen demselben Aufbau — sie unterscheiden sich nur in Zieltabelle und Schlüsselfeld:

Beispiel Anrede:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "wysa_bcsalutation",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_bccodekey",
        "KeyValues": [
          { "keyName": "wysa_code", "attributeName": "salutationCode", "rank": 1 }
        ]
      }
    }
  }]
}

Beobachtungen

Übergeordnete Firma (companyNumber → parentcustomerid) — der Lookup zeigt auf account und löst über die BC Kontaktnummer der Firma auf. Anders als beim gleichnamigen Lookup der Firma gibt es hier kein SetNullIfEqualsValueOfField — ein Personenkontakt trägt sich nicht selbst als Unternehmen ein, der Sonderfall kann also nicht auftreten.

Freigabe (wysa_sync2bc) — fester Wert 799840000 („Ja") per DefaultValue.

17 - 440 · contactsfrombcdelete

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Jobs

Die Quelle ist die API Page acdlogentries, gefiltert auf tableId 5050 — die BC-Tabelle Kontakt, in der Firmen- und Personenkontakte gemeinsam liegen. Derselbe Filter (tableId 5050) steht auch im Firmen-Job accountsfrombcdelete (Order 420); beide Jobs lesen dieselben Protokolleinträge und sortieren sie über die Zieltabelle bzw. den Schlüssel selbst auseinander.

Das Mapping BCContactsDelete folgt derselben Struktur wie BCAccountsDelete — dieselben drei Feldzuordnungen, dieselben Werte für statecode/statuscode —, adressiert aber die Zieltabelle contact statt account.

Beobachtungen

Action ist leer konfiguriert, deshalb wird deaktiviert, nicht gelöscht. statecode = 1 ist der Dataverse-Standardwert für Inaktiv. Der Statusgrund 799840001 stammt aus dem lösungseigenen Nummernbereich ab 799840000 — siehe Wertelisten.

18 - 450 · productsfrombcdelete

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Die beiden DefaultValue-Operationen setzen den Datensatz auf inaktiv:

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "1" }
  }]
}

Anders als die Löschjobs von Firma, Kontakt und Angebot hat dieser Job keinen Zusatzfilter auf operation eq 'DELETE'. Er verarbeitet damit jeden Protokolleintrag zu dieser Tabelle — auch eine bloße Änderung — als Deaktivierung.

Vergleich mit anderen Jobs

19 - 520 · accountupdatesfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Id",
  "keyName": "wysa_bcsystemid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Filter im Detail

{
  "Operations": [
    { "Name": "NotNull", "Parameters": { "SourceField": "wysa_bcsystemid" } },
    { "Name": "OptionSetValue",
      "Parameters": { "SourceField": "wysa_sync2bc", "Value": 799840000 } }
  ]
}

Beide Lookups (countryRegionCode, salespersonCode) laufen mit LookupType: Attribute und UseCache: true.

Vergleich mit anderen Jobs

20 - 530 · contactupdatesfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Id",
  "keyName": "wysa_bcsystemid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Das Feld wysa_bcsystemid wird auf id gemappt und dient gleichzeitig als Schlüssel. Der Umweg über dataverseId entfällt.

Weitere technische Details

Vergleich mit anderen Jobs

Die fünf LookupValue-Operationen sind identisch zu denen in contactsnewfromce.

Unterschied zu contactsnewfromce (240):

21 - 550 · serviceobjectsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_numberkey",
  "keyValues": [
    {
      "attributeName": "no",
      "keyName": "wysa_number",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Vier Lookups, alle über das Feld wysa_bccontactnumber und den Alternate Key wysa_bccodekey:

Beispiel Rechnungsempfänger Firma:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "account",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_bccodekey",
        "KeyValues": [
          { "keyName": "wysa_bccontactnumber", "attributeName": "billToCompanyContactNo", "rank": 1 }
        ]
      }
    }
  }]
}

Abonnementart — ohne Quellfeld, fester Wert:

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "799840000" }
  }]
}

Der Wert 799840000 stammt aus dem lösungseigenen Nummernbereich — siehe Wertelisten.

Beobachtungen

Die Quelle liegt nicht unter singhammerITConsulting/dyce/v2.0/ wie alle übrigen Abgleiche, sondern ist die Schnittstelle der Abonnementverwaltung von Business Central selbst.

Adressiert wird über die fachliche Abonnementnummer, nicht über die BC System-ID — anders als bei den Wertelisten und anders als bei den Abonnementzeilen (servicecommitmentsfrombc).

22 - 560 · servicecommitmentsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "systemId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Abonnement (serviceObjectNo → wysa_serviceobjectid) — Lookup auf die Abonnementtabelle über die Abonnementnummer:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "wysa_bcserviceobject",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_numberkey",
        "KeyValues": [
          { "keyName": "wysa_number", "attributeName": "serviceObjectNo", "rank": 1 }
        ]
      }
    }
  }]
}

OptionMapping — übersetzt BC-Textwerte in Dataverse-Auswahlwerte. Die Operation kommt nur in diesem Mapping vor:

{
  "Operations": [{
    "Name": "OptionMapping",
    "Parameters": {
      "Mapping": [
        { "Key": "Contract", "Value": "799840000" },
        { "Key": "Sales", "Value": "799840001" }
      ]
    }
  }]
}

Bei wysa_discount sind die Zielwerte 1 und 0 — es ist ein Ja/Nein-Feld, keine lösungseigene Werteliste.

Werte, die in der Zuordnungstabelle nicht vorkommen, sind nicht abgedeckt.

Beobachtungen

Wie beim Abonnement liegt die Quelle nicht unter singhammerITConsulting/dyce/v2.0/.

Anders als das Abonnement (serviceobjectsfrombc), das über seine fachliche Nummer adressiert wird, wird diese Zeile über die BC System-ID adressiert.

23 - 610 · salesquotesfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_quotenumberkey",
  "keyValues": [
    {
      "attributeName": "number",
      "keyName": "quotenumber",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Drei Lookups, jeder über einen Alternate Key:

Verkaufschance:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "opportunity",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_bcopportunitynumberkey",
        "KeyValues": [
          { "keyName": "wysa_bcopportunitynumber", "attributeName": "opportunityNumber", "rank": 1 }
        ]
      }
    }
  }]
}

Kunde — seit der Umstellung über die Kontaktnummer (wysa_bccontactnumber) statt über die Debitorennummer:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "account",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_bccodekey",
        "KeyValues": [
          { "keyName": "wysa_bccontactnumber", "attributeName": "sellToCompanyContactNumber", "rank": 1 }
        ]
      }
    }
  }]
}

Beobachtungen

Die API Page liefert alle Verkaufsbelege; die Einschränkung auf Angebote erfolgt über documentType eq 'Quote' im Filter.

Der Schlüssel ist das Standardfeld quotenumber — die Angebotsnummer —, aufgelöst über den Alternate Key wysa_quotenumberkey. In allen anderen Bereichen wird über wysa_bcsystemid oder wysa_bccontactnumber adressiert.

24 - 620 · salescalculationelementsfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "systemId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Angebot:

{
  "Operations": [{
    "Name": "Lookup",
    "Parameters": {
      "TargetTable": "quote",
      "TargetKey": {
        "KeyType": "CustomKey",
        "KeyName": "wysa_quotenumberkey",
        "KeyValues": [
          { "keyName": "quotenumber", "attributeName": "documentNo", "rank": 1 }
        ]
      }
    }
  }]
}

Produkt — hier steht in KeyName der Feldname wysa_bccode statt eines Alternate-Key-Namens; dasselbe Muster wie in BCOpportunityElements.

Einheit:

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "946e49c5-b59d-41c6-b47a-da4ecbfa95fc" }
  }]
}

Dieselbe GUID wie defaultuomid in BCOpportunityElements.

Beobachtungen

Das Watermark-Feld heißt systemModifiedAt — wie beim Job 190, aber anders als in den übrigen BC→CE-Jobs (lastModifiedDateTime).

25 - 621 · salescalculationelementsfrombcdelete

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Beobachtungen

Das Feld Action = Delete ist der Unterschied zu den Löschjobs von Firma und Kontakt: Dort ist es leer, und das Mapping setzt stattdessen den Status auf inaktiv.

Eine einzige Zuordnung — mehr braucht ein Löschjob nicht. Der Schlüssel identifiziert den Datensatz, Action = Delete erledigt den Rest. Keine Statusfelder, keine Vorgabewerte.

26 - 625 · activatesalesquotesfrombc

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "2" }
  }]
}

statecode = 2 ist der Dataverse-Standardwert für ein Angebot im Status Gewonnen.

Das Feld operation wird unverändert in wysa_bcstatus geschrieben — durch den Filter des Jobs kann dort nur der Wert TRANSFERRED ankommen. Auf dieses Feld reagiert die Logik in Customer Engagement, die das Angebot und optional die Verkaufschance abschließt.

Beobachtungen

Anders als salesquotesfrombc, das über die Angebotsnummer adressiert, muss dieser Job über die BC System-ID gehen — das Änderungsprotokoll kennt nur diese. Voraussetzung ist also, dass der Abgleich 610 die System-ID am Angebot gefüllt hat.

27 - 690 · salesquotesfrombcdelete

Feldzuordnung

Alternate Key

{
  "keyType": "CustomKey",
  "keyName": "wysa_bcsystemidkey",
  "keyValues": [
    {
      "attributeName": "recordId",
      "keyName": "wysa_bcsystemid",
      "rank": 1
    }
  ],
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Jobs

Nur noch die Angebotspositionen werden hart gelöscht. Das Angebot selbst wird seit der Überarbeitung der Mappings nicht mehr gelöscht, sondern über zwei Festwerte auf Geschlossen / Storniert gesetzt.

Festwerte für den Status

statecode und statuscode haben kein Quellfeld (Default) und werden fest gesetzt — 3 = Geschlossen, 6 = Storniert (Standard-Statusgrund des Angebots in Dataverse):

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "3" }
  }]
}

{
  "Operations": [{
    "Name": "DefaultValue",
    "Parameters": { "DefaultValue": "6" }
  }]
}

Beobachtungen

Adressiert wird über die BC System-ID, nicht über die Angebotsnummer wie in salesquotesfrombc — das Änderungsprotokoll kennt nur die System-ID. Voraussetzung ist also, dass der Abgleich 610 sie am Angebot gefüllt hat.

28 - 710 · opportunityproductsnewfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Id",
  "keyName": "wysa_bcsystemid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Transformationen im Detail

Beide Lookups mit LookupType: Attribute:

{
  "Operations": [{
    "Name": "LookupValue",
    "Parameters": {
      "LookupType": "Attribute",
      "SourceField": "opportunityid",
      "LookupTable": "opportunity",
      "LookupField": "wysa_bcopportunitynumber",
      "UseCache": false
    }
  }, {
    "Name": "LookupValue",
    "Parameters": {
      "LookupType": "Attribute",
      "SourceField": "productid",
      "LookupTable": "product",
      "LookupField": "wysa_bccode",
      "UseCache": true
    }
  }]
}

Die beiden Lookups unterscheiden sich im Cache-Verhalten: Die Verkaufschancennummer wird ohne Cache aufgelöst (UseCache: false), der Produktcode mit Cache (UseCache: true). Genau diese beiden Auflösungen begründen die Reihenfolgeabhängigkeit: opportunity liefert die Nummer erst nach opportunitiesresponsefrombc (261), product den Code erst nach dem Abgleich in opportunityelementsfrombc (190). Beide Vorgänger laufen im Zwei-Minuten-Takt, dieser Job im Drei-Minuten-Takt.

Beobachtungen

• Das Feld wysa_bcsystemid wird auf systemId gemappt und dient als Schlüssel — obwohl der Filter des Jobs voraussetzt, dass es leer ist. Es gibt keinen dataverseId-Umweg wie bei Firma, Kontakt und Verkaufschance.
• Dieser Job schreibt den Schlüssel in das BC-Feld systemId, der Job opportunityproductsupdatesfromce in das Feld id — dieselbe API Page, zwei verschiedene Feldnamen.
• Der Filter verwendet wysa_synctobc ohne „2", abweichend vom Feldnamen wysa_sync2bc an der Verkaufschance.

29 - 750 · opportunityproductsupdatesfromce

Feldzuordnung

Alternate Key

{
  "keyType": "Id",
  "keyName": "wysa_bcsystemid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Vergleich mit anderen Jobs

Beide Lookups sind identisch zu denen in opportunityproductsnewfromce:

Beide mit LookupType: Attribute; die Verkaufschancennummer ohne Cache (UseCache: false), der Produktcode mit Cache (UseCache: true) — wie in opportunityproductsnewfromce.

Beobachtungen

• Das Feld wysa_bcsystemid wird auf id gemappt. Der Anlage-Job opportunityproductsnewfromce schreibt denselben Schlüssel in das Feld systemId derselben API Page — zwei verschiedene Zielfeldnamen für denselben Zweck.

30 - 760 · opportunityproductsresponsefrombc

Feldzuordnung

Alternate Key

{
  "keyType": "PrimaryKey",
  "keyName": "_opportunityproductid",
  "ignoreEmptySourceKey": false,
  "keyRank": 0
}

Weitere technische Details

Beobachtungen

• IsActive = false ist kein Hinweis auf einen abgeschalteten Job — Response-Jobs laufen nicht nach eigenem Zeitplan, sondern werden vom auslösenden Job (opportunityproductsnewfromce, 710) über dessen Feld ResponseJob gestartet.
• Bei Firma, Kontakt und Verkaufschance funktioniert PrimaryKey, weil das jeweilige Anlage-Mapping die CE-GUID im Feld dataverseId mitgeschickt hat und BC sie zurückgibt. Das Anlage-Mapping der Positionen (CEOpportunityProducts) enthält kein dataverseId — woraus die DataBridge hier den Primärschlüssel bezieht, geht aus der Konfiguration nicht hervor und sollte im System nachvollzogen werden.