PMAIL100

Osnovni podaci

Oznaka	PMAIL100
Naziv	Slanje ispisa dokumenta e-mailom
Opis	Slanje ispisa dokumenta e-mailom

Namjena

Modul PMAIL100 koristi se za za slanje ispisa dokumenta e-mailom.

Poziva se odabirom funkcije za slanje ispisa dokumenta e-mail-om s kontrolne ploče u kontekstu rada s određenim dokumentom.

Mogućnosti ugrađene u modul:

• Opcija da se datoteke priložene e-mail poruci nakon slanja poruke prilože i dokumentu u kontekstu u F4B-u
• Opcije notifikacije pošiljatelja o statusu isporuke i primitka e-mail poruke
• Adrese za CC i BCC mogu se dohvatiti proizvoljnom SQL skalarnom funkcijom

Izgled ekrana

 

Kratak opis modula

Modul se ugrađuje na kontrolnu ploču za sve dokumente koje je potrebno poslati e-mail-om (npr. narudžbenica).

Način rada

Modul se aktivira u kontekstu rada s određenim dokumentom. Dovoljno je iz liste dokumenata označiti dokument za koji se šalje e-mail i kliknuti na funkciju Slanje dokumenta na e-mail, PMAIL100 s kontrolne ploče. dokument će biti poslan na e-mail adrese ukoliko su sve postavke slanja ispravno postavljene.

Vezana poglavlja

Konfiguracija kontrolne ploče

Ugradnja u sustav

Modul se ugrađuje na kontrolnu ploču u radnom kontekstu željene aplikacije na nivou dokumenta.

Postavke PMAIL100

Ulazni parametri

DprotocolID

OPP dokumenta koji se šalje kao ispis

DProtocolIDPrimatelj

OPP primatelja e-mail poruke (iz poslovnog imenika - BussPartID). Koristi se za dohvat e-mail adrese primatelja iz tablice BussMail. Ovaj parametar se koristi na isti način kao i parametar BussPartIDKupac u LoadArgumets, a uveden je kao ulazna vrijednost zbog kompatibilnosti sa XAML modulima. Radi zadržavanja prethodne funkcionalnosti, ovaj parametar se ignorira ako BussPartIDFieldName producira vrijednost. Ako dokument koji se želi poslati ne sadrži prikladan identifikator primatelja, za dohvat e-mail adrese primatelja može se koristiti općenitija metoda sa parametrom RecipientAddressFunctionName

Parametri poziva modula (LoadArguments)

