- Itinera srl
Transcript
- Itinera srl
MANUALE UTENTE versione 2013A Sommario AVVERTENZE..............................................................................................................................................................................................1 INTRODUZIONE ..........................................................................................................................................................................................3 ARCHITETTURA ...................................................................................................................................................................................4 INSTALLAZIONE.........................................................................................................................................................................................5 PREREQUISITI PER INSTALLAZIONE PASSEPARTOUT CONNECTION MANAGER ................................................................5 CONFIGURAZIONE ...................................................................................................................................................................................21 GESTORE PASSEPARTOUT CONNECTION MANAGER ...............................................................................................................21 CONNESSIONE E PRIMO AVVIO......................................................................................................................................................23 LOG........................................................................................................................................................................................................27 ELENCO PLUG-IN......................................................................................................................................................................................29 ALTECON .............................................................................................................................................................................................29 CISA.......................................................................................................................................................................................................29 GLT ........................................................................................................................................................................................................30 MEGANET ............................................................................................................................................................................................30 MICRODEVICE ....................................................................................................................................................................................30 IRNET PAY-TV.....................................................................................................................................................................................31 SIEMENS...............................................................................................................................................................................................31 ONITY ...................................................................................................................................................................................................32 INDELB .................................................................................................................................................................................................32 STS .........................................................................................................................................................................................................33 CENTRALINI ........................................................................................................................................................................................33 SKY (PAY PER VIEW).........................................................................................................................................................................41 VDA MICROMASTER .........................................................................................................................................................................42 EELECTRON.........................................................................................................................................................................................44 GFP LAB GIANO ..................................................................................................................................................................................45 TECNOVOX ..........................................................................................................................................................................................46 RIEPILOGO PLUGIN SUPPORTATI.........................................................................................................................................................49 AVVERTENZE Il presente manuale descrive gli ambienti ed i modi per eseguire l’installazione, l’aggiornamento e la configurazione di Passepartout Connection Manager nelle varie modalità operative e fornisce all'utente un supporto all'utilizzo dell'applicazione stessa. In esso vengono spiegate le caratteristiche e le funzioni con l'ausilio di riproduzioni delle pagine video, esempi pratici e riproduzione dei tabulati. Il manuale, pur essendo redatto con la massima cura, potrebbe non essere perfettamente allineato al programma a seguito di rilasci di nuove funzioni in momenti successivi alla stesura del manuale stesso; per eventuali discrepanze fra quanto descritto nel manuale e quanto effettivamente riscontrato nel programma, contattare il rivenditore autorizzato per i necessari chiarimenti. Nella stesura di questo volume ci siamo posti due obiettivi: realizzare un valido strumento da utilizzare nella fase di apprendimento iniziale del programma e fornire un supporto agli utenti più esperti che devono affrontare problematiche particolari. Nella speranza di aver conseguito i risultati che ci eravamo proposti e scusandoci per eventuali imperfezioni auguriamo a tutti i nostri utenti Buon lavoro Reparto Divisione Tecnica Passepartout s.p.a. Tutti i marchi registrati sono di appartenenza dei legittimi proprietari. NOZIONI GENERALI 2 • AVVERTENZE PASSPARTOUT CONNECTION MANAGER INTRODUZIONE Passepartout Connection Manager (PCM in questo manuale) è uno strumento che consente di integrare i prodotti Passepartout Welcome, Passepartout Menu, Passepartout Beauty e Passepartout Retail con dispositivi esterni come centralini telefonici, controllo e gestione degli accessi, PayTv, sistemi di addebito, domotica. PCM nasce dalla necessità di facilitare l’integrazione tra il Software Passepartout e i dispositivi hardware di terze parti , rendendo indipendente l’integrazione di nuovi dispositivi dal processo di rilascio di nuove versioni dei programmi Welcome, Retail, Menu e Beauty. PCM integra un insieme di moduli (Plugin) che forniscono l’interfaccia software ai dispositivi e fornisce una piattaforma di comunicazione con i programmi sopra citati. Tutto questo è possibile grazie ad una tecnologia proprietaria che fornisce un interfaccia universale ai dispositivi. PCM è quindi composto da una serie di moduli attivabili separatamente ognuno dei quali fornisce il supporto per specifici dispositivi. Lo strumento, facile e versatile, dialoga in modo bidirezionale con i vari dispositivi, inviando e ricevendo informazioni e si pone come strumento di comunicazione immediato fra i dispositivi hardware ed i programmi Passepartout. INTRODUZIONE • 3 PASSPARTOUT CONNECTION MANAGER ARCHITETTURA PCM si propone come un ponte tra programma Passepartout (d’ora in poi “Server” o “Gestionale”) e dispositivi. A questo scopo implementa due componenti principali: Un interfaccia software al dispositivo chiamata “Plugin”. Un protocollo di comunicazione bidirezionale tra server e plugin Grazie al suo protocollo di comunicazione, può essere installato su una macchina diversa da quella in cui risiede il server, permettendo quindi di “remotizzare” dispositivi che non dispongono di interfaccia remota (solo seriali o usb). E’ possibile anche avere più PCM installati su diverse macchine che dialogano con lo stesso server. Per la sua natura versatile PCM può essere installato su un qualunque PC della rete e far comunicare server e dispositivi indipendentemente dalla loro collocazione fisica. Sulla stessa installazione PCM posso essere interfacciati più dispositivi. 4 • INTRODUZIONE PASSPARTOUT CONNECTION MANAGER INSTALLAZIONE PREREQUISITI PER INSTALLAZIONE PASSEPARTOUT CONNECTION MANAGER REQUISITI HARDWARE • CPU >= Intel Pentium IV /3 GHz (o equivalenti); • RAM >= 2 GB • Video Risoluzione minima 1024x768 (monitor e scheda video adeguati); FunzionalitàTouchscreen USB; • Mouse; • Spazio HD >= 350 MB; • Rete Schede a 100 Mb/sec; collegamento con cavi UTP >= cat.5. REQUISITI SOFTWARE • Sistemi operative supportati: Windows XP Professional / Windows 2003/ Windows Vista, WEPOS ( Windows Embedded for Point Of Service) • Rete di Microsoft Windows; • Framework .NET v. 3.5 SP 1; • RDBMS Microsoft SQLServer o MSDE ( 2000 ) , residente sulla stessa macchina del server applicativo oppure su una macchina dedicata. o dedicata . SQL Server Express ( 2005 ), residente sulla stessa macchina del server applicativo oppure su una macchina NOTA BENE: obbligatorio per Windows VISTA • RDBMS Microsoft SQLClient , necessario per connettersi ad un SQL Server remoto o MDAC versione 2.6 o superiore (già integrato con MSDE ); o sqlncli.msi ( già integrato con SQLExpress ) NOTE: con il sistema operativo Windows Vista è necessario utilizzare SQL Server Express disponibile gratuitamente, o sql 2005 INSTALLAZIONE • 5 PASSPARTOUT CONNECTION MANAGER ATTENZIONE: applicare l’ultimo Service Pack relativo al S.O. prescelto (se esistente) e tutte le patch disponibili sia del S.O. che dei componenti installati. MSDE L’installazione di tale requisito, per il corretto funzionamento del programma, necessita dell’impostazione di alcune opzioni relative alla password da SuperAmministratore, al tipo di autenticazione e all’attivazione dei protocolli di rete. In caso l’installazione di MSDE venga effettuato dal CD fornito per l’installazione di PCM tali impostazioni risulteranno già determinate, in caso si disponga di una versione originale del setup tali impostazioni dovranno essere aggiunte da riga di comando. Per maggiori informazioni sul settaggio di tali impostazioni si consiglia di seguire quanto riportato di seguito: MICROSOFT DESKTOP ENGINE (MSDE) 2000 SP 3A Nel caso di nuova installazione dell’MSDE 2000 SP 3, inizialmente è necessario estrarre i files dal pacchetto di installazione. Una volta effettuata l’operazione è necessario eseguire l’installazione utilizzando la linea di comando, in quanto il setup deve essere lanciato con alcuni parametri di installazione. Per far ciò dal menù start scegliere Esegui e digitare cmd in modo da aprire una shell di comando (command), e da qui portarsi nella cartella contenente i files del setup (precedentemente scelta) e procedere come segue: setup.exe SAPWD=<password utente sa> SECURITYMODE=SQL DISABLENETWORKPROTOCOLS=0 Il significato dei parametri di installazione sopra riportati è il seguente: − SAPWD: comando che permette di impostare una password per l’utente sa (che è consigliabile essere sicura, cioè almeno alfanumerica), o in alternativa non impostata (cioè nulla); − SECURITYMODE=SQL: comando per impostare l’autenticazione in modalità “mista”, NT e SQL Server; − DISABLENETWORKPROTOCOLS=0: comando per attivare i protocolli di rete di SQL Server, in modo tale da permettere l’accesso all’SQL Server dalle altre macchine della rete. Nel caso in cui l’installazione sia stata fatta trascurando il primo e il secondo parametro, è possibile modificarla o reinstallando l’MSDE 2000 SP3 oppure attraverso l’Enterprise Manager di un’installazione client di SQL Server Standard/Enterprise, effettuata anche in una macchina diversa, seguendo la procedura sopra esposta per SQL Server. Per impostare il terzo parametro è possibile installare gli strumenti client di SQL Server 2000 sulla macchina dove è presente l’MSDE 2000 SP 3 e cambiare la configurazione attraverso l’Enterprise Manager oppure utilizzare l’utilità svrnetcn.exe presente in “C:\Programmi\Microsoft SQL Server\80\Tools\Binn ” che permette l’abilitazione e la disabilitazione selettiva di protocolli di rete utilizzati. A tal proposito è necessario che siano abilitati i protocolli di rete “TCP/IP” e “Named Pipes” (che sono i protocolli abilitati in automatico attraverso l’installazione). IMPORTANTE: la dimensione massima di un database gestibile attraverso l’MSDE è di 2 GB, il numero di utenti concorrenti che vi possono accedere è di 25 e il numero di batch concorrenti eseguibili è di 5 6 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER INSTALLAZIONE SQL SERVER 2005 EXPRESS SP2 Analogamente a quanto riportato sopra, anche per SQL Server Express 2005 Sp1 è necessario specificare alcune opzioni per il corretto funzionamento del programma. Di seguito viene mostrato come effettuare il setup di SQL Server Express 2005 e del client Management Studio. Lanciando il setup di SQL Server, vengono inizialmente estratti i file: e successivamente viene richiesta l’accettazione dei termini di contratto. Chiede se si vuol continuare l'esecuzione dell'applicazione dare CONTINUA: Una volta spuntata la relativa voce come mostrato in figura sopra, procedere tramite il pulsante Avanti così da arrivare all’installazione dei componenti necessari per poter poi installare SQL Server: Proseguire l’installazione selezionando Installa. Proseguire l’installazione tramite il pulsante Avanti fino ad arrivare al punto in cui il programma di setup un controllo sulla configurazione di sistema per il controllo per rilavare la presenza di potenziali problemi di installazione: INSTALLAZIONE • 7 PASSPARTOUT CONNECTION MANAGER Una volta terminato il controllo proseguire con il pulsante Avanti: Nella maschera di “Informazioni di registrazione” togliere la spunta a Nascondi opzioni avanzate e proseguire con il pulsante Avanti. Nella finestra “Selezione funzionalità” è possibile decidere quali componenti installare oltre ai servizi di database: 8 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER Selezionando Avanti si passa alla scelta della tipologia di istanza. In caso sulla macchina in uso non vi sia già installata un’istanza predefinita selezionare l’omonima opzione, in caso contrario selezionare “Istanza denominata” ed eventualmente modificarne il nome, così sarà possibile per far coesistere le diverse installazioni senza procedere ad una migrazione \ aggiornamento che potrebbe causare delle perdite di dati sensibili: Tramite il pulsante Istanze installate è possibile visualizzare le eventuali istanze già esistenti sulla macchina. Proseguendo con il pulsante Avanti, si arriva alla maschera che permette di personalizzare L’account di accesso al programma: Nella sezione avvia i servizi al termine dell’installazione è possibile decidere quali servi avviare una volta terminata l’installazione. Proseguire con l’installazione mediante il pulsante Avanti per definire la modalità di autenticazione: INSTALLAZIONE • 9 PASSPARTOUT CONNECTION MANAGER Per la modalità di autenticazione, è importante spuntare Modalità Mista in modo tale da permettere sia la modalità di autenticazione di Windows che quella di SQL Server. E’ possibile modificare questa impostazione successivamente utilizzando il tool “SQL Server Management Studio Express Edition” (SSMSEE) scaricabile dal seguente collegamento internet: http://go.microsoft.com/fwlink/?linkid=51793 (una volta installato lo si trova nella cartella Tutti i ProgrammiÆ Microsoft SQL Server 2005). Inoltre è necessario assegnare una password. Premere avanti per continuare l’installazione, proseguire lasciando tutte le impostazioni predefinite fino a che non si giunge alla maschera Opzioni di configurazione dove è necessario spuntare l’opzione Attiva istanza utente: Proseguire lasciando tutte le impostazioni predefinite fino ad arrivare alla maschera di Inizio installazione: 10 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER Selezionare Installa per iniziare l’installazione e proseguire con il pulsante Avanti fino a che non si giunge alla fine dell’istallazione: Cliccare su fine per terminare l’installazione: Una volta installato SQL Express 2005 è necessario effettuarne la configurare in modo che vengano accettate connessioni esterne alla macchina su cui è installato. Per fare questo lanciare la configurazione superficie di attacco dal percorso Start -> Programmi -> Microsoft SQL Server 2005 -> Strumenti di configurazione -> Configurazione superficie di attacco di SQL Server. Selezionare Configurazione superficie di attacco per servizi e connessioni per aprire la relativa maschera. Nella finestra di configurazione, fare click sul simbolo + posto accanto alla voce Database Engine, selezionare Connessioni remote ed impostare le opzioni come mostrato di seguito, poi confermare premendo “OK”: INSTALLAZIONE • 11 PASSPARTOUT CONNECTION MANAGER Alla conferma delle impostazioni verrà chiesto di riavviare il motore del database. Per far questo selezionare “interrompi” e quindi “avvia” come mostrato in figura: Infine per controllare che il servizio “SQL Server Browser” sia abilitato all’avvio automatico selezionare la voce Servizio, posto sotto SQL Server Browser e impostare su Automatico l’opzione “Tipo di avvio”: Si ricorda che in caso venga utilizzato il sistema operativo Windows Vista, non essendo compatibile il motore di database MSDE, risulta necessaria l’installazione di un SQL Server compatibile con esso come per esempio SQL Server Express. Selezionare il pulsante Ok per terminare la configurazione della superficie di attacco così da concludere l’installazione di SQL Express 2005. 12 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER Ora è utile poter utilizzare un client per amministrare SQL Express. Per questo è possibile utilizzare Management Studio 2005 Express SP2 collocato nel menù Utility del menù Camtasia. Lanciare Management Studio 2005 Express SP2 per far partire l’installazione: Proseguire con l’installazione accettando i termini di contratto ed avanzare con il pulsante Avanti: Immettere il nome per personalizzare l’installazione e proseguire per arrivare alla selezione delle funzionalità da installare: INSTALLAZIONE • 13 PASSPARTOUT CONNECTION MANAGER Modificare eventualmente l’installazione delle funzionalità e proseguire con Avanti: e successivamente selezionare Installa per iniziare l’installazione: terminata l'installazione viene presentata la maschera di completamento, utilizzando il pulsante fine viene terminata la procedura guidata. 14 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER Per poter gestire un DataBase, aprire il percorso Tutti i programmi -> Microsoft SQL Server 2005 ->SQL Server Management Studio ed impostare le opzioni citate di seguito: Nel campo nome server viene indicato il nome del server SQL a cui ci si vuole connettere, l’Autenticazione permette di scegliere se utilizzare quella di SQL Server o quella di Windows, scelta resa possibile dall’impostazione effettuata durante il setup di SQL Server impostando la modalità di autenticazione a Mista, Nome account di accesso indica il nome account scelto o impostato durante l’installazione si Management studio, nel campo Password inserire la password che è stata definita in fase di installazione. Selezionare “Connetti” per aprire il Manager DB. Se in fase di installazione di SQL non è stata scelta l’opzione di Autenticazione mista è possibile configurarla ora, procedendo come segue. Effettuare click con il tasto destro del mouse sul nome del pc su cui risiede il database e selezionare Proprietà: Aprendo così la finestra delle proprietà relative a SQL Server. Selezionare la voce “Protezione” ed in seguito impostare l’opzione “Autenticazione di SQL Server e di Windows” come mostrato in figura: Infine selezionare Ok per confermare le impostazioni e chiudere la finestra. INSTALLAZIONE • 15 PASSPARTOUT CONNECTION MANAGER INSTALLAZIONE PASSEPARTOUT CONNECTION MANGER Al clic (con il pulsante sinistro del mouse) sulla scritta Passepartout Connection Manager parte l’installazione guidata di PCM: In ciascuna maschera dell’installazione guidata sono presenti tre pulsanti: • • • Annulla <Indietro Avanti > per annullare l’installazione; per tornare alla finestra precedente; per passare alla finestra successiva e procedere con l’installazione. La “X”, collocata nell’angolo superiore destro delle maschere, ha la stessa funzionalità di “Annulla”. PERCORSO DI INSTALLAZIONE La procedura di seguito descritta è valida sia per eseguire nuove installazioni, sia per effettuare aggiornamenti. Facendo click sul tasto Avanti si passa alla finestra di dialogo Passepartout Connection Manager in cui vengono richiesti il percorso di installazione del programma e la modalità di gestione degli utenti. Se il sistema operativo prevede la multiutenza, si consiglia di scegliere l’opzione “Tutti gli utenti”: Il percorso di installazione proposto come predefinito è “<CartellaProgrammi>\Passepartout\Passepartout Connection Manager”, dove <Cartella programmi>, in un’installazione su disco fisso “C”, assume il valore “C:\Programmi” in italiano o “C:\Program Files” in inglese. 16 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER Nel caso in cui si voglia scegliere un percorso differente, fare click sul pulsante “Sfoglia...”, si apre così la finestra “sfoglia per cartelle” contenente l’elenco delle cartelle in cui è possibile installare il programma: Sempre nella finestra Passepartout Connection Manger, selezionando il pulsante “Spazio richiesto su disco...” compare una finestra contenente l’elenco delle unità in cui è possibile installare il programma, con le relative indicazioni di spazio libero e spazio richiesto: Dopo aver confermato la finestra relativa allo spazio su disco, si ritorna alla finestra di installazione e al click del mouse su “Avanti” si passa alla finestra di conferma per l’installazione: INSTALLAZIONE • 17 PASSPARTOUT CONNECTION MANAGER Ora cliccando su “Avanti”, inizia l’installazione del programma “Passepartout Connection Manager”: Durante la procedura guidata, appare un messaggio contenente l’avviso di chiudere tutte le applicazioni eventualmente aperte prima di proseguire con l’installazione: Alla conferma su OK si passa alla finestra di avvenuta installazione: Facendo click sul pulsante “Chiudi”, si completa il processo di installazione. Se l’installazione ha avuto successo, viene avviato il gestore Passepartout Connection Manager. Al primo avvio, PCM richiede di configurare il database lanciando il seguente avviso. 18 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER E proponendo la relativa finestra di configurazione. Creare, nel caso non esista già, un nuovo database tramite l’apposito tasto e confermare con “Ok” INSTALLAZIONE • 19 PASSPARTOUT CONNECTION MANAGER 20 • INSTALLAZIONE PASSPARTOUT CONNECTION MANAGER CONFIGURAZIONE GESTORE PASSEPARTOUT CONNECTION MANAGER Terminata l’installazione, tra i diversi servizi di sistema del computer compare quello relativo a PCM. Il servizio si attiva in automatico all’avvio della macchina. La presenza dell’icona nella tray bar indica che il “Gestore” PCM è attivo. Per interagire con esso si può fare click con il pulsante destro o doppio click con il pulsante sinistro del mouse sopra l’icona e scegliere una voce, tra quelle abilitate, nel menù che compare: Per avviare il gestore del servizio e far comparire l’icona nella tray bar, quando non presente, occorre effettuare doppio click sull’icona di PCM presente sul desktop. CONFIGURAZIONE • 21 PASSPARTOUT CONNECTION MANAGER Dalla voce del menù “Apri gestore”, o con doppio click sull’icona nella tray bar, o con doppio click su quella nel desktop si apre la finestra Gestore servizio PCM: Avvia server: è attivo solo se il servizio non è ancora stato avviato;. Arresta server: è attivo solo se il servizio è già stato avviato. Cliccando sulla “X” rossa collocata nell’angolo superiore destro, viene chiusa la finestra del gestore ma non viene arrestata l’esecuzione del sevizio. Apri log: apre il file di log del server. Se il file di log è vuoto o il database no è configurato correttamente, compare un messaggio di errore. Plugin: apre la finestra relativa alla configurazione dei singoli componenti (plugin) Configura: apre la finestra di configurazione del servizio e del gestore PCM. 22 • CONFIGURAZIONE PASSPARTOUT CONNECTION MANAGER CONNESSIONE E PRIMO AVVIO Prima di poter avviare il servizio è necessario effettuare le seguenti operazione: Test Connessione: Test di connessione al gestionale (Welcome o Retail\Menu\Beauty) Registrazione: Registrazione dell’istanza PCM sul gestionale Abilitazione Plugin: Selezione dei plugin da avviare Dal Gestore PCM, tramite il tasto “Configura” si entra nella finestra di configurazione. CONNESSIONE La scheda “Configurazione” permette di impostare tutti i parametri di connessione. E’ possibile connettere PCM ad un gestionale di tipo Passepartout Welcome o Menu\Retail\Beauty. Impostare indirizzo del server del gestionale, la porta e premere il tasto “Test connessione”. Se i parametri sono impostati correttamente compare la seguente finestra di conferma. NOTA BENE: La porta di connessione è quella utilizzata dai palmari per accedere al gestionale. CONFIGURAZIONE • 23 PASSPARTOUT CONNECTION MANAGER REGISTRAZIONE L’operazione di registrazione rende le varie istanze PCM contattabili dal gestionale. Prima di eseguire la registrazione occorre avviare il gestionale. Una volta impostati parametri di connessione è possibile registrare PCM tramite il tasto “Registra”. Se le impostazioni sono corrette, compare una finestra di conferma. Per concludere l’operazione di registrazione è necessario riavviare il gestionale. Dal Menu Configurazione/Impostazioni alla scheda collegamento Hospitality di Passepartout Welcome è possibile verificare la corretta registrazione dei PCM e attivare le diverse classi di Plug-In (Centralini, Domotica, Pay TV, Musa ) in base alle proprie esigenze. 24 • CONFIGURAZIONE PASSPARTOUT CONNECTION MANAGER ABILITAZIONE PLUGIN Una volta completata l’operazione di registrazione è opportuno abilitare i plugin a cui si intende interfacciarsi Dal Gestore PCM tramite il tasto “Plugin” si apre la finestra di elenco dei plugin supportati. Le colonne della griglia danno una breve descrizione dei plugin, oltre che fornire informazioni sullo stato attuale e ti tipo di avvio.server Lo stato di un plugin può essere: Arrestato: il plugin non è in esecuzione o il servizio PCM non è attivo Avviato: il plugin è in esecuzione Il tipo di avvio definisce il comportamento di un plugin all’avvio del servizio PCM. Se il Tipo Avvio è impostato su “Automatico”, il plugin viene eseguito ad ogni avvio del servizio PCM. Se invece il Tipo Avvio è “Disabilitato”, il plugin non viene eseguito. Per impostare il Tipo Avvio, cliccare con tasto destro sul plugi. Tramite il menu contestuale selezionare la voce “Proprietà”. Si apre la seguente finestra. CONFIGURAZIONE • 25 PASSPARTOUT CONNECTION MANAGER Tramite il menu Combo “Tipo avvio” è possibile abilitare (Avvio Automatico) o disabilitare (Disabilitato) il plugin Il menù contestuale “Configura”, apre la configurazione del singolo plugin. Vedere il capitolo “Configurazione Plugin” per maggiori dettagli. Lo stato di avvio è indicato dal colore dei semafori. In caso di errore in avvio (automatico o manuale) il semaforo diventa rosso altrimenti verde. Se il servizioPCM è avviato, è possibile avviare o arrestare il singolo plugin tramite i tasti “Avvia” e “Arresta” del menu contestuale o tramite i tasti “Play”, “Stop” come in figura NOTA BENE: Impostare il Tipo Avvio su “Automatico” solo sui plugin di cui si dispone del componente hardware e opportunamente configurato AVVIO Se le operazioni precedenti sono andate a buon fine è possibile avviare il servizio PCM. Avviare il servizio dal gestore tramite il tasto “Avvia Servizio”. A questo punto si attiva una comunicazione bidirezionale tra gestionale e plugin tramite il servizio PCM. 26 • CONFIGURAZIONE PASSPARTOUT CONNECTION MANAGER LOG LOG STANDARD Per visualizzare gli errori e le informazioni relative al ciclo di vita dei plugin e del servizio PCM, consultare il log tramite il relativo tasto dal Gestore PCM. Sulla colonna di sinistra è possibile filtrare il log relativo ad un singolo plugin mentre selezionando la radice si visualizza tutto il contenuto del log fino ad un massimo di 1000 righe. Fare doppio clic sulla riga interessata per espandere le informazioni in finestra. DETTAGLIO OPERAZIONI PCM mette a disposizione una console che in tempo reale mostra lo scambio di informazioni tra plugin e gestionale. In particolare la console mostra: • Chiamate dei plugin al gestionale (IN) • Chiamate del gestionale al plugin (OUT) • Errori CONFIGURAZIONE • 27 PASSPARTOUT CONNECTION MANAGER I “led” sulle schede del singolo plugin indicano lo stato: • Verde: plugin in stato di attesa • Giallo: plugin in elaborazione di un comando • Rosso: il plugin ha generato un errore. Se la finestra viene chiusa, è sempre possibile riattivarla dalla icona nella tray-bar di Windows ATTENZIONE Per visualizzare la console occorre attivare l’opzione “Consenti al servizio di interagire con il Desktop” dal menu Proprietà della Finestra servizi di Windows. • IMPORTANTE: Su Windows Vista/Seven non è visualizzabile la tray-icon della console a causa dell’Interactive Service Detection che ne impedisce la visualizzazione. 28 • CONFIGURAZIONE PASSPARTOUT CONNECTION MANAGER ELENCO PLUG-IN ALTECON Per configurare Altecon Plug-In è necessario selezionare il percorso del file di scambio dati (SETROOM.TXT) attraverso il quale sarà possibile comunicare al PCM tutte le operazioni di Check-In/Check-Out avvenute in Passepartout Welcome. CISA Per configurare Cisa Plug-In è necessario selezionare la porta seriale alla quale è collegato il dispositivo, l’orario di arrivo e partenza per assegnare il periodo di validità alla card, il numero di terminale e le zone comuni da attivare. Le informazioni riguardanti gli ultimi due campi si possono trovare nell’apposita documentazione del dispositivo. ELENCO PLUG-IN • 29 PASSPARTOUT CONNECTION MANAGER GLT Per configurare Glt Plug-In è necessario selezionare il percorso del file di scambio dati (FILE.INP) attraverso il quale sarà possibile comunicare al PCM tutte le operazioni di Check-In/Check-Out avvenute in Passepartout Welcome, l’ora di arrivo/partenza del cliente e il numero di terminale. Quest’ultima informazione si può trovare nell’apposita documentazione del dispositivo. MEGANET Per permettere a Meganet di effettuare tutte le attività legate al check-In Check-Out è necessario impostare: il Server TCP/IP e la Porta TCP/IP di collegamento a Meganet, l’ora di arrivo/partenza del cliente, il Timeout di connessione, le zone comuni alle quali si desidera consentire l’accesso, il numero di badge e il numero di terminale su cui effettuare la codifica della chip-card. Quest’ultime informazioni si possono trovare nell’apposita documentazione del dispositivo. MICRODEVICE Per configurare Microdevice Plug-In selezionare il percorso del file di scambio in cui vengono registrati tutti i comandi di Check-In Check-Out da comunicare al sistema e le zone comuni da attivare. Quest’ultima informazione si può trovare nell’apposita documentazione del dispositivo. 30 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER IRNET PAY-TV Per configurare Irnet Plug-In è necessario impostare il tempo di aggiornamento degli addebiti, il percorso della directory dello scambio dei file di comunicazione tra Passepartout Welcome e il sistema, la voce sulla quale andare ad addebitare su Passepartout Welcome le operazioni, la tariffa per ogni scatto e infine il messaggio (opzionale) che verrà visualizzato all’accesso del servizio Pay-Tv. SIEMENS Per configurare Siemens Plug-In oltre a impostare il numero terminale e le zone comuni da attivare è necessario selezionare la directory dei file di scambio tra Passepartout Welcome e il dispositivo. Le informazioni riguardanti gli ultimi due campi si possono trovare nell’apposita documentazione del dispositivo. ELENCO PLUG-IN • 31 PASSPARTOUT CONNECTION MANAGER ONITY Per configurare Onity Plug-In è necessario impostare Server Tcp e Porta Tcp sul quale è connesso il dispositivo, gli orari di arrivo e partenza del cliente per assegnare il periodo di validità alla card, il timeout di connessione, le zone comuni da attivare sulle card e infine il numero di terminale. Le ultime informazioni si possono trovare nell’apposita documentazione del dispositivo. INDELB Modello lettore, Sector Number, Porta Seriale (alla quale è collegato il dispositivo) sono tutti campi indispensabili per la configurazione di IndelB Plug-In. L’orario di arrivo e partenza del cliente invece stabilisce la validità della card mentre il Repeat Time indica il numero di beep che il sistema restituisce durante la lettura della card. Premendo il tasto destro sul Plug-In è possibile selezionare la funzionalità “Esegui” che permette di aprire una finestra con cui interrogare il contenuto della tessera oppure scriverne dei nuovi valori. Tramite i pulsanti “Leggi” è possibile leggere il contenuto della tessera posto sopra il controllo; “Scrivi” permette di scrivere sopra la tessera e “Chiudi” di chiudere la finestra. 32 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER ATTENZIONE: Con dispositivi MUR-100 ad interfacciamento tramite USB, su diversi pc è necessario installare l’opportuno driver prima dell’utilizzo, affinché sia possibile utilizzare e gestire le tessere. STS Il Plug-In STS riceve i dati relativi alle operazioni di Check-In e Check-Out da Passepartout Welcome attraverso la generazione di file in una directory predefinita comune, per questo motivo è necessario impostare nella finestra delle configurazioni del Plug-In il percorso di scambio. L’ora di arrivo e partenza fanno riferimento rispettivamente all’ora di Check-In e Check-Out. La creazione dei file txt nella cartella di scambio avviene solamente per le prenotazioni inserite dopo l'attivazione del Plug-In. Inserendo, infatti, una nuova prenotazione ed effettuando il check-in viene creato in automatico il file chk-in.txt, mentre in fase di check-out (o annullamento del check-in) il file chk-out.txt. NOTE BENE: Non occorre utilizzare il pulsante “Crea Scheda”. CENTRALINI Il Plug-In Centralini può essere utilizzato per: • addebiti telefonate da centralini analogici e digitali; • segnalazione stato delle camere (sporche/pulite) digitando un numero dal telefono di ogni camera; Il formato dell’archivio di input è parametrico: può essere un file in formato testo, testi delimitato, db Access e db SQL Server. SISTEMI INTERFACCIABILI ELENCO PLUG-IN • 33 PASSPARTOUT CONNECTION MANAGER Il PlugIn gestisce diversi metodi di acquisizione dati: SISTEMA MODALITA’ OPERATIVA Centralini telefonici Porta seriale Centralini VOIP (su DB) Access, SQL Server, ODBC CENTRALINI TELEFONICI Possono essere di 2 tipi: • SERIALI: tramite la porta seriale le chiamate scaricano dei dati dal centralino e riempiono un file; • VOIP (Voice Over IP): hanno un loro database dove vengono registrate le chiamate. CENTRALINI SERIALI Prima di ogni nuova configurazione, è necessario conoscere le specifiche tecniche del centralino, le quali si possono ottenere solamente dal tecnico che fornisce il prodotto. I dati necessari sono i seguenti: • BIT PER SECONDO; • BIT DI DATI; • BIT DI STOP; • PARITA’. Una volta ottenute le specifiche tecniche occorre avviare HyperTerminal ed effettuare una chiamata in uscita dal centralino per verificare il suo corretto funzionamento e ottenere una stringa di dati. Connessione Seriale: Attivare il flag in “Attiva porta seriale”. Inserire le specifiche tecniche del centralino (PORTA SERIALE, BIT PER SECONDO, BIT DI DATI, BIT DI STOP, PARITA’). FILE ADDEBITI: il percorso predefinito è la cartella Passepartout Connection Manager dove verrà automaticamente creato il file chiamate_seriale.txt, nel quale saranno registrate le chiamate una dopo l’altra. Il collegamento seriale parte all’avvio quindi è necessario salvare, chiudere e riavviare PCM. “Lunghezza stringa ricevuta dal centralino”: lasciare il valore 0, si utilizza se si vuole tagliare il resto della chiamata e passare a quella successiva (solo per alcuni modelli di centralino). TIMEOUT (s) = ogni quanto tempo verrà controllata la connessione al centralino per la verifica di nuove chiamate. Cliccando sul pulsante Camere si apre la maschera Camere, da questa, cliccando sul pulsante Importa camere, in automatico verranno importate tutte le camere configurate in Passepartout Welcome. In caso i numeri degli interni fossero diversi dai numeri delle camere, occorre inserire il numero reale di ogni interno nella colonna Interno. E’ inoltre possibile aggiungere nuovi interni e associarvi un nome (ad es. Reception, Bar, Cucina, ecc…). 34 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER Cliccando sul pulsante Tariffe si apre la maschera Tariffe, da questa, cliccando sul pulsante Importa tariffe, in automatico verranno importate tutte le tariffe predefinite . Viene fornito un elenco che riporta nazioni, prefissi e tariffe al minuto. I dati sono modificabili in base alle proprie esigenze (Connessione = secondi di scarto che vengono considerati per il calcolo dell'addebito). Connessione Dati Attive: Cliccando sul pulsante Nuovo della maschera Configurazione si apre la maschera Database dove è necessario impostare i campi della connessione dati: NOME = assegnare un nome alla connessione; ELENCO PLUG-IN • 35 PASSPARTOUT CONNECTION MANAGER TIPO = scegliere File come tipo di connessione; FILE = scegliere il file chiamate_seriale.txt; VOCE DI ADDEBITO = scegliere la voce di addebito di Passepartout Welcome in cui verranno addebitati gli importi del centralino, ad es. Telefono; Attivare il flag “Connessione Attiva”. Attivare il flag “Elimina dopo la lettura” SOLO quando sono stati effettuati tutti i test sulle chiamate del centralino in uscita e in entrata: Aspettare il tempo del timeout, ad es. 30 secondi, per verificare se ci sono chiamate, in questo caso nel file chiamate_seriale.txt e nella parte di log della maschera Addebiti PCM (all’interno di Passepartout Welcome) verranno registrate le stringhe di dati relative alle chiamate. Se non fossero presenti fare i seguenti test: • 1 chiamata in uscita dal centralino; • 1 chiamata da una camera con conto aperto; • impostare una sveglia. Le stringhe presenti nel file chiamate_seriale.txt sono indispensabili per configurare la struttura dei dati. CONFIGURAZIONE STRUTTURA DATI Aprire il file chiamate_seriale.txt, selezionare e copiare una stringa. Cliccando sul pulsante Modifica si apre la maschera Database, andare nella scheda Struttura Dati per definire la tipologia di dati presenti nella stringa. cliccare il pulsante Wizard per aprire la maschera in cui copiare la stringa di dati ricevuta dal centralino e configurarla. 36 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER E’ sufficiente selezionare un dato della stringa, cliccare con tasto dx del mouse e specificarne il tipo tra quelli presenti in elenco. Una volta terminata e salvata questa configurazione, nella griglia di struttura dati verranno visualizzati i dati impostati tramite Wizard. Un centralino telefonico seriale ha una struttura dati simile alla seguente: Il pulsante “Salva Configurazione” permette di salvare in un file xml tutti i dati impostati nella scheda STRUTTURA DATI e CONDIZIONI, operazione consigliabile una volta terminata la configurazione. Il pulsante “Carica Configurazione”, invece, permette di caricare configurazioni salvate precedentemente (ad es. in caso di reinstallazione di PCM). GESTIONE TARRIFFAZIONE Caso A: IL CENTRALINO INVIA L’IMPORTO NELLA STRINGA: in Struttura Dati impostare l’inizio e la fine del campo Importo. Caso B: IL CENTRALINO NON INVIA L’IMPORTO NELLA STRINGA: in Struttura Dati impostare a 0 l’inizio e la fine del campo Importo. ELENCO PLUG-IN • 37 PASSPARTOUT CONNECTION MANAGER In CONFIGURAZIONE attivare la Tariffazione a Secondi, in questo modo verranno utilizzate le tariffe presenti nella tabella Tariffe: Caso C: IL CENTRALINO INVIA SOLO GLI SCATTI NELLA STRINGA: in Struttura Dati definire l’inizio e la fine del campo Scatti ed impostare a 0 l’inizio e la fine del campo Importo: In CONFIGURAZIONE attivare la Tariffazione a Scatti con il relativo costo in centesimi: ALCUNI CHIARIMENTI SULLA STRUTTURA DEI DATI • L’Ordine Griglia è l’ordine di visualizzazione dei campi nella maschera Addebiti PCM presente in Passepartout Welcome; • L’inizio e la fine del campo Camera sono sempre uguali all’inizio e alla fine del campo Interno; • L’inizio e la fine del campo Numero hanno in genere una lunghezza di 10 caratteri; • Il formato dei campi Data, Ora e Durata deve sempre essere un formato Windows; • Se manca la data all’interno della stringa occorre impostare a 0 l’inizio e la fine del campo Data; in questo modo verrà presa automaticamente la data di sistema; • Se manca l’ora all’interno della stringa occorre impostare a 0 l’inizio e la fine del campo Ora; in questo modo verrà presa automaticamente l’ora di sistema. CONDIZIONI (SOLO PER ALCUNI CENTRALINI) Le condizioni sono necessarie affinché i dati provenienti dal centralino vengano processati correttamente. Occorre definirle solo in caso sia necessario conteggiare determinate stringhe che invia il centralino, ad es. quando vengono inviate le stringhe relative alle sveglie o alle chiamate in entrata, ma si vogliono conteggiare esclusivamente le chiamate in uscita. Le condizioni vengono impostate sui campi, quindi se quest’ultimi non sono presenti in Struttura Dati è necessario creare prima dei campi “condizione”. Andare in STRUTTURA DATI e definire: • Campo = Condizione1; 38 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER • Tipo Dati = Stringa; • Inizio e Fine = inizio e fine del dato necessario per impostare la condizione; • Ordine Griglia = 0 (non è necessario). Andare in CONDIZIONI e scegliere: • Campo = campo specifico o campo “condizione” (creato precedentemente nella scheda Struttura Dati); • Tipo Confronto: • - = uguale (conteggia stringhe che hanno quel valore); - > maggiore; - < minore; - <> diverso (conteggia stringhe che non hanno quel valore). Valore = dato presente nella stringa che serve a identificarla dalle altre. NOTA BENE: ogni stringa può presentare valori diversi a seconda del modello del centralino. In CONFIGURAZIONE è possibile attivare diversi parametri, ad es.: Parametri Vari “Utilizza la tabella di conversione numero / camere” (da attivare se è stata personalizzata la tabella Camere perché i numeri degli interni sono diversi dai numeri delle camere); “Salva solo gli addebiti con importo maggiore di 0”. Parametri Addebito “Addebita direttamente in Passepartout Welcome” (da attivare una volta terminata la configurazione, in modo che le chiamate vengano addebitate automaticamente sui conti aperti): ELENCO PLUG-IN • 39 PASSPARTOUT CONNECTION MANAGER Infine, dopo la configurazione e i test sulle chiamate, attivare in Connessione Dati il flag “Elimina dopo la lettura”, in questo modo PCM processerà una sola volta i dati presenti nel file chiamate_seriale.txt: CENTRALINI VOIP Voip è una tecnologia che rende possibile effettuare una conversazione telefonica sfruttando una connessione Internet o un'altra rete dedicata che utilizza il protocollo IP. Questi centralini possiedono un database con un contatore interno di chiamate. Il tecnico del centralino deve fornire il codice dell’ultima chiamata per poter configurare il Plug-In. Connessione Dati Attive: Cliccando sul pulsante Nuovo della maschera Configurazione si apre la maschera Database dove è necessario impostare i campi della connessione dati: NOME = assegnare un nome alla connessione; TIPO = scegliere Sql Server, Access oppure Odbc come tipo di connessione; SERVER = nome server del centralino; USERNAME = nome utente del server del centralino; PASSWORD = password del server del centralino; NOME DB = nome del database del centralino; VOCE DI ADDEBITO = scegliere la voce di addebito di Passepartout Welcome in cui verranno addebitati gli importi del centralino, ad es. Telefono; NOME TABELLA = nome tabella delle chiamate; NOME CAMPO CONTATORE = nome del campo contatore; ULTIMO VALORE LETTO = codice dell’ultima chiamata effettuata; Attivare il flag “Connessione Attiva”. Un centralino telefonico voip ha una struttura dati simile alla seguente: 40 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER GESTIONE STATO CAMERE (CENTRALINI SERIALI E VOIP) Andare in AZIONI e definire. • Campo = Numero; • Valore = inserire il numero che si dovrà digitare per compiere l’azione; • Tipo Azione = CameraPulita oppure CameraSporca: Digitando un numero dal telefono di ogni camera è possibile modificare lo stato delle camere (sporche/pulite) sul Quadro Giornaliero di Passepartout Welcome: SKY (PAY PER VIEW) • Sky è un web service ovvero un sistema che permette di accedere ai dati tramite Internet; • La struttura compra un pacchetto di film da Sky e decide a quanto venderli a seconda della categoria (Film, Sport, Altri Eventi); ELENCO PLUG-IN • 41 PASSPARTOUT CONNECTION MANAGER • Ogni decoder ha 1 codice ed ad ogni codice viene associato 1 numero di camera; • I clienti acquistano gli eventi che desiderano vedere; • Il Plug-In per leggere gli addebiti si collega al server di Sky dove vengono registrati gli eventi acquistati dalle camere. ATTIVAZIONE INTERFACCIAMENTO CON SKY • La struttura deve fare una richiesta a Sky comunicando l‘IP fisso della propria ADSL (Sky non può attivare il servizio se la struttura non possiede un IP fisso di collegamento ad Internet); • Sky fornirà i dati di accesso al proprio server, user e password per il collegamento in modalità test; • Tali dati sono necessari per eseguire il collaudo del sistema in modalità test (da concordare il giorno con i tecnici Sky); • Configurare il Plug-In ed eseguire i test per l’interfacciamento con Sky (ad es. acquistando un evento da una camera); • Completati i test in modalità piena occorrerà inviare un’email di conferma a Sky che attiverà in maniera definitiva il servizio; • Dal sito di Sky sarà possibile definire le tariffe dei singoli eventi.. Per la configurazione è quindi necessario impostare: il server di Sky (Ws.sky.it), il Codice Hotel (numero di contratto Sky o codice account) e Chiave Hotel (password) legati all’abbonamento Sky, la frequenza di aggiornamento e la voce di addebito di Passepartout Welcome in cui verranno addebitati gli importi di Sky. VDA MICROMASTER Il Plug-In permette l’interfacciamento delle applicazioni Passepartout con il prodotto building automation Micromaster prodotto dalla VDA, software di supervisione che mette le unità di gestione (quali riscaldamento, clima, rivelazione dei fiumi , controllo degli accessi, ect..) in grado di dialogare con un unico PC centrale che si integra senza problemi con i sistemi di videomonitoraggio, antincendio, moneta elettronica e PMS. Per configurare VDA Plug-In è necessario impostare “Numero postazione” che viene fissato di default e il “Numero di chiavi da generare”; “Percorso scambio file” identifica la cartella nella quale i file TXT generati verranno memorizzati per poi interfacciarsi tramite file con l’hardware interessato. 42 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER ATTENZIONE: affinché sia possibile per il PCM generare e salvare i file testuale nella cartella selezionato è necessario verificare che la cartella (eventualmente prevista su una macchina diversa da quella dove è installato il PCM) sia raggiungibile dalla rete, si abbiano i permessi di scrittura e lettura su di essa e l’utente abbia i permessi relativamente al Servizio PCM in uso. Facendo un Check-In o un Check-Out i file TXT generati dal PCM e poi memorizzati nella suddetta cartella sono due: SETROOM.TXT e KEYGEN.TXT. Ad esempio durante un CHECK-IN il formato del file SETROOM.TXT prevederà la seguente struttura: 1) $CHECKIN 2) Numero della camera 3) Cognome del cliente 4) Nome del cliente 5) Lingua 6) Cortesia prevista per l’anagrafica cliente 7) Pay TV Mode 8) VDA (stringa costante) 9) 1 (stringa costante) Mentre il formato del file KEYGEN.TXT prevederà la seguente struttura: 1) $KEYGEN 2) Numero postazione 3) Numero della camera 4) Numero di chiavi da generare 5) 10 caratteri vuoti 6) Riferimento all’area pubblica 7) GuessName – ragione sociale del cliente dell’appuntamento (cognome + nome) 8) Data di arrivo 9) Data di partenza 10) “D” se è duplicato, “N” altrimenti ELENCO PLUG-IN • 43 PASSPARTOUT CONNECTION MANAGER EELECTRON Il Plug-In permette l’interfacciamento dei programmi Passepartout con i dispositivi prodotti da Eelectron, azienda italiana che produce dispositivi elettronici hardware per l’automazione alberghiera. Per configurare Eelectron Plug-In è necessario impostare, oltre alle classiche informazioni ora di arrivo e partenza, la “Zona cumeni” e “Indirizzo TCP” del server a cui occorre collegarsi e del suo “Numero di porta”. L’operazione di CHECK-IN e di CHECK-OUT prevedono la generazione di una stringa sulla base dell’appuntamento interessato al Server specificato dal suddetto indirizzo. Per il CHECK-IN la stringa generata viene così valorizzata: 1) Carattere STX (char di 2) 2) CI (costante relativo al CHECK-IN) 3) IC + ID dell’appuntamento selezionato 4) ST + numero del terminale 5) CC + cognome del cliente dell’appuntamento 6) NC + nome del cliente dell’appuntamento 7) TC + cortesia associata al cliente dell’appuntamento 8) DA + data inizio dell’appuntamento nel formato “ddMMyy” 9) TA + ora di inizio dell’appuntamento nel formato “hhmm” 10) DP + data fine dell’appuntamento nel formato “ddMMyy” 11) TP + ora di partenza dell’appuntamento nel formato “hhmm” 12) SP + numero del terminale 13) Carattere ETX (char di 3) A seguito del CHECK-IN il Server restituisce sempre un messaggio di notifica, un feedback che permette di verificare se l’operazione in oggetto è stata eseguita con successo o meno. Qualora la stringa restituita dal Server presenta la chiave “ECACK” vorrà dire che l’operazione è terminata con successo, in caso contrario, chiave “EANACK”, il PCM segnalerà il fallimento dell’operazione. Per il CHECK-OUT la stringa generata viene così valorizzata: 1) Carattere STX (char di 2) 2) CO (costante relativo al CHECK-OUT) 3) IC + ID dell’appuntamento selezionato 4) Carattere ETX (char di 3) 44 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER Analogamente a quanto sopra spiegato, anche per il CHECK-OUT vi è un feedback del Server che segnalazione l’eventuale fallimento dell’operazione oppure il suo successo, secondo la stessa logica sopra spiegata, ovvero con le chiavi “ECACK” e “ECNACK”. GFP LAB GIANO Il Plug-In permette l’interfacciamento dei programmi Passepartout con una qualunque installazione del sistema Giano, lavorando attraverso il protocollo XML-RPC.. Per configurare GFP Lab Giano Plug-In è necessario impostare il numero terminale e l’indirizzo del Server in cui il sistema è in esecuzione, specificandone anche la porta di comunicazione. Premendo il stato “Esegui” è possibile aprire una finestra in cui configurare dei parametri per verificare la connettività, l’invio e ricezione di informazioni dal sistema Giano. Le operazioni gestite con il Plug-In sono il CHECK-IN e il CHECK-OUT, attraverso l’interfaccia proposta da XML-PRC. Viene impostato di default per l’attribut “FLAGS” relativo alla fase di Check-In il valore 3, ovvero selezionando i flag ENABLE_CLIMA e ENABLE_COMMON_AREAS. Le opzioni comunque abilitabili attraverso il flag sono le seguenti: FLAG VALORE DESCRIZIONE ENABLE_CLIMA 1 Abilita il climatizzatore nella stanza ENABLE_COMMON_AREAS 2 Abilita la carta a passare per le aree comuni ENABLE_TIME_LIMITS 4 Disabilita la gestione del tempo limite per rimettere il device ELENCO PLUG-IN • 45 PASSPARTOUT CONNECTION MANAGER ENABLE_MONEY 8 Abilita denaro PRE_CHECKIN 16 Abilita la carta per il pre-checkin La carta di default non è attiva. ALL_FLAGS 31 Abilita tutte le suddette opzioni TECNOVOX Il Plug-In permette da parte dei sistemi Passepartout di poter interfacciarsi per l’apertura porte con sistemi Tecnovox, inviando attraverso trasmissione TCP/IP di messaggi di check-in, check-out e check sullo stato del link. Il servizio remoto deve essere configurato in maniera tale che punti all’indirizzo IP dove è installato e viene eseguito il PCM, sulla porta configurata nella scheda “Configurazione”. E’ opportuno verificare che sulla macchina di PCM la porta risulta aperta e funzionante. CONFIGURAZIONE Selezionando il plug-in Tecnovox dall’elenco si apre la finestra di configurazione nella quale deve essere specificato l’indirizzo IP e la porta a cui inviare il messaggio via TCP/IP ai dispositivi. I parametri configurabili sono: • Porta – porta con la quale il PCM rimane in ascolto e comunica con il servizio remoto. • Timeout connessione – permette di definire il tempo di attesa massimo oltre il quale, in fase di attesa di messaggi esterni, il sistema si sblocca per valutare poi quale operazione fare (chiusura socket e successiva riapertura, etc..). ATTENZIONE: Tecnovox circa ogni minuto invia un messaggio di “Link Alive” notificando lo stato attivo del link in uso; risulta pertanto consigliato mantenere un valore di timeout dei messaggi ricevuti dal listener almeno pari ad un minuto. Terminando questo timeout infatti avverrà un errore che provocherà la chiusura del socket in uso da PCM per la comunicazione attendendone uno nuovo da utilizzare. • Numero terminale – numero del terminale di riferimento. • Attesa invio Link Alive (ms) – definisce il tempo di attesa che il PCM prevederà durante il suo funzionamento ogni volta che invierà un messaggio di “Link Alive”, che segnala lo stato attivo e funzionante del link di comunicazione. 46 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER • • Livello di log – definisce il livello di log con cui registrare le informazioni sulla elaborazione del PCM e del file di log di Tecnovox creato (file LogSocketTecnovox.txt). I livelli previsti sono: o Errori – livello di log minimo, che registra solo le informazioni relative ad errori e anomalie riscontrate durante il funzionamento del plug-in. o Debug – livello dettagliato. Invia “Check-Out” dopo 4 “Leggi tessera” – abilita l’invio di un check-out se durante l’invio di una richiesta di “leggi tessera” il sistema remoto restituisce un fallimento nella lettura (risposta KA con tag ASUR): in questo caso, dopo 4 tentativi di invio da parte di PCM, viene eseguito in automatico un “check-out” al sistema remoto e poi si riprendere con la richiesta di “lettura tessera”. Durante l’esecuzione del PCM, verrà generato per il plug-in corrente un file di log “LogSocketTecnovox.txt” all’interno della cartella di installazione di PCM: inizialmente contiene solo ed esclusivamente messaggi di errore, ma in presenza della spunta sulla opzione “Registra sul log notifiche informative”, all’interno di esso verranno tracciate anche tutte le notizie sulle operazioni fatte dal PCM, dando in dettaglio anche le stringhe dei messaggi inviati e letti. LEGGI TESSERA Affinché sia possibile eseguire una lettura della tessera, è necessario fare una “Leggi tessera” iniziale con la quale il PCM invia una richiesta (key-request KR) al sistema remoto Tecnovox; solo in un secondo momento il sistema Tecnovox restituirà la tessera interessata. Pertanto facendo una seconda richiesta “Leggi tessera” il PCM restituirà la tessera richiesta; in caso contrario notificherà l’assenza della tessera richiesta. ATTENZIONE PCM per procedere alla lettura della tessera crea ed invia al sistema Tecnovox una richiesta KR (key-request). Se il sistema non fosse inizialmente in grado di soddisfare la richiesta, restituisce una risposta (KA – key-answer) con tag ASUR: in questo caso PCM procede a inviare di nuovo lo stesso messaggio KR, finché la tessera non viene letta e ricevuta da PCM (KA con tag ASOK). Inviando più volte un KR sulla stessa camera Tecnovox procede a gestire un check che limita il numero di tessere per camera (dato che un KR viene visto come una richiesta di tessera per singola camera): pertanto con 4 invii da PCM si raggiungerebbe il numero massimo stimato da Tecnovox, il quale bloccherà del tutto la lettura della tessera. In questo caso è necessario fare un “Check-Out” per liberare la camera, cancellando tutte le tessere richieste, e poi inviare di nuovo un KR; selezionando pertanto la spunta suddetta “Invia “Check-Out” dopo 4 “Leggi tessera”” si permetterà di automatizzare questo invio direttamente durante il funzionamento di PCM, in caso contrario dovrà essere l’utente a fare un “Check-Out” e poi un “Leggi tessera”, per sbloccare la lettura della tessera. ESEGUI Premendo il pulsante “Esegui” è possibile aprire la scheda dove verificare il funzionamento del plug, avendo a disposizione una serie di operazioni tra quelle utilizzate dal PCM durante la comunicazione con la Socket. Nella finestra vengono presentati i dati classici di un appuntamento generico, che verrà generato ed utilizzato nelle varie chiamate di test. Aprendo la scheda “Check” vengono presentate le operazioni di test da poter utilizzare. ELENCO PLUG-IN • 47 PASSPARTOUT CONNECTION MANAGER Le operazioni disponibili sono: • Connetti – avvia il listener affinché il PCM possa connettersi e comunicare con il Socket remoto per inviare e ricevere messaggi. • Disconnetti – disconnette e chiude il listener al momento istanziato per l’ascolto, se previsto. • Link Start – metodo per avviare la configurazione del link di invio e ricezione dei messaggi. Di regola questo messaggio prevederà per chi lo ricevere l’invio di informazioni relativamente alla struttura dei messaggi da inviare (Link Record), un messaggio sulle informazioni del link e sistema comunicante (Link Description) ed infine una notifica sullo stato attivo del link utilizzato (Link Alive). • Link Alive – metodo per inviare un messaggio di notifica sullo stato attivo del link utilizzato per la comunicazione. • Link End – metodo per richiedere la chiusura del link di comunicazione attuale, ripristinando pertanto il listener in attesa di poter procedere ad una successiva riconfigurazione del successivo link da utilizzare, attraverso un “Link Start”. • Check-In – prevede l’invio di un messaggio per il check-in di un appuntamento. • Check-Out – prevede l’invio di un messaggio per il check-in di un appuntamento. • Key request – prevede l’invio di un messaggio per la lettura della tessera. Affinché i test possano essere eseguiti correttamente, è necessario premere prima “Connetti” affinché venga istanziato un listener che rimarrà in ascolto del Socket remoto e poi procedere alla selezione ed esecuzione della istruzione richiesta. ESECUZIONE Il PCM all’avvio del plug-in rimane in ascolto per catturare il Socket remoto con il quale scambiare i messaggi. Trovato il Socket del Sistema remoto, il quale punterà all’indirizzo IP della macchina dove il PCM è in esecuzione e come porta di comunicazione quella impostata nella scheda “Configurazione”, si procede ad inizializzare il link di trasmissione ricevendo dal servizio esterno dei “Link Record” (riportanti la sequenza dei tag dei messaggi che dovranno poi essere inviati), un “Link Description” riportante la descrizione del link utilizzato (versione sistema, etc…) ed infine un “Link Alive”, che conferma lo stato attivo del link tra i due Socket, del sistema remoto e di PCM. Qualora uno dei messaggi di inizializzazione che il PCM attende non venissero ricevuti, PCM procede a reinviare un nuovo messaggio di “Link Start”, richiesta di impostazioni della comunicazione da inviare al Sistema remoto. Il Sistema remoto circa ogni minuto invierà a PCM un messaggio “Link Alive” per notificare che il link è ancora funzionante, qualora non vi più alcuno scambio di informazione per una certa durata di tempo. CRASH SISTEMA TECNOVOX A fronte di eventuali crash del sistema Tecnovox che prevedono la perdita dell’attuale Socket utilizzato per la comunicazione con PCM e la generazione di uno nuovo, PCM in automatico non provvede la procedura di ripristino della comunicazione. Risulta pertanto necessario in caso di crash (verificabile nel log del sistema Tecnovox), procedere al riavvio manuale del PCM (server e servizio) e riavvio di Tecnovox per riconfigurare il link di comunicazione tra i due sistemi e continuare il lavoro. 48 • ELENCO PLUG-IN PASSPARTOUT CONNECTION MANAGER RIEPILOGO PLUGIN SUPPORTATI Tabella riassuntiva dei protocolli\dispositivi supportati: TIPOLOGIA PRODUTTORE DISPOSITIVO Centralini Gestione Gestione centralini centralini Domotica Altecon Service Hotel Domotica Cisa Cisa Key Card Domotica Glt Perseo Domotica Meganet MEGA Domotica Onity HT22 e HT28 Domotica Siemens Desigo Hotel Domotica Microdevice Hotel Supervisor Domotica IndelB Safe in Proximity Domotica STS STS_HOTEL PayTV Eurotelecom IRnet Pay TV PayTV Sky Web Service Hotel PayTV Eurotelecom IRnet Pay TV Domotica SmartCard Manhattan Domotica VDA VDA Domotica Eelectron Eelectron Domotica GFP Lab Eelectron Domotica Tecnovox Tecnovox Versione protocollo di comunicazione Interfaccia file esterni 26/05/09 Vers.UKPMS302 08/02/06 Rev.1.04 22/02/04 Vers.1.2 Rel.10/2002 Rev.2 09/09/01 Vers.3.0 19/04/03 Protocllo QJ/BD 10.001-08 Vers.4.0 Agosto 2007 Vers.1.04 24/06/04 Vers.1.6 17/05/07 Vers. 1.04 24/06/04 Vers. 2.16 QJ/BD 10.001-08 Vers. 1.00 Sw reference 1.8.r440 Rev. 27 RIEPILOGO PLUGIN SUPPORTATI • 49 PASSPARTOUT CONNECTION MANAGER 50 • RIEPILOGO PLUGIN SUPPORTATI World Trade Center – Edificio A Via Consiglio dei Sessanta, 99 47891 Dogana – Rep. San Marino Tel. 0549 978011 Fax 0549 978005 www.passepartout.net [email protected]