Utilizando a Configuração de Ativação da Transformação do XSL

Uma configuração de ativação é um mecanismo para definir e salvar diferentes configurações de ambiente de trabalho que podem ser ativadas separadamente. É possível utilizar configurações de ativação para ativar sessões de depuração.

Para criar uma configuração de ativação que carregará uma transformação do XSL para depuração, conclua estas etapas:

  1. Em uma perspectiva de workbench que ofereça o conjunto de ações ativar/depurar/executar (tal como a perspectiva de depuração), execute uma das seguintes tarefas:
    • Selecione Executar > Depurar na barra de menus do workbench para abrir a caixa de diálogo de configurações de ativação Depurar.
    • Clique na seta para baixo ao lado do botão de comando Depurar da barra de ferramentas do workbench e escolha Depurar na lista. Isso abrirá a caixa de diálogo de configurações de ativação Depurar.
  2. Na caixa de diálogo de configuração de ativação Depurar, execute uma das seguintes tarefas:
    • Selecione o nó Transformação XSL e clique em Nova configuração de ativação.
    • Clique com o botão direito do mouse no nó Transformação do XSL e selecione Novo no menu pop-up.
    • Dê um clique duplo no nó Transformação do XSL.
  3. Isso fará com que as guias de configuração e os campos de entrada sejam exibidos no lado direito da caixa de diálogo.
  4. No campo Nome, digite um nome de sua preferência para a configuração que está sendo criada.
  5. Selecione a guia Principal para trazê-la para o primeiro plano.
    1. Na guia Principal, no campo Projeto, digite o nome do projeto que contém a origem do aplicativo que você deseja depurar. Se o aplicativo não estiver em um projeto do workbench, então o campo do projeto poderá ser deixado vazio. Entretanto, se nenhum projeto for especificado, altere a consulta de origem na página da guia Origem para incluir o local da origem.

      Em vez de digitar um nome de projeto no campo Projeto, você pode procurar o projeto clicando em Procurar.

      Se você concluir este campo, o local do botão Procurar nos outros campos da guia será padrão para o local do projeto.

    2. Digite o caminho e o nome completos do arquivo XSL que você deseja depurar no campo Arquivo XSL de Origem. Como alternativa, você pode navegar para o arquivo clicando em Procurar. A conclusão deste campo é obrigatória.
    3. No campo Arquivo XML de Origem, digite o caminho e o nome completos do arquivo de entrada XML do arquivo XSL que você deseja depurar. Como alternativa, você pode navegar para o arquivo clicando em Procurar. A conclusão deste campo é obrigatória.
    4. No campo Arquivo de Saída, especifique o nome e o local do seu arquivo de saída. A conclusão deste campo é obrigatória.
    5. A caixa de opções Parar na Primeira Regra de Gabarito é selecionada por padrão. Com esta caixa de opções selecionada, o processo de transformação parará no primeiro gabarito definido no arquivo XSL.
  6. Clique na guia Parâmetros. Na página Parâmetros, você pode especificar:
    1. Parâmetros da Folha de Estilo - Clique em Incluir para incluir um novo Nome e Valor para o parâmetro da folha de estilo desta lista. Em sua folha de estilo XSL, você pode definir um xsl:param com um Nome. Você pode utilizar esta página para especificar um novo Valor para o parâmetro ou substituir o existente.
    2. Propriedades de Saída - Você pode optar por substituir as propriedades de saída padrão especificadas nos arquivos de origem. Clique em F1 para obter informações adicionais sobre os campos.
    3. Propriedades da Transformação - É possível especificar o Limite Recursivo e a Base de URI. O Limite Recursivo especifica em quantos níveis você deseja que a transformação esteja vinculada e a Base de URI é um caminho de contexto que você pode definir para que os URIs sejam resolvidos corretamente.
  7. Clique na guia Caminho de Classe. A página Caminho de Classe define o local de arquivos de classe utilizado ao executar e depurar o aplicativo. Ao depurar folhas de estilo XSL, o caminho de classe é utilizado ao procurar classes Java chamadas pela transformação XSL por meio de extensões XSL.

    Por padrão, os locais de classe de auto-inicialização e de usuário são derivados do caminho de construção do projeto associado. Você pode substituir essas definições aqui.

  8. Para definir o Caminho de Consulta da Origem, selecione a guia Origem e execute estas tarefas:
    • Para incluir um local de origem, clique em Incluir. Isso chamará a caixa de diálogo Incluir Origem, na qual você pode selecionar o tipo de local de origem a ser incluído. Na lista de seleção da caixa de diálogo Incluir Origem, a escolha de Espaço de Trabalho fará com que todos os projetos em seu espaço de trabalho sejam incluídos no caminho de procura de origem. Todas as outras seleções válidas para depurar transformações do XSL resultarão em uma caixa de diálogo na qual será possível digitar ou procurar o local do caminho de procura da origem a ser utilizado.
    • Para remover uma entrada existente, selecione um local de origem e clique em Remover.
    • Para definir a ordem das entradas existentes, selecione um local de origem e clique em Para Cima ou Para Baixo para alterar a disposição desse local.

    Se você quiser procurar todas as instâncias do nome do arquivo de origem no caminho da procura de origem, selecione a caixa de opções Procurar arquivos de origem duplicados no caminho. Se você selecionar essa caixa de opções e o depurador localizar várias instâncias do nome do arquivo, você será avisado por uma caixa de diálogo para escolher o arquivo de origem correto.

  9. Selecione a guia Comum para trazê-la para o primeiro plano. Você pode executar as seguintes tarefas na página Comum:
    • Caso deseje que a configuração de ativação seja armazenada localmente e esteja disponível para um único usuário, assegure-se de que o botão de rádio Local esteja selecionado. Se a configuração de ativação tiver de ser armazenada como um arquivo no espaço de trabalho e compartilhada em um repositório para uso da equipe, selecione o botão de rádio Compartilhado e digite o local do projeto em que você deseja que a configuração de ativação seja armazenada no campo Local de Configuração Compartilhada. Como alternativa, você pode procurar pelo projeto.
    • Caso deseje que a configuração de ativação seja exibida como uma configuração de depuração favorita no menu de favoritos do botão de comando Depurar ou na lista Histórico da Depuração do menu Depurar, selecione a caixa de opções Depurar.
  10. Se todas as informações obrigatórias para a configuração de ativação tiverem sido fornecidas, os botões de comando Depurar e Aplicar serão ativados. Clicar em Aplicar salvará a configuração de ativação, na qual você poderá optar por fechar a caixa de diálogo sem ativar a sessão de depuração ou poderá clicar em Depurar para ativar uma sessão de depuração utilizando a nova configuração de ativação. Se você clicar em Depurar, todas as alterações feitas à configuração de ativação serão salvas e uma sessão de depuração será ativada.

    Depois de salvar uma configuração de ativação da depuração, você poderá editá-la. Para obter informações adicionais sobre como editar configurações de ativação de depuração, consulte a tarefa relacionada.

    Dica: Se você ainda não salvou definições de configuração de ativação e se tiver criado entradas nas definições de configuração de ativação que deseja remover ou alterar, clique em Reverter para remover todas as alterações feitas.
  11. Se as informações obrigatórias para a configuração de ativação não foram fornecidas ou se houver erros nas informações fornecidas, as mensagens na parte superior da caixa de diálogo indicarão o que está faltando.
  12. Se você não utilizou esta caixa de diálogo para ativar uma sessão de depuração (por exemplo, você a utilizou para criar e salvar uma configuração de ativação), clique em Fechar para sair da caixa de diálogo quando tiver concluído o trabalho.
Tarefas relacionadas
Preparando para Depurar
Localizando a Origem
Iniciando uma Sessão de Depuração
Utilizando os Atalhos de Ativação da Depuração
Criando novas configurações de ativação a partir das configurações de ativação existentes
Editando configurações de ativação
Removendo configurações de ativação

Feedback