Crie um Destino de Arquivo Local

Introdução

Um arquivo local em um Agente Privado pode ser usado como destino no Jitterbit. Deve residir na máquina onde o Agente Privado está instalado e não pode ser utilizado com Agentes em Nuvem. (Consulte Meta de armazenamento temporário para uma abordagem aplicável a Agentes em Nuvem.)

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

Pré-requisito

Antes de poder usar um destino de arquivo local, você deve ter habilitado o local de arquivo local em seu Jitterbit Agente Privado. Consulte Ativar localização de arquivo local para detalhes.

Crie um Destino de Arquivo Local

Você pode optar por criar um novo destino de arquivo local sozinho ou dentro de uma operação existente. Para obter mais informações sobre como as fontes e os destinos funcionam nas operações, consulte Criando uma operação.

Crie um Novo Destino de Arquivo Local Como Destino Independente

Dentro do seu projeto no Jitterbit Design Studio, você cria um novo destino de compartilhamento de arquivos por qualquer um dos seguintes:

• Vá para Arquivo > Novo > Novo Destino; ou

• Na árvore à esquerda, clique com o botão direito em Targets e selecione New Target; ou

• Na barra de ferramentas superior, clique no ícone de alvo azul .

No pop-up, selecione Compartilhamento de arquivos como o tipo:

Seu novo alvo aparece em sua própria guia Novo aba no painel direito da janela.

Crie um Novo Destino de Arquivo Local em uma Operação Existente

Um destino geralmente é criado 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 seu destino:

• Clicar duas vezes no ícone do alvo; no pop-up, selecione Criar novo destino; ou

• Clicar com o botão direito no ícone do alvo e selecionar Criar Novo Destino.

Na tela de configuração exibida, use o menu suspenso Tipo para selecionar Arquivo local, conforme mostrado acima.

Usar um Destino de Arquivo Local Existente em uma Operação Existente

Para usar um destino de arquivo local existente em uma operação existente com um destino, você pode defini-lo por qualquer um dos seguintes:

• Dentro da operação, clicar duas vezes no ícone do alvo, e no popup resultante, selecionar o alvo do Arquivo Local desejado na lista; ou

• Dentro da operação, clicar com o botão direito no ícone de destino, escolher Selecionar destino existente, e no popup resultante, selecionar o destino de arquivo local desejado na lista; ou

• Arrastar o destino do Arquivo Local desejado da árvore à esquerda e soltá-lo no ícone de destino existente da operação.

Configurar um Destino de Arquivo Local

Depois de criar um destino 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 do alvo na operação ou clicando duas vezes no alvo na árvore à esquerda.

Configuração Básica

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

• Nome: Insira um nome exclusivo e apropriado para o destino.
• Tipo: Use o menu suspenso para selecionar Local Arquivo, se ainda não estiver especificado.

• Parâmetros de conexão: Especifique os detalhes da sua conexão de arquivo local:

  • Navegar: O botão Navegar, se ativado, pode ser usado para inserir rapidamente o caminho da pasta. Ele só poderá ser usado se o Jitterbit Agente estiver instalado localmente na mesma máquina em que o Design Studio está sendo executado. Se esta opção estiver desativada, pode ser necessário ativar os arquivos locais conforme descrito em Ativando a localização de arquivos locais. Se você selecionar uma pasta ou arquivo usando Procurar, os campos Pasta(s) — e possivelmente Nome(s) de arquivo — serão preenchidos automaticamente.

  • Pasta(s): Insira um caminho local na máquina onde o Jitterbit Agente está instalado que aponta para a pasta onde o(s) arquivo(s) de destino residirão.

    • O caminho não pode conter nenhum destes caracteres: \~ % $ ? " \< >:
    • Os separadores de caminho ('/'ou '\') utilizado deve ser apropriado ao SO da máquina onde o Agente Privado está instalado.
    • Vários caminhos podem ser especificados usando valores delimitados por vírgula. Se vários caminhos forem especificados, o mesmo arquivo será gravado em vários locais.

  • Nome(s) de arquivo(s): Insira o nome desejado para o(s) arquivo(s) de destino. Variáveis podem ser usadas neste campo. Se especificar um arquivo compactado (ZIP), consulte a seção "Compressão" dos parâmetros de conexão adicionais em Opções abaixo. O arquivo será automaticamente gravado no arquivo no nível raiz. (Obrigatório.)

• Testar conexão: Clicando em testará o destino do arquivo local e verificará se uma conexão com a pasta especificada pode ser feita; falhará se o caminho não for válido no sistema operacional onde o Jitterbit Agente está sendo executado. Se você receber um erro, certifique-se de ter habilitado os arquivos locais conforme descrito em Ativando o local do arquivo local.

• Clique no botão Salvar na barra de ferramentas principal ou na barra de ferramentas do destino 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:

• Tipo de fim de linha: Determina como o Jitterbit grava quebras de linha ao gravar em um destino. Observe que os caracteres de fim de linha nos dados não serão convertidos. Opções disponíveis:

  • Padrão: Caracteres de fim de linha padrão para a plataforma em que o Agente está sendo executado.
  • Windows: CRLF (ASCII 13 e ASCII 10)
  • Unix: LF (ASCII 10)

• Escrever cabeçalhos: Se marcado e for um destino de texto simples, um cabeçalho de nomes de colunas/campos será escrito como a primeira linha.

• Não criar arquivos vazios: Se marcada, a criação do arquivo de destino será ignorada se não houver dados de destino.
• Criar diretórios automaticamente: Se marcado, quaisquer diretórios intermediários necessários para completar os caminhos (conforme especificado acima em Parâmetros de conexão) serão criados automaticamente.
• Codificação de caracteres: Usado para especificar uma codificação de caracteres para o arquivo de destino. Se deixado em branco, o Jitterbit tentará detectar a codificação. Para especificar uma codificação diferente daquela padrão, insira uma das codificações suportadas descritas em Codificações de caracteres suportadas.

• Pasta de sucesso/erro: Especifica se as 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, após o processamento bem-sucedido do destino, uma cópia do arquivo será gravada em um arquivo nessa pasta.
  • O arquivo terá o mesmo nome especificado no campo Nome(s) de arquivo acima, mas com um sublinhado final e um carimbo de data/hora adicionado. Se já existir um arquivo com o mesmo nome nessa pasta, um sublinhado adicional e um contador serão adicionados.
  • Exemplo: se um arquivo chamado data.csv for processado com sucesso, uma cópia chamada data.csv_2018-01-01_12-00-00-000 pode ser gravado na pasta especificada como 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 maneira semelhante, se uma pasta de erro for especificada, todos os arquivos que falharem serão gravados em um arquivo na Pasta de Erros.

• Compactação: Se a caixa de seleção Compactar arquivos de destino estiver marcada, os arquivos de destino serão compactados usando o formato ZIP. As opções adicionais são:

  • Nome(s) de arquivo(s) no arquivo: Aceita variáveis e palavras-chave de nome de arquivo. Para manter o nome do arquivo no arquivo igual ao nome do arquivo definido no destino, use um formato de [file].[ext] como mostrado acima.
  • Modo: Um de Substituir ou Anexar. Substituir substituirá um arquivo existente. Para arquivos não criptografados, Anexar adicionará arquivos a um arquivo existente. Este modo está disponível apenas para destinos de arquivo local (e armazenamento temporário).
  • Senha: Para arquivos criptografados, forneça uma senha.
  • Modo de criptografia: Se uma senha for fornecida, dois modos de criptografia estarão disponíveis: AES ou ZIP padrão.