Atividade de leitura de arquivo SMB

Introdução

Uma atividade de Leitura de arquivo SMB, utilizando sua conexão SMB, recupera o conteúdo de um arquivo baseado em texto de um servidor SMB. Esta atividade é destinada a ser usada como uma fonte em operações e suporta arquivos JSON e XML.

Criar uma atividade de leitura de arquivo SMB

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

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, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade de Leitura de arquivo SMB existente pode ser editada a partir destes locais:

• A tela de design (veja Menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).

Configurar uma atividade de leitura de arquivo SMB

Siga estas etapas para configurar uma atividade de Leitura de arquivo SMB:

• Etapa 1: Insira um nome e especifique as configurações
  Forneça um nome para a atividade e especifique o caminho da pasta e o arquivo.

• Etapa 2: Forneça o esquema de resposta
  Forneça um esquema de resposta personalizado (opcional).

• Etapa 3: Revise os esquemas de dados
  Quaisquer esquemas de resposta são exibidos.

Etapa 1: Insira um nome e especifique as configurações

Neste passo, forneça um nome para a atividade e especifique um caminho de pasta e arquivo.

A interface para este passo depende da opção Escolher pasta que você selecionar:

• Selecionar pasta existente: Escolha a partir de uma lista de pastas existentes. O domínio (especificado durante a configuração da conexão) deve ter acesso a essas pastas.
• Informar nome da pasta manualmente: Insira o caminho da pasta manualmente.

Selecionar pasta existente

Se você selecionar Selecionar pasta existente para Escolher pasta, esta interface aparece:

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

• Escolher pasta: Selecione a opção Selecionar pasta existente.

• 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: Insira qualquer valor de pasta 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 são filtrados em tempo real a cada tecla pressionada. Para recarregar pastas do endpoint ao pesquisar, insira critérios de pesquisa e, em seguida, atualize, conforme descrito abaixo.

• Atualizar elementos raiz: Clique no ícone de atualização ou nas palavras Atualizar elementos raiz 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.

• Selecionar uma pasta: Dentro da tabela, clique no nome de uma pasta para selecioná-la. Você pode selecionar apenas uma pasta.

  • Atualizar: Ao passar o mouse sobre o nome de uma pasta, clique no ícone de atualização ou na palavra Atualizar para carregar suas subpastas. Uma vez que as subpastas aparecem, você pode selecioná-las para uso na atividade.

  Dica

  Se a tabela não for preenchida com pastas disponíveis, a conexão SMB pode não ter sido bem-sucedida. Certifique-se de que está conectado reabrindo a conexão e testando novamente as credenciais.

• Obter arquivos: Insira o nome e a extensão do arquivo a ser lido.

• 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Informar nome da pasta manualmente

Se você selecionar Informar nome da pasta manualmente para Escolher pasta, esta interface aparece:

• Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Ler arquivo e não deve conter barras / ou dois pontos :.

• Escolher pasta: Selecione a opção Informar nome da pasta manualmente.

• Endereço do caminho: Insira o caminho da pasta que contém o arquivo a ser lido. Use este formato: exemplo-pasta-1/sub-pasta-13.

• Obter arquivos: Insira o nome e a extensão do arquivo a ser lido.

• 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Fornecer o esquema de resposta

Nesta etapa, você pode fornecer um esquema de resposta personalizado.

• Fornecer esquema de resposta: O esquema de resposta define a estrutura dos dados de resposta usados pela atividade Ler arquivo. Para instruções sobre como completar esta seção, consulte Esquemas definidos em uma atividade.

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

• 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Quaisquer esquemas de resposta são exibidos nesta etapa. Cada elemento da interface do usuário desta etapa é descrito abaixo.

• Esquema de dados: Um esquema de resposta fornecido pelo usuário é herdado por uma transformação adjacente e é exibido novamente durante o mapeamento de transformação.

  Nota

  Esta atividade não possui esquemas de resposta padrão. Se você não forneceu um esquema de resposta na etapa 2 da configuração da atividade, você deve definir um em uma transformação.

• 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 ao longo 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 qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Próximas etapas

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

As ações de menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, veja o menu de ações da atividade em Noções básicas sobre conectores.

As atividades SMB Ler arquivo podem ser usadas como fonte com esses padrões de operação:

• Padrão de transformação
• Padrão de arquivo com dois destinos (apenas como a primeira fonte)
• Padrão de arquivo HTTP com dois destinos (apenas como a primeira fonte)

Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, 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.