Ferramentas XML - Notas sobre o Release

1.0 Introdução
2.0 Alterações do Release Anterior
3.0 Limitações
   3.1 Transformação e Depuração do XSL
4.0 Problemas Conhecidos
   4.1 Abrir Arquivos XML Grandes Pode Causar o Fechamento Repentino do Workbench
   4.2 XML para SQL Não Suporta Tipos de Dados BLOB, CLOB e Binário
   4.3 XML para SQL Pode Lançar uma SQLException para Formatos de Data ou Hora Inapropriados
   4.4 Gerando um Esquema XML a partir de uma Tabela do Banco de Dados em Máquinas Árabes/Hebraicas
   4.5 Gerando Teste de Segurança e Arquivos DAD para DB2 XML Extender em Máquinas DBCS
   4.6 Gerando um Esquema XML a partir de uma Tabela do Banco de Dados que Contém Caracteres DBCS
   4.7 Aplicando uma Folha de Estilo XSL com um Loop Infinito a um Arquivo XML
   4.8 As Definições do Catálogo XML Não São Reconhecidas no Ativador do XSL Remoto
   4.9 Gerando XSL para um Gabarito XHTML sem Utilizar a Opção 'Extract XML data from XHTML'
   4.10 Recarregar Não Altera Nada nos Editores RMX e XMX
   4.11 URIs de Validação e Não Resolvidos
   4.12 Problemas ao Utilizar o Assistente Java Bean XML/XSL Client se o Bean Tiver Métodos com os Mesmos Nomes de Parâmetros
   4.13 Problemas de Codificação BiDi Podem Ser Encontrados na Geração de um Esquema XML ou Arquivo DTD
   4.14 A Exibição XSL Transform output Está Vazia ao Rastrear Transformações de XML Remotas
   4.15 A Renomeação de um Espaço de Nomes em um Esquema XML Cria um Novo Espaço de Nomes
   4.16 O Depurador XSL Ignora o Sinalizador Enabled/Disabled em um Ponto de Interrupção.

1.0 Introdução

As seguintes ferramentas do ambiente de desenvolvimento XML estão disponíveis no WebSphere Studio: editor XML, editor DTD, editor de esquema XML, editor XSL, ferramenta de depuração e transformação XSL, editor de mapeamento de XML para XML e o editor de mapeamento de RDB para XML (que pode ser utilizado para gerar arquivos DAD para o DB2 XML Extender). Também estão incluídas bibliotecas de classes Java e assistentes para armazenar e recuperar dados XML data de quaisquer bancos de dados JDBC, suporte a segurança XML, um assistente de expressão XPath e muitos geradores (tais como geração DOM/XSL de XML a partir de um Java bean e geração de XSL/XML a partir de arquivo XHTML).

2.0 Alterações do Release Anterior

As seguintes melhorias foram feitas para o WebSphere Studio Versão 5.1:

3.0 Limitações

3.1 Transformação e Depuração do XSL

Se o caminho ou o nome do arquivo de arquivos XML /XSL não tiver caracteres ascii, a depuração e transformação XSL poderão não funcionar corretamente.

4.0 Problemas Conhecidos

4.1 Abrir Arquivos XML Grandes Pode Causar o Fechamento Repentino do Workbench

Aja com cautela quando abrir grandes arquivos com qualquer editor de XML. Se os limites de memória do workbench forem excedidos, ele fechará repentinamente sem salvar os dados (e sem mensagens de aviso ou erro). O número de elementos em um arquivo XML, não seu tamanho, é o melhor indicador de quanta memória será necessária. Os requisitos de memória dependem, também, do que mais está aberto no workbench - em alguns casos você pode abrir um arquivo de 15 megabytes, mas em outros casos, um arquivo de 1 megabyte pode causar problemas. Portanto, recomendamos salvar todos os dados no workbench antes de abrir grandes arquivos XML.

Nota: você pode alterar a memória máxima alocada para o WebSphere Studio. Para obter informações adicionais, consulte o leia-me do Workbench.

