Robomail 2V Multi Consult Milano

Transcript

1 Robomail 2V

2

3 Contents 3 Table of Contents Foreword 0 Part I Introduzione 6 1 Requisiti di... Installazione 6 2 Installazione... 7 Part II Console di Configurazione 10 1 Invio Messaggi in Invio Ricezione Messaggi in Ricezione Raw Polling Log Monitor Licensing Index 0 3

4

5 Parte I

6 6 Robomail 2V 1 Introduzione Robomail 2V è permette di gestire comunicazioni tra sistemi eterogenei suddividendo le operazioni in: INVIO Costituito da un prelevamento files (polling) su file system oppure FTP e un inoltro a indirizzo RICEVIMENTO Costituito da un prelevamento files da indirizzo e un inoltro su file system oppure FTP RAW POLLING Costituito da un prelevamento files da determinata posizione in file system ed inoltro a indirizzo L'applicazione è costituita da: - Servizio Windows "MCM Robomail V2" che esegue le operazioni applicative. Essendo un servizio windows, non è necessario effettuare login sulla macchina Windows - Applicazione desktop "Robomail V2 Console" che permette la gestione della configurazione. 1.1 Requisiti di Installazione Sistemi Operativi Windows XP/Server 2003/Server 2008/Vista/Windows Mbytes spazio disco (di cui per Microsoft.NET Framework 3.5 SP1)

7 Introduzione 7 Microsoft.NET Framework 3.5 SP1 (installato con download automatico se assente) Una casella mail dedicata, accessibile tramite protocollo SMTP 1.2 Installazione Eseguire il programma di setup come utente amministratore. Il processo di setup crea una cartella [percorso programmi]\multi Consult Milano\MCM Robomail V2 contenente tutti i files a supporto, la console di amministrazione e il servizio windows Viene creata sul desktop l'icona collegamento per l'applicazione console Selezionare il servizio windows "MCM Robomail V2" e se necessario cambiare la modalità di avvio (default: automatica), l'utente (default: account di sistema locale), e eventualmente permettere l'interazione con il desktop (per visualizzare le finestre dei post/pre processori) La cartella di installazione contiene il file log.txt, file contenente messaggistica operativa del sistema, avente il seguente formato: DATA ORA; LIVELLO DI MESSAGGIO (1=ERRORE, 2=INFORMAZIONE BASE 3=INFORMAZIONE DETTAGLIO); TIPO PROCESSO (P=BASE, I=INVIO, R=RICEVIMENTO, X=RAW POLLING); MESSAGGIO; DETTAGLI DI ERRORE (SE APPLICABILE)

8

9 Parte II

10 10 Robomail 2V 2 Console di Configurazione La Console è richiamabile tramite collegamento presente sul Desktop. Note: Il Servizio Windows Robomail 2V deve essere riavviato affinchè le modifiche siano operative Il pulsante "Ricarica la configurazione" reimposta la configurazione precedente ad eventuali modifiche non salvate. L'operazione non si applica alle informazioni relative ai Messaggi in Invio e Messaggi in Ricezione (che possiedono un proprio pulsante di salvataggio) Il pulsante di esportazione permette di salvare i files xml di configurazione in un unico file formato Zip Il pulsante "Salva" effettua il salvataggio della configurazione. L'operazione non si applica alle informazioni relative ai Messaggi in Invio e Messaggi in Ricezione (che possiedono un proprio pulsante di salvataggio) 2.1 Invio L'operazione di INVIO: effettua polling in una cartella locale o spazio FTP dei file di configurazione messaggio (formato xml) preleva il file messaggio, effettua se necessario le operazioni di preprocessing e inoltra il messaggio tramite mail agli indirizzi specificati Informazioni Base Abilitato: abilita o disabilita l'operazione di INVIO Usa Intervallo/Schedulazione:utilizza per il timing dell'operazione di polling un intervallo in minuti oppure una serie di orari (fino a cinque) Modalità di Polling: File System oppure FTP

11 Console di Configurazione 11 Formato dei messaggi di configurazione: specifica la maschera del nome file da analizzare (files di configurazione messaggi). Il valore di default è *.xml (tutti i files con estensione xml) Elimina/Rinomina:elimina i files di configurazione e di messaggi elaborati oppure rinomina apponendo estensione ".processato" Deposito temporaneo dei messaggi: specifica la cartella ove vengono temporaneamente depositati i messaggi trovati nel percorso di polling (Locale oppure FTP) prima di essere spediti. A questo percorso dovranno riferirsi eventuali processi che eseguono preprocessing dei messaggi. Salva backup: effettua salvataggio dei files in archivio ZIP (processati con successo o meno) Percorso di backup: specifica il percorso di salvataggio dei files ZIP Polling Locale Percorso: specifica il percorso locale ove effettuare il polling dei messaggi in INVIO Polling FTP Specifica i dati per la connessiore al server FTP ove recuperare i files messaggio Invio a mail

