Nummer |
Beschreibung |
1 |
Menü CSV |
2 |
Aktiviert |
3 |
Automatischer Import bei Software-Start deaktivieren |
4 |
Datensätze ohne eindeutige Kontakt-ID als neuen Kontakt anfügen (AUS=verwirft Datensatz) |
5 |
Einmalig von der Quell-URL importieren |
6 |
Verzeichnisname |
7 |
API Interface Auswahl eines verfügbaren API Interfaces |
8 |
Authentifizierungstyp Mit diesem Parameter wird festgelegt, wie und wo die Authentifizierung stattfindet |
9 |
Benutzername |
10 |
Kennwort |
11 |
URL |
CSV Import
Kontakte können aus CSV-Datenquellen mit URL-Verlinkung oder Dateiverknüpfung importiert werden. URL-Datenquellen sind URLs, die ohne Authentifizierung, mit http-AUTH oder oAUTH abgerufen werden können. Ebenso sind statische Dateien nutzbar, die einmalig für den Import angelegt oder zyklisch aktualisiert werden.
Ungeachtet der Datenquelle können Kontaktdaten „einmalig“ oder zyklisch importiert/synchronisiert werden. Zu Synchronisationszwecken ist eine eindeutige Kontakt-ID-Vergabe zu bevorzugen, um Duplikate bei zyklischen Importvorgängen zu vermeiden.
Für den Import aus lokalen Datenquellen nutzen Sie bitte eine Sonderform der Pfadangabe und fügen vor der Laufwerksangabe „file:///“ an, z.B. „file:///d:/json-csv/data.csv“.
Der CSV Aufbau unterliegt keinen speziellen Vorgaben. Der erwartete Delimiter (Trennzeichen) zwischen einzelnen Werten ist das „Kommazeichen“ (,).
Die erste Zeile entspricht einer Kopfzeile (Header) mit einem aussagekräftigem Spaltenaufbau. Der Spaltenaufbau kann eine beliebige Reihenfolge der zu übermittelnden Werte beinhalten. Die Spaltenbezeichnungen unterliegen keinen Vorgaben. Datensätze entsprechen immer einer Eingabezeile.
Die Zuordnung der zu importierenden Daten erfolgt durch das einfache Prinzip der Wertezuordnung per Angabe des Spaltennamens aus der Kopfzeile (Header):
[Zu importierender Wert] -> [Lokaler Wert]
Beispiel eines einfachen CSV-Aufbaus zu einem einzelnen „Kontakt-Objekt“:
id,cn,sn,title,phone1,groups
010201,Tim1-web,Harper1,Product Manager1,1,"friends,support,dev"
Import-Beispiel “Vorname”:
Der CSV-Import unterstützt keine Arrays. Es können ausschließlich 1:1 Zuordnungen erfolgen. Für komplexere Importvorhaben ist der JSON Import zu bevorzugen.
Import von Bilddateien:
Bilddaten werden immer mit dem Bildformat JPEG erwartet. JPEG Dateien sind für jeglichen Import in das BASE64 Format zu konvertieren.
Besondere Handhabung bei dem Import von Gruppenzuordnungen ( > Version Build 22039):
Eine Gruppenzuordnung eines Kontaktes kann durch den Datenimport in das Feld „Zuordnung zu Kontaktgruppe“ erfolgen.
Ein Kontakt kann eine Zuordnung von mehreren Gruppen via CSV erhalten. Die Aufzählung von Gruppen ist in Hochkomma zu setzen und durch Komma zu trennen.
Es gilt:
•Externe Gruppenbezeichnungen haben immer Vorrang vor den Programmgruppen.
•Die interne Programmgruppe „Favorit“ ist die einzige Gruppe, die haptisch neben den extern zugelieferten Gruppen genutzt und zugeordnet werden kann.
•Gruppenbezeichnungen werden bei dem Import NICHT „Case sensitive“ behandelt. Damit werden mehrfach angelegte Gruppen mit unterschiedlichen Schreibweisen eines Gruppentyps vermieden (Freunde, freunde, FreunDe).
•Importierte Gruppen sind dauerhaft in der Anwendung hinterlegt. Nicht mehr benötigte Gruppen müssen in der Gruppenverwaltung der Anwendung gelöscht werden. Das Löschen per JSON ist aktuell nicht vorgesehen.
Ein Kontakt kann eine Zuordnung von Gruppen erhalten. Die Aufzählung von Gruppen ist in Hochkomma zu setzen und wie in dem zuvor gezeigten Beispiel durch Komma zu trennen ("friends,support,dev").
Die aufgezeigten Funktionsmerkmale sind von dem verbundenen Gerät (Hardwaretelefon)
oder von dem Softwaretelefon abhängig.
Die hier aufgeführten Merkmale können daher von der erwarteten Funktionsfähigkeit abweichen.