Esquema Hierárquico Personalizado¶

Introdução¶

Um esquema hierárquico (ou esquema hierárquico) é uma estrutura de arquivo complexa com vários tipos de linha de arquivo, como linhas de cabeçalho ou de resumo. Esta página aborda a criação e edição de um esquema hierárquico personalizado em uma transformação.

Crie um Esquema Hierárquico¶

Esquemas personalizados, incluindo esquemas hierárquicos, são definidos em transformações. Para poder criar um esquema hierárquico, primeiro crie uma transformação.

A opção Definir Esquema fica visível somente quando uma transformação ainda não está herdando um esquema de uma atividade adjacente. Se uma atividade adjacente que permite a configuração de esquemas definidos pelo usuário estiver presente, não forneça um esquema de solicitação ou resposta na configuração da atividade, pois isso faria com que esses esquemas fossem herdados pela transformação.

Desde que esta condição seja atendida, o botão Definir Esquema será exibido no modo de mapeamento em cada lado da transformação que ainda não possui um esquema definido em uma atividade. Clique em Definir Esquema no lado de origem ou destino da transformação e selecione Criar Hierárquico:

Editar um Esquema Hierárquico¶

Para editar um esquema hierárquico que foi definido em uma transformação, use o menu de ações do esquema em uma transformação para selecionar Edit Schema:

Ao abrir um esquema referenciado por vários componentes, uma caixa de diálogo exibe uma lista de quaisquer componentes que fazem referência ao esquema e serão afetados por quaisquer alterações:

Configurar um Esquema Hierárquico¶

A configuração de um esquema usando o editor de esquema hierárquico é abordada da seguinte forma:

• Nome do esquema: Insira um nome a ser usado para identificar o esquema hierárquico.

• Status de salvamento: À direita do nome do esquema estão a data e a hora em que a transformação associada ao esquema foi salva pela última vez. Esta informação não está associada ao próprio esquema, que é salvo usando o botão Salvar alterações localizado na parte inferior da configuração.

• Tipo: Selecione entre os tipos disponíveis para um esquema hierárquico personalizado:

  • XML: O esquema será criado no formato XML.
  • Largura Fixa: O esquema será criado em formato CSV usando comprimento para delinear os campos.
  • Delimitado por Caracteres: O esquema será criado em formato CSV usando caracteres para delinear os campos.

  Nota

  Não há suporte para a criação de um esquema hierárquico no formato JSON.

• Opções: Quando Delimitado por Caractere é selecionado, estas opções ficam disponíveis:

  

  • Delimitador: Insira os caracteres a serem usados como delimitadores de campo que especificam o limite entre os campos de dados. O padrão é uma vírgula. Você também pode usar delimitadores de vários caracteres, como uma barra vertical dupla ||. Para usar uma aba como delimitador, insira \t.

  • Quebras de linha para fim de registros: Marque esta caixa de seleção para usar quebras de linha para separar registros. Esta opção é selecionada por padrão. Quando esta opção é selecionada, o final dos registros é indicado por quebras de linha para que cada registro exista em uma linha (a menos que seja usado um qualificador). Quando desabilitado, as quebras de linha são ignoradas e novos registros começam após o número total de campos ser atingido.

    Nota

    Esta opção é relevante somente para esquemas usados no lado de origem de uma transformação. Para esquemas usados no lado de destino de uma transformação, as quebras de linha são sempre usadas para indicar o fim dos registros.

  • Qualificador de String: Insira o caractere a ser usado como wrapper, indicando uma string de texto que deve ser tratada como uma única unidade de dados. O padrão é um caractere de aspas duplas. Se deixado em branco, nenhum qualificador de string será usado.

    Ao usar um Qualificador de string, selecione Sempre ou Quando necessário para indicar quando o qualificador deve ser usado. O padrão, Quando Necessário, é recomendado, de modo que se os caracteres especificados como Delimitador ocorrerem na sequência, a sequência será agrupada pelos caracteres qualificadores de sequência especificados. Se o delimitador não ocorrer, a string não será quebrada.

    Durante o processamento das fontes, o qualificador de string é removido. Durante o processamento dos destinos, o qualificador de string é adicionado.

  • Converter sequências de escape: Marque esta caixa de seleção para converter ou ignorar sequências de escape conforme indicado por uma barra invertida \. Por padrão, as sequências de escape são convertidas seguindo os padrões Java. Quando desabilitado, a conversão de texto ocorre sem interpretação das sequências de escape.

    Nota

    Esta opção é relevante somente para esquemas usados no lado de origem de uma transformação.

  • EDIFACT: Marque esta caixa de seleção se os dados seguem o padrão EDIFACT de regras de sintaxe.