12 12 Robomail 2V Specifica i parametri SMTP per l'invio dei messaggi. Le informazioni ivi contenute (dati di connessione e dati di composizione ) vengono applicati a tutti i messaggi in uscita tranne quelli per cui sono state definite regole particolari (vedasi Messaggi in Invio) Notifica a mail Specifica i parametri della mail di notifica relativa all'avvenuta operazione di INVIO messaggio Destinatari: è possibile inserire uno o più destinatari separandoli con il carattere, oppure ; Oggetto: oggetto della mail Testo: è possibile inserire parole chiave che verranno sostituite all'atto dell'invio con i valori reali. Esse sono: NOMEMESSAGGIO: nome del messaggio inviato DATARICEZIONE: data di ricezione (polling) del messaggio ORARICEZIONE: ora di ricezione (polling) del messaggio INVIODATA: data di invio dell' di INVIO (non della di notifica) INVIOORA: ora di invio dell' di INVIO (non della di notifica) Allega alla notifica il messaggio elaborato: allega alla mail di notifica il file messaggio (non viene allegato il file xml di configurazione messaggio). Nel caso il file messaggio venga rinominato in preprocessing egli manterrà il nome originale nella mail di notifica Formato del file di configurazione messaggio <?xml version="1.0" encoding="utf-8"?>

13 Console di Configurazione 13 <OUTMsgConfig xmlns=" xsd"> <OUTMessaggio> <NomeMessaggio>esempio.abc</NomeMessaggio> </OUTMessaggio> </OUTMsgConfig> I dati in grassetto sono dati parametrici: il percorso e nome del file messaggio (NomeMessaggio) e l'utente o gli utenti destinatari (DestinatariMessaggio) NomeMessaggio può contenere il percorso completo (ad esempio c:\temp\polling\messaggio.txt). Nel caso sia presente solamente il nome del file, esso verrà ricercato nello stesso percorso del file xml di configurazione messaggio. Nota: se i files vengono prelevati da FTP, il file messaggio dovrà essere situato nella stessa cartella del file xml (NomeMessaggio dovrà riportare sempre e solo il nome del file) DestinatariMessaggio può contenere uno o più indirizzi separati da carattere, oppure ; Messaggi in Invio E' possibile specificare regole di pre-processing per i messaggi in INVIO Schermata Principale Vengono elencati gli elementi del registro "Messaggi in Invio". E' possibile aggiungere/eliminare/ salvare gli elementi tramite gli appositi pulsanti della toolbar (Il pulsante Salva posto in basso a

14 14 Robomail 2V destra della finestra principale non è deputato al salvataggio degli elementi di questo registro ma al salvataggio dei valori INVIO/RICEZIONE) Anagrafica Nome: nome identificativo (ID) dell'elemento Possibili nomi dei messaggi: specificare una o più maschere per l'individuazione dei files messaggio da preprocessare. Nota: nel caso siano presenti maschere identiche su elementi diversi, verrà utilizzato il primo elemento di corrispondenza) Preprocessing Esegui PreProcessing del messaggio: attiva o disattiva l'esecuzione di un processo esterno Processo da eseguire: specifica (con digitazione manuale o tramite pulsante) il processo deputato Argomenti di avvio: argomenti di avvio del processo Aspetta che il processo termini: blocca l'esecuzione delle operazioni seguenti di INVIO e aspetta il termine del preprocessing Non visualizzare il processo in esecuzione: esegue il processo non visualizzando l'interfaccia utente dello stesso. Nota: nel caso il preprocessore debba eseguire operazioni sul file da spedire, esso dovrà far riferimento "Deposito temporaneo dei messaggi" specificato nella scheda "INVIO -> Base" I messaggi da inviare (sia il file di configurazione xml che il file messaggio da spedire) vengono prelevati da percorso di polling (cartella locale, percorso di rete, ftp) e spostati nel percorso di deposito temporaneo specificato.. Nel caso quindi sia necessario preprocessare il file abc.txt, il preprocessore dovrà riferirsi ad esempio al file C:\Programmi\Multi Consult Milano\ Robomail 2V\TMPOUTBOX\abc.txt (il percorso di installazione potrebbe essere diverso) oppure al file C:\temp\preprocess\abc.txt se C:\temp \preprocess è stato specificato come deposito temporaneo In ogni caso Robomail dopo il termine del preprocessing preleverà il file da tale percorso per la spedizione: l'applicazione che effettua preprocessamento del file dovrà quindi lasciare in loco il file processato per le successive operazioni effettuate da Robomail

