Supervisione e controllo XML-based da Windows Vista a Windows CE. Alarm Dispatcher. Cod. DOCS 11 AD Build 1101

Transcript

1 Supervisione e controllo XML-based da Windows Vista a Windows CE Alarm Dispatcher Cod. DOCS 11 AD Build 1101

2 Table Of Contents 1. ALARM DISPATCHER INTRODUZIONE COMANDI MENÙ GESTIONE LICENZA GESTIONE MULTILINGUA MESSAGGI IMPOSTAZIONI IMPOSTAZIONI GENERALI UTENTI MODULI PLUG-IN UTILIZZO DI ALARM DISPATCHER SU WINCE INVIO S VIA SMTP INVIO S VIA MAPI SMS VIA MODEM GSM SMS VIA SMPP INVIO FAX SMS VIA UCP-EMI INVIO MESSAGGI VOCALI ERRORI MODULI ERRORI RELATIVI AI PLUGINS DISPATCHERDOM DISPATCHERDOM OBJECT DISPATCHERDOM.ALDINIT DISPATCHERDOM.EMPTYQUEUE DISPATCHERDOM.GETDISPATCHERSTATE DISPATCHERDOM.GETMSGSTATUS DISPATCHERDOM.REMOVEMESSAGE DISPATCHERDOM.SETDISPATCHERSTATE DISPATCHERDOM.SENDMESSAGE DISPATCHERDOM.PUTLOG

3 1. Alarm Dispatcher 1.1. Introduzione Alarm Dispatcher è un programma software per la notifica (invio) di messaggi utilizzando vari mezzi di comunicazione (PlugIn), fra quelli configurati. Le tecnologie di comunicazione disponibili sono: 1. Messaggi SMS tramite protocollo SMPP 2. Messaggi SMS tramite GSM 3. Invio di Fax 4. Invio di Messaggi Vocali (Sintesi Vocale) 5. Invio di s tramite protocollo SMTP 6. Invio di tramite MAPI 7. Messaggi SMS tramite protocollo Ucp-Emi Il software è stato realizzato da Progea affinchè possa essere gestito da Movicon o da qualunque software in grado di gestire le funzioni, proprietà e metodi che il programma Alarm Dispatcher mette a disposizione. L'utilizzo tramite Movicon è totalmente trasparente nella notifica dei messaggi e nella gestione anagrafica. tuttavia l'utilizzo può essere personalizzato tramite gli script VBA oppure programmi di terze parti possono comandare ad Alarm Dispatcher la notifica dei messaggi secondo le tecniche di programmazione descritte in questa documentazione. Alarm Dispatcher mantiene, per ogni suo progetto di configurazione, un elenco di destinatari e la lista dei plugin da utilizzare per l'invio di messaggi. Alarm Dispatcher è pensato per funzionare come un server di smistamento messaggi. I messaggi provengono da Movicon o da qualsiasi applicazione Client che dovrà interfacciarsi utilizzando apposite funzioni. Tutta l'attività di presa in carico dei messaggi e loro distribuzione lascia una traccia nella finestra di log, oltre che nel relativo file di log. 3