• Adicionar Nó: Clique no botão Adicionar Nó para adicionar novos nós, um de cada vez, à tabela. Estas colunas estão disponíveis para cada linha do nó:

  • #: Cada linha do nó recebe automaticamente um número na ordem em que a linha aparece. Depois de ter pelo menos duas linhas com o mesmo pai na árvore, passe o mouse sobre o número e clique no botão para cima ou para baixo seta. O nó que serve como nó raiz (sem um pai) não pode ser reordenado, nem os nós podem ser reordenados para um nível diferente na estrutura em árvore (em vez disso, isso pode ser feito alterando o pai do nó).

  • Nó: Insira um nome para o nó. O nome do nó não pode conter caracteres de espaço em branco ou símbolos como estes: @ $ % & / + ( ) : ; ,. Além disso, o nome do campo não pode começar com um número, ponto final (.) ou hífen (-).

    Dica

    Para referência sobre todos os caracteres não permitidos, consulte NCName conforme definido pelo W3C.

  • Pai: Use o menu suspenso para selecionar o pai do nó. Observe que não é possível selecionar um nó pai que causaria uma referência circular.

  • Ocorrência: Use o menu suspenso para selecionar como o nó deve ocorrer no documento complexo:

    • Zero ou Mais: Selecione esta opção se este nó pode ou não ocorrer, mas se ocorrer, poderá ocorrer inúmeras vezes.
    • Zero ou Um: Selecione esta opção se este nó pode ou não ocorrer, mas se ocorrer, poderá ocorrer apenas uma vez.
    • Um ou Mais: Selecione esta opção se este nó deve ocorrer pelo menos uma vez, mas também pode ser repetido.
    • Exatamente uma vez: Selecione esta opção se este nó deve ocorrer uma vez e somente uma vez no documento.

  • Campos: O número de campos definidos para o nó é listado. Para definir os campos do nó, clique no ícone de edição à direita do número de campos. Isso abre um editor de campo para o nó específico, conforme a seguir.

    

    Nota

    Os nós devem conter pelo menos um campo para poder mapeá-los ao concluir um mapeamento de transformação.

    

    • Ciclo do nó: Clique nas setas para a esquerda ou para a direita para percorrer os nós no esquema hierárquico para mostrar a tabela de campos do nó selecionado.

      • Voltar: Clique no ícone fechar para retornar à tabela de nós.

        Navegador de Nó: Ao longo da parte superior da tabela há um botão cinza expandido que permite alterar a exibição da tabela navegando para outro nó:

        

    • Adicionar Campo: Clique para adicionar novas linhas de campo, uma de cada vez, à tabela. Dependendo do esquema selecionado Tipo, estas colunas estão disponíveis para cada linha do campo:

      • #: Cada linha do campo recebe automaticamente um número na ordem em que a linha aparece. Para reordenar as linhas, arraste e solte em outra posição na tabela ou passe o mouse sobre o número e clique no botão para cima ou para baixo seta.

      • Campo: Insira um nome para o campo. O nome do campo não pode conter caracteres de espaço em branco ou símbolos como estes: @ $ % & / + ( ) : ; ,. Além disso, o nome do campo não pode começar com um número, ponto final (.) ou hífen (-).

        Dica

        Para referência, consulte NCNameChar para os caracteres permitidos conforme definido pelo W3C.

      • Tipo: Use o menu suspenso para selecionar um tipo de dados. As opções para novos esquemas personalizados são boolean, date, decimal, double, float, integer, long, e string. O padrão é string. Se um esquema personalizado foi criado espelhando um esquema de uma atividade baseada em servidor, tipos de dados adicionais poderão ser listados.

      • Begin: Somente para esquemas de Largura fixa, insira a posição inicial do caractere. Observe que 1 é considerado a posição de início do arquivo.

        O valor padrão para linhas subsequentes é o próximo caractere após a posição final do campo anterior. Por exemplo, se a posição final do campo anterior for 50, a posição inicial do próximo campo será 51.

      • Comprimento: Apenas para esquemas de Largura fixa, insira o número de caracteres a serem reservados para este campo. Quando a posição inicial e final do caractere já foram inseridas, este campo é calculado automaticamente.

        Arquivos de texto de comprimento fixo sempre especificam um determinado número de caracteres reservados para cada campo. Por exemplo, você pode identificar um campo chamado LastName que sempre tem 30 caracteres reservados para ele. Se o valor real for "Smith", apenas 5 caracteres serão usados; os personagens restantes não têm nada neles.

      • End: Somente para esquemas de Largura fixa, insira a posição do caractere final. Quando a posição e o comprimento do caractere inicial já foram inseridos, este campo é calculado automaticamente.

        Nota

        Por padrão, segmentos de comprimento fixo terminam com um caractere de nova linha.

      • Valor padrão: Para esquemas Largura fixa ou Delimitado por caracteres, se desejar que este campo tenha um valor padrão, insira o valor aqui.

      • Formato: Para esquemas Largura fixa ou Delimitado por caracteres, se desejar que este campo tenha um formato específico, como para data ou moeda, insira o formato aqui.

      • Ações: Para ações que você pode realizar em uma linha de campo existente, passe o mouse sobre o campo na extremidade direita abaixo do ícone do menu de ações . Em seguida, clique no ícone de cópia para duplicar a linha do campo ou clique no ícone de exclusão para excluir a linha do campo.

    • Revisar Esquema: À medida que você define manualmente cada campo dentro do esquema, uma visualização do esquema é exibida no lado direito. O esquema é exibido usando os elementos de interface padrão descritos em Nós e Campos.

    • Salvar alterações: Clique para salvar e fechar o esquema.

    • Descartar alterações: Clique para fechar o esquema sem salvar as alterações.

  • Ações: Para ações que você pode realizar em uma linha de nó existente, passe o mouse sobre o campo na extremidade direita abaixo do ícone do menu de ações . Em seguida, clique no ícone de cópia para duplicar a linha do nó ou clique no ícone de exclusão para excluir a linha do nó.

• Revisar esquema: À medida que você define manualmente cada nó no esquema, uma visualização do esquema é exibida no lado direito. O esquema é exibido usando os elementos de interface padrão descritos em Nós e Campos.

  Cuidado

  Se você criou nós que não possuem nenhum campo, então você não poderá mapear nenhum campo dentro desses nós ao concluir um mapeamento de transformação.

• Salvar alterações: Clique para salvar e fechar o esquema.

• Descartar alterações: Clique para fechar o esquema sem salvar as alterações.

Menu de Ações do Esquema¶

Após a criação de um esquema hierárquico personalizado, você poderá acessar opções de menu adicionais que estão disponíveis para todos os esquemas.

Isso inclui Excluir, Renomear, Exibir dependências, Implantar, Implantação configurável e Adicionar ao grupo, bem como Editar esquema e Limpar esquema. Para obter detalhes sobre essas ações, consulte Menu Ações do esquema.