Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2023-06-23
Converter texto em XML com um arquivo de esquema de texto

Converter texto em XML com um arquivo de esquema de texto

Crie um assembly contendo uma etapa
textschema
. Obtenha o texto de amostra que formará a base do seu esquema de texto.
A etapa
textschema
 permite que você converta texto em XML usando um esquema de texto. Para desenvolver um esquema de texto, você deve conhecer a estrutura dos dados que quer transformar. O processo é consideravelmente simplificado quando há um pequeno documento de amostra contendo dados representativos. Este tópico presume que você tem essa amostra.
Você pode usar a etapa
textschema
 para converter XML em texto ou para transformar arquivos delimitados. Na maioria dos casos, é mais simples usar as etapas
XTT
 e
csv-to-xml
, respectivamente.
  1. Na visualização
    Properties
     da etapa
    textschema
    , clique em
    Create Text Schema File
    .
  2. Selecione uma pasta principal para o arquivo do esquema de texto e forneça o nome do arquivo. Se necessário, especifique o URI do namespace de destino.
  3. O Studio abre o editor de esquema de texto e exibe o novo esquema de texto na visualização
    em árvore
     .
  4. Recorte e cole o texto de amostra na área superior direita do editor de esquema de texto, substituindo
    initial-text
    .
    Para remover a alimentação de linha de término dos arquivos de entrada, adicione este atributo ao elemento do esquema raiz:
    ts:eofStrip="
"
    .
  5. Comece descrevendo o texto de amostra. Selecione o primeiro campo, clique com o botão direito do mouse e selecione
    Create Field
    .
    Se você não tem uma amostra do texto que quer converter, mas conhece a estrutura, você pode editar diretamente a visualização
    Source
     do esquema de texto.
  6. Na página
    Identity
     do
    Create Field Wizard
    , forneça uma descrição básica do campo. Durante a execução da tarefa, considere:
    Opção Descrição
    Name
    Um nome para o campo.
    Occurrence
    As opções são:
    • Default
      : o campo é obrigatório e ocorre apenas uma vez.
    • Required
      : igual a Default.
    • Optional
      : o campo é opcional e pode ocorrer somente uma vez.
    • Multiple Optional
      : o campo é opcional e pode ocorrer várias vezes.
    • Multiple Required
      : o campo é obrigatório e pode ocorrer várias vezes.
    Start Tag
    Uma expressão regular que especifica o texto que faz com que um elemento seja gerado. Observe que o texto que corresponde a essa expressão não faz parte do valor de saída. Se você quer que o texto correspondente seja exibido no valor de saída, use o
    ts:format
     opção
    Etiqueta de término
    Uma expressão regular que especifica o texto que marca o fim de um elemento. Observe que o texto que corresponde a essa expressão não faz parte do valor de saída. Se você quer que o texto correspondente seja exibido no valor de saída, use o
    ts:format
     opção
    Truncar
    Especifica se os dados excedentes devem ser truncados em um campo de comprimento fixo ou se será gerado um erro. O valor por padrão é
    true
    .
    Separador
    Uma expressão regular que especifica um caractere que separa campos repetidos. Essa opção é habilitada somente se você seleciona a opção de ocorrência
    Multiple Optional
     ou
    Multiple Required
    .
    Omit
    Especifica se o campo da saída deve ser omitido em uma transformação
    text-to-XML
     ou
    XML-to-text
    . O valor por padrão é não omitir.
  7. Na página
    Delimit
     do
    Create Field Wizard
    , descreva quantos caracteres do texto de amostra representam um campo:
    Opção Descrição
    Formato
    Uma expressão regular que identifica padrões de texto válidos para um campo. Use essa expressão como uma alternativa para
    Start Tag
     e
    End Tag
    , a fim de garantir que todo o texto correspondente seja exibido na saída. Você também pode usá-la quando estiver lidando com valores que ocorrem várias vezes para que fique claro quando ocorre o final da sequência.
    Fixed Length
    Especifica o comprimento dos campos com comprimento fixo. Inclui aspas e caracteres de escape.
    Quoted
    Indica se os valores de cadeia de caracteres são tratados como cadeias de caracteres entre aspas. As opções são:
    • Default
      :
    • always
      :
    • always-including-empty
      :
    • optional
      :
    • never
      :
    Padding
    Uma expressão regular que identifica qualquer texto de preenchimento em campos com comprimento fixo.
    Preferred Padding
    Especifica o valor a ser usado se a expressão de
    Padding
     puder corresponder a mais de uma possível cadeia de caracteres.
    Align
    Especifica o alinhamento dos campos com comprimento fixo que exigem preenchimento.
  8. Na página
    Interpret
     do
    Create Field Wizard
    , descreva quantos caracteres do texto de amostra representam um campo:
    Opção Descrição
    Tipo
    O tipo de dados do campo.
    Valor por padrão
    Um valor por padrão para o campo.
    Date Format
    Especifica um padrão para datas ou horas. Com suporte a qualquer padrão permitido por Javas
    SimpleDateFormat
    .
    Idioma da data
    Especifica o idioma de data a ser usado na interpretação de datas. Garante que o nome seja usado no idioma apropriado quando o formato de data usar nomes de meses. O valor por padrão é
    EN
    .
    Ano de dois dígitos
    Especifica um valor para interpretar datas com ano de dois dígitos. O analisador de esquema de texto interpreta as datas de ano de dois dígitos que ocorrem antes desse valor como ocorrendo no país atual. Exemplo: se você inserir
    18
    , o analisador interpreta
    14
     como
    2014
     e
    96
     como
    1996
    .
    Formato de número
    Especifica um padrão para números. Com suporte a qualquer padrão permitido por Javas
    DecimalFormat
    .
    Separador decimal
    Especifica o separador usado em números decimais.
    Grouping Separator
    Especifica o separador de agrupamento de milhares nos números.
  9. Repita as etapas 6 a 9 para cada campo do texto de exemplo, adicionando novos elementos à visualização
    em árvore
     . Depois de criar todas as definições de campos obrigatórios, exclua o restante.
    Unparsed
     elemento filho
  10. Para agrupar todos os elementos que você criou em um tipo complexo, selecione-os, clique com o botão direito do mouse neles e selecione
    Quebrar elementos automaticamente
    . Em seguida, forneça um nome e um valor de ocorrência para o elemento wrapper.
  11. Na visualização
    de Propriedades
     do elemento wrapper, selecione
    /n
     na lista suspensa
    Etiqueta de finalização
     .
  12. O elemento-raiz do esquema por padrão é denominado
    File
    . Na guia
    Esquema
     da visualização
    Propriedades
     do elemento, forneça um nome mais significativo.
  13. Na visualização
    Propriedades
     do nível superior
    schema
     elemento, a propriedade
    Elemento-raiz
     tem o valor
    tns:File
    . Substituir
    File
     com o nome significativo que você selecionou para o elemento-raiz.
  14. Para remover quaisquer espaços extras da saída gerada, selecione a visualização
    Propriedades
     do nível superior.
    schema
     elemento. Selecione
    +
     na lista suspensa
    Preenchimento
     . Salve o esquema.