Ferramentas do esquema XML: Trabalhando com componentes do esquema XML

Voltar para Introdução às ferramentas do esquema XML

O objetivo deste tutorial é adicionar e editar componentes do esquema no esquema XML de amostra que você abriu no Abrindo um esquema XML de amostra tutorial. Além disso, você irá rever como desfazer e refazer ações de edição.

Observação: Sempre que o ícone for mostrado, você poderá clicar para exibir uma demonstração interativa detalhada das etapas descritas no tutorial.

superior

Adicionando um componente do esquema

Nesta seção, você adicionará um tipo complexo chamado InternationalAddressType usando a exibição Esquema e depois adicionará um elemento chamado província a esse tipo complexo.

Observação: As referências em um arquivo do esquema são somente leitura e serão editáveis somente onde forem definidas. Isso pode ser no mesmo arquivo do esquema ou em um arquivo diferente.

Para adicionar o tipo complexo InternationalAddressType:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Maximize a exibição, clicando com o botão direito do mouse na guia do arquivo e escolhendo Maximizar janela no menu pop-up.
   Maximizar a exibição permite que você veja mais informações sobre o esquema na exibição de coluna da exibição Esquema.
3. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
4. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos, clique com o botão direito do mouse e escolha Adicionar tipo complexo.
   A caixa de diálogo Tipo complexo se abre.
5. No campo Nome, digite InternationalAddressType.
6. Em Definição de tipo, selecione o botão de opção Usar definição existente.
   A parte inferior da caixa de diálogo se altera para lhe oferecer opções para definir a referência.
7. Em Referência global, selecione o botão de opção Extensão e, na lista de tipos, expanda o nó Tipos complexos e selecione o nó AddressType.
   Observe que o IDE mostra-lhe uma visualização prévia do código-fonte que será adicionado para essa definição.
8. Clique em OK.
   O IDE adiciona um nó para o novo tipo complexo. O rótulo do nó é o nome inserido no campo Nome, InternationalAddressType.
   Dica: Você pode clicar com o botão direito do mouse no novo nó e escolher Ir para > Definição para navegar diretamente para AddressType, o componente do esquema que você estendeu.

Exibir demonstração

Para adicionar o elemento província ao tipo complexo InternationalAddressType:

1. Na exibição Esquema, selecione o nó InternationalAddressType que você acabou de criar, clique com o botão direito do mouse e escolha Adicionar > Elemento.
   A caixa de diálogo Elemento se abre.
2. No campo Nome, digite província.
3. Em Tipo, selecione o botão de opção Usar tipo existente e, na lista, expanda o nó Tipos incorporados e selecione seqüência.
4. Clique em OK.
   A exibição Esquema agora contém um nó do novo elemento província, cujo pai é a seqüência no tipo complexo InternationalAddressType adicionado anteriormente.
5. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Editando um componente do esquema

Neste procedimento, você irá alterar o nome de um componente do esquema usando a janela Propriedades. Para fazer uma alteração estrutural em um componente do esquema, você não pode usar a janela Propriedade. Para fazer uma alteração estrutural, tal como usar um tipo complexo definido localmente em vez de fazer referência a um tipo complexo existente de um componente do esquema, use o personalizador desse componente.

Para editar um componente do esquema:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Exiba a janela Propriedades escolhendo Janela > Propriedades.
   Dica: Para aumentar o espaço usado para o editor do esquema XML e a janela Propriedades, você pode minimizar as janelas Projetos, Arquivos e Tempo de execução.
3. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
4. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos.
   O IDE adiciona uma nova coluna à direita da coluna onde você selecionou o nó. Esta nova coluna mostra os tipos complexos definidos no esquema.
   Observação: Quando o IDE adiciona uma nova coluna, uma barra de rolagem horizontal pode aparecer na parte inferior da exibição Esquema. Use esta barra de rolagem para retornar às colunas da extremidade esquerda na exibição. Você também pode clicar em um link na área de trilha para voltar pelo mesmo caminho.
5. Na segunda coluna, selecione o nó AddressType, em seguida, selecione o nó seqüência na próxima coluna e o nó CEP na próxima coluna.
   O IDE adiciona outra coluna à direita da que contém informações sobre o elemento CEP. A janela Propriedades mostra as propriedades do elemento do esquema CEP.
6. Na janela Propriedades, altere o valor da propriedade Nome para código postal e pressione Enter.
   Observação: Se você quisesse alterar a estrutura do elemento, clicaria no botão de reticências na propriedade Estrutura para acessar o Personalizador de elemento local.
7. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Excluindo um componente do esquema

Neste procedimento, você excluirá o componente província que adicionou anteriormente neste tutorial. Neste exercício, você usará um comando de exclusão simples. Você também poderia usar a função de refatoração para excluir um componente com segurança. Refatoração em um projeto do módulo BPEL usando o NetBeans Enterprise Pack guia você através do recurso de refatoração do NetBeans Enterprise Pack.

Para excluir um componente de esquema:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
3. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos.
4. Na segunda coluna, selecione o nó InternationalAddressType, em seguida, selecione o nó seqüência na próxima coluna e o nó província na próxima coluna.
5. Clique com o botão direito do mouse e escolha Excluir no menu pop-up.
   O IDE exclui província do arquivo do esquema XML.
6. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Desfazendo e refazendo ações

Neste procedimento, você tentará desfazer e refazer ações ao trabalhar com um esquema na exibição Esquema.

Para desfazer e refazer ações:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
3. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos, clique com o botão direito do mouse e escolha Adicionar tipo complexo.
   A caixa de diálogo Tipo complexo se abre.
