JForward 1.3: POP3 Retriever per Domino

E' un vero piacere vedere progetti Italiani crescere e prosperare  come nel caso di questo JForward, progetto di Emidio e Gabriele di ankon group che arriva alla versione 1.3 continuando a portare valore a tanti utenti Lotus.
Lo staff di Dominopoint.

---

Abbiamo ricevuto molte richieste per nuove funzionalità riguardo al POP3 retriever su Lotus Domino e rilasciamo quindi la nuova versione 1.3.

Questo progetto, come potete immaginare, è nato per soddisfare le esigenze di piccole aziende che volevano utilizzare Lotus Domino, continuando a mantenere le caselle di posta dal provider.
La passione per Lotus Notes ci ha spinto a condividere questo lavoro con chi ne avesse bisogno, il tipo di licenza è quindi GPL, cioè libero di essere utilizzato e anche modificato.

PS:
Una precisazione: l'ultima versione di jForward funziona esclusivamente con le versioni di lotus domino 7.x e superiori perchè utilizza alcune funzionalità della jvm 1.4.

Emidio Giuseppetti  e Gabriele Mariotti

---

History of Changes

What's new in version 1.30 - 26 settembre 2007
Migliorie:
* Utilizzo di JavaMail 1.4  
* Gestione POP3 in SSL
* Aggiunte classi : "DummySSLSocketfactory.java" e "DummyTrustManager" per la gestione dei certificati

What's new in version 1.20 - 20 marzo 2007
Migliorie:
* Migliorato il Sender
* Le email senza mittente vengono cancellate come SPAM
* Eliminata la trace su Console
* Le trace delle eccezioni ora sono riportate in un documento di Log

What's new in version 1.10 - 03 marzo 2007
Migliorie:
* Inseriti nei log le informazioni del mittente,oggetto e dimensione e destinatario
* Possibilità di ordinare i log per le nuove informazioni
* Diminuito il numero di log se il livello è solo download.

What's new in version 1.08 - 14 settembre 2006
Migliorie:
* Separato il database di log da quello engine.

What's new in version 1.07 - 19 aprile 2006
Migliorie:
* Possibilità di avere diversi livelli di log (nessuno, solo info di download o completo)
In ogni caso gli errori e i warning verranno visualizzati.

What's new in version 1.06 - 14 marzo 2006
Migliorie:
* Migliorata la visualizzazione degli account disabilitati
Correzioni:
* Tolta la possibilità di lasciare la posta sul server.

What's new in version 1.05 - 2 febbraio 2006
Migliorie:
* Inserita l'informazione dell'email che viene scaricata nei documenti Account. La stessa info sarà fruibile nel log.
* I log sono raggruppabili anche per singolo processo di download
Correzioni:
* Corretto un errore di ordinamento nella visualizzazione dei log

What's new in version 1.04 - 19 Gennaio 2006
Migliorie:
* Nell'invio delle email viene saltato il controllo della valitidà degli headers con le specifiche RFC822
* Modificata la Sender per gestione di 451:Unable to complete command, DNS not available or timed out
* Migliorato il dettaglio dei log e del debug in fase di spedizione e collegamento al POP3
Correzioni:
* Gestito i casi di in cui il campo form origina un extra-addr e nested group

What's new in version 1.03 - 16 Gennaio 2006
Migliorie:
* Inserita la possibilità di lasciare la posta sul server a livello di singolo account.

What's new in version 1.02 - 10 Gennaio 2006
Migliorie:
* Modificata la Sender per gestione eccezioni di Rejected for policy reasons
* Inserita la documentazione per configurazione account e programma
Correzioni:
* Corretto errore di ordine di visualizzione date nei log
* Corretto dati debug e enable sulle viste di config e account

---

note relative al precedente rilascio su dominopoint in data 30/11/2006 :
L'applicazione è completamente gratuita e opensource può essere modificata ad uso e consumo di chi vuole.
Nasce per un utilizzo interno e quindi va presa "as is".Non ha nè documentazione ne esempi di sorta.
Se servono ulteriori informazioni sono disponibile a fornirle.

