Get Exchange Mail Messages

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

Recupera uma mensagem de email do Exchange.

Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.
• TempoLimiteEmMs - Especifica o período de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. O valor padrão é de 30.000 milissegundos (30 segundos).

Configurações do Exchange

• DescobertaAutomáticaDeEmail — pesquisa automaticamente um servidor do Exchange usando um endereço de email desse servidor. Isso só funciona se o servidor do Exchange tiver a Descoberta Automática habilitada.
• VersãoDoExchange - Especifica a versão mais baixa do Exchange Server que é usada. As opções exibidas nesse campo variam da versão 2007 até a 2013. Observe que o número da versão indica o nível mais baixo de serviço compatível com você. Isso significa que se você tiver um Exchange Server 2016, poderá selecionar a opção Exchange2013.
• Servidor - O host do servidor de email que deve ser usado.

Logon

• Domínio - O domínio do Active Directory ao qual se conectar.
• Senha - A senha da conta do Exchange usada para recuperar a mensagem.
• SenhaSegura — a senha da conta do Exchange usada, como uma string segura.
• Usuário - O nome de usuário da conta do Exchange usada para recuperar a mensagem.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Configurações do Office 365

• IdDoAplicativo - O ID do seu aplicativo do Active Directory do Azure. Este campo é compatível apenas com strings e variáveis String.
• TipoDeAutenticação - As opções de autenticação do Office 365. As opções disponíveis são:

  • NomeDeUsuárioESenha — nome de usuário padrão e login por senha.

    Importante: a propriedade IdDoAplicativo é necessária ao selecionar a autenticação NomeDeUsuário e Senha. Isso garante que a autenticação ROPC seja usada em vez da autenticação básica, que foi descontinuada no Exchange online.
  • Interativo — token interativo (Auth 2.0).
  • Integrada do Windows — autenticação integrada do Windows.
• IdDoDiretório - O ID de seu Active Directory do Azure. Este campo é compatível apenas com strings e variáveis String.

Opções

• FiltrarPorIdsDeMensagens — retorna apenas as mensagens de email com IDs de mensagem especificados. Se definido, o parâmetro FiltrarExpressão é ignorado. Este campo é compatível apenas com variáveis String[].
  Observação: a filtragem por IDs de mensagem é suportada a partir do Exchange Server 2013.
• FilterExpression - retorna apenas as mensagens de e-mail correspondentes à expressão de filtro.
  Observação: a expressão de filtro pode ser usada a partir do Exchange Server 2010.
• ObterAnexos - Especifica se os anexos devem ser recuperados na mensagem de email. Por padrão, essa caixa de seleção está desmarcada.
  Observação: para Exchange Server 2007 SP1, a atividade retorna todos os anexos, incluindo anexos embutidos. Esta é uma limitação da API do Exchange.
• ÉCorpoEmHTML - Especifica se o corpo da mensagem está escrito no formato HTML.
• MarcarComoLido - Especifica se as mensagens recuperadas devem ser marcadas como lidas. Por padrão, essa caixa de seleção está desmarcada.
• ApenasMensagensNãoLidas - Especifica se apenas as mensagens não lidas devem ser recuperadas. Por padrão, essa caixa de seleção fica marcada.
• OrderByDate - Ordena as mensagens de e-mail por data. Escolha uma das duas opções: Mais recentes primeiro, Mais antigos primeiro. O valor padrão é Mais recente primeiro.
• Superior — o número de mensagens a serem recuperadas, começando pela mais recente ou mais antiga, dependendo do parâmetro OrdernarPorData.

Saída

• Mensagens - As mensagens recuperadas como uma coleção de objetos MensagemDoEmail.
  Observação: começando com UiPath.Mail.Activities versão 1.10.4, o objeto MailMessage expõe:

  • O ID da mensagem de uma mensagem de e-mail, por exemplo MailMessage.Headers("Message-ID").
  • As categorias associadas a uma mensagem de correio, por exemplo MailMessage.GetCategories().

Destino

• PastaDeEmail - A pasta de email da qual as mensagens devem ser recuperadas.
  Importante:

  • Para recuperar emails de uma pasta pública, o valor do campo MailFolder deve ser exatamente igual ao nome da pasta pública exibida em Favoritos.
  • Ao usar uma pasta pública, se houver uma pasta pessoal na caixa de correio com o mesmo nome, a atividade retornará os emails da pasta pessoal. Para retornar os e-mails da pasta pública, a pasta pessoal deve ser renomeada.
  • A atividade não suporta itens Posts. Se houver itens Posts na pasta pública, a atividade falhará, a menos que você especifique uma expressão de filtro adequada, por exemplo, FilterExpression = “kind:emails”.
• SharedMailbox - permite a recuperação de mensagens de uma caixa de correio compartilhada vinculada a uma conta de usuário do Exchange.

Exemplos de filtragem

A tabela a seguir mostra exemplos de filtros que podem ser úteis ao consultar mensagens de correio do Exchange:

Consulta	FiltrarExpressão
Todas as mensagens de e-mail que contenham "bem-vindo" no assunto	"subject:welcome"
Todas as mensagens de e-mail que contêm "bem-vindo" no assunto e são de "[e-mail]"	"subject:welcome AND from:""[e-mail]"""
Todas as mensagens de e-mail de uma conta de e-mail de example.com	"from:example.com"
Todas as mensagens de e-mail que contêm "reveja" no corpo	"body:please review"
Todas as mensagens de correio com anexos	"hasattachment:true"
Todas as mensagens de correio com alta importância com um arquivo pdf anexado	"importance:high AND attachments:.pdf"
Todas as mensagens de correio com 'categoria vermelha' e 'categoria azul' como suas categorias	"category:Red category, Blue category"
Todas as mensagens de e-mail do tipo reunião (ex. convites de calendário, respostas)	"kind:meetings"
Todas as mensagens de correio recebidas hoje	"received:today"
Todas as mensagens de correio recebidas em 23/10/2020	"received:10/23/2020"
Todas as mensagens de email recebidas desde 23/10/2020	"received: >=10/23/2020"

Observação: para saber como especificar uma expressão de filtro, leia Executar uma pesquisa AQS usando EWS no Exchange.