Outils XML - Notes sur l'édition

1.0 Introduction
2.0 Modifications par rapport à la version précédente
3.0 Limitations
   3.1 Transformation et débogage XSL
4.0 Problèmes connus
   4.1 L'ouverture de fichiers XML volumineux peut provoquer la fermeture brutale du plan de travail
   4.2 XML vers SQL ne prend pas en charge les types de données BLOB, CLOB et Binary
   4.3 XML vers SQL peut émettre une SQLException pour des formats de date ou d'heure inappropriés
   4.4 Génération d'un schéma XML à partir d'une table de base de données contenant des caractères machines
   4.5 Génération d'une routine de test et de fichiers DAD pour DB2 XML Extender sur les machines DBCS
   4.6 Génération d'un schéma XML à partir d'une table de base de données contenant des caractères DBCS
   4.7 Application d'une feuille de style XSL avec une boucle infinie à un fichier XML
   4.8 Les paramètres de catalogue XML ne sont pas reconnus dans le programme de lancement XSL à distance
   4.9 Génération d'XSL pour un modèle XHTML sans utiliser l'option "Extraire les données XML à partir de XHTML"
   4.10 Le rechargement n'a aucun effet dans les éditeurs RMX et XMX
   4.11 Validation et identificateurs URI non résolus
   4.12 Problèmes d'utilisation de l'assistant de client XML/XSL de bean Java si le bean possède des méthodes avec les mêmes noms de paramètres
   4.13 Problèmes de codage bidirectionnel possibles lors de la génération d'un fichier de schéma XML ou de DTD
   4.14 Vue de sortie XSL vide lors du traçage d'une transformation XML distante
   4.15 Le changement de nom d'un espace de nom dans un schéma XML crée un nouvel espace nom
   4.16 Le programme de débogage XSL ignore l'indicateur Activé/Désactivé sur un point d'arrêt.

1.0 Introduction

Les outils d'environnement de développement XML suivants sont disponibles dans WebSphere Studio : éditeur XML, éditeur de DTD, éditeur de schéma XML, éditeur XSL, outil de débogage et de transformation XSL, éditeur de mappage XML vers XML, et éditeur de mappage RDB vers XML (que vous pouvez utiliser pour générer des fichiers DAD pour le DB2 XML Extender). WebSphere Studio inclut également des bibliothèques de classes Java et des assistants de stockage et d'extraction de données XML à partir de n'importe quelles bases de données JDBC, la prise en charge de la sécurité XML, un assistant d'expression XPath et de nombreux générateurs (tels que la génération XML DOM/XSL à partir d'un bean Java et la génération XSL/XML à partir du fichier XHTML).

2.0 Différences par rapport à l'édition précédente

Les améliorations suivantes ont été apportées dans WebSphere Studio version 5.1 :

3.0 Limitations

3.1 Transformation et débogage XSL

Si le chemin d'accès ou le nom de fichier des fichiers XML/XSL contiennent des caractères non ascii, le débogage et la transformation XSL peuvent ne pas fonctionner correctement.

4.0 Problèmes connus

4.1 L'ouverture de fichiers XML volumineux peut provoquer la fermeture brutale du plan de travail

Prenez garde lorsque vous ouvrez des fichiers de grande taille à 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 de grande taille.

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 (Workbench).

4.2 XML vers SQL ne prend pas en charge les types de données BLOB, CLOB et Binary

XML vers SQL ne met pas à jour la table de base de données correctement lorsque le type de colonne est Binary, BLOB ou CLOB. Ce problème concerne les actions INSERT et UPDATE.

4.3 XML vers SQL peut émettre une SQLException pour des formats de date ou d'heure inappropriés

Lors de la mise à jour d'une table de base de données contenant des colonnes avec le type de données Date, Time ou Timestamp, l'assistant XML vers SQL ou les fichiers JARxmltosql et sqltoxml peuvent émettre une SQLException si la valeur de la chaîne dans la source XML d'entrée n'est pas acceptée par le produit de base de données cible. Les formats de date et d'heure varient légèrement d'un produit à l'autre. Vous pouvez utiliser le générateur de requêtes SQL pour déterminer les formats corrects de ces types.

4.4 Génération d'un schéma XML à partir d'une table de base de données contenant des caractères machines

Lors de la génération d'un fichier schéma XML à partir d'une table de base de données, le message d'erreur suivant peut être généré dans la sous-fenêtre Tâches, particulièrement sur les plateformes utilisant les langues arabe et hébreu : "Fin de fichier prématurée".

Le fichier schéma est toutefois généré correctement. Régénérez le dossier de l'espace de travail cible que vous avez spécifié, puis ouvrez le fichier à l'aide de l'éditeur XSD.

4.5 Génération d'une routine de test et de fichiers DAD pour DB2 XML Extender sur les machines DBCS

Si vous générez les fichiers de routine de test sous Windows, les fichiers de commandes générés utilisent CR comme délimiteur de ligne alors qu'ils devraient utiliser CRLF. Par conséquent, les fichiers ne peuvent pas s'exécuter correctement. Si c'est le cas, insérez les délimiteurs de ligne manuellement à l'aide d'un éditeur de texte tel que NotePad.

Notez également qu'un fichier DAD doit être généré dans le codage par défaut de la plateforme pour s'exécuter correctement. Pour ce faire, sélectionnez la valeur de codage appropriée dans l'éditeur de préférences de fichiers XML.

4.6 Génération d'un schéma XML à partir d'une table de base de données contenant des caractères DBCS

Si vous générez un schéma XML à partir d'une table de base de données contenant des noms alphabétiques et numériques pleine largeur, des erreurs seront affichées dans la vue des 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.

4.7 Application d'une feuille de style XSL avec une boucle infinie à un fichier XML

Si la feuille de style XSL que vous appliquez à un fichier XML a une boucle infinie, vous pouvez recevoir un message d'erreur du type 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.

4.8 Les paramètres de catalogue XML ne sont pas reconnus par le programme de lancement XSL distant

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 débogueur XSL dans un processus XSL distant, les mappages d'URI vers clés dans le catalogue XML ne sont pas respectés et une exception java.io.FileNotFound est émise.

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).

