Criar uma fonte de arquivo local no Jitterbit Design Studio

Introdução

Um Arquivo Local em um agente privado pode ser usado como uma fonte no Jitterbit. Ele deve residir na máquina onde o agente privado está instalado e não pode ser usado com agentes em nuvem. (Veja Fonte de Armazenamento Temporário para uma abordagem aplicável a agentes em nuvem.)

Qualquer tipo de arquivo pode ser usado. Tipos comumente usados para arquivos locais são texto (.txt), CSV (.csv), XML (.xml) e JSON (.json).

Pré-requisito

Antes de usar uma fonte de Arquivo Local, você deve ter habilitado a Local File Location no seu agente privado Jitterbit. Veja Habilitando a localização de arquivo local para mais detalhes.

Criar uma fonte de arquivo local

Você pode optar por criar uma nova fonte de Arquivo Local por conta própria ou dentro de uma operação existente. Para mais informações sobre como as fontes funcionam dentro das operações, veja Criando uma operação.

Criar uma nova fonte de arquivo local como uma fonte independente

Dentro do seu projeto no Jitterbit Design Studio, você cria uma nova fonte de Arquivo Local por meio de qualquer um dos seguintes métodos:

• Vá para Arquivo > Novo > Nova Fonte; ou

• No painel à esquerda, clique com o botão direito em Fontes e selecione Nova Fonte; ou

• Na barra de ferramentas superior, clique no ícone de fonte verde .

Na janela pop-up, selecione Arquivo Local como o tipo:

Sua nova fonte aparece em sua própria aba Nova Fonte no painel direito da janela.

Criar uma nova fonte de arquivo local em uma operação existente

Uma fonte é geralmente criada por padrão quando você cria uma nova operação. (A exceção é uma operação que consiste apenas em um script.) Com uma operação existente, você pode especificar o tipo de sua fonte por:

• Clicando duas vezes no ícone da fonte; na janela pop-up, selecione Criar Nova Fonte; ou

• Clicando com o botão direito no ícone da fonte e selecionando Criar Nova Fonte.

Na tela de configuração que aparece, use o dropdown Tipo para selecionar Arquivo Local, conforme mostrado acima.

Usar uma fonte de arquivo local existente em uma operação existente

Para usar uma fonte de Arquivo Local existente em uma operação existente com uma fonte, você pode configurá-la de qualquer uma das seguintes maneiras:

• Dentro da operação, clicando duas vezes no ícone da fonte e, na janela pop-up resultante, selecionando a fonte de Arquivo Local desejada na lista; ou

• Dentro da operação, clicando com o botão direito no ícone da fonte, escolhendo Selecionar Fonte Existente e, na janela pop-up resultante, selecionando a fonte de Arquivo Local desejada na lista; ou

• Arrastando a fonte de Arquivo Local desejada da árvore à esquerda e soltando-a no ícone da fonte existente da operação.

Configurar uma fonte de arquivo local

Depois de criar uma fonte de Arquivo Local, a tela de configuração será aberta na visualização principal do Design Studio. Você pode retornar à tela de configuração a qualquer momento clicando duas vezes no ícone da fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração básica

A tela de configuração aparecerá semelhante a este exemplo:

• Nome: Insira um nome apropriado e único para a fonte.
• Tipo: Use o dropdown para selecionar Arquivo Local, se ainda não estiver especificado.

• Parâmetros de Conexão: Especifique os detalhes para sua conexão de Arquivo Local:

• Navegar: O botão Navegar, se habilitado, pode ser usado para inserir rapidamente o caminho da pasta. Ele só pode ser utilizado se o agente Jitterbit estiver instalado localmente na mesma máquina em que o Design Studio está sendo executado. Se esta opção estiver desabilitada, pode ser necessário habilitar arquivos locais conforme descrito em Habilitando a localização de arquivos locais. Se você selecionar uma pasta ou arquivo usando Navegar, os campos Pasta(s) (e possivelmente Obter Arquivos) serão preenchidos automaticamente.