15 Console di Configurazione 15 Invio a Mail

16 16 Robomail 2V Modifica il comportamento standard di invio del messaggio. Usa dati personalizzati di Invio: specifica se modificare i dati di connessione SMTP standard e/o i dati della mail Nota: i parametri SMTP vengono considerati solamente se "usa dati personalizzati di Invio" è abilitato e tutti i dati SMTP sono presenti. Varie Rinomina il messaggio: rinomina il messaggio da inviare e quindi lo allega alla mail di INVIO Cambia destinatari: non considera i destinatari contenuti nel file di configurazione messaggio xml ma spedisce il messaggio ai destinari ivi specificati 2.2 Ricezione L'operazione di RICEZIONE: effettua polling di una specifica casella analizzando le presenti in inbox preleva la mail avente uno o più allegati riconosciuti, effettua se previsto le operazioni di postprocessing e deposita il messaggio in File System o FTP Informazioni Base

17 Console di Configurazione 17 Abilitato: specifica se la funzionalità di RICEZIONE è operativa Usa Intervallo/Schedulazione:utilizza per il timing dell'operazione di polling un intervallo in minuti oppure una serie di orari (fino a cinque) Salvataggio via File System/FTP: specifica se depositare i messaggi ricevuti su file system locale o remotamente in FTP Nome file dei mittenti: specifica il nome file di configurazione del registro Messaggi in Ricezione (si consiglia di non modificare tale valore se non per motivi diagnostici nel caso si abbia a disposizione un secondo registro di Messaggi in Ricezione per fini di test) Deposito allegati: specifica il percorso locale di salvataggio allegati (utlizzato se è stato specificato File System) Sovrascrivi i messaggi presenti durante il deposito: nel caso siano presenti più nella casella di posta che riportino allegati aventi lo stesso nome (ad esempio prova.txt), il software effettua una rinominazione interna automatica per permettere la coesistenza di files aventi nomi eguali. Tuttavia il messaggio viene salvato (in locale o in FTP per il prelievo/postprocessing) con il nome originale. Il postprocessore (postprocessore gestito da Robomail V2 oppure processore esterno che preleva i files per altre destinazioni -feeder) devono rinominare/eliminare/spostare i files depositati dall'applicazione. In caso contrario i files verranno sovrascritti se questa opzione è abilitata (vengono sempre sovrascritti se il deposito avviene in area FTP). Nel caso si abbia deposito su File System e questa opzione non sia abilitata, il messaggio non verrà salvato. La modalità operativa ottimale per evitare questa problematica (nel caso sia presente la possibilità di s aventi nomi di allegato uguale) è la seguente: definire un postprocessore per il nome di allegato specificato specificare che occorre attendere la fine del postprocesso prevedere che il postprocessore vada al termine a rinominare/eliminare/spostare il file messaggio Lo schema di rinominazione dei messaggi è il seguente: Viene effettuato PostProcessing su File System: verrà sempre deposto il file con nome originale prima di essere utilizzato dal postprocessore. Si verifica errore se il percorso contiene già file con nome uguale Viene effettuato PostProcessing su FTP: verrà sempre deposto il file con nome originale prima di

