Email 2 Logbook

2010-08-03

 

Martin Horak, martinhorak@centrum.cz

www.horakovi.eu

 

 

[CZ] Tento dokument obsahuje základní informace k používání aplikace email2log.

 

email2log je aplikace, a nástroj, na automatické generování webové stránky (html). Jako vstupy pro vygenerování stránky slouží SMS, či emaily, zaslané uživatelem. Předpokládá se, že SMS/email obsahuje geografickou pozici např. z GPS zařízení, a další doplňkový text. Výsledná html stránka bude pak obsahovat mapku s trasou a popis. Právě přítomnost mapy je důvod, proč nejde použít Facebook. Výsledná stránka se přenese na webový server, takže bude moci být přístupna všem lidem. Dále bude na konci přenosu poslán informativní email.

 

[EN] This document contains basic info for email2log application. The application is using SMS or email as an input (e.g. containing GPS position), and generates HTML page as a result to web server. More information in English will be added later on, or on demand – see email of author.

 

 

 Mapa_info

 

 

Hlavní myšlenka celého systému

 

Uživatel zprávu z mobilního telefonu, obsah zprávy se pak dekóduje a následně se vygeneruje HTLM soubor/stránka. Soubor se pak přenese na webový server – čímž je možné, pro uživatelovi přátele, si následně stránku prohlídnout ve webovém prohlížeči (Internet Explorer, Firefox, Opera, atd) kdekoli na světě.

 

Zpráva z mobilního telefonu se posílá pomocí emailu (v mobilním telefonu je nutno vybrat položku Poslat zprávu jako email), či pomocí SMS.

 

Pokud uživatel posílá SMS, pak SMS musí být ve formátu, aby výsledkem byl poslán email. Formát SMS definuje mobilní operátor.

Např Vodafone má SMS tvar:    email2log@gmail.com email_v_normalizovaném_tvaru

Uživatel mobilního telefone pro Vodafone posílá tuto SMS na číslo 2255. Tím firma Vodafone zařídí, že na adresu email2log@gmail.com bude zaslán email v jehož těle bude zpráva email_v_normalizovaném_tvaru .

 

Systém Email2log si všechny příchozí emaily na této adrese pravidelně „čte“, např. jednou za 30 minut.

 

Aby se mohl následně vygenerovat HTML soubor/stránka, musí být vstupní SMS/email zaslaný mobilním telefonem v definovaném (normalizovaném) tvaru.

 

 

 

Normalizovaný tvar emailu (či v SMS poli email_v_normalizovaném_tvaru)

 

Formát emailu email_v_normalizovaném_tvaru:

  ID_emailu Datum [Lat+Lon] Text_do_konce_emailu

      -nebo-

  ID_emailu Datum Text_do_konce_emailu

 

 

Formát datumu Datum:

 Číselný:

  RRRRMMDDHHMM      --> 12 číslic: Rok na 4 číslice následovaný Měsícem na 2 číslice následovaný Dnem na 2 číslice. Dále Hodina na 2 číslice následovaná Minutou na 2 číslice.

  RRRRMMDD            --> 8 číslic:   Rok na 4 číslice následovaný Měsícem na 2 číslice následovaný Dnem na 2 číslice. Hodina a minuta budou nastaveny na 00:00.

  DDHHMM               --> 6 číslic:   Den na 2 číslice, dále Hodina na 2 číslice následovaná Minutou na 2 číslice. Rok a měsíc bude nastaven na momentální rok a měsíc.

  HHMM                   --> 4 číslice: Hodina na 2 číslice následovaná Minutou na 2 číslice. Rok, měsíc a den budou odpovídat momentálnímu (dnešnímu) datu.

  DD                      --> 2 číslice: Den na 2 číslice. Rok, měsíc a den budou odpovídat momentálnímu datu. Hodina a minuta budou nastaveny na 00:00.

 Písmena:

  A                       --> Jedno písmeno „A“ – aktuální den a čas.

  D                       --> Jedno písmeno „D“ – aktuální den (tedy dnešní datum). Hodina a minuta budou nastaveny na 00:00.

 

 

Příklad 1: Email/SMS přidá pro datum 28.6.2010 geografické souřadnice a text.

demo 20100628 <50.075896+14.415073> Je tu Mallorca.

 

Příklad 2: Email/SMS přidá pro datum 28.6.2010 další text.

demo 20100628 Tento text se přidá za text Je tu Mallorca.

 

Příklad 3: Email/SMS přidá pro datum 30.6.2010 text „Přepluli jsme do Itálie“, a do záhlaví dne přidá extra text „Itálie“.

demo A  %Itálie%Přepluli jsme do Neapole.

 

Příklad 4: Email/SMS přidá pro datum 30.6.2010 v čase 11:05 text.

demo 201006301105 !A zde řádek pro datum a specifický čas, řádek začne novým odstavcem.

 

 

