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.

Você pode adicionar controles, incluindo botões e rótulos, para realizar essas funções em seu aplicativo. Por exemplo, você pode adicionar caixas de texto de entrada em seu aplicativo que solicitam informações de email, incluindo o destinatário, o assunto e o corpo do email. Em seguida, adicione um botão Enviar que envia o 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.

Importante: quando este artigo foi escrito, as funções para calendário e contatos não tinham suporte.

 

O que você precisa para começar

Conectar ao Office 365

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

    Conectar 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.

Use a conexão do Office 365 Outlook em seu aplicativo

Mostrar email

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

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

    Office365.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.From. Defina o segundo rótulo como ThisItem.Subject. Defina o terceiro rótulo como ThisItem.Body. 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 Itens da galeria como uma das fórmulas a seguir:

    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 email

  1. No menu Inserir, selecione Text e, em seguida, selecione Text input. Faça isso três vezes para criar três controles de entrada de texto diferentes. Organize-os em uma coluna:

  2. Renomeie-os como:

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

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

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

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

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

Excluir email

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

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

    Office365.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 EmailID:

    Fechar o painel Opções

  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:

    Office365.DeleteEmail(EmailID.Text)

  6. Pressione F5 ou selecione o botão Visualizar ( ). Selecione um dos emails na galeria e clique no botão.

    Observação isso exclui o email selecionado da caixa de entrada. Portanto, escolha com sabedoria.

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

Marcar email como lido

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

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

    Office365.MarkAsRead(EmailID.Text)

  2. Pressione F5 ou selecione o botão Visualizar ( ). Selecione um dos emails não lidos e clique no botão.

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

Exibir as funções disponíveis

Essa conexão inclui as seguintes funções:

Nome da Função Descrição
GetEmails Recupera emails de uma pasta
SendEmail Envia uma mensagem de email
DeleteEmail Exclui uma mensagem de email usando a ID da mensagem
MarkAsRead Marca uma mensagem de email como tendo sido lida
ReplyTo Responde uma mensagem de email
GetAttachment Recupera o anexo da mensagem pela ID
OnNewEmail Dispara um fluxo quando chega um novo email
SendMailWithOptions Envie um email com várias opções e aguarde o destinatário responder com uma das opções.
SendApprovalMail Envie um email de aprovação e aguarde uma resposta do destinatário.

GetEmails

Receber emails: recupera emails de uma pasta

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
folderPath cadeia de caracteres não Caminho da pasta para recuperar mensagens (padrão: 'inbox')
Início inteiro não Número de emails a serem recuperados (padrão: 10)
fetchOnlyUnread booliano não Recuperar somente mensagens não lidas? (padrão: true)
includeAttachments booliano não Se definido como true, os anexos também serão recuperados junto com a mensagem de email. (padrão: false)
searchQuery cadeia de caracteres não Consulta de pesquisa para filtrar emails
Ignorar inteiro não Número de emails a serem ignorados (padrão: 0)
skipToken cadeia de caracteres não Ignorar o token para buscar a nova página

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
valor matriz sim Receba mensagens de email que podem incluir as seguintes propriedades:
  • De (opcional)
  • Para (obrigatório)
  • Assunto (obrigatório)
  • Corpo (obrigatório)
  • Importância (opcional): "Baixa", "Normal" ou "Alta"
  • HasAttachment (opcional)
  • ID (opcional)
  • IsRead (opcional)
  • DateTimeReceived (opcional)
  • Anexos (opcionais): receber um anexo. As propriedades de anexo incluem ID (obrigatória), ContentType (obrigatório), Nome (obrigatório), ContentBytes (obrigatório).
  • Cc (opcional)
  • Cco (opcional)
  • IsHtml (opcional)

SendEmail

Enviar email: envia uma mensagem de email

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
emailMessage sim Instância de mensagens de email que pode incluir as seguintes propriedades:
  • Anexo (opcional): enviar um anexo. Propriedades de anexo incluem Nome (obrigatório) e ContentBytes (obrigatório).
  • De (opcional)
  • Cc (opcional)
  • Cco (opcional)
  • Assunto (obrigatório)
  • Corpo (obrigatório)
  • Importância (opcional): "Baixa", "Normal" ou "Alta"
  • IsHtml (opcional): Inserir true ou false
  • Para (obrigatório): endereços de email separados por vírgula.

Propriedades de saída

Nenhuma.

DeleteEmail

Excluir email: exclui uma mensagem de email pela ID

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
messageId cadeia de caracteres sim ID da mensagem a ser excluída.

Propriedades de saída

Nenhuma.

MarkAsRead

Marcar como lido: marca uma mensagem de email como tendo sido lida

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
messageId cadeia de caracteres sim ID da mensagem a ser marcada como lida

Propriedades de saída

Nenhuma.

ReplyTo

Responder à mensagem: responde a uma mensagem de email

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
messageId cadeia de caracteres sim ID da mensagem a ser respondida
comentário cadeia de caracteres sim Comentário de resposta
replyAll booliano não Responder a todos os destinatários

Propriedades de saída

Nenhuma.

GetAttachment

Obter anexo: recupera o anexo da mensagem pela ID

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
messageId cadeia de caracteres sim ID da mensagem
attachmentId cadeia de caracteres sim ID do anexo a ser baixado

Propriedades de saída

Nenhuma.

OnNewEmail

No novo email: aciona um fluxo quando chega um novo email

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
folderPath cadeia de caracteres não Pasta de email para recuperar (padrão: Inbox, Inbox\ToMe etc.)
a cadeia de caracteres não Endereços de email do destinatário
de cadeia de caracteres não Do endereço
importância cadeia de caracteres não Importância do email (alta, Normal, baixa) (padrão: Normal)
fetchOnlyWithAttachment booliano não Recuperar somente os emails com um anexo
includeAttachments booliano não Incluir anexos
subjectFilter cadeia de caracteres não Cadeia de caracteres a ser procurada no assunto.

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
valor matriz Não

SendMailWithOptions

Enviar email com opções: envie um email com várias opções e aguarde o destinatário responder com uma das opções.

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
optionsEmailSubscription sim Solicitação de assinatura para opções de email, incluindo:
  • NotificationUrl (opcional)
  • Mensagem (opcional)

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
ID cadeia de caracteres Não
recurso cadeia de caracteres Não
notificationType cadeia de caracteres Não
notificationUrl cadeia de caracteres Não

SendApprovalMail

Enviar email de aprovação: envie um email de aprovação e aguarde uma resposta do destinatário.

Propriedades de entrada

Nome Tipo de Dados Obrigatório Descrição
approvalEmailSubscription sim Solicitação de assinatura para email de aprovação, incluindo:
  • NotificationUrl (opcional)
  • Mensagem (opcional)

Propriedades de saída

Nome da Propriedade Tipo de Dados Obrigatório Descrição
ID cadeia de caracteres Não
recurso cadeia de caracteres Não
notificationType cadeia de caracteres Não
notificationUrl cadeia de caracteres Não

Links Úteis