Geschäftspartner identifizieren

Die Informationen über den Anschlussnehmer, Anlangenbetreiber und Installateur bzw. Solarteur werden über den Aufruf ag.itc.createGeneratingUnit aus dem Kundenportal an TINA übermittelt. Sie werden wie die übrigen Informationen zum Projekt in Form einer JSON-Struktur in einem Zeitereignis abgelegt und stehen dort zum Auslesen durch die Prozesse zur Verfügung.

Während die Geschäftspartner-Identifizierung zu einem Projekt in TINA noch nicht abgeschlossen ist, erhält das Portal bis zum Abschluss der Identifizierung die Informationen aus dem im Zeitereignis hinterlegten JSON (projectParties) zurück. Im Kundenportal werden somit exakt die zuvor im Portal eingebenen Informationen dargestellt.

Die automatische Identifizierung erfolgt anhand folgender Kriterien, die alle zutreffen müssen

Vorname (name2)
Nachname (name1)
E-Mail (email)

Sofern anhand der übermittelten Daten die Geschäftspartner nicht direkt eindeutig in TINA identifiziert und zugeordnet werden konnten, sind diese über einen Prozess durch die Fachabteilung zu identifizieren. Bestehende Geschäftspartner können gesucht und übernommen oder neue Geschäftspartner angelegt werden.

Feld Haupt-Geschäftspartner im Projekt

Abhängig davon, welche Projektrollen im Unterbereich vorhanden sind, wird der (Haupt-)Geschäftspartner (DefaultCustomer.Project) auf dem Projekt gesetzt.

In Kurzform gilt die folgende Logik:

Vorhandene Rollen	Haupt-Geschäftspartner
Nur Anlagenbetreiber	Anlagenbetreiber
Nur Anschlussnehmer	Anschlussnehmer
Anlagenbetreiber und Anschlussnehmer	Anlagenbetreiber

Details zum automatischen Füllen des Feldes

Der Hauptgeschäftspartner auf dem Projekt (DefaultCustomer.Project) wird automatisch befüllt

Wenn ein Geschäftspartner mit Rolle ANLAGENBETREIBER verknüpft ist, wird dieser eingetragen.
Wenn ein Geschäftspartner mit Rolle ANLAGENBETREIBER nicht vorhanden ist, wird der Geschäftspartner mit der Rolle ANSCHLUSSNEHMER eingetragen.

Ist keine der beiden Rolle vorhanden, wird der Haupt-Geschäftspartner auf dem Projekt nicht automatisch befüllt.

Die Logik reagiert ebenfalls auf das Zuordnen/Wegordnen der Geschäftspartner im Unterbereich

Wird der Geschäftspartner, der im Feld Haupt-Geschäftspartner eingetragen ist, weggeordnet, wird die obenstehende Logik erneut durchlaufen.
Wird im Unterbereich das Hauptgeschäftspartner-Flag geändert, werden die obenstehenden Logiken ignoriert und der neue Haupt-Geschäftspartner wird eingetragen (egal, welche Rolle er besitzt).
Ist bereits der Anschlussnehmer als Haupt-Geschäftspartner eingetragen und es erfolgt eine Zuordnung eines neuen Geschäftspartners als Anlagenbetreiber, wird der Hauptgeschäftspartner durch den Anlagenbetreiber ersetzt.
Ist bereits der Anlagenbetreiber als Haupt-Geschäftspartner eingetragen und es erfolgt eine weitere Zuordnung eines neuen Geschäftspartners als Anlagenbetreiber (= doppelte Rolle, vielleicht nicht fachlich, aber durchaus technisch möglich) erfolgt keine Änderung. Der bisher eingetragene Geschäftspartner bleibt im Feld erhalten.
Ist bereits der Anschlussnehmer als Haupt-Geschäftspartner eingetragen und es erfolgt eine weitere Zuordnung als Anschlussnehmer (= doppelte Rolle, vielleicht nicht fachlich aber durchaus technisch möglich) erfolgt keine Änderung. Der bisherig eingetragene Geschäftspartner bleibt im Feld erhalten.
Die obenstehenden Prüfungen beim Zu-/Wegordnen werden auch durchlaufen, wenn ein Projekt per ag.itc.generatingUnit über das Portal neu angelegt oder upgedated wird.

