Подключение к Office 365 Outlook из PowerAppsConnect to Office 365 Outlook from PowerApps

Outlook в Office 365

Подключившись к Office 365 Outlook, вы, помимо других задач, получаете возможность отображать, отправлять и удалять сообщения электронной почты, а также отвечать на них.If you connect to Office 365 Outlook, you can show, send, delete, and reply to email messages, in addition to other tasks.

Можно добавить элементы управления для выполнения этих функций в приложении.You can add controls to perform these functions in your app. Например, можно добавить элементы управления Текстовый ввод для запроса данных получателя, темы и текста сообщения электронной почты и Кнопка для отправки сообщения.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.

В этой статье описывается, как добавлять Office 365 Outlook в качестве подключения и источника данных в приложение, а также как использовать эти данные в других элементах управления.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.

Важно! На момент написания статьи операция календаря не поддерживает повторяющиеся события.Important: As of this writing, the calendar operation doesn't support recurring events.

 

What you need to get started

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

  1. Добавьте подключение данных и выберите Office 365 Outlook:Add a data connection and select Office 365 Outlook:

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

  2. Выберите Подключиться и при появлении запроса на вход введите данные своей рабочей учетной записи.Select Connect, and if prompted to sign in, enter your work account.

Подключение Office 365 Outlook создано и добавлено в приложение.The Office 365 Outlook connection has been created and added to your app. Теперь оно готово к использованию.Now, it's ready to be used.

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

  1. В меню Вставка выберите Коллекция, а затем — элемент управления Коллекция текста.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Задайте для свойства Items следующую формулу:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    Элемент управления "Коллекция" автоматически заполняется некоторыми сообщениями электронной почты.The gallery control is automatically populated with some of your emails.

  3. В коллекции задайте для свойства Text первой метки значение ThisItem.From.In the gallery, set the Text property of the first label to ThisItem.From. Задайте для второй метки значение ThisItem.Subject.Set the second label to ThisItem.Subject. Задайте для третьей метки значение ThisItem.Body.Set the third label to ThisItem.Body. Вы также можете изменить размер меток.You can also resize the labels.

    Элемент управления "Коллекция" автоматически заполняется новыми свойствами.The gallery control is automatically populated with the new properties.

  4. Эта функция получает доступ к нескольким необязательным параметрам.This function has several optional parameters available. Задайте для свойства Items коллекции одну из следующих формул: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})

Отправка сообщенийSend a message

  1. В меню Вставка выберите Текст, а затем — Ввод текста.On the Insert menu, select Text, and then select Text input.
  2. Повторите предыдущий шаг еще дважды, чтобы создать три поля и разместить их в столбце:Repeat the previous step two more times so that you have three boxes, and then arrange them in a column:

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

    • inputTo;inputTo
    • inputSubject;inputSubject
    • inputBody.inputBody
  4. В меню Вставка выберите Элементы управления, а затем — Кнопка.On the Insert menu, select Controls, and then select Button. Задайте для свойства OnSelect следующую формулу:Set its OnSelect property to the following formula:

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

  5. Переместите кнопку, чтобы она отображалась под другими элементами управления, и задайте для свойства Text значение Отправить электронное письмо.Move the button so that it appears under all the other controls, and set its Text property to "Send email".
  6. Нажмите клавишу F5 или кнопку предварительного просмотра ().Press F5, or select the Preview button (). Введите действительный адрес электронной почты в inputTo, а также любой текст в двух других элементах управления для ввода текста.Type in a valid email address in inputTo, and type whatever you want in the other two Text input controls.
  7. Нажмите кнопку Отправить электронное письмо для отправки сообщения.Select Send email to send the message. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.Press Esc to return to the default workspace.

Отправка сообщения с вложениемSend a message with an attachment

Можно создать, к примеру, приложение для фотосъемки с помощью камеры устройства и отправки снимков в виде вложений.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. Кроме того, пользователи могут вложить в приложение электронной почты файлы других типов.Users can also attach many other kinds of files to an email app.

Чтобы добавить вложение в сообщение, выполните действия, описанные в предыдущем разделе, добавив параметр для указания вложения (при настройке свойства OnSelect для кнопки).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). Этот параметр оформлен в виде таблицы, в которой можно указать до трех свойств для каждого вложения:This parameter is structured as a table in which you specify up to three properties for each attachment:

  • ИмяName
  • ContentBytesContentBytes
  • @odata.type

Примечание. Можно указать свойство @odata.type только для одного вложения, а также задать для него пустую строку.Note: You can specify the @odata.type property for only one attachment, and you can set it to an empty string.

В этом примере фото будет отправлено в виде файла 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':""})})

В этом примере фото будет сопровождаться звуковым файлом: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 })})

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

  1. В меню Вставка выберите Коллекция, а затем — элемент управления Коллекция текста.On the Insert menu, select Gallery, and then select a Text gallery control.
  2. Задайте для свойства Items следующую формулу:Set its Items property to the following formula:

    Office365.GetEmails({fetchOnlyUnread:false})

    Элемент управления "Коллекция" автоматически заполняется некоторыми сообщениями электронной почты.The gallery control is automatically populated with some of your emails.

  3. В коллекции задайте для свойства Text первой метки значение ThisItem.Id.In the gallery, set the Text property of the first label to ThisItem.Id. Задайте для второй метки значение ThisItem.Subject.Set the second label to ThisItem.Subject. Задайте для третьей метки значение ThisItem.Body.Set the third label to ThisItem.Body.
  4. Выберите первую метку в коллекции и переименуйте ее на Идентификатор сообщения.Select the first label in the gallery, and rename it to EmailID:

    Закрытие области "Параметры"

  5. Выберите третью метку в коллекции и добавьте кнопку (меню Вставка).Select the third label in the gallery, and add a Button (Insert menu). Задайте для свойства OnSelect кнопки следующую формулу:Set the button's OnSelect property to the following formula:

    Office365.DeleteEmail(EmailID.Text)

  6. Нажмите клавишу F5 или кнопку предварительного просмотра ().Press F5, or select the Preview button (). Выберите одно из сообщений электронной почты в коллекции и нажмите кнопку.Select one of the emails in your gallery, and click the button.

    Примечание. Это действие удалит выбранное сообщение из папки "Входящие".NOTE This deletes the selected email from your inbox. Так что выбирайте осмотрительно.So, choose wisely.
  7. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.Press Esc to return to the default workspace.

Добавление к сообщению пометки о прочтенииMark a message as read

В этом разделе используются те же элементы управления, что и в предыдущем.This section uses the same controls as Delete email.

  1. Задайте для свойства OnSelect кнопки следующую формулу:Set the button's OnSelect property to the following formula:

    Office365.MarkAsRead(EmailID.Text)

  2. Нажмите клавишу F5 или кнопку предварительного просмотра ().Press F5, or select the Preview button (). Выберите одно из непрочитанных сообщений и нажмите кнопку.Select one of the unread emails, and then click the button.
  3. Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.Press Esc to return to the default workspace.