Instrucţiuni de setare trimitere email

Soluţia este utilizabilă pe Windows şi pe Linux_WP.

Pentru a funcţiona cu o adresă gmail este necesară o adresă de email şi să activăm Gmail API pe platforma Google Cloud.

Pentru a funcţiona cu o adresă proprie de email este necesară o adresă de email, o parolă. Noi promovăm Gmail pentru o funcţionare fără probleme, deci recomandăm crearea unei adrese gmail, dacă nu există!

c1) Configurări generale

c11) Configurare cataloage şi hUTIL:

Fişiere resurse:

dbf\IMG\EMAIL\E_JPG.JPG  - Fişier imagine, pentru Varianta Optiune email+
dbf\LOG\EMAIL\E_LOG.TXT  - Fişier log, pentru ambele variante.

Configuraţi următoarele aliasuri în HUTIL:

Catalogul fişiere resurse: 'ppr' este deja configurat pentru HPRINT
Tipurile de documente H..: daca se transmit documente HPRINT, in Model va fi secventa
                           IMPRIMANTA= nume imprimanta pdf
                           // Nume fisier creat cu PDFCreator: nr.fac si cod client
                           {D}DOCNAME=F{Nr  }_{CodC  }
Catalogul PDF:             'pdf' indică catalogul în care se afla pdf-urile
                            de transmis, numele pdf-ului trebuie să fie Fnrfac.PDF
                            sau nrfac.PDF
Catalogul PRN:             'prn' daca se transmit documente model H,
                                 se va seta cccccc.lst,  caz in care se genereaza
                                   fisiere cu nume <nrfac>.PDF sau
                                 se va seta ccccccc/lst. caz in care se genereaza
                                   fisiere cu nume F<nrfac>.PDF       
Catalogul LOG:             'log' este necesar pentru log-uri email
Catalogul IMG:             'img' este necesar pentru Varianta Opţiune email

c12) Configurare parametri în hMARFA

Pentru trimiterea de email-urilor trebuie să configuraţi parametrii în hMARFA în funcţie de serverul de email folosit(GMAIL_API,MAIL_SRV).

La GMAIL_API:

// Configuratie pentru trimitere email prin Gmail API
SRV_TYPE := "GMAIL_API"
// Adresa de la care se trimite email-ul
FROM:="facturi_firma@gmail.com"

După ce aţi configurat parametrii, trebuie să creaţi un token din Gmail Cloud. Instrucţiuni pentru descărcare token din Gmail Cloud: instructiuni descarcare Gmail token

Tutorial descărcare Gmail token: https://youtu.be/YfpLrCqr9hQ

După descărcare vom redenumi fişierul JSON astfel: GOOGLE_OAUTH.JSON şi îl vom copia în DBF/MARFDEF/ respectiv DBF/SALDEF/

La MAIL_SRV:

// Configurare pentru trimitere email prin server email smpt.
SRV_TYPE := "MAIL_SRV"
// Parametri pentru operatia trimitere email
[EMAIL]
// Adresa de server email
HOST:="smtp.gmail.com"
// Port smtp
PORT:="587"
// Adresa de la care se trimite email-ul
FROM:="facturi_firma@gmail.com"
// Parola contului de la care se trimite email-ul
PSW:="parola_secreta"

c13) Configurare PDFCreator

:!: În cazul în care doriţi să imprimaţi documentele din hMARFA într-un catalog distinct faţă de alte liste PDF pe care le realizaţi, procedaţi conform instrucţiunilor pentru a seta un nou profil de imprimantă PDF...

c2) Configurarea continuţului email-ului şi personalizarea acestuia

c21) Varianta de bază

Câmpuri utilizabile în secţiunea BODY:

Pentru modificarea următoarelor câmpuri mergeţi la Formule:

Pentru modificare Subject, modificaţi valoarea de variabilă 'xf_subject' în secţiunea 'DECLARATII'.

Valorile de variabile 'xf_host', 'xf_port', 'xf_from', 'xf_password' provin din Parametri hMARFA. :!: Nu le modificati!

De exemplu:

~~ contine descriere email varianta de baza
~~ tdoc.txt tine pana la sfarsit formular
~INCEPUT
    ~DECLARATII
        ~~Este preluat din hMARFA Parametri
        xf_host       = '{xf_host}'
        xf_port       = {xf_port}
        xf_from       = '{xf_from}'
        xf_password   = '{xf_psw}'
        
        xf_printName  = '{NUMESOC}'
        
        xf_to         = [{xf_adrTo}]
        xf_attach     = [{xf_fact}]
    ~SFIRSITDECLARATII
    BODY1=Buna ziua,
    BODY2=
    BODY3=Trimit atasat factura {xf_nrFac}.
    BODY4=
    BODY5=Cu stima,
    BODY6={NUMESOC}
    BODY7={JUDET}
    BODY8={CODPOSTAL} - {LOCALITATE}
    BODY9={SEC} {S} {STRADA}, {NR} 
    BODY10=email.: {EMAIL}   
    BODY11=tel.: {TEL}
    BODY12=web.: {WEB} 
    BODY13=harta: {MAP}
    BODY14=
    BODY15=Acest email a fost trimis automat din hMARFA.
    BODY16=Pentru corespondenta nu utilizati Reply. Scrieti la adresa {EMAIL}
~SFIRSITFORMULAR

c22) Varianta Opţiune email+ (e)

:!: Atenţie: În această variantă conţinutul email-ului reprezintă o structură tip HTML.

Câmpuri utilizabile în secţiunea BODY:

Pentru modificarea următoarelor câmpuri mergeţi la Formule:

Pentru modificare Subject, modificaţi valoarea de variabilă 'xf_subject' în secţiunea 'DECLARATII'

Valorile de variabile 'xf_host', 'xf_port', 'xf_from', 'xf_password' provin din Parametri hMARFA. :!: Nu le modificati!

Exemplu:

~~ tdoc.txt tine pana la sfarsit formular
~INCEPUT
    ~DECLARATII
        ~~Este preluat din hMARFA Parametri
        xf_host       = '{xf_host}'
        xf_port       = {xf_port}
        xf_from       = '{xf_from}'xf_password   = '{xf_psw}'
        
        xf_printName  = '{NUMESOC}'
        ~~Titlul 
        xf_attach = [{xf_fact}]
        xf_html       = '{xf_html}'
        xf_html_imgs  = {'xf_image' : '{xf_image}'}
    ~SFIRSITDECLARATII
    BODY1=Buna ziua,<br />
    BODY2=<br />
    BODY3=Trimitem atasat factura {xf_nrFac}.<br />
    BODY4=<br />
    BODY5=Cu stima,<br />
    BODY6={NUMESOC}<br />
    BODY7=<br />
    BODY8=<i>Acest email a fost trimis automat din hMARFA.</i><br />
    BODY9=<i>Pentru corespondenta nu utilizati Reply. 
             Scrieti la adresa de email de mai jos.</i><br/> 
~SFIRSITFORMULAR
<!--- contine descrierea email-ului in htm, logo-ul este definit in Formule --->
<html> 
...
</html>

c3) Testaţi trimiterea email-ului