4.2 XML para SQL Não Suporta Tipos de Dados BLOB, CLOB e Binário

XML para SQL não suporta a tabela do banco de dados corretamente quando o tipo de coluna é Binary, BLOB ou CLOB. Isso aplica-se para as ações INSERT e UPDATE.

4.3 XML para SQL Pode Lançar uma SQLException para Formatos de Data ou Hora Inapropriados

Ao atualizar uma tabela de banco de dados que tem colunas com o tipo de dados Date, Time ou Timestamp, o assistente XML para SQL ou os arquivos JAR xmltosql e sqltoxml podem lançar uma SQLException se o valor da cadeia na origem XML de entrada não for aceito pelo produto de banco de dados de destino. Os formatos de data e hora são ligeiramente diferentes de um produto para outro. Você pode utilizar o gerador de consultas SQL para determinar os formatos corretos desses tipos.

4.4 Gerando um Esquema XML a partir de uma Tabela do Banco de Dados em Máquinas Árabes/Hebraicas

Ao gerar um arquivo esquema XML de uma tabela do banco de dados, a mensagem de erro a seguir poderá ser produzida na área de janela Tasks, especialmente, em plataformas árabes ou hebraicas: "Premature end of file."

Todavia, o arquivo esquema será gerado corretamente. Atualize a pasta de espaço de trabalho de destino especificada, em seguida, abra o arquivo com o editor XSD.

4.5 Gerando Teste de Segurança e Arquivos DAD para DB2 XML Extender em Máquinas DBCS

Se você estiver gerando arquivos de teste de segurança no Windows, os arquivos em batch gerados utilizarão CR como o delimitador de linha, enquanto deveriam estar utilizando CRLF. Por isso, os arquivos podem não estar sendo executados corretamente. Nesse caso, insira os delimitadores de linha manualmente utilizando um editor de texto como NotePad.

Além disso, observe que um arquivo DAD deve ser gerado na codificação padrão da plataforma para ser corretamente executado. Você pode fazer isso, selecionando o valor de codificação correto a partir do editor de preferências do arquivo XML.

4.6 Gerando um Esquema XML a partir de uma Tabela de Banco de Dados que Contém Caracteres DBCS

Se você gerar um esquema XML de um banco de dados contendo alfabeto completo e nomes de dígitos, você receberá erros na exibição Tasks. É recomendável não nomear as tabelas e colunas do banco de dados com nomes que contenham caracteres DBCS.

4.7 Aplicando uma Folha de Estilo XSL com um Loop Infinito a um Arquivo XML

Se a folha de estilo XSL aplicada a um arquivo XML tiver um loop infinito, você poderá receber uma mensagem de erro como a seguinte:
Xalan dies with a java.lang.StackOverflowError,
most likely due to deep recursion
.

Você deve corrigir sua folha de estilo antes de reexecutar a transformação. Se você não corrigir a folha de estilo e reexecutar imediatamente a transformação, poderá receber uma mensagem de erro diferente - isso ocorre porque a falha de memória pode acontecer em locais diferentes na máquina virtual. Se isso ocorrer, feche o WebSphere Studio, inicie-o novamente e corrija a folha de estilo XSL para deixar as coisas em ordem.

4.8 As Definições do XML Catalog Não São Reconhecidas no Ativador de XSL Remoto

Ao aplicar um arquivo XSL para um arquivo XML que inclui um arquivo DTD ou XSD, quaisquer definições que você tenha no XML Catalog serão aceitas se o XSL Debugger estiver sendo lançado em um processo XSL local.

Se o arquivo XSL chamar Java beans externos e você tiver que lançar o XSL Debugger em um processo XSL remoto, os mapeamentos de URI para chaves no XML Catalog não serão aceito e você receberá uma exceção java.io.FileNotFound.

Para solucionar isso, altere o arquivo XML de modo que o DTD ou XSD incluído possa ser localizado diretamente (ou seja, sem passar pelo XML Catalog).

