Invio di email sfruttando la classe cl_bcs

Buongiorno,  vediamo come inviare email  con SAP usando la classe CL_BCS.

Fino a l’avvento della classe CL_BCS in SAP l’invio delle email avvenivano attraverso il function module SO_DOCUMENT_SEND_API1 ( fino alla 6.10) molto più semplice e snella da utilizzare.

Non solo è molto più duttile permettendo per esempio come vedremmo dopo di poter scegliere la tipologia di destinatario ( sap, lista di distribuzione o email esterna).

Vediamo quindi i metodi di cui avremmo bisogno per inviare una mail.

•  Create persistent
•  Create document
•  Set  document

1.        Il primo passo per inviare una mail la creazione dell’oggetto mail .

L     L’oggetto email è un semplice oggetto binario, bisogna quindi aggiungere alla mail un corpo, un   titolo e specificare mittente e destinatario.

2        

           2.       Il secondo passo è quindi creare il documento che agganceremo all’oggetto email.

La classe cl_document_bcs è una classe molto ricca e consiglio vivamente di darvi un occhio per scoprire tutte i metodi che offra per personalizzare  le email .

Al momento ci soffermiamo sul  metodo create document

Questo metodo innumerevoli parametri  ma useremo per la nostra email solo 6 (I_TYPE, I_SUBJECT, I_LENGTH, I_TEXT, I_SENDER).

Il parametro I_TYPE definisce la tipologia di email che si voglia creare ( text, html, etc…) , i valori che può assumere sono contenuti nella tabella tsotd. Per un email semplice il valore ‘RAW’ è quello indicato.

Il parametro I_SUBJECT è il titolo della mail,

                       I_LENGTH la dimensione della mail,

                       I_TEXT è il contenuto della mail

                       I_SENDER è il mittente della mail

A questo punto possiamo inserire il documento creato al nostro oggetto email

                                          ob_send_request->set_document( lo_document ).

Abbiamo scritto la mail, dobbiamo adesso mandarla e quindi inseriamo il mittente e il destinatario.

Per questo caso semplice indicheremmo semplice utente sap ( approfondiremmo in un altro articolo le tipologie di mittenti e destinatari delle mail)

Il destinatario invece sarà un email esterno

A questo punto possiamo inviare la mail e scegliere se effettuare l’invio immediato o aspettare che il job che invia le mail giri.

Ecco la nostra prima email con la nuova classe, nei prossimi post entremmo un pò di più nei dettagli!