SPECIFICHE INFORMATICHE RICHIESTE:

Transcript

1 La nuova piattaforma RICESTAT prevede per l invio dei dati, dal vostro programma gestionale, l'interscambio di un file xml Di seguito troverete la varie specifiche informatiche richieste ai fini dell'accettazione del dato statistico inviato alla Provincia di Siena tramite il vostro gestionale, che vi invitiamo a trasmettere alla Vostra Ditta fornitrice del programma software in uso Siamo a disposzione per eventuali chiarimenti, contattando l'ufficio Turismo della Provincia di Siena 0577/ / o scrivendo a statistica.turismo@provincia.siena.it Siamo altresì a disposizione degli sviluppatori di software gestionale di strutture ricettive per accettare altri formati, per spiegazione sul formato suddetto nonchè per problemi informatci, contattare v.caputo@connectisweb.com ing Vittorio Caputo Connectis srl Tel Fax Cell. 348/ SPECIFICHE INFORMATICHE RICHIESTE: Con la presente veniamo a spiegare il funzionamento e il procedimento per l'importazione dei dati relativi agli arrivi e alle presenze mensili della Vostra struttura sul portale internet "Ricestat" Nello specifico Il file con i movimenti mensili è un documento XML il cui formato e componenti sono descritti di seguito. Tale formato fu scelto nel 2003 dal CED di Grosseto congiuntamente all'allora gestore dei servizi ed è stato mantenuto sull'attuale piattaforma per garantire la continuità del servizio. Ne consegue che la procedura di generazione del file è operativa anche sulle province gestite direttamente dal Turiweb. Inoltre ne è stato promosso l'utilizzo presso le altre province toscane. Le province che rispettano tale schema sono: Grosseto Livorno Pisa Siena Lucca Ecco la descrizione delle specifiche di interscambio dati Ricestat: Per poter essere importati nell'applicazione Turiweb, i dati devono essere esportati dal programma gestionale in un documento XML corrispondente alle specifiche di formato che seguono. Esempio di documento di interscambio Turiweb: <messaggio-turiweb xmlns=" xmlns:xsi=" xsi:schemalocation=" > <report id-struttura="00000alb0000"> <riepilogo-mensile anno="2002" mese="2"> <riga provenienza="gb" giorno="6" arrivi="20" partenze="10"/> <riga provenienza="d" giorno="8" arrivi="10" partenze="5"/> </riepilogo-mensile> </report>

