Atividade de E-mail E-mail¶

Introdução¶

Uma atividade de Ler E-mail E-mail, usando sua Conexão E-mail, recupera e-mail não lidos usando o Internet Message Access Protocol (IMAP) e destina-se a ser usado como uma fonte para fornecer dados para uma operação.

Criar uma Atividade de Leitura E-mail E-mail¶

Uma instância de uma atividade E-mail Ler E-mail é criada a partir de uma Conexão E-mail usando seu tipo de atividade Ler E-mail.

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 Criando uma instância de atividade em Reutilização de componente.

Uma atividade existente E-mail Ler E-mail pode ser editada a partir destes locais:

• A quadro de design (consulte Menu de ações do componente em Quadro de Design).
• A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).

Configurar uma Atividade E-mail de Leitura de E-mail¶

Siga estas etapas para configurar uma atividade E-mail Ler E-mail:

• Etapa 1: Digite um nome e selecione uma pasta
  Forneça um nome para a atividade e selecione uma pasta.

• Etapa 2: especificar filtros
  Especifique os critérios e-mail para filtrar.

• Etapa 3: Revise os Esquemas de Dados
  Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: Digite um Nome e Selecione uma Pasta¶

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

• Nome: Digite um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade E-mail Ler E-mail e não deve conter barras / ou dois pontos :.

• Selecione uma pasta: Esta seção exibe as pastas disponíveis no endpoint E-mail.

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

  • Pesquisar: Digite qualquer parte do nome da pasta na caixa de pesquisa para filtrar a lista de pastas. A busca 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 durante a pesquisa, insira os critérios de pesquisa e, em seguida, atualize, conforme descrito abaixo.

  • Atualizar: Clique no ícone de atualização ou a palavra Atualizar para recarregar as pastas do endpoint E-mail. Isso pode ser útil se as pastas tiverem sido adicionadas ao E-mail. 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 em qualquer lugar em uma linha para selecionar uma pasta. Apenas uma pasta pode ser selecionada. As informações disponíveis para cada pasta são buscadas no endpoint E-mail:

    • Nome: O nome da pasta.

  Dica

  Se a tabela não for preenchida com as pastas disponíveis, a Conexão E-mail pode não ser bem-sucedido. Verifique se você está conectado reabrindo a conexão e testando novamente as credenciais.

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

• Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na 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 as 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: Especifique os Filtros¶

Nesta etapa, especifique os critérios e-mail para filtrar. Cada elemento da interface do usuário desta etapa é descrito a seguir.

• De: Insira um único endereço e-mail do remetente ou um fragmento de um endereço e-mail do remetente.

• Assunto: Insira uma única linha de assunto ou um fragmento de uma linha de assunto.

• Para: Insira um único endereço e-mail de destinatário ou um fragmento de um endereço e-mail de destinatário.

• CC: Insira um único endereço e-mail de destinatário em CC ou parte de um endereço e-mail de destinatário em CC.

• Data de início: Insira a data de início e-mail, no formato de yyyy-mm-dd.

• Data final: Insira a data final e-mail, no formato yyyy-mm-dd.

• Maximum Number of Returns: Insira o número máximo de e-mails não lidos a serem retornados na resposta. Deixe este campo em branco para retornar todas as mensagens não lidas disponíveis.

• Incluir anexos: Selecione para incluir anexos e-mail na resposta (selecionado por padrão).

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

• Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na 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 as 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 3: Revisar os Esquemas de Dados¶

Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito a seguir.

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

  O esquema de dados de resposta consiste nestes nós e campos:

  Nó/campo do esquema de resposta	Descrição
  readEmailResponse	Nó da resposta do e-mail
  item	Nó do item de destinatários de e-mail
  recipients	Nó de destinatários e-mail
  to	Nó de destinatários do campo "para" e-mail
  item	Nó do item de destinatários do campo "para" do e-mail
  #text	Valor de string de um único endereço e-mail do destinatário "para"
  cc	Nó de destinatários do campo "cc" do e-mail
  item	Nó do item de destinatários do campo "cc" do e-mail
  #text	Valor de string de um único endereço e-mail de destinatário "cc"
  dateTime	String da data e hora em que o e-mail foi enviado
  from	String do campo "de" e-mail
  subject	String do campo "assunto" e-mail
  mailBody	String do campo "corpo" e-mail
  attachments	Nó de anexos e-mail
  item	Nó do item de anexos e-mail
  fileName	String do nome de arquivo do anexo e-mail
  base64content	String do conteúdo do anexo codificado em base64 Dica Você pode usar o Jitterbit's Base64Decode para decodificar o conteúdo do anexo.
  fileSize	String do tamanho do arquivo binário para o anexo de e-mail
  fileBase64Length	String do comprimento do caractere codificado em base64 para o anexo e-mail

• Atualizar: Clique no ícone de atualização ou a palavra Atualizar para regenerar esquemas do endpoint E-mail. Essa ação também regenera um esquema em outros locais do projeto em que 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 as 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óximos Passos¶

Depois de configurar uma atividade E-mail Ler E-mail, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo workflows ou em diferentes.

As ações de menu para uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu de ações de atividade em Noções básicas do conector.

As atividades de Ler e - mail E-mail podem ser usadas como fonte com esses padrões de operação:

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

Um caso de uso típico é usar uma atividade E-mail Ler E-mail no Transformation Pattern. Neste exemplo, a atividade E-mail Read E-mail gera uma estrutura de resposta que é recebida pela transformação (Read E-mail Response), que é gravada em uma variável por uma atividade Variable Write (Write Read E-mail Response) e uma mensagem é então registrada pelo script Write to Operation Log:

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 da operação.