Daten mit Datastudio importieren (Beta)
Mit Datastudio importierst du eine CSV- oder Excel-Datei in mehrere Entitäten auf einmal, zum Beispiel Kontakte mit ihren Verträgen und Zählern. Du ordnest die Spalten direkt beim Import zu, setzt Beziehungen, korrigierst fehlerhafte Zeilen vor dem Import und speicherst die Zuordnung als Vorlage für die nächste Datei.
Dieser Artikel zeigt dir, wie ein Import in Datastudio abläuft und wann du ihn statt der anderen Importwege nutzt.
Beta
Datastudio befindet sich in der Beta-Phase und ist noch nicht für alle Organisationen freigeschaltet. Möchtest du es frühzeitig nutzen? Dann melde dich bei deiner Ansprechperson bei epilot, wir schalten es für deine Organisation frei. Einzelne Funktionen können sich noch ändern.
Wir freuen uns über dein Feedback: Sag uns, was dir beim Import gefehlt hat, was unklar war oder welche Datei sich nicht importieren ließ. Deine Rückmeldung bestimmt, was wir als Nächstes verbessern.
So funktioniert's
Du exportierst aus deinem Altsystem eine Datei mit einer Zeile pro Vertrag. In jeder Zeile stehen außerdem die Kundin, zum Beispiel Anna Becker mit Kundennummer und E-Mail-Adresse, und die Zählernummer. In Datastudio werden aus jeder Zeile ein Kontakt, ein Vertrag und ein Zähler, und der Vertrag erhält direkt die Beziehung zu seiner Kundin. Steht Anna Becker in drei Zeilen, entsteht trotzdem nur ein Kontakt.
Ein Import hat fünf Schritte: Datei hochladen, Entitäten wählen, Spalten zuordnen, Prüfen und Importieren. Die Datei wird in deinem Browser gelesen. Hochgeladen wird erst, wenn du den Import startest.
-
Entität: was aus einer Zeile deiner Datei wird, zum Beispiel ein Kontakt und ein Vertrag. Eine Datei kann mehrere Entitäten anlegen.
-
Eindeutige ID: das Attribut, an dem eine Entität wiedererkannt wird, zum Beispiel die Kundennummer. Zeilen mit demselben Wert aktualisieren dieselbe Entität, statt eine neue anzulegen. Das gilt auch für Entitäten, die schon in epilot sind.
-
Beziehung: die Verbindung zwischen zwei Entitäten, zum Beispiel zwischen einem Vertrag und seinem Kunden. Die andere Entität kommt aus derselben Zeile oder wird über einen Schlüssel gesucht, zum Beispiel über eine Zählernummer.
-
Vorlage: die gespeicherte Zuordnung einer Datei mit Entitäten, Spalten, Änderungen und Beziehungen. Du verwendest sie für jede weitere Datei mit demselben Aufbau.
Welcher Import passt?
| Importweg | Dafür geeignet | Artikel |
|---|---|---|
| Importieren auf der Übersichtsseite | Eine einzelne Entität, mit der Importvorlage (CSV) von der Übersichtsseite | Export und Import von Daten |
| Mit Zuordnung importieren | Wiederkehrende Dateien mit einer Zuordnung, die im Integration Hub gepflegt wird | Mehrere Entitäten mit Beziehungen importieren |
| Datastudio | Dateien aus anderen Systemen mit mehreren Entitäten und Beziehungen. Du ordnest beim Import zu, korrigierst Zeilen und speicherst das Ergebnis als Vorlage. | Dieser Artikel |
Konfiguration
Datei hochladen
1. Öffne Datastudio und klicke oben rechts auf Neuer Import oder unter Daten importieren auf Datei hochladen.
2. Ziehe deine CSV- oder Excel-Datei in den Bereich Datei hochladen oder klicke, um sie auszuwählen.
3. Hat deine Excel-Datei mehrere Tabellenblätter, wählst du unter Tabellenblatt wählen das richtige aus. Unter Wo ist die Kopfzeile? prüfst du, ob die markierte Zeile die Spaltennamen enthält. Zeilen darüber werden übersprungen.
Entitäten wählen
4. Unter Wähle, was diese Datei anlegt sind die Entitäten vorausgewählt, die zu deinen Spalten passen. Du findest sie unter Passend zu den Spalten deiner Datei, weitere unter Häufig importiert und Weitere Entitäten. Wähle alles aus, was in einer Zeile deiner Datei steht, zum Beispiel Kontakt, Vertrag und Zähler.
5. Kommt eine Entität mehrmals in einer Zeile vor, zum Beispiel ein Grundpreis und ein Arbeitspreis, klickst du auf Noch einmal hinzufügen und gibst jeder einen Namen.
6. Gibt es für diese Art von Datei schon eine Vorlage, zeigt Datastudio sie dir unter Mit einer Vorlage beginnen an. Mit Verwenden übernimmst du ihre Entitäten, Spalten und Beziehungen. Du kannst danach alles anpassen.
Tipp
Um Zählerstände zu importieren, wählst du in diesem Schritt zusätzlich Zählerstände aus. Sie werden am Zähler gespeichert. Im nächsten Schritt ordnest du die Spalten für Zähler, Ablesedatum und Zählerstand zu.
Spalten zuordnen
7. Unter Dein Import siehst du deine Datei, die Entitäten und die Beziehungen zwischen ihnen. Wähle eine Entität, um ihre Zuordnung zu sehen. Datastudio hat die Spalten anhand von Name und Werten bereits zugeordnet. Prüfe die Vorschau und ändere, was nicht passt.
8. Lege unter Erkannt über für jede Entität die eindeutige ID fest, zum Beispiel die Kundennummer für den Kontakt und die Vertragsnummer für den Vertrag.
9. Klicke auf ein Attribut, um weitere Einstellungen zu öffnen:
-
Mit weiterer Spalte kombinieren: fasst mehrere Spalten zu einem Wert zusammen, zum Beispiel Straße und Hausnummer.
-
Änderung hinzufügen: ändert die Werte vor dem Import, zum Beispiel mit Suchen und ersetzen, Rechnen (× ÷ + −) oder Überflüssige Leerzeichen entfernen. Für alles, was diese Änderungen nicht abdecken, gibt es Ausdruck (JSONata).
-
Werte zuordnen: legt bei Auswahl-Attributen fest, welcher Option ein Wert aus deiner Datei entspricht, zum Beispiel „Hr.“ der Option „Herr“.
-
Standardwert: der Wert für Zeilen, in denen die Spalte leer ist.
-
Nur setzen, wenn: setzt das Attribut nur in Zeilen, die eine Bedingung erfüllen, zum Beispiel die Modulleistung nur für PV-Anlagen.
10. Soll ein Attribut in jeder Zeile denselben Wert bekommen, klickst du in der Entität auf Attribut hinzufügen… und trägst unter Fester Wert den Wert ein.
11. Gibt es für eine Spalte noch kein Attribut, wählst du in der Attributauswahl Neues Attribut… und legst Name und Typ fest.
12. Fehlt eine Entität, ergänzt du sie über Entität hinzufügen, ohne einen Schritt zurückzugehen. Deine bisherige Zuordnung bleibt erhalten.
Wichtig
Neue Attribute werden beim Hochladen in ihrer Entität angelegt und bleiben bestehen, auch wenn du den Import danach nicht startest.
Beziehungen einrichten
13. Linien zwischen Entitäten sind Beziehungen, gestrichelte Linien sind Vorschläge. Klicke auf die Beschriftung einer Linie, um die Beziehung zu behalten oder zu ändern. Mit Beziehung hinzufügen legst du eine Beziehung an, die nicht vorgeschlagen wurde.
14. Lege fest, wie die andere Entität gefunden wird:
-
Aus derselben Zeile: die Entität, die aus derselben Zeile importiert wird, zum Beispiel der Kontakt zum Vertrag.
-
Über eine Spalte: Die Spalte enthält einen Schlüssel, zum Beispiel eine Zählernummer, der in dieser Datei oder in epilot gesucht wird. So setzt du Beziehungen zu Entitäten, die schon in epilot sind.
-
Dieselbe Entität vom Typ … in jeder Zeile: eine Entität, die schon in epilot ist, zum Beispiel die Steuer jedes Preises. Du gibst ihren Schlüssel ein.
15. Suchst du über eine Spalte, zeigt dir Datastudio sofort, wie viele Schlüssel gefunden werden. Lege fest, was passiert, wenn es zu einem Schlüssel keine Entität gibt:
-
Zeile ohne diese Beziehung importieren: Die Zeile wird importiert, die Beziehung bleibt leer. Das ist die Voreinstellung.
-
Zeile als Fehler markieren (in der Prüfung korrigieren): Die Zeile wird erst importiert, wenn du den Schlüssel korrigiert hast.
-
… nur mit diesem Schlüssel anlegen, zum Beispiel Vertrag nur mit diesem Schlüssel anlegen: Die fehlende Entität wird angelegt und enthält nur den Schlüssel.
16. Kann eine Entität mehrere Beziehungen derselben Art haben, wählst du für bestehende Beziehungen Behalten oder Ersetzen. Im Feld Rolle gibst du optional ein Label für die Beziehung an, zum Beispiel Anlagenbetreiber.
Daten prüfen
17. Unter Was aus deinen Zeilen wird siehst du, wie viele Entitäten deine Zeilen anlegen oder aktualisieren und wie viele Beziehungen sie setzen.
18. Darunter sind die Probleme nach Ursache zusammengefasst: Jede Ursache steht einmal da, mit allen Zeilen, die sie betrifft. Mit einer Entscheidung behebst du sie in allen Zeilen. Du trägst unter Korrigierter Wert den richtigen Wert ein, wählst Leer lassen, lässt die Zeilen aus oder gehst mit Zuordnung ändern zurück zum Attribut. Einzelne Werte korrigierst du direkt in der Tabelle.
19. Mit Änderungen anzeigen unter Was sich in epilot ändert vergleichst du die Zeilen mit den Datensätzen, die jetzt in epilot sind. Du siehst, was neu angelegt und was aktualisiert wird und was unverändert bleibt.
20. Klicke auf Weiter. Haben noch Zeilen Fehler, fragt dich Datastudio, ob du nur die fehlerfreien Zeilen importieren möchtest. Die übrigen Zeilen kannst du mit der Fehlerursache herunterladen, in deiner Datei korrigieren und später importieren.
Importieren
21. Unter Bereit zum Import steht, was jede Zeile anlegt oder aktualisiert. Gib unter Zuordnung speichern als einen Namen für die Vorlage ein und klicke auf Hochladen und prüfen. Bleib auf der Seite, bis die Prüfung fertig ist.
22. Im Prüfergebnis siehst du, was importiert wird. Gibt es Warnungen, setzt du den Haken bei Ich habe die Warnungen geprüft und möchte trotzdem importieren.
23. Klicke auf Import starten. Du kannst die Seite verlassen: Der Import läuft weiter, und du findest ihn unter Letzte Importe. Mit Benachrichtige mich, wenn alle Zeilen geschrieben sind bekommst du eine Nachricht per E-Mail und in epilot.
24. Nach dem Import zeigt dir Was geschrieben wurde, wie viele Entitäten angelegt oder aktualisiert wurden und wie viele unverändert geblieben sind. Fehlgeschlagene Zeilen findest du unter Warum Zeilen fehlgeschlagen sind, nach Ursache gruppiert. Mit Fehlgeschlagene Zeilen herunterladen bekommst du sie als Datei.
Wichtig
Import stoppen macht nichts rückgängig. Zeilen, die schon importiert sind, bleiben importiert.
Vorlagen wiederverwenden
Eine Vorlage entsteht, wenn du bei einem Import die Zuordnung speicherst. Du brauchst also eine Vorlage pro Art von Datei, nicht pro Import.
-
Im Reiter Vorlagen startest du mit Für einen Import verwenden einen neuen Import mit einer Vorlage. Dort kannst du sie auch Umbenennen oder Löschen.
-
Änderst du bei einem Import etwas an der Zuordnung, wählst du beim Hochladen, ob du die Vorlage aktualisierst oder die Zuordnung als neue Vorlage speicherst. Importe, die die Vorlage schon verwenden, behalten ihre Zuordnung.
-
Mit Als Datei speichern sicherst du eine Vorlage als Datei, mit Vorlage importieren lädst du sie wieder hoch.
Häufige Fragen
Legt ein erneuter Import Duplikate an?
Nein, solange die eindeutige ID stimmt. Zeilen, deren Wert es in epilot schon gibt, aktualisieren die vorhandene Entität.
Kann ich einen Zähler importieren und nur eine Beziehung zu einem bestehenden Vertrag setzen?
Ja. Importiere nur den Zähler und richte die Beziehung zum Vertrag Über eine Spalte ein. Mit Zeile ohne diese Beziehung importieren wird kein Vertrag angelegt, wenn es zu einem Schlüssel keinen Vertrag gibt.
Was passiert, wenn ich den Import unterbreche?
Datei, Zuordnung und Korrekturen bleiben in deinem Browser, bis der Import hochgeladen ist. Beim nächsten Öffnen kannst du ihn mit Fortsetzen weiterführen.
Lösen importierte Datensätze Automatisierungen aus?
Ja. Importierte Datensätze lösen Automatisierungen wie gewohnt aus.
Warum kann ich keine Beziehung zu einer Entität setzen?
Eine Beziehung findet die andere Entität über ihre eindeutige ID. Lege zuerst unter Erkannt über fest, woran die Entität erkannt wird.