2 </messaggio-turiweb> Descrizione: Ogni documento ha come elemento radice l'elemento <messaggio-turiweb/>. L'elemento <messaggioturiweb/> funge esclusivamente da contenitore, e deve contenere obbligatoriamente uno e un solo elemento <report/> che contiene i dati effettivi. L'attributo id-struttura corrisponde all'identificativo univoco della struttura ricettiva: di norma il codice regionale struttura utilizzato per tutte le comunicazioni. L'elemento <report/> può contenere uno o più elementi <riepilogo-mensile/>. Ciascuno di questi elementi contiene gli attributi anno e mese che specificano l'anno e il mese a cui si riferiscono le registrazioni contenute. All'interno dell'elemento <riepilogo-mensile/> sono contenute le effettive registrazioni di arrivi e partenze per ciascun giorno, sotto forma di elementi <riga/>. Ciascun elemento <riga/> corrisponde al totale giornaliero di arrivi e partenze per una singola nazionalità di provenienza (o provincia italiana). Il giorno è specificato nell'attributo giorno (mese e anno sono comuni a tutto il riepilogo mensile e vengono quindi specificati nell'elemento di livello superiore), totale arrivi e totale partenze negli attributi omonimi. La provenienza, registrata nell'attributo omonimo, è una stringa che deve contenere: * per gli ospiti esteri: la sigla automobilistica, determinata in base alla Tabella allegata, relativa al paese di provenienza (secondo la classificazione ISTAT del turismo); * per gli ospiti italiani: in generale il carattere underscore (_) seguito dalla sigla automobilistica della provincia di provenienza (RM per la provincia di Roma); possono anche essere indicate alcune province "fittizie" che permettono di indicare generiche regioni d'italia o ospiti italiani generici. Si veda a questo proposito Tabella allegata; Si ricorda che la direttiva regionale indica chiaramente che per le finalità Istat per ogni singola provenienza il numero dei partiti non può essere superiore al numero dei presenti la notte precedente. Tale situazione si verifica se si registrano l'arrivo e la partenza dello stesso soggetto lo stesso giorno solare. Se l'avventore utilizza il servizio per poche ore non dovrà essere inserito nei dati di rilevamento Istat, qualora invece pernotti effettivamente la procedura dovrà far sì che data di arrivo e di partenza non siano coincidenti. L'inosservanza ti tale punto inficierà il corretto caricamento dei dati Le regole di cui sopra sono contenute nello schema ricestat.xsd ( conforme alle specifiche XML Schema ( Facendo riferimento allo schema suddetto è eventualmente possibile utilizzare applicazioni esistenti di convalida XML Schema ( per controllare la correttezza del formato del file prima dell'invio a Ricestat. Una volta creato il file è necessario caricarlo nella sezione "File Presenze" del portale (ovviamente tramite il tasto "sfoglia" e poi "spedisci file") e sarebbe poi oppurtuno controllarne il corretto inserimento selezionando il mese in questione e controllando i dati a consuntivo. Il formato sopra indicato non permette di inserire le presenze al giorno precedente ma solo il movimento di arrivi e partenze. E' necessario perciò, nel caso si utilizzi il formato per caricare il primo mese in RICESTAT, aver prima caricato le presenze (se ci sono) alla notte precedente del primo del mese. Tale procedura non sarà più necessaria nei mesi successivi in quanto RICESTAT gestirà automaticamente i riporti.

3 Provenienza Italiana Regione Provincia Sigla automobilistica Sigla TURIWEB Valle d'aosta Aosta AO _AO Piemonte Alessandria AL _AL Piemonte Asti AT _AT Piemonte Biella BI _BI Piemonte Cuneo CN _CN Piemonte Novara NO _NO Piemonte Torino TO _TO Piemonte Verbano-Cusio-Ossola VB _VB Piemonte Vercelli VC _VC Piemonte (generico) _01 Liguria Genova GE _GE Liguria Imperia IM _IM Liguria La Spezia SP _SP Liguria Savona SV _SV Liguria (generico) _07 Lombardia Bergamo BG _BG Lombardia Brescia BS _BS Lombardia Como CO _CO Lombardia Cremona CR _CR Lombardia Lecco LC _LC Lombardia Lodi LO _LO Lombardia Milano MI _MI Lombardia Mantova MN _MN Lombardia Pavia PV _PV Lombardia Sondrio SO _SO Lombardia Varese VA _VA Lombardia (generico) _03 Veneto Belluno BL _BL Veneto Padova PD _PD Veneto Rovigo RO _RO Veneto Treviso TV _TV Veneto Venezia VE _VE Veneto Vicenza VI _VI Veneto Verona VR _VR Veneto (generico) _05 Trentino-Alto Adige Bolzano - Bozen BZ _BZ Trentino-Alto Adige Trento TN _TN Giulia Gorizia GO _GO Giulia Pordenone PN _PN Giulia Trieste TS _TS Giulia Udine UD _UD Giulia (generico) _06 Emilia-Romagna Bologna BO _BO Emilia-Romagna Ferrara FE _FE Emilia-Romagna Forl-Cesena FC _FC Emilia-Romagna Modena MO _MO

