Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Atividade de pesquisa SMB

Introdução

Uma atividade de Pesquisa SMB, usando sua conexão SMB, retorna todos os arquivos dentro de uma pasta em um servidor SMB e se destina a ser usado como uma fonte para fornecer dados em uma operação.

Importante

O conector SMB tem uma limitação em que arquivos individuais maiores que 2 GB podem não ser recuperados.

Criar uma atividade de pesquisa SMB

Uma instância de uma atividade SMB Search é criada a partir de uma conexão SMB usando seu tipo de atividade Pesquisar.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Pesquisa SMB existente pode ser editada nestes locais:

Configurar uma atividade de pesquisa SMB

Siga estas etapas para configurar uma atividade de Pesquisa SMB:

Etapa 1: insira um nome e especifique uma pasta

Nesta etapa, forneça um nome para a atividade e especifique uma pasta. Cada elemento da interface do usuário desta etapa é descrito abaixo.

A interface usada nesta etapa da configuração de uma atividade de Pesquisa SMB depende da opção Escolher pasta selecionada:

Selecione a pasta existente

Se Selecionar pasta existente estiver selecionado para Escolher pasta, esta interface será apresentada:

Lista da etapa 1 da configuração da atividade de pesquisa do SMB

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Pesquisa SMB e não deve conter barras / ou dois pontos :.

  • Escolher pasta: Especifique o método para fornecer o caminho da pasta, um de Selecionar pasta existente ou Informar nome da pasta manualmente:

    • Selecionar pasta existente: Selecione para escolher em uma lista preenchida de pastas. Para usar esta opção, o domínio (especificado durante conexão configuração) deve ter acesso às pastas.

    • Informar nome da pasta manualmente: Selecione para inserir manualmente o caminho da pasta.

  • Selecione uma pasta: Esta seção exibe as pastas disponíveis na pasta SMB especificada na conexão.

    • Pasta selecionada: Depois que uma pasta é selecionada, ela é listada aqui.

  • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de pastas. A pesquisa não diferencia maiúsculas de minúsculas. Se as pastas já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar pastas do endpoint ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

  • Atualizar elementos raiz: Clique no ícone de atualização ou a palavra Refresh Root Elements para recarregar pastas do endpoint SMB. Isso pode ser útil se pastas foram adicionadas ao servidor SMB. Esta ação atualiza todos os metadados usados para construir a tabela de pastas exibida na configuração.

  • Selecionando uma pasta: Dentro da tabela, clique no nome da pasta para selecioná-la. Apenas uma pasta pode ser selecionada.

    • Atualizar: Ao passar o mouse sobre o nome de uma pasta, você pode clicar no ícone de atualização ou a palavra Refresh para carregar as subpastas daquela pasta. Uma vez que quaisquer subpastas sejam preenchidas, elas podem ser selecionadas para uso na atividade.

    Dica

    Se a tabela não for preenchida com pastas disponíveis, a conexão SMB pode não ser bem-sucedido. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

  • Retornar conteúdo do arquivo: Selecione para retornar o conteúdo dos arquivos.

  • Pesquisar em subpastas: Selecione para recuperar arquivos em subpastas.

  • Salvar e sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Informar nome da pasta manualmente

Se Informar nome da pasta manualmente estiver selecionado para Escolher pasta, esta interface será apresentada:

Manual de configuração da etapa 1 da atividade de pesquisa SMB

Dica

Campos com um ícone variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade de Pesquisa SMB e não deve conter barras / ou dois pontos :.

  • Escolher pasta: Especifique o método para fornecer a pasta, um de Selecionar pasta existente ou Informar nome da pasta manualmente:

    • Selecionar pasta existente: Selecione para escolher em uma lista preenchida de pastas.

    • Informar nome da pasta manualmente: Selecione para inserir manualmente o caminho da pasta.

  • Endereço do caminho: Insira o caminho da pasta a ser pesquisada. O caminho deve ser inserido neste formato: example-folder-1/example-sub-folder-13.

  • Retornar conteúdo do arquivo: Selecione para retornar o conteúdo dos arquivos.

  • Pesquisar em subpastas: Selecione para recuperar arquivos em subpastas.

  • Salvar e sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revise os esquemas de dados

Quaisquer esquemas de solicitação ou resposta são exibidos. Cada elemento de interface de usuário desta etapa é descrito abaixo.

Etapa 2 da configuração da atividade de pesquisa SMB

  • Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.

    Os esquemas de dados de solicitação e resposta consistem nestes nós e campos:

    Nó/Campo do Esquema de Resposta Descrição
    root Nó que representa a raiz
    item Nó que representa o arquivo
    error_message String contendo a mensagem de erro, se aplicável
    response String contendo a resposta
    item Nó que representa o arquivo retornado
    path String contendo o caminho para o arquivo
    name String contendo o nome do arquivo
    type String contendo o tipo de arquivo
    content String contendo o conteúdo do arquivo
    index String contendo o índice do dialeto usado

    Importante

    O conector SMB tem uma limitação em que arquivos individuais maiores que 2 GB podem não ser recuperados.

  • Atualizar: Clique no ícone de atualização ou a palavra Refresh para regenerar esquemas do endpoint SMB. Esta ação também regenera um esquema em outros locais em todo o projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximos passos

Após configurar uma atividade de Pesquisa SMB, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas de operação. Você também pode configurar as configurações de operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu para uma atividade são acessíveis a partir do painel do projeto e da quadro de design. Para obter detalhes, consulte menu de ações de atividade em Noções básicas do conector.

As atividades de Pesquisa do SMB podem ser usadas como uma fonte com esses padrões de operação:

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.