Dieses Tool dient als Importassistent von kundeneigenen Datenbanken in die Adressdatenbank des YellowFox Portalzugangs. Es werden CSV Dateien eingelesen. Die eingelesenen oder auch selbstständig eingegebenen Datensätze können vorher geocodiert werden, um diese auch in den Positionsslisten und auf den Karten darzustellen.

Programmstart

Nachdem Sie den "YellowFox Geocoder" gestartet haben, sucht dieser nach neuen Updates. 
Dieser Vorgang kann je nach Bandbreite der verfügbaren Internetverbindung bis zu 1 Minute dauern. Sollten keine neuen Updates verfügbar sein, wird geprüft, ob Sie bereits Ihre Authentifizierungsschlüssel angegeben haben. 
Falls Sie das Programm schon einmal in Verwendung hatten und das damalige Projekt nicht geschlossen haben, wird dieses beim Start mit geladen. 
Sobald in der Statuszeile "Bereit" angezeigt wird, ist der Programmstart beendet und Sie erhalten in etwa folgendes Fenster:

Hauptmenü

• Datei
  • Neues Projekt - Erstellt ein neues Projekt
  • Projekt öffnen - Öffnet ein schon erstelltes Projekt
  • Projekt schließen - Schließt das geöffnete Projekt
  • Beenden - Beendet den YellowFox Geocoder 

• Im-/Export
  • Import CSV-Datei - Öffnet das Fenster um eine CSV Datei einzulesen
  • Portal-Adressdatenbank löschen - Löscht die Komplette Adressdatenbank des Portals 

• Einstellungen
  • Zugangsschlüssel - Öffnet das Fenster um die Authentifizierungsschlüssel zu aktualisieren
  • Sprache - Auswahl in welcher Sprache der YellowFox Geocoder angezeigt werden soll

• Hilfe
  • Hilfe (F1) - Öffnet die Internethilfe des YellowFox Geocoder
  • Debugging - Versetzt das Programm in den Debug Modus
  • Debugging löschen - Setzt das Debugging zurück
  • Nach Updates suchen... - Verbindet sich mit dem Internet und sucht nach neuen Updates
  • Über - Informationsbildschirm des YellowFox Geocoder

Funktionen

Neues Projekt

Um ein neues Projekt anzulegen, geben Sie einfach den gewünschten Projektnamen an und klicken auf "OK". Der YellowFox Geocoder legt danach automatisch ein neues leeres Projekt an. 
Über den Button "Tabelle neu laden" öffnen Sie die leere Tabelle und können Werte eintragen.

Neues Update

Eine Überprüfung, ob ein neues Update verfügbar ist, wird bei jedem Programmstart oder jedem Klick im Menü auf Extras --> Nach Updates suchen... durchgeführt. Sollte ein neues Update verfügbar sein, werden Sie über folgende Darstellung über ihre derzeitige Version und die verfügbare Version informiert. Sollten Sie die Durchführung des Updates wünschen, klicken Sie bitte auf "Ja". Andernfalls auf "Nein". Sollten Sie das Installieren von Updates ablehnen, kann es zu Fehlfunktionen kommen, die bis hin zum Verlust des Adressdatenbestandes im YellowFox-Portal führen können. Bei der Durchführung beendet sich der YellowFox Geocoder von selbst, lädt das neue Update herunter, aktualisiert sich und startet sich wieder neu.

Import CSV Datei

In diesem Fenster stellen Sie die Importeigenschaften Ihrer CSV Datei ein, die importiert werden soll. Sie ist in 6 Schritte unterteilt. 

Schritt 1

Schritt 2

Schritt 3

Importdatei prüfen - Hierbei werden die Einstellungen, die Sie für die CSV Datei getroffen haben geprüft. Außerdem werden die Feldnamenbezeichnungen aus der CSV Datei in die Auswahlfelder geschrieben.

Schritt 4

 Geben Sie die Zuordnung ein, welche Felder aus der CSV Datei zu den Feldern der YellowFox Datenbank gehören sollen.  Unter dem Punkt Vorgabetext, können Sie Standardwerte für die Felder festlegen. Ob diese immer verwendet werden sollen oder nur dann, wenn aus der CSV Datei kein Wert kommt, legen Sie durch das Häkchen hinter dem jeweiligen Textfeld fest. Wichtig hierbei ist Anzeigetext! Dieser wird hauptsächlich im Portal verwendet.

Schritt 5

Hier können Sie sich entscheiden, ob Sie die zu importierenden Datensätze an das bestehende Projekt anfügen wollen oder alle bisher im Projekt befindlichen Datensätze löschen wollen.

Reaktion bei gefundenen Dubletten: 

• Dublette: Ist ein bereits im Projekt existierender Datensatz. Dieser wird anhand folgender Kriterien überprüft: Name1, Name2, Ort, PLZ, Land, Straße, Hausnummer und Anzeigetext

Welche Reaktion soll erfolgen, wenn bereits ein Datensatz mit identischen Werten im Projekt existiert?

• Nachfragen: Sie erhalten eine Meldung und werden bei jeder gefundenen Dublette gefragt, ob diese mit in das Projekt übernommen werden soll oder nicht
• Dublette übernehmen: Dubletten werden mit in das Projekt übernommen
• Dublette verwerfen: Wenn bereits ein identischer Datensatz vorhanden ist, wird die Dublette verworfen

Schritt 6

Über 'Import Starten' wird der Import-Vorgang begonnen. Über 'Schliessen' werden alle Änderungen verworfen und Sie kehren zu, Hauptbildschirm zurück.

