<< Fare clic per visualizzazione il sommario >> Percorso:  API di piattaforma > JamioPlug > JamioPlug Message > Spedizione tramite trasporto PEC

Il Plug Message consente di effettuare spedizioni tramite trasporto di tipo Posta Elettronica Certificata (PEC) utilizzando una casella PEC opportunamente configurata in Jamio openwork. L'avanzamento di tali spedizioni è tracciato in risorse di tipo Dati.

 

Una spedizione tramite trasporto PEC è caratterizzata:

•da uno o più corrispondenti della spedizione che rappresentano la controparte del messaggio inviato/ricevuto dalla casella PEC configurata in Jamio openwork;

•dal percorso della spedizione (SendingPath) per ogni corrispondente, definito con:

oil trasporto di tipo PEC

ol’indirizzo PEC del corrispondente (Address)

oil vettore della spedizione che corrisponde all'indirizzo PEC da cui si sta inviando per i messaggi in entrata o l'indirizzo PEC a cui si sta ricevendo per i messaggi in uscita

 

Per inviare un messaggio PEC da una casella configurata in Jamio openwork, occorre progettare un processo con un'attività di tipo service task che invoca il metodo SendPEC del plug message.

Per un messaggio in uscita, vengono attivati diversi percorsi di spedizione, il cui stato-obiettivo dipende dalla valorizzazione dei parametri in input al metodo SendPEC. Se non vengono fornite informazioni sulla tipologia di trasporto per il singolo corrispondente, l'obiettivo sarà Delivered (Consegnato), diversamente sarà Sent (Inviato) per gli indirizzi non Pec, Delivered (Consegnato) per gli indirizzi Pec e Processed (Elaborato) per gli indirizzi PEC interoperabili.

 

Per ogni messaggio PEC ricevuto sulla casella PEC configurata in Jamio openwork, il plug message crea una nuova risorsa di tipo Dati istanza del modello di PEC in entrata specificato in configurazione, compila in automatico i campi della stessa ed imposta la proprietà SendingDirection a valore In entrata (Inbound). Se l'oggetto del messaggio PEC contiene caratteri speciali, come ad esempio il ritorno a capo, essi vengono rimossi. Eventuali file allegati al messaggio PEC sono riportati in automatico nella lista degli allegati della risorsa creata alla ricezione. Se un allegato ha dimensione pari a 0KB il PlugMessage aggiunge al file l'estensione .txt e riporta nel testo del file la dicitura "Empty file". Ad esempio se il file allegato è denominato Esempio.xsl ed ha dimensione 0KB il plug message rinomina il file in Esempio.xsl.txt e riporta al suo interno dicitura "Empty file". Inoltre se un file allegato ad un messaggio PEC ha un nome superiore a 255 caratteri il plug message in automatico rinomina il file impostando il nome a 255 caratteri. Il nome del file troncato è seguito dal simbolo "~" e poi dai caratteri finali .<estensione>. Eventuali caratteri speciali riportati nel nome del file sono sostituiti con il carattere - .

 

Per un messaggio in entrata, lo stato-obiettivo che deve raggiungere un percorso di spedizione viene impostato in funzione dei valori assunti dai parametri di configurazione della casella PEC, PreProcessing e Processing:

•se Processing è diverso dalla stringa vuota e non nullo, il TargetSendingStatus viene impostato a Elaborato (Processed);

•se Processing è valorizzato con stringa vuota o nullo e PreProcessing è diverso da stringa vuota e non nullo, viene impostato a Pre-Elaborato (PreProcessed);

•se Processing e PreProcessing sono entrambi valorizzati con stringa vuota o nulli, viene impostato a Consegnato (Delivered).

 

Per ogni messaggio ricevuto il plug message inserisce un messaggio di tracciamento riportando le informazioni specifiche di tracciamento e:

•il trasporto impostato a PEC;

•il vettore (carrier) impostato con l'indirizzo della casella su cui è arrivato il messaggio;

•il corrispondente impostato con il mittente del messaggio;

•l'indirizzo (Address) impostato con l’indirizzo del mittente;

•il tracking status a seconda dei valori assunti dai parametri di configurazione della casella PEC, PreProcessing e Processing, impostato a:

oConsegnato al destinatario (Delivered to recipient), se Processing e PreProcessing sono entrambi valorizzati con stringa vuota o nulli;

oIn pre-elaborazione da parte del destinatario (PreProcessingByRecipient), se Preprocessing assume valore custom;

oIn elaborazione da parte del destinatario (ProcessingByRecipient ), se PreProccesing è valorizzato con stringa vuota o nullo e Processing è uguale a custom;

Se PreProccesing è valorizzato con digitalitaly il tracking viene gestito dal JamioPlug Digitalitaly.

 

La risoluzione del mittente del messaggio PEC in entrata avviene ricercando le informazioni relative ad esso nel catalogo specificato nelle informazioni applicative della configurazione della casella. Se il mittente non è presente nel catalogo, il plug messagge assegna all'indirizzo, l'indirizzo di posta elettronica certificata e al corrispondente il display name associato all'indirizzo di posta elettronica certificata. Qualora il display name è assente, assegna anche al corrispondente l'indirizzo di posta elettronica certificata. In caso di ricezione sulla casella di posta elettronica certificata di un messaggio inviato da un indirizzo di posta elettronica ordinaria, il plug crea una nuova risorsa di tipo Dati istanza del modello PEC in entrata impostando il campo notevole Warning a valore Anomaly. Nella configurazione della casella PEC, attraverso il parametro Abilitare la gestione anomalie dei parametri di configurazione, è possibile specificare di ignorare tali messaggi e quindi non istanziare per essi risorse PEC in entrata. In ogni caso i messaggi ignorati non vengono eliminati dal server del gestore di posta elettronica certificata.

 

Alla ricezione delle ricevute previste dal protocollo PEC, il plug message crea specifici messaggi di tracciamento per ogni corrispondente raggiunto. Qualora una ricevuta non sia riconciliabile con un messaggio PEC creato in Jamio openwork, il plug message crea una risorsa segnandola come anomalia. Segue il dettaglio della gestione delle ricevute

 

Gestione delle ricevute

 

Ricezione di una ricevuta con informazione riconciliabile ad un invio effettuato da Jamio openwork

Il plug message riceve la ricevuta di un messaggio PEC precedentemente inviato dal plug, per cui esiste una risorsa di tipo Dati che traccia la spedizione dove sono riportati i corrispondenti e per ciascuno di essi i percorsi di spedizione dell'invio effettuato. Il plug message inserisce un messaggio di tracciamento con:

•tipo trasporto impostato a PEC;

•carrier impostato con l'indirizzo della casella su cui è arrivato il messaggio;

•stato in funzione della tipologia di ricevuta come da tabella sottostante.

 

 

Nella sezione allegati del messaggio di tracciamento sono riportati i file che rappresentano le ricevute (ad esempio daticert.xml). Le ricevute che afferiscono a destinatari diversi, come ad esempio la ricevuta di accettazione che è unica a fronte di più destinatari, sono riportate come collegamento che referenzia lo stesso allegato nei messaggi di tracciamento del singolo destinatario.

 

Ricezione di una ricevuta con informazione di invio effettuato da Jamio openwork ma non riconciliabile

Tale scenario si verifica, ad esempio, quando un messaggio PEC è stato inviato da Jamio istanziando una risorsa PEC in uscita e subito dopo l'invio la risorsa viene eliminata. Alla ricezione delle ricevute, il plug message non riesce a riconciliare le stesse con una Risorsa Jamio openwork specifica che traccia la spedizione, quindi le tratta come ricevute non riconciliabili e crea un nuovo messaggio PEC in entrata il cui campo notevole Warning viene impostato a valore Orphan receipt.

 

Ricezione di una ricevuta con informazione di invio effettuato esternamente da Jamio openwork

Tale scenario si verifica quando un messaggio PEC è stato inviato esternamente da Jamio openwork, ad esempio dal client web del gestore di posta elettronica certificata. Alla ricezione delle ricevute, il plug message non riesce a riconciliare le stesse con una Risorsa Jamio openwork specifica che traccia la spedizione, quindi le tratta come ricevute non riconciliabili e crea un nuovo messaggio PEC in entrata il cui campo notevole Warning viene impostato a valore Unmanaged receipt.