ZimbraFlow - Integra la tua mail con i tuoi applicativi aziendali
By: studiostorti
ZimbraFlow
ITALIAN
ZimbraFlow è un'estensione di Zimbra che utilizza la libreria OpenZAL.E' compatibile con OpenZAL 1.5 e Zimbra dalla version 6.0.7 alla versione 8.5.1.
La versione di OpenZAL compatibile piu' recente puo' essere trovata all'indirizzo http://openzal.org/1.5/zal-1.5-{zimbraVersion}.jar - es. la versione di OpenZAL compilata per Zimbra 8.5.0 è disponibile all'indirizzo http://openzal.org/1.5/zal-1.5-8.5.0.jar
La zimlet manda una richiesta all'estensione ZimbraFlow contenente l'Id del messaggio selezionato e l'indirizzo del servizio SOAP.L'estensione estrae il messaggio da Zimbra, anche se contenuto in cartelle condivise, e spedisce una richiesta SOAP contenente alcuni attributi del messaggio.
Nel file ZimbraFlowHandler.java è possibile configurare gli attributi del messaggio da inviare nella richiesta SOAP.Modificando il file configtemplate.xml è possibile impostare l'indirizzo del servizio SOAP: per impostare il file di configurazione per una zimlet utilizzare il comando'zmzimletctl configure configtemplate.xml'
Installazione
Crea la cartella per l'estensione ZimbraFlow:
mkdir /opt/zimbra/lib/ext/ZimbraFlow
Sposta i jar zal.jar (per la tua versione di zimbra) e ZimbraFlow.jar nella cartella:
mv zal.jar ZimbraFlow.jar /opt/zimbra/lib/ext/ZimbraFlow/
Riavvia il servizio mailbox dei server conivolti:
zmmailboxdctl restart
Installa la zimlet com_ZimbraFlow.zip direttamente dalla console amministrativa oppure via CLI con il comando:
zmzimletctl deploy com_ZimbraFlow.zip
Esempio
Nell'implementazione di esempio i seguenti campi sono inclusi nella richiesta SOAP:
"cUserEmail": indirizzo dell'utente che effettua la richiesta (*)
"cEmailUniqueID": Id zimbra del messaggio
"cEmailMessageID": Message-ID del messaggio
"cDateTime": data di ricezione del messaggio (*)
"cFrom": mittente del messaggio
"cTO": destinatario del messaggio
"cCC": destinatari del messaggio
"cCCN": destinatari nascosti del messaggio
"cSubject": soggetto del messaggio
"cBody": corpo del messaggio
"StreamBase64": tutto il messaggio (compresi eventuali allegati) encodato in base64 (*)
[NB: i campi contrassegnati con * devono essere necessariamente presenti nel messaggio per poter costruire la richiesta.]
Quando la richiesta causa un'eccezione il contenuto di questa viene mostrato in un alert dal browser.Se la richiesta viene inviata correttamente ma la riposta inizia con la sigla KO il messaggio è interpretato come un errore e mostrato in un popup all'interno del WebClient.Se la risposta inizia con la sigla OK il messaggio viene mostrato in un popup all'interno del WebClient che segnala il successo della richiesta SOAP.
ENGLISH
ZimbraFlow is a Zimbra extension using the OpenZAL library. It's compatible with OpenZAL 1.5 and all Zimbra versions from 6.0.7 to 8.5.1.
The most recent compatible OpenZAL package can be found at http://openzal.org/1.5/zal-1.5-{zimbraVersion}.jar - e.g. the most recent compatible OpenZAL version for Zimbra 8.5.0 can be found at http://openzal.org/1.5/zal-1.5-8.5.0.jar
The Zimlet dispatches a request to the ZimbraFlow extension containing the Message ID of the selected item and the SOAP service's URL. The exension extracts the item's information from Zimbra, even if it's contained on a shared folder, and dispatches a SOAP request containing some of the item's attributes to the target SOAP service.
The attributes sent by the ZimbraFlow extension can be configured within the ZimbraFlowHandler.java file, while the SOAP target can be set within the configtemplate.xml file through the zmzimletctl configure command.
Installation
Create the appropriate folder
mkdir /opt/zimbra/lib/ext/ZimbraFlow
Move both .jar files in the aforementioned folder
mv zal.jar ZimbraFlow.jar /opt/zimbra/lib/ext/ZimbraFlow/
Restart the mailboxd service so that both the ZimbraFlow and OpenZAL extensions will be loaded
zmmailboxdctl restart
Install the com_ZimbraFlow.zip zimlet either via GUI or CLI
zmzimletctl deploy com_ZimbraFlow.zip
Usage Example
The example implementation included in the downloadable file sends the following item information to the target SOAP service: "cUserEmail": indirizzo dell'utente che effettua la richiesta (*)
"cEmailUniqueID": ZimbraID
"cEmailMessageID": Message-ID
"cDateTime": date received (*)
"cFrom": "From" header
"cTO": "To" header
"cCC": "CC" header
"cCCN": hidden recipients
"cSubject": Message subject
"cBody": Message body
"StreamBase64": full message (including attachment) encoded in base64 (*)
Fields marked with (*) are required in order to build the SOAP request
When a request triggers an exception, the exception content is returned to the user through a browser alert. If the request is sent successfully but the response begins with "KO" the error is displayed within the Zimbra WebClient. If the response begins with "OK" the message is diplayed in a pop-up within the Zimbra WebClient that confirms the request has been correctly dispatched.
Helpful Links
| Rating | No ratings or reviews |
| Downloads | 1487 |
| Latest Version | 1.0 |
| Categories | Developer Tools , Utilities |
| Compatibility | ZCS Legacy , ZCS 7.x , ZCS 8.0.x |
| License | No License Specified |
| Created | on 11/19/14 |
| Updated | on 10/7/15 |