Während des Importvorganges wird Ihnen in der Statuszeile angegeben, wie viele Datensätze bereits importiert wurden. Sobald der Import-Vorgang abgeschlossen wurde, erhalten Sie eine Meldung, wieviele Datensätze insgesamt importiert wurden.

Zugangsschlüssel

Im Portal finden Sie die RTI Verbindungsschlüssel unter Extras --> RTI (Schnittstelle)

RTI - Firmenkey

Ist der Autorisierungsschlüssel unter dem Punkt Firma.

RTI - Importkey

Ist der Autorisierungsschlüssel unter dem Punkt Import.

Gültigkeitsprüfung

Das eingegebene Schlüsselpaar wird auf ihre Gültigkeit hin überprüft.

Portaldatenbank löschen

Achtung dieser Vorgnag kann nicht rückgängig gemacht werden!

Es wird die komplette Adressdatenbank des Portals gelöscht.

Sprachauswahl

• Verfügbare Sprachen:
  • Deutsch
  • Englisch

Die gewünschte Sprache können Sie im Hauptmenü unter Einstellungen --> Sprache auswählen.

Über

Tabelle

Die Tabelle enthält alle Adressangaben, die sich in der Projektdatenbank befinden.

Aufbau

Ansichten

Die Anzeige kann durch vordefinierte Filter spezialisiert werden.

Folgende Datenansichten sind verfügbar:

• alle anzeigen
• nur bereits geocodierte
• nur noch zu bearbeitende
• nur noch nicht geocodierte
• nur fehlerhaft geocodierte
• nur bereits übertragene
• nur noch nicht übertragene
• nur die mit einem bestimmten Inhalt (Selbstdefinierter Filter für Firma/PLZ/ORT/Land/Strasse/Anzeigetext)

Datensatz bearbeiten

Um einen Wert eines Datensatzes bearbeiten zu können, markieren Sie diesen mit der Maus. Schreiben Sie danach den gewünschten Wert in die Zelle. Um die Eingabe abzubrechen müssen Sie die Taste 'ESC' drücken. Sie können mit der Maus und den Richtungspfeilen innerhalb der Tabelle navigieren. Um den Wert 'auf Karte' zu verändern, betätigen Sie bei markiertem Feld die 'LEERTASTE' oder klicken mit der Maus in die Auswahlbox. Die Adressen, die bereits geocodiert sind, allerdings mit dem Vermerk versehen sind, dass diese noch bearbeitet werden sollen, wurden mehrere mögliche Kartenpositionen für diesen Eintrag gefunden. Um auszuwählen, welchen Sie für diesen Eintrag wünschen, klicken Sie mit der rechten Maustaste auf die Adresse und wählen den Punkt 'Datensatz bearbeiten'. Es erscheint ein Auswahlfenster (siehe Abbildung) wo Sie ihre gewünschte Adresse auswählen können. Über den Button Google Earth besteht die Möglichkeit, sich alle in der Auswahlbox dargestellten Adressen in GoogleEarth anzeigen zu lassen. Voraussetzung dafür ist eine funktionsfähige Installation von GoogleEarth.
 

Angezeigte löschen

Hierbei werden alle Adressen aus Ihrer Geocoder Datenbank gelöscht, die momentan angezeigt werden. Verwenden Sie die Datenansicht, um ihre gewünschte Auswahl zu treffen. Wenn Sie einen einzelnen Datensatz löschen wollen, klicken Sie mit der rechten Maustaste auf die gewünschte Adresse und wählen 'Datensatz löschen'.

Angezeigte Adresse finden

Hierbei werden zu den bereitgestellten Koordinaten aus Ihrer Geocoder Datenbank die Adressen gefunden (Reverse Geocoding). Es werden nur die momentan angezeigten Einträge bearbeitet. Verwenden Sie die Datenansicht, um ihre gewünschte Auswahl zu treffen. 
Ergebnisfarben:

• Weiß: noch nicht geocodiert
• Grün: bereits geocodiert (1 Adresszuweisung)
• Gelb: noch zu bearbeiten (mehrere Adresszuweisungen gefunden)
• Rot: fehlerhaft geocodiert (es konnte keine Adresszuweisung gefunden werden)

Angezeigte geocodieren

Hierbei werden alle Adressen aus Ihrer Geocoder Datenbank geocodiert, die momentan angezeigt werden. Verwenden Sie die Datenansicht, um ihre gewünschte Auswahl zu treffen. 

Ergebnisfarben:

• Weiß: noch nicht geocodiert
• Grün: bereits geocodiert (1 Adresszuweisung)
• Gelb: noch zu bearbeiten (mehrere Adresszuweisungen gefunden)
• Rot: fehlerhaft geocodiert (es konnte keine Adresszuweisung gefunden werden)

Vorgegebene Position nutzen

Wenn Datenmaterial importiert wurde mit vorgegebenen Werten für Längengrad und Breitengrad, kann diese Position direkt benutzt werden. Der langwierige Ceocoding-Vorgang entfällt dann.

Angezeigte übertragen

Hierbei werden alle Adressen die momentan angezeigt werden, an die Adressdatenbank im YellowFox Portal übertragen. Ob dies erfolgreich war, ist an einer '1' in der Spalte 'Online' oder über die Datenansicht Auswahloption 'nur bereits übertragene' möglich.

Fehlerhafte Geocodierung

Mögliche Gründe für eine fehlerhafte Geocodierung:

• unbekannte Länderkennung (Kennzeichenliste)
• Schreibfehler in den Adressangaben