Ir para o conteúdo

Crie uma Fonte de Compartilhamento de Arquivos

Introdução

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

Pré-requisito

Antes de poder usar o recurso de arquivo acionador de uma fonte de compartilhamento de arquivos (consulte Opções abaixo), você deve ter habilitado o Local File Location em seu Jitterbit Agente Privado. Consulte Ativar localização de arquivo local para detalhes.

Crie uma Fonte de Compartilhamento de Arquivos

Você pode optar por criar uma nova fonte de compartilhamento de arquivos por conta própria ou em uma operação existente. Para obter mais informações sobre como as fontes funcionam nas operações, consulte Criar uma operação.

Crie uma Nova Fonte de Compartilhamento de Arquivos Como Fonte Independente

Dentro do seu projeto no Jitterbit Design Studio, você cria uma nova fonte de compartilhamento de arquivos por 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 verde da fonte anexo.

No pop-up, selecione Compartilhamento de arquivos 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 independente usando qualquer um desses métodos, observe que ela não está conectada a uma operação. Consulte Usar uma fonte de compartilhamento de arquivos existente em uma operação existente abaixo para usar a nova fonte.

Criar uma Nova Fonte de Compartilhamento de Arquivos em uma Operação Existente

Uma origem 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 origem:

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

  • Clicar com o botão direito no ícone da fonte e selecionar Criar nova fonte.

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

Usar 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, clicar duas vezes no ícone da fonte e, no pop-up resultante, selecionar a fonte de compartilhamento de arquivo desejada na lista; ou

  • Dentro da operação, clicar com o botão direito no ícone da fonte, escolher Selecionar Fonte Existente, e no popup resultante, selecionar a fonte de Compartilhamento de Arquivo desejada na lista; ou

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

Configurar uma Fonte de Compartilhamento de Arquivos

Depois de 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 da 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 exclusivo e apropriado 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 da sua conexão de arquivo local:

    • Caminho(s): Insira o(s) caminho(s) de compartilhamento de arquivo da Convenção de Nomenclatura Universal (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, tome nota:

      • Os caminhos UNC devem começar com duas barras invertidas \\ mas uma barra invertida final \ é 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 em 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 estão sujeitos à segurança e ao controle de acesso definidos para o usuário definido na origem ou no destino para aquele compartilhamento de arquivo específico.
      • Se o compartilhamento de arquivos permitir apenas um determinado 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 no 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), 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.
    • Opções de Filtro: Permite especificar se as maiúsculas e minúsculas do nome do arquivo devem ser ignoradas ou se as informações de Obter Arquivos devem ser tratadas como uma expressão regular.

  • Testar conexão: Clicando em anexo testará a fonte do compartilhamento de arquivos; falhará se o caminho não for um caminho UNC válido que encontre arquivos no sistema operacional onde o Jitterbit Agente está sendo executado.

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

  • Arquivo Trigger: Use isto para especificar um arquivo trigger para iniciar o processamento do(s) arquivo(s) de origem. O arquivo acionador é excluído quando o processamento é iniciado.

    • Depois de marcar a caixa de seleção Use Trigger, 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 acionador é excluído quando o processamento é iniciado, o arquivo acionador não pode ser o mesmo arquivo que um arquivo de origem que está sendo processado.
    • Assim que a operação for iniciada, a operação fará uma pesquisa, procurando o arquivo acionador. O intervalo de tempo de votação é fixado em um segundo.
    • O arquivo acionador é excluído quando o processamento é iniciado.
    • Se o arquivo do gatilho não for encontrado, a operação continuará tentando encontrar o arquivo do gatilho até que a operação expire.
    • Definir um arquivo acionador bloqueia qualquer operação ou script que use a origem até que a condição do arquivo acionador seja satisfeita ou a operação expire.

  • Após 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 Renomear arquivo, o arquivo será renomeado usando o padrão fornecido. Variáveis podem ser usadas neste campo.
    • Somente uma opção de exclusão ou renomeação é aceita; se a caixa de seleção Excluir arquivo estiver marcada, Renomear arquivo será desativado 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 da primeira e da última linha que devem ser 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 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 Os dados de origem estão comprimidos estiver marcada, os arquivos de origem serão descompactados usando o formato ZIP. Uma Senha (para arquivos criptografados) pode ser especificada. Arquivos criptografados serão suportados se uma senha for fornecida. Somente a leitura do diretório raiz do arquivo é suportada.