Tourinsoft v5 – Syndication Dé véloppémént én PHP

Tourinsoft v5 – Syndication
Dévéloppémént én PHP
Objectif du document
Ce document présente l’utilisation du framework PHP Tourinsoft Syndication afin d’intégrer les données des offres dans des pages web. Pour
une présentation de Tourinsoft, des syndications Tourinsoft ou du protocole OData, se référer au document Tourinsoft v5 – Documentation –
Syndication.pdf
Prérequis
Le présent document nécessite des connaissances en développement PHP, Web Services et environnement serveur PHP.
Il est également nécessaire d’avoir un accès Internet, un serveur Web avec PHP installé, configuré et en état de fonctionnement. Nous
conseillons l’utilisation de WampServer sous Windows pour obtenir un environnement opérationnel rapidement. (http://wampserver.com)
Nous conseillons également l’installation du plugin XML Viewer sur Google Chrome afin de visualiser et formater le code XML récupéré des
appels de syndication.
Contenu du framework
Le framework PHP Tourinsoft Syndication contient 2 fichiers permettant de récupérer les enregistrements des offres avec 2 lignes de code. Ce
framework est compatible avec les formats XML et JSON.
TISSyndication.php : Framework permettant d’effectuer les appels OData, de construire les tableaux de données et de faire le mapping
générique des champs de la syndication.
TISExempleUtilisation.php : Fichier d’exemples d’utilisation du framework avec plusieurs URLs OData complexes.
Installation et configuration
1.
2.
Récupérez les fichiers PHP du framework, ‘TISSyndication.php’ et ‘TISExempleUtilisation.php’, créés par la société Faire-Savoir et placez les
dans votre bibliothèque PHP (ou ajoutez le chemin vers ces fichiers dans votre variable d’environnement PATH ou include_path).
Affichez la page ‘TISExempleUtilisation.php’ sur votre serveur PHP pour vérifier le bon fonctionnement. Si vous obtenez, après environ 10 à
20 secondes, une page affichant des exemples d’utilisation et des listings de données, l’installation et la configuration du framework sont
terminées.
Fonctionnement du framework
Le protocole OData permet d’effectuer des filtres sur les données directement dans l’URL de navigation et de retourner un fichier XML (ou JSON)
de données. Le framework PHP Tourinsoft Syndication permet de simplifier à l’extrême les appels OData et de formater le fichier récupéré pour
le transformer en un tableau d’enregistrements d’objets génériques. Il ne reste plus aux développeurs qu’à sélectionner les bonnes URLs et
parcourir le tableau de données et les champs de la syndication.
Prenons un exemple avec la syndication suivante : http://wcf.tourinsoft.com/Syndication/anmsm/817bee9d-faf4-4680-9d05-e41c2c90ae5a/
Celle-ci retourne un fichier XML avec la liste des offres de la syndication (aucun critère ajouté dans l’URL de syndication).
L’appel suivant permet de récupérer puis d’afficher le nom de la première offre de la syndication. (NomOffre est un champ de la syndication).
$tisResult = TISResult::getResult(http://wcf.tourinsoft.com/Syndication/anmsm/817bee9d-faf4-4680-9d05-e41c2c90ae5a/);
echo “Nom de l’offre : ” . $tisResult[0]->NomOffre;