Technische Dokumentation

Komponentenübersicht

Prozesse

Geschäftspartner identifizieren (C14IdentifyCustomer)
- Geschäftspartner identifizieren: Geschäftspartnersuche (C14IdentifyCustomer_CustomerSearch)

Skriptklasse SC14ProjectUtils

Methodenname	Funktionalität
filterAlreadyLinkedProjectRoles	Ermittelt die bereits zugeordneten Geschäftspartner-Rollen zum Projekt in Form einer Liste, damit diese nicht noch einmal durch den Prozess behandelt werden
getEventArchiveFromProject	Ermittelt den Container des Zeitereignisses aus dem Projekt
isProjectReadyForStatusInPreparation	Ermittelt, ob für das Projekt der Status 20 gesetzt werden kann
isCustomerUnique	Ermittelt, ob die Geschäftspartneridentifizierung für das Projekt abgeschlossen ist, wird durch isProjectReadyForStatusInPreparation aufgerufen
readCustomerValuesFromGeneratingRequestJson	Ermittelt die Geschäftspartnerinformationen aus dem JSON des Zeitereignisses der Projektanlage in Form einer Liste
getEventArchiveFromPortalLog	Ermittelt den Container des Zeitereignisses aus dem Portal-Login
getInstanceInfoForIdentifyCustomer	Baut die in den Selektionstasks verwendete Instanzinformation aus den Geschäftspartnerinformationen zusammen
readCustomerValuesFromRegisterRequestJson	Ermittelt die Ansprechpartnerinformationen aus dem JSON des Zeitereignisses der Registrierung in Form eines Containers

Ablauf

Konnte einer oder mehrere Geschäftspartner bei der automatischen Erzeugung des Projekts nicht eindeutig über die E-Mailadresse identifiziert werden, wird nach dem Start des Prozesses über den Aktionsboxeintrag „Geschäftspartner identifizieren“ eine Prozess-Suchmaske ausgegeben.

Der Aktionsboxschalter ist nur aktiv, wenn das Flag „Ident. Geschäftspartner abgeschl.“ (C12IdentCuCompl.Project) false ist und man sich in der Detailansicht eines Projekts befindet, oder in der Listenansicht, wenn genau ein Projekt ausgewählt ist.

Eine unscharfe Suche über Firma/Name, Zusatz/Vorname, Ort und Straße wird automatisch angezeigt. Der Anwender muss aus der Trefferliste einen passenden Geschäftspartner auswählen.

In beiden Fällen wird ein Portal-Login neu angelegt, wenn der identifizierte Geschäftspartner noch keinen Portal-Login-Datensatz besitzt. Dieser befindet sich im Status IN PRÜFUNG. Der Geschäftspartner- und Ansprechpartner-Satz ist im Portal-Login hinterlegt.

Projektrolle zuweisen

Die Projektrolle des Geschäftspartners zum Projekt wird aus dem JSON-Attribute projectParty.type in allen Fällen (Zuordnung/Neuanlage) übernommen. Es werden nur die folgenden Projektrollen verarbeitet:

