Criar um destino de arquivo local no Jitterbit Design Studio

Introdução

Um Arquivo Local em um agente privado pode ser usado como um destino 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 Destino 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 um destino de Arquivo Local, você deve ter habilitado a Localização de Arquivo Local em seu agente privado Jitterbit. Veja Habilitando a localização de arquivo local para mais detalhes.

Criar um destino de arquivo local

Você pode optar por criar um novo destino de arquivo local por conta própria ou dentro de uma operação existente. Para mais informações sobre como fontes e destinos funcionam dentro das operações, veja Criando uma operação.

Criar um novo destino de arquivo local como um destino autônomo

Dentro do seu projeto no Jitterbit Design Studio, você cria um novo destino de Compartilhamento de Arquivo por qualquer um dos seguintes métodos:

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

• No painel à esquerda, clique com o botão direito em Destinos e selecione Novo Destino; ou

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

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

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

Criar um novo alvo de arquivo local em uma operação existente

Um alvo é 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 alvo por:

• Clicando duas vezes no ícone do alvo; na janela pop-up, selecione Criar Novo Alvo; ou

• Clicando com o botão direito no ícone do alvo e selecionando Criar Novo Alvo.

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

Usar um alvo de arquivo local existente em uma operação existente

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

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

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

• Arrastando o alvo de Arquivo Local desejado da árvore à esquerda e soltando-o sobre o ícone do alvo existente da operação.

Configurar um alvo de arquivo local

Depois de criar um alvo 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 aparecerá semelhante a este exemplo:

• Nome: Insira um nome apropriado e único para o destino.
• Tipo: Use o menu suspenso 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 usado 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 Nome(s) do Arquivo—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 de destino devem residir.

    • O caminho não pode conter nenhum destes caracteres: \~ % $ ? " \< > :
    • Os separadores de caminho ('/'ou '\') usados devem ser apropriados para o sistema operacional 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) do Arquivo: Insira o nome desejado para os arquivos de destino. Variáveis 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 será gravado automaticamente no arquivo no nível raiz. (Obrigatório.)

• Testar Conexão: Clicar no botão testará o destino de Arquivo Local e verificará se uma conexão com a pasta especificada pode ser feita; falhará se o caminho não for um caminho válido 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 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 escreve quebras de linha ao escrever para 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 um destino de texto plano, um cabeçalho de nomes de coluna/campo será escrito como a primeira linha.

• Não Criar Arquivos Vazios: Se marcado, a criação do arquivo de destino será pulada 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 da padrão, insira uma das codificações suportadas descritas em Codificações de caracteres suportadas.

• Pasta de Sucesso/Erro: Especifica 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 o destino, uma cópia do arquivo será escrita em um arquivo nessa pasta.
  • O arquivo terá o mesmo nome que o especificado no campo Nome do(s) Arquivo(s) 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.
  • 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 escrita 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.
  • Da mesma forma, se uma pasta de erro for especificada, quaisquer arquivos que falharem serão escritos em um arquivo na Pasta de Erro.

• Compressão: Se a caixa de seleção para 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) do arquivo 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] conforme mostrado acima.
  • Modo: Um de Substituir ou Adicionar. Substituir irá substituir um arquivo existente. Para arquivos não criptografados, Adicionar irá incluir arquivos em 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 estão disponíveis: AES ou ZIP Padrão.