Das RTI (Remote Tracking Interface) ermöglicht den Zugriff auf YellowFox Funktionen und Daten über HTTP von Software Drittanbietern. Die technische Dokumentation und Funktionsübersicht finden Sie hier.

Einleitung

Die RTI Schnittstelle bietet Ihnen die Möglichkeit Daten aus YellowFox in andere Systeme zu übertragen. Ebenso haben Sie die Möglichkeit Daten an YellowFox zu übergeben. So können Sie beispielsweise:

• Positionsdaten abrufen
• Fahrzeugeinstellungen ändern
• Formular- und Auftragsdaten holen
• neue Aufträge und Nachrichten versenden
• Dateien hochladen
• Zeitbuchungen verwalten
• Adressen importieren

Die RTI Schnittstelle bietet noch viele weitere Funktionen, die Sie unserer technischen Dokumentation entnehmen können. Wenn Sie sich dafür interessieren Touren an YellowFox zu übergeben oder Tourdaten abzurufen, sollten Sie sich unseren separaten Tour Webservice anschauen.

Voraussetzungen und Einrichtung

Die RTI Schnittstelle muss für Sie durch unseren Innendienst freigeschaltet werden. Kommen Sie dazu gern auf uns zu. Nachdem das Modul freigeschaltet wurde, finden Sie im Portal über das Hauptmenü → Verwaltung → Administration → RTI Schnittstelle die nötigen Einstellungen.

Um RTI Funktionen nutzen zu können, müssen Sie zunächst die benötigten RTI Schlüssel erzeugen.

Was ist ein RTI Schlüssel?

Die RTI Schnittstelle nutzt eine 2-stufige Authentifizierung. Das bedeutet, dass Sie bei jedem Zugriff 2 Schlüssel mitgeben müssen um unautorisierte Zugriffe zu vermeiden. Diese Schlüssel können Sie über das Portal erzeugen. Ein Schlüssel ist ein zufällig erstellter hexadezimaler Code. RTI Schlüssel sind vertrauliche Informationen und sollten nur weitergegeben werden, sofern es nötig ist. Nur mithilfe dieser Schlüssel sind Daten über die Schnittstelle abrufbar. YellowFox unterscheidet in 4 Arten von Schlüssel:

• Firmenschlüssel: dieser Schlüssel identifiziert Ihre Firma und muss bei jeder Anfrage mitgegeben werden.
• Fahrzeugschlüssel: dieser Schlüssel identifiziert ein einzelnes Fahrzeug. Er wird für Anfragen benötigt, die fahrzeugbezogene Daten wie z.B. Ortungsdaten zurückgeben.
• Gruppenschlüssel: dieser Schlüssel identifiziert eine Fahrzeuggruppe. Mit einem Gruppenschlüssel können Sie z.B. Ortungsdaten aller Fahrzeuge abrufen, die dieser Gruppe zugeordnet sind. ACHTUNG: Es werden nur Daten für Fahrzeuge ausgegeben, die auch selbst einen Fahrzeugschlüssel besitzen!
• Importschlüssel: dieser Schlüssel agiert als universeller Schlüssel. Er wird benötigt um Daten von allen Fahrzeugen abzurufen oder auch auf personenbezogene Daten zuzugreifen.

RTI Schlüssel erzeugen

RTI Schlüssel müssen über das Portal erzeugt werden. Gehen Sie dazu in die RTI Einstellungen. Unter Globale Schlüssel können Sie den Firmen- und Importschlüssel erzeugen. Wenn Sie bereits einen Schlüssel erzeugt haben, können Sie diesen auch ändern oder löschen. Eine Änderung würde dazu führen, dass der Schlüssel neu erzeugt wird. Das ist beispielsweise hilfreich wenn Sie den Schlüssel versehentlich an jemanden weitergegeben haben, der nicht auf Ihre Daten zugreifen können soll. Wenn Sie den Schlüssel löschen, sind Funktionen, die diesen nutzen, nicht mehr erreichbar.

Über Fahrzeugschlüssel können Sie die Schlüssel für die Fahrzeuge erzeugen. Fahrzeuge können auch ohne den Schlüssel zu entfernen vorübergehend für das RTI gesperrt werden. So können Sie einem Partner vorübergehend Zugriff auf ein Fahrzeug geben, z.B. während es eine bestimmte Tour fährt und anschließend den Zugriff wieder unterbinden. Sie können Fahrzeuge jederzeit aktivieren und wieder deaktivieren. Fahrzeuge sind nicht nur über den RTI Schlüssel identifizierbar, sondern optional auch über einen so genannten RTI Ident. Während der Schlüssel automatisch durch das System vergeben wird, können Sie den Ident frei vergeben. Das ist beispielsweise hilfreich um die Schlüssel einfacher in einem anderen Programm verwalten zu können. RTI Idents können nur in Kombination mit einem passenden Gruppenschlüssel verwendet werden. Eine Anleitung dazu finden Sie in der technischen Dokumentation. Über das Aktionsmenü können Sie weiterhin über RTI Links einige Beispielaufrufe sehen. 

Unter Fahrzeuggruppen Schlüssel können Sie die Schlüssel für Fahrzeuggruppen erzeugen. Hier sehen Sie auch noch einmal übersichtlich welche Fahrzeuge sich in den jeweiligen Gruppen befinden, ob diese bereits einen Schlüssel haben oder derzeit gesperrt sind. Fahrzeuge ohne Fahrzeugschlüssel werden in Abfragen mit Gruppenschlüsseln auch wenn sie der Gruppe zugeordnet sind nicht aufgeführt.

Netzwerkzugangsprofile

Wenn Sie für Ihre Firma Netzwerkzugangsprofile angelegt haben, so haben diese auch Auswirkungen auf RTI Anfragen. In den Einstellungen des Moduls können Sie Ihrer Firma Profile zuweisen. Anfragen die aus einem unbekannten Netz kommen werden dann automatisch unterbunden.

Vollständige Funktionsübersicht

Technische Dokumentation