Especificações gerais para arquivos XML
Siga estas especificações para todos os arquivos de importação do IEX WFM Integrated que exigem formatação XML. Um elemento ou arquivo que não atende a essas especificações é inválido.
Tipo de conteúdo |
Especificação |
---|---|
Elementos de arquivo |
Todos os elementos devem estar aninhados no elemento raiz. O elemento raiz de cada tipo de importação é descrito no artigo dessa importação. A importação falhará se:
|
Declaração de tipo de elemento
|
Quando usar a definição de tipo de documento (DTD) para criar um arquivo, lembre-se destas considerações sobre declarações de tipo de elemento: <!ELEMENT elementName (childElement, childElement, ...)> Quando um elemento é definido com uma lista de elementos secundários separados por vírgulas, os elementos secundários devem aparecer na mesma ordem no arquivo de importação. Caso contrário, o elemento não será válido. <!ELEMENT elementName (#PCDATA)> Os elementos com o tipo #PCDATA podem conter qualquer string de texto. A importação de dados de dados valida o texto conforme necessário. O DTD para cada arquivo de importação XML é definido no tópico desse tipo de arquivo de importação. |
Qualificadores de elementos |
O DTD usa qualificadores de elemento XML padrão:
|
Atributos do elemento |
Siga as regras de atributos XML padrão. Cada atributo deve ser colocado entre aspas duplas. Se um atributo marcado como #REQUIRED no DTD estiver faltando no elemento associado, o elemento não será válido. |
Comentários |
Insira comentários neste formato: <!-- texto do comentário -->
|
Regras XML padrão
O arquivo de importação de dados deve ser um documento XML válido e bem formado, baseado em padrões XML. Se o arquivo de importação não estiver bem formado, a importação falhará.
Todas as regras padrão de formatação XML devem ser seguidas, incluindo:
-
O arquivo deve começar com uma declaração XML:
<?xml version=”1.0”?>
Caso o banco de dados contenha caracteres internacionais, a declaração deverá conter um parâmetro de codificação, conforme mostrado neste exemplo.
<?xml version="1.0" encoding="UTF-8"?>
A importação falhará se a codificação do arquivo de dados estiver no formato ANSI. O arquivo de dados deve ter a codificação UTF-8.
- Deve haver um elemento raiz em cada arquivo de importação. Consulte o artigo sobre o tipo de importação para obter detalhes.
- Cada elemento deve consistir em uma tag de abertura (
<tagName>
), uma tag de fechamento (</tagName>
) e o conteúdo do elemento. O conteúdo válido de cada elemento é definido na definição de tipo de documento (DTD) para cada importação de dados. -
As tags dos elementos diferenciam maiúsculas de minúsculas.
-
Os elementos podem ser aninhados, mas não podem se sobrepor. Este exemplo mostra elementos aninhados corretamente:
<tag1><tag2>the Data</tag2></tag1>
Este exemplo mostra elementos sobrepostos e resultaria em erro:
<tag1><tag2>the Name</tag1></tag2>
- O espaço em branco é ignorado, a menos que faça parte de uma string de texto (#PCDATA). O arquivo de importação de dados pode conter espaços em branco, linhas vazias ou tabulações entre elementos.
-
Tags e elementos secundários podem estar na mesma linha ou em linhas separadas. Estes dois exemplos são aceitáveis:
Exemplo 1
<tag1><tag2>the Data</tag2></tag1>
Exemplo 2
<tag1>
<tag2>
the Data
</tag2>
</tag1>