%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
\\
\\
!!! Prerequisiti\\
Installazione e configurazione dello SMENS per il funzionamento della £G53.\\
\\
!!! Configurazione invio e-mail\\
\\
Lo scopo del costruttore LOA17 è la configurazione delle modalità di invio delle e-mail.\\
Le impostazioni vengono scritte in membri LOA17* del file SCP_SET .\\
\\
Lo script è composto da sezioni (tag SEZ) e subsezioni (tag SUB).\\
L'identificazione e l'indirizzamento di un tipo mail è quindi data da un codice composto dal suffisso del membro (per 2 caratteri) più sezione e subsezione per tre caratteri ciascuno.\\
Quindi, ad esempio, X1.A01.001 indica un tipo mail definito nel membro LOA17_X1 sezione A01, subsezione 001.\\
\\
!! Invio della mail tramite il servizio B£SER_85\\
L'invio della mail avviene tramite il richiamo del B£SER_85 tramite una funzione A(EMU , una funzione A con entry del servizio invece che entry funizzata.\\
__Esempio di chiamata:__\\
A(EMU;B£SER_85;MAI.OGG) 1(;;X1.A01.001)  2(CN;CLI;&CO.Cod) INPUT(SJ(Report del 20230828) TX(#TEXT#/Smedoc/testo.html))\\
\\
||Parametro||Valore||Descrizione
|Metodo | MAI.OGG | Invio dell'e-mail ad un oggetto\\
|Oggetto 1 | es. 1(;;X1.A01.001) | Tipo mail per la configurazione dell'invio\\
|Oggetto 2 | es  2(CN;CLI;&CO.Cod) | Oggetto da cui reperire il destinatario (se non presente il destinatario deve essere impostato nello script del tipo mail oppure tramite attributo EM() nell'INPUT della chiamata\\
|Attributi nell'INPUT della chiamata | EM() | Indirizzo del destinatario\\
| | CC() | Indirizzo a cui inviare in copia conoscenza\\
| | BC() | Indirizzo a cui inviare in copia conoscenza nascosta\\
| | FR() | Indirizzo del mittente\\
| | SJ() | Oggetto dell'e-mail\\
| | TX() | Testo del corpo dell'e-mail L'attributo TX() può anche rimandare ad un file di testo o html su IFS con la stessa sintassi usata per la £G53 (es.: TX(#TEXT#/Smedoc/testo.html) )\\
| | FL() | Cartella sull'IFS in cui reperire i file da allegare. Il percorso va scritto relativamente al Server IBM i (con / )\\
| | AT() | Nomi dei file da allegare separati da ';' . E' anche possibile specificare tutti i file che iniziano con un prefisso (ex XXX*)\\
| | TF() | Estensione dei file da allegare. Accetta * per tutti i tipi di file\\
| | CA(1) | Cancella l'allegato dopo aver inviato la mail\\
\\
\\
_h_N.B.: Il funzionamento degli attributi impostati nell'INPUT dipende dalla presenza delle corrispondenti variabili &CO. nello script LOA17_* (come specificato in seguito)\\
\\
\\
\\
\\
!! I tag utlizzati nello script LOA17_*\\
\\
! MAI.TPM\\
E' il tag più importante. Contiene le informazioni relative al reperimento degli indirizzi e-mail del mittente e dei destinatari e configura la modalità di esecuzione dell'invio mail. Deve esserci un solo tag MAI.TPM per ogni subsezione.\\
\\
||Attributo||Descrizione||Spiegazione||Sostituzione
|__Test__ | Modalità test                 | __=' ' : Non invia la mail e scrive una stampa di controllo; ='1' :Invia la mail all'indirizzo di test specificato in TstM ; ='2' :Invia effettivamente la mail__ |\\
|__CFTo__ | Funz. Aziendali / Mail  To    | Determina il reperimento dell'indirizzo a cui inviare la mail. Se attivi i referenti, può contenere la mailing list che deve essere attribuita al referente per essere preso in considerazione (divisa da ";" ne può essere indicata anche più di una), se invece NON sono attivi i referenti, può contenere la funzione aziendale (V£F) su cui cercare tramite £G85 l'e-mail dell'oggetto ricevuto (come per la mailing list dei referenti può anche essere indicato un elenco diviso da ";" di funzioni aziendali, che verranno risalite per trovare i corrispondenti referenti). E' inoltre possibile impostare come ultima risalita *FIRST in modo che restituisca l'e-mail associata alla prima funzione aziendale trovata. L'attributo accetta in alternativa l'impostazione di un indirizzo e-mail. | Qualora nello script sia impostato &CO.EM il valore viene recepito dall'attributo EM() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__CFCc__ | Funz. Aziendali / Mail  Cc    | Determina il reperimento dell'indirizzo a cui inviare la mail in copia conoscenza. Se attivi i referenti, può contenere la mailing list che deve essere attribuita al referente per essere preso in considerazione (divisa da ";" ne può essere indicata anche più di una), se invece NON sono attivi i referenti, può contenere la funzione aziendale (V£F) su cui cercare tramite £G85 l'e-mail dell'oggetto ricevuto (come per la mailing list dei referenti può anche essere indicato un elenco diviso da ";" di funzioni aziendali, che verranno risalite per trovare i corrispondenti referenti). E' inoltre possibile impostare come ultima risalita *FIRST in modo che restituisca l'e-mail associata alla prima funzione aziendale trovata. L'attributo accetta in alternativa l'impostazione di un indirizzo e-mail. | Qualora nello script sia impostato &CO.CC il valore viene recepito dall'attributo CC() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__CFBc__ | Funz. Aziendali / Mail  Bcc   | Determina il reperimento dell'indirizzo a cui inviare la mail in copia conoscenza nascosta. Se attivi i referenti, può contenere la mailing list che deve essere attribuita al referente per essere preso in considerazione (divisa da ";" ne può essere indicata anche più di una), se invece NON sono attivi i referenti, può contenere la funzione aziendale (V£F) su cui cercare tramite £G85 l'e-mail dell'oggetto ricevuto (come per la mailing list dei referenti può anche essere indicato un elenco diviso da ";" di funzioni aziendali, che verranno risalite per trovare i corrispondenti referenti). E' inoltre possibile impostare come ultima risalita *FIRST in modo che restituisca l'e-mail associata alla prima funzione aziendale trovata. L'attributo accetta in alternativa l'impostazione di un indirizzo e-mail. | Qualora nello script sia impostato &CO.BC il valore viene recepito dall'attributo BC() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__OFro__ | Ogg. Funz. Azi.  From         | Oggetto su sui effettare il reperimento dell'indirizzo e-mail del mittente in caso in From si imposti una funzione aziendale anziché direttamente un indirizzo e-mail |\\
|__From__ | Funz. Aziendali / Mail  From  | Determina il reperimento dell'indirizzo del mittente. Se attivi i referenti, può contenere la mailing list che deve essere attribuita al referente per essere preso in considerazione (divisa da ";" ne può essere indicata anche più di una), se invece NON sono attivi i referenti, può contenere la funzione aziendale (V£F) su cui cercare tramite £G85 l'e-mail dell'oggetto ricevuto (come per la mailing list dei referenti può anche essere indicato un elenco diviso da ";" di funzioni aziendali, che verranno risalite per trovare i corrispondenti referenti). E' inoltre possibile impostare come ultima risalita *FIRST in modo che restituisca l'e-mail associata alla prima funzione aziendale trovata. L'attributo accetta in alternativa l'impostazione di un indirizzo e-mail. | Qualora nello script sia impostato &CO.FR il valore viene recepito dall'attributo FR() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__OTst__ | Ogg. Funz. Azi.  segnalazioni | Oggetto su sui effettare il reperimento dell'indirizzo e-mail del mittente in caso in TstM si imposti una funzione aziendale anziché direttamente un indirizzo e-mail |\\
|__TstM__ | Funz. Az./ Mail  segnalazioni | Determina il reperimento dell'indirizzo a cui inviare notifica di anomalie e che viene utilizzato come destinatario nell'invio di test. Se attivi i referenti, può contenere la mailing list che deve essere attribuita al referente per essere preso in considerazione (divisa da ";" ne può essere indicata anche più di una), se invece NON sono attivi i referenti, può contenere la funzione aziendale (V£F) su cui cercare tramite £G85 l'e-mail dell'oggetto ricevuto (come per la mailing list dei referenti può anche essere indicato un elenco diviso da ";" di funzioni aziendali, che verranno risalite per trovare i corrispondenti referenti). E' inoltre possibile impostare come ultima risalita *FIRST in modo che restituisca l'e-mail associata alla prima funzione aziendale trovata. L'attributo accetta in alternativa l'impostazione di un indirizzo e-mail. __La segnalazione di anomailia si genera qualora non sia reperito il mittente, il destinatario o uno dei file da allegare__ |\\
\\
\\
! MAI.TXT\\
Contiene le informazioni relative all'oggetto e al testo dell'e-mail. Deve esserci un solo tag MAI.TPM per ogni subsezione.\\
\\
||Attributo||Descrizione||Spiegazione||Sostituzione
|__Sbj__  | Oggetto della mail        | Testo che appare nell'oggetto della mail | Qualora nello script sia impostato &CO.SJ il valore viene recepito dall'attributo SJ() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__Txt__  | Testo                     | Testo che appare nel corpo della mail  | Qualora nello script sia impostato &CO.TX il valore viene recepito dall'attributo TX() ricevuto nell'INPUT della chiamata del B£SER_85. L'attributo TX() può anche rimandare ad un file di testo o html su IFS con la stessa sintassi usata per la £G53 (es.: TX(#TEXT#/Smedoc/testo.html) )\\
|__FldT__ | Cartella su IFS           | Cartella sull'IFS in cui reperire il file di testo contenente il corpo della mail. Il percorso va scritto relativamente al Server IBM i (con  / ) |\\
|__FilT__ | File contenente il testo  | Nome del file di testo contenente il corpo della mail |\\
|__ScpF__ | File sorgente AS400       | File sul Server IBM il cui membro contiene il corpo della mail |\\
|__ScpM__ | Membro AS400 con il testo | Membro contenente il corpo della mail |\\
\\
\\
! MAI.ATT\\
Contiene le informazioni relative al reperimento degli allegati.  Possono esserci più tag MAI.TPM per ogni subsezione.\\
\\
||Attributo||Descrizione||Spiegazione||Sostituzione
|__NFld__ | Cartella su IFS            | Cartella sull'IFS in cui reperire i file da allegare. Il percorso va scritto relativamente al Server IBM i (con / ) | Qualora nello script sia impostato &CO.FL il valore viene recepito dall'attributo FL() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__NFil__ | Files da allegare (sep. ;) | Nomi dei file da allegare separati da ';' . E' anche possibile specificare tutti i file che iniziano con un prefisso (ex XXX*) | Qualora nello script sia impostato &CO.AT il valore viene recepito dall'attributo AT() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__TFil__ | Estensione file            | Estensione dei file da allegare. Accetta * per tutti i tipi di file | Qualora nello script sia impostato &CO.TF il valore viene recepito dall'attributo TF() ricevuto nell'INPUT della chiamata del B£SER_85\\
|__FCnd__ | Condizioni di validazione  | Espressione di £G91 usata per condizionare il fatto che il file venga allegato. Ad esempio FCnd="&CO.Cod =01" comporta che i file vengano allegati solo se il codice dell'oggetto a cui si sta inviando la mail è 01.\\
|__Des__  | Descrizione                | Campo descrittivo |\\
|__MTst__ | Modalità di test           | Simula il reperimento degli allegati anche se non esistono i file corrispondenti __(DA USARE SOLO IN CASO DI TEST!)__ |\\
\\
\\
! MAI.CAR\\
Serve unicamente al caricamento dei dati necessari alla simulazione del corretto reperimento dei dati nalle scheda LOA17.\\
Non influisce in alcun modo sul funzionamento dell'invio delle mail e può venire omesso dallo script.\\
\\
||Attributo||Descrizione||Spiegazione
|__Pgm__ | Programma da eseguire |programma che si occupa di ritornare gli oggetti per i quali le istruzioni incluse nel loop dovranno essere eseguite. Come programma di esempio vedere il programma __ LOA11_01__\\
|__Mod__ | Modalità              |passo funzione/metodo del programma stesso.\\
|__Par__ | Parametri             |posso passare un serie di parametri al programma specifico.\\
\\