Ir para o conteúdo

Crie uma fonte de compartilhamento de arquivo no Jitterbit Design Studio

Introdução

Uma fonte de compartilhamento de arquivos fornece acesso a recursos (arquivos e pastas) usando caminhos UNC do Microsoft Windows File Share.

Pré-requisito

Antes de poder usar o recurso de arquivo de gatilho de uma fonte de Compartilhamento de Arquivos (consulte Opções abaixo), você deve ter habilitado o Local File Location no seu agente privado Jitterbit. Veja Habilitar local de arquivo local para detalhes.

Criar uma fonte de compartilhamento de arquivos

Você pode escolher criar uma nova fonte de Compartilhamento de Arquivos por conta própria ou dentro de uma operação existente. Para obter mais informações sobre como as fontes funcionam dentro das operações, consulte Criar uma operação.

Crie uma nova fonte de compartilhamento de arquivos como uma fonte autônoma

No seu projeto no Jitterbit Design Studio, você cria uma nova fonte de compartilhamento de arquivos por meio de qualquer um dos seguintes:

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

  • Na árvore à 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 anexo.

No pop-up, selecione File Share como o tipo:

anexo

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

Nota

Se você criar uma fonte autônoma usando qualquer um desses métodos, observe que ela não está conectada a uma operação. Consulte Usar uma fonte de compartilhamento de arquivo existente em uma operação existente abaixo para usar a nova fonte.

Crie uma nova fonte de compartilhamento de arquivos 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:

  • Clique duas vezes no ícone da fonte; no pop-up, selecione Criar nova fonte; ou

  • Clique com o botão direito do mouse no ícone da fonte e selecione Criar nova fonte.

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

Use uma fonte de compartilhamento de arquivos existente em uma operação existente

Para usar uma fonte de compartilhamento de arquivos existente em uma operação existente com uma fonte, você pode defini-la por qualquer um dos seguintes:

  • Dentro da operação, clique duas vezes no ícone de origem e, no pop-up resultante, selecione a origem do Compartilhamento de Arquivos desejada na lista; ou

  • Dentro da operação, clique com o botão direito do mouse no ícone de origem, escolha Selecionar origem existente e, no pop-up resultante, selecione a origem de compartilhamento de arquivos desejada na lista; ou

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

Configurar uma fonte de compartilhamento de arquivos

Após criar uma fonte de Compartilhamento de Arquivos, 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 de fonte na operação ou clicando duas vezes na fonte na árvore à esquerda.

Configuração básica

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

anexo

  • Nome: Insira um nome apropriado e exclusivo para a fonte.

  • Tipo: Use o menu suspenso para selecionar Compartilhamento de Arquivos, se ainda não estiver especificado.

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

    • Caminho(s): Insira o(s) caminho(s) de compartilhamento de arquivo da Convenção Universal de Nomenclatura (UNC) que você deseja ler, excluindo o(s) nome(s) de arquivo(s). Ao inserir um caminho, use este formato: \\servername\sharename\path\. Além disso, observe:

      • Caminhos UNC devem começar com duas barras invertidas \\ mas uma barra invertida à direita \ é opcional (por exemplo, \\dropserver\incoming\po).
      • Um endereço IP pode ser usado no lugar do nome do servidor (por exemplo, \\198.51.100.1\mydir).
      • Vários caminhos podem ser especificados usando valores separados por vírgula (por exemplo, \\myserver\mydir, \\120.104.20.69\mydir).

      Importante

      Se estiver usando um grupo de agentes de nuvem, os caminhos UNC funcionam apenas com um endereço IP público no lugar do nome do servidor.

      Todos os grupos de agentes são limitados por restrições impostas pelo compartilhamento de arquivos que está sendo acessado:

      • Eles são vinculados por segurança e controle de acesso definidos para o usuário na origem ou destino para aquele compartilhamento de arquivos fornecido.
      • Se o compartilhamento de arquivos permitir apenas um certo número de conexões, o grupo de agentes ficará vinculado a esse limite.
      • Como a maioria dos compartilhamentos de arquivos não permite que vários usuários alterem um determinado arquivo simultaneamente, se um arquivo estiver sendo usado por outro usuário ou processo, o grupo de agentes não poderá alterá-lo.

    • Login: Se um login for necessário (na forma de DomainName\UserName) para acessar uma unidade de rede compartilhada, insira um nome de usuário válido no campo Login.

    • Senha: Insira uma senha para usar com o Login para acessar uma unidade de rede compartilhada referenciada no campo Caminho(s).

    • Obter arquivos: Insira o nome do(s) arquivo(s) de origem que você deseja ler dentro do diretório especificado em Caminho. Este campo também pode incluir um asterisco * para usar como curinga (por exemplo, *.txt ou *.*) ou um ponto de interrogação ? para corresponder exatamente a um caractere (por exemplo, file?.txt). Variáveis também podem ser usadas neste campo. Se especificar um arquivo compactado (ZIP), veja 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.

      Importante

      Uma fonte de Compartilhamento de Arquivos tem uma limitação em que arquivos individuais maiores que 2 GB podem não ser recuperados.

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

  • Conexão de Teste: Clicar em anexo testará a fonte do File Share; ele falhará se o caminho não for um caminho UNC válido que encontre arquivos no sistema operacional onde o agente Jitterbit está em execução.

  • 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:

anexo

  • Codificação de caracteres: Usado 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 do padrão, insira uma das codificações suportadas descritas em Codificação de caracteres.

  • Arquivo de gatilho: Use isto 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.

    • Depois de 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 (mas 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 que está sendo processado.
    • Uma vez que a operação começa, a operação irá pesquisar, procurando pelo arquivo de gatilho. O intervalo de tempo de pesquisa é fixo em um segundo.
    • O arquivo de gatilho é excluído quando o processamento é iniciado.
    • Se o arquivo de gatilho não for encontrado, a operação continuará tentando encontrá-lo até que o tempo limite da operação se esgote.
    • 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 o tempo limite da operação seja esgotado.

  • Após o processamento:

    • Se a caixa de seleção Excluir arquivo estiver marcada, os arquivos de origem serão excluídos após serem processados.
    • Se um valor for especificado no campo Rename File, 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 Renomear arquivo estiver vazio, ele será ignorado. Se deixado como padrão, nenhum pós-processamento dos arquivos de origem ocorrerá.

  • Ignorar Linhas: Os números indicados de primeiras e últimas linhas que devem ser ignoradas 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 entra em vigor quando uma fonte de compartilhamento de arquivos é referenciada a partir de um script usando o ReadFile ou WriteFile funções.

  • 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. Arquivos criptografados são suportados se uma senha for fornecida. Somente a leitura do diretório raiz do arquivo é suportada.