4 A L A R M _ D I S P A T C H E R Utilizzo tramite Movicon Movicon utilizza le funzioni di Alarm Dispatcher in modo completamente trasparente. L'invio dei messaggi avviene tramite le proprietà degli allarmi del progetto di Movicon, ed i profili utenti (Recipients) sono quelli della gestione utenti del progetto di Movicon. Tuttavia è possibile utilizzare gli Script VBA di Movicon per personalizzare la gestione delle notifiche in base alle proprie necessità. Modalità di funzionamento. Alarm Dispatcher possiede due modalità di funzionamento: 1. Configurazione 2. Esecuzione (Run) Configurazione Il programma parte in modalità di progettazione (salvo l'avvio con opzione da riga di comando) dalla quale è possibile creare nuovi progetti di configurazione, aprirne di esistenti, modificarli e salvarli. L'avvio del programma provoca il caricamento dell'ultimo progetto salvato. Da questa modalità si ha accesso alle finestre di impostazione del progetto, per mezzo delle voci del menù "Settings" o dei pulsanti della barra degli strumenti. Il menù "File", e relativi pulsanti nella barra strumenti, consentono di gestire i progetti, che siano nuovi o esistenti. I comandi Run e Stop, presenti nel menù "File", consentono di passare da una modalità di funzionamento all'altra. Esecuzione (Run) In questa modalità avviene il vero e proprio smistamento ed invio dei messaggi. Quando possibile, secondo criteri appositi per ogni tipo di messaggio, i messaggi per uno stesso destinatario vengono raggruppati in uno solo, al fine di economizzare in tempo e risorse. Non è possibile modificare le impostazione di lavoro, ne chiudere il programma. Per fare queste cose è necessario ritornare alla modalità di Progettazione. Un'icona nella "tray area" segnala lo stato dell'applicazione e fornisce l'accesso alla finestra di log. Utilizzando il tasto desto del mouse si attiva un menù contestuale che fornisce alcuni comandi, utili se l'applicazione è stata avviata da un altro programma come applicazione nascosta. Windows 32/64 bit L'esecuzione diretta dell'alarm Dispatcher in modalità run è possibile usando l'opzione sulla riga di comando "/R". Sulla riga di comando si può anche inserire il file di progetto che deve essere caricato ed eseguito; altrimenti viene eseguito l'ultimo progetto che era stato caricato dall'alarm Dispatcher. Windows CE L'Alamr Dispatcher può essere eseguito solo nella modalità Run su WinCE. Quando nella riga di comando non viene specificato il percorso del progetto da eseguire, l'alarm Dispatcher cerca la presenza di un file di boot nella root della compact flash. Il file di boot deve avere il nome "Dispatcher.boot", e deve essere in formato XML con all'interno l'attributo "filename" in cui deve essere indicato il percorso e il nome del file che il Dispatcher deve eseguire. Se non c'è il file di boot, allora il Dispatcher esegue il progetto "AlarmDispatcher.Dspt" che, normalmente, si trova nella sua stessa cartella. Esempio di configurazione di un file di boot "Dispatcher.boot": <?xml version="1.0" encoding="iso "?> <boot> <filename>\ssd\projectfolder\projectname.dspt</filename> </boot> 1.2. Comandi Menù Menu File New Apre un nuovo progetto, impostando il valori di default per gli attributi. Attraverso la finestra di dialogo standard per la selezione di un file, si sceglie il percorso ed il nome del nuovo progetto. 4

5 A L A R M D I S P A T C H E R Open Apre un progetto esistente. L'estensione di default è <nome>.dspt Save Salva il progetto corrente. L'estensione di default è <nome>.dspt Save as Salva il progetto corrente in un nuovo progetto. Run Manda in esecuzione il processo di smistamento ed invio messaggi, utilizzando le impostazioni del progetto corrente. Stop Arresta l esecuzione dello smistamento ed invio messaggi. Il programma ritorna alla modalità di Progettazione. Exit Termina l esecuzione del programma Gestione Licenza Il prodotto Alarm Dispatcher, se utilizzato da Movicon, non richiede alcuna licenza in quanto utilizza la licenza di Movicon. Se è utilizzato invece da programmi di terze parti, il programma necessita di un codice di attivazione, che deve essere impostato tramite l'interfaccia COM. BOOL AlDInit(LPCTSTR lpszserialnumber) Argomento: LPCTSTR lpszserialnumber Codice di licenza per la disabilitazione della modalità Demo. Ritorna: TRUE (1) se il codice inserito è corretto. Permette di sbloccare la modalità di funzionamento demo. In modalità demo, le funzionalità sono complete, salvo che il messaggio inviato è un testo costante, non modificabile dall'utente. Il codice di licenza va richiesto agli uffici commerciali di Progea. Il codice di attivazione deve essere gestito come parametro di inizializzazione dal codice di utilizzo del programma. Contattare gli uffici commerciali Progea (sales@progea.com) per maggiori informazioni Il codice acquistato è valido per l'utilizzo del programma su una sola postazione 1.4. Gestione Multilingua Messaggi Quando l'alarm Dispatcher viene utilizzato all'interno di Movicon è possibile gestire l'invio dei messaggi in multilingua. Nel progetto Movicon è infatti possibile associare una lingua di default ad ogni utente o gruppi di utenti consentendo di inviare il messaggio al Dispatcher nella lingua dell'utente (naturalmente nel progetto Movicon dovrà essere stata definita la Tabella Stringhe per gestire il multilingua). Questo significa, ad esempio, che se una mail viene inviata a tre differenti utenti, ognuno di questi utenti riceverà il testo nella propria lingua di default. Il meccanismo funziona per l'invio dei messaggi SMS, e FAX. Per quanto riguarda l'invio dei messaggi Vocali (Voice) attualmente non è supportata la possibilità di modificare il TTS Engine, ovvero la voce, con il quale il Dispatcher esegue lo speech del testo. Questo significa che indipendentemente dalla lingua con la quale viene passato il testo al Dispatcher lo speech verrà fatto sempre con il TTS Engine impostato nel plugin "Voice Message Sender" del Dispatcher (ad esempio, selezionando Sam come voce lo speech verrà fatto sempre utilizzando i fonemi in inglese, anche se il testo del messaggi è in italiano o tedesco, ecc.). 5

