F_MAIL_CHILKAT()
Siuntimas elektroniniu paštu tiesiogiai per pašto serverį, naudojant CHILKAT bibliotekas. Prisijungimui tiesiogiai prie pašto serverio naudojamas SMTP protokolas.
(nuo 115 RIV_GAMA versijos)
Ši funkcija leidžia siųsti laiškus naudojant Office365 arba MS Exchange serverį reikalaujantį TLS sertifikato (587 portas).
Detaliau apie CHILKAT bibliotekos objektus aprašyta CHILKAT bibliotekos objektai.
Naudojimo apribojimai :
- Biblioteka CHILKATAX-9.5.0-WIN32.DLL turi būti registruojama kiekvienoje darbo vietoje – registruojama automatiškai pirmą kartą paleidus funkciją, naudojančią Chilkat biblioteką (pvz. f_mail_chilkat).
- Bibliotekos registravimui reikalingos administratoriaus teisės. Jei Rivile GAMA vartotojas tokių teisių neturi – registruoti biblioteką kompiuteryje gali administratorius paleisdamas RIV_GAMA kataloge esantį CHILKAT_INSTALL.BAT failą.
Sintaksė
F_MAIL_CHILKAT(tcTo, tcSubject, tcBodyPlain, [tcFiles], [tcBodyHTML], [tcCC], [tcBCC], [tcFrom], [tcModul], [tcCommand], [tnTimeSpan])Grąžina
.T. - jei išsiųsta be klaidų, priešingu atveju - klaidos pranešimą
Parametrai
| Parametras | Aprašymas | Formatas |
|---|---|---|
| tcTo | el. pašto adresas - gavėjas | C |
| tcSubject | laiško pavadinimas | C |
| tcBodyPlain | laiško turinys paprastu tekstu | C |
| tcFiles | prisegami failai išvardinti per kabliataškį | C |
| tcBodyHTML | laiško turinys HTML formatu (formatizuotas tekstas) | C |
| tcCC | laiško kopijos gavėjas | C |
| tcBCC | laiško kopijos nematomas gavėjas | C |
| tcFrom | nuo adresato (pagal nutylėjimą account vartotojo vardas) | C |
| tcModul | modulis pagal kurį imami prisijungimo duomenys iš parametrų sąrašo | C |
| tcCommand | programa prieš laiško siuntimą (papildyti laiško turinį, išplėstinius laiško nustatymus ir pan.) | C |
| tnTimeSpan | laiko intervalas (sekundėmis) tarp siuntimų. Pavyzdžiui, pagal Office365 reikalavimus – galima išsiųsti ne daugiau kaip 30 laiškų per minutę, todėl būtų nurodomas 2 sekundžių intervalas tarp siuntimų. | N |
Pavyzdžiai
f_mail_CHILKAT("info@testas.lt","Antraštė","Laiško tekstas","c:\test.txt")
Pastaba 1
"Servisas" -> "Administravimas" -> "Parametrai" užpildomos prisijungimo parametrų reikšmės:
SS_SMTP_SERV - El. pašto serveris (Server / IP , Port)
SS_SMTP_SAUG - El. pašto saugumas (SSL , TLS)
SS_SMTP_VART- El. pašto vartotojas (Vardas , Slaptažodis)
Pastaba 2
Siunčiant per Office 365, standartiniai nustatymai:
Server : smtp.office365.com
Port : 587
SSL : Ne
TLS : Taip
Nurodomas vartotojas vardas ir slaptažodis. Šiam vartotojui MFA (dvigubo autentifikavimo) funkcionalumas turėtų būti išjungtas.
Office365 vartotojui turi būti suteikta teisė naudotis SMTP protokolu, pagal nutylėjimą visiems vartotojams tokia galimybė būna išjungta.
Pastaba 3
Naudojant CHILKAT kaip pagrindinį laiškų siuntimo metodą, sistemos INIT-e turi būti užprogramuota:
titi_pagr.smtp_server=[f_mail_chilkat(_adresas,_antraste,_tekstas,_failas)]
Jeigu laiškų siuntimui iš Rivile GAMA naudojama Gmail pašto dėžutė, ją reikia papildomai sukonfigūruoti.
Pastaba 4
Siunčiant laiškus funkcijų F_MAIL_CDO() ir F_MAIL_CHILKAT() pagalba, yra galimybė nurodyti laiško kopijos gavėjų adresus.
Jie aprašomi parametre SS_SMTP_KOP.