CONFIGURAZIONE MEDIA

La maschera CONFIGURAZIONE MEDIA permette di definire i media utilizzati dalle comunicazioni e relativi parametri.

• Il campo tipologia imposta il tipo di media (E-MAIL, SMS, WEBFORUM, VPORTAL, ESSE3).

È possibile definire diversi codici legati alla stessa tipologia. In tal modo è possibile avere E-MAIL, EMAILPERS, E-MAIL2, E-MAIL TEST tutti legati alla tipologia E-MAIL e ognuno risponderà ai propri parametri impostati.

• E’ possibile dare una descrizione a ogni media per meglio distinguerli nelle lookup predisposte nelle varie maschere del modulo.

• L’utilizzo delle caselle di controllo Sistema, Attivo, Pagamento e Spedizione è spiegato direttamente nella maschera.

In particolare:

la casella Pagamento è utilizzata per gli sms (SMS-PREMIUM) e definisce un pagamento per ogni invio a carico del destinatario (il destinatario deve aver sottoscritto l’eventuale canale tematico);

la casella Spedizione definisce se la comunicazione basata su questo media sarà effettivamente spedita o meno. Nella lista delle comunicazioni sarà sempre come inviata, ma questo flg ne definisce l’effettivo invio o meno.

• I pulsanti CANALI e COMUNICAZIONI navigano rispettivamente verso la maschera CANALI TEMATICI e COMUNICAZIONI MULTI-MEDIALI.

• Il pulsante DUPLICA permette di creare una copia con gli stessi parametri personalizzabile secondo le esigenze. (vedi Figura 6)

Il pulsante VERIFICA permette di testare la corretta configurazione del media prima del suo utilizzo. In tal modo se il test ha buon fine, anche le comunicazioni con quel determinato media saranno processate correttamente.

Parametri del media di tipo E-MAIL

SMTP_SERVER: Indirizzo logico o fisico del server SMTP (es. smtp.kion.it, oppure 127.0.0.1)

GET_ADDR_FROM_USER:

0: Destinatario da anagrafica, EMAIL.

1: Destinatario da anagrafica, EMAIL_ATE.

2: Destinatario da USER_ID (vedi in associazione a E-MAIL DOMANI).

3: Destinatario da anagrafica, preferenza EMAIL_ATE.

4: Destinatario da anagrafica, preferenza EMAIL.

E-MAIL_DOMAIN: Dominio da aggiungere al nome dell'utente per generare indirizzo E-MAIL; il campo serve per creare la mail del destinatario (se il GET_ADDR_FROM_USER =2).

La mail sarà inviata a un indirizzo composto da user_id (p18_user.user_id) @ E-MAIL_DOMAIN

USR_LOGIN e USR_PWD (autenticazione SMTP) opzionale se il server SMTP d’ateneo le richiede

MAX_DEST_PER_MAIL: Numero massimo di destinatari per MAIL

TIME_BETWEEN_MAIL: Tempo espresso in millisecondi tra l'invio di una MAIL e l'altra

MAX_FAILURE_PER_MAIL: numero di fallimenti possibili d’invio mail.

PORT: porta su cui è attivo il servizio SMTP. Di default è proposta la 25, è possibile indicare una porta differente, utilizzando anche eventuali certificati (ad esempio SSL, vedi … \EAServer\bin\security).

MITTENTE: sarà il mittente delle comunicazioni se non diversamente specificato (sui singoli template e sulle singole comunicazioni). Deve essere, nel formato email, un account valido di dominio.

Indicazioni sul mittente:

Il mittente di default per tutte le comunicazioni di ateneo (vedi Eccezioni), se non diversamente specificato, sarà il parametro MITTENTE nella configurazione MEDIA. Questo parametro deve essere obbligatoriamente un account valido di dominio (nelle prossime release sarà introdotto come parametro dei Media anche un campo DA).

Eccezioni:

1. E’ possibile differenziare il mittente per i singoli eventi applicativi, indicando il parametro MITTENTE e DA (account valido) nella configurazione di ciascun TEMPLATE (vedi immagine sopra).

2. Il mittente delle comunicazioni legate alla funzione di pubblicazione esiti nell’area docente (o stampa verbale per la tipologia di appello online semplificato), è recuperato dal parametro FROM ADDRESS nel file di context di ciascun tomcat (o web.xml secondo la configurazione di ateneo).

a. configurare il context:

Il file di context si trova nelle cartelle seguenti e si chiama ROOT.xml:

/esse3/tomcat_instance/base_a/conf/Catalina/localhost/ROOT.xml

/esse3/tomcat_instance/base_b/conf/Catalina/localhost/ROOT.xml

...base_c

...base_d

Ovviamente deve essere fatto su tutti i server e per tutti i 'base'.

<param-name>FromAddress</param-name>

<param-value>account valido</param-value>

Attenzione! La modifica al file di context (ROOT.xml) fa scattare un riavvio della webapp.

3. Il mittente delle comunicazioni legate alla funzione di Comunicazione agli iscritti nell’area docente:

è possibile scegliere il mittente (proposto o di default) tramite il parametro di configurazione WEB_COMUNICAZ_WEB_MITTENTE.

Gestione delle comunicazioni multi-mediali in AMBIENTE DI TEST

Per poter inviare le comunicazioni in ambiente di test evitando di inviare realmente comunicazioni agli indirizzi reali degli studenti, è possibile utilizzare degli indirizzi email specifici per il test definiti nel file debugemail.ini (debugsms.ini per i numeri di cellulare).

Questi file devono essere salvati nella cartella nome_jaguar\sybase\EAServer\bin hanno rispettivamente questa struttura:

debugemail.ini:

[EMAILS]

TO=utente_1@kion.it; utente_2@kion.it; utente_n@kion.it

CC= utente_1@kion.it; utente_2@kion.it; utente_n@kion.it

BCC= utente_1@kion.it; utente_2@kion.it; utente_n@kion.it

debugsms.ini:

[SMS]

TO=0:+393380000001;0+393380000002;

In assenza di questi file (se l’ambiente è di test), le mail e gli sms vengono dirottati su un indirizzo mail (e cellulare) kion, cablato nel codice.

Esempio: comunicazione di tipo E-MAIL con 1005 destinatari tutti in CC.

Il parametro di device MAX_DEST_PER_MAIL =100

Nel debugemail.ini in CC ci sono3 destinatari.

L’invio della comunicazione sarà suddivisa in pacchetti da 100 destinatari (MAX_DEST_PER_MAIL) creando 11 pacchetti. A rotazione, ogni pacchetto sarà inviato come unica mail al primo indirizzo, poi al secondo, al terzo e nuovamente al primo fino ad esaurimento dell’ultimo pacchetto da 5 destinatari

Verifica del media

La verifica del media viene effettuata inviando un messaggio di test. Indirizzo mittente e destinatario devono essere account validi di dominio.

Se il processo di invio non produce errori, sarà inviata una mail con i dati impostati. Altrimenti un messaggio di errore avviserà del fallimento della Verifica:

La verifica del media può essere fatta con la stessa modalità per i media di tipo SMS inserendo il numero di cellulare per mittente e destinatario.

Configurazione tipica di E-MAIL e E-MAIL2

Solitamente E-MAIL viene configurato con il parametro GET_ADDR_FROM_USER= 1 (email di ateneo) per la maggior parte degli eventi di sistema.

Il parametro E-MAIL2 viene settato con GET_ADDR_FROM_USER= 0 (email personale) e utilizzato soprattutto per l’evento di REGISTRAZIONE della persona (in quella fase la persona non essendo ancora studente non ha email di ateneo). In questo caso occorre che anche il template di REGISTRAZIONE sia legato a questo MEDIA. (vedi la sezione Template).

Maggiori dettagli nel documento: Manuale - Comunicazioni multi-mediali