Dateibasiert übertragen - adelo® onboarding

Mit dem dateibasierten Import können Sie Daten aus verschiedenen Dateiformaten wie CSV, XML oder XML in adelo® übertragen. Diese Methode ermöglicht den Transfer großer Datenmengen in einem strukturierten Format und bietet eine einfache und effiziente Möglichkeit, Daten in das System zu importieren. adelo® stellt diese Funktionalität als Standard bereit.

Beim dateibasierten Import muss eine Importdefinition erstellt und definiert werden. In der Oberfläche der Importdefinition ordnen Sie die Spalten/Felder aus den importierten Dateien den entsprechenden Feldern in adelo® zu. Dies ermöglicht es Ihnen, die Struktur und das Format der importierten Daten an die Anforderungen von adelo® anzupassen. Darüber hinaus können Sie in dieser Oberfläche einfach und schnell Importdefinitionen erstellen und erweitern, um den Import an verschiedene Dateien, Dienstleister und Auftraggeber anzupassen.

Dateiformate

Folgende Dateiformate können in adelo® importiert werden.

CSV-Datei

Positionsbasierte Textdatei

XML-Datei

Excel-Datei

Pflichtfelder

Um die Aufträge in adelo® erfolgreich zu übertragen, sind in der oben beschriebenen Importdefinition Pflichtfelder (mit einem * gekennzeichnet) enthalten. Nur mit diesen Informationen kann eine reibungslose Bearbeitung der Aufträge in adelo® sichergestellt werden.

Importfelder

Auftrag

Der Auftrag ist das zentrale Objekt in adelo®. Er beschreibt eine zu erledigende Aufgabe, zum Beispiel das Ablesen eines Stromzählers.

Eigenschaft	Datentyp	Beschreibung	Beispiel
Eindeutiger Schlüssel*	STRING	Eine eindeutige Nummer zur Identifikation des Auftrages	4865164
Abteilung*	STRING	Werden in einer Datei Aufträge für unterschiedliche Abteilungen übergeben, muss der ExternalKey einer Abteilung, die in adelo® angelegt ist, übergeben werden. In der Importdefinition in adelo® kann auch eine Abteilung für alle Aufträge gesetzt werden.	Geraetewechsel
Auftragsart*	STRING	Werden in einer Datei Aufträge für unterschiedliche Auftragsarten übergeben, muss der ExternalKey einer Auftragsart, die in adelo® angelegt ist, übergeben werden. In der Importdefinition in adelo® kann auch eine Auftragsart für alle Aufträge gesetzt werden.	Wechsel
Auftragstyp*	STRING	Werden in einer Datei Aufträge für unterschiedliche Auftragstypen übergeben, muss der ExternalKey eines Auftragstyp, der in adelo® angelegt ist, übergeben werden. In der Importdefinition in adelo® kann auch ein Auftragstyp für alle Aufträge gesetzt werden.	Turnus
Dauer*	STRING	Es wird die Durchführungszeit pro Auftrag übergeben. In der Importdefinition in adelo® kann auch eine Dauer für alle Aufträge gesetzt werden.	00:30:00
Auftraggeber*	STRING	Werden in einer Datei Aufträge für unterschiedliche Auftraggeber übergeben, muss der ExternalKey eines Auftraggeber, der in adelo® angelegt ist, übergeben werden. In der Importdefinition in adelo® kann auch ein Auftraggeber für alle Aufträge gesetzt werden.	eNetze
MasterExternalKey*	STRING	Eine eindeutige Nummer zur Identifikation des Auftrages. Kann gleich mit dem eindeutigen Schlüssel sein.	4865164
Vorgang*	STRING	Steuert die Abarbeitung des Auftrages in der App und legt fest, was für Daten erfasst werden. Wird über die übergebene Auftragsart gesteuert.	Wechsel = ReplaceDevice
Skills*	STRING	Eignungen / Qualifikationen eines Auftrages. Der übergebene Wert muss dem ExternalKey eines angelegten Skills in adelo® entsprechen.	STROM
Solldaten Min	DATE	Übergabe eines gültigen Datum, ab wann der Auftrag ausgeführt werden soll / darf. In der Importdefinition in adelo® kann auch ein Datum für alle Aufträge gesetzt werden.	01.01.2024
Solldaten Max	DATE	Übergabe eines gültigen Datum, bis wann der Auftrag ausgeführt werden soll / darf. In der Importdefinition in adelo® kann auch ein Datum für alle Aufträge gesetzt werden.	31.12.2024

Adresse

Es handelt sich um die Adresse, an der sich die Anlage befindet.

Die Felder Strasse und Plz sind als Pflichtfelder ( * ) gekennzeichnet. Um eine gute Qualität für die Adresse in adelo® zu erhalten, sollten auch die Felder .Haus und Ort übertragen werden.

