Ligar ao Office 365 Outlook a partir do PowerAppsConnect to Office 365 Outlook from PowerApps

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.If you connect to Office 365 Outlook, you can show, send, delete, and reply to email messages, in addition to other tasks.

Pode adicionar controlos para executar estas funções na sua aplicação.You can add controls to perform these functions in your app. 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.For example, you can add Text input controls to ask for the recipient, the subject, and the body of the email, and add a Button control to send the email.

Este tópico mostra 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.This topic shows you how to add Office 365 Outlook as a connection, add Office 365 Outlook as a data source to your app, and use this data in different controls.

Importante

A partir da data deste artigo, a operação de calendário não suporta eventos periódicos.As of this writing, the calendar operation doesn't support recurring events.

Pré-requisitosPrerequisites

Ligar ao Office 365 OutlookConnect to Office 365 Outlook

  1. Adicione uma ligação de dados e selecione Office 365 Outlook:Add a data connection and select Office 365 Outlook:

    Ligar ao Office 365

  2. Selecione Ligar e se lhe for pedido para iniciar sessão, introduza a sua conta profissional.Select Connect, and if prompted to sign in, enter your work account.

A ligação do Office 365 Outlook foi criada e adicionada à sua aplicação.The Office 365 Outlook connection has been created and added to your app. Agora está pronta a ser utilizada.Now, it's ready to be used.

Mostrar mensagensShow messages

  1. No menu Inserir, selecione Galeria e, em seguida, selecione um controlo da Galeria de texto.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Defina a respetiva propriedade Items como a fórmula seguinte:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    O controlo de galeria é preenchido automaticamente com algumas das suas mensagens de e-mail.The gallery control is automatically populated with some of your emails.

  3. Na galeria, defina a propriedade Text da primeira etiqueta como ThisItem.From.In the gallery, set the Text property of the first label to ThisItem.From. Defina a segunda etiqueta como ThisItem.Subject.Set the second label to ThisItem.Subject. Defina a terceira etiqueta como ThisItem.Body.Set the third label to ThisItem.Body. Também pode redimensionar as etiquetas.You can also resize the labels.

    O controlo de galeria é preenchido automaticamente com as novas propriedades.The gallery control is automatically populated with the new properties.

  4. Esta função tem vários parâmetros opcionais disponíveis.This function has several optional parameters available. Defina a propriedade Items da galeria como uma das fórmulas seguintes:Set the gallery's Items property to one of the following formulas:

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

Enviar uma mensagemSend a message

  1. No menu Inserir, selecione Texto e, em seguida, selecione Introdução de texto.On the Insert menu, select Text, and then select Text input.
  2. Repita o passo anterior mais duas vezes, de modo a que tenha três caixas e, em seguida, disponha-as numa coluna:Repeat the previous step two more times so that you have three boxes, and then arrange them in a column:

    Três caixas numa coluna

  3. Mude o nome dos controlos para:Rename the controls to:

    • inputToinputTo
    • inputSubjectinputSubject
    • inputBodyinputBody
  4. No menu Inserir, selecione Controlos e, em seguida, selecione Botão.On the Insert menu, select Controls, and then select Button. Defina a respetiva propriedade OnSelect como a fórmula seguinte:Set its OnSelect property to the following formula:

    Office365.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".Move the button so that it appears under all the other controls, and set its Text property to "Send email".
  6. Prima F5 ou selecione o botão de Pré-visualização (botão de Pré-visualização).Press F5, or select the Preview button (Preview button). Introduza um endereço de e-mail válido em inputTo e escreva o que quiser nos outros dois controlos de Entrada de texto.Type in a valid email address in inputTo, and type whatever you want in the other two Text input controls.
  7. Selecione Enviar e-mail para enviar a mensagem.Select Send email to send the message. Prima Esc para voltar à área de trabalho predefinida.Press Esc to return to the default workspace.

Enviar uma mensagem com um anexoSend a message with an attachment

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.You can, for example, create an app in which the user takes pictures by using the device's camera and then sends them as attachments. Os utilizadores também podem anexar muitos outros tipos de ficheiros a uma aplicação de e-mail.Users can also attach many other kinds of files to an email app.

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).To add an attachment to a message, follow the steps in the previous section, but add a parameter to specify an attachment (when you set the OnSelect property of the button). Este parâmetro está estruturado como uma tabela na qual especifica até três propriedades para cada anexo:This parameter is structured as a table in which you specify up to three properties for each attachment:

  • NomeName
  • ContentBytesContentBytes
  • @odata.type

Nota

Só pode especificar a propriedade @odata.type para um anexo e pode defini-la como uma cadeia vazia.You can specify the @odata.type property for only one attachment, and you can set it to an empty string.

Neste exemplo, uma fotografia será enviada como file1.jpg:In this example, a photo will be sent as file1.jpg:

Office365.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:In this example, an audio file will be sent in addition to the photo:

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

Eliminar uma mensagemDelete a message

  1. No menu Inserir, selecione Galeria e, em seguida, selecione um controlo da Galeria de texto.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Defina a respetiva propriedade Items como a fórmula seguinte:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    O controlo de galeria é preenchido automaticamente com algumas das suas mensagens de e-mail.The gallery control is automatically populated with some of your emails.

  3. Na galeria, defina a propriedade Text da primeira etiqueta como ThisItem.Id.In the gallery, set the Text property of the first label to ThisItem.Id. Defina a segunda etiqueta como ThisItem.Subject.Set the second label to ThisItem.Subject. Defina a terceira etiqueta como ThisItem.Body.Set the third label to ThisItem.Body.
  4. Selecione a primeira etiqueta na galeria e mude o nome da mesma para EmailID:Select the first label in the gallery, and rename it to EmailID:

    Mudar o nome da primeira etiqueta

  5. Selecione a terceira etiqueta na galeria e adicione um Botão (menu Inserir).Select the third label in the gallery, and add a Button (Insert menu). Defina a propriedade OnSelect do botão como a fórmula seguinte:Set the button's OnSelect property to the following formula:

    Office365.DeleteEmail(EmailID.Text)

  6. Prima F5 ou selecione o botão de Pré-visualização (Press F5, or select the Preview button (Botão de Pré-visualização).). Selecione uma das mensagens de e-mail da sua galeria e clique no botão.Select one of the emails in your gallery, and click the button.

    Nota

    Esta ação elimina a mensagem de e-mail selecionada da sua caixa de entrada.This deletes the selected email from your inbox. Por isso, escolha de forma sensata.So, choose wisely.

  7. Prima Esc para voltar à área de trabalho predefinida.Press Esc to return to the default workspace.

Marcar uma mensagem como lidaMark a message as read

Esta secção utiliza os mesmos controlos que Eliminar uma mensagem.This section uses the same controls as Delete a message.

  1. Defina a propriedade OnSelect do botão como a fórmula seguinte:Set the button's OnSelect property to the following formula:

    Office365.MarkAsRead(EmailID.Text)

  2. Prima F5 ou selecione o botão de Pré-visualização (Press F5, or select the Preview button (Botão de Pré-visualização).). Selecione uma das mensagens de e-mail não lidas e, em seguida, clique no botão.Select one of the unread emails, and then click the button.
  3. Prima Esc para voltar à área de trabalho predefinida.Press Esc to return to the default workspace.