Outlook в Office 365

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

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

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

Важно! На момент написания этой статьи функции календаря и контактов не поддерживаются.

 

Что нужно для начала работы

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

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

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

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

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

Использование подключения Office 365 Outlook в приложении

Отображение электронной почты

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

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

    Office365.GetEmails({fetchOnlyUnread:false})

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

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

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

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

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

Отправка сообщения электронной почты

  1. В меню Вставка выберите Текст, а затем — Ввод текста. Выполните это действие три раза, чтобы создать три разных элемента управления для ввода текста. Упорядочите их в виде столбца:

  2. Назначьте им следующие имена:

    • inputTo;
    • inputSubject;
    • inputBody.
  3. В меню Вставка выберите Элементы управления, а затем — Кнопка. Задайте для свойства OnSelect следующую формулу:

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

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

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

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

Удаление сообщения электронной почты

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

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

    Office365.GetEmails({fetchOnlyUnread:false})

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

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

  4. Выберите первую метку в коллекции и переименуйте ее на Идентификатор сообщения.

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

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

    Office365.DeleteEmail(EmailID.Text)

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

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

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

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

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

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

    Office365.MarkAsRead(EmailID.Text)

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

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

Просмотр доступных функций

Это подключение включает следующие функции:

Имя функции Описание
GetEmails Получает сообщения электронной почты из папки.
SendEmail Отправляет сообщение электронной почты.
DeleteEmail Удаляет сообщение электронной почты, используя идентификатор.
MarkAsRead Помечает сообщение как прочитанное.
ReplyTo Отвечает на сообщение.
GetAttachment Получает вложение сообщения по идентификатору.
OnNewEmail Активирует последовательность при получении нового сообщения.
SendMailWithOptions Отправляет сообщение с несколькими вариантами и ожидает от получателя ответа с указанием одного из вариантов.
SendApprovalMail Отправляет сообщение с запросом на утверждение и ожидает ответа получателя.

GetEmails

Эта функция получает сообщения из папки.

Входные свойства

Имя Тип данных Требуется Описание
folderPath строка нет Путь к папке для получения сообщений (по умолчанию: "Входящие")
top целое число нет Число получаемых сообщений (по умолчанию: 10)
fetchOnlyUnread логическое значение нет Получает только непрочитанные сообщения (по умолчанию: true)
includeAttachments логическое значение нет Если задано значение true, вложения будут извлекаться вместе с сообщением (по умолчанию: false)
searchQuery строка нет Поисковый запрос для фильтрации сообщений
skip целое число нет Число пропускаемых электронных сообщений (по умолчанию: 0)
skipToken строка нет Токен пропуска для получения новой страницы

Выходные свойства

Имя свойства Тип данных Требуется Описание
value массив да Сообщения могут содержать следующие свойства:
  • From (необязательно);
  • To (обязательно);
  • Subject (обязательно);
  • Body (обязательно);
  • Importance (необязательно): Low, Normal или High;
  • HasAttachment (необязательно);
  • Id (необязательно);
  • IsRead (необязательно);
  • DateTimeReceived (необязательно);
  • Attachments (необязательно): получайте вложение. Свойства вложения: Id (обязательно), ContentType (обязательно), Name (обязательно), ContentBytes (обязательно);
  • Cc (необязательно);
  • Bcc (необязательно);
  • IsHtml (необязательно).

SendEmail

Эта функция отправляет сообщение электронной почты.

Входные свойства

Имя Тип данных Требуется Описание
emailMessage да Экземпляр сообщения, который может содержать следующие свойства:
  • Attachment (необязательно): отправьте вложение. Свойства вложения: Name (обязательно) и ContentBytes (обязательно);
  • From (необязательно);
  • Cc (необязательно);
  • Bcc (необязательно);
  • Subject (обязательно);
  • Body (обязательно);
  • Importance (необязательно): Low, Normal или High;
  • IsHtml (необязательно): введите значения true или false;
  • To (обязательно): разделите адреса электронной почты запятыми.

Выходные свойства

Нет.

DeleteEmail

Эта функция удаляет сообщение по идентификатору.

Входные свойства

Имя Тип данных Требуется Описание
messageId строка да Идентификатор сообщения для удаления

Выходные свойства

Нет.

MarkAsRead

Эта функция помечает сообщение как прочитанное.

Входные свойства

Имя Тип данных Требуется Описание
messageId строка да Идентификатор сообщения, которое нужно отметить как прочитанное

Выходные свойства

Нет.

ReplyTo

Эта функция позволяет ответить на сообщение.

Входные свойства

Имя Тип данных Требуется Описание
messageId строка да Идентификатор сообщения, на которое нужно ответить
comment строка да Ответ на комментарий
replyAll логическое значение нет Ответ всем получателям

Выходные свойства

Нет.

GetAttachment

Эта функция позволяет получить вложение сообщения по идентификатору.

Входные свойства

Имя Тип данных Требуется Описание
messageId строка да Идентификатор сообщения
attachmentId строка да Идентификатор скачиваемого вложения

Выходные свойства

Нет.

OnNewEmail

Эта функция активирует последовательность при получении нового сообщения.

Входные свойства

Имя Тип данных Требуется Описание
folderPath строка нет Папка электронной почты для получения сообщений (по умолчанию: "Входящие", Inbox\ToMe и т. д.)
строка нет Адреса электронной почты получателей
from строка нет Адрес отправителя
importance строка нет Важность электронного сообщения (высокая, обычная, низкая); значение по умолчанию: обычная
fetchOnlyWithAttachment логическое значение нет Получает только электронные сообщения с вложением
includeAttachments логическое значение нет Включает вложения
subjectFilter строка нет Искомая строка в теме

Выходные свойства

Имя свойства Тип данных Требуется Описание
value массив Нет

SendMailWithOptions

Эта функция отправляет сообщение с несколькими вариантами и ожидает от получателя ответа с указанием одного из вариантов.

Входные свойства

Имя Тип данных Требуется Описание
optionsEmailSubscription да Запрос на подписку с вариантами ответа в сообщении, включающий следующие свойства:
  • NotificationUrl (необязательно);
  • Message (необязательно).

Выходные свойства

Имя свойства Тип данных Требуется Описание
Id строка Нет
resource строка Нет
notificationType строка Нет
notificationUrl строка Нет

SendApprovalMail

Эта функция отправляет сообщение с запросом на утверждение и ожидает ответа получателя.

Входные свойства

Имя Тип данных Требуется Описание
approvalEmailSubscription да Запрос на подписку, требующий получения утверждения в сообщении, включающий следующие свойства:
  • NotificationUrl (необязательно);
  • Message (необязательно).

Выходные свойства

Имя свойства Тип данных Требуется Описание
Id строка Нет
resource строка Нет
notificationType строка Нет
notificationUrl строка Нет

Полезные ссылки

  • Сведения о всех доступных подключениях см. здесь.
  • Сведения об управлении подключениями см. здесь.