QBS >> Elementy standardowe >> QM-Emailer >> Podręcznik informatyka

QM-Emailer

Potrzebne pliki |  Podłączenie do programu |  Format wiadomości pocztowych |  Pytania informatyków

Potrzebne pliki

Aby podłączyć moduł QM-Emailer należy do katalogu głównego z programem przekopiować dwa pliki "email.qcon" i "email.txt". Pliki te można pobrać w tym miejscu (obydwa pliki są spakowane, należy je rozpakować). Po tej operacji katalogu główny programu wzbogacił się o dwa pliki. Teraz można rozpocząć podłączanie modułu QM-Emailer do programu

Podłączenie do programu

Pierwszym krokiem jaki należy wykonać to zmiana w pliku konfiguracyjnym "qline.txt" (katalog główny programu). Do pliku należy dodać dwa wpisy. Pierwszy który informuje program z którego wpisu w bibliotece na korzystać moduł, a drugi gdzie znajduje się plik konfiguracyjny do modułu QM-Emailer. Drugi wpis należy umieścić tuż przed nawiasem zamykającym rekord. 

"EMAIL",                "email.qcon",           "qline.email.EMailTrigger";

EMail = file "email.txt";

Po całej operacji plik "qline.txt" powinien wyglądać tak jak ten poniżej 


record
{

  Sep = record
  {
     Host = "seplib" ;
     Port = 2507;
  };


  Application = record
  {

    Modules = recordarray
    {
      MODULE,         QCON,                        TRIGGER_SET;//,    TRANSLATION_FILE;
      "LARRANGER",    null,                        "qline.labelsarranger.LabelsArrangerTrigger";
      "QTENBERG",     "qtenberg/qtenberg.qcon",    "qline.qtenberg.QtTrigger";
      "EMAIL",        "email.qcon",                "qline.email.EMailTrigger";
      "QLINE",        null,                        "qline.export.ExportTrigger";
      "QLINE",        null,                        "qline.misc.TextImporterTrigger";
      "QLINE",        null,                        "qline.qlicense.LicenseTrigger";
      "QLINE",        null,                        "qline.misc.ColorMaskSelectorTrigger";
      "QLINE",        null,                        "qline.tools.TriggerNarrowBrowser";
      "QLINE",        null,                        "qline.backup.triggers.BackupTrigger";
      "QLINE",        null,                        "qline.misc.GroupStatisticsTrigger";
       //--------------------------------------------------------------------------------
      "QSZKIELET",      "qcon/struct.qcon",          null;

        };
        Title = "Q-Szkielet 3000";
        BackgroundImage="pic/Qbslogo.jpg";
        DateEditFormat="YYYY.MM.DD";
        DefaultHtmlViewer = "explorer";
        BrowserColumns = "true";
    };
        EMail = file "email.txt";
}

Po zapisaniu zmian w pliku można uruchomić program. Ponieważ dodawaliśmy nowy moduł do programu co wiąże się z dodaniem nowych tabel pierwsze uruchomienie jest traktowane jako uruchomienie techniczne podczas którego program nie uruchomi się. Zostanie stworzony plik "struct.qsr", a w pliku out.txt znajdziemy informację o brakującej tabeli. W takim przypadku należy z katalogu głównego programu przekopiować do katalogu dat plik "struct.qsr" i ponowic próbę uruchomienia programu. W tym przypadku program powinien uruchomić się bez problemów.

Drugim krokiem przy dodawaniu modułu QM-Emailer do programu jest edycja pliku "struct.qcon" należy tam wpisać następujące polecenia (należy to wpisać na początku pliku po wywołaniu menu głównego) 

MENU DodMenu
    TITLE="Dodatkowe opcje"
    POS=50 50
{
ID               ACTION            NAME;
EMAIL            EMAIL_SENDER ;    "Wyślij E-mail";
}

Nasze MENU DodMenu należy dopisać w menu głównym (tam gdzie wywoływany jest browser) 

ID         ACTION                           SHORTCUT    NAME                   ; 
ADRESSES   BROWSER  ADRESSES DodMenu;          A        "Spis adresów"         ;

Po wprowadzonych zmianach plik "struct.qcon" powiniem wyglądać tak jat ten poniżej (Prezentujemy tylko część pliku dotyczącą menu programu. Reszta pliku pozostaje bez zmian) 