AuthMethod	Način autorizacije na web servis report servera (default je CurrentUserCredentials). Moguće vrijednosti: CurrentUserCredentials - na web servis se prijavljuje kao trenutno prijavljeni windows korisnik UserNetworkCredentials - na web servis se prijavljuje kao Network service Anonymous - na web servis se spaja kao anonimni korisnik
BussPartIDFieldName	Naziv polja koje se dohvaća iz konteksta a predstavlja ID poslovnog partnera kome se šalje e- mail poruka. Na temelju te vrijednosti se iz baze dohvaćaju e-mail adrese koje se postavljaju u polje 'Primatelj'. Default vrijednost je 'BussPartIDKupac'. Ako je modul u kontekstu XAML modul, onda umjesto ovog parametra treba koristiti ulaznu vrijednost DProtocolIDPrimatelj ili parametar RecipientAddressFunctionName.
DefaultSubject	Naslov poruke koji se kreira automatski. Na upisani tekst se nastavlja broj dokumenta tako da je dobro da vrijednost ovog parametra bude npr. 'Ponuda broj: ' -> kreirani naslov poruke de biti 'Ponuda broj: 12345'.
ReportName	Naziv (i put do) reporta koji se šalje e-mailom. Ako naziv nije upisan, dohvaća se iz baze podataka prema vrsti odabranog dokumenta. Primjer: '/TestReport' ReportRenderFormat Format u kojem se kreira dokument koji se želi poslati e-mailom. Moguće vrijednosti su: PDF – (default) dokument se kreira kao attachment u PDF formatu MHTML - dokument se kreira kao attachment u MHTML formatu HTML4_0 – dokument se prikazuje u HTML editoru i moguće ga je mijenjati.
ReportServer	Adresa Microsoft Reporting Services servera (npr. http://demo/ReportServer)
SignatureFile	Put do i ime HTML datoteke koja se učitava kod kreiranja e-mail poruke. Praktično za datoteku potpisa. Datoteka se neće učitavati ako je vrijednost parametra ReportRenderFormat = HTML4_0 kada se vrijednost ovog parametra ignorira.
SMTPServer	Server putem kojeg se šalje e-mail poruka (npr. xxxx.netlab.hr).
ReportParameters	Lista parametara u obliku: Naziv1|Vrijednost1;Naziv2|Vrijednost2 Nazivi su nazivi parametara reporta (bez znaka '@'), a vrijednosti su stvarne vrijednosti parametara. Tipovi podataka za parametre se ne provjeravaju unaprijed pa treba paziti da ne dođe do pogreške prilikom konverzije navedene vrijednosti u tip parametra.
ReportParametersFromContext	Lista naziva polja koje se iz konteksta prenose u parametar izvješća u obliku: NazivPoljaIzKonteksta1|NazivParametra1;NazivPoljaIzKonteksta2|NazivParametra2 Za dohvat vrijednosti polja iz konteksta koristi se RefererContext objekt pa može biti problema ako je u pozadini XAML modul (nije do kraja testirano).
AddSenderToBCC	Indikator da li će se adresa pošiljaoca automatski dodati u BCC polje (slanje kopije e-mail poruke samom sebi). Default vrijednost je True.
RecipientAddressFunctionName	Naziv SQL skalarne funkcije za dohvat e-mail adresa primatelja. Navodi se obavezno shema i naziv funkcije npr. CUST.GetToMailAddress bez parametara i zagrada. Funkcija navedenog naziv mora postojati u bazi podataka i mora biti skalarna tipa VARCHAR i primati jedan integer parametar s nazivom @DProtocolID. Ako je potrebno da funkcija vrati više od jedne e-mail adrese, pojedine adrese treba razdvojiti znakom ';' bez dodanih razmaka. Funkcija de se koristiti ako niti parametar BussPartIDFieldName niti ulazna vrijednost DProtocolIDPrimatelj ne produciraju valjanu vrijednost.
AddAttachmentsToF4B	Indikator da li se prilozi poslani e-mailom automatski dodaju kao F4B prilozi dokumentu u kontekstu. Prilozi se kreiraju nakon uspješnog slanja e-mail poruke. Ako se dogodi pogreška F4B prilozi neće biti kreirani. U opisu F4B priloga navedeno je kada i kome je priložena datoteka poslana.
CCAddressFunctionName	Naziv SQL skalarne funkcije za dohvat e-mail adresa primatelja kopije e-mail poruke (CC). Navodi se obavezno shema i naziv funkcije npr. CUST.GetCCMailAddress bez parametara i zagrada. Funkcija navedenog naziv mora postojati u bazi podataka i mora biti skalarna tipa VARCHAR i primati jedan integer parametar s nazivom @DProtocolID. Ako je potrebno da funkcija vrati više od jedne e-mail adrese, pojedine adrese treba razdvojiti znakom ';' bez dodanih razmaka.
BCCAddressFunctionName	Naziv SQL skalarne funkcije za dohvat e-mail adresa primatelja kopije e-mail poruke (BCC). Navodi se obavezno shema i naziv funkcije npr. CUST.GetBCCMailAddress bez parametara i zagrada. Funkcija navedenog naziv mora postojati u bazi podataka i mora biti skalarna tipa VARCHAR i primati jedan integer parametar s nazivom @DProtocolID. Ako je potrebno da funkcija vrati više od jedne e-mail adrese, pojedine adrese treba razdvojiti znakom ';' bez dodanih razmaka.
DeliveryNotification_OnSuccess	Opcija slanja notifikacije o isporuci pošiljatelju za slučaju kada je isporuka e-mail poruke uspješno izvršena. Parametar određuje default vrijednost opcije prikazane na korisničkom sučelju.
DeliveryNotification_OnDelay	Opcija slanja notifikacije o isporuci pošiljatelju za slučaju kada je isporuka e-mail poruke odgođena zbog nekog razloga. Parametar određuje default vrijednost opcije prikazane na korisničkom sučelju.
DeliveryNotification_OnFailure	Opcija slanja notifikacije o isporuci pošiljatelju za slučaju kada isporuka e-mail poruke nije izvršena. Parametar određuje default vrijednost opcije prikazane na korisničkom sučelju.
RequestReadReceipt	Opcija uključuje/isključuje zahtjev za slanje potvrde primitka poruke od svih primatelja. Program za čitanje e-mail poruka de prilikom otvaranja ove poruke pitati primatelja da li želi poslati potvrdu da je ovu poruku pročitao. Funkcionalnost ove opcije ovisi o tome da li je podržana od strane programa kojeg primatelj koristi za čitanje e-mail poruka.

Napomene

Funkcionalnost opcija slanja notifikacije o statusu isporuke e-mail poruke (DeliveryNotification_OnSuccess, DeliveryNotification_OnDelay, DeliveryNotification_OnFailure) moguda je samo ako korišteni SMTP server podržava takvu funkcionalnost. Korišteni SMTP server mora podržavati DSN (Delivery Status Notification) prema ESMTP (Extended Simple Mail Transfer Protocol) specifikaciji. Jednostavan način provjere da li server implementira ESMTP i podržava DSN je slanje EHLO naredbe serveru. Ako server podržava DSN u odgovoru na EHLO naredbu mora se nalaziti stavka 250-DSN.