Předpoklad:

-         Každý účastník posílá email na společný účet email2log@gmail.com

-         To pro kterého účastníka je email poslán (pro který jeho projekt), co určuje identifikátor ID_emailu. Tento identifikátor je naprosto jednoznačný a jedinečný.

-         Na text napsaný v Subject/Předmětu emailu se nebere ohled. Samotný text pro účely systému se nalezne v těle emailu – tedy tělo emailu bude dekódováno.

 

Zvláštnost Text_do_konce_emailu:

-         Pokud text začíná znakem “!” (Vykřičník), pak text za tímto znakem bude začínat na samostatném řádku.

-         Pokud text začíná znakem “%”, pak text do dalšího znaku “%” (tedy text nacházející se mezi procenty) bude označen ve zvláštním poli.

-         Více viz kapitola „Zpracování textu Text_do_konce_emailu“

 

Příklady povoleného formátu geografických souřadnic Latitude a Lontitude (zeměpisná šířka a výška):

-         <50.075896+14.415073>             … tedy stupně tečka minuty, znaménku plus uprostřed

-         <50.075896 + 14.415073>          … tedy stupně tečka minuty, znaménku plus uprostřed s mezerami

-         <50° 10.75896+15° 5.12345>     … tedy stupně mezera minuty s desetinnou tečkou

-         <50 10.75896+15 5.12345>        … tedy stupně mezera minuty s desetinnou tečkou

-         <50° 10’ 25“ + 15° 5‘ 12“>     … tedy stupně mezera minuty mezera vteřiny

-         <N50.075896 + 14.415073E>       … zápis pro určení Severní šířky a Východní délky. Písmeno pro šířku musí být na první pozici, písmeno pro označení délky musí být na poslední pozici.

Upozornění: Systém rozezná zápis souřadnic podle to, že jsou ohraničeny znaky menší a větší („<“ resp “>”) a ve vnitř je znaménko „+“ (plus).

Upozornění: Pokud nejsou uvedena písmena „N“,“S“,“E“,“W“ (tedy severní šířka, jižní šířka, východní délka, západní délka), pak je standardně předpokládána severní šířka a východní délka.

 

Pomoc námořníkům v Chorvatsku používající chorvatské mapy (např. Male Karte) v použití geografických souřadnic: Chorvatské mapy nepoužívají WGS 84 souřadnicový systém používaný v GPS přístrojích, ale systém "Bessel 1841" (Besselův elipsoid) jenž nebývá běžně dostupný v GPS přístrojích. Jak je psáno na http://www.dalmacia.org/ucebnitext/gpsi.htm : „pro chorvatské mapy se hodnota posunutí zeměpisné šířky mění v rozmezí 0 - 0,01´(cca 20 m) směrem jižním, a hodnota posunutí zeměpisné délky je 0,27´- 0,31´ (cca 380 m) směrem východním.“. Systém MhoWebLogbook proto automaticky přepočte pozici na WGS 84 a to posunem východní zeměpisné délky o střední hodnotu 0,29´.

Příklady povoleného formátu geografických souřadnic Latitude a Lontitude (zeměpisná šířka a výška) pro tyto chorvatské mapy:

-         <C50° 10.5 + 15° 5.2>

-         <C50°10.5+15°5.22>

-         <C50 10.5+15 5.21>

-         <50° 10.5+15° 5.2EC>

-         <N50° 10.5+15° 5.2EC>

-         <CN50° 10.5+15° 5.2E>

Upozornění: Systém rozezná zápis souřadnic podle to, že je použito písmeno „C“ na začátku či konci zápisu souřadnic. Písmeno „C“ musí předcházet písmenu pro šířku („N“), resp. následovat za písmenem označujícím délku („E“).

Upozornění: Systém nepracuje pro souřadnice definované „stupně tečka minuty“. Důvodem je, že tento systém je používán standardně v GPS přístrojích a nikoli chorvatských mapách.

 

 

 

Zpracování textu Text_do_konce_emailu

 

Pro vysvětlení použijeme sadu příkladů. Příklady předpokládají, že se pošlou 2 SMS pro stejný datum, popř. datum a čas, např:

demo 20100628 text1

demo 20100628 text2

Výsledkem je, že text2 se přidá za text1. Následující příklady zobrazují výsledný text (na uvozovky v příkladech neberte zřetel v čase , slouží jen pro lepší vysvětlení)

 

Příklad 5:

Text1: demo 20100628    Máma mele.

Výsledek: Máma mele.    ... mezery před a za textem „Máma mele.“ jsou smazány – na mezery se nebere zřetel.

 

Příklad 6:

Text1: demo 20100628    !Máma mele.