4 Emilia-Romagna Piacenza PC _PC Emilia-Romagna Parma PR _PR Emilia-Romagna Ravenna RA _RA Emilia-Romagna Reggio nell'emilia RE _RE Emilia-Romagna Rimini RN _RN Emilia-Romagna (generico) _08 Toscana Arezzo AR _AR Toscana Firenze FI _FI Toscana Grosseto GR _GR Toscana Livorno LI _LI Toscana Lucca LU _LU Toscana Massa-Carrara MS _MS Toscana Pisa PI _PI Toscana Prato PO _PO Toscana Pistoia PT _PT Toscana Siena SI _SI Toscana (generico) _09 Umbria Perugia PG _PG Umbria Terni TR _TR Umbria (generico) _10 Marche Ancona AN _AN Marche Ascoli Piceno AP _AP Marche Macerata MC _MC Marche Pesaro e Urbino PU _PU Marche (generico) _11 Lazio Frosinone FR _FR Lazio Latina LT _LT Lazio Rieti RI _RI Lazio Roma RM _RM Lazio Viterbo VT _VT Lazio (generico) _12 Abruzzo L'Aquila AQ _AQ Abruzzo Chieti CH _CH Abruzzo Pescara PE _PE Abruzzo Teramo TE _TE Abruzzo (generico) _13 Molise Campobasso CB _CB Molise Isernia IS _IS Molise (generico) _14 Campania Avellino AV _AV Campania Benevento BN _BN Campania Caserta CE _CE Campania Napoli NA _NA Campania Salerno SA _SA Campania (generico) _15 Puglia Bari BA _BA Puglia Brindisi BR _BR Puglia Foggia FG _FG Puglia Lecce LE _LE Puglia Taranto TA _TA Puglia (generico) _16 Basilicata Matera MT _MT Basilicata Potenza PZ _PZ Basilicata (generico) _17 Calabria Cosenza CS _CS Calabria Catanzaro CZ _CZ

5 Calabria Crotone KR _KR Calabria Reggio di Calabria RC _RC Calabria Vibo Valentia VV _VV Calabria (generico) _18 Sicilia Agrigento AG _AG Sicilia Caltanissetta CL _CL Sicilia Catania CT _CT Sicilia Enna EN _EN Sicilia Messina ME _ME Sicilia Palermo PA _PA Sicilia Ragusa RG _RG Sicilia Siracusa SR _SR Sicilia Trapani TP _TP Sicilia (generico) _19 Sardegna Cagliari CA _CA Sardegna Nuoro NU _NU Sardegna Oristano OR _OR Sardegna Sassari SS _SS Sardegna (generico) _20 Italia (generico) _00

6 Provenienza Straniera Paese FRANCIA BELGIO OLANDA GERMANIA GRAN BRETAGNA IRLANDA DANIMARCA GRECIA PORTOGALLO SPAGNA LUSSEMBURGO ISLANDA NORVEGIA SVEZIA FINLANDIA SVIZZERA AUSTRIA TURCHIA POLONIA REPUBBLICA CECA SLOVACCHIA UNGHERIA RUSSIA SLOVENIA CROAZIA EGITTO SUD AFRICA STATI UNITI D'AMERICA CANADA MESSICO VENEZUELA BRASILE ARGENTINA ISRAELE CINA COREA DEL SUD GIAPPONE AUSTRALIA NUOVA ZELANDA ALTRI PAESI MEDIO ORIENTE ALTRI PAESI ASIA ALTRI PAESI ALTRI PAESI AMERICA LATINA PAESI AFRICA MEDITERRANEA ALTRI PAESI AFRICA ALTRI PAESI EUROPEI MALTA ESTONIA LETTONIA LITUANIA Sigla TURIWEB F B NL D GB IRL DK GR P E L ISL N S SF CH A TR PLN CSV SKV H SU SLO HRV ET ZA USA CDN MEX YV BR RA IL RPC ROK J AUS NZL AMO ASI APX APA AFM AAF APE MT EE LV LT

7 ROMANIA BULGARIA UCRAINA CIPRO ALBANIA BIELORUSSIA BOSNIA-ERZEGOVINA MACEDONIA IUGOSLAVIA MOLDOVA INDIA ALTRI PAESI AMERICA CENTRALE ALTRI PAESI AMERICA SETTENTRIONALE PAESI AMERICHE NON INDICATO PAESI ASIA CENTRO OCCIDENTALE ALTRI PAESI ASIA ORIENTALE ALTRI PAESI OCEANIA E REGIONI POLARI ALTRI PAESI OCEANIA E REGIONI POLARI NON INDICATO RO BG UA CY AL BY BA MK YU MD IN AMC AMS AFN ASC ASO OCE OCN