- 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
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
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
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
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
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
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
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
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
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.
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:
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.
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 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.
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:
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.
E proponendo la relativa finestra di configurazione.
Creare, nel caso non esista già, un nuovo database tramite l’apposito tasto e confermare con “Ok”
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
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
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.
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.
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.
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.
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
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.
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
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
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.
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.
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
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…).
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;
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.
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.
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;
•
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):
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:
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);
•
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.
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
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)
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
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.
•
•
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.
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.
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
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]

- Itinera srl

Transcript

Documenti analoghi

Registrazione manuale DAO350

Ottimizzazione iniziale del proprio server prima della sua

Listino prezzi aggiornato al 9/12/2011 Articolo Prezzo

scheda d`acquisizione 4 canali mpeg4 per pc

Installazione ISE WebPack 6.3 e Modelsim Xilinx Edition (MXE) Step

guida winmx

edu cd8 unipa giuffre nov10

Europass CV