Výsledek: Máma mele.    ... mezery před a za textem „Máma mele.“ jsou smazány – na mezery se nebere zřetel. Následně je použit znak „!“ sloužící pro vypsání textu na samostatném odstavci.

 

Příklad 7:

Text1: demo 20100628 kole

Text1: demo 20100628 no

Výsledek: koleno    ... slovo je spojeno.

 

Příklad 8:

Text1: demo 20100628 Ahoj.

Text1: demo 20100628 Nazdar.

Výsledek: Ahoj. Nazdar.    ... slova jsou spojena s tím, že pokud první („Ahoj.“) končí tečkou, pak před dalším slovem („Nazdar.“) se automaticky přidá mezera.

 

Příklad 9:

Text1: demo 20100628 Je tu

Text1: demo 20100628 .krásně;

Výsledek: Je tu krásně;    ... slova jsou spojena s tím, že pokud druhé („krásně;“) začíná tečkou, pak se před druhé slovo („krásně;“) automaticky přidá mezera.

 

 

Upozornění:

-         Znaménka menší a větší („<“ resp “>”) jsou používány pro zvláštní případy – a to jak v rámci systému MHo Web Logbook, tak i v rámci jazyka HTML sloužícího pro zápis stránek. Můžete proto v textu použít některé prvky HTML, např.:

1.     Máma <i>mele</i> maso.   … výsledkem bude text: Máma mele maso.

2.     Máma <u>mele</u> maso. … výsledkem bude text: Máma mele maso.

3.     Máma <b>mele</b> maso. … výsledkem bude text: Máma mele maso.

-         Pokud si přejete ve vašem textu zapsat znaménka menší a větší („<“ resp “>”), pak použijte dvojitě zapsané znaménko - „<<“ resp “>>”. Mezi těmito dvojitými znaménky nesmí být mezera.

 

 

 

 

Zvláštní příkazy

 

Slouží pro nepřímou spolupráci se systémem za pomoci mobilního telefonu či emailu.

 

 

ID_emailu Datum <CLEAR_ALL>      -nebo-

ID_emailu Datum <CLEARALL>

Vymažou se všechny dříve poslané záznamy a vygeneruje se HTML stránka/soubor bez záznamů.

Příklad 10:   demo 20100628 <CLEAR_ALL>

 

 

ID_emailu Datum <CLEAR_DATE>      -nebo-

ID_emailu Datum <CLEARDATE>

Vymažou se všechny dříve poslané záznamy pro konkrétní datum a vygeneruje se HTML stránka/soubor.

Příklad 11:   demo 20100628 <CLEAR_DATE>

 

 

ID_emailu Datum <REFRESH>

Vygeneruje se HTML stránka/soubor.

Příklad 12:   demo 20100628 <REFRESH>

 

 

ID_emailu Datum <DUMP>

Vypíšou se základní informace do LOG souboru.

 

 

 

Příkazy pro vzdálené nastavení systému

 

ID_emailu Datum <SET ZOOM cele_cislo_zvetseni>

Nastavení inicializačního zvětšení mapy.

Příklad 13:   demo 20100628 Datum <SET ZOOM 10>

 

 

ID_emailu Datum <SET CENTER Lat+Lot>

Nastavení inicializačního centrálního bodu mapy.

Příklad 14:   demo 20100628 Datum <SET CENTER 50.075896+14.415073>

Pozor: souřadnice jsou odděleny znaménkem „+“ (plus), viz popis zápisu formátu souřadnic popsaný výše.

 

 

ID_emailu Datum <SET EMAILADD aaa@bbb.cz>

Přidání další emailové adresy do seznamu adres. Pokud dojde ke změně stránky, pak je na tyto adresy zaslán informační email.

Příklad 15:   demo 20100628 Datum <SET EMAILADD nekdo@adresa.com>

 

 

ID_emailu Datum <SET EMAILCLEAR>

Vymažou se seznam emailových adres – informační email při změně stránek se tak nebude zasílat.

 

 

 

Demonstrační příklad

Pro vyzkoušení systému je možno použít demonstrační příklad.

 

Adresa vygenerované stránky:

http://www.horakovi.eu/email2log/Demonstrace.html

 

Adresa vygenerované stránky pro majitele – slouží pro přehled co se přihodilo v projektu (LOG soubor):

Info: jen vlastník projektu zná ID_emailu. Bez znalosti tohoto kódu neví běžný uživatel tuto adresu. ID_emailu musí být napsán velkými písmeny.

http://www.horakovi.eu/email2log/Demonstrace_DEMO.html

 

 

Příklad 16: přidání textu pro datum 20100628:

1)     Z mobilního telefonu, operátor Vodafone, pošlete tuto SMS na číslo 2255: email2log@gmail.com demo 20100628 Můj text do konce zprávy.

2)     Po určité době budou přegenerovány obě HTML stránky na obou adresách popsaných v předchozích odstavcích.

 

 

 

