Conectar-se ao Office 365 Outlook a partir do Power Apps

Office 365 Outlook.

Se você se conectar ao Office 365 Outlook, será possível exibir, enviar, excluir e responder a mensagens de email, além de outras tarefas.

É possível adicionar controles para executar essas funções em seu aplicativo. Por exemplo, você pode adicionar controles Entrada de texto para solicitar o destinatário, o assunto e o corpo do email e adicionar um controle Botão para enviar o email.

Este artigo mostra como adicionar o Office 365 Outlook como uma conexão, como adicionar o Office 365 Outlook como uma fonte de dados ao seu aplicativo e como usar esses dados em controles diferentes.

Importante

Quando este artigo foi escrito, a operação de calendário não dava suporte para eventos recorrentes.

Pré-requisitos

Conectar-se ao Office 365 Outlook

  1. Adicione uma conexão de dados e selecione Office 365 Outlook:

    Conecte-se ao Office 365.

  2. Selecione Conectar e, se for solicitado que você entre, insira sua conta corporativa.

A conexão do Office 365 Outlook foi criada e adicionada ao seu aplicativo. Agora, ele está pronto para ser usado.

Mostrar mensagens

  1. No menu Inserir, selecione Galeria e selecione um controle Vertical em branco.

  2. Defina sua propriedade Items como a fórmula a seguir:

    Office365Outlook.GetEmails({fetchOnlyUnread:false})

    Após mudar as configurações, altere Layout para Título, Subtítulo, Corpo.

    O controle da galeria é preenchido automaticamente com alguns dos seus emails.

  3. Na galeria, defina a propriedade Text do primeiro rótulo como ThisItem.From. Defina o segundo rótulo como ThisItem.Subject. Defina o terceiro rótulo como ThisItem.BodyPreview. Também é possível redimensionar os rótulos.

    O controle da galeria é preenchido automaticamente com as novas propriedade propriedades.

  4. Essa função tem vários parâmetros opcionais disponíveis. Defina a propriedade Items da galeria como uma das fórmulas a seguir:

    Office365Outlook.GetEmails({fetchOnlyUnread:false})
    Office365Outlook.GetEmails({fetchOnlyUnread:false, top:2})
    Office365Outlook.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2})
    Office365Outlook.GetEmails({folderPath:"Sent Items", fetchOnlyUnread:false, top:2, searchQuery:"powerapps"})
    Office365Outlook.GetEmails({folderPath:"Deleted Items", fetchOnlyUnread:false, top:2, skip:3})

Enviar uma mensagem

  1. No menu Inserir, selecione Texto e, em seguida, Entrada de texto.

  2. Repita a etapa anterior mais duas vezes para obter três caixas e, em seguida, as organize em uma coluna:

    Três caixas em uma coluna.

  3. Renomeie os controles como:

    • inputTo;
    • inputSubject;
    • inputBody.
  4. No menu Inserir, selecione Controles e, em seguida, Botão. Defina sua propriedade OnSelect como a fórmula a seguir:

    Office365Outlook.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text)

  5. Mova o botão para que ele apareça em todos os outros controles e defina sua propriedade Text como "Enviar email".

  6. Pressione F5 ou selecione o botão Visualizar (botão Visualizar.). Digite um endereço de email válido em inputTo e digite o que quiser nos outros dois controles Entrada de texto.

  7. Selecione Enviar email para enviar a mensagem. Pressione Esc para retornar ao espaço de trabalho padrão.

Enviar uma mensagem com um anexo

Você pode, por exemplo, criar um aplicativo no qual o usuário tira fotos usando a câmera do dispositivo e, em seguida, as envia como anexos. Os usuários também podem anexar vários outros tipos de arquivos em um aplicativo de email.

Para adicionar um anexo a uma mensagem, siga as etapas na seção anterior, mas adicione um parâmetro para especificar um anexo (quando você definir a propriedade OnSelect do botão). Esse parâmetro é estruturado como uma tabela na qual você especifica até três propriedades para cada anexo:

  • Name
  • ContentBytes;
  • @odata.type

Observação

Você pode especificar a propriedade @odata.type para apenas um anexo e defini-la como uma cadeia de caracteres vazia.

Neste exemplo, uma foto será enviada como file1.jpg:

Office365Outlook.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text, {Attachments:Table({Name:"file1.jpg", ContentBytes:Camera1.Photo, '@odata.type':""})})

Neste exemplo, um arquivo de áudio será enviado junto com a foto:

Office365Outlook.SendEmail(inputTo.Text, inputSubject.Text, inputBody.Text, {Attachments:Table({Name:"file1.jpg", ContentBytes:Camera1.Photo, '@odata.type':""}, {Name:"AudioFile", ContentBytes:microphone1.audio })})

Excluir uma mensagem

  1. No menu Inserir, selecione Galeria e, em seguida, um controle Galeria de texto.

  2. Defina sua propriedade Items como a fórmula a seguir:

    Office365Outlook.GetEmails({fetchOnlyUnread:false})

    O controle da galeria é preenchido automaticamente com alguns dos seus emails.

  3. Na galeria, defina a propriedade Text do primeiro rótulo como ThisItem.Id. Defina o segundo rótulo como ThisItem.Subject. Defina o terceiro rótulo como ThisItem.Body.

  4. Selecione o primeiro rótulo na galeria e renomeie-o como EmailID:

    Renomear primeiro rótulo.

  5. Selecione o terceiro rótulo na galeria e adicione um Botão (menu Inserir). Defina a propriedade OnSelect do botão como a fórmula a seguir:

    Office365Outlook.DeleteEmail(EmailID.Text)

  6. Pressione F5 ou selecione o botão Visualizar (Botão Visualização.). Selecione um dos emails na galeria e selecione o botão.

    Observação

    Isso exclui o email selecionado da caixa de entrada. Portanto, escolha com cuidado.

  7. Pressione Esc para retornar ao espaço de trabalho padrão.

Marcar uma mensagem como lida

Esta seção usa os mesmos controles que Excluir uma mensagem.

  1. Defina a propriedade OnSelect do botão como a fórmula a seguir:

    Office365Outlook.MarkAsRead(EmailID.Text)

  2. Pressione F5 ou selecione o botão Visualizar (Botão Visualização.). Selecione um dos emails não lidos e, em seguida, selecione o botão.

  3. Pressione Esc para retornar ao espaço de trabalho padrão.

Confira também

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).