Esquema personalizado no Jitterbit Integration Studio

Introdução

Um esquema plano (ou esquema plano) é uma estrutura de campo simples, de um nível, com o mesmo tipo de linha de dados em todo o documento de texto. Esta página aborda a criação e a edição de um esquema plano personalizado em uma transformação.

Crie um esquema plano personalizado

Esquemas personalizados, incluindo esquemas simples, são definidos em transformações. Para criar um esquema simples, primeiro crie uma transformação.

A opção Definir Esquema só fica visível quando uma transformação ainda não herda 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.

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

Editar um esquema plano

Para editar um esquema simples que foi definido em uma transformação, use o menu de ações do esquema em uma transformação para selecionar Editar Esquema:

Ao abrir um esquema referenciado por vários componentes, uma caixa de diálogo exibe uma lista de todos os componentes que referenciam o esquema e que serão afetados por quaisquer alterações:

Configurar um esquema plano

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

• Nome do esquema: Na caixa de entrada de texto na parte superior da tela, insira um nome a ser usado para identificar o esquema plano.

• Salvar Status: À 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. Essas informações não estão associadas ao esquema em si, que é salvo usando o botão Salvar Alterações localizado na parte inferior da configuração.

• Tipo: Selecione entre dois tipos para um esquema plano personalizado:

  • Largura fixa: O esquema será criado no formato CSV usando comprimento para delinear campos.
  • Delimitado por caracteres: O esquema será criado no formato CSV usando caracteres para delimitar campos.

• Opções: Quando Delimitado por caracteres é 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 com vários caracteres, como uma barra vertical dupla. ||. Para usar uma aba como delimitador, insira \t.

  • Quebras de Linha para o Fim dos 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 fim dos registros é indicado por quebras de linha, de modo que cada registro exista em uma única linha (a menos que seja usado um qualificador). Quando desabilitada, 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 apenas para esquemas usados no lado de origem de uma transformação. Para esquemas usados no lado de destino de uma transformação, 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 para que, se os caracteres especificados como Delimitador ocorrerem na string, a string seja encapsulada pelos caracteres qualificadores de string especificados. Se o delimitador não ocorrer, a string não será encapsulada.

    Durante o processamento das fontes, o qualificador de string é removido. Durante o processamento dos alvos, 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 apenas para esquemas usados no lado de origem de uma transformação.

• Adicionar Campo: Clique para adicionar novas linhas de campo, uma de cada vez, à tabela. Estas colunas estão disponíveis para cada linha:

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

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

    Dica

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

  • Tipo: Use o menu suspenso para selecionar um tipo de dado. 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 por espelhamento de um esquema de uma atividade baseada em servidor, tipos de dados adicionais podem ser listados.

  • Início: Somente para esquemas de Largura Fixa, insira a posição inicial do caractere. Observe que 1 é considerado a posição inicial 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: Somente para esquemas de Largura Fixa, insira o número de caracteres a serem reservados para este campo. Quando a posição inicial e a posição final do caractere já estiverem inseridas, este campo será calculado automaticamente.

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

  • Fim: Somente para esquemas de Largura Fixa, insira a posição final do caractere. Quando a posição e o comprimento do caractere inicial já estiverem inseridos, este campo será calculado automaticamente.

    Nota

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

  • Valor Padrão: Se desejar que este campo tenha um valor padrão, insira-o aqui.

  • Formato: Se desejar que este campo tenha um formato específico, como data ou moeda, insira-o aqui.

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

• Revisar Esquema: Conforme você define manualmente cada campo dentro do esquema, uma prévia 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.

Menu de ações do esquema

Depois que um esquema plano personalizado for criado, você poderá acessar opções de menu adicionais 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 de ações do esquema.