Conecte-se ao Office 365 Outlook por meio do PowerAppsConnect to Office 365 Outlook from PowerApps

Outlook do Office 365

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

É possível adicionar controles para executar essas funções em seu aplicativo.You can add controls to perform these functions in your app. Por exemplo, você pode adicionar controles de Entrada de texto para solicitar o destinatário, o assunto e o corpo do email e adicionar um controle de Botão para enviar o email.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 conexão, como adicionar o Office 365 Outlook como uma fonte de dados ao seu aplicativo e como usar esses dados em controles diferentes.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: quando este artigo foi escrito, a operação de calendário não dava suporte para eventos recorrentes.Important: As of this writing, the calendar operation doesn't support recurring events.

 

What you need to get started

Conecte-se ao Office 365 OutlookConnect to Office 365 Outlook

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

    Conectar ao Office 365

  2. Selecione Conectar e, se for solicitado que você entre, insira sua conta corporativa.Select Connect, and if prompted to sign in, enter your work account.

A conexão do Office 365 Outlook foi criada e adicionada ao seu aplicativo.The Office 365 Outlook connection has been created and added to your app. Agora, ele está pronto para ser usado.Now, it's ready to be used.

Mostrar mensagensShow messages

  1. No menu Inserir, selecione Galeria e selecione um controle Galeria de texto.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Defina sua propriedade Itens como a fórmula a seguir:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    O controle da galeria é preenchido automaticamente com alguns dos seus emails.The gallery control is automatically populated with some of your emails.

  3. Na galeria, defina a propriedade Text do primeiro rótulo como ThisItem.From.In the gallery, set the Text property of the first label to ThisItem.From. Defina o segundo rótulo como ThisItem.Subject.Set the second label to ThisItem.Subject. Defina o terceiro rótulo como ThisItem.Body.Set the third label to ThisItem.Body. Também é possível redimensionar os rótulos.You can also resize the labels.

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

  4. Essa função tem vários parâmetros opcionais disponíveis.This function has several optional parameters available. Defina a propriedade Itens da galeria como uma das fórmulas a seguir: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 Text e, em seguida, selecione Text input.On the Insert menu, select Text, and then select Text input.
  2. Repita a etapa anterior mais duas vezes para obter três caixas e, em seguida, as organize em uma coluna:Repeat the previous step two more times so that you have three boxes, and then arrange them in a column:

  3. Renomeie os controles como:Rename the controls to:

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

    Office365.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 Texto como "Enviar email".Move the button so that it appears under all the other controls, and set its Text property to "Send email".
  6. Pressione F5 ou selecione o botão Visualizar ().Press F5, or select the Preview button (). Digite um endereço de email válido em inputTo e digite o que quiser nos outros dois controles 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 email para enviar a mensagem.Select Send email to send the message. Pressione Esc para retornar ao espaço de trabalho padrão.Press Esc to return to the default workspace.

Enviar uma mensagem com um anexoSend a message with an attachment

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.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 usuários também podem anexar vários outros tipos de arquivos em um aplicativo de email.Users can also attach many other kinds of files to an email app.

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).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). Esse parâmetro é estruturado como uma tabela na qual você 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

Observação: você pode especificar a propriedade @odata.type para apenas um anexo e defini-la como uma cadeia de caracteres vazia.Note: You can specify the @odata.type property for only one attachment, and you can set it to an empty string.

Neste exemplo, uma foto 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 arquivo de áudio será enviado além da foto: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 })})

Excluir uma mensagemDelete a message

  1. No menu Inserir, selecione Galeria e selecione um controle Galeria de texto.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Defina sua propriedade Itens como a fórmula a seguir:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    O controle da galeria é preenchido automaticamente com alguns dos seus emails.The gallery control is automatically populated with some of your emails.

  3. Na galeria, defina a propriedade Text do primeiro rótulo como ThisItem.Id.In the gallery, set the Text property of the first label to ThisItem.Id. Defina o segundo rótulo como ThisItem.Subject.Set the second label to ThisItem.Subject. Defina o terceiro rótulo como ThisItem.Body.Set the third label to ThisItem.Body.
  4. Selecione o primeiro rótulo na galeria e renomeie-o EmailID:Select the first label in the gallery, and rename it to EmailID:

    Fechar o painel Opções

  5. Selecione o terceiro rótulo 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 a seguir:Set the button's OnSelect property to the following formula:

    Office365.DeleteEmail(EmailID.Text)

  6. Pressione F5 ou selecione o botão Visualizar ().Press F5, or select the Preview button (). Selecione um dos emails na galeria e clique no botão.Select one of the emails in your gallery, and click the button.

    Observação isso exclui o email selecionado da caixa de entrada.NOTE This deletes the selected email from your inbox. Portanto, escolha com sabedoria.So, choose wisely.
  7. Pressione Esc para retornar ao espaço de trabalho padrão.Press Esc to return to the default workspace.

Marcar uma mensagem como lidaMark a message as read

Esta seção usa os mesmos controles que Excluir email.This section uses the same controls as Delete email.

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

    Office365.MarkAsRead(EmailID.Text)

  2. Pressione F5 ou selecione o botão Visualizar ().Press F5, or select the Preview button (). Selecione um dos emails não lidos e, em seguida, clique no botão.Select one of the unread emails, and then click the button.
  3. Pressione Esc para retornar ao espaço de trabalho padrão.Press Esc to return to the default workspace.