|
Nächste Überarbeitung
|
Vorherige Überarbeitung
|
data_importexport [2014/02/10 03:15]
nick angelegt |
data_importexport [2023/09/28 17:27] (aktuell)
smg [Beim aktualisieren eines Datensatzes] |
| ====== Daten importieren und exportieren ====== | ====== Daten importieren und exportieren ====== |
| |
| efa kann Daten im CSV- oder XML-Format exportieren und importieren, beispielsweise um diese mit einer anderen Anwendung (zum Beispiel Mitgliederverwaltung) auszutauschen. Der Import und Export erfolgt im Admin-Modus unter den jeweiligen Menüpunkten für die verschiedenen Daten (Personen, Boote, usw.) durch Klick auf die Button //Import// bzw. //Export// neben der Liste aller Personen, Boote, usw. | efa kann Daten im CSV- oder XML-Format exportieren und importieren, beispielsweise um diese mit einer anderen Anwendung (zum Beispiel Mitgliederverwaltung) auszutauschen. Der Import und Export erfolgt im Admin-Modus unter den jeweiligen Menüpunkten für die verschiedenen Daten (Personen, Boote, usw.) durch Klick auf die Button //Import// bzw. //Export// neben der Liste aller Personen, Boote, usw. Falls der Export oder Import automatisiert werden soll, kann er auch über die [[access_cli|efaCLI - Kommandoschnittstelle]] gestartet werden. |
| |
| ===== Daten exportieren ===== | ===== Daten exportieren ===== |
| |
| Beim Exportieren von Daten kann angegeben werden, ob alle Datensätze, nur selektierte Datensätze, oder alle derzeit angezeigten (gefilterten) Datensätze exportiert werden sollen. Für versionierte Daten erfolt die Ausgabe zum angegebenen Gültigkeitszeitpunkt, d.h. es wird nur die zu diesem Zeitpunkt gültige Version exportiert. Der Export erfolgt wahlweise im XML- oder CSV-Format. Falls die Daten in ein Tabellenkalkulationsprogramm (z.B. Excel) geladen werden sollen, sollte der Export im CSV-Format erfolgen. | Beim Exportieren von Daten kann angegeben werden, ob alle Datensätze, nur selektierte Datensätze, oder alle derzeit angezeigten (gefilterten) Datensätze exportiert werden sollen. Für versionierte Daten erfolgt die Ausgabe zum angegebenen Gültigkeitszeitpunkt, d.h. es wird nur die zu diesem Zeitpunkt gültige Version exportiert. Der Export erfolgt wahlweise im XML- oder CSV-Format. Falls die Daten in ein Tabellenkalkulationsprogramm (z.B. Excel) geladen werden sollen, sollte der Export im CSV-Format erfolgen. |
| |
| ===== Daten importieren ===== | ===== Daten importieren ===== |
| efa identifiziert importierte Datensätze anhand von Schlüsselfeldern. Für Personen sind dies beispielsweise die Kombination aus Vorname, Nachname und Namenszusatz. Wenn nicht mindestens eines dieser Felder in den Importdaten vorhanden ist, liefert der Import einen Fehler. | efa identifiziert importierte Datensätze anhand von Schlüsselfeldern. Für Personen sind dies beispielsweise die Kombination aus Vorname, Nachname und Namenszusatz. Wenn nicht mindestens eines dieser Felder in den Importdaten vorhanden ist, liefert der Import einen Fehler. |
| |
| Falls die Identifikation eines Datensatzes über ein anderes Schlüsselfeld erfolgen soll (z.B. eine Mitgliedsnummer, die sowohl in efa als auch in einer Mitgliedsverwaltung hinterlegt ist und zur eindeutigen Identifikation einer Person dient, selbst wenn sich deren Name ändert), kann dieses Schlüsselfeld in der Importdatei entsprechend markiert werden. Für CSV-Importdateien muß dazu in der ersten Zeile der Importdatei dem Feldnamen ein # vorangestellt und nachgestellt werden, also beispielsweise //FirstName|LastName|Gender|Birthday|#MembershipNo#|StatusId//. Für XML-Importdateien muß das Schlüsselfeld über ein Attribut //key="true"// kenntlichgemacht werden, z.B. //<MembershipNo key="true">12345</MembershipNo>//. Pro Datensatz ist nur ein einzelnes Schlüsselfeld möglich. Bei CSV-Dateien gilt dieses für alle zu importierenden Datensätze, wohingegen bei XML-Dateien (falls gewünscht) für jeden Datensatz ein separates Schlüsselfeld angegeben werden kann. Falls bei XML-Dateien ein Datensatz kein separat gekennzeichnetes Schlüsselfeld hat, wird das Schlüsselfeld des vorangegangenen Datensatzes verwendet. Es genügt damit also, für XML-Importe das gewünschte Schlüsselfeld beim ersten Datensatz zu kennzeichnen. | Falls die Identifikation eines Datensatzes über ein anderes Schlüsselfeld erfolgen soll (z.B. eine Mitgliedsnummer, die sowohl in efa als auch in einer Mitgliedsverwaltung hinterlegt ist und zur eindeutigen Identifikation einer Person dient, selbst wenn sich deren Name ändert), kann dieses Schlüsselfeld in der Importdatei entsprechend markiert werden. Für CSV-Importdateien muß dazu in der ersten Zeile der Importdatei dem Feldnamen ein # vorangestellt und nachgestellt werden, also beispielsweise |
| | ''FirstName|LastName|Gender|Birthday|#MembershipNo#|StatusId''. Für XML-Importdateien muß das Schlüsselfeld über ein Attribut ''key="true"'' kenntlichgemacht werden, z.B. ''<MembershipNo key="true">12345</MembershipNo>''. Pro Datensatz ist nur ein einzelnes Schlüsselfeld möglich. Bei CSV-Dateien gilt dieses für alle zu importierenden Datensätze, wohingegen bei XML-Dateien (falls gewünscht) für jeden Datensatz ein separates Schlüsselfeld angegeben werden kann. Falls bei XML-Dateien ein Datensatz kein separat gekennzeichnetes Schlüsselfeld hat, wird das Schlüsselfeld des vorangegangenen Datensatzes verwendet. Es genügt damit also, für XML-Importe das gewünschte Schlüsselfeld beim ersten Datensatz zu kennzeichnen. |
| |
| ==== Import-Modus ==== | ==== Import-Modus ==== |
| Bei versionierten Daten bestimmt dieser Zeitpunkt die ausgewählte Version für existierende Datensätze, bzw. beim Erstellen von neuen Datensätzen oder neuen Versionen von existierenden Datensätzen den Gültigkeitsbeginn des neu erstellten Datensatzes / der neu erstellten Version. | Bei versionierten Daten bestimmt dieser Zeitpunkt die ausgewählte Version für existierende Datensätze, bzw. beim Erstellen von neuen Datensätzen oder neuen Versionen von existierenden Datensätzen den Gültigkeitsbeginn des neu erstellten Datensatzes / der neu erstellten Version. |
| |
| ==== Beim aktualisieren eines Datensatzes ==== | ==== Beim Aktualisieren eines Datensatzes ==== |
| |
| Für versionierte Daten, falls der Modus //Vorhandene Datensätze aktualisieren// oder //Datensätze hinzufügen oder aktualisieren// ausgewählt ist, entscheidet diese Option, ob im Falle eines vorhandenen Datensatzes die zum gewählten Zeitpunkt gültige Version lediglich aktualisiert werden soll (anhand der Import-Daten), oder aber eine neue Version erstellt werden soll. | Für versionierte Daten, falls der Modus //Vorhandene Datensätze aktualisieren// oder //Datensätze hinzufügen oder aktualisieren// ausgewählt ist, entscheidet diese Option, ob im Falle eines vorhandenen Datensatzes die zum gewählten Zeitpunkt gültige Version lediglich aktualisiert werden soll (anhand der Import-Daten), oder aber eine neue Version erstellt werden soll. |
