Da un punto di vista generale la Spedizione identifica un processo di business in cui bisogna raggiungere l'obiettivo di mandare qualcosa ad uno o più indirizzi (Address) di uno o più destinatari (Correspondent), attraverso uno o più vettori (Carrier) che utilizzano mezzi di trasporto (Transport).
Il processo si sviluppa attraverso uno o più stati che denominiamo SendingStatus sino al raggiungimento dell'obiettivo che denominiamo TargetSendingStatus.
L'obiettivo è determinato dalla problematica di business e condizionato dal Carrier e dal Transport utilizzato, per esempio con la Posta Elettronica non si riesce sempre a sapere se il messaggio è stato consegnato.
Gli stati possono essere ordinati in ordine crescente, gli stati più bassi rappresentano situazioni indeterminate o di errore, quelli più alti il raggiungimento di obiettivi di business a complessità crescente (inviato, consegnato, processato).
Il processo generale di Spedizione può essere scomposto nelle singole spedizioni che vengono tipicamente definite da un identificativo fornito dal Carrier che denominiamo SendingID.
La tupla Correspondent, Address, Carrier, Transport, TargetSendingStatus, SendingStatus, SendingID prende il nome di SendingPath o percorso di spedizione.
Un processo di Spedizione identifica un processo di business multidestinatario e multicanale che può dirsi concluso con successo quando tutte le SendingPath hanno raggiunto il proprio TargetSendingStatus.
Con la risorsa Data e le funzionalità messe a disposizione dal Servizio core Jamio Sending delle API di piattaforma è possibile governare un processo di spedizione ed in particolare di:
•associare ad una risorsa Data diversi SendingPath;
•ottenere lo stato di avanzamento del processo di spedizione su un Correspondent; nel caso in cui si cerchi di raggiungere un Correspondent attraverso Carrier e Transport diversi, la spedizione al Correspondent può dirsi completata con successo nel momento in cui sono stati conseguiti tutti gli obiettivi sui percorsi di consegna o se è stato conseguito un obiettivo di consegna superiore o uguale agli obiettivi ancora da raggiungere per quel corrispondente; la spedizione si completa con errore quando tutte le SendingPath sono andate in errore;
•ottenere lo stato di avanzamento del processo della spedizione come percentuale di SendingPath (proprietà SendingProgress di Dati) che hanno raggiunto l'obiettivo;
•ottenere lo stato complessivo del processo di spedizione (proprietà SendingStatus di Dati) come il peggior stato fra tutti gli stati dei corrispondenti e per i quali la spedizione è in corso; fa eccezione a questa regola la situazione in cui la spedizione per almeno un corrispondente è caratterizzata da una situazione di blocco (errore, timeout), in tal caso, lo stato di tutta la Spedizione è pari a errore oppure timeout;
•specificare la direzione della Spedizione (proprietà SendingDirection di Dati) distinguendo tra flussi in entrata e flussi in uscita; per i flussi in entrata il Correspondent è il mittente della spedizione, per i flussi in uscita il Correspondent è il destinatario della spedizione.
Schema spedizione multicanale e multidestinatario
Ogni Correspondent di una spedizione dispone di un insieme di informazioni (CorrespondentInfo) utili a consultare il suo stato e la lista dei SendingPath ad esso associati.
In Jamio openwork il SendingPath è caratterizzato inoltre
•da un LeadTime che identifica il tempo in cui l'obiettivo deve essere raggiunto, se questo non accade il SendingPath viene messo in timeout;
•dallo stato completato che se vero indica il raggiungimento dell'obiettivo;
•dalla data di avvio della spedizione.
Le funzionalità del Servizio Core Jamio Sending delle API di piattaforma consentono di modificare il TrackingStatus di un SendingPath tramite l'inserimento di TrackingMessage.
Jamio Sending consente di ottenere la reportistica sullo stato complessivo di una spedizione e sugli eventi che ne hanno determinato l'avanzamento. Tali informazioni sono rese disponibili anche all'utente finale tramite l'interfaccia di Jamio on Stage.
Il Plug Message orchestra le funzionalità di tracking per governare processi di spedizione tramite trasporti predefiniti (Posta Elettronica Certificata e Posta Elettronica Ordinaria) e vettori di spedizione configurati tramite Risorse Jamio openwork (tipicamente di tipo Data o Identity). Il Jamioplug Message crea in automatico i SendingPath e TrackingMessage derivanti dalla spedizione e li associa alla risorsa Dati che traccia il processo.
Esempio
Supponiamo di dover convocare il Sig. Rossi e il Sig. Verdi, che la convocazione debba avere un valore legale e quindi si debba poter attestare in forma opponibile a terzi l'avvenuta ricezione della convocazione. Del Sig. Rossi è noto l'indirizzo di residenza, del Sig. Verdi l'indirizzo di Posta Elettronica Certificata.
Nello scenario descritto siamo in presenza di:
•due corrispondenti, il sig. Rossi e il sig. Verdi;
•ad ognuno dei corrispondenti è associato un SendingPath:
oil SendingPath del sig. Rossi utilizza come Transport la Racccomadata con ricevuta di ritorno, come Carrier Poste Italiane, l'indirizzo è il suo indirizzo di residenza, il TargetSendingStatus è Delivered
oil SendingPath del sig. Verdi utilizza come Transport la PEC, come Carrier la casella PEC di chi sta convocando l'assemblea, l'Address è il suo indirizzo di posta elettronica certificata, il TargetSendingStatus è Delivered;
Definita una risorsa di tipo Dati per il monitoraggio del processo di spedizione,
•per la gestione della raccomandata A/R è possibile utilizzare le funzionalità del Servizio core Jamio Sending delle API di piattaforma in un processo che:
oavvia la spedizione creando un SendingPath per il Correspondent Rossi;
oregistra la spedizione tramite l'inserimento del codice della raccomandata e genera un TrackingMessage con TrackingStatus Accepted sul SendingPath del Sig. Rossi;
oregistra la ricezione della ricevuta di ritorno e genera un TrackingMessage con Status Accepted sul SendingPath del Sig. Rossi;
•per la gestione della PEC è possibile utilizzare il metodo SendPEC del Plug Message per avviare la spedizione per il Correspondent Verdi. Il Plug Message valorizza automaticamente il Data preposto alla gestione del processo di convocazione e alla ricezione della ricevuta di accettazione e di consegna della PEC, crea automaticamente i TrackingMessage utili a segnalare l'avvenimento.