L'applicazione richiede lato server l'utilizzo di un domino v6 o successivi (è richiesta la JVM 1.3 o superiore) e l'installazione del package javamail 1.3.2 distribuito insieme (ci sono dei documenti notes di Help dentro il Template).
1- estrarre i due file .jar (activation.jar e mail.jar) nella cartella $domino_dir/jvm/lib/ext (sovrascrivere gli eventuali file presenti)
2- inserire o modificare le due chiavi nel notes.ini del server domino

// Serve per la Heap Size Massima della JVM (se è impostato ad un livello superiore lasciare quel livello)
JavaMaxHeapSize=380MB (importante il suffisso MB)
//Se la chiave non è presente non è necessario inserirla. Se invece è presente si devono inserire i percorsi dei due file
JavaUserClasses=... inserire il percorso dei due jar.

Attenzione: a volte se installato Sametime, nella installazione vengono sparsi per le varie cartelle del domino (o data) jar con nomi identici.
Questi eventuali file vanno cancellati (non si incorre in nessun tipo di problema perchè la 1.3.2 di javamail è cmq ad un livello superiore di quello distribuito da sametime).

3- modificare il file $domino_dir/jvm/security/java.policy aggiungendo nei default grant alla fine ( prima di };) :
//modifica
permission java.security.AllPermission "read,write";

Attenzione: durante gli update di versione di domino questo file e i due file .jar vengono sovrascritti, quindi vanno ripristinati.


Lato client non è richiesta ovviamente nessuna modifica od installazione.
Tuttavia se si vuole modificare il codice java al suo interno, è necessario inserire i due file .jar (activation.jar e mail.jar) presenti nel documento server nella cartella $notes_dir/jvm/lib/ext (sovrascrivere gli eventuali file presenti) del client con il quale si effettuano le modifiche.

L'applicazione è divisa in due database che vanno inseriti nella stessa directory (una qualsiasi sotto data).
Nel primo database (JForward.nsf) va creato un documento notes di configurazione con questi parametri:

L'applicazione per poter funzionare correttamente deve aver impostato correttamente i parametri.

* DEBUG=Questa chiave permette di visualizzare a sulla console Domino i vari passaggi in fase di download della posta.
Il dettaglio delle operazioni non appare nella videata del log.
Impostare il parametro =SI (1) per abilitarla, =NO (0) per disabilitarla.
* TIMEOUT=Valore espresso in millisecondi del timeout di connessione al provider. (consigliato 300000)
* Cronologia del LOG=indica quanti la durata in giorni della cronologia del log. I messaggi più vecchi verranno cancellati con un agent.
* database di log = percorso e nome del secondo database (JForwardLog)
* tipo di log= Completo (scrive tutto) / Solo Download (crea dei log solo in presenza di messaggi da POP3 o errori) / Solo errori(solo se si verificano errori)


Inoltre vanno creati gli account da scaricare:
NOTES USER= non interessa il processo di download della posta. E' utilizzato come lettore/scrittore da domino.

* EMAILPOP3= email che si va a scaricare ma è una informazione che non interessa il download ma viene usato solo per il log
* POP3= indicare il pop3 per la ricezione della posta
* USER= indicare lo user da utilizzare per il collegamento al POP3
* PASSWORD= indicare la password da utilizzare per il coll. al POP3
* SMTP= indicare il server smtp per inoltrare l'email (IP o nome)
* EMAIL= indicare l'indirizzo email al quale inoltrare l'email scaricata.
Se si vogliono indicare più destinatari basta separarli con uno spazio.

* ENABLE= indica se l'account deve essere attivo
Se=SI (1) è attivo
Se=NO (0) non è attivo



Il tutto funziona con un agent che si chiama DownloadPOP3 che va schedulato, che legge gli accont ed in base ai parametri di configurazione e le info degli account, si connette con protocollo POP3 ai provider per scaricare la posta ed inoltrarla ai vari indirizzi.
Vengono mantenute ovviamente le informazioni dell'email originale.

Il secondo database (JForwardLog.nsf) fa solo da repository per i log.
C'è un agent di Pulizia che pulisce questo database per evitare che diventi troppo grande.

Il cuore dell'applcazione è lo script JForward, scritto in java nel quale avviene il download della posta.