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:

  • Algum elemento existir fora do elemento raiz.

  • O elemento raiz estiver ausente.

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:

  • ? -Elementos com este qualificador não são necessários. Se incluí-los, você pode apenas especificá-los uma vez por elemento.
  • *-Elementos com este qualificador não são necessários. Você pode incluir mais de um desses para cada elemento.
  • +-Pelo menos um dos elementos com esse qualificador é necessário. Você pode incluir mais de um de cada elemento.
  • [sem qualificador]-Elementos não marcados com um qualificador são necessários e você só pode especificá-los uma vez por elemento.
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 -->


A importação de dados do IEX WFM Integrated ignora o texto que aparece entre <!-- e -->.

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>