Počáteční nastavení před používáním systému

 

Dříve než se začne systém používat, musí autor (nebo-li správce systému) vytvořit nový projekt. Vytvořením nového projektu vznikne kód ID_emailu.

 

Pro vytvoření projektu je nutné nastavit základní parametry projektu, jako např.:

1)     Nastavení grafických parametrů výsledné HTML stránky/souboru. Např.

a.     Barva pozadí

b.     Barva textů

c.      Nadpis umístěný v horní části stránky

2)     Geografické údaje sloužící pro mapu

a.     Souřadnice středu mapy

b.     Nastavení zvětšení náhledu mapy

3)     Adresa a přihlašovací údaje cílového webového serveru (FTP přenos)

4)     Seznam emailových adres, na které automaticky pošle systém upozornění, pokud byla vy/pře-generována nová HTML stránka.

 

 

 

Posílání MMS – posílání fotek z mobilního telefonu

 

Mobilní operátoři dosud zaslání MMS na emailovou adresu neumožňují. Proto je možno fotku (soubor typu JPG) poslat z mobilního telefonu pomocí volby Poslat email.

 

Emailová adresa nechť je email2log@gmail.com

Na Předmět/Subjekt emailové zprávy se nebere zřetel.

Foto je uloženo v příloze.

 

Tělo zprávy musí být v definovaném (normalizovaném) tvaru – viz tento dokument výše,

např: demo 20100628 Posilam foto z Benatek.

 

Na výsledném HTML soboru/stránce se foto objeví v malých rozměrech – náhledu. Kliknutím myší na náhled se foto objeví v plné velikosti.

 

Pozor: Čím větší (rozměry šířka a výška) je posílaná fotka, tím více bytů se musí z mobilního telefonu poslat, a tím více bude přenos dotyčné zprávy stát – mobilní operátor bude vymáhat po vás větší cenu. Proto doporučuji fotku před odesláním zmenšit.

 

Omezení: V jednom emailu může být jen jedna fotka. Soubor s fotka musí být formátu JPG.

 

 

Posílání několika zpráv v jednom emailu

 

Do těla jedné SMS mající jen 160 znaků se pravděpodobně vleze jen jedna zpráva v normalizovaném stavu. Pokud ale posíláme z mobilního telefonu email, pak se do těla emailu vleze více zpráv v normalizovaném stavu. Je tedy finančně asi výhodnější poslat jeden email z mobilního telefonu, než sled několika SMS.

 

Formát zprávy – z mobilního telefonu:

  ID_emailu ZPRÁVA $$$ ID_emailu ZPRÁVA

 

Formát zprávy – z počítače:

  ID_emailu ZPRÁVA       ... zde je přechod na nový řádek, další zpráva začíná dalším řádkem

  ID_emailu ZPRÁVA

 

ZPRÁVA má formát:

  Datum <Lat+Lon> Text_do_konce_emailu

     -nebo-

  Datum Text_do_konce_emailu

 

 

Vysvětlení:

-         Jednotlivé zprávy jsou tedy odděleny trojicí znaků „$” (dolar).

-         Počet zpráv ZPRÁVA může být uvedeno teoreticky nekonečně mnoho – tedy nejen dvě jak je uvedeno v odstavci „Formát zprávy“.

 

Pozor:

-         Posílejte email jako prostý text, tedy neformátovaný. Např. email zaslaný z google (gmail.com) je většinou ve Formátovaném tvaru – je použito formátování HTML. Formátovaný tvar neumí systém zpracovat.

 

 

Příklad 17:

Email z mobilního telefonu – vše psáno na jeden řádek:

  demo  20100721 Hello world.$$$ demo 20100722 A jsem zde. $$$demo 20100723 %Itálie%Hurá.

Email z počítače – co zpráva, to nový řádek:

  demo  20100721 Hello world.

  demo 20100722 A jsem zde.

  demo 20100723 %Itálie%Hurá.

 

 

 

Posílání emailů pomocí SMS

 

T-MOBILE:

 

O2:

 

Vodafone:

 

Pozor:

-         Všimněte si mezery mezi emailovou adresou a email_v_normalizovaném_tvaru , či mezi EML a adresou.

-         Ne všechny znaky jsou pro SMS podporovány – např. Vodafone při zaslání SMS obsahující znaky {,},[,],| zašle email kde místo těchto znaků je uveden jen znak ? (otazník).

-         V SMS se nesmí vyskytovat české znaky, nebo musíte vypnout podporu přenosu českých znaků v mobilu (v tom případě se české znaky neodešlou, odešle se náhrada bez češtiny – např. písmeno „s“ místo písmena „š“).

 

 

 

Závěr

 

Chcete založit projekt? Není problém, stačí napsat email autoru systému Email2log na adresu martinhorak @ centrum.cz

 

 

 

Konec souboru