Ir para o conteúdo

Atividade SMB Search no Jitterbit Studio

Introdução

Uma atividade SMB Search, usando sua conexão SMB, retorna todos os arquivos em uma pasta do servidor SMB e é destinada a ser usada como fonte para fornecer dados em uma operação.

Importante

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

Criar uma atividade SMB Search

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

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

Uma atividade SMB Search existente pode ser editada a partir destes locais:

Configurar uma atividade SMB Search

Siga estas etapas para configurar uma atividade SMB Search:

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 SMB Search depende da opção Escolher pasta selecionada:

Selecionar pasta existente

Se Selecionar pasta existente for selecionado para Escolher pasta, a interface descrita abaixo será apresentada.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.

  • Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade SMB Search 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 Fornecer nome da pasta manualmente:

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

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

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

    • Pasta selecionada: Após selecionar uma pasta, ela é listada aqui.

  • Pesquisar: Digite o valor de qualquer 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 digitação. Para recarregar pastas do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

  • Atualizar elementos raiz: Clique no ícone de atualização ou na palavra Atualizar elementos raiz para recarregar as 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.

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

    • Atualizar: Ao passar o mouse sobre um nome de pasta, você pode clicar no ícone de atualização ou na palavra Atualizar para carregar as subpastas dessa pasta. Após as subpastas serem preenchidas, elas podem ser selecionadas para uso na atividade.

    Dica

    Se a tabela não for preenchida com as pastas disponíveis, a conexão SMB pode não ter sido bem-sucedida. Certifique-se de estar 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 desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta 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.

Fornecer nome da pasta manualmente

Se Fornecer nome da pasta manualmente for selecionado para Escolher pasta, a interface descrita abaixo será apresentada.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.

  • Menu de endpoint: Se você tiver vários endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Editar endpoint: Aparece ao passar o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.

  • Nome: Digite um nome para identificar a atividade. O nome deve ser único para cada atividade Pesquisar 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 Fornecer nome da pasta manualmente:

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

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

  • Endereço do caminho: Digite 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 Sub-pastas: Selecione para recuperar arquivos em sub-pastas.

  • Salvar e Sair: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.

  • Próximo: Clique para armazenar temporariamente a configuração desta 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.

Etapa 2: Revisar os esquemas de dados

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

  • 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ó representando a raiz
    item Nó representando o arquivo
    error_message String contendo a mensagem de erro, se aplicável
    response String contendo a resposta
    item Nó representando o arquivo retornado
    path String contendo o caminho do 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 na palavra Atualizar para regenerar esquemas do endpoint SMB. Esta ação também regenera um esquema em outros locais do 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 solicita que você confirme que deseja descartar as alterações.

Próximas etapas

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

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

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

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

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.