protocollo di colloquio modello c59

PROTOCOLLO DI COLLOQUIO
MODELLO C59
1
INDICE
1.
INTRODUZIONE ............................................................................................................ 3
2.
TRACCIATO RECORD .................................................................................................. 4
3.
TABELLA DEGLI ERRORI ............................................................................................. 5
4.
MODALITA’ DI CARICAMENTO .................................................................................... 6
5.
TABELLE DI CODIFICA ................................................................................................. 6
2
1. INTRODUZIONE
La Regione Marche ha messo a disposizione per tutte le sue strutture ricettive un portale per
l’inserimento dei flussi turistici raggiungibile al sito: http://statistica.turismo.marche.it.
Il movimento turistico è stato suddiviso in due grandi filoni italiani e stranieri come da
disposizione del modello C59 ISTAT.
Per facilitare l’inserimento, il nostro sistema mette a disposizione un protocollo di
cooperazione applicativa, tale protocollo intende snellire le procedure di caricamento dei dati
alle strutture che per la gestione del flusso turistico utilizzano già un software.
Il protocollo da noi ideato prevede da parte dei software in dotazione alle strutture la
generazione di file in formato CSV opportunamente strutturato in base alle nostre specifiche.
Il caricamento del file CSV generato va eseguito manualmente con cadenza mensile.
Si ricorda che una volta che si intraprende tale modalità non sarà più possibile tornare
all’inserimento da portale.
3
2. TRACCIATO RECORD
In questo paragrafo descriveremo il tracciato record in dettaglio, come accennavamo
nell’introduzione di questo documento, il file è di tipo CSV il separatore che è utilizzato, è il
carattere “tab”.
I dati di flusso all’interno del file dovranno essere ordinati per data in maniera crescente.
Il file dovrà contenere dati che fanno riferimento a un solo mese e non saranno ammessi
caricamenti parziali.
CAMPO
TIPO
NOTE
Tipo Movimento
INTEGER
Vedi Tabella di Codifica T1
Data del movimento
STRING
Formato gg/mm/aaaa
Numero arrivati/ Numero partiti
INTEGER
Maggiore di zero
Codice Comune/Nazione
INTEGER
Vedi Tabella di Codifica T2,T3
ESEMPI
ITALIANI
Esempio Arrivo:
1
01/01/2010
4
405028001
3
405028001
1
405028001
4
100000203
3
100000203
1
100000203
Esempio Partenza:
2
01/01/2010
Esempio in out:
3
01/01/2010
STRANIERI
Esempio Arrivo:
4
01/01/2010
Esempio Partenza:
5
01/01/2010
Esempio in out:
6
01/01/2010
4
3. TABELLA DEGLI ERRORI
Di seguito la tabella riepilogativa degli errori che la procedura potrà generare durate
l’elaborazione del file.
Si avverte che il file sarà scartato completamente in caso di errore!
Cod. scarto
Tipo Errore
Note
00
Movimenti in periodo di chiusura
Si
sta
tentando
di
inserire
dei
movimenti mentre la struttura è
chiusa.
01
Comune non codificato
Si sta tentando di inserire un codice
comune che non corrisponde con il
nostro tracciato;
02
Nazione non codificata
Si sta tentando di inserire un codice
nazione che non corrisponde con il
nostro tracciato;
03
Tipo Movimento non codificato
Si sta tentando di inserire un codice
movimento che non corrisponde con
il nostro tracciato;
04
Formato file errato
Il file non è conforme con le nostro
formato CSV;
05
Formato data errato
06
La
data
è
antecedente
alla Il file non è ordinato correttamente
precedente
07
Numero partenze superiore agli arrivi
08
Arrivi superiori ai posti letti
per data;
Gli arrivi superano i posto letti
dichiarati dalla struttura:
09
Errore imprevisto del server
Comprende tutti gli errori generati
dalla connessione con il server e con
il database;
5
4. MODALITA’ DI CARICAMENTO
In questo paragrafo si descrive la modalità di caricamento dei file. L’utente dotato di
credenziali per l’accesso al portale regionale qualora sarà abilitato avrà due funzionalità una
per il caricamento del file e un’altra per la visualizzazione dello storico dei caricamenti.
5. TABELLE DI CODIFICA
TIPO MOVIMENTO (T1)
CODICE
1
2
3
4
5
6
DESCRIZIONE
Arrivo turista/i italiano/i
Partenza turista/i italiano/i
In /out italiano/i
Arrivo turista/i straniero/i
Partenza turista/i straniero/i
In /out straniero/i
In/Out: Sono tutte quelle persone che arrivano e partono nello stesso giorno.
COMUNI ITALIANI (T2) (Es: esempio Excel dei comuni)
Codice
405028001
401001501
403098001
403015699
403013663
403097001
409052001
403013501
420092512
420095001
413068001
450500501
403015002
403012501
409047001
417076001
419088001
416071001
………
Descrizione
ABANO TERME
ABBADIA ALPINA
ABBADIA CERRETO
ABBADIA CERRETO
ABBADIA LARIANA
ABBADIA LARIANA
ABBADIA SAN SALVATORE
ABBADIA SOPRA ADDA
ABBASANTA
ABBASANTA
ABBATEGGIO
ABBAZIA
ABBIATEGRASSO
ABBIATEGUAZZONE
ABETONE
ABRIOLA
ACATE
ACCADIA
Provincia DataFineVal
PD
TO
31/12/1983
LO
MI
05/03/1992
CO
05/03/1992
LC
SI
CO
31/12/1983
CA
15/07/1974
OR
PE
FU
15/09/1947
MI
VA
31/12/1983
PT
PZ
RG
FG
6
NAZIONI (T3) (Es: esempio Excel delle nazioni)
Codice
Descrizione
100000301 AFGHANISTAN
Provincia DataFineVal
ES
100000201
100000401
100000202
100000402
100000733
100000503
100000734
100000735
100000999
100000736
100000302
100000602
100000358
100000701
100000203
100000359
100000505
100000304
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ES
ALBANIA
ALGERIA
ANDORRA
ANGOLA
ANGUILLA (ISOLA)
ANTIGUA E BARBUDA
ANTILLE BRITANNICHE
ANTILLE OLANDESI
APOLIDE
ARABIA MERIDIONALE
ARABIA SAUDITA
ARGENTINA
ARMENIA
AUSTRALIA
AUSTRIA
AZERBAIGIAN
BAHAMA
BAHREIN
Le tabelle di codifica complete per le nazioni e i comuni italiani saranno comunicate
in allegato in formato Excel;
7