Подключение к Office 365 Outlook из Power Apps

При подключении к Office 365 Outlook вы можете отображать, отправлять, удалять и отвечать на сообщения электронной почты, а также другие задачи.

Вы можете добавить элементы управления для выполнения этих функций в приложении. Например, можно добавить элементы управления вводом текста для запроса получателя, темы и текста сообщения электронной почты и добавления элемента управления Button для отправки сообщения электронной почты.

В этой статье показано, как добавить Office 365 Outlook в качестве подключения, добавить Office 365 Outlook в качестве источника данных в приложение и использовать эти данные в различных элементах управления.

Предпосылки

• Доступ к Power Apps
• Добавление подключения
• Создание приложения из шаблона, из данных или с нуля

Подключение к Office 365 Outlook

1. Добавьте подключение к данным и выберите Office 365 Outlook:

   

2. Выберите "Подключиться" и при появлении запроса на вход введите рабочую учетную запись.

Подключение к Office 365 Outlook было создано и добавлено в приложение. Теперь он готов к использованию.

Отображение сообщений

1. В меню "Вставка " выберите коллекцию и выберите пустой вертикальный элемент управления.

2. Задайте для свойства Items следующую формулу:

   Office365Outlook.GetEmails({fetchOnlyUnread:false})

   После изменения параметров измените макет на название, подзаголовок, текст.

   Элемент управления коллекции автоматически заполняется некоторыми вашими электронными письмами.

3. В коллекции задайте для свойства Text первой метки ThisItem.Fromзначение . Задайте для второй метки ThisItem.Subjectзначение . Задайте для третьей метки ThisItem.BodyPreviewзначение . Вы также можете изменить размер меток.

   Элемент управления коллекции автоматически заполняется новыми свойствами.

4. Эта функция имеет несколько необязательных параметров. Задайте свойству Items коллекции одно из следующих формул:

   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})

Отправка сообщения

1. В меню "Вставка " выберите "Текст" и выберите ввод текста.

2. Повторите предыдущий шаг 2 еще раз, чтобы у вас было три поля, а затем упорядочить их в столбце:

   

3. Переименуйте элементы управления в:

   • inputTo
   • inputSubject
   • inputBody

4. В меню "Вставка " выберите "Элементы управления", а затем нажмите кнопку. Задайте для свойства OnSelect следующую формулу:

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

5. Переместите кнопку, чтобы она отображалась во всех других элементах управления и задайте для свойства Text значение "Отправить сообщение электронной почты".

6. Нажмите клавишу F5 или нажмите Введите допустимый адрес электронной почты в inputTo и введите все, что вы хотите, в других двух элементах управления вводом текста .

7. Выберите "Отправить сообщение" для отправки сообщения. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

Отправка сообщения с вложением

Например, можно создать приложение, в котором пользователь принимает фотографии с помощью камеры устройства, а затем отправляет их в виде вложений. Пользователи также могут вложить множество других типов файлов в почтовое приложение.

Чтобы добавить вложение в сообщение, выполните действия, описанные в предыдущем разделе, но добавьте параметр для указания вложения (при настройке свойства OnSelect кнопки). Этот параметр структурирован как таблица, в которой указывается до трех свойств для каждого вложения:

• Имя
• ContentBytes
• @odata.type

В этом примере фотография будет отправлена как file1.jpg:

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

В этом примере звуковой файл будет отправлен в дополнение к фотографии:

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

Удаление сообщения

1. В меню "Вставка " выберите коллекцию и выберите элемент управления "Коллекция текста ".

2. Задайте для свойства Items следующую формулу:

   Office365Outlook.GetEmails({fetchOnlyUnread:false})

   Элемент управления коллекции автоматически заполняется некоторыми вашими электронными письмами.

3. В коллекции задайте для свойства Text первой метки ThisItem.Idзначение . Задайте для второй метки ThisItem.Subjectзначение . Задайте для третьей метки ThisItem.Bodyзначение .

4. Выберите первую метку в коллекции и переименуйте ее в EmailID:

   

5. Выберите третью метку в коллекции и добавьте кнопку (меню "Вставить "). Задайте свойству OnSelect кнопки следующую формулу:

   Office365Outlook.DeleteEmail(EmailID.Text)

6. Нажмите клавишу F5 или нажмите Выберите одно из сообщений электронной почты в коллекции и нажмите кнопку.

   Замечание

   При этом удаляется выбранная электронная почта из папки "Входящие". Итак, мудро выбирайте.

7. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

Пометка сообщения как прочитанного

В этом разделе используются те же элементы управления, что и удаление сообщения.

1. Задайте свойству OnSelect кнопки следующую формулу:

   Office365Outlook.MarkAsRead(EmailID.Text)

2. Нажмите клавишу F5 или нажмите Выберите одно из непрочитанных сообщений электронной почты и нажмите кнопку.

3. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

См. также

• Список всех функций и их параметров см. в справочнике по Office 365 Outlook.
• Просмотрите все доступные подключения.
• Узнайте, как управлять подключениями.