4. No campo Nome, digite Pegar emprestado, aceite os outros padrões (Definição in-line e Seqüência) e clique em OK.
   A segunda coluna da exibição Esquema agora contém um nó Pegar emprestado.
5. Alterne para a exibição Fonte clicando no botão Fonte na parte superior da exibição Esquema.
6. Na exibição Fonte, adicione um tipo simples denominado Emprestar inserindo as linhas a seguir antes da linha </xs:esquema>:

   <xs:simpleType name="Lend">
     <xs:list>
         <xs:simpleType>
               <xs:restriction base="xs:string"/>
         </xs:simpleType>
     </xs:list>
   </xs:simpleType>
   

   Na ilustração seguinte, as linhas de 274 a 280 mostram o código-fonte como você o veria depois de adicioná-lo na exibição Fonte:
   
   

   

   Neste ponto, Pegar emprestado e Emprestar existem nas exibições Esquema e Fonte.
7. Volte para a exibição Esquema clicando no botão Esquema e clique no nó Tipos simples na primeira coluna para verificar se Emprestar aparece no nó Tipos simples.
8. Desfaça suas ações executando o seguinte procedimento:
   1. Clique no botão Desfazer na barra de ferramentas ou pressione Ctrl-Z.
      Emprestar desaparece da exibição Esquema.
   2. Clique no botão Desfazer novamente ou pressione Ctrl-Z novamente.
      Clique no nó Tipos complexos na primeira coluna da exibição Esquema e observe que o componente Pedir emprestado não está mais no esquema.
9. Alterne para a exibição Fonte clicando no botão Fonte na parte superior da exibição Esquema e observe que os elementos (Pegar emprestado e Emprestar) não estão mais na exibição Fonte.
10. Refaça suas ações executando o seguinte procedimento:
    1. Volte para a exibição Esquema clicando no botão Esquema na exibição Fonte e depois clique no botão Refazer na barra de ferramentas ou pressione Ctrl-Y.
       O tipo complexo Pegar emprestado é adicionado de volta à exibição Esquema.
    2. Clique no botão Refazer novamente ou pressione Ctrl-Y mais uma vez.
       Clique no nó Tipos simples na primeira coluna da exibição Esquema e observe que o componente Emprestar é adicionado de volta na exibição Esquema.
11. Navegue de volta para a exibição Fonte para verificar se ambos os elementos estão de volta na fonte.
12. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Usando cortar, copiar e colar

Nestes procedimentos, você aprenderá como usar as funções de cortar, copiar e colar no editor do esquema XML.

Observação: Você pode realizar todas as ações de cortar, copiar e colar clicando com o botão direito do mouse nos menus pop-up, usando as opções do menu Editar e os botões da barra de ferramentas.

Para criar uma cópia de um componente do esquema XML usando copiar e colar:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Na exibição Esquema, clique no botão de coluna para verificar se você está no modo de coluna da exibição.
3. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos.
4. Na segunda coluna, selecione o nó OccupancyType, em seguida, selecione o nó seqüência na próxima coluna e o nó tipo na próxima coluna.
5. Clique com o botão direito do mouse na seleção e escolha Copiar no menu pop-up.
6. Na primeira coluna da exibição Esquema, selecione o nó Tipos complexos.
7. Na segunda coluna, selecione o nó ResidenceType, em seguida, selecione o nó seqüência na próxima coluna.
8. Clique com o botão direito do mouse na seleção e escolha Colar do menu pop-up.
   O componente tipo agora existe em OccupancyType e ResidenceType.
9. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

Para mover um componente do esquema XML usando recortar e colar:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Na exibição Esquema, clique no botão de árvore para certificar-se de que esteja no modo de árvore da exibição.
3. Na primeira coluna da exibição Esquema, expanda o nó Elementos, em seguida, expanda o nó autoLoanApplication.
4. No nó autoLoanApplication, selecione o nó anotação, clique com o botão direito do mouse e escolha Cortar do menu pop-up.
5. No nó autoLoanApplication, expanda o nó complexType.
6. Selecione o nó seqüência, clique com o botão direito do mouse e escolha Colar do menu pop-up.
   A anotação agora aparece no nó seqüência.
7. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Usando arrastar e soltar

Neste procedimento, você aprenderá como usar o recurso arrastar e soltar para reordenar os componentes do esquema. Você usará o modo de árvore da exibição Esquema para realizar as etapas desta seção.

A reordenação de arrastar e soltar só funciona para componentes no nível filho. Por exemplo, você não pode usar o recurso arrastar e soltar para reordenar tipos simples em um esquema XML, mas pode usar o recurso arrastar e soltar para reordenar componentes filhos de uma definição de tipo simples em um esquema XML.

Para usar o recurso arrastar e soltar:

1. Se mySchemaPrj não estiver aberto no IDE, abra-o agora e, em seguida, abra o arquivo do esquema newLoanApplication.
2. Na exibição Esquema, clique no botão de árvore para certificar-se de que esteja no modo de árvore da exibição.
3. Na exibição Esquema, expanda o nó Tipos simples e, em seguida, expanda o nó LoanType.
4. Selecione o nó "refinanciar" e arraste-o para o nó "novo".
   O IDE move "refinanciar" para seu novo local.
5. No menu principal do IDE, escolha Arquivo > Salvar todos.

Exibir demonstração

superior

Próxima etapa

As etapas em Analisando esquemas XML mostram como usar as consultas disponíveis em ferramentas do esquema XML para analisar um esquema XML.

superior