Ligar ao Office 365 Outlook a partir do Power Apps

Office 365 Outlook

Se ligar ao Office 365 Outlook, pode mostrar, enviar, eliminar e responder a mensagens de e-mail, para além de outras tarefas.

Pode adicionar controlos para executar estas funções na sua aplicação. Por exemplo, pode adicionar controlos de Entrada de texto para pedir o destinatário, assunto e corpo da mensagem de e-mail e adicionar um controlo de Botão para enviar a mensagem de e-mail.

Este artigo mostra-lhe como adicionar o Office 365 Outlook como uma ligação, adicionar o Office 365 Outlook como uma origem de dados à sua aplicação e utilizar estes dados em diferentes controlos.

Importante

A partir da data deste artigo, a operação de calendário não suporta eventos periódicos.

Pré-requisitos

Ligar ao Office 365 Outlook

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

    Ligar ao Office 365

  2. Selecione Ligar e se lhe for pedido para iniciar sessão, introduza a sua conta profissional.

A ligação do Office 365 Outlook foi criada e adicionada à sua aplicação. Agora está pronta a ser utilizada.

Mostrar mensagens

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

  2. Defina a respetiva propriedade Items como a fórmula seguinte:

    Office365Outlook.GetEmails({fetchOnlyUnread:false})

    Depois de alterar as definições, altere o esquema para título, subtítulo, corpo.

    O controlo de galeria é preenchido automaticamente com algumas das suas mensagens de e-mail.

  3. Na galeria, defina a propriedade Text da primeira etiqueta como ThisItem.From. Defina a segunda etiqueta como ThisItem.Subject. Defina a terceira etiqueta como ThisItem.BodyPreview. Também pode redimensionar as etiquetas.

    O controlo de galeria é preenchido automaticamente com as novas propriedades.

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

    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, selecione Introdução de texto.

  2. Repita o passo anterior mais 2 vezes, de modo a que tenha três caixas e, em seguida, disponha-as numa coluna:

    Três caixas numa coluna

  3. Mude o nome dos controlos para:

    • inputTo
    • inputSubject
    • inputBody
  4. No menu Inserir, selecione Controlos e, em seguida, selecione Botão. Defina a respetiva propriedade OnSelect como a fórmula seguinte:

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

  5. Mova o botão para que seja apresentado em todos os outros controlos e defina a respetiva propriedade Text como "Enviar e-mail".

  6. Prima F5 ou selecione o botão de Pré-visualização (botão de Pré-visualização). Introduza um endereço de e-mail válido em inputTo e escreva o que quiser nos outros dois controlos de Entrada de texto.

  7. Selecione Enviar e-mail para enviar a mensagem. Prima Esc para voltar à área de trabalho predefinida.

Enviar uma mensagem com um anexo

Pode, por exemplo, criar uma aplicação na qual o utilizador tira fotografias através da câmara do dispositivo e, em seguida, envia as mesmas como anexos. Os utilizadores também podem anexar muitos outros tipos de ficheiros a uma aplicação de e-mail.

Para adicionar um anexo a uma mensagem, siga os passos na secção anterior, mas adicione um parâmetro para especificar um anexo (quando define a propriedade OnSelect do botão). Este parâmetro está estruturado como uma tabela na qual especifica até três propriedades para cada anexo:

  • Nome
  • ContentBytes
  • @odata.type

Nota

Nota: só pode especificar a propriedade @odata.type para um anexo e pode defini-la como uma cadeia vazia.

Neste exemplo, uma fotografia 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 ficheiro de áudio será enviado para além da fotografia:

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

Eliminar uma mensagem

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

  2. Defina a respetiva propriedade Items como a fórmula seguinte:

    Office365Outlook.GetEmails({fetchOnlyUnread:false})

    O controlo de galeria é preenchido automaticamente com algumas das suas mensagens de e-mail.

  3. Na galeria, defina a propriedade Text da primeira etiqueta como ThisItem.Id. Defina a segunda etiqueta como ThisItem.Subject. Defina a terceira etiqueta como ThisItem.Body.

  4. Selecione a primeira etiqueta na galeria e mude o nome da mesma para EmailID:

    Mudar o nome da primeira etiqueta

  5. Selecione a terceira etiqueta na galeria e adicione um Botão (menu Inserir). Defina a propriedade OnSelect do botão como a fórmula seguinte:

    Office365Outlook.DeleteEmail(EmailID.Text)

  6. Prima F5 ou selecione o botão de Pré-visualização (botão Pré-visualização). Selecione uma das mensagens de e-mail da sua galeria e selecione o botão.

    Nota

    Esta ação elimina a mensagem de e-mail selecionada da sua caixa de entrada. Por isso, escolha de forma sensata.

  7. Prima Esc para voltar à área de trabalho predefinida.

Marcar uma mensagem como lida

Esta secção utiliza os mesmos controlos que Eliminar uma mensagem.

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

    Office365Outlook.MarkAsRead(EmailID.Text)

  2. Prima F5 ou selecione o botão de Pré-visualização (botão Pré-visualização). Selecione uma das mensagens de e-mail não lidas e, em seguida, selecione o botão.

  3. Prima Esc para voltar à área de trabalho predefinida.

Consulte também

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).