Les Flux SITRA

Flux Sortants

Flux Entrants

1

Sommaire

• Comment récupérer des données de SITRA ?

– Sélectionner les données dans SITRA

– Les solutions techniques à disposition

– Les différents usages

• Les Exports XML SITRA

• Les WebServices SITRA

• Comment importer des données dans SITRA ?

2

Les sélections

3

Comment sélectionner des données

dans SITRA ?

• Marquer des objets permet de sélectionner

unitairement des objets

Exemple : Hôtel des 3 Canards à Valence

• Créer un filtre permet de définir des critères de

recherche

Exemple : Les hôtels 3* en Ardèche acceptant les

animaux

4

Les sélections

Une sélection =

1 ensemble d’objets marqués

+

1 ensemble d’objets répondant à des filtres

Exemple : Sélection « Coups de Cœur » :• les « fêtes et manifestations » sur ma commune qui se

déroulent aujourd’hui

• une « activité culturelle» que je souhaite mettre en avant.

5

Intérêt des sélections

Créer des regroupements de données pilotées

dans SITRA

Exemple : Sélection « Coups de Cœur » :• Côté Site Web on affiche en page d’accueil une sélection

• Côté SITRA, c’est l’office de tourisme qui gère cette sélection

6

Les solutions techniques

• Les exports XML

• Les WebServices

• Les Exports csv (besoins très ponctuels)

7

Exports XML / WebServices : quels

usages ?

8

Les Exports XML Les WebServices

Vous disposez déjà d’un CMS et/ou d’une Base de Données

Développement rapide : pas besoin de créer une Base de Données ni module d’import

Besoins assez complexes en terme de requêtes

Manipulation de petits flux de données

Besoins complexes en terme de tris Besoin simple en terme de requêtes et de tris

Besoin d’enrichir l’info provenant de SITRA

Connaissance en XML indispensable Connaissance en WebServices + XML indispensables

Les préconisations

9

Utilisation des WebServices pour appel en direct et petit flux de données

Pour des traitement de masse, utilisation des Exports XML

Pour ceux qui utilisent les exports XML, ne rien changer car la grammaire des WebServices est différente (nouvelle grammaire à appréhender)

Pour WebServices (appliquer règles de programmation propres aux WS : cache, gestion timeout). Par exemple pour le détail d’un objet, le mettre en cache .

Les exports XML SITRA

10

Principes des exports XML SITRA

En place depuis lancement SITRA en 2005

Basés sur TourInfrance 3.1 + adaptations SITRA

Format d’échange riche et relativement verbeux

Envoi en mode différentiel

Compatibilité ascendante du XML (ajout de

nouvelles balises mais pas de modifications des

balises existantes)

11

Paramétrage des exports XML

12

Formatage des envois

+ indication

de fin

Fréquence

Les languesVotre

serveur FTP

Serveur

Site Web

Traitement différentiel (par rapport au

dernier envoi)

les objets modifiés, créés ou

répondant pour la 1ère fois à un filtre

les objets supprimés ou sortis d’un

filtres ou démarqués

•Les images principales (option)

•1 fichier avec tous les objets ou 1fichier /

objet

•Les fichiers zippés (option)

XML , flux

complet

ZIP

13

Traitement

Exports Web

la nuit à

partir de 22H

Sitra

Paramétrage

des exports

dans SITRA

Si KO envoi

d’un mail

Si OK appel

d’une URL sur

le site client

Envoi FTP

• 1 fichier DEL

• 1 fichier ListeOI ou

des fichier FichierOI

• 1 fichier Selection

multimédias

stockés

pendant 48H

Les infos / aide à votre disposition

• Une documentation en ligne

http://195.101.57.102/Documentation/Exports

XML

• Une hotline technique accessible après

demande de login / mot de passe auprès de

Rhône Alpes Tourisme et des animateurs Sitra

(Mantis)

14

Les WebServices SITRA

15

Principes des WebServices

SITRA• WebServices SOAP / HTTP-GET

• Les données sont mises à jour en temps réel

• Compatibilité ascendante assurée

• Flux plus simple que les exports XML

• Les médias doivent être récupérés et stockés sur le serveur des prestataires

• Modèle économique non encore posé (basé sur le nombre d’appels, volume flux renvoyé)

16

Les WebServices XML

• Si utilisation des sélections : paramétrer

la fréquence dans SITRA

17

Fréquence

Hébergement

site web

Appel

SOAP ou

HTTP-GET

Sitra Web

Service

Synchronisation des

sélections pour les créations et

modifications (selon

paramétrage exports )

Les données sont mises à jour

en quasi temps réel

IP autorisées

Les Webméthodes

• DetailObjets : renvoie le flux d’un ou plusieurs objets (flux complet ou partiel)

• RechObtsListeID et RechObtsListeIDHttpGet : renvoie une liste d’identifiants.

• RechObts et RechObtsHttpGet : renvoie le flux des objets en fonction de TypeSortie + CodeRestitution choisis.

• RechObtsSelection : renvoie le flux des objets d’une ou plusieurs sélections

19

Les infos / aide à votre disposition

• Une documentation en ligne

http://195.101.57.102/Documentation/WebServi

ces_V2/

• Des formulaires pour tester les méthodes des

WebServices et consulter les flux de retour

• Une hotline technique accessible après demande

de login / mot de passe auprès de Rhône Alpes

Tourisme et des animateurs Sitra (Mantis)

20

Comment importer des

données dans SITRA ?

21

Les imports dans SITRA

• L’import csv (ponctuel) : documentation +

exemples sous répertoire SITRA

(modele\import\excel)

• L’import XML : documentation + exemples

sous répertoire SITRA (modele\import\xml).

Bientôt disponible en ligne

22

Différences imports XML / imports csv

23

Imports XML Imports csv

Imports automatisés (fréquence,…) Imports manuels via SITRA

Mode Annule et Remplace : écrase la version de l’objet présente dans SITRA

Via les modèles d’imports, possibilité de ne modifier que certaines informations d’un objet (exemple : que les tarifs)

Les structures doivent également être importées

Possible d’utiliser des structures déjà présentes dans SITRA

Modèles d’import XML proches des exports XML (même grammaire)

Questions ?

24