Mit dem dateibasierten Import übertragen Sie Auftragsdaten aus Formaten wie CSV, XML, Excel oder JSON strukturiert in adelo® – effizient, auch für große Datenmengen. Die Funktion ist im Standard enthalten.
Der dateibasierte Import ermöglicht den Transfer großer Datenmengen in einem strukturierten Format und bietet eine einfache, effiziente Möglichkeit, Daten in adelo® zu importieren. Diese Funktionalität stellt adelo® als Standard bereit.
Beim dateibasierten Import wird eine Importdefinition erstellt. In deren Oberfläche ordnen Sie die Spalten und Felder aus den importierten Dateien den entsprechenden Feldern in adelo® zu. So passen Sie Struktur und Format der Daten an die Anforderungen von adelo® an. Importdefinitionen lassen sich schnell erstellen und erweitern, um den Import an verschiedene Dateien, Dienstleister und Auftraggeber anzupassen.
Folgende Dateiformate können in adelo® importiert werden.
Zeichengetrennte Werte für tabellarische Auftragsdaten.
Hierarchisch strukturiertes Format für komplexe Datensätze.
Tabellenblätter aus Microsoft Excel für strukturierte Auftragsdaten.
Leichtgewichtiges, strukturiertes Format für komplexe Datensätze.
Textdatei mit fester Spaltenbreite für positionsbezogene Auftragsdaten.
Damit Aufträge in adelo® erfolgreich übertragen werden, enthält die Importdefinition Pflichtfelder – in den Feldlisten mit einem * gekennzeichnet. Nur mit diesen Informationen ist eine reibungslose Bearbeitung der Aufträge sichergestellt. Viele Pflichtwerte lassen sich in der Importdefinition auch zentral für alle Aufträge einer Datei setzen.
Eine Importdatei ist in thematische Feldgruppen gegliedert. Je nach Auftragsart und Gerät werden unterschiedliche Gruppen benötigt.
Das zentrale Objekt in adelo®, das die zu erledigende Aufgabe beschreibt – z. B. das Ablesen eines Stromzählers. Felder u. a.: Eindeutiger Schlüssel, Abteilung, Auftragsart, Auftragstyp, Dauer, Auftraggeber, MasterExternalKey, Vorgang, Skills, Solldaten Min/Max.
Die Adresse, an der sich die Anlage befindet. Pflicht sind Straße und PLZ; für gute Adressqualität sollten auch Haus und Ort übertragen werden. Optional: Haus2, Ortsteil, Land, Längen- und Breitengrad.
Bei Aufträgen mit Bestandsgerät (z. B. Zählerausbau, Zählerwechsel) erforderlich. Mindestens Gerätenummer und Sparte. Weiter: Bauform, Bauformgruppe, Externer Schlüssel, Ausleseverfahren, Geräteart.
Zählwerksinformationen zum Bestandsgerät. Bei vorhandenem Zählwerk ist mindestens eine OBIS-Kennziffer oder eine Zählwerksbeschreibung nötig. Felder: Bezeichnung, Vor-/Nachkommastellen, OBIS, Zählwerknummer, Einheit.
Hinterlegen erwarteter Zählerstände am Zählwerk für die Plausibilitätsprüfung bei einer Ablesung. Felder: minimales/maximales Datum, minimaler/maximaler Zählerstand.
Zusätzliche Informationen zum Auftrag, u. a. Sperrung, Wiederinbetriebnahme und Sperrkontrolle. Felder: Date, Info, Verwendung (Unspezifisch, Einbaugerät, Ausbaugerät), Type.
Beschreibt den Standort des Geräts. Felder: Standortzusatz (z. B. „Dritte Tür rechts“), Standort (z. B. „Keller“), Längen- und Breitengrad.
Terminzeitfenster zum Auftrag. Felder: Termin.Von und Termin.Bis, jeweils als Zeitpunkt – z. B. 12.06.2024 10:00 bis 12.06.2024 16:00.
Zugangsdaten für das Consumer Portal. Felder: Login (Benutzer) und Passwort.
Kontakt- und Adressdaten des Geschäftspartners – u. a. E-Mail, ExternalKey, Vor- und Nachname, Adresse, Telefon-/Mobilnummer sowie der Typ (Standard, Abweichender Rechnungs-/Mahnempfänger, Geschäftspartner, Eigentümer).
Zur Orientierung die wichtigsten Pflichtfelder mit Datentyp und Beispielwert.
| Eigenschaft | Datentyp | Beschreibung | Beispiel |
|---|---|---|---|
| Eindeutiger Schlüssel | STRING | Eine eindeutige Nummer zur Identifikation des Auftrages | 4865164 |
| Adresse | – | Die Adresse, an der sich die Anlage befindet. Es muss mindestens eine übergeben werden. | – |
| Auftragsart | STRING | ExternalKey der Auftragsart, die in adelo® angelegt ist. | Wechsel |
| Solldatenbereich | – | Übergabe eines gültigen Zeitbereichs, in dem der Auftrag ausgeführt werden soll / darf. | – |
| Dauer | STRING | Dauer für einen Auftrag | 00:30:00 |
Die Adresse, an der sich die Anlage befindet.
| Eigenschaft | Datentyp | Beschreibung | Beispiel |
|---|---|---|---|
| Straße | STRING | Straße, an der sich die Anlage befindet | Paderborner Str. |
| Ort | STRING | Ort, an dem sich die Anlage befindet | Paderborn |
| Postleitzahl | STRING | Postleitzahl, an der sich die Anlage befindet | 33104 |
| Ortsteil | STRING | Ortsteil, an dem sich die Anlage befindet | Schloss Neuhaus |
| Hausnummer | STRING | Hausnummer, an der sich die Anlage befindet | 60 |
| Land | STRING | 3-stelliger ISO-Ländercode | DEU |
| Longitude | DOUBLE | Übergabe des Längengrades, falls bekannt | – |
| Latitude | DOUBLE | Übergabe des Breitengrades, falls bekannt | – |
Übergabe eines gültigen Zeitbereichs, in dem der Auftrag ausgeführt werden soll / darf.
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| min | STRING | Untere Grenze des Bereichs |
| max | STRING | Obere Grenze des Bereichs |
Beispiel
{
"min": "2023-09-28T00:00:00.0Z",
"max": "2024-09-28T00:00:00.0Z"
}
Unser Team unterstützt Sie beim Aufbau Ihrer Importdefinition und bei der Feldzuordnung.