Par défaut, le service de données REST d'eXtreme Scale crée des flux ATOM lorsqu'il utilise un navigateur Web.
Le format des flux ATOM risque de ne pas être compatible avec les navigateurs plus anciens. Il y a également le risque d'une mauvaise interprétation des données
qui ne seront pas affichées comme des données XML. Vous pouvez configurer Internet Explorer Version 8 et Firefox Version 3 pour afficher les flux ATOM et les données XML dans le navigateur.
Pourquoi et quand exécuter cette tâche
Par défaut, le service de données REST d'
eXtreme Scale crée des flux ATOM lorsqu'il utilise un navigateur Web.
Le format des flux ATOM risque de
ne pas être compatible avec les autres navigateurs ou d'être interprété de
sorte que les données ne puissent pas être consultées comme des données XML. Pour les anciens navigateurs, vous serez invité à sauvegarder les fichiers sur
le disque. Une fois que les fichiers ont été téléchargés, utilisez votre
lecteur XML favori pour consulter les fichiers. Le XML généré n'étant pas formaté pour être affiché, tout est imprimé sur une seule ligne. La plupart des programmes de lecture XML, tels qu'Eclipse, prennent en charge le reformatage du XML dans un format lisible.
Pour les navigateurs modernes, tels que Microsoft Internet Explorer
Version 8 et Firefox Version 3, les fichiers XML ATOM peuvent être affichés de manière native dans le navigateur. Les rubriques ci-après fournissent des détails
sur la manière de configurer Internet Explorer Version 8 et Firefox Version
3 pour afficher les flux ATOM et le XML dans le navigateur.
Procédure
Configuration d'Internet Explorer Version
8
- Pour permettre à Internet Explorer de lire les flux ATOM que le service de données REST génère, procédez comme suit :
- Cliquez sur
- Sélectionnez l'onglet Contenu
- Cliquez sur le bouton Paramètres de la section Flux et composants Web Slice
- Désélectionnez la case "Activer le mode Lecture du flux"
- Cliquez sur OK pour retourner au navigateur.
- Redémarrez Internet Explorer.
Configuration de Firefox Version 3
- Firefox n'affiche pas automatiquement les pages avec le type de contenu suivant : application/atom+xml. La première fois qu'une page est affichée, Firefox vous invite à sauvegarder le fichier. Pour afficher la page, ouvrez le fichier avec Firefox, comme suit :
- Dans la boîte de dialogue de sélection de l'application, sélectionnez le bouton d'option
"Ouvrir avec" et cliquez sur le bouton Parcourir.
- Accédez au répertoire d'installation de Firefox.
Par
exemple : C:\Program Files\Mozilla Firefox
- Sélectionnez firefox.exe, puis cliquez sur
le bouton OK.
- Cochez la case "Toujours utiliser ce programme pour ouvrir ce type de fichier".
- Cliquez sur le bouton OK.
- Firefox affiche ensuite la page XML ATOM dans une nouvelle fenêtre ou page de navigateur
- Firefox affiche automatiquement les flux ATOM dans un format lisible.
Toutefois, les flux créés par le service de données REST incluent XML.
Firefox ne peut pas afficher le XML à moins que vous ne désactiviez le présentateur de flux.
Contrairement à Internet Explorer, dans Firefox, le plug-in d'affichage des flux ATOM doit être édité de manière explicite. Pour configurer Firefox afin qu'il puisse lire les flux ATOM comme des fichiers
XML, procédez comme suit :
- Ouvrez le fichier suivant dans un éditeur de texte : <firefoxInstallRoot>\components\FeedConverter.js.
Dans le chemin d'accès, <firefoxInstallRoot> correspond au répertoire principal dans lequel Firefox est installé.
Pour les systèmes d'exploitation Windows, le répertoire par défaut est le suivant : C:\Program Files\Mozilla Firefox.
- Recherchez le fragment de code similaire au suivant :
// montre la page de flux si elle n'a pas été reniflée et que nous avons un document,
// ou un document, un titre et un lien ou un ID
if (result.doc && (!this._sniffed ||
(result.doc.title && (result.doc.link || result.doc.id)))) {
- Placez les deux lignes commençant par if et
result en commentaire, en les précédant de deux barres
obliques (//).
- Ajoutez l'instruction suivante au fragment de code : if(0) {.
- Le texte résultant doit ressembler au suivant :
// montre la page de flux si elle n'a pas été reniflée et que nous avons un document,
// ou un document, un titre et un lien ou un ID
//if (result.doc && (!this._sniffed ||
// (result.doc.title && (result.doc.link || result.doc.id)))) {
if(0) {
- Enregistrez le fichier.
- Redémarrez Firefox
- Firefox peut maintenant afficher automatiquement tous les flux dans le navigateur.
- Testez votre configuration en essayant quelques URL.
Exemple
Cette section décrit certains exemples d'URL qui peuvent être utilisés pour afficher les données qui ont été ajoutées par l'exemple d'initiation fourni avec le service de données REST. Avant d'utiliser les URL suivantes, ajoutez le fichier par défaut à l'exemple de grille de données eXtreme Scale en utilisant l'exemple de client Java ou l'exemple de client Visual Studio WCF Data.
Dans les exemples qui suivent, l'on part du principe que le port utilisé est le 8080, mais cela peut varier. Reportez-vous à la section pour des explications détaillées sur la manière de configurer le service de données REST sur différents serveurs d'applications.
- Visualiser un seul client dont l'ID est "ACME" :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('ACME')
- Visualiser toutes les commandes du client "ACME" :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('ACME')/orders
- Visualiser le client "ACME" et les commandes :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Customer('ACME')?$expand=orders
- Visualiser la commande 1000 du client "ACME" :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/Order(orderId=1000,customer_customerId='ACME')
- Visualiser la commande 1000 du client "ACME" et le Customer qui lui est associé :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/
Order(orderId=1000,customer_customerId='ACME')?$expand=customer
- Visualiser la commande 1000 du client "ACME" et le Customer et les OrderDetails associés à ce client :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/
Order(orderId=1000,customer_customerId='ACME')?$expand=customer,orderDetails
- Visualiser toutes les commandes du client "ACME" pour le mois d'octobre 2009 (GMT) :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/
Customer(customerId='ACME')/orders?$filter=orderDate
ge datetime'2009-10-01T00:00:00'
and orderDate lt datetime'2009-11-01T00:00:00'
- Visualiser les trois premières commandes et les trois premiers orderDetails du client "ACME"
pour le mois d'octobre 2009 (GMT) :
http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/
Customer(customerId='ACME')/orders?$filter=orderDate
ge datetime'2009-10-01T00:00:00'
and orderDate lt datetime'2009-11-01T00:00:00'
&$orderby=orderDate&$top=3&$expand=orderDetails