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:

 Image Modified

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)

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

YellowFox Geocoder [Original Seitentitel]

This tool is designed as an import assistant to convert your preliminary database into your yellowfox portal address database. CSV files will be supported. The converted and self entried records can be previously geocoded.

program start

After the start of "YellowFox Geocoder", the program is searching for new updates. 
This procedure can take up to 1 minute, depending on your internet connection. If no new updates was found, the program is checking if you entered rti access codes.
If you have ever started this tool and you not closed your previous project, the tool will starting this one. 
Immediately the status bar displayed "ready", the starting proccess is done and you will seen approximately following window.

 Image Added

main menu

• File
  • new project - creates a new project
  • open project - opens an existing project
  • close project - closes the open project
  • close - close YellowFox Geocoder
• Im-Export
  • import CSV file - open the dialog to import a csv file
  • delete portal address database - delete all records from the portal address database
• Settings
  • access codes - open the dialog to update your rti access codes
  • language - language selection of YellowFox GeoCoder
• Help
  • Help (F1) - open internet help site of YellowFox GeoCoder
  • debugging - set the program into the debug mode
  • delete debugging - reset the debugging
  • searching for new updates... - connect the internet and searches for new updates
  • about - information window of YellowFox Geocoder

functions

new project

To create a new project, just enter the wanted name of the project into the text box and click "ok". The YellowFox Geocoder will create an new project automaticly. 
With the button "reload table" you will open the empty table and you are now able to insert new records.

new update

After every program start and on every click in the menu extras --> "searching for new updates..." an update check will be procceded. If a new update is available, you will be informed about the current and the available version. If you want to procced the update, please click "yes" otherwise "no". Not installing available updates may cause malfunction up to destroying your address database. While the update is running the YellowFox Geocoder close himself, download the new update and restart

import csv file

In this dialog you set the attributes of the csv file you will imprt. It is divided into 6 steps.

1st step

Source file selection. Click on "open" and select the file you want to import. The path including the filename will be shown in the textbox of step 1.

2nd step

properties of the csv file:

• seperator: Is the character, which seperates the single columns of the csv file.
  • tabulator (<TAB>)
  • comma (,)
  • semicolon (;)
  • tilde (~)
  • pipe (|)
  • space (<SPC>)
• text delimiter: selection of the character, which fences the text. Inside this perimeter for example seperators or end of line files will be ignored.
  • double quotation mark (")
  • single quotation mark (')
  • without text delimiter (without)
• sort field names - the field names of the import file will be sortet alphabeticly

3rd step

Check the import file - at this step the settings which you have selected will be checked. Additionally the field names of the csv file will be added to the selection fields.

4th step

In this step you will allocate the fields of the csv file to the fields of the YellowFox database.

In the textbox default value, you can input default text. You can yhoose, when they will be used. Whether only if there is nothing inputed into the field or always.

5th step

At this option group you can select between delete all records from the temporaray YellowFox Geocoder database and add the records you want to import to the temporary database.

reaction if a doublet was found: 

• Doublet: checks if the record already exists (checks for name1, name2, city, postcode, country, street, house number and position description)

What kind of reaction do you want to proceed if a doublet was found?

• ask: If a doublet was found, you will be asked, what you will do. Do yout want to add this record or do you want to discard them.
• add doublet: Although a doublet was found, it will be added to the project
• discard doublet: If a doublet was found, the record will be discard. No additional insert into the project database.

6th step

A click on "import start" the import procedure will be starting. A click on " close" will close the dialog and you will go back to the main window.

While the import process you will be informed in the status bar, how many records have been imported yet. Immediately the import procedure has been completed, you will be informed how many records toal have been imported.

access code

You will find the rti access codes in the extras menu RTI (interface)

rti - company key

Is the authorization code from company.

rti - import key

Is the authorization code from import.

validation

The entered key pair will be checked.

delete portal address database

Attention, this process can not be reversed!

All records from the address database in the portal will be deleted.

language selection

• available languages:
  • German
  • English

The requested language can be selected in the menu under settings --> language.

about

table

The table conatins all address entries, which are in the project database.

structure[edit]

views

The view can be specialised by predefined filter values.

following data views are available:

• show all
• only geocoded
• only to edit
• not yet geocoded
• failing geocoded
• already transmitted
• not yet transmitted
• with certain content (selfdefinable filter for company/postcode/city/country/street/position description)

edit record

If you want to edit a record, you must check this one. After that, input the favoured value into the cell. If you want to cancel your input press the key 'ESC'. To save the record uncheck thisone or check another cell. Inside the table you can navigate with mouse and the arrow keys of your keyboard. To change the value of 'on map' you must check this cell and press the 'SPACE' key or click into the selection box with the mouse arrow. The addresses which are already geocoded, but with the comment 'to edit'(beige background), has found more than one possible geocode address. To select which address you will allocate to this entry, right-click on the record and select 'to edit'. A selective-dialog will be shown (see picture), there you can select the wanted address you will allocate. By using the button GoogleEarth you can view the addresses in GoogleEarth. You need a working installation of GoogleEarth to use this feature.  

delete displayed

With this option you celete all displayed records from the project database. To change the data view, you only must change the filter. If you want to delete only one record, just right-click them and select 'delete record'.

find address of displayed

With this function the geocoder will find the address values (street, hnr, city...) by the given coordinates (reverse geocoding).

result colours:

• white: not yet geocoded
• green: already geocoded (1 address allocation)
• beige: to edit (more than 1 possible address allocations)
• red: failing geocoded (no address allocation found)

geocode displayed

With this function you try to geocode all displayed records. If you want to change the displayed view, use the filter option 'data view'. 
result colours:

• white: not yet geocoded
• green: already geocoded (1 address allocation)
• beige: to edit (more than 1 possible address allocations)
• red: failing geocoded (no address allocation found)

transmit displayed

With this function you try to send all displayed records to the portal address database. All successful transmitted records have a '1' in the column 'online'. Only these records will be shown the data view filter 'already transmitted'.

 failing geocoding

possible reasons for an failing geocoding:

• unknown country code ((list of country codes))
• literal error in address submission