Key-Rolle	Key-Beschreibung	Anmerkung/Quelle
ANSCHLUSSNEHMER	Anschlussnehmer, Grundstückseigentümer	Wenn der Geschäftspartner als ANSCHLUSSNEHMER verknüpft ist, ist er auch automatisch ANLAGENBETREIBER + AUFTRAGGEBER + RECHNUNGSEMPFÄNGER, sofern die Projektrolle nicht separat zum Projekt hinterlegt ist. Quelle: JSON-Objekt project Attribute projectParties
ANLAGENBETREIBER	Anschlussnutzer, Anlagenbetreiber (abweichend zu Anschlussnehmer)	Wenn der ANLAGENBETREIBER zusätzlich zu ANSCHLUSSNEHMER gesetzt ist, gibt es eine zum ANSCHLUSSNEHMER abweichende Rolle ANLAGENBETREIBER. Quelle: JSON-Objekt project Attribut projectParties
AUFTRAGGEBER	Auftraggeber, Solateur (abweichend zu Anschlussnehmer)	Wenn der AUFTRAGGEBER zusätzlich zu ANSCHLUSSNEHMER gesetzt ist, gibt es eine zum ANSCHLUSSNEHMER abweichende Rolle AUFTRAGGEBER. Quelle: Wenn der Geschäftspartner aus dem aktuellen Portal-Login (CustomerPk.C12PORTALLOG) zu dem Geschäftspartner mit der Rolle ANSCHLUSSNEHMER abweichend ist, wird für diesen Geschäftspartner am Projekt die Rolle AUFTRAGGEBER verknüpft.
INSTALLATEUR	Installateur	Der Installateur bzw. Geschäftsprtner wird über das JSON-Objekt `project.installer.customerProfile.pk` ermittelt.

Weitere übergebene Projektrollen werden ignoriert.

*Abb. 1 - Geschäftspartnersuche - Für die eingegebenen Suchkriterien wurde ein Datensatz gefunden*

Sollte kein Eintrag angezeigt werden oder passend sein, kann der Prozessschritt ohne Auswahl fortgesetzt werden. Es öffnet sich die Geschäftspartner-Neuanlage. Diese ist aus den übergebenen Daten vorbelegt. Potentielle Dubletten werden hier im Unterbereich angezeigt.

Identifizierung der Geschäftspartner abgeschlossen

Wurden alle über das JSON-Attribute projectParties übergebenen Geschäftspartner eindeutig über die E-Mail identifiziert und automatisch mit der übergebenen Rolle dem Projekt zugeordnet, wird das Flag „Identifizierung Geschäftspartner abgeschlossen“ (C12IdentCuCompl.Project) auf true gesetzt. Der Aktionsboxeintrag ist dann inaktiv.

Wenn zum Zeitpunkt des Prozessabschlusses die Identifizierung des Anschlussobjektes abgeschlossen ist, wird der Status des Projekts auf 20 - In Bearbeitung gesetzt. Andernfalls verbleibt das Projekt in Status 10 - Auftrag eingegangen.

Behandlung der Kommunikationsdaten

Bei der Zuordnung eines bestehenden Geschäftspartners per ag.itc.createGeneratingUnit (egal ob dies automatisch oder manuell erfolgt) wird die Telefonnummer aus dem JSON-Objekt in jedem Fall in den Geschäftspartner bzw. dessen Standard-Telekommunikation in TINA übernommen.

Wird nur project.projectParties.customerProfile.phoneNoBase übergeben ( = phoneNoCountry, phoneNoCity und phoneNoExt sind leer) ist das Zielfeld PhoneNoBase.Telecom. Die Länder-, Ortsvorwahl und Durchwahl der bestehenden Kommunikation werden dabei geleert. Dies ist der Fall, wenn die Kommunikationsdaten aus dem Marktstammdatenregister (MaStR) übertragen wurden.

Sind die einzelnen Rufnummernbestandteile (PhoneNoCountry, phoneNoCity, phoneNoBase und phoneNoExt) im JSON des Zeitereignisses enthalten, werden die Werte jeweils in die Zielfelder auf den Kommunikationsdatensatz geschrieben. Dies ist der Fall, wenn die Daten aus dem Kundenportal übertragen wurden.

Die Telefonnummer wird demzufolge immer überschrieben. Dies muss im Projekt mit der SAP-Schnittstelle in Einklang gebracht werden.