18 18 Robomail 2V essere utilizzato dal postprocessore. Se il percorso FTP contiene già file con nome uguale esso verrà sovrascritto Non viene effettuato PostProcessing su File System: se sono presenti s con nomi messaggio uguali, questi verranno deposti con suffisso numerico Non viene effettuato PostProcessing su FTP: se sono presenti s con nomi messaggio uguali, questi verranno deposti con suffisso numerico Salva i messaggi e allegati elaborati in locale: specifica se effettuare copia di backup in formato ZIP dei messaggi in RICEZIONE (elaborati correttamente o meno) Percorso di backup: percorso di salvataggio dei files di backup Deposito FTP Definisce i dati di salvataggio dei messaggi su area remota FTP (non utilizzati se è stata selezionata l'opzione File System) Casella Mail Specifica i dati di connessione POP3 alla casella di mail dedicata per la RICEZIONE Elimina dal mail server le elaborate: elimina dal server mail i messaggi di posta elettronica elaborati (con successo o meno). Nel caso tale opzione non sia attiva Robomail V2 processerà ogni volta gli stessi messaggi Elimina dal mail server le ignorate: specifica se eliminare dal server di posta le che non contengono allegati riconosciuti come Messaggi in Ricezione

19 Console di Configurazione 19 Notifica a mail Specifica se notificare l'avvenuta operazione di RICEZIONE Destinatari: è possibile inserire uno o più destinatari separandoli con il carattere, oppure ; Oggetto: oggetto della mail Testo: è possibile inserire parole chiave che verranno sostituite all'atto dell'invio con i valori reali. Esse sono: NOMEMESSAGGIO: nome del messaggio inviato DATARICEZIONE: data di ricezione (polling) del messaggio in ORARICEZIONE: ora di ricezione (polling) del messaggio in DATAMAIL: data di invio dell' contenente il messaggio ESITOSALVATAGGIO : esito dell'operazione di download e deposito dell'allegato messaggio ERRORESALVATAGGIO: specifica il messaggio di errore di download e/o deposito dell'allegato messaggio MITTENTEMESSAGGIO: mittente della mail contenente l'allegato messaggio Allega alla notifica gli allegati elaborati: allega alla mail di notifica il file messaggio. Nota: nel caso una mail di RICEZIONE contenga più messaggi allegati verrà inoltrata una notifica per singolo messaggio elaborato Messaggi in Ricezione Specifica quali allegati mail devono essere considerati messaggi idonei. E' possibile inoltre specificare regole di post-processing per i messaggi in RICEZIONE Schermata Principale

20 20 Robomail 2V Vengono elencati gli elementi del registro "Messaggi in Ricezione". E' possibile aggiungere/eliminare/ salvare gli elementi tramite gli appositi pulsanti della toolbar (Il pulsante Salva posto in basso a destra della finestra principale non è deputato al salvataggio degli elementi di questo registro ma al salvataggio dei valori INVIO/RICEZIONE) Anagrafica Nome: nome identificativo (ID) dell'elemento Possibili nomi degli allegati per procedere ad elaborazione della mail: occorre specificare almeno una maschera file. Gli allegati che corrisponderanno a tale maschera saranno considerati idonei e seguiranno le regole di postprocessing se definite Esegui PostProcessing dell'allegato: specifica se avviare applicazioni esterne in seguito al deposito del messaggio Processo da eseguire: definisce il percorso e nome del file eseguibile deputato al postprocessing Argomenti di avvio: specifica gli argomenti di avvio del processo Aspetta che il processo termini: se attivata pone l'applicazione in attesa che il postprocessore termini prima di continuare con l'elaborazione dei successivi messaggi Non visualizzare il processo in esecuzione: se attivata nasconde l'interfaccia utente del processo esterno 2.3 Raw Polling Questa funzionalità permette di spedire files come allegati a determinati destinatari

21 Console di Configurazione 21 Nome: identificativo dell'elemento di registro Raw Polling Percorso di polling: percorso locale ove ricercare i files da inviare Invia gli allegati come Zip: se attivato gli allegati trovati vengono spediti in un unico file formato ZIP Destinatari: destinatari della mail - separare più destinatari con carattere, oppure ; Oggetto: oggetto della mail Testo: corpo della mail 2.4 Log Monitor Visualizza il contenuto del file di Log (log.txt) prodotto nella cartella di installazione. Nota: il file log.txt viene automaticamente eliminato al raggiungimento dei 5Mbytes di dimensione, in fase di avvio del servizio. L'elenco viene aggiornato ogni 0,2 secondi.

22 22 Robomail 2V Nota: è possibile visualizzare il file di log anche tramite tool esterni quale MS Excel, essendo i campi di tale file separati da carattere ; (punto e virgola) 2.5 Licensing Il prodotto necessita di Licenza Standard Multi Consult Milano. Nel caso la licenza non sia presente o sia corrotta/scaduta non sarà possibile avviare il Servizio Windows MCM Robomail V2 Per registrare il prodotto selezionare la schermata Informazioni e quindi premere il pulsante Registra/Visualizza la licenza

23 Console di Configurazione 23 Inserire / variare i dati per procedere a nuova registrazione della licenza. Premere Attiva Nel caso si voglia registrare manualmente un file di licenza, il nome deve essere obbligatoriamente lic.xml e deve essere posizionato nella cartella di installazione del programma.