4.9 Génération d'XSL pour un modèle XHTML sans utiliser l'option 'Extraire les données XML de XHTML'

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.

4.10 Le rechargement n'a aucun effet dans les éditeurs RMX et XMX

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, vous devez fermer la session RMX ou XMX et la réouvrir afin d'éditer le nouveau fichier réservé.

4.11 Validation et identificateurs URI non résolus

Le comportement de l'analyseur syntaxique XML lorsqu'il rencontre un identificateur URI insolvable (par exemple, dans une déclaration DOCTYPE) consiste à signaler une erreur d'E/S fatale et à mettre fin à tout traitement supplémentaire. 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é.

4.12 Problèmes d'utilisation de l'assistant de client XML/XSL de bean Java si le bean comporte des méthodes avec les mêmes noms de paramètres

Pour l'assistant de client XML/XSL de bean Java, si le bean possède des méthodes avec les mêmes noms de paramètres, les champs du formulaire d'entrée seront également générés avec le même nom.

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.

4.13 Problèmes de codage bidirectionnel possibles lors de la génération d'un schéma XML ou d'un fichier DTD

Lorsque vous générez un schéma XML à partir d'un fichier DTD contenant des éléments en hébreu ou en arabe ou que vous générez une DTD à partir d'un schéma XML contenant des éléments en hébreu ou en arabe, certains noms d'éléments peuvent être codés avec leurs valeurs de codage hexadécimales pour l'hébreu et l'arabe. Pour éviter ce problème, remplacez l'attribut de codage de la DTD ou du fichier de schéma XML d'origine par UTF-8 avant d'exécuter la génération:  La déclaration XML devrait alors être :

<?xml version="1.0" encoding="UTF-8"?>

La liste des valeurs de codage concernées est la suivante :

4.14 Vue de sortie de transformation XSL vide lors du traçage d'une transformation XML distante

La vue de sortie de transformation XSL dans la perspective de débogage XSL n'affiche aucun résultat lorsqu'un traçage de transformation XSL est lancé sur une application distante.

4.15 Le changement de nom d'un espace de nom dans un schéma XML crée un nouvel espace de nom

Si vous modifiez l'espace nom cible dans un schéma XML, un nouvel espace nom est créé avec le préfixe Q1. Pour éviter ce problème, déplacez d'abord vos éléments globaux et types vers le haut du document (avant qu'ils ne soient réellement utilisés). Dans un deuxième temps, appliquez votre modification d'espace nom cible.

4.16 Le programme de débogage XSL ignore l'indicateur Activé/Désactivé sur un point d'arrêt.

Vous pouvez sélectionner Activer le point d'arrêt et Désactiver le point d'arrêt dans le menu en incrustation de l'éditeur XSL. Toutefois, le programme de débogage XSL ignore l'indicateur Activé/Désactivé sur un point d'arrêt.

Retour au fichier Readme principal