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.

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

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

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.

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äftspartner zum Projekt wird aus dem JSON-Attribute projectParty.type in allen Fällen (Zuordnung/Neuanlage) übernommen. Es werden nur die folgenden Projektrollen verarbeitet

Anschlussnehmer
Auftraggeber
Anlagenbetreiber

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 Marktstammdatenregistert (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.