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:
- 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.
- 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.
- Isso fará com que as guias de configuração e os campos de entrada
sejam exibidos no lado direito da caixa de diálogo.
- No campo Nome, digite um nome de sua
preferência para a configuração que está sendo criada.
- Selecione a guia Principal para trazê-la para o
primeiro plano.
- 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.
- 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.
- 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.
- 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.
- 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.
- Clique na guia Parâmetros. Na página Parâmetros,
você pode especificar:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.