Manuel d`utilisation interface d`importation
Contents
1. BEGASHFT INFORMATIK Manuel d utilisation interface d importation PASTA light Version 1 2 22 August 2011 BEGASOFT AG Version 1 22 August 2011 Seite 1 von 14 BEBASDFT S INFORMATIK Information sur le document 1 2 U In Bearbeitung O Zur berpr fung Definitive Fassung 22 August 2011 Sepp M geli G BEGASOFT Kunden S STV PASTA light 20 Entwicklung import Importschnittstelle PASTA light_12 odt BEGASOFT AG Version 1 22 August 2011 Seite 2 von 14 BEGASOET T INFORMATIK Table des mati res Administration 4 1 1 Versions 4 2 Introduction 5 2 1 Modifications par rapport la version pilote 5 3 Importation 6 3 1 Vue d ensemble 6 3 2 P riodes temporelles 6 3 3 Date de la fourniture de donn es 7 3 4 Format XML 8 3 5 Sch ma XML 8 3 6 occupancy 9 3 7 consolidation 10 3 8 Occupations empi tant sur une autre p riode 13 4 Transfert des donn es FTP ___ ___ 22 022 0 0 14 4 1 Conventions terminologiques 14 4 2 Proc dure de transfert des donn es 14 BEGASOFT AG Version 1 22 August 2011 Seite 3 von 14 1 Administration 1 1 Versions Version Datum BEBASOFT INFORMATIK Autor en nderungen 0 9 02 06 11 Sepp M geli version initiale en cours 1 0 27 06 11 Sepp M geli Version en tant que2. au 15 janvier numberOfNightsOccupied de personnes 30 14 44 totalNightsAdults Total des nuit es adultes Appartement 1 2 adultes Par adulte on entend toute personne Appartement 2 3 adultes ayant plus de 16 ans r volus totalNightsAdults 30 2 14 3 102 totalNightsChildren Total des nuit es enfants Par enfant Appartement 1 1 enfant on entend toute personne n ayant Appartement 2 2 enfants pas encore 16 ans r volus totalNightsChildren 30 1 14 2 58 numberOfArrivalsAdults Nombre d arrivees adultes numberOfArrivalsAdults 2 3 5 numberOfArrivalsChildren Nombre d arrivees enfants numberOfArrivalsChildren 1 2 3 S il y a en plus un regroupement par pays d origine les m mes r gles s appliquent pour d terminer les valeurs de chaque champ N anmoins seules les occupations du pays d origine en question sont prises en compte BEGASOFT AG Version 1 22 August 2011 Seite 10 von 14 BEGASDET S INFORMATIK Exemple dans la localit 723 2 appartements de vacances ont t occup s comme suit en f vrier 2011 Appartement 1 du 10 f vrier au 24 f vrier 2 adultes 1 enfant originaires de Suisse Appartement 2 du 2 f vrier au 9 f vrier 3 adultes originaires d Allemagne Ces donn es d occupation sont r unies comme suit pour l l ment consolidation El ment Valeur Aappartement 1 Appartement 2 numberOfNightsOccu
3. base pour la r alisation et le contr le par les partenaires IT fournisseurs de donn es 1 1 30 06 11 Version de travail dans laquelle les r actions et questions des partenaires IT fournisseurs de donn es vont tre int gr es Sepp M geli chapitre additionnel 3 8 Occupations empi tant sur une autre p riode 10 07 11 Sepp M geli suppl ments chapitre 3 4 Livrer les m mes donn es soit en tant que occupancy ou en tant que consolidation uniquement pas les deux Nom du sous registre dans le chapitre 4 2 compl t 11 07 11 Sepp M geli occupancy Element champ additionnel facultatif referenceFromOwner 20 07 11 El ment occupancy El ment numberOfAdults peut avoir le valeur 0 Offres pour enfants sans adults 25 07 11 Nouveau el ment EGID und EWID identificateur f d ral de b timent et identificateur f d ral de logement pour identifier les appartements El ment suppl mentaire fewolnformation avec donn es de base minimales concernant les appartements qui ne figurent pas dans le Metadirectory 1 2 12 08 11 Sepp M geli Version consolid e provenant de la phase pilote Version contraignante pour l impl mentation par les partenaires IT fournisseurs de donn es Nouveau chapitre 2 1 Modifications par rapport la version pilote BEGASOFT AG Version 1 22 August 2011 Seite 4 von 14 st BEGASOFT INFORMATIK 2 Introduction Le pr sent document d crit l interface d importation de l applic
4. en plus EGID et EWID Pour les appartements qui ne figurent pas dans le Metadirectory il est n cessaire en plus d indiquer les valeurs de l l ment fewolnformation Si l appartement figure dans le Metadirectory cet l ment est facultatif Dans le champ referenceFromOwner l identification interne du relev des occupations du fournisseur de donn es peut tre livr e La possibilit existe ainsi de r f rencer une inscription occupancy un moment ult rieur par l interface et d actualiser les donn es Si une telle cl est disponible dans le syst me du fournisseur de donn es elle doit imp rativement galement tre livr e Ce n est que l o aucun ID n est indiqu que le champ peut tre ignor Exemple d un l ment occupancy une famille allemande 2 adultes 1 enfant arrive le 2 mai et rentre le 8 mai L l ment occupancy correspondant est le suivant upancy gt lt fewoldentification gt lt idFromOwner gt 12345 lt idFromOwner gt lt owner gt begasoft lt owner gt lt fewoldentification gt 2 alDate gt 2010 05 02 lt arrivalDate gt lt coun ct ryOfOrigin gt DE lt countryOfOrigin gt lt occupancy gt Dans cet exemple l appartement de vacances est r f renc via l ID du fournisseur de donn es BEGASOFT AG Version 1 22 August 2011 Seite 9 von 14 3 7 consolidation BEBASOFT INFORMATIK L l ment consolidation r unit toutes les donn es d occupation des ap
5. 2 August 2011 Seite 6 von 14 Les p riodes temporelles suivantes sont possibles consolidationPeriodType Valeurs admissibles pour consolidationPeriodStart BESASOFT S INFORMATIK Description MONTH Chaque mois par ex 2011 02 Les donn es sont r unies et fournies chaque mois Cette variante est celle pr conis e HALFYEAR Janvier ou juillet d une ann e par ex 2011 01 ou 2011 07 Les donn es du 1 ou du 2 semestre sont r unies et fournies 01 01 30 06 et 01 07 31 12 Ce type de p riode ne doit tre s lectionn que si aucune donn e plus pr cise c est dire mensuelle n est disponible YEAR Janvier d une ann e par ex 2011 01 es donn es de l ann e enti re sont r unies et fournies Ce type de p riode ne doit tre s lectionn que si aucune donn e plus pr cise c est dire mensuelle ou semestrielle n est disponible SEASON 1 novembre d but de la saison d hiver ou 1 mai d but de la saison d t d une ann e par ex 2011 05 Les saisons d finies selon BFS sont novembre avril saison d hiver mai octobre saison d t Ce type de p riode ne doit tre s lectionn que si aucune donn e plus pr cise c est dire mensuelle ou semestrielle n est disponible 3 3 Date de la fourniture de donn es De mani re g n rale les donn es ne doivent pas tre fourn
6. XML peut tre t l charg ici Production http st stnet ch pasta light schemas beispiel xml Test http sttest stnet ch pasta light schemas beispiel xml BEGASOFT AG Version 1 22 August 2011 Seite 8 von 14 st BEGASOFT T INFORMATIK 3 6 occupancy L l ment occupancy correspond exactement aux donn es d une occupation r servation d appartement de vacances La signification de chaque champ doit tre parlante Par enfant on entend toute personne n ayant pas encore 16 ans r volus par adulte toute personne ayant d j 16 ans r volus Un l ment occupancy est toujours affect un certain appartement de vacances fewoldentification Cette attribution est possible avec les deux variantes suivantes 1 L appartement de vacances est disponible dans le Metadirectory et la Metadirectory ID est connue par le fournisseur de donn es L appartement de vacances peut alors tre r f renc avec la Metadirectory ID l ment idFromMetadirectory Cette variante est celle pr conis e 2 Sil appartement de vacances ne figure pas dans le Metadirectory ou que la Metadirectory ID n est pas connue du fournisseur de donn es l appartement de vacances peut tre r f renc via l ID du fournisseur de donn es l ments owner et idFromOwner Si le num ro de l appartement et de l immeuble est d j connu dans le registre f d ral des b timents et des logements RegBL ces deux valeurs doivent tre fournies
7. ation PASTA light L interface d importation est bas e sur des fichiers XML Le transfert des donn es s effectue via FTP et les ventuels retours aux fournisseurs de donn es messages d erreur etc par e mail 2 1 Modifications par rapport la version pilote Les exp riences faites pendant cette phase pilote ont t int gr es dans la version actuelle de la sp cification de l interface Il n y a en fait pas eu de changements fondamentaux du format de sorte que les fichiers qui ont t cr s avec la version initiale restent valables aujourd hui galement Les champs suppl mentaires ne sont pas des champs obligatoires Pour que l on dispose de donn es fiables et de qualit pour les valuations dans PASTA Light ces champs doivent toutefois si possible toujours tre remplis ou alors ignor s lorsque les donn es correspondantes ne sont pas disponibles dans le syst me du fournisseur de donn es Les l ments suivants sont venus s ajouter et doivent tre compl t s par les partenaires IT qui ont particip la phase pilote pour la version definitive de l interface e EGID e EWID e fewolnformation e referenceFromOwner BEGASOFT AG Version 1 22 August 2011 Seite 5 von 14 BEBASOFT INFORMATIK 3 Importation 3 1 Vue d ensemble Proc dure g n rale d importation des donn es PASTA light Le fournisseur de donn es cr e le fichier XML contenant les donn es importer Le fourniss
8. egasoft 2011 06 01 00 zip temp pm D Apr s le transfert renommer le fichier sur le serveur FTP PASTA light en begasoft 2011 06 01 00 zip Ensuite le fichier est d compress automatiquement et les donn es sont v rifi es puis import es vers la base de donn es PASTA light En cas de probleme l importation des donn es un message est envoy l adresse Error indiqu e errorEMailAddress BEGASOFT AG Version 1 22 August 2011 Seite 14 von 14
9. esure du possible les fournisseurs de donn es qui g rent les donn es dans un syst me de r servation partenaire IT doivent toujours fournir les donn es de chaque occupation r servation car ce type de donn es fournit un maximum d informations et autorise des valuations compl tes Ils disposent pour cela de l l ment occupancy L o les donn es ne sont pas fournies avec ce degr de pr cision par ex dans les organes de classification les donn es de plusieurs appartements de vacances d une localit peuvent tre r unies et fournies pour une certaine p riode temporelle On utilise pour cela l l ment consolidation Dans ce cas de figure les donn es doivent tre fournies avec le plus de details possible c est dire mensuellement si possible Les donn es ne peuvent tre r unies et fournies par semestre ou par an que si elles ne sont pas disponibles par mois Dans le cas o les donn es ne sont saisies qu en fonction des saisons il est possible de r unir et de fournir des donn es saisonni res 3 5 Sch ma XML Le format est d fini dans le sch ma xml pasta xsd Remarque Les URL indiqu es ci dessous ne sont pas encore disponibles Les deux fichiers mentionn s sont fournis dans la pi ce jointe ce document Le sch ma XML en vigueur peut tre obtenu via cette URL Production http st stnet ch pasta light schemas pasta xsd Test http sttest stnet ch pasta light schemas pasta xsd Un exemple de fichier
10. eur des donn es valide le fichier XML avec le sch ma XML Le fournisseur de donn es transf re le fichier XML via FTP au serveur FTP de PASTA light Les donn es sont contr l es puis import es dans la base de donn es PASTA light Qu Br LS En cas d erreur l importation un e mail est envoy l adresse Error indiqu e dans le header errorEMailAddress Les donn es erron es peuvent tre corrig es par le fournisseur de donn es et fournies nouveau ult rieurement 6 En cas d importation r ussie un e mail est envoy l adresse d info indiqu e dans le header 3 2 P riodes temporelles En pr sence de donn es de type occupancy la p riode temporelle correspond aux dates d arriv e de d part de l occupation r elle arrivalDate departureDate En pr sence de donn es de type consolidation les dates d occupation de tous les appartements de vacances du fournisseur de donn es sont r unies par localit pendant une certaine p riode Les donn es doivent toujours tre fournies selon la p riodicit la plus courte autrement dit la p riodicit mensuelle est meilleure que la p riodicit semestrielle et la semestrielle meilleure que l annuelle Dans la mesure du possible les donn es doivent tre livr es par mois consolidationPeriodtype MONTH car sous cette forme les donn es fournissent davantage d informations et autorisent les valuations les plus compl tes BEGASOFT AG Version 1 2
11. i sur les p riodes respectives totalNightsAdults Sera factur e la dur e pendant laquelle le logement a r ellement t occup Le nombre de nuits sera r parti sur les p riodes respectives totalNightsChildren Sera factur e la dur e pendant laquelle le logement a r ellement t occup Le nombre de nuits sera r parti sur les p riodes respectives numberOfArrivalsAdults On se r f rera syst matiquement la date d arriv e numberOfArrivalsChildren On se r f rera syst matiquement la date d arriv e Exemple Les clients 2 adultes 1 enfant arrivent le 30 janvier et repartent le 6 f vrier Les donn es sont regroup es par mois Ainsi les donn es de cette occupation entrent en ligne de compte dans les l ments de consolidation des deux mois Il en r sulte les chiffres suivants Element Total consolidation Januar consolidation Februar numberOfNightsOccupied 7 2 5 totalNightsAdults 2 7 14 4 10 totalNightsChildren 1 7 7 2 5 numberOfArrivalsAdults 2 2 0 numberOfArrivalsChildren 1 1 0 BEGASOFT AG Version 1 22 August 2011 Seite 13 von 14 BEBASOFT INFORMATIK 4 Transfert des donn es FTP Les fichiers d importation sont fournis via FTP A cet effet chaque fournisseur de donn es se voit attribuer son propre FTP Account L adresse FTP et les donn es d acc s sont communiqu es chaque fournisseur de donn es par BEGASOFT Les partenai
12. ies des dates fixes L id al est de fournir les donn es d s qu elles sont disponibles Si possible les donn es doivent tre livr es avant la fin du mois suivant la p riode temporelle Type de donn es Date de livraison Exemple occupancy Avant la fin du mois suivant la departureDate 2011 05 08 departureDate Fourniture avant le 30 09 2011 consolidation Avant la fin du mois suivant la consolidationPeriodType p riode temporelle des donn es fournies HALFYEAR consolidationPeriodStart 2011 01 Fourniture avant le 31 07 2011 BEGASOFT AG Version 1 22 August 2011 Seite 7 von 14 BEBASOFT INFORMATIK 3 4 Format XML Le fichier d importation est compos d un l ment header contenant toutes les informations g n rales sur les donn es et l importation Cette partie est suivie d une liste de chaque occupation l ment occupancy ou des donn es d occupation r unies l ment consolidation De mani re g n rale les l ments occupancy et consolidation peuvent appara tre dans le m me fichier N anmoins dans la plupart des cas cela n a pas de sens car en g n ral un fichier d importation ne contient qu une seule liste avec l un des deux l ments Important un fournisseur de donn es qui livre des donn es d occupation individuelles occupancy ne doit pas encore livrer en plus les m mes donn es de mani re group e consolidation Dans la m
13. partements de vacances disponibles dans une localit pendant une certaine p riode temporelle Un l ment consolidation est toujours affect une localit placeReference Cette attribution est possible avec les variantes suivantes sachant que chaque variante est quivalente 1 Si la Resort ID de Suisse Tourisme est connue elle peut tre utilis e pour le r f rencement l ment resortld 2 Le num ro d ordre univoque de la Poste ONRP figurant dans le fichier de NPA de la Poste l ment onrp 3 Le num ro postal d acheminement 4 chiffres de la localit compl t si n cessaire par le chiffre compl mentaire du fichier de NPA de la Poste l ments zip et zipSequentialI Number La signification des champs consolidation est moins parlante que dans l l ment occupancy Raisons pour laquelle ici les r gles sont fournies pour chaque champ El ment Description Exemple consolidationPeriodType Pour quelle p riode les donn es sont elles fournies Voir chapitre P riodes temporelles consolidationPeriodStart D but de la p riode temporelle La fin de la p riode d pend du type de p riode Voir chapitre P riodes temporelles numberOfNightsOccupied Nombre de nuit es pendant lesquelles les appartements de vacances ont t occup s Cette valeur est ind pendante du nombre L appartement 1 tait occup tout le mois de janvier l appartement 2 du 1
14. pied 21 14 7 totalNightsAdults 49 14 2 7 3 totalNightsChildren 14 14 1 7 0 numberOfArrivalsAdults 5 2 3 numberOfArrivalsChildren 1 1 0 si possible les donn es sont aussi r unies et livr es par pays d origine des touristes El ment Valeur Aappartement 1 Appartement 2 countryOfOrigin CH CH totalNightsAdults 28 14 2 totalNightsChildren 14 14 1 numberOfArrivalsAdults 2 2 numberOfArrivalsChildren 1 1 El ment Valeur Aappartement 1 Appartement 2 countryOfOrigin DE DE totalNightsAdults 21 7 3 totalNightsChildren 0 7 0 numberOfArrivalsAdults 3 3 numberOfArrivalsChildren 0 0 BEGASOFT AG Version 1 22 August 2011 Seite 11 von 14 BEGASOFT INFORMATIK L l ment consolidation correspondant est le suivant lt consolidation gt lt placeReference gt lt resortId gt 723 lt resortId gt lt placeReference gt lt consolidationPeriodType gt MONTH lt consolidationPeriodType gt lt consolidationPeriodStart gt 2010 02 lt consolidationPeriodStart gt lt numberOfNightsOccupied gt 21 lt numberOfNightsOccupied gt lt totalNightsAdults gt 49 lt totalNightsAdults gt lt totalNightsChildren gt 14 lt totalNightsChildren gt lt numberOfArrivalsAdults gt S lt numberOfArrivalsAdults gt lt numberOfArrivalsChildren gt 1 lt numberOfArrivalsChildren gt lt consolidationPerCountryOfOrigin gt lt countryOfOrigin gt CH lt co
15. res IT qui saisissent d j des donn es dans le Metadirectory utiliseront le FTP Account dont ils disposent d j Le fichier d importation est transf r au serveur FTP PASTA light par le fournisseur de donn es la date d finie voir chapitre Date de la fourniture de donn es vial interface FTP 4 1 Conventions terminologiques Le nom du fichier se compose de l ID du fournisseur de donn es dataproviderld de la date de cr ation du fichier d exportation et d un num ro courant par jour au cas o plusieurs fichiers doivent tre fournis le m me jour Le num ro courant n est pas limit deux chiffres Exemple begasoft 2011 06 01 00 xml Avant la fourniture des donn es le fichier XML doit tre compress et transf r puis enregistr dans un conteneur ZIP fichier zip Exemple begasoft 2011 06 01 00 zip 4 2 Proc dure de transfert des donn es Important le fichier doit tre transf r avec un nom temporaire et ne peut tre renomm en zip qu une fois le transfert des donn es termin Le fichier tant trait automatiquement d faut il se peut que le traitement d marre sur un fichier dont le transfert n est pas encore termine Exemple d une proc dure compl te 1 Exportation des donn es vers begasoft 2011 06 01 00 xml Validation du fichier sch ma XML pasta xsd Compression du fichier vers begasoft 2011 06 01 00 zip Transfert du fichier via FTP sous un nom temporaire par ex b
16. untryOfOrigin gt lt totalNightsAdults gt 28 lt totalNightsAdults gt lt totalNightsChildren gt 14 lt totalNightsChildren gt lt numberOfArrivalsAdults gt 2 lt numberOfArrivalsAdults gt lt numberOfArrivalsChildren gt 1 lt numberOfArrivalsChildren gt lt consolidationPerCountryOfOrigin gt lt consolidationPerCountryOfOrigin gt lt countryOfOrigin gt DE lt countryOfOrigin gt lt totalNightsAdults gt 21 lt totalNightsAdults gt lt numberOfArrivalsAdults gt 3 lt numberOfArrivalsAdults gt lt consolidationPerCountryOfOrigin gt lt consolidation gt BEGASOFT AG Version 1 22 August 2011 Seite 12 von 14 3 8 Occupations empietant sur une autre p riode BEBASOFT INFORMATIK Lorsque les donn es par p riode sont centralis es consolidation les occupations d bordent parfois sur la p riode de consolidation Le chapitre suivant d crit la mani re dont les donn es doivent tre trait es le cas ch ant Lorsque les diff rentes dur es d occupation sont livr es occupancy cette probl matique ne se pose pas puisque la dur e d occupation effective date d arriv e date de d part est syst matiquement indiqu e En cas d occupations cheval sur plusieurs p riodes les r gles suivantes s appliquent l ment Traitement numberOfNightsOccupied Sera comptabilis e la dur e pendant laquelle le logement a r ellement t occup Le nombre de nuits sera r part
Download Pdf Manuals
Related Search