6 A L A R M _ D I S P A T C H E R 6

7 2. Impostazioni 2.1. Impostazioni Generali Le Impostazioni Generali permettono di definire alcune configurazioni di carattere generale per l'intero progetto. Vi troviamo tre sezioni: Log, Communication e Priority delays. Log Controlla l'abilitazione alla registrazione su file degli eventi, il percorso del file ed il numero massimo di righe, dopo il quale il file ricircola. Enable log to file: se abilitato provoca la generazione di un file contenente traccia degli eventi che accadono durante il funzionamento del programma, quali inizio e termine dell'esecuzione, invio di messaggi, errori sull'invio Max Number of row in log: è il massimo numero di righe che conterrà il file. Le registrazioni successive saranno sovrascritte sulle righe più vecchie (ricircolo) Log file name: qui si può specificare un nome da dare al file di log. Se il campo rimane vuoto, il file di log avrà lo stesso nome del progetto, con estensione ".dsplog" Communications Determina le modalità di notifica dei messaggi. 7

8 A L A R M _ D I S P A T C H E R # Messages: Determina il numero di tentativi consecutivi di notifica di un messaggio. Dopo il numero specificato di tentativi, il programma segnala l'errore nell'invio del messaggio # Modules retry: Determina il numero di errori consecutivi di notifica messaggi per un singolo modulo (Plug In). Dopo il numero specificato di tentativi, il programma segnala l'errore nel modulo specificato Voice Multiplex: Selezionando questa opzione, la notifica di un messaggio vocale verrà inviata comunque a tutti i destinatari di un gruppo, indipendentemente dal singolo riconoscimento eseguito da ogni utente destinatario Priority Delay Determina le modalità di notifica dei messaggi. Priority Thread - Dealy: parametri relativi alla priorità di notifica del messaggio. Ad ogni priorità corrisponde un tempo di ritardo (min.). Se il messaggio è notificato da Movicon, la priorità assegnata all'allarme identifica il corrispondente tempo di ritardo di notifica. In caso di richiesta di invio da programmi terzi, è necessario assegnare una priorità di invio (funzione SendMessage), il cui numero corrispondente determinerà il relativo tempo di ritardo Esempio: in caso di insorgenza di due o più allarmi da notificare, il programma verificherà il numero di priorità e di conseguenza il tempo eventuale di ritardo assegnato. Quindi procederà a inviare per primo il messaggio con il tempo di ritardo (Delay) minore, identificando il tempo in base al numero di priorità Utenti La finestra di impostazione utenti (Recipients) permette di inserire l'anagrafica utenti destinatari delle notifiche, disponibili per il progetto. Gli utenti inseriti saranno elencati nella lista sul bordo sinistro. Ogni utente potrà essere aggiunto con il pulsante "Add", modificato con il pulsante "Modify" oppure eliminato con il pulsante "Delete". Name Definisce il nome identificativo del destinatario. Può essere una qualunque stringa di caratteri. Mobile Number Definisce il numero di telefono cellulare (mobile) del destinatario, per la ricezione dei messaggi SMS notificati dal programma. Il numero è suddiviso in tre parti per il prefisso internazionale, il prefisso locale ed il numero di telefono. 8