Eigenschaft	Datentyp	Beschreibung	Beispiel
Strasse*	STRING	Strasse an der sich die Anlage befindet	Paderborner Str.
Plz*	STRING	Postleitzahl an der sich die Anlage befindet	33104
Haus	STRING	Hausnummer an der sich die Anlage befindet	60
Haus2	STRING	Zusätze für die Hausnummer	A
Ort	STRING	Ort an der sich die Anlage befindet	Paderborn
Ortsteil	STRING	Ortsteil an der sich die Anlage befindet	Schloss Neuhaus
Land	STRING	Land in dem sich die Anlage befindet. In der Importdefinition in adelo® kann auch ein Land für alle Aufträge gesetzt werden.	DEU
Longitude	DOUBLE	Übergabe des Längengrades Falls bekannt.
Latitude	DOUBLE	Übergabe des Breitengrades Falls bekannt.

Gerät

Falls Sie Aufträge bearbeiten, für die es ein Bestandsgerät gibt (z.B. Zählerausbau, Zählerwechsel) müssen Geräteinformationen übergeben werden. Es sind mindestens die Gerätenummer und die Sparte erforderlich.

Eigenschaft	Datentyp	Beschreibung	Beispiel
Bauform	STRING	Die Bauform des Bestandsgeräts	eHZ+BKE-A
Bauformgruppe	STRING	übergeordnete Beschreibung der Bauform / Gruppierung der Bauform	Drehstromzähler
Gerätenummer	STRING	Die Gerätenummer des Zählers	1ISK0000001234
Externer Schlüssel	STRING	Gerätenummer des Zählers im Abrechnungssystem	1ISK0000001234
Ausleseverfahren	STRING	Methode, wie der Zählerstand ausgelesen werden soll. 0 = Manuelle Ablesung 1 = Elektronische Auslesung 2 = Funk Ablesung	Manual
Sparte	STRING	Sparte des Gerätes	Strom
Geräteart	STRING	Art des Gerätes	Zähler

Zählwerk

Zählwerksinformationen zum Bestandsgerät. Falls Ihr Gerät ein Zählwerk hat, sind mindestens eine OBIS-Kennziffer oder eine Zählwerksbeschreibung notwendig.

Eigenschaft	Datentyp	Beschreibung	Beispiel
Bezeichnung	STRING	Bezeichnung des Zählwerks	ET
Nachkommastellen	STRING	Nachkommastellen des Zählwerks	3
Vorkommastellen	STRING	Vorkommastellen des Zählwerks	7
OBIS	STRING	OBIS-Kennziffer des Geräts	1-1:1.8.0
Zählwerknummer	STRING	Nummer des Zählwerks	1
Einheit	STRING	Einheit des Zählwerks	kWh

Validierungsinformationen

Die Validierungsinfomationen dienen dazu, am Zählwerk erwartete Zählerstände zu hinterlegen. Diese werden dann für eine Plasibilitätsprüfung bei einer Ablesung verwendet.

Eigenschaft	Datentyp	Beschreibung	Beispiel
Minimales Datum	DATE	Übergabe eines gültigen Datum, ab wann der Auftrag ausgeführt werden soll / darf. In der Importdefinition in adelo® kann auch ein Datum für alle Aufträge gesetzt werden.	01.01.2024
Maximales Datum	DATE	Übergabe eines gültigen Datum, bis wann der Auftrag ausgeführt werden soll / darf. In der Importdefinition in adelo® kann auch ein Datum für alle Aufträge gesetzt werden.	31.12.2024
Minimaler Zählerstand	STRING	Es wird der minimal zu erreichende Zählerstand des Zählwerks übergeben.	1000
Maximaler Zählerstand	STRING	Es wird der maximal zu erreichende Zählerstand des Zählwerks übergeben.	2000

Auftragsinformation

Eigenschaft	Datentyp	Beschreibung
Date	STRING
Info	STRING
Verwendung	STRING	Die Verwendung des Geräts (Unspezifisch, Einbaugerät, Ausbaugerät,)
Type	STRING	Sperrung, Wiederinbetriebnahme und Sperrkontrolle

Gerätestandort

Eigenschaft	Datentyp	Beschreibung	Beispiel
Standortzusatz	STRING	Der Standortzusatz des Geräts	Dritte Tür rechts
Latitude	STRING	Übergabe des Breitengrades
Longitude	STRING	Übergabe des Längengrades
Standort	STRING	Der Standort des Geräts	Keller

Termin

Eigenschaft	Datentyp	Beschreibung	Beispiel
Termin.Von	STRING	Terminzeitfenster Von	12.06.2024 10:00
Termin.Bis	STRING	Terminzeitfenster Bis	12.06.2024 16:00

Login

Eigenschaft	Datentyp	Beschreibung	Beispiel
Login	STRING	Login Benutzer für das ConsumerPortal
Passwort	STRING	Passwort für das ConsumerPortal

Geschäftspartner

Eigenschaft	Datentyp	Beschreibung
E – Mail	STRING
ExternalKey	STRING
Vorname	STRING
Nachname	STRING
Haus	STRING
Haus2	STRING
Land	STRING
Mobilnummer	STRING
Telefonnummer	STRING
Ort	STRING
PLZ	STRING
Postfach	STRING
Straße	STRING
Titel	STRING
Typ	STRING	Der Typ des Geschäftspartners (Standard, Abweichender Rechnungsempfänger, Abweichender Mahnempfänger, Geschäftspartner, Eigentümer)