PIVOT. Pivot/Querier Documentation technique XML/XSD/XSLT

Please download to get full document.

View again

of 23
40 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
Réf. : Pivot/Querier Auteur : JM. DERUYTER Rév. : 1.3 Rév. Date : 05/05/15 Distribution : Normale * Restreinte 1. Confidentielle PIVOT Pivot/Querier Documentation technique XML/XSD/XSLT Table des matières
Document Share
Documents Related
Document Transcript
Réf. : Pivot/Querier Auteur : JM. DERUYTER Rév. : 1.3 Rév. Date : 05/05/15 Distribution : Normale * Restreinte 1. Confidentielle PIVOT Pivot/Querier Documentation technique XML/XSD/XSLT Table des matières 1 Préambule Gestion du document Base de données Pivot/Web XML Langage Utilisation dans l'application du schéma XML racine offre infos_generales toffres infos_complementaires tannexess tcontactss tmoyencoms treservationss ttarifss tdatess tvisitess thorairess tcampingss tanipedss tseminairess tpoiss treloffres trestaurantss ttypesusagerss tsalless trandonneess /30 tmicess tdureess trecettess tmicess thebergementss tchambress toffrespromoss toffresraws tcriteres critere Exemple de fichier XML XSD Langage Utilisation dans l'application Extrait du schéma XSLT Langage Utilisation dans l'application Extrait du document de transformation XSLT (tableau structuré) /30 1 Préambule Le présent document expose les technologies XML, XSD et XSLT mises en place pour la génération des résultats des requêtes Web (Web Queries ou WQ) du projet PIVOT/Querier. 2 Gestion du document Version Date de la modification Auteur /03/10 Document initial JM. DERUYTER /11/14 Mise à jour du document initial W. KASSEM /05/15 Mise à jour thème A. RUELLE 3/30 3 Base de données Pivot/Web La source des données est une base de données MySql de type «Pivot/Web» (structure relationnelle) mise à jour quotidiennement. Voir la documentation «Pivot/Web» pour plus de détails. 4 XML 4.1 Langage 1 Extensible Markup Language (XML) est un langage informatique de balisage générique. Il sert essentiellement à stocker/transférer des données de type texte Unicode structurées en champs arborescents. Ce langage est qualifié d extensible car il permet à l'utilisateur de définir les balises des éléments. Le World Wide Web Consortium (W3C) 2, promoteur de standards favorisant l'échange d'informations sur Internet, recommande la syntaxe XML pour exprimer des langages de balisages spécifiques. De nombreux langages respectent la syntaxe XML : SVG pour des données de graphique vectorisé, XHTML pour des données de page web, RSS pour des données de syndication de contenu, XSLT pour des données de transformation d'un document XML, etc. Cette syntaxe est reconnaissable par son usage des chevrons ( ) pour les balises d'éléments et de la chaîne !-- -- pour les commentaires du code. L'objectif initial est de faciliter l'échange automatisé de contenus entre systèmes d'informations hétérogènes (interopérabilité). XML est une simplification du Standard Generalized Markup Language (SGML) 3 dont il retient les principes essentiels comme : la structure d'un document XML est définissable et peut être validée par un schéma (XSD); un document XML est entièrement transformable dans un autre document XML /30 4.2 Utilisation dans l'application Les requêtes Web ont pour but d'extraire de l'information d'une base de données MySql de type «Pivot/Web» et de la partager avec d'autres systèmes d'informations. L'emploi de la technologie XML nous permet d'automatiser l'échange de contenus entre l'interface de gestion de Pivot/Querier et des demandeurs externes au système grâce aux connecteurs de requêtes Web mis en place. Le code XML généré par l'application est encodé en UTF-8 dans sa version du schéma XML Une structure XML se compose d'une arborescence de balises encadrées de chevrons ( ). L'arborescence XML employée pour l'extraction de données se présente comme suit racine La balise racine est la balise pivot . Elle est unique et obligatoire. C'est elle qui contient toute la structure arborescente. Plusieurs paramètres, appelés attributs, lui sont associés : cle : clé unique de la requête Web exécutée (attribut obligatoire) ; page : numéro de la page extraite (optionnel) ; maxpage : nombre maximum de pages existantes (optionnel) offre Sous l'élément racine peuvent se retrouver zéro, une ou plusieurs balises offre (et leurs propres contenus). Cette balise représente une offre dans son entièreté. Aucun attribut n'est associé à cette balise. Sous chaque balise offre , nous retrouvons trois niveaux ordonnés : la balise infos_generales ; la balise infos_complementaires ; la balise tcriteres. 5/30 4.3.3 infos_generales toffres La balise infos_generales contient une seule sous-balise toffres . Ces deux balises représentent les données identitaires de l'offre traitée. Chaque donnée identitaire est une balise à part entière. En voici la liste complète. fk_ttypesoffres_id_type_offre codecgt nom[_(nl,en,de)] rue rue_cplt numero boite cp id_ins ins lieu_dit lieu_precis localite commune province parc_naturel mdt coord_lambert_x coord_lambert_y coord_geo_longitude coord_geo_latitude itineraire_acces[_(nl,en,de)] classement Type de l'offre Code CGT de l'offre (identifiant) Dénomination de l'offre, respectivement en français, en néerlandais, en anglais et en allemand Adresse de l'offre Dénomination du parc naturel dans lequel se trouve l'offre Dénomination de la maison du tourisme concernée par l'offre Coordonnées Lambert Coordonnées de longitude et de latitude Itinéraire d'accès à l'offre touristique, sous forme de texte Classement de l'offre (sous forme de texte). Les valeurs sont différentes selon les types d'offres (étoiles, épis, etc.) 6/30 classement_num Valeur numérique du classement (0 à 5) nbr_unite_sejour nbr_chambre capacite1 capacite2 descriptif[_(nl,en,de)] descriptif_scolaire[_(nl,en,de)] descriptif_rando[_(nl,en,de)] descriptif_indiv[_(nl,en,de)] descriptif_groupes[_(nl,en,de)] horaire_ouverture[_(nl,en,de)] pmr_acceptes animaux_admis non_fumeur nbr_personnes_min nbr_personnes_max fk_toffres_code_cgt complement_tarif[_(nl,en,de)] cplt_nom date_creation date_modification groupes_acceptes horaire_ouverture_groupes[(_nl,en,de)] metadonnees_resume[(_nl,en,de)] metadonnees_motscles[(_nl,en,de)] VV TypeUniteSejour : nombre d'unités de séjour de ce type dans le village Pour HLO/Hôtel: nombre de chambres Pour HLO: capacité de base. Autres: capacité minimale. Pour VV : capacité totale (en nombre de personnes) du Village. Pour Restauration: nombre de couverts Pour HLO: capacité additionnelle. Autres: capacité maximale. Pour VV: capacité totale (en nombre d'unités de séjour) du Village. Pour Restauration: marketing (standard) Descriptifs pour les cibles marketing Horaire d'ouverture Flag indiquant si les PMR sont acceptés Flag indiquant si les animaux sont acceptés Établissement non fumeur Nombre de personnes minimum Nombre de personnes maximum Code CGT de l'offre parente, si elle existe Complément du tarif de l'offre Complément du nom de l'offre Date de création de l'offre Date de modification de l'offre Groupes acceptés Horaire d'ouverture groupe de l'offre Métadonnées du résumé de l'offre Métadonnées des mots clés de l'offre 7/30 non_fumeur points_forts[(_nl,en,de)] qualite Non fumeur Points forts de l'offre Qualité de l'offre infos_complementaires La balise infos_complementaires contient toutes les données non identitaires des offres. Les sous-balises de infos_complementaires sont : tannexess : annexes associées à une offre (images, traces GPS, fichiers PDF, etc.); tcontactss : personnes de contact; tmoyencoms : coordonnées (téléphone, fax, adresse , etc.); treservationss : moyens de réservations (offres de type hébergement et aux attractions/musées); ttarifss : tarifs; tdatess : dates d'apparition des activités et/ou événements (offres de type activité et événement); tvisitess : informations des visites (offres de type attraction/musée, visite/découverte, TNA, producteur et artisan) toffresraws : informations de l'offre sous forme de texte brut ; toffrespromoss : informations sur des offres promotionnelles; tchambress : détails des chambres (offres de type gîte, meublé et chambre d'hôte); thebergementss : informations complementaires pour les offres de type hébergement; trecettess : informations complémentaires pour les offres de type recette; tdureess : durées de parcours par type d'usager (offres de type itinéraire balisé); tmicess : informations complémentaires pour les offres de type MICE; trandonneess : informations complémentaires pour les offres de type itinéraire balisé; tsalless : descriptions des salles (offres de type lieu de séminaire); tseminairess : informations complémentaires pour les offres de type lieu de séminaire; 8/30 tanipedss : informations complémentaires pour les offres de type animation pédagogique ; tcampingss : informations complémentaires pour les offres de type camping ; thorairess : informations complémentaires des horaires des offres ; tpoiss : informations complémentaires pour les offres de type point d'intérêt ; treloffres : descriptions des relations de l'offre ; trestaurantss : informations complémentaires pour les offres de type restaurant ; ttypesusagerss : descriptions des types d'usagers de l'offre. Chacune de ces sous-balises contiennent elles-mêmes d'autres balises. En voici la liste complète tannexess Chaque annexe est représentée par une balise tannexes . Les sous-balises possibles de tannexes sont : type url principale copyright cplt_info[_(nl,en,de)] intitule[_(nl,en,de)] mode langue[_(nl,en,de)] date_creation Type d'annexe URL vers l'annexe dans la médiathèque Détermine s'il s'agit de l'annexe principale liée à l'offre (par une exemple, une photo officielle) Copyright associé à l'annexe Descriptif associé à l'annexe Intitulé de l'annexe Mode d'annexe Langue de l'annexe Date de création de l'annexe tcontactss Chaque personne de contact est représentée par une balise tcontacts . Les sousbalises possibles de tcontacts sont : 9/30 civilite nom prenom adresse numero boite id_ins ins cp localite commune pays telephone fax gsm url facebook flickr googleplus instagram pinterest twitter youtube type[_(nl,en,de)] Genre du contact (Madame, Monsieur, etc.) Nom et prénom du contact Adresse du contact Coordonnées du contact Type de contact (Propriétaire, Entretien, Direction, etc.) tmoyencoms Chaque moyen de communication est représenté par une balise tmoyencom . Les sous-balises possibles de tmoyencom sont : type coordonnees_moyen_com coordonnees_info_moyen_com[_(nl,en,de)] Type du moyen de communication Coordonnées du moyen de communication (le numéro de tél/fax/gsm, l'url du site web, l'adresse de mail) Complément d'information lié au moyen de communication 10/30 treservationss Chaque mode de réservation est représenté par une balise treservations . Les sousbalises possibles de treservations sont : type type_coordonnees coordonnees Type de réservation Type de moyen de communication Coordonnées du moyen de communication pour la réservation ttarifss Chaque tarif est représenté par une balise ttarifs . Les sous-balises possibles de ttarifs sont : categorie type[_(nl,en,de)] complement_info[_(nl,en,de)] complement_info_brut[_(nl,en,de)] date prix_min prix_max Catégorie de tarif Type de tarif Complément d'information du tarif Complément d'information du tarif sous forme de texte brut Date de début de validité du tarif Prix minimum Prix maximum tdatess Chaque date est représentée par une balise tdates . Les sous-balises possibles de tdates sont : date_debut date_fin Date de début de l'activité/événement, ou de la période de chasse (itinéraires balisés) Date de fin de l'activité/événement, ou de la période 11/30 cplt_info[_(nl,en,de)] cplt_info_brut[_(nl,en,de)] heure_ouverture_1 heure_fermeture_1 heure_ouverture_2 heure_fermeture_2 de chasse (itinéraires balisés) Complément d'information des dates Complément d'information des dates sous forme de texte brut Heure d'ouverture 1 de l'activité/événement, ou de la période de chasse (itinéraires balisés) Heure de fermeture 1 de l'activité/événement, ou de la période de chasse (itinéraires balisés) Heure d'ouverture 2 de l'activité/événement, ou de la période de chasse (itinéraires balisés) Heure de fermeture 2 de l'activité/événement, ou de la période de chasse (itinéraires balisés) tvisitess Chaque visite est représentée par une balise tvisites . Les sous-balises possibles de tvisites sont : individuels groupes pedagogique descriptif_indiv[_(nl,en,de)] descriptif_indiv_brut[_(nl,en,de)] descriptif_groupe[_(nl,en,de)] descriptif_groupe_brut[_(nl,en,de) ] duree_moy_indiv duree_moy_groupes visite_guidee_indiv_permanence visite_guidee_indiv_demande visite_libre_indiv_permanence Visites pour individuels Visites pour groupes Visites pédagogiques Descriptif de la visite individuelle Descriptif de la visite individuelle sous forme de texte brut Descriptif de la visite de groupe Descriptif de la visite de groupe sous forme de texte brut Durée moyenne de la visite individuelle Durée moyenne de la visite de groupe Flag indiquant si les visites guidées pour individuels en permanence sont acceptées Flag indiquant si les visites guidées pour individuels sur demande sont acceptées Flag indiquant si les visites libres pour individuels en permanence sont acceptées 12/30 visite_libre_indiv_demande visite_guidee_groupes_permanence visite_guidee_groupes_demande visite_libre_groupes_permanence visite_libre_groupes_demande Flag indiquant si les visites libres pour individuels sur demande sont acceptées Flag indiquant si les visites guidées pour groupes en permanence sont acceptées Flag indiquant si les visites guidées pour groupes sur demande sont acceptées Flag indiquant si les visites libres pour groupes en permanence sont acceptées Flag indiquant si les visites libres pour groupes sur demande sont acceptées thorairess Chaque horaire est représenté par une balise thoraires . Les sous-balises possibles de thoraires sont : ouverture_indiv ouverture_indiv_brut fermeture_annuelle_indiv fermeture_annuelle_indiv_brut fermeture_hebdo_indiv fermeture_hebdo_indiv_brut ouverture_groupes ouverture_groupes_brut fermeture_annuelle_groupes fermeture_annuelle_groupes_brut fermeture_hebdo_groupes fermeture_hebdo_groupes_brut Période et horaire d'ouverture pour individuels Période et horaire d'ouverture pour individuels sous forme de texte brut Fermeture annuelle pour individuels Fermeture annuelle pour individuels sous forme de texte brut Fermeture hebdomadaire pour individuels Fermeture hebdomadaire pour individuels sous forme de texte brut Période et horaire d'ouverture pour groupes Période et horaire d'ouverture pour groupes sous forme de texte brut Fermeture annuelle pour groupes Fermeture annuelle pour groupes sous forme de texte brut Fermeture hebdomadaire pour groupes Fermeture hebdomadaire pour groupes sous forme de texte brut 13/30 tcampingss Chaque offre de type camping peut posséder des informations complémentaires représentées par une balise tcampings . Les sous-balises possibles de tcampings sont : superficie nb_empl_total nb_empl_passage nb_empl_residentiel nb_empl_prise nb_empl_egout nb_empl_motorhome nb_empl_saisonnier nb_chalet_loc nb_caravane_loc La superficie du camping Nombre d'emplacements total dans le camping Nombre d'emplacements de passage Nombre d'emplacements résidentiels Nombre d'emplacements avec prise de courant Nombre d'emplacements avec égoût Nombre d'emplacements motor-homes Nombre d'emplacements saisonniers Nombre de chalets/bungalows en location Nombre de caravanes en location tanipedss Chaque offre de type animation pédagogique peut posséder des informations complémentaires représentées par une balise tanipeds . Les sous-balises possibles de tanipeds sont : type duree_min duree_max cplt_info[_(nl,en,de)] cplt_info_brut[_(nl,en,de)] programme[_(nl,en,de)] programme_brut[_(nl,en,de)] conseilpro[_(nl,en,de)] Type d'animation pédagogique Durée minimum (minutes) Durée maximum (minutes) Complément d'information Complément d'information sous forme de texte brut Programme de l'animation pédagogique Programme de l'animation pédagogique sous forme de texte brut Conseil du pro 14/30 conseilpro_brut[_(nl,en,de)] Conseil du pro sous forme de texte brut entrenous[_(nl,en,de)] Champ «entre nous» entrenous_brut[_(nl,en,de)] petitplus[_(nl,en,de)] Champ «petit plus» petitplus_brut[_(nl,en,de)] suggestions[_(nl,en,de)] Champ «suggestions» suggestions_brut[_(nl,en,de)] comprend[_(nl,en,de)] Champ «comprend» comprend_brut[_(nl,en,de)] Champ «entre nous» sous forme de texte brut Champ «petit plus» sous forme de texte brut Champ «suggestions» sous forme de texte brut Champ «comprend» sous forme de texte brut necomprendpas[_(nl,en,de)] Champ «ne comprend pas» necomprendpas_brut[_(nl,en,de)] Champ «ne comprend pas» sous forme de texte brut encadrement[_(nl,en,de)] Champ «encadrement» encadrement_brut[_(nl,en,de)] capacite[_(nl,en,de)] capacite_brut[_(nl,en,de)] Champ «encadrement» sous forme de texte brut Capacité d'accueil Capacité d'accueil sous forme de texte brut tseminairess Chaque offre de type lieu de séminaire peut posséder des informations complémentaires représentées par une balise tseminaires . Les sous-balises possibles de tseminaires sont : descriptif_activites[_(nl,en,de)] des activités descriptif_activites_brut[_(nl,en,de)] descriptif_salles[_(nl,en,de)] descriptif_salles_brut[_(nl,en,de )] des activités sous forme de texte brut des salles des salles sous forme de texte brut tpoiss Chaque offre de type point d'intérêt peut posséder des informations complémentaires représentées par une balise tpois . Les sous-balises possibles de tpois sont : 15/30 type nom[_(nl,en,de)] id_ins ins localite commune lieuprecis[_(nl,en,de)] parc_naturel mdt description[_(nl,en,de)] description_brut[_(nl,en,de)] coord_lambert_x coord_lambert_y coord_geo_longitude coord_geo_latitude Type du point d'intérêt Nom de l'offre touristique Adresse de l'offre de l'offre de l'offre sous forme de texte brut Coordonnées Lambert Coordonnées de longitude et de latitude treloffres A chaque offre touristique peuvent être associées des offres représentées par des balises treloffre . Les sous-balises possibles de treloffre sont : libelle codecgt_destinataire Libelle de la relation Code CGT de l'offre liée trestaurantss Chaque offre de type randonnée peut posséder des informations complémentaires représentées par une balise trestaurants . Les sous-balises possibles de trestaurants sont : nb_couverts groupe_min Nombre de couverts dans le restaurant Groupe minimum accepté 16/30 groupe_max Groupe maximum accepté ttypesusagerss A chaque offre touristique peuvent être associées des types usagers représentés par des balises ttypesusagers . Les sous-balises possibles de ttypesusagers sont : type niveau_facile niveau_moyen niveau_difficile niveau_pratiquant_debutant niveau_pratiquant_confirme niveau_sportif duree cplt_info[_(nl,en,de)] cplt_info_brut[_(nl,en,de)] Type d'usager Flag indiquant si le niveau facile est coché Flag indiquant si le niveau moyen est coché Flag indiquant si le niveau difficile est coché Flag indiquant si le niveau pratiquant débutant est coché Flag indiquant si le niveau partiquant confirmé est coché Flag indiquant si le niveau sportif est coché Durée de parcours Complément d'informations Complément d'informations sous forme de texte brut tsalless A chaque offre de type lieu de séminaire peuvent être associées des salles représentées par des balises tsalles . Les sous-balises possibles de tsall
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x