BusinessPartner [draft]
Einsatz des Datenobjekts
Das BusinessPartner-Objekt bündelt in Pimcore alle relevanten Stammdaten zu Unternehmen und Personen (Kunden, Lieferanten, Händler, Ansprechpartner sowie interne Mitarbeiter) – inklusive der SAP-Partnerrollen, Login-Typen und Beziehungen.
Die Daten werden aus SAP S/4HANA repliziert und über Ereignisse synchron gehalten. In Pimcore erfolgt die objektseitige Zuordnung anhand Partner-Typ (Organisation/Person) und Geschäftspartnerrollen.
Aufbau des Datenobjekts
https://pimcore-qa.motorex.com/admin/login/deeplink?object_807278_folder
Datenreplikation Pimcore
In Pimcore werden alle Geschäftspartner – also Ansprechpartner, Auftraggeber, Warenempfänger sowie Händler und Distributoren – über das gemeinsame SAP-Objekt BPARTNER repliziert. Ein Geschäftspartner kann dabei mehreren Rollen gleichzeitig zugeordnet sein, zum Beispiel als Auftraggeber und Händler. Diese Rollen steuern in der Eingangsverarbeitung die korrekte Zuordnung zu den entsprechenden Objekten in Pimcore. Die Geschäftspartner werden in Pimcore gespiegelt, allerdings in zwei unterschiedliche Objekttypen unterteilt:
User Account
Das User Account-Objekt bündelt in Pimcore alle Daten, die für die Verwaltung von Ansprechpartnern (Kontakten) und deren Login/Portal-Nutzung relevant sind.
Ein SAP-Ansprechpartner (BPARTNER vom Typ Person mit entsprechender Rolle) wird in Pimcore zu einem User Account.
Business Partner
Das BusinessPartner-Objekt konzentriert sich auf die Stammdaten von Organisationen und Geschäftspartnern.
Ein SAP-Geschäftspartner, der über das Marketingattribut (Klassifikationswert „Händler“) aus SAP verfügt, wird in Pimcore als Business Partner-Objekt mit Rolle "Händler" abgebildet.
Die Datenübernahme erfolgt zunächst über einen Initial Load und wird anschliessend durch regelmässige, ereignisbasierte Updates aktuell gehalten. Pimcore pollt dazu SAP in kurzen Abständen und übernimmt alle Änderungen, die in einer Synchronisationstabelle vermerkt sind. Dabei werden ausschliesslich die für Pimcore relevanten Geschäftspartnerrollen berücksichtigt, was über Customizing gesteuert wird. Zusätzlich werden auch die zugehörigen Wertetabellen mit Schlüsseln und Bezeichnungen in regelmässigen Abständen repliziert. Bei Bedarf können Aktualisierungen gezielt in SAP angestossen oder via Pimcore nachgefordert werden.
Base Data
Sap Identifier
Zeigt die Geschäftspartner-Nummer (BPARTNER) aus SAP
Visible On Page
Statusbalken gibt an ob der Business Partner aktuell auf der Webseite bzw. den Verkaufsstellen sichtbar ist.
Geo Lookup
Statusbalken gibt an, ob die Geokoordinaten einer Adresse in Pimcore erfolgreich ermittelt, aktualisiert oder ob ein Fehler beim Geo Lookup aufgetreten ist.
Relation Data
Partner Roles
Unter Partner Roles werden sämtliche Rollen aufgeführt, die für das Objekt Business Partner in Pimcore relevant sind. Geschäftspartner, die über eines der untenstehenden Marketingattribute (aus der SAP-Klasse ZBP_COMM_ACT_CO) verfügen, werden automatisch in den Verkaufsstellen (ehem. Händler- und Distributorensuche) angezeigt. Sobald einem Geschäftspartner in SAP eines dieser Merkmale zugewiesen wird, wird diesem in Pimcore automatisch die entsprechende Partner-Rolle zugewiesen. Diese Rolle steuert nicht nur die Sichtbarkeit im Pimcore-Frontend (z. B. Händlersuche), sondern sorgt auch für die konsistente Zuordnung der Geschäftspartnerrollen zwischen SAP und Pimcore
001
Händler
ZBM004
002
Distributor
ZBM005
003
Top-Dealer
ZBM006
004
Onlinehändler
ZBM018
005
Servicepunkt
ZBM019
006
Nein
-
Partner Relations
tba
Product Lines
tba
Sales Organizations
tba
Site Domains
tba
Qualitäts-Monitoring für Business Partner
Bei Business Partnern in Pimcore wird das Data Quality Bundle eingesetzt. Es dient dazu, die Qualität und Vollständigkeit des Datenobjekts in Bezug auf die Verkaufsstellen im Frontend sicherzustellen.
Definition Score Data Quality Details
Visible On Page
A
Sichtbar
B - D
Nicht Sichtbar
Geo Lookup
A
SAP Adresse macht mit Google
B - D
SAP Adresse macht mit Google
Localized Lookup > Anfrage an Google erfolgreich oder nicht
Adress seems valid > Abgleich Google mit SAP Adresse
Partner Type > Type Organisation
Base Data
Diese Informationen werden direkt aus SAP übernommen.
Änderungen müssen nicht in Pimcore erfolgen
Geo Data
Die Maske „Geo Data“ in Pimcore dient zur Verwaltung und Anreicherung von Geoinformationen zu einem Datensatz. Die enthaltenen Felder haben dabei folgende Bedeutung:
Do not use Google services Checkbox, um festzulegen, dass für Geocoding/Geo Lookup keine Google-Dienste verwendet werden dürfen. Standardmässig werden Google-Dienste genutzt.
Dealer countries Auswahlfeld, in dem die Länder hinterlegt werden, in denen der Händler aktiv ist bzw. für die er zuständig ist.
Location (map) Visuelles Kartenfeld, das den Standort anzeigt und die direkte Platzierung oder Korrektur von Geo-Koordinaten (Latitude/Longitude) ermöglicht.
Localized address
Pimcore bekommt die Stammdatenadresse aus SAP (Strasse, PLZ, Ort, Land etc.).
Diese ist nicht immer vollständig formatiert oder nach lokalen Schreibweisen standardisiert.
Es wird ein Geo Lookup via Google gemacht
Google liefert der Geo-Dienst eine formatted address zurück. Diese ist an die landesspezifische Schreibweise angepasst (z. B. „München, Germany“ vs. „Munich, Deutschland“) und wird in das Feld Localized Address geschrieben
Anwendungsfall:
Das Geo-Lookup kann fehlschlagen, wenn sich die von SAP gelieferte Adresse zu stark von den von Google erkannten Adressdaten unterscheidet. In solchen Fällen besteht die Möglichkeit, den Google-Service zu deaktivieren. Anschliessend kann die gewünschte Adresse im „Localized Address“ Feld hinterlegt werden. Der Plus Code wird nicht benötigt.
Do not use google services —> hartverlinken von Localized Adress > Geo Lookup Score wird ausgeblendet > Adresse wird gefunden > Partner wird im FE mit hartverlinkten Adresse angezeigt > Bei Sync wird Localized Adress nicht automatisch aktualisiert
Pin auf Karte (Location) setzen
Dealer Countries immer leer > wieso? > unklar muss abgeklärt werden
Geo Debug Information
Gibt Auskunft über Fehler. Nur relevant sofern Geo Lookup failed bzw. der Partner im Frontend nicht angezeigt wird.
Additional Data
Dieser Bereich ist derzeit irrelevant und hat keine Funktion.
Last updated