Import Marktpartnerdaten
Voraussetzungen
Die Modul-Lizenz EVI-BASIS liegt im System vor.
Der Prozess wird ausgeliefert und ist aktiv.
Die globale Variable "C12EnetImportPath" muss auf den entsprechenden Pfad gesetzt werden, wenn ein regelmäßiger Import erfolgen soll.
Zusätzlich ist der Timer C12ImportEnetMarketPartnerList zu konfigurieren und aktivieren
Technische Dokumentation
Komponentenübersicht
Prozesse
C12ImportEnetMarketPartnerList
Beim Einspielen des Moduls werden die Prozesse automatisch veröffentlicht, dennoch ist eine Prüfung des Veröffentlichungsstatus empfehlenswert. Entsprechende Hinweise werden auch beim Import des Moduls ausgegeben.
Skriptbibliothek
SC12EnergyMarketUtils
Globale Variablen
C12EnetImportPath
Timer
C12ImportEnetMarketPartnerList
Administrationsmöglichkeiten
Administration über globale Variablen:
Globale Variable | Beschreibung |
---|---|
C12EnetImportPath | Pfad für den Import der ene't Serviceprovider-Liste |
Übersteuerungsmöglichkeiten
Grundsätzlich können die mit dem Modul bereitgestellten Komponenten wie BPM-Prozesse, -teilprozesse, Suchen und Skriptbibliotheksmethoden übersteuert werden, um diese an individuelle Anforderungen und Bedürfnisse anzupassen.
Nach dem Einspielen eines Moduls sollte geprüft werden, ob bereits Methoden im Projekt übersteuert wurden und ob die Methodenänderung aus dem Standard im Projekt übernommen werden sollte.
Skriptklasse | Methodenname | Funktionalität |
---|---|---|
SC12EnetUtils | importMarketPartnerFile | Import die Marktpartner-Datei vom Pfad aus der globalen Variable C12EnetImportPath. Der Dateiname muss "Marktpartnerimport.xslx" lauten. Die Datei wird als Dokument in EVI hinterlegt. |
isMarketPartnerImportFileAvailable | Prüft, ob eine Marktpartner-Datei verfügbar ist. | |
isValidMarketPartnerImportFile | Prüft die Datei auf Korrektheit der Struktur. Diese Methode muss angepasst werden, wenn die Marktpartner-Datei nicht dem Standard-Mapping entspricht. | |
createOrUpdateMarketPartnersFromList | Für jeden Eintrag in der importierten Datei wird nun ein bestehender Marktpartner in der Entität C12SERVPROV aktualisiert oder ein neuer Datensatz inklusive Geschäftspartner angelegt. Diese Methode muss angepasst werden, wenn die Marktpartner-Datei nicht dem Standard-Mapping entspricht. | |
getServiceProviderEntry | Erzeugt einen IContainer C12SERVPROV, der für die Neuanlage oder Aktualisierung verwendet werden soll. Diese Methode kann übersteuert werden, wenn ein anderes Feldmapping verwendet werden soll. | |
SC12EnergyMarketUtils | createOrUpdateServiceProvider | Legt einen Serviceprovider inklusive Geschäftspartner an oder aktualisiert einen bestehenden Serviceprovider |
Interner Ablauf
Skriptklasse | Methodenname | Funktionalität |
---|---|---|
SC12EnetUtils | importMarketPartnerFile | Import die Marktpartner-Datei vom Pfad aus der globalen Variable C12EnetImportPath. Der Dateiname muss "Marktpartnerimport.xslx" lauten. Die Datei wird als Dokument in EVI hinterlegt. |
createOrUpdateMarketPartnersFromList | Für jeden Eintrag in der importierten Datei wird nun ein bestehender Marktpartner in der Entität C12SERVPROV aktualisiert oder ein neuer Datensatz inklusive Geschäftspartner angelegt. |
Technische Ablaufbeschreibung
→ Für diese Funktion wurde der BPM-Prozess "C12ImportEnetMarketPartnerList" implementiert. Dieser ist per Prozess-Lasche in myEVI oder per Timer startbar.
Importmöglichkeiten
Timer
Über die globale Variable C12EnetImportPath wird der Ablageort für die Importdatei hinterlegt. Diese Datei wird, wenn vorhanden, für den Import verwendet.
myEVI
Es öffnet sich eine Maske zum Dokumentenimport. Der Anwender hat nun die Möglichkeit, die Importdatei zu übergeben. Diese Datei wird als Dokumentendatensatz in der Anwendung hinterlegt.
Prozessablauf
Der Prozess überprüft, ob es sich bei der übergebenen oder vom Importpfad eingelesenen Datei um eine Marktpartnerimportdatei handelt. Hierfür werden die Überschriften der Datei geprüft. Passen diese zur Vorgabe, kann der Import beginnen.
Der Prozess liest die Datei zeilenweise ein und extrahiert die enthaltenen Werte.
Hieraus wird dann spezifisch für den ene't-Import ein IContainer "Serviceprovider" erstellt und mit den entsprechenden Daten gefüllt. Dieser IContainer ist noch nicht persistent. Nach dem Einlesen aller Daten werden die erstellten IContainer an die Methode
SC12EnergyMarketUtils.createOrUpdateServiceProvider
übergeben. Diese Methode prüft anhand der BDEW-Nummer und/oder des GLN-/ILN-Codes, ob der Serviceprovider bereits vorhanden ist. In diesem Fall wird er mit den übergebenen Daten aktualisiert. Falls nicht, wird er neu angelegt.Da ein Serviceprovider eine Verknüpfung zu einem Geschäftspartner besitzt, wird dieser ebenfalls angelegt oder aktualisiert. Hierfür werden der Name und die Adresse als identifizierendes Merkmal verwendet