Das Programm 'PR E-Mail Assistant'
Einführung
Hinweis: Die folgnden Ausführungen sind für Dich nur dann interessant, wenn auf Deinem Rechner ein Windows XP oder Windows 2000 Betriebssystem installiert ist (Vista ist noch nicht getestet). Wenn das nicht der Fall ist, dann lese bitte, wie Du die E-Mail-Schnittstelle manuell bedienen kannst.
Wie im vorhergehenden Abschnitt beschrieben, ist es auch ohne die Verwendung des 'PR E-Mail Assistant' möglich, mit einem beliebigen E-Mail Programm, möglich Position Reports (PRs) zu senden und bereits gesendete PRs zu editieren. Doch es ist sicher nicht jedermanns Sache, sich in die 'kryptische' Befehlssyntax einzuarbeiten und die die komplette Kommando Syntax auswendig zu lernen.
Der 'PR E-Mail Assistant' wurde entwickelt, um den Vorgang des Erzeugens von PR-E-Mails zu vereinfachen und möglichst intuitiv zu gestalten. Der 'PR E-Mail Assistant' ist in Visual Basic 6.0 geschrieben und läuft unter Windows. Das Programm kann von aus dem Downloadbereich von OpenLogbook herunter geladen werden muss anschließend auf dem jeweiligen Rechner installiert werden. Die Nutzung des Programms ist kostenlos
PR E-Mail Assistant' unterstützt den Nutzer in folgenden Punkten:
- Es bietet dem Nutzer auf einer sinnvoll gegliederten Oberfläche die zur Verfügung stehenden Kommandos in verständlicher Textform zur Auswahl an.
- Der Nutzer wird vollständig von der Aufgabe freigestellt, die Syntax aller Kommandos zu lernen und richtig anzuwenden. Er muss lediglich auf die neben dem Befehl platzierte Taste klicken.
- Zum Erzeugen eines neuen Logbucheintrags oder Reise oder zum Editieren bereits gesendeter Datensätze werden übersichtliche Eingabemasken bereitgestellt.
- Das Programm überprüft die Syntax und das Format der eingegebenen Daten und hilft dem Nutzer Syntaxfehler oder Formatfehler zu finden und zu beseitigen.
- Als Ergebnis liefert das Programm den jeweiligen Text für die Betreff Zeile und für den Textkörper des E-Mails der mit 'Kopieren' und 'Einfügen' in das E-Mail-Programm übertragen wird.
Begriffe
ID: |
Eine eindeutige Identifikationsnummer für Datensätze. Diese werden unterteilt in YachtID, ReiseID und PRID. |
|---|---|
YachtID: |
Diese Nummer spezifiziert eindeutig eine Yacht im System. Die YachtID wird bei der Registrierung automatisch vergeben und per E-Mail mitgeteilt. |
ReiseID: |
Die ReiseID spezifiziert eindeutig eine im System angelegte Reise. Anders als die ReiseNr, kommt eine ReiseID nur einmal vor. Die ReiseID wird vergeben, wenn eine neue Reise angelegt wurde und wird mit dem Bestätigungs-E-Mail mitgeteilt. Eine andere Möglichkeit die ReiseID zu ermitteln ist die Verwendung des Kommandos "Auflisten der letzten Reisen (kurz)". |
PRID: |
Die ID eines Position Report, kurz PRID spezifiziert eindeutig einen, im System angelegte Position Report. Jede PRID, kommt im System nur einmal vor. Die PRID wird vergeben, wenn ein neuer PR angelegt wurde und wird mit dem Bestätigungs-E-Mail mitgeteilt. Eine andere Möglichkeit die PRID zu ermitteln ist die Verwendung des Kommandos "Auflisten der letzten Position Reports (kurz)". |
Übersicht
Das Programm ist in einzelne Seiten unterteilt. Durch einen Klick auf den jeweiligen Reiter im oberen Bereich öffnet sich die jeweilige Seite. Es gibt folgende Tabs:
Position Report
Liste mit gültigen Kommandos, die mit dem Senden, Ansehen, Editieren oder Löschen von Positions Reports (PRs) zu tun haben.
Reise
Liste mit gültigen Kommandos, die mit dem Senden, Ansehen, Editieren oder Löschen von Reisen (Legs) zu tun haben.
WEB
Liste mit gültigen Kommandos, mit deren Hilfe Inhalte von Webseiten per E-Mail empfangen werden können.
Result
Das Ergebnis des Programms. Hier werden die einzelnen Bestandteile des zu erzeugenden E-Mails (Adresse, Betreff-Zeile und E-Mail-Körper) angezeigt und zum Kopieren und Einfügen zur Verfügung gestellt.
Info
Anzeige dieses Textes
Seite 'Position Report'
Die Liste der zur Verfügung stehenden Kommandos ist unterteilt in die Beschreibung des Kommandos, der Beschreibung des Parameters, eines Feldes zur Eingabe des Parameters und einer Taste zum Ausführen des jeweiligen Kommandos. Wenn ein Feld zur Eingabe des Parameters vorhanden ist, ist die Eingabe dieses Parameters auch zwingend erforderlich. Einige der Parameter sind bereits mit einem sinnvollen Wert gefüllt. Dieser Wert sollte bei Bedarf überschrieben werden.
Die Tasten 'Weiter' und 'Generate' führen zu verschiedenen weiteren Verfahren: Während die Taste 'Generate' sofort das Ergebnis auf der Seite 'Result' anzeigt (wobei der Textkörper leer bleibt), öffnet die Taste 'Weiter' zunächst eine weitere Eingabemaske, die zum Ausführen dieses Befehls möglichst ausgefüllt werden sollte.
Folgende Kommandos stehen zur Verfügung:
Senden eines neuen Position Report
Das wichtigste Kommando ist das Kommando zum senden eines Position Reports. In der sich öffnenden Eingabemaske sollten möglichst alle Felder ausgefüllt werden. Die rot hinterlegten Felder sind Pflichtfelder und müssen unbedingt ausgefüllt werden. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Auflisten der letzten Position Reports (kurz)
Dieses Kommando fordert eine Liste der PR-ID Zeiten und Positionen der zeitlich letzten Position Reports (PRs) an. Die Anzahl der zu listenden PRs wird als Eingabe in das Parameterfeld erwartet. Als Anfangswert ist eine eins eingetragen. Mit diesem Kommando können auch die PRIDs der einzelnen PRs ermittelt werden.
Auflisten der letzten Position Reports (ausführlich)
Dieses Kommando fordert allen Informationen der zeitlich letzten Position Reports (PRs) an. Die Anzahl der zu listenden PRs wird als Eingabe in das Parameterfeld erwartet. Als Anfangswert ist eine eins eingetragen.
Auflisten eines RP mit einer bestimmten PRID
Nachdem die PR-ID bekannt ist, kann über dieses Kommando eine einzelner PR gezielt zurück übertragen und angezeigt werden. Die PRID ist dabei in das Parameterfeld einzutragen.
Löschen der letzten Position Reports
Dieses Kommando löscht den zeitlich letzten (nach Datum und Zeit) PR aus der Datenbank.
Löschen eines PR mit einer bestimmten PRID
Dieses Kommando löscht genau den PR aus der Datenbank, dessen PRID in das Parameterfeld eingetragen wurde.
Update des letzten Position Reports
Um einen einmal übertragenen Position Report zu verändern wird ein Update-Kommando verwendet. Dieses Update-Kommando kann den zeitlich (Datum und Zeit) letzten PR aktualisieren. In der sich öffnenden Eingabemaske ist ein neuer Wert nur für dasjenige Feld einzutragen, dessen Inhalt aktualisiert werden sollte. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Update eines PR mit einer bestimmten PR-ID
Dieses Update-Kommando kann den PR aktualisieren, dessen PRID in das Parameterfeld eingetragen wurde. In der sich öffnenden Eingabemaske ist ein neuer Wert nur für dasjenige Feld einzutragen, dessen Inhalt aktualisiert werden sollte. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Seite 'Reise'
Die Liste der zur Verfügung stehenden Kommandos ist unterteilt in die Beschreibung des Kommandos, die Beschreibung des Parameters, eines Feldes zur Eingabe des Parameters und einer Taste zum Ausführen des jeweiligen Kommandos. Wenn ein Feld zur Eingabe des Parameters vorhanden ist, ist die Eingabe dieses Parameters auch zwingend erforderlich. Einige der Parameter sind bereits mit einem sinnvollen Wert gefüllt. Dieser Wert sollte bei Bedarf überschrieben werden.
Die Tasten 'Weiter' und 'Generate' führen zu verschiedenen weiteren Resultaten: Während die Taste 'Generate' sofort das Ergebnis auf der Seite 'Result' anzeigt (wobei der Textkörper leer bleibt), öffnet die Taste 'Weiter' zunächst eine weitere Eingabemaske, die zum Ausführen dieses Befehls möglichst ausgefüllt werden sollte.
Erzeugen einer neuen Reise
Das ist das Kommando zum Anlegen einer neuen Reise. In der sich öffnenden Eingabemaske sollten möglichst alle Felder ausgefüllt werden. Die rot hinterlegten Felder sind Pflichtfelder und müssen unbedingt ausgefüllt werden. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Auflisten der letzten Reisen (kurz)
Dieses Kommando fordert eine Kurz-Liste der zeitlich letzten Reisen an. Die Anzahl der zu listenden Reisen wird als Eingabe in das Parameterfeld erwartet. Als Anfangswert ist eine Eins eingetragen. Mit diesem Kommando können auch die ReiseIDs der einzelnen Reisen ermittelt werden.
Auflisten der letzten Reisen (ausführlich)
Dieses Kommando fordert eine ausführliche Liste der zeitlich letzten Reisen an. Die Anzahl der zu listenden Reisen wird als Eingabe in das Parameterfeld erwartet. Als Anfangswert ist eine Eins eingetragen.
Auflisten einer Reise mit einer bestimmten ID
Nachdem die Reise-ID bekannt ist, kann über dieses Kommando eine einzelne Reise gezielt zurück übertragen und angezeigt werden. Die Reise-ID ist dabei in das Parameterfeld einzutragen.
Auflisten einer Reise mit einer bestimmten Reise-Nr.
Nachdem die ReiseNr bekannt ist, kann über dieses Kommando eine einzelne Reise gezielt zurück übertragen und angezeigt werden. Die ReiseNr ist dabei in das Parameterfeld einzutragen. Der Unterschied zwischen ReiseNr und ReiseID ist der, dass die ReiseNr fortlaufend für jede Yacht vergeben wird. Also hat jede Yacht eine erste, zweite, dritte, usw. Reise, während eine ReiseID grundsätzlich nur ein einziges Mal vorkommen kann.
Löschen einer Reise mit einer bestimmten ID
Dieses Kommando löscht die Reise aus der Datenbank, deren ReiseID in das Parameterfeld eingetragen wurde. Dabei werden auch alle PRs und übertragenen Bilder, die dieser Reise zugeordnet wurden ebenfalls gelöscht.
Löschen einer Reise mit einer bestimmten Reise-Nr
Dieses Kommando löscht die Reise aus der Datenbank, deren ReiseNr in das Parameterfeld eingetragen wurde. Dabei werden auch alle PRs und übertragenen Bilder, die dieser Reise zugeordnet wurden ebenfalls gelöscht.
Update der letzten Reise
Um Informationen in einer einmal übertragenen Reise zu verändern wird ein Update-Kommando verwendet. Dieses Update-Kommando kann die zeitlich letzte Reise aktualisieren. In der sich öffnenden Eingabemaske ist ein neuer Wert nur für dasjenige Feld einzutragen, dessen Inhalt aktualisiert werden soll. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Update einer Reise mit einer bestimmten ID
Dieses Update-Kommando kann die Reise aktualisieren, deren ReiseID in das Parameterfeld eingetragen wurde. In der sich öffnenden Eingabemaske ist ein neuer Wert nur für dasjenige Feld einzutragen, dessen Inhalt aktualisiert werden sollte. Eine Beschreibung der Eingabemaske gibt es weiter unten. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Update einer Reise mit einer bestimmten Reise-Nr.
Dieses Update-Kommando kann die Reise aktualisieren, deren ReiseNr in das Parameterfeld eingetragen wurde. In der sich öffnenden Eingabemaske ist ein neuer Wert nur für dasjenige Feld einzutragen, dessen Inhalt aktualisiert werden sollte. Eine Beschreibung der Eingabemaske gibt es weiter unten. Der Unterschied zwischen ReiseNr und ReiseID ist der, dass die ReiseNr fortlaufend für jede Yacht vergeben wird. Also hat jede Yacht eine erste, zweite, dritte, usw. Reise, während eine ReiseID grundsätzlich nur ein einziges Mal vorkommen kann. Ein JPG-Bild als Anlage ist möglich (Siehe Punkt Anlagen).
Seite 'WEB'
Im oberen Bereich der Ansicht ist zunächst das Eingabefeld 'URL' hier ist die Adresse der gewünschten Webseite einzugeben.
Die Liste der zur Verfügung stehenden Kommandos unterteilt sich im Wesentlichen nach dem Inhalt und dem Format des Inhaltes der gewünschten Webseite im E-Mail:
Text-Mode
Das Antwort E-Mail wird nur den extrahierten Text der in der URL eingegebenen Webseite enthalten.
Text+Link-Mode
Das Antwort E-Mail wird den extrahierten Text der in der URL eingegebenen Webseite und eine Liste der Links enthalten.
Link-Mode
Das Antwort E-Mail wird nur eine Liste der Links von der in der URL eingegebenen Webseite enthalten.
HTML-Mode
Das Antwort E-Mail wird den vollständigen HTML-Code der in der URL eingegebenen Webseite enthalten.
Seite 'Result'
Nachdem das Programm die einzelnen Bestandteile des zu sendenden E-Mails erfolgreich generiert hat, zeigt es automatisch den Bereich der Seite 'Result' an. Hier sind die Inhalte von E-Mail-Adresse, Betreff-Zeile und Text des E-Mails dargestellt. Diese können jetzt per Copy and Paste (Kopieren und Einfügen) in jedes beliebige E-Mail-Programm übertragen werden. Um das Kopieren ins Clipboard zu erleichtern wurde neben jedem Bereich eine Taste 'Copy' angeordnet.
Eingabemaske für das Kommando 'Senden eines neuen Position Reports'
Wird die Taste 'Weiter' neben dem Befehl 'Senden eines neuen Position Reports' betätigt, öffnet sich eine neue Eingabe Maske. In diese Maske werden die benötigten Informationen für das Absenden eines neuen Position Reports eingegeben. Die rot hinterlegten Felder müssen unbedingt ausgefüllt werden. Die einzelnen Felder haben folgende Bedeutung:
ReiseNr.: |
Nummer der zuvor angelegten Reise, zu der dieser Position Report (Logbucheintrag) gehören soll. |
|---|---|
Fahrtag: |
Anzahl der Tage, die seit dem Begin dieser Reise bereits vergangen sind. |
Datum: |
Das aktuelle Datum im Format: 'YYYY-MM-TT'. |
Zeit: |
Die aktuelle Uhrzeit im Format: 'HH:MM:SS' (24 Stunden Angabe) |
Zeitbasis: |
Spezifiziert ob die Uhrzeit als lokale Zeit oder als Weltzeit angegeben ist. |
Log: |
Die seit dem letzten Position Report zurückgelegte Strecke, gemessen in Seemeilen [nm]. |
RwK: |
Der Rechtweisende Kurs (COG), gemessen in Grad. Der Rechtweisende Kurs ist der Kurs über Grund und entspricht dem GPS-Kurs. |
Geschw: |
Die durchschnittliche Geschwindigkeit der Yacht über Grund (SOG), gemessen in Knoten [kt]. |
Etmal: |
Die innerhalb von 24 Stunden zurückgelegte Distanz, gemessen in Seemeilen [nm]. |
Breite: |
Geographische Breite mit getrennten Eingaben für das Symbol (N oder S), die Gradzahl der Breite als dreistellige Zahl mit Führungsnullen und die Minutenzahl als zweistellige Minutenangabe mit Führungsnullen und genau zwei Dezimalstellen. |
Länge: |
Geographische Länge mit getrennten Eingaben für das Symbol (W oder E), die Gradzahl der Breite als dreistellige Zahl mit Führungsnullen und die Minutenzahl als zweistellige Minutenangabe mit Führungsnullen und genau zwei Dezimalstellen. |
Headline: |
Die Überschrift zum Logbucheintrag in deutscher bzw. englischer Sprache |
Bericht: |
Der Text des Logbucheintrags in deutscher bzw. englischer Sprache. |
Befehle im Menü der Eingabemaske:
File > Exit: |
Das Programm beenden |
|---|---|
Tools > Maske Loeschen: |
Alle Eingaben in der Eingabe-Maske löschen |
Tools > Vorhergehende Daten laden: |
Die Daten des vorhergehenden PR wieder in die Eingabe Maske laden |
Tools > Populate (Example): |
Füllen der Eingabe Maske mit Beispieldaten |
Tools > Generate: |
Erzeugen der Daten, die dann in das E-Mail kopiert werden können und Öffnen der Seite 'Result'. |
Spezielle Tasten:
Taste 'Alles Löschen': |
Alle Eingaben in der Eingabe-Maske löschen (Selbe Funktion wie der Menüpunkt) |
|---|---|
Taste 'Generate': |
Erzeugen der Daten, die dann in das E-Mail kopiert werden können und Öffnen die Seite 'Result'. (Selbe Funktion wie der Menüpunkt) |
Eingabemaske für eines der Update-Kommandos für Position Reports
Wird die Taste 'Weiter' neben einem der Update-Kommandos betätigt, öffnet sich dieselbe Maske wie bereits weiter oben beim Senden-Kommando beschrieben. Der Unterschied ist, dass es in dieser Maske keine Felder mit Pflichteingabe gibt. Es wird ausschließlich diejenige Information aktualisiert, in deren Feld ein neuer Wert eingetragen wurde. So können beliebig viele oder nur einzelne Informationen aktualisiert werden.
Eingabemaske für das Kommando 'Erzeugen einer neuen Reise'
Wird die Taste 'Weiter' neben dem Befehl 'Erzeugen einer neuen Reise' betätigt, öffnet sich eine neue Eingabe Maske. In diese Maske werden die benötigten Informationen für das Erzeugen einer neuen Reise eingegeben. Die rot hinterlegten Felder müssen unbedingt ausgefüllt werden. Die einzelnen Felder haben folgende Bedeutung:
Beginn (Ort): |
Der Ausgangspunkt der Reise |
|---|---|
Ende (Ort): |
Das Ziel der Reise |
Headline: |
Die Überschrift der Reise in deutscher bzw. englischer Sprache |
Bericht: |
Ein zusammenfassender Text, der die Besonderheiten der Reise beschreibt (in deutscher bzw. englischer Sprache). |
Befehle im Menü der Eingabemaske:
File > Exit: |
Das Programm beenden |
|---|---|
Tools > Maske löschen: |
Alle Eingaben in der Eingabemaske löschen |
Tools > Vorhergehende Daten laden: |
Die Daten des vorhergehenden PR wieder in die Eingabemaske laden |
Tools > Populate (Example): |
Füllen der Eingabemaske mit Beispieldaten |
Tools > Generate: |
Erzeugen der Daten, die dann in das E-Mail kopiert werden können und Öffnen die Seite 'Result'. |
Spezielle Tasten:
Taste 'Alles löschen': |
Alle Eingaben in der Eingabemaske löschen (Selbe Funktion wie der Menüpunkt) |
|---|---|
Taste 'Generate': |
Erzeugen der Daten, die dann in das E-Mail kopiert werden können und Öffnen die Seite 'Result'. (Selbe Funktion wie der Menüpunkt) |
Eingabemaske für eines der Update-Kommandos für Reisen
Wird die Taste 'Weiter' neben einem der Update-Kommando betätigt, öffnet sich dieselbe Maske wie bereits weiter oben beim Senden-Kommando beschrieben. Der Unterschied ist, dass es in dieser Maske keine Felder mit Pflichteingabe gibt. Es wird ausschließlich diejenige Information aktualisiert, in deren Feld ein neuer Wert eingetragen wurde. So können beliebig viele oder nur einzelne Informationen aktualisiert werden.
Anlagen (Attachments)
Beim Anlegen neuer Reisen oder Position Reports, aber auch bei allen Update-Kommandos kann jeweils ein Bild im E-Mail als Anlage gesendet werden. Das Anhängen von Anlagen erfolgt direkt im verwendeten E-Mail Programm. Beim Senden von Anlagen ist folgendes zu beachten:
- Es darf nur eine einzige Anlage angehangen werden.
- Die Anlage darf nur ein Bild im JPG-Format sein.
- Das Bild darf maximal 0,5 MB groß sein.
Ein übertragenes Bild wird von der Webseite umbenannt und in seiner Bildgröße so reduziert, dass es eine bestimmte Bildgröße nicht übersteigt. Die Bildgröße hängt vom Privilege Level der Yacht ab. Bei der Reduzierung der Größe wird das Höhen-Breiten-Verhältnis beibehalten.
Aus dieser Vorgehensweise können die folgenden Regeln abgeleitet werden:
- Der Dateiname des Bildes spielt keine Rolle, es muss aber eine JPG File sein.
- Es ist unsinnig deutlich größere Bilder zu übertragen, da dadurch sich nur die
- Übertragungszeit des E-Mails unnötig verlängert.