9 I M P O S T A Z I O N I Voice Number Definisce il numero di telefono del destinatario, per la ricezione dei messaggi vocali (Voice) notificati dal programma. Il numero è suddiviso in tre parti per il prefisso internazionale, il prefisso locale ed il numero di telefono. Fax Number Definisce il numero dell'apparecchio telefax del destinatario, per la ricezione dei messaggi fax notificati dal programma. Il numero è suddiviso in tre parti per il prefisso internazionale, il prefisso locale ed il numero di telefono. Mail Address Definisce l'indirizzo di posta elettronica per la ricezione delle notificate dal programma. Messenger Definisce l'indirizzo identificativo dell'utente destinatario collegato in rete tramite il programma Microsoft Windows Messenger. Utilizzo tramite Movicon Movicon utilizza le funzioni di Alarm Dispatcher in modo completamente trasparente. L'invio dei messaggi avviene tramite le proprietà degli allarmi del progetto di Movicon, ed i profili utenti (Recipients) sono quelli della gestione utenti del progetto di Movicon. Tuttavia è possibile utilizzare gli Script VBA di Movicon per personalizzare la gestione delle notifiche in base alle proprie necessità Moduli Plug-In La finestra di impostazione PlugIn (Moduli di Notifica) permette di inserire le modalità di trasmissione dei messaggi di notifica, utilizzando i moduli plug-in disponibili per nel programma. Ogni modulo plug-in disponibile può essere liberamente inserito e configurato nel programma, a seconda delle proprie necessità. I plug-in disponibili sono elencati sulla lista a sinistra, quelli inseriti saranno elencati nella lista sulla destra. Ogni plug-in potrà essere selezionato e quindi aggiunto con il pulsante "->", oppure rimosso con il pulsante "<-". Ogni modulo plug-in inserito dovrà necessariamente essere configurato. Per attivare la finestra di configurazione del modulo, selezionarlo dalla lista dei moduli inseriti e quindi fare doppio clic oppure utilizzare il pulsante "Configure". Verrà visualizzata la finestra con le relative impostazioni. Il pulsante "Version" permette di verificare il numero di versione e di release di ogni singolo modulo, tra quelli inseriti. Il numero di versione è utile per verificare la disponibilità di eventuali versioni più aggiornate. 9

