Bedienung der E-Mail-Schnittstelle für das Erstellen, Überprüfen, Ändern und Löschen von Reise- und Logbuchdaten
Voraussetzung
Um diesen Service nutzen zu können, muss die Yacht mit dem notwendigen Equipment ausgerüstet sein, das es erlaubt, unterwegs E-Mails senden und empfangen zu können. Üblicherweise ist das ein Kurzwellenfunkgerät mit einem angeschlossenen Pactor-Modem , oder ein Satellitentelefon in Verbindung mit einem Bordcomputer.
Übersicht
Die Webseite besitzt eine E-Mail-Schnittstelle, über die folgende Funktionen per E-Mail zugänglich sind:
Position Report (PR)
- Senden neuer Position Reports (PRs), als neuer Eintrag in das Logbuch,
- Anfordern von Listen mit bestehenden PRs,
- Aktualisieren / Editieren von bestehenden PRs,
- Löschen von bestehenden PRs,
Reise
- Anlegen neuer Reisen,
- Anfordern von Listen mit bestehenden Reisen,
- Aktualisieren / Editieren von bestehenden Reisen,
- Löschen von bestehenden Reisen.
WEB
- Abrufen von Inhalten von Webseiten,
- Die Webseiten werden per E-Mail zugeschickt,
Hinweis: Wenn auf Deinem Rechner ein Windows XP oder Windows 2000 Betriebssystem installiert ist (Vista ist noch nicht getestet), dann kannst Du auch dieses Kapitel überspringen und direkt zum Kapitel PR E-Mail Assistant weitergehen.
E-Mail-Adresse
Die automatisch arbeitende E-Mail-Adresse des Systems ist: pr@openlogbook.com
Diese E-Mail-Adresse wird von OpenLogbook automatisch abgefragt und auf eingegangene E-Mails überprüft die E-Mails müssen dabei einer vorgegebenen Syntax strickt folgen. E-Mails, die von dieser Syntax abweichen, werden vom System ohne Warnung gelöscht.
Sicherheitslevel bei E-Mail Sicherheit
OpenLogbook bietet den teilnehmenden Yachten zwei Sicherheitslevels an. Sie werden
- 'Bequemer E-Mail-Mode' und
- 'Sicherer E-Mail-Mode' genannt.
Der Skipper muss sich bei der Registrierung für eine dieser Möglichkeiten entscheiden. Er kann diese Einstellung jederzeit im Loginbereich ändern.
Wählt der Skipper den 'Bequemen E-Mail-Mode' aus, dann instruiert er OpenLogbook, seine, per E-Mail gesendeten Position Reports, Update- oder Löschanweisungen, sofort nach Erhalt des entsprechenden E-Mails auszuführen. Dieser Mode ist etwas bequemer, da hier keine Notwendigkeit zur Rückbestätigung besteht. Es sollte dem Skipper aber bewußt sein, dass es Möglichkeiten gibt, eine E-Mail-Adresse zu fälschen und so unberechtigt die Daten im Logbuch einer Yacht zu verändern. Wenn der Skipper sich für diese Methode entscheidet, wird dringend empfohlen, die verwendete E-Mail-Adresse geheim zu halten und nur für diesen Zweck zu verwenden.
Falls der Skipper einen höheren Sicherheitslevel bevorzugt und dafür lieber zusätzliche E-Mails empfängt und sendet, dann sollte er den 'Sicheren E-Mail-Mode' auswählen. In diesem Mode ist OpenLogbook instruiert, E-Mails, die Befehle enthalten, die die Daten in OpenLogbook verändern, zunächst zu speichern und die Identität des Senders zu überprüfen. Dazu sendet das System ein Rückbestätigungs-E-Mail an die E-Mail-Adresse, die für die betroffene Yacht in OpenLogbook registriert ist. Dieses E-Mail enthält einen Bestätigungskode. Alles was der Skipper jetzt tun muss ist dieses Rückbestätigungs-E-Mail mit unveränderter Betreff-Zeile wieder zurück and OpenLogbook zu schicken. Erst nach dem Erhalt dieser Rückbestätigung wird zwischengespeicherte Befehl ausgeführt. Mit Hilfe dieser Rückbestätigung wurde sichergestellt, dass der Sender des E-Mails tatsächlich der ist, der er vorgibt zu sein. OpenLogbook empfiehlt den 'Sicheren E-Mail-Mode' zu verwenden.
Betreff Zeile
Die Betreffzeile enthält das Kommando an das System. Kommandos teilen dem System mit, was der Nutzer zu tun wünscht. Weiter unten ist eine Liste der Kommandos. Ein Kommando hat immer folgende allgemeine Syntax:
PR>Befehl.Kategorie[.Zusatz]:[Parameter][,Parameter]
Ob und wie viele Parameter angehangen werden, richtet sich nach dem jeweiligen Befehl.
PR> : |
Eröffnungssequenz. |
|---|---|
Befehl: |
Instruiert den Kommandointerpreter was er tun soll, Befehl und Kategorie werden durch einen Punkt getrennt, |
Kategorie: |
Gibt an, auf was sich der Befehl bezieht, gefolgt durch einen Doppelpunkt, |
Zusatz: |
Weitere Spezifikationen, abhängig vom Befehl, |
Parameter: |
Beliebige Parameter in Abhängigkeit des Befehls. Vor jedem Parameter steht ein Komma. |
Beispiele:
PR>ADD.POS
ADD |
Anhängen eines neuen Datensatzes, |
|---|---|
POS |
Es handelt sich um Position Reports, |
Es gibt bei diesem Befehl keinen Zusatz und keine Parameter
PR>LIST.POS.LONG:9
LIST |
Anzeigen von bestehenden Datensätzen, |
|---|---|
POS |
Die Anzeige bezieht sich auf Position Reports, |
LONG |
Ausführliche Anzeige in umgekehrter Reihenfolge auf der Basis von Datum und Zeit. Die Anzahl der anzuzeigenden Datensätze wird als Parameter übergeben. |
9 |
Parameter: 9 Datensätze sollen angezeigt werden. |
PR>LIST.LEG.ID:66
LIST |
Anzeigen von bestehenden Datensätzen, |
|---|---|
LEG |
Die Anzeige bezieht sich auf Reisen, |
ID |
Es wird der Datensatz mit einer bestimmten ID angezeigt. Die ID wird im Parameter übergeben. |
66 |
Parameter: Der Datensatz mit der ID 66 soll angezeigt werden. |
PR>UPDATE.LEG.NO:4
UPDATE |
Ändern eines bestehenden Datensatzes, |
|---|---|
LEG |
Die Anzeige bezieht sich auf Reisen, |
NO |
Es wird der Datensatz mit einer bestimmten Reise Nr. angezeigt. Die Reise Nr. wir im Parameter übergeben. |
4 |
Parameter: Der Datensatz mit der Reise Nr. 4 soll angezeigt werden. |
Textbereich des E-Mails (Body)
Einträge in den Textbereich des E-Mails sind nur bei wenigen Kommandos notwendig. Typischerweise handelt es sich dabei um die Kommandos ADD und UPDATE. Das folgende Beispiel soll die Syntax des Textbereiches eines ADD-Kommandos für einen Position Report verdeutlichen:
ReiseNr={1}
Fahrtag={5}
Datum={2008-09-07}
Zeit={17:09:03}
Zeitbase={UTC}
Lat={N027g44.78m}
Lng={W015g37.40m}
Log={98.3}
Kurs={270}
Speed={5.7}
Etmal={112}
Headline_d={Deutsche Headline}
Bericht_d={Deutscher Bericht}
Headline_e={English Headline}
Bericht_e={English Report}
Beispiel für ein LEG-Kommando:
Begin_Ort={Hamburg}
Ende_Ort={Sylt}
Headline_d={Deutsche Headline}
Bericht_d={Deutsche Reise Zusammenfassung}
Headline_e={English Headline}
Bericht_e={English summarize of the leg/trip.}
Das erste Wort in jeder Zeile (vor dem Gleichheitszeichen) ist das so genannte Schlüsselwort. Dieses Schlüsselwort muss genauso geschrieben werden wie im Beispiel, sonst wird es nicht erkannt. Hinter dem Schlüsselwort muss ein Gleichheitszeichen folgen. Danach kommt der Wert, der dem Schlüsselwort zugeordnet werden soll. Dieser muss zwingend zwischen geschweiften Klammern stehen. Jede Zeile muss mit einem Semikolon abgeschlossen werden. Im Folgenden wird auf die einzelnen Schlüsselworte näher eingegangen:
Schlüsselwörter beim ADD.POS, Position Report Kommandos
Die Werte zwischen den geschweiften Klammer sind nur als Beispiele gedacht.
ReiseNr={1}; Pflichteingabe
Jeder Position Report muss einer Reise zugeordnet sein. Die Reisenummer ist eine fortlaufend aufsteigende Zahl im Integer-Format, also ohne Kommastellen.
Fahrtag={5}; optional
Der Fahrtag ist ebenfalls eine fortlaufend aufsteigende Zahl im Integer-Format, also ohne Kommastellen. Sie zählt die Tage einer Reise.
Datum={2008-09-07}; Pflichteingabe
Zeit={17:09:03}; Pflichteingabe
Das Datum und die Zeit des Position Report. Bitte die seltsamen Formate beachten und einhalten. Anderenfalls kommt es zu Fehlermeldungen. Das Format des Datums ist Jahr-Monat-Tag. Bei der Zeit bitte beachten, dass die Sekunden mit angegeben werden müssen. Sie können natürlich 00 gesetzt werden.
Zeitbase={UTC}; optional
Die Zeitbase zeigt an, ob es sich um die lokale Ortszeit handelt (local), oder um die Weltzeit (UTC)
Lat={N027g44.78m}; Pflichteingabe
Lng={W015g37.40m}; Pflichteingabe
Die Koordinaten, auf denen der Position Report angeschickt wurde. Auch hier bitte das seltsame Format beachten und einhalten. Eine Koordinate geht immer mit dem Zeichen für die Himmelsrichtung (N W S E) los. Danach kommt eine 3-stellige Gradangabe (bei Bedarf mit Führungsnullen auffüllen). Das sich anschließende 'g' steht für das Grad Symbol. Danach folgen die Minuten mit 2 Vorkomma- und 2 Nachkommastellen. Bitte auch hier bei Bedarf Führungsnullen bzw. Nachkomma-Nullen verwenden. Das am Ende stehende 'm' symbolisiert die Minuten.
Log={98.3}; Pflichteingabe
Das Log ist eine positive natürliche Zahl. Nachkommastellen sind erlaubt, aber nicht empfohlen. Zum Abtrennen der Nachkommastellen wird ein Punkt und kein Komma verwendet. Das Log repräsentiert die seit dem letzten Position Report zurückgelegte Strecke in Seemeilen.
Kurs={270}; optional
Der Kurs ist eine positive natürliche Zahl zwischen 0 und 359 Grad. Nachkommastellen sind erlaubt, aber nicht empfohlen. Zum Abtrennen der Nachkommastellen wird ein Punkt und kein Komma verwendet.
Speed={5.7}; optional
Mit dem Schlüsselwort 'Speed' ist natürlich die Geschwindigkeit gemeint. Es ist eine positive natürliche Zahl. Nachkommastellen sind erlaubt, aber nicht empfohlen. Zum Abtrennen der Nachkommastellen wird ein Punkt und kein Komma verwendet. 'Speed' beschreibt die Geschwindigkeit in Knoten.
Etmal={112}; optional
Das Etmal ist eine positive natürliche Zahl. Nachkommastellen sind erlaubt, aber nicht empfohlen. Zum Abtrennen der Nachkommastellen wird ein Punkt und kein Komma verwendet. Etmal beschreibt die in den letzten 24 Stunden zurückgelegte Strecke in Seemeilen.
Headline_d={Deutsche Headline}; optional
Die Überschrift des Reisereports in deutscher Sprache.
Bericht_d={Deutscher Bericht}; optional
Der eigentliche Position Report (Reisebericht) in deutscher Sprache.
Headline_e={English Headline}; optional
Die Überschrift des Reisereports in englischer Sprache.
Bericht_e={English Report}; optional
Der eigentliche Position Report (Reisebericht) in englischer Sprache.
Im Falle des Kommandos ADD gilt:
Schlüsselworte, die Pflichteingabe sind, müssen unbedingt aufgeführt werden. Wenn sie fehlen wird das Kommando nicht abgearbeitet. Als 'optional' gekennzeichnete Schlüsselworte können leer bleiben, also ohne Text zischen den geschweiften Klammern. Beispiel: Etmal={}
Im Falle des Kommandos Update gilt:
All die Schlüsselwörter, die angegeben sind, werden auch überschrieben. Es brauchen also nur die Schlüsselwörter in den Text aufgenommen werden, die geändert werden sollen. Das Kommando UPDATE ignoriert Pflichteingaben.
Schlüsselwörter beim ADD.LEG, Reise Kommandos
Die Werte zwischen den geschweiften Klammer sind nur als Beispiele gedacht.
Begin_Ort={Hamburg}; Pflichteingabe
Der Anfangsort der Reise
Ende_Ort={Sylt}; Pflichteingabe
Der Zielort der Reise
Headline_d={Deutsche Headline}; optional
Die Überschrift der Reisezusammenfassung in deutscher Sprache.
Bericht_d={Deutsche Reise Zusammenfassung}; optional
Die Reisezusammenfassung in deutscher Sprache.
Headline_e={English Headline}; optional
Die Überschrift der Reisezusammenfassung in englischer Sprache.
Bericht_e={English summarize of the leg/trip.}; optional
Die Reisezusammenfassung in englischer Sprache.
Im Falle des Kommandos ADD gilt:
Schlüsselworte, die Pflichteingabe sind, müssen unbedingt aufgeführt werden. Wenn sie fehlen wird das Kommando nicht abgearbeitet. Als „optional“ gekennzeichnete Schlüsselworte können leer bleiben, also ohne Text zischen den geschweiften Klammern. Beispiel: Headline_e ={}
Im Falle des Kommandos Update gilt:
All die Schlüsselwörter, die angegeben sind, werden auch überschrieben. Es brauchen also nur die Schlüsselwörter in den Text aufgenommen werden, die geändert werden sollen. Das Kommando UPDATE ignoriert Pflichteingaben.
Übersicht über die zur Verfügung stehenden Befehle
Befehle für Logbucheinträge (Position Reports)
Syntax |
Beschreibung |
Parameter |
|---|---|---|
PR>HELP oder PR>? |
Anzeige der Befehlsübersicht |
keine |
PR>ADD.POS |
Einen neuen PR zufügen. Der eigentliche PR wird nach den oben erläuterten Richtlinien in den Textbereich geschrieben. |
keine |
PR>LIST.POS.ID:ID |
Auflisten eines einzelnen PR mit der als Parameter übermittelten RecordID |
ID: RecordID |
PR>LIST.POS:n |
Auflisten der letzten PRs (Sortiert nach Datum und Zeit). Die Anzeige erfolgt in kurzer Darstellung |
n: Anzahl der Datensätze |
PR>LIST.POS.LONG:n |
Auflisten der letzten PRs (Sortiert nach Datum und Zeit). Die Anzeige erfolgt in der ausführlichen Darstellung. |
n: Anzahl der Datensätze |
PR>DELETE.POS.ID:ID |
Löschen des PR mit der als Parameter übermittelten RecordID. |
ID: RecordID |
PR>DELETE.POS:n |
Löschen der letzten n PRs (Sortiert nach Datum und Zeit). |
n: Anzahl der Datensätze |
PR>UPDATE.POS.ID:ID |
Ändern des PRs mit der als Parameter übermittelten RecordID. In den Textbereich werden solche Schlüsselwörter nach den oben erläuterten Syntax-Richtlinien geschrieben, deren Inhalt geändert werden sollen. |
ID: RecordID |
PR>UPDATE.POS |
Ändern des letzten PRs (nach Datum und Zeit). In den Textbereich werden solche Schlüsselwörter nach den oben erläuterten Syntax-Richtlinien geschrieben, deren Inhalt geändert werden sollen. |
keine |
Befehle für Reisen
Syntax |
Beschreibung |
Parameter |
|---|---|---|
PR>HELP oder PR>? |
Anzeige der Befehlsübersicht. |
keine |
PR>ADD.LEG |
Eine neue Reise zufügen Die eigentliche Reise wird nach den oben erläuterten Richtlinien in den Textbereich geschrieben. |
keine |
PR>LIST.LEG.ID:ID |
Auflisten einer einzelnen Reise mit der als Parameter übermittelten RecordID |
ID: RecordID |
PR>LIST.LEG.ID:No |
Auflisten einer einzelnen Reise mit der als Parameter übermittelten Reise Nummer |
No: Reise Nummer |
PR>LIST.LEG:n |
Auflisten der letzten n Reisen (Sortiert nach Datum und Zeit). Die Anzeige erfolgt in kurzer Darstellung |
n: Anzahl der Reisen |
PR>LIST.LEG.LONG:n |
Auflisten der letzten n Reisen(Sortiert nach Datum und Zeit). Die Anzeige erfolgt in der ausführlichen Darstellung. |
n: Anzahl der Reisen |
PR>DELETE.LEG.ID:ID |
Löschen der Reise mit der als Parameter übermittelten ID. |
ID: RecordID |
PR>DELETE.POS:n |
Löschen der letzten Reisen (Sortiert nach Datum und Zeit). |
n: Anzahl der Datensätze |
PR>DELETE.LEG.NO:No |
Löschen der Reise mit der als Parameter übermittelten Reise Nummer. |
No: Reise Nummer |
PR>UPDATE.LEG.ID:ID |
Ändern der Reisen mit der als Parameter übermittelten ReiseID. In den Textbereich werden solche Schlüsselwörter nach den oben erläuterten Syntax-Richtlinien geschrieben, deren Inhalt geändert werden sollen. |
ID: RecordID |
PR>UPDATE.LEG.NO:No |
Ändern Reisen mit der als Parameter übermittelten Reise Nummer. In den Textbereich werden solche Schlüsselwörter nach den oben erläuterten Syntax-Richtlinien geschrieben, deren Inhalt geändert werden sollen. |
No: Reise Nummer |
PR>UPDATE.LEG |
Ändern der letzten Reise (nach Datum und Zeit). In den Textbereich werden solche Schlüsselwörter nach den oben erläuterten Syntax-Richtlinien geschrieben, deren Inhalt geändert werden sollen. |
keine |
Befehle für Webseitenabfrage
Syntax |
Beschreibung |
Parameter |
|---|---|---|
WEB>TEXT |
Auslesen des Textes der im Textteil übermittelten Webadresse (URL) und per E-Mail zusenden. |
keine |
WEB>TEXTLINK |
Auslesen der Links der im Textteil übermittelten Webadresse (URL) und per E-Mail zusenden. |
keine |
WEB>LINK |
Auslesen des Textes und der Links der im Textteil übermittelten Webadresse (URL) und per E-Mail zusenden. |
keine |
WEB>HTML |
Auslesen des Textes in HTML-Format der im Textteil übermittelten Webadresse (URL) und per E-Mail zusenden. |
keine |
Beispiel für die Angabe einer URL im Textteil: <url>www.dradio.de/seewetter/</url>