1.0 Introduction
2.0 Modifications par rapport à la version précédente
3.0 Restrictions
3.1 Débogage et transformation XSL
4.0 Problèmes connus
4.1 L'ouverture de fichiers XML volumineux est susceptible d'entraîner une fermeture brutale du plan de travail
4.2 L'assistant XML vers SQL ne prend pas en charge les types BLOB, CLOB ni les types de données binaires
4.3 L'assistant XML vers SQL peut générer une exception SQL pour les formats de date ou d'heure non reconnus
4.4 Génération d'un schéma XML à partir d'une table de base de données
sur des machines en arabe ou en hébreu
4.5 Génération de la routine de test et de fichiers DAD pour DB2 XML Extender sur des machines DBCS
4.6 Génération d'un schéma XML à partir d'une table de base de données qui contient des caractères DBCS
4.7 Application d'une feuille de style XSL comportant une boucle infinie à un fichier XML
4.8 XML Les paramètres du catalogue XML ne sont pas reconnus dans le programme de lancement XSL éloigné
4.9 Génération de XSL pour un modèle XHTML sans utiliser l'option 'Extraire les données XML à partir de XHTML'
4.10 L'opération de rechargement n'a aucun effet dans les éditeurs RMX et XMX
4.11 Validation et URI non résolus
4.12 Incidents lors de l'utilisation de l'assistant du client Java Bean XML/XSL
si le bean comporte des méthodes contenant des noms de paramètre identiques
4.13 Problèmes de codage BiDi pouvant se produire lors de la génération d'un schéma XML ou d'un fichier DTD
4.14 Vue Sortie de transformation XSL vide lors du traçage d'une transformation XML éloignée
4.15 Création d'un espace nom lorsque vous renommez un espace nom dans un schéma XML
4.16 Problèmes d'affichage dans l'éditeur XML
4.17 Erreur d'outil externe lors de l'utilisation de l'assistant
de débogage et de transformation XSL ou création d'une signature numérique XML
4.18 Le débogueur XSL ignore l'indicateur Activé/Désactivé au niveau d'un point d'arrêt.
Les outils de l'environnement de développement XML suivants sont disponibles dans WebSphere Studio : éditeur XML, éditeur DTD, éditeur de schéma XML, éditeur XSL, outil de transformation et de débogage XSL, éditeur de mappage XML vers XML, éditeur de mappage RDB vers XML (génère des fichiers DAD pour DB2 XML Extender). WebSphere Studio offre également des bibliothèques de classes Java et des assistants pour stocker et extraire des données XML de n'importe quelle base de données JDBC, un support de sécurité XML, un assistant d'expressions XPath et de nombreux générateurs (notamment pour la génération XML DOM/XSL à partir d'un bean Java et la génération XSL/XML à partir d'un fichier XHTML).
Les améliorations suivantes ont été apportées à WebSphere Studio version 5.1 :
- De nouvelles options ont été ajoutées à l'assistant Création d'un fichier XML.
- La vue Graphique du schéma XML a été optimisée.
- Les fonctionnalités de l'outil de transformation et de débogage XSL ont été modifiées. Vous pouvez désormais exécuter séparément les opérations de transformation et débogage.
Si le chemin ou le nom des fichiers XML /XSL comporte des caractères non ASCII, le débogage et la transformation XSL peuvent ne pas fonctionner correctement.
Prenez garde lorsque vous ouvrez des fichiers volumineux à l'aide de l'un des éditeurs XML. Si vous dépassez la capacité mémoire du plan de travail, ce dernier se ferme sans sauvegarder les données (ni générer de message d'erreur ou d'avertissement). Le nombre d'éléments contenus dans un fichier XML, et non sa taille, est le meilleur indicateur de la capacité mémoire requise. Cette dernière dépend également des autres éléments ouverts dans le plan de travail ; s'il est parfois possible d'ouvrir un fichier de 15 Mo sans difficulté, il peut s'avérer impossible d'ouvrir un fichier de 1 Mo. Il est donc conseillé de sauvegarder toutes les données dans le plan de travail avant d'ouvrir des fichiers XML volumineux.
Remarque : Vous pouvez modifier la quantité maximale de mémoire allouée à WebSphere Studio. Pour plus d'informations, reportez-vous au fichier README du plan de travail.
L'assistant XML vers SQL ne met pas correctement à jour la table de base de données lorsque le type de colonne est binaire, BLOB ou CLOB. Cette restriction s'applique aux actions INSERT et UPDATE.
Lorsque vous mettez à jour une table de base de données dont les colonnes contiennent le type de données Date, Heure et Horodatage, l'assistant XML vers SQL ou les fichiers JAR xmltosql ou etsqltoxml peuvent générer une exception SQL si la chaîne indiquée dans le code source XML en entrée n'est pas acceptée par la base de données cible. Les formats de date et d'heure peuvent légèrement varier d'un produit à un autre. Vous pouvez utiliser le générateur de requêtes SQL pour déterminer les formats corrects de ces types.
Lors de la génération d'un fichier de schéma XML à partir d'une table de base de données, le message d'erreur indiquant une fin de fichier prématurée peut être généré dans le panneau Tâches, plus particulièrement sur les plateformes en arabe ou en hébreu.
Néanmoins, le fichier de schéma sera généré correctement. Régénérez le dossier de l'espace de travail cible puis ouvrez le fichier avec l'éditeur XSD.
Si vous générez les fichiers de routine de test sous Windows, les fichiers de commandes générés utilisent un retour chariot en tant que délimiteur de ligne et non un caractère CRLF. Ce qui fait que les fichiers peuvent ne pas s'exécuter correctement. Dans ce cas, insérez les délimiteurs de ligne manuellement à l'aide d'un éditeur de texte, tel NotePad.
Un fichier DAD doit être généré à l'aide du codage par défaut de la plateforme pour s'exécuter correctement. Pour cela, il suffit de sélectionner les valeurs de codage appropriées dans l'éditeur de préférences des fichiers XML.
Si vous générez un schéma XML à partir d'une table de base de données contenant des noms alphanumériques en pleine largeur (full-width alphabet and digit), des erreurs s'affichent dans la vue Tâches. Il est préférable de ne pas attribuer de noms comportant des caractères DBCS aux colonnes et aux tables de base de données.
Si la feuille de style XSL que vous appliquez à un fichier XML contient une boucle infinie, vous risquez de recevoir un message d'erreur similaire au message suivant :
Xalan dies with a java.lang.StackOverflowError,
most likely due to deep recursion.Vous devez corriger votre feuille de style avant d'exécuter à nouveau votre transformation. Si vous ne le faites pas, vous risquez de recevoir un message d'erreur différent car un échec de la mémoire peut se produire à des endroits différents sur la machine virtuelle. En cas d'échec, fermez WebSphere Studio, redémarrez-le et corrigez la feuille de style XSL pour nettoyer le système.
Lorsque vous appliquez un fichier XSL à un fichier XML contenant un fichier XSD ou DTD, les paramètres du catalogue XML sont appliqués si vous démarrez le programme de débogage XSL dans un processus XSL local.
Si votre fichier XSL appelle des beans Java externes et que vous devez lancer le programme de débogage XSL dans un processus XSL éloigné, les mappages d'URI en clés du catalogue XML ne sont pas appliqués et une erreur java.io.FileNotFound est générée.
Pour éviter cette erreur, modifiez le fichier XML de sorte que le fichier XSD ou DTD inclus puisse être localisé directement (sans passer par le catalogue XML).
Lorsque des données sont déjà stockées dans un fichier XML, appelez l'assistant de génération d'un fichier XSL pour un modèle XHTML sans l'option 'Extraire les données XML à partir de XHTML'.
En raison des restrictions actuelles, le fichier dataLogic généré par l'assistant doit être édité manuellement pour spécifier la logique des données spécifique au fichier XML faisant l'objet de la transformation. Des exemples de fichier dataLogic sont inclus dans l'exemple de projet 'XML from XSL and HTML'.
Si vous n'éditez pas manuellement le fichier de la logique des données, les fichiers XSL génèrent un squelette de fichier HTML ne contenant pas de données.
L'option de rechargement, qui apparaît à l'écran lorsque le contenu d'un fichier est modifié sur le disque, n'effectue aucune opération. Cette notion est importante pour le support coopératif. Dans le cas où l'utilisateur réserve un fichier et que le contenu de ce dernier est différent de celui de l'éditeur, l'éditeur invite l'utilisateur à effectuer un nouveau chargement, mais cette opération n'exécute aucune action. Dans ce cas, il convient de fermer la session RMX ou XMX et de la rouvrir pour éditer le fichier qui vient d'être réservé.
Lorsqu'il détecte un URI non résolu (dans une déclaration DOCTYPE, par exemple), l'analyseur XML signale une erreur d'E-S irrémédiable et arrête tous les processus. Un URI non résolu n'est pas considéré comme une erreur syntaxique ou sémantique et n'est donc pas pris en charge par l'analyseur. Le document n'est donc pas contrôlé.
Lorsque, dans l'assistant du client Java Bean XML/XSL, le bean comporte des méthodes contenant des noms de paramètre identiques, les zones générées dans le formulaire d'entrée possèdent également des noms identiques.
La solution consiste à renommer les paramètres de méthode de manière à ce que ceux qui servent à générer le bean ne portent pas les mêmes noms.
Lorsque vous générez un schéma DTD qui contient des caractères hébreux ou arabes à partir d'un fichier DTD ou générez un document DTD à partir schéma XML qui contient des caractères hébreux ou arabes, certains noms d'élément peuvent être codés avec leurs valeurs de codage arabes ou hébreux hexadécimales équivalentes. Pour éviter ce problème, modifiez l'attribut de codage du fichier de schéma XML ou du fichier DTD correspondant en UTF-8 avant d'effectuer la génération. La déclaration XML doit donc être :
<?xml version="1.0" encoding="UTF-8"?>
La liste des valeurs de codage concernées est la suivante :
- ISO-8859-8-I
- ISO-8859-8
- Windows-1256
- ISO-8859-6
La vue Sortie de transformation XSL de la perspective Débogage XSL n'affiche pas les données générées lorsque vous effectuez le traçage d'une transformation XSL lancée sur une application éloignée.
Si vous modifiez l'espace nom cible dans un schéma XML, le programme crée un espace avec le préfixe Q1. Pour éviter cette erreur, placez d'abord les éléments et les types globaux au début du document (avant qu'ils ne soient référencés). Modifiez ensuite l'espace nom cible.
Des problèmes d'affichage ou de régénération peuvent apparaître dans l'éditeur XML.
Si vous utilisez l'assistant de débogage et de transformation XSL sous Linux et que vous sélectionnez l'option Application XSL distante dans la page Sélection d'un programme de lancement XSL, il est possible qu'une erreur javaw soit générée.
De la même façon, si vous tentez de créer une signature numérique XML, une erreur d'outil de gestion des clés.
Pour éviter ces erreurs, vous devez ajouter un chemin à JAVA_HOME\bin dans la variable d'environnement PATH. Ce chemin provient du module JRE par défaut indiqué dans Fenêtres > Préférences > Préférences JRE installées, par exemple : répertoire_installation_WS\eclipse\jre\bin).
Vous pouvez sélectionner Activer le point d'arrêt et Désactiver le point d'arrêt à partir du menu en incrustation de l'éditeur XSL. Toutefois, le débogueur ignore l'indicateur Activé/Désactivé au niveau d'un point d'arrêt.
Retour au fichier Readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.