Welcome Guest, Login or Sign up

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


Download

Rating No ratings or reviews
Downloads 318
Latest Version 1.0
Categories Developer Tools , Utilities
Compatibility ZCS 6.0.7 , ZCS 6.0.14 , ZCS 7.0 or later , ZCS 8.0 or later
License No License Specified
Created on 11/19/14
Updated on 10/7/15