Ligar ao Office 365 Outlook a partir do Power Apps

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.

Pré-requisitos

• Acesso ao Power Apps
• Adicionar a ligação
• Crie uma aplicação a partir de um modelo, dados ou de raiz

Ligar ao Office 365 Outlook

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

   

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 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 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:

   

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 (). 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:

• Name
• ContentBytes
• @odata.type

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 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:

   

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 (). 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 (). 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

• Para obter uma lista de todas as funções e os respetivos parâmetros, veja a Office 365 Referência do Office 365 Outlook.
• Veja todas as ligações disponíveis.
• Saiba como gerir as suas ligações.