10 A L A R M _ D I S P A T C H E R Il pulsante "Test" permette di verificare le impostazioni del plug-in inviando un messaggio di prova. Premendo il pulsante si apre una finestra specifica per ogni plug-in; qui è possibile inserire i dati di un destinatario, digitare un messaggio di prova ed eseguire l'invio Utilizzo di Alarm Dispatcher su WinCE Alarm Dispatcher può essere utilizzato anche su sistemi Windows CE. In questo caso però è necessario fare attenzione ad alcuni accorgimenti da seguire. L'Alarm Dispatcher per WinCE carica sempre il progetto "AlarmDispatcher.Dspt". Questo progetto si deve trovare nella cartella di installazione di Movicon CE insieme anche agli altri file di configurazione dei plugin e SMS (non è supportato il plugin per l'invio di messaggi vocali). Tutti questi file sopra citati vengono installati con l'alarm Dispatcher ma potrebbero aver bisogno di essere modificati. Ad esempio si potrebbe dover modificare la porta COM in cui l'alarm Dispatcher cerca il modem GSM, oppure il Server SMTP da utilizzare per l'invio delle . Quindi per eseguire le modifiche a questi file di progetto installati dal setup, si possono copiare sul PC desktop, modificarli con l'editor dell'alarm Dispatchere e ricopiarli nella cartella di installazione di Movicon CE. Nel caso in cui l'applicazione sia parte integrante dell'immagine di WinCE, occorre fare una routine allo startup del progetto o del device per copiare da una compact flash i file del progetto dell'alarm Dispatcher nella cartella "\Windows" Invio s via SMTP Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso l'invio di (posta elettronica) utilizzando l'accesso diretto ad un Server con protocollo SMTP. Questo tipo di notifica permette l'invio di anche in assenza di un programma di posta (es. Ms Outlook) installato sul PC di impianto. Il sistema di notifica richiede comunque un modem per l'accesso ad internet. Server Address Questa impostazione permette di definire il nome del Server di posta (operatore gestore del servizio) presso il quale si dispone dell'account. Static From Address Questa impostazione permette di definire un indirizzo da specificare nel messaggio come indirizzo del mittente. Questa impostazione è utile per utilizzare i Server che consentono l'invio di posta solamente se il mittente appartiene al proprio dominio. 10

11 I M P O S T A Z I O N I Authentication Permette di specificare se l'accesso al Server richiede l'autenticazione all'accesso oppure no. Authentication Type Permette di selezionare il tipo di autenticazione richiesta dal Server di posta. Al momento, le modalità di autenticazione supportate sono "Plain" e "Login". UserName, Password In queste due caselle di editazione è necessario specificare il nome utente e la password richieste per l'accesso all'account di posta. RAS Settings Qualora l'accesso ad internet richieda la connessione RAS (modem), occorre specificare i relativi parametri per la chiamata e quindi la connessione ad internet. Enable: abilita l'utilizzo di una connessione RAS per accedere al Server via modem. In caso contrario, significa che l'accesso al Server (internet) sfrutta una connessione permanente (es. LAN) Show Dialog: abilitala visualizzazione della finestra di dialogo durante la connessione Retry Hold Time: Timeout per ritentare la connessione Retry Hold Time: Timeout per eseguire la disconnessione Retries: Numero di tentativi di connessione Dial Up: permette di utilizzare una connessione già disponibile nel sistema operativo (precedentemente inserita nelle connessioni di rete) Phone Number: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare il numero di telefono di accesso al servizio UserName, Password: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare i parametri di accesso al servizio 2.6. Invio s via MAPI Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso l'invio di (posta elettronica) utilizzando il programma per l'invio di posta configurato in Windows come "Programma di posta" (es. Ms Outlook). E' importante ricordare che questo tipo di notifica utilizza il programma di posta configurato, quindi è indispensabile che tale programma sia correttamente installato e configurato. 11

12 A L A R M _ D I S P A T C H E R Profile Name Permette di specificare il nome del profilo (account) presente tra i profili riconosciuti nel programma di posta installato. Tutti i parametri per l'accesso al Server di posta saranno pertanto da configurarsi nel profilo (account) di posta del programma (es. Ms Outlook). RAS Settings Qualora l'accesso ad internet richieda la connessione RAS (modem), occorre specificare i relativi parametri per la chiamata e quindi la connessione ad internet. Enable: abilita l'utilizzo di una connessione RAS per accedere al Server via modem. In caso contrario, significa che l'accesso al Server (internet) sfrutta una connessione permanente (es. LAN) Show Dialog: abilitala visualizzazione della finestra di dialogo durante la connessione Retry Hold Time: Timeout per ritentare la connessione Retry Hold Time: Timeout per eseguire la disconnessione Retries: Numero di tentativi di connessione Dial Up: permette di utilizzare una connessione già disponibile nel sistema operativo (precedentemente inserita nelle connessioni di rete) Phone Number: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare il numero di telefono di accesso al servizio UserName, Password: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare i parametri di accesso al servizio 2.7. SMS via Modem GSM Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso la tecnologia SMS basata su GSM, utilizzando qualsiasi modem GSM standard. 12

13 I M P O S T A Z I O N I Serial Port Settings In questo gruppo di impostazioni occorre specificare i parametri di utilizzo della porta seriale alla quale il modem GSM è collegato. Inizialization String Stringa di inizializzazione del modem. Normalmente utilizzare ATE0, ma è sempre preferibile attenersi alla documentazione del modem utilizzato. ServiceCenter Questo numero potrebbe essere richiesto dalla SIM Card utilizzata dal modem. Pin Numbers I numeri PIN devono essere introdotti in funzione della SIM Card utilizzata dal modem SMS via SMPP Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso la tecnologia SMS basata sul protocollo SMPP (Short Message Point-To-Point protocol). Grazie a questa tecnica di notifica, il sistema è in grado di inviare messaggi SMS sui telefoni dei destinatari accedendo direttamente ad un Server SMPP, senza quindi la necessità di un modem GSM. Naturalmente, occorre verificare la disponibilità di un operatore telefonico abilitato al servizio, quindi attivare il conseguente abbonamento. In base alla scelta dell'operatore (gestore del servizio), occorrerà impostare i parametri funzionali e di accesso relativi. Server Address Occorre specificare l'indirizzo del Server SMPP dell'operatore telefonico e gestore del servizio. Server Port Generalmente è richiesta la porta 9000, ma occorre sempre verificare la porta del Server richiesta del gestore del servizio. 13

14 A L A R M _ D I S P A T C H E R Source TON, NPI, Type Parametri di accesso richiesti dal gestore del servizio. Source ID, Password Parametri di accesso richiesti dal gestore del servizio. Si dell'abbonamento. ricevono dopo l'attivazione Timeout: Binding, Answer, Delivery Impostazione dei tempi (msec) relativi ai timeout di funzionamento. RAS Settings Qualora l'accesso ad internet richieda la connessione RAS (modem), occorre specificare i relativi parametri per la chiamata e quindi la connessione ad internet. Enable: abilita l'utilizzo di una connessione RAS per accedere al Server via modem. In caso contrario, significa che l'accesso al Server (internet) sfrutta una connessione permanente (es. LAN). Show Dialog: abilitala visualizzazione della finestra di dialogo durante la connessione Retry Hold Time: Timeout per ritentare la connessione Retry Hold Time: Timeout per eseguire la disconnessione Retries: Numero di tentativi di connessione Dial Up: permette di utilizzare una connessione già disponibile nel sistema operativo (precedentemente inserita nelle connessioni di rete) Phone Number: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare il numero di telefono di accesso al servizio UserName, Password: nel caso in cui non si utilizzi un profilo di connessione esistente, specificare i parametri di accesso al servizio 2.9. Invio Fax Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso il gestore Fax di Windows. Il programma infatti consente la spedizione di fax utilizzando la stampante fax di Windows. L'unica proprietà da configurare nel programma è quindi il nome quale "Titolo Intestazione" del fax che verrà inviato. Prima di utilizzare il servizio di notifica via Fax, è necessario procedere alla corretta e completa configurazione del servizio in Windows. Per fare ciò, occorre utilizzare il Pannello di Controllo ed accedere alla voce "Stampanti e Fax". 14

15 I M P O S T A Z I O N I SMS via Ucp-Emi Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso la tecnologia SMS, utilizzando qualsiasi modem standard per collegarsi ad un server che supporti il protocollo Ucp. Serial Port Settings In questo gruppo di impostazioni occorre specificare i parametri di utilizzo della porta seriale alla quale il modem è collegato. Timeout Tempo di attesa (in ms.) per le operazioni di comunicazione sulla seriale. 15

16 A L A R M _ D I S P A T C H E R Pause Tempo di attesa (in ms.) fra l'invio di due messaggi successivi. E' sconsigliabile tenerlo basso, poichè i server Ucp, frequentemente, non supportano l'invio di messaggi in sequenze veloci. Default RTS/DTR Stato dei corrispondenti segnali della porta seriale. Per alcuni modelli di modem può essere richiesta questa impostazione. Di norma, con i dispositivi attualil, non è necessario modificare l'impostazione. Max Connection try Numero di tentativi di invio successivi, dopo i quali il messaggio viene eliminato. Inizialization String Stringa di inizializzazione del modem. Normalmente utilizzare ATE0, ma è sempre preferibile attenersi alla documentazione del modem utilizzato. ServiceCenter Questo è il numero da chiamare per il collegamento col server Ucp-Emi. Sender Address Questo è il numero che viene utilizzato come numero mittente del messaggio Invio Messaggi Vocali Questa finestra di impostazione permette di configurare il sistema di notifica messaggi attraverso la tecnologia Voice - Text-To-Speech. Grazie a questa tecnologia, il programma provvederà a sintetizzare vocalmente le stringhe di test dei messaggi, quindi a notificarli ai destinatari via telefono. E' necessario l'utilizzo di un Modem Voice compatibile 100% con le specifiche TAPI Modalità di invio dei messaggi vocali: 1. Il programma notifica i messaggi vocali al destinatario indicato. In caso di gruppo di destinatari, il programma invia i messaggi secondo due possibili modalità: Proprietà "Voice Multiplex" non selezionata (come default) nei General Settings: Il programma notifica i messaggi partendo dal primo destinatario del gruppo. Il primo che esegue il riconoscimento (Ack) determina il termine con buon fine della procedura di notifica Proprietà "Voice Multiplex" selezionata: il programma notifica i messaggi partendo dal primo destinatario del gruppo. Il programma notifica comunque a tutti i destinatari del gruppo i messaggi, indipendentemente dal singolo eventuale riconoscimento (Ack). Il riconoscimento comporta l'esito a buon fine della notifica, ma non interrompe la notifica stessa a tutti i destinatari 2. Quando un utente risponde alla chiamata, il programma fornisce il messaggio di benvenuto, quindi inizia a notificare il messaggio di allarme. L'allarme viene ripetuto fino al comando di tacitazione (Ack) oppure fino al timeout. La tacitazione può avvenire in due modi: Proprietà "Force message acknowledgement with key #" non selezionata (come default) nelle proprietà Voice: il programma notifica il messaggio fino alla pressione di un tasto qualsiasi del telefono, quindi considererà riconosciuto l'allarme e passerà all'eventuale successivo (se presente), precedendolo dal messaggio di "Nuovo Allarme". Anche il messaggio successivo verrà ripetuto fino alla pressione di un tasto qualsiasi. Con l'ultimo messaggio, il tasto qualsiasi premuto provvederà a chiudere la comunicazione, con esito positivo. Se non si preme un tasto qualsiasi, il sistema resterà a ripetere il singolo messaggio fino al timeout, quindi chiuderà la comunicazione con esito negativo nel Log Proprietà "Force message acknowledgement with key #" selezionata nelle proprietà Voice: il programma si comporterà come prima, salvo che il programma terminerà la comunicazione solo con la pressione del tasto "#" dal telefono. Quindi, premendo un tasto qualsiasi si passerà al messaggio successivo, ma al termine dei messaggi, il sistema ricomincerà a comunicare il primo messaggio considerando 16

17 I M P O S T A Z I O N I solo il tasto "#" quale tasto di conferma e riconoscimento degli allarmi. Se non si preme il tasto "#", il sistema ripeterà i messaggi fino al timeout. La pressione del tasto "#" comporterà il riconoscimento di tutti gli allarmi, anche quelli non ancora notificati Welcome Message Permette di definire una stringa di testo che verrà trasmessa come messaggio introduttivo, all'inzio della chiamata di notifica, precedendo i messaggi. Farewell Message Permette di definire una stringa di testo che verrà trasmessa come messaggio finale, al termine della notifica, per avvisare della chiusura della comunicazione. Next Message Permette di definire una stringa di testo che verrà trasmessa tra la notifica di un messaggio ed il successivo. TimeOut Definisce il tempo (sec.) oltre il quale, non ricevendo alcun segnale di riconoscimento, il sistema abbandonerà la comunicazione (ad esempio in presenza di segreterie telefoniche). Max Retry Definisce il numero massimo di tentativi nel recapito della notifica. Force message acknowledgement with key # Questa selezione permette di impostare il tipo di comportamento nella gestione del comando di riconoscimento (Ack) degli allarmi da parte dell'utente destinatario. Opzione non selezionata: alla notifica dei messaggi, il sistema si aspetterà la pressione di un qualsiasi tasto della tastiera telefonica per riconoscere (Ack) l' allarme in corso di notifica. 17

18 A L A R M _ D I S P A T C H E R Se presenti altri messaggi, la pressione di un tasto qualsiasi passerà a quello successivo, altrimenti chiuderà con successo la notifica Opzione selezionata: alla notifica dei messaggi, il sistema si aspetterà la pressione del tasto # per riconoscere (Ack) l' allarme in corso di notifica. La pressione del tasto # chiuderà con successo la notifica, anche in presenza di altri allarmi Modem Questa selezione permette di scegliere quale modem utilizzare. La lista dei modem viene compilata in base ai modem voice installati nel sistema operativo. Speech Voice Questa selezione permette di scegliere quale voce, e quindi quale fonema, utilizzare per lo speech dei messaggi. La lista verrà compilata in base ai fonemi installati nel sistema operativo (vedi "Fonemi (Voci)"). Test La pressione del pulsante "Test" eseguirà lo speech del testo inserito nella casella di editazione con le impostazioni di voce, volume, rate e pitch definite. Volume Tramite questa proprietà è possibile impostare la percentuale di volume con cui eseguire lo speech. Rate Tramite questa proprietà è possibile impostare la velocità di esecuzione dello speech. Dal valore 0 a 10 si aumenta la velocità di enunciazione, mentre da 0 a -10 si rallenta la velocità di enunciazione. Pitch Tramite questa proprietà è possibile impostare il tono (più acuto o più grave) della voce per lo speech. Acknowledge scada alarm Se si abilita questa proprietà, quando l'operatore eseguirà il riconoscimento del messaggio, l'allarme verrà anche riconosciuto e resettato nel progetto Movicon. Se pertanto l'allarme in questione era già nello stato di OFF, allora scomparirà anche dalla Finestra Allarmi. Utilizzo delle SAPI 5.1 Le SAPI (Speech Application Programming Interface) sono librerie di Microsoft che consentono di utilizzare le funzionalità di "Riconoscimento Vocale" e "Sintetizzazione Vocale" con applicazioni su Windows. Alarm Dispatcher utilizza le SAPI versione 5.1 per l'invio dei messaggi vocali. Le SAPI 5.1 fanno parte della famiglia delle SAPI 5 e sono installate di default in Windows 32/64 bit dal 2001 (vedi B4530&displaylang=en). Per il corretto utilizzo delle SAPI 5.1 per l'invio dei messaggi vocali con Alarm Dispather è necessario: 1. Installare lo Speech Recognition SAPI Installare almeno un fonema che supporti le SAPI Utilizzare la versione dell'alarm Dispatcher o successive 4. Nell'Alarm Dispatcher utilizzare il PlugIn Message Voice Sender (Voice.dll) versione o successive 5. Utilizzare un modem Voice compatibile al 100% con le TAPI di Windows Modem Voice Per un corretto invio dei messaggi vocali è necessario installare un Modem Voice pienamente compatibile con le TAPI di Windows. Si raccomanda inoltre di eseguire sempre l'installazione dei driver a corredo con il modem e di non far selezionare dal sistema operativo il driver più idoneo per quel modem. Ad esempio, se si installa il modem voice "US Robotics 56K Message Modem" è necessario installare i driver proprietari "US Robotics 56K Message V.92" altrimenti i driver di sistema (European) non riconoscono i toni del telefono per rispondere al messaggio. Fonemi (Voci) Per poter eseguire l'enunciazione dei testi è necessario utilizzare i fonemi che possono essere installati nel sistema operativo. Per verificare la lista dei fonemi già presenti è sufficiente aprire il 18

19 I M P O S T A Z I O N I gruppo "Sintesi e Riconoscimento Vocale" dal Pannello di Controllo di Windows. Selezionando la tab "Sintesi vocale" nella finestra di dialogo che verrà aperta è possibile verificare la lista dei fonemi, o voci, già presenti nel sistema (Seleziona voce). Normalmente sono già presenti alcune "voci" che installa Windows di default, Sam, Mary e Mike. Queste voci utilizzano tutte dei fonemi in lingua inglese ma sono fonemi SAPI 4 e quindi non utilizzabili col Plug-in Voice Message Sender. Sarà quindi necessario installare dei nuovi fonemi in base alla lingua che si vorrà utilizzare. I fonemi da installare dovranno essere compatibili con le SAPI 5.1. Si tenga anche conto del fatto che in commercio (su internet) sono disponibili numerosi fonemi rilasciati da differenti ditte, e la qualità di questi fonemi può essere anche notevolmente diversa a seconda della ditta che lo fornisce. E' consigliabile quindi eseguire una valutazione di alcuni fonemi prima di scegliere quello da utilizzare. Si consideri anche che alcuni fonemi potrebbero presentare maggiori limitazioni di utilizzo rispetto ad altri. Normalmente, per la sintesi vocale via telefono, sono migliori i fonemi di qualità "telefonica" (8KHz) rispetto a quelli a qualità più alta (22KHz o oltre). Utilizzando le SAPI 5.1 è possibile eseguire lo speech anche di caratteri accentati come "è", "ì" ecc. e di punteggiatura come "?" e "!" senza che il TTS Engine abbia problemi. Questo perchè non è più utilizzato il processo "vcmd.exe" che col SAPI 4 causava il blocco del TTS Engine. 19

20 A L A R M _ D I S P A T C H E R 20