PowerApps から Office 365 Outlook に接続するConnect to Office 365 Outlook from PowerApps

Office 365 Outlook

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 を接続として追加する方法、アプリに 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.

重要

この記事の執筆時点では、カレンダー操作では定期的なイベントがサポートされていません。As of this writing, the calendar operation doesn't support recurring events.

前提条件Prerequisites

Office 365 Outlook に接続するConnect 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. 2 つ目のラベルを ThisItem.Subject に設定します。Set the second label to ThisItem.Subject. 3 つ目のラベルを 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. [挿入] メニューで、[テキスト][Text input] (テキスト入力) の順に選択します。On the Insert menu, select Text, and then select Text input.
  2. 上記の手順を 2 回繰り返して 3 つのボックスを作成します。次に、作成した 3 つのボックスを一列に配置します。Repeat the previous step two more times so that you have three boxes, and then arrange them in a column:

    3 つのボックスを一列に配置

  3. コントロールの名前を次のように変更します。Rename the controls to:

    • inputToinputTo
    • inputSubjectinputSubject
    • inputBodyinputBody
  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 (Preview button). 有効なメール アドレスを inputTo に入力し、他の 2 つのテキスト入力コントロールに適当なテキストを入力します。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). このパラメーターはテーブルとして構成されており、ここで各添付ファイルの最大 3 つのプロパティを指定します。This parameter is structured as a table in which you specify up to three properties for each attachment:

  • 名前Name
  • ContentBytesContentBytes
  • @odata.type

注意

@odata.type プロパティを指定できる添付ファイルは 1 つだけです。また、このプロパティは空の文字列に設定できます。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. 2 つ目のラベルを ThisItem.Subject に設定します。Set the second label to ThisItem.Subject. 3 つ目のラベルを ThisItem.Body に設定します。Set the third label to ThisItem.Body.
  4. ギャラリーで最初のラベルを選び、名前を EmailID に変更します。Select the first label in the gallery, and rename it to EmailID:

    1 つ目のラベルの名前変更

  5. ギャラリーで 3 つ目のラベルを選び、ボタン ([挿入] メニュー) を追加します。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 (プレビュー ボタン) を選択します。). ギャラリーでメールの 1 つを選び、ボタンをクリックします。Select one of the emails in your gallery, and click the button.

    注意

    選んだメールが受信トレイから削除されます。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 a message.

  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 (プレビュー ボタン) を選択します。). 未開封のメールを 1 つ選び、ボタンをクリックします。Select one of the unread emails, and then click the button.
  3. Esc キーを押して既定のワークスペースに戻ります。Press Esc to return to the default workspace.