Usando auto-completar código em documentos XML restritos por vários esquemas XML
Consulte também
Você pode restringir um documento de instância XML por mais de um arquivo do esquema, se pelo menos um dos arquivos do esquema tiver xsd:any ou xsd:anyAttribute, conhecidos como curingas. Ao usar esses curingas, o IDE limitará as informações na caixa de auto-completar de código por namespace. xsd:any e xsd:anyAttribute vêm com um atributo opcional namespace . A tabela seguinte mostra como o IDE substitui curingas com base no valor do atributo namespace.
| valor de namespace |
Substituição |
| ##any |
Qualquer elemento de qualquer namespace. |
| ##other |
Qualquer elemento de outros namespaces que não sejam targetNamespace. |
| ##targetNamespace |
Qualquer elemento de targetNamespace. |
| ##local |
Qualquer elemento não-qualificado (sem namespace). |
| Lista de URIs |
Elementos dos namespaces especificados. |
Por exemplo, presuma que você possui o seguinte:
<a:RootA xmlns:a="http://xml.netbeans.org/schema/A"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xml.netbeans.org/schema/A A.xsd
http://xml.netbeans.org/schema/B B.xsd
http://xml.netbeans.org/schema/C C.xsd">
< (current cursor position)
</a:RootA>
Neste exemplo, RootA é um dos elementos raiz definidos no esquema A.xsd. Se RootA tinha um elemento filha xsd:any, então, na posição do cursor você veria itens aparecendo de vários namespaces segundo a regra de substituição mostrada na tabela acima. O mesmo se aplica a xsd:anyAttribute.
Regras e restrições
- Definiçao de xsd:any ou xsd:anyAttribute.
xsd:any (ou xsd:anyAttribute) deve existir no elemento raiz do esquema de restração base. Por exemplo, presuma o seguinte:
- Você está usando A.xsd, B.xsd e C.xsd para restringir instance.xml.
- O elemento raiz que você está usando para a restrição é o elemento raiz de A.xsd, chamado A-Element.
Nesse caso, xsd:any (or xsd:anyAttribute) deve ser definido em A-Element para ver os artefatos de A.xsd, B.xsd e C.xsd em instance.xml.
- Selecionando vários arquivos durante a criação do documento da instância XML.
Quando cria um documento da instância XML no IDE, você pode selecionar apenas um arquivo do esquema XML para restringir esse documento. Você deve adicionar as referências aos arquivos do esquema usando o Editor de código-fonte.
- Localização dos arquivos do esquema de restrição.
Verifique se os arquivos do esquema que você deseja usar para restringir o documento da instância XML estão disponíveis em seu sistema de arquivos. Nesta versão, o IDE não permite que você faça referência aos arquivos de esquema externos com a finalidade de restringir os documentos da instância XML.
Para criar um documento XML restringido por vários arquivos do esquema XML e chamar auto-completar de código:
- No menu principal, escolha Arquivo > Novo arquivo.
O assistente para Novo arquivo se abre.
- Em Categorias, selecione o nó XML e em Tipos de arquivo, selecione o nó Documento XML, em seguida, clique em Próximo.
- Especifique um nome e um local para o documento e clique em Próximo.
- Selecione o botão de opção Documento com restrição do esquema XML e clique em Próximo.
- Clique no botão Explorar ao lado do campo URI do esquema para navegar e selecionar o primeiro arquivo do esquema que irá restringir o documento da instância XML.
Quando você tiver selecionado o arquivo do esquema, o IDE preenche os campos Namespace do documento e Elemento raiz. Se o esquema não possui namespace de destino, o campo Namespace do documento fica em branco.
- Se o esquema possui mais de um elemento raiz, selecione o elemento que deseja usar para a restrição na lista suspensa Elemento raiz.
- Clique em Finalizar.
O IDE adiciona um nó para o novo arquivo .xml na janela Projetos, e o novo arquivo é aberto no Editor de código-fonte.
- No Editor de código-fonte, atualize o valor xsi:schemaLocation para adicionar os arquivos do esquema adicionais.
Na amostra mostrada abaixo, base-schema-targetNamespace é o namespace de destino do esquema selecionado na etapa 5, e base-schema é o caminho para o arquivo .xsd e o nome do arquivo.
xsi:schemaLocation='base-schema-targetNamespace base-schema
second-schema-targetNamespace second-schema
third-schema-targetNamespace third-schema'
- Salve as alterações.
- Na guia Editor de código-fonte do documento XML, posicione o cursor onde deseja começar a adicionar conteúdo e digite um colchete angular esquerdo de abertura (<).
A caixa de conclusão de código se abre. Essa caixa fornece uma lista de rolagem de elementos de esquema. A lista dos componentes é baseada no arquivo do esquema XML que restringe o arquivo XML atual.
- Quando você usa curingas e seleciona um elemento de outro namespace, o IDE insere automaticamente uma declaração de namespace desse elemento. O IDE tentará prefixos diferentes, começando com ns1, se se uma correspondência for encontrada, é adicionada uma declaração da seguinte forma: xmlns:ns1="targetNamespace-of-selected-element".
- Consulte também
- Sobre o uso de conclusão de código em documentos da instância XML restritos pelo esquema XML
- Sobre as ferramentas do esquema XML
Notificações legais