4.9 Gerando XSL para um Gabarito XHTML sem Utilizar a Opção 'Extract XML data from XHTML'

Quando os dados já estiverem armazenados em um arquivo XML, você deve chamar o assistente para 'XSL for XHTML template' sem selecionar a opção 'Extract XML data from XHTML'.

Devido a uma limitação atual, o arquivo dataLogic gerado pelo assistente deve ser editado manualmente para especificar a lógica relacionada aos dados específica do arquivo XML que está sujeito à transformação. Os arquivos dataLogic de exemplo são incluídos no projeto de exemplo 'XML from XSL and HTML'.

Se você não editar manualmente o arquivo da lógica relacionada aos dados, os arquivos XSL produzirão um arquivo HTML esqueleto que não incluirá dados.

4.10 Reload Não Altera Nada nos Editores RMX e XMX

A opção reload, que é solicitada quando o conteúdo de um arquivo editado é alterado no disco, não faz nada. Isso deve ser observado principalmente para Team Support. Quando um usuário registra saída de um arquivo e o conteúdo do arquivo é diferente daquele no editor, o editor solicitará que o usuário recarregue, mas a ação reload não fará nada. Nesse caso, você deve fechar a sessão RMX ou XMX e reabri-la para editar o arquivo do qual acaba de registrar saída.

4.11 Validação e URIs Não Resolvidos

O comportamento do analisador XML ao encontrar um URI que não pode ser resolvido (por exemplo, em uma declaração DOCTYPE) é relatar um erro de E/S fatal e parar qualquer processamento adicional. Um URI não resolvido não é visto como um erro sintático nem um erro semântico e, assim, o analisador não tenta tratá-lo. Essencialmente, o documento permanece sem verificação.

4.12 Problemas ao Utilizar o Assistente Java Bean XML/XSL Client se o Bean Tiver Métodos com os Mesmos Nomes de Parâmetros

Para o assistente para Java Bean XML/XSL Client, se o bean tiver métodos com os mesmos nomes de parâmetros, os campos do formulário de entrada serão gerados também com o mesmo nome.

A solução alternativa é renomear os parâmetros do método para que não ocorra sobreposição de nomes para parâmetros dos métodos que são utilizados para geração de beans.

4.13 Problemas de Codificação BiDi Podem Ser Encontrados na Geração de um Esquema XML ou Arquivo DTD

Quando você gera um esquema XML a partir de um arquivo DTD que contém elementos em Hebraico ou Árabe ou quando gera um DTD a partir de um esquema XML que contém elementos em Hebraico ou Árabe, determinados nomes de elementos podem ser codificados com seus valores de codificação Hebraico ou Árabe hexadecimais equivalentes. Para evitar esse problema, altere o atributo de codificação do arquivo de esquema DTD ou XML original para UTF-8 antes de executar a geração:  Ou seja, a declaração XML deve ser:

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

A lista de valores de codificação afetados é:

4.14 Exibição da Saída XSL Transform Vazia ao Rastrear Transformação de XML Remota

A exibição da saída XSL Transform na perspectiva XSL debug não mostrará nenhuma saída ao rastrear uma transformação XSL ativada em um aplicativo remoto.

4.15 Renomear um Espaço de Nomes em um Esquema XML Cria um Novo Espaço de Nomes

Se você alterar o espaço de nomes de destino em um esquema XML, um novo espaço de nomes é criado com o prefixo Q1. Para evitar isso, primeiro mova seus elementos e tipos globais para o início do documento (antes que eles sejam realmente referenciados). Em seguida, aplique a alteração ao espaço de nomes de destino.

4.16 O Depurador XSL Ignora o Sinalizador Enabled/Disabled em um Ponto de Interrupção.

Você pode selecionar Enable Breakpoint e Disable Breakpoint a partir do menu pop-up do editor XSL, entretanto, o XSL Debugger ignora o sinalizador Enabled/Disabled em um ponto de interrupção.

Retornar para o arquivo leia-me principal