Le web et mobile
De Base de Connaissance SITRA.
On entend par site internet tout projet de diffusion numérique utilisant des flux XML : sites internet, applications et sites mobiles, chaines de diffusion, bornes tactiles, panneaux d’information…
Pré-requis pour la réalisation de votre projet
Contacter votre animateur départemental pour lui exposer votre projet.
- Réaliser un cahier des charges détaillé.
- Demander la documentation technique des exports Sitra (Webservices et exports XML).
- Demander l’ouverture un compte Hotline auprès de votre animateur départemental.
Ce qu’il faut savoir
Pour accéder aux fonctionnalités de paramétrages web de Sitra il est nécessaire d’avoir le profil de webmaster.
Quel mode d’alimentation choisir ?
2 scénarii sont possibles :
Par le biais d'export XML
Le membre Sitra paramètre des exports sur serveur FTP. Il choisit les langues exportées, mais aussi les fréquences (tous les mois, toutes les semaines ou toutes les nuits).
Le prestataire peut appeler une URL lors de la fin de l'export, ce qui est fortement recommandé car les exports ne finissent jamais à heure fixe. Cela permet de garantir la synchronisation quotidienne des données à chaque export. Généralement, cela nécessite une réplication de base de données en local, c'est donc plus lourd à gérer (suivi des critères entre autre), mais beaucoup plus rapide.
Par le biais d'accès WebService
Les fréquences d’appel du webservice peuvent se faire en temps réel. Le prestataire doit donc créer des requêtes pour obtenir directement l'information en XML. Les avantages sont la légèreté du système, la fraicheur des informations. Cependant, cette solution reste tributaire du serveur, c'est-à-dire qu'il est impératif de créer un système de cache, qui est susceptible de subir des ralentissements (trop de requêtes) ou encore des coupures. -> Le webservice possède 2 niveaux de sécurité : Une clé de fonctionnement mais aussi une identification des IP.
Pour vous aider à choisir, les points essentiels sont exposés ici : Exports ou Web Services ?
Le choix du type de récupération des données de SITRA est très important au départ d’un projet et comme expliqué dans la Documentation technique,les deux méthodes ont leurs avantages :
- Les exports XML se font en différentiel, ce qui est un avantage. Ils nécessitent moins de traitement par le prestataire et rendent l’application web du client beaucoup plus autonome. En effet une erreur sur les exports d’une journée rend uniquement l’information affichée plus vieille de 24h (ce qui souvent n’a que peu d’impact).
- Les Web Services permettent un accès en temps réel à une information parfaitement à jour. Contrairement à l’export XML qui se planifie (chaque nuit dans la plupart des cas) créant un décalage pouvant aller jusqu'à 24h entre l’information restituée à l’utilisateur de l’application web et l’information de SITRA.
- Les Web Services ne sont pas prévus pour être utilisés seuls (sans stockage en base de données). Exception faite d’applications très légères type Widget. Un site construit uniquement sur des appels aux Web Services deviendra trop dépendant de ce dernier et ne pourra pas mettre en place des traitements complexes.
- Il est tout à fait possible de combiner les deux méthodes dans le cas d’une application web complexe. Hélas la syntaxe des flux XML des deux méthodes étant légèrement différentes cela oblige à des développements supplémentaires.
Quelques bonne pratiques peuvent être mises en avant afin d’utiliser au mieux les Web Services :
- Apparemment utilisé par une grande majorité des agences l’utilisation des sélections est primordiale pour une utilisation optimale du service. Etant pré-calculées elles permettent un gain très important et peuvent être utilisées pour une grande majorité de fonctionnalités.
- Certaine options du Web Service peuvent être très utiles afin de ne pas remonter bon nombre d’informations inutiles. Les combinaisons de sortie de la fonction « DetailObt » par exemple ainsi que les type de sortie des recherches.
- Plusieurs astuces peuvent permettre d’éviter des appels récurrents lorsque l’on a déjà l’information : utilisation du cache, AJAX, …
Critères et références (comment on y accède, à quoi cela sert ?)
La donnée touristique dans SITRA est organisée par le biais de critères. Ces critères permettent de hiérarchiser cette donnée.
Par exemple, le premier niveau est le niveau "Type Objet" (Hébergement, Hôtel, Restaurant...).
Le second niveau réorganise les types par rapport au premier niveau. Par exemple, sur le type objet "Hébergement locatif", on retrouve "Chambres d'hôtes" ou encore "Meublés et Gîtes"...
D'autres critères permettent encore de créer d'autres niveaux.
Enfin, des critères permettent simplement d'enrichir la donnée (par exemple, si l'hôtel possède la TV, la clim, un minibar, douche, baignoire...) Ces derniers critères permettent en général de créer des filtres de recherche, de s’afficher sous forme de pictos ou en texte, au sein des sites Internet…
La liste des critères peut être exportée à partir du module « paramétrages web » (fichier csv complet de toutes les références, attention le fichier peut mettre plusieurs minutes à se télécharger.)
Il est également possible d’exporter la liste des critères par type objet depuis le module « gestion » : modèle simple (sans les codes des critères) ou détaillé.
Comment créer un site internet dans SITRA ?
Demandez à votre animateur départemental de déclarer un site Internet dans SITRA et d’affecter le profil webmaster à l’admin local du membre. L’admin local peut affecter le profil webmaster aux autres utilisateurs. Il est recommandé de créer un compte utilisateur (avec le profil personnel accueil et webmaster) pour le prestataire afin qu’il puisse accéder aux paramétrages du site.
Une fois le site créé, le membre peut le retrouver dans son module « paramétrages web » (Raccourci clavier F3).
Présentation du module paramétrages web.
Accès
On accède au module des exports web en cliquant sur « paramétrages web » dans la barre de module, ou par le raccourci clavier « F3 ».
Paramétrage
On y renseigne les paramètres FTP donnés par le prestataire du site Internet, à savoir le serveur (par ip ou par nom de domaine), le chemin (si aucun, il faut indiquer « / »), le nom d’utilisateur et le mot de passe.
On indique ensuite les fréquences d’export. Plusieurs choix sont possibles :
- Jamais
- Tous les mois
- Toutes les semaines
- Toutes les nuits
Il est conseillé de choisir « toutes les nuits » si l’on souhaite afficher des informations mise à jour fréquemment (telles les fêtes et manifestations).
On coche ensuite le choix des langues exportées. Il faut cocher au moins une langue.
Enfin, on indique des paramètres complémentaires. On coche si l’on souhaite un export de fichier XML, en complétant si les exports s’effectuent tous dans un seul et même fichier XML, ou bien si un fichier XML est créé par objet exporté. On indique (optionnel) une URL, donnée par votre prestataire, pour confirmer la fin des exports (ne pas hésiter à en parler au prestataire, car les exports peuvent se réaliser de 22h à 6h). Cocher « Exporter les images principales » si l’on souhaite les exporter. Celles-ci se retrouveront dans un fichier ZIP, exporté en même temps.
Il existe une possibilité de compresser les fichiers exportés. Cette option est à prendre en compte si on exporte un fichier XML par objet. Se renseigner auprès du prestataire.
Comment sélectionner les infos à envoyer sur son site ?
Deux possibilités pour envoyer des infos sur son site : les filtres et le marquage de fiches.
Les filtres web : back office du site internet
A savoir :
Un filtre est une requête (recherche) mémorisée.
Créer un filtre
Exemple : Les hôtels (type objet) + Pays Rochois (localisation / périmètre géographique) + accepte les chèques vacances (tarif / moyens de paiement).
Si le résultat nous convient, on peut enregistrer la requête en cliquant sur « définir comme filtre web ». Si l’on se trouve dans la recherche avancée, il faut auparavant cliquer sur « Retour aux critères ».
Une fois la requête effectuée dans le module recherche, cliquez en bas à droite de votre écran sur « définir comme filtre web » en recherche avancée.
Et en bas à gauche en recherche simple.
Lors du clic sur « définir comme filtre web » une pop up permet de sélectionner vers quel site vous voulez envoyer ce filtre et de nommer la requête. Nous avons également la possibilité de remplacer un filtre existant.
Attention de nommer les filtres correctement pour se souvenir facilement de leur fonctionnement ! L’avantage du filtre c’est qu’il va relancer à la fréquence demandée la requête et donc mettre à jour votre site au gré de vos suppressions, modifications et créations.
A l’opposé, le marquage ne fera qu’actualiser vos fiches mais n’ajoutera pas de nouveaux objets puisqu’il s’agit d’une opération manuelle et ponctuelle.
Créer un filtre avec un critère interne
Exemple : pour gérer les notions d’adhérents, les prestataires partenaires de la carte d’hôtes ou différentes filières crées (GTA, écotourisme, villages de caractères…) il faut créer et affecter un critère interne afin de retrouver les fiches concernées. Le filtre web sera ensuite basé sur ce critère interne.
Où trouver les filtres et les modifier ?
Les filtres web sont enregistrés dans le module paramétrages web (onglet filtres).
Voir le contenu d’un filtre
Pour rouvrir un filtre cliquer sur « visualiser ».
Marquage
A savoir
Le marquage doit être utilisé ponctuellement pour une fiche isolée ou ne répondant pas à des critères de recherche. Il ne faut généralement pas dépasser une vingtaine d’objets par site.
Par exemple, si l’on recherche tous les trains touristiques sur Chamonix nous obtenons deux résultats, or nous souhaitons récupérer uniquement le train de la Mer de glace et pas tous les trains touristiques de Chamonix, il est donc nécessaire de faire un marquage sur cette fiche.
Le marquage ne doit pas être utilisé pour marquer autant de fiches touristiques qu’une recherche peut afficher, car :
- Le marquage ne retient pas la requête mais le résultat. Si une nouvelle fiche est créée, elle ne sera pas marquée, contrairement au filtre web
- Le marquage alourdit l’export et le traitement. Il est beaucoup plus simple d’utiliser toutes les fiches appartenant à plusieurs critères qu’utiliser les fiches marquées une à une
Comment marquer un objet
Pour marquer une fiche, cela peut se réaliser dans la recherche simple, avancée, mais aussi en gestion. Lorsque l’on trouve la ou les fiches à marquer, on clique sur la case à cocher pour la ou les sélectionner, puis on les exporte vers le site Web (dans les recherches, on clique sur « exporter » puis « vers site Web ». Dans la gestion, on clique sur « Autres actions » puis sur « exporter vers Site Web »).
Où trouver les fiches marquées
Les fiches marquées se regroupent toutes ensemble dans l’onglet « marquage ». Si l’on possède trop de fiches marquées, l’information sera noyée dans la masse, et difficile à gérer.
Les sélections
A savoir
Les sélections ont été créées à la demande des agences web afin de faciliter la récupération des données car une fois sur leur serveur, tous les objets sont à nouveau mélangés et il faut à nouveau faire des requêtes pour définir quelle fiche doit aller sur quelle page du site.
C’est la garantie d’être autonome sur la gestion du contenu de son site.
Il est impératif d’utiliser les sélections pour son projet web.
Lors de l’export 4 dossiers importants sont envoyés visibles sur le rapport d’export (onglet rapport) : DEL ListeOI … (contient les références des objets supprimés ou masqués) ImagesOI…(contient les références de certains multimédias. Subtilités expliquées dans la doc technique) ListecomplèteOI…(contient les références de tous les objets créés et mis à jour) Sélections (contient toutes les sélections et liste pour chacune d'elle, les objets qu'elles comportent)
Votre agence devra automatiser le traitement des 3 premiers dossiers
Les sélections web sont formées par un ou plusieurs filtres web, et/ou une ou des fiches marquées.
Une sélection comporte un numéro unique : il sera à fournir au prestataire, et lui servira à alimenter une rubrique précise du site.
Comment créer une sélection
On clique sur le bouton « ajouter une sélection ». A chaque nouvelle sélection, une nouvelle ligne s’ajoute dans le tableau.
Ce tableau comporte de plusieurs colonnes. La première permet de donner un nom, en plus du numéro de sélection (cela permet une lecture plus facile des sélections). Il est aussi possible, en cliquant sur la loupe à côté du nom de vérifier quels sont les objets exportés pour la sélection choisie. C’est grâce à cet outil que l’on peut vérifier si notre sélection est bien paramétrée.
En cas de problème d’affichage de résultat sur le site Internet :
1 - contrôler si le nombre de fiches exportées correspond bien au nombre de fiches visibles sur le site internet. En cas de différence, modifier la sélection. La correction sera effective le lendemain sur le site.
2 - Contrôler dans le rapport si l’export s’est bien déroulé (nombre de fiches exportées, dates d’export…)
3 – si côté Sitra tout est ok, demandez au prestataire d’identifier le problème. (Le prestataire peut contacter éventuellement la hotline).
Dans la seconde colonne, on affecte 0, 1 ou plusieurs filtres web enregistrés, en cliquant sur « modifier les filtres de la sélection ». On coche ou on décoche ensuite le ou les filtres dans la nouvelle fenêtre.
Dans la troisième colonne, on affecte 0, 1 ou plusieurs objets marqués auparavant, en cliquant sur « modifier les objets marqués de la sélection ». On coche ou on décoche ensuite le ou les objets dans la nouvelle fenêtre.
Lorsqu’une sélection n’est plus utilisée, on peut :
- La renommer, et y affecter de nouveaux filtres ou de nouveaux objets marqués (recyclage)
- La supprimer, en cliquant sur le petit « moins » à la fin de la ligne.
Les rapports
Les rapports d’export sont stockés pendant plusieurs jours sous forme texte. Cela permet de retrouver les erreurs, dans le cas où les exports n’aient pas été correctement effectués.