• Pasta(s): Insira um caminho local na máquina onde o agente Jitterbit está instalado que aponte para a pasta onde os arquivos desejados estão localizados.

  -   O caminho não pode conter nenhum destes caracteres: \~ % $ ? " \< \> :
  -   Os separadores de caminho (`'/'` ou `'\')` utilizados devem ser apropriados para o SO da máquina onde o agente privado está instalado.
  -   Apenas um caminho pode ser especificado.
  

• Obter Arquivos: Insira o nome do(s) arquivo(s) de origem que você deseja ler dentro do diretório especificado em Pasta(s). Este campo também pode incluir um asterisco * para ser usado como um caractere curinga (por exemplo, *.txt ou *.*) ou um ponto de interrogação ? para corresponder exatamente a um caractere (por exemplo, arquivo?.txt). Variáveis também podem ser usadas neste campo. Se estiver especificando um arquivo compactado (ZIP), consulte a seção "Compressão" dos parâmetros de conexão adicionais em Opções abaixo. O arquivo compactado pode ser descompactado e lido automaticamente. (Obrigatório.)

• Opções de Filtro: Permite especificar se a diferenciação de maiúsculas e minúsculas no nome do arquivo deve ser ignorada ou se as informações de Obter Arquivos devem ser tratadas como uma expressão regular.

• Testar Conexão: Clicar no botão testará a fonte de Arquivo Local. Ele verificará se uma conexão com a pasta especificada pode ser feita e retornará uma lista de arquivos encontrados; falhará se o caminho não for um caminho válido que encontre arquivos no sistema operacional onde o agente Jitterbit está sendo executado. Se você receber um erro, certifique-se de que habilitou arquivos locais conforme descrito em Habilitando a localização de arquivos locais.

• Clique no botão Salvar na barra de ferramentas principal ou na barra de ferramentas da fonte para salvar a configuração.

Opções

Parâmetros de conexão adicionais podem ser especificados clicando em Opções na parte inferior da seção Parâmetros de Conexão:

• Codificação de Caracteres: Usada para especificar uma codificação de caracteres para o(s) arquivo(s) de origem. Se deixado em branco, o Jitterbit tentará detectar a codificação. Para especificar uma codificação diferente da padrão, insira uma das codificações suportadas descritas em Codificação de caracteres.

• Pasta de Sucesso/Erro: Use esta seção para especificar se pastas de sucesso e/ou erro serão usadas para arquivar uma cópia de todos os arquivos processados.

  • Se uma pasta de sucesso for especificada, ao processar com sucesso a origem, uma cópia do arquivo será gravada em um arquivo nessa pasta.
  • O arquivo terá o mesmo nome que o especificado no campo Obter Arquivos acima, mas com um sublinhado final e um carimbo de data/hora adicionados. Se já houver um arquivo com o mesmo nome nessa pasta, um sublinhado adicional e um contador serão adicionados.
  • Por exemplo, se um arquivo chamado data.csv for processado com sucesso, uma cópia chamada data.csv_2018-01-01_12-00-00-000 poderá ser gravada na pasta especificada como a Pasta de Sucesso. Se tal arquivo já existir de uma execução anterior, um novo arquivo data.csv_2018-01-01_12-00-00-000_1 seria adicionado.
  • De forma semelhante, se uma pasta de erro for especificada, quaisquer arquivos que falharem serão gravados em um arquivo na Pasta de Erro.

• Arquivo de Gatilho: Use isso para especificar um arquivo de gatilho para iniciar o processamento do(s) arquivo(s) de origem. O arquivo de gatilho é excluído quando o processamento começa.

  • Após selecionar a caixa de seleção Usar Gatilho, especifique um Caminho de arquivo absoluto para um arquivo cuja presença acionará o processamento.
  • Variáveis (embora não curingas) podem ser usadas neste campo.
  • Como o arquivo de gatilho é excluído quando o processamento começa, o arquivo de gatilho não pode ser o mesmo arquivo que um arquivo de origem sendo processado.
  • Uma vez que a operação começa, a operação fará polling, procurando pelo arquivo de gatilho. O intervalo de tempo de polling é fixo em um segundo.
  • O arquivo de gatilho é excluído quando o processamento começa.
  • Se o arquivo de gatilho não for encontrado, a operação continuará tentando encontrar o arquivo de gatilho até que a operação expire.
  • Definir um arquivo de gatilho bloqueia qualquer operação ou script que use a origem até que a condição do arquivo de gatilho seja satisfeita ou a operação expire.

• Após o Processamento:

  • Se a caixa de seleção Excluir Arquivo estiver marcada, o(s) arquivo(s) de origem serão excluídos após serem processados.
  • Se um valor for especificado no campo Renomear Arquivo, o arquivo será renomeado usando o padrão fornecido. Variáveis podem ser usadas neste campo.
  • Apenas uma das opções de exclusão ou renomeação é aceita; se a caixa de seleção Excluir Arquivo estiver marcada, Renomear Arquivo será desabilitado e ignorado. Se o Renomear Arquivo estiver vazio, será ignorado. Se deixado como padrão, nenhum pós-processamento dos arquivos de origem ocorrerá.

• Ignorar Linhas: Os números indicados das primeiras e últimas linhas são ignorados para cada arquivo. Se houver cabeçalhos ou rodapés a serem ignorados, insira o número de linhas nos campos Primeiro e Último conforme apropriado.

  Nota

  Esta configuração não tem efeito quando uma fonte de Arquivo Local é referenciada a partir de um script usando as funções ReadFile ou WriteFile.

• Compressão: Se a caixa de seleção para Os dados de origem estão compactados estiver marcada, os arquivos de origem serão descompactados usando o formato ZIP. Uma Senha (para arquivos criptografados) pode ser especificada. Apenas a leitura do diretório raiz do arquivo é suportada.