//---------------------------------------------------------------------------
// POCZĄTEK:  MainMenu
//---------------------------------------------------------------------------
MENU MainMenu

    TITLE="Menu główne  "
    POS=75 20

{
ID         ACTION                           SHORTCUT    NAME                   ;
PODR       MENU PodrMenu                       P        "Komplet podręczników" ;
FunSys     MENU SysMenu                        S        "Operacje systemowe"   ;
MYDATA     RECEDIT  TAB=SYSED_MOJE_DANE;       M        "Moje dane"            ;
ADRESSES   BROWSER  ADRESSES DodMenu;          A        "Spis adresów"         ;
}

MENU DodMenu
    TITLE="Etykiety adresowe"
    POS=50 50
{
ID               ACTION                                          NAME;
EMAIL            EMAIL_SENDER ;                                  "Wyślij E-mail";
}
//---------------------------------------------------------------------------
// KONIEC:  MainMenu
//---------------------------------------------------------------------------

Po zastosowaniu zmian można uruchomić program. W spisie adresów pojawiła się nowa ikona, która uruchamia okno "Dodatkowe menu" (dostępne również pod klawiszem [F2]). Po wywołaniu tego okna uzyskujemy dostęp do modułu QM-Emailer, możemy wysyłać e-maile z programu.

Format wiadomości pocztowych

Ogólnie

Wiadomości pocztowe są wysyłane z klienta do serwera zgodnie z protokołem SMTP. Format wiadomości został zdefiniowany w dokumencie "Standard for the format of ARPA internet messages" (RFC #822) i rozwijany w kolejnych aktualizacjach.
Celem standaryzacji było stworzenie formatu:

Opis formatu wiadomości

Poniżej przybliżone zostały wyłącznie podstawowe wiadomości na temat formatu.
Na wiadomość składają się:

Należy pamiętać, że znakiem przejścia do następnej linii jest CRLF. Dotyczy to zarówno treści wiadomości, jak i kolejnych pól nagłówka (każde występuje w oddzielnej linii, a w szczególnych przypadkach może zająć ponad jedną linię). Przed wysłaniem wiadomości należy zadbać o to, aby linie były rozdzielone tym termem. W przeciwnym wypadku otrzymamy efekt sklejania linii. Wiadomość należy także przekonwertować zgodnie z podanym zestawem znaków (charset).
W polu temat musi być osobno informacja, że to pole też ma być interpretowane zgodnie z określonym zestawem znaków.

Ogólnie dobrym źródłem informacji na temat specyfiki poszczególnych pól nagłówka, jest (obok dokumentacji) prześledzenie otrzymanych wiadomości o żądanych cechach. Większość klientów pocztowych pozwala na podejrzenie źródeł wiadomości. Jeśli nawet nie, to niemal zawsze można zapisać wiadomość w formacie eml i przejrzeć ją w edytorze tekstowym.

Kodowanie załączników

Załączniki są sekwencyjnie doklejane do bieżącej postaci wiadomości. W ten sposób wiadomość składa się z wielu części (multipart).
Mogą mieć w szczególności charakter binarny. Bez różnicy, czy faktycznie tak jest, czy nie są one odpowiednio kodowane przed włączeniem do wiadomości.

Stosowane są dwa sposoby kodowania:

Obie metody są bezstratne. Ogólnie BinHex prowadzi do podwojenia wielkości załącznika, co w wielu wypadkach jest niedopuszczalne. Z tego względu powszechnie stosowane jest kodowanie base64

Format eml

Często występuje potrzeba zapamiętania wiadomości pocztowej. Pomimo że niektórzy producenci proponują własne formaty (np. msg), to najbardziej naturalnym jest zapis wiadomości w postaci, która jest przekazywana w internecie. Należy pamiętać, że w ten sposób zapisujemy wiadomość otrzymaną. Zawiera ona zarówno informacje z nagłówka, jak i samą treść z załącznikami. Pomimo że format jest tekstowy i częściowo zrozumiały dla odbiorcy, to do poprawnej interpretacji zapisanej wiadomości potrzebny jest klient poczty.

Pytania informatyków w sprawie modułu QM-Emailer

Data Pytanie Kto Odpowiedź