Power Automate クラウドフローでスケジュールを設定したのに、意図した時刻に実行されなかったことはありませんか？
私は夜中の2時に動くよう設定し、翌朝結果を確認してみたら実行されておらず、何が原因かと思ったらまだ開始時刻になっていませんでした…
時刻を指定するだけなのになぜ失敗してしまうのか、注意しておくポイントを押さえましょう。

スケジュール済みクラウドフロー作成の基本

作成ページで「スケジュール済みクラウドフロー」を選択します。
スケジュールの設定画面で、開始日と繰り返し間隔を設定します。
初期設定では今日の10:00AMから、1分ごとに実行となりますが、繰り返し間隔は他に時間・日・週・月などがあり、「週間」にすると曜日を選択することもできます。

開始時刻の見方

先ほど作成したフローを編集画面で見てみると、日付は同じことが分かりますが10:00AMという設定が見当たらず、開始時刻の時間らしき部分は 01:00:00.000Z となっています。
これは10:00AMから自動でUTCに変換されたためです。末尾に「Z」が付いているとUTCと見なされます。
そのため、開始時刻を変更する場合、UTCで設定する必要があります。UTCだと何時になるのか考えて設定しないといけないのです。

UTCとは

協定世界時 【Coordinated Universal Time】
世界の標準時刻の基準として用いられる時刻。UTCは日本標準時（JST）から9時間引いた時間となる。

日本時間で設定する方法

UTCで設定するのは分かりにくいので、タイムゾーンの設定をしましょう。

タイムゾーンに「（UTC+9:00）大阪、札幌、東京」を選択します。
左図、頻度を「日」にした場合は設定時刻（時間・分）を別途設定できるのですが、タイムゾーンが反映されるのはこの設定時刻に対してとなります。
ただし、開始時刻には末尾に「Z」が付いていますので、これはUTCのままです。

開始時刻にもタイムゾーンを反映するには、末尾の「Z」を取ります！
「Z」を取ることでどちらも日本時間で設定することができます。
これで分かりやすくなりますね。

設定時刻があって開始時刻を過ぎた後は、特に困らないと思いますが、開始時刻だけの場合は、開始時刻が起点であり実行時刻となります。
末尾「Z」を取って、間違いなく目的の時間に実行させましょう！

（おまけ）アクションで日時を扱う時はタイムゾーン変換

スケジュール実行ではなく、クラウドフローの処理の中で日時を扱うことがあります。

”現在の時刻”で取得した日時もUTCですので、日本時間として扱いたい場合は”タイムゾーン変換”を使いましょう。この二つのアクションをセットで覚えておくとよいですね。

末尾「Z」とその意味、ご存じでしたでしょうか？これでもう間違えることはないでしょう。
確実なスケジュール実行で、さらにクラウドフローをご活用ください。

Power Automate（クラウドフロー）の実行が失敗すると、フローの所有者にメールで通知が届きます。…が、このメール通知、​​​​​​​週1回しか送られてきません。タイミングによってはずっとエラーになっていたのに随分経ってから気づく、なんてことも
エラーが発生した都度、フロー詳細画面と実行履歴へのリンクのついたメールを送る方法をご紹介します。

デフォルトのエラー通知

クラウドフローで何らかのエラーが発生して実行がうまくいかなかった場合、フローの所有者宛にメールが届きます。

「過去１週間で～」とある通り、週１回の頻度でまとめて通知が来ることになっています。

もっと早く気づきたい！という場合、エラーが発生したら都度通知をするように、フロー内のアクションとして設定する方法があります。

メール送信アクションの設定

実行が失敗しがちなアクション、スコープ（アクションのグループ）、またはフロー全体の最後に、メール送信 アクションを追加しましょう。
（Teamsで通知を受け取りたい場合はTeamsのアクション「チャットまたはチャネルでメッセージを投稿する」でも、もちろんOKです）

ポイントは、件名にフロー名、本文にフロー詳細へのリンクと、実行履歴へのリンクを含めること。どのフローで、どんなエラーが起きたのかの確認がしやすくなります！

◆「メールの送信」アクションの設定

「メールの送信」アクションの設定をしていきましょう。
宛先はフローの所有者のほか、フォローできるチームメンバーや関係者をCCに入れておくと良いでしょう。

フローの情報をメールに表示させるには、Workflow関数 を使います。

◆フロー名の挿入

まずは件名の設定です。「エラー：フロー名」などにすると何の通知なのか分かりやすいですね。

workflow()[‘tags’][‘flowDisplayName’]
とすることで、フロー名（表示名）を入れることができます。

動的なコンテンツの追加 で「式」のタブに切り替えて、上記のworkflow関数を入力し（コピペでOK）、OKボタンを押して確定しましょう。

◆リンクの挿入

続いて、本文を設定していきます。実行履歴の一覧が表示されるフロー詳細ページと、その実行単体の履歴ページへのリンクをそれぞれ貼っておくと、エラーの確認がスムーズです。

文章を入力したらリンクを設定します。
URLは構成が決まっているので、Workflow関数を組み合わせて設定することができます。

環境ID	workflow()[‘tags’][‘environmentName’]
フローID	workflow()[‘name’]
実行ID	workflow()[‘run’][‘name’]

リンクを貼りたい文字列を選択して、右上のリンクボタンを押します。
Link Target の部分に、下記のURLをそのままコピーして貼り付ければ完成です！

フロー詳細

【URLの構成】　https://make.powerautomate.com/environments/環境ID/flows/フローID/details

https://make.powerautomate.com/environments/@{workflow()[‘tags’][‘environmentName’]}/flows/@{workflow()[‘name’]}/details

実行履歴

【URLの構成】　https://make.powerautomate.com/environments/環境ID/flows/フローID/runs/実行ID

https://make.powerautomate.com/environments/@{workflow()[‘tags’][‘environmentName’]}/flows/@{workflow()[‘name’]}/runs/@{workflow()[‘run’][‘name’]}

「コードビュー」でHTMLを書き込む

メール本文のエディター内にある </> ボタンを選択すると、メール本文をHTMLで記入することができます。
以下をコピペいただくと、リンクの設定を開く必要がなくて簡単です♪
（文章の部分はお好みで変更してください。）

<p>@{workflow()[‘tags’][‘flowDisplayName’]}の実行に失敗しました。<br>        
<a href=https://make.powerautomate.com/environments/@{workflow()[‘tags’][‘environmentName’]}/flows/@{workflow()[‘name’]}/details>フロー詳細を開く</a><br>
<a href=https://make.powerautomate.com/environments/@{workflow()[‘tags’][‘environmentName’]}/flows/@{workflow()[‘name’]}/runs/@{workflow()[‘run’][‘name’]}>実行履歴を開く</a><br>
このメールは自動送信です。</p>

▼

これで、Power Automate のサイトを開いて、監視 ＞ クラウドフロー活動 …と辿っていかなくても、マイフロー の一覧を眺めて「どれだっけ？」と探さなくても、メールにあるリンクをクリックするだけで直接フローの詳細画面・実行履歴画面が開けます。手間なく必要な情報にたどり着けて便利♪

実行条件の設定

フローの実行が失敗した時だけメール通知が送信されるように設定しましょう。

アクション右上の[・・・]三点ボタンから、実行条件（＝どんな場合にそのアクションを実行するか）を設定することができます。

デフォルトは、前のアクションが成功した場合、になっています。
「に成功しました」のチェックを外し、それ以外の３つにチェックを入れると良いでしょう。（場面に応じて不要なものは チェックなし のままにしてください。）

実行条件の設定をすると、アクションを繋ぐ矢印が赤の点線に変わり ⓘマーク がつきます。

「失敗」として終了させる

※途中のアクションがエラーになると、フロー実行全体は「失敗」として記録されるよう動作が変更になっています。

途中のアクションがエラーになっても、フローの最後にあるエラー通知メールを送信するアクションが成功すると、最終的には正常に実行完了したものとして実行履歴は【成功】として記録されます。

これでは、どの実行でエラーが起きたのか、どのくらいの頻度でエラーが起きているのか、把握しにくくなってしまいます。
メールに履歴へのリンクを貼っているのでその場では困らないかもしれませんが、後から振り返りたい時に一つずつ開いて確認するというのではとても面倒です。

エラーが発生した実行は【失敗】として表示されるようにしましょう。

コントロール グループの「終了」アクションを追加しましょう。
状態を【失敗】に設定することで、実行履歴のステータスを【失敗】として記録することができます。

なお、実行条件を設定しているので、エラーが発生しなかった場合は「メールの送信」と「終了」のアクションはスキップされ、その前のアクションが成功したところまでで実行が完了するので、実行履歴のステータスは【成功】になります。

エラーの発生を見逃さない通知メールの設定をご紹介しました。様々な要因でどうしてもエラーは起きるものなので、すぐに気づいて対応できることが大切ですね。
今後も業務効率化の手助けになるPCの小技や便利な使い方を随時発信していきます！

はじめに ：返信アクションで起きうるトラブル

Power Automateで起こしがちな失敗に、無限ループがあります。
なかでも、メール受信をトリガーにして、返信を送るフローによって、大量メール返信の発生を引き起こしてしまうという恐怖体験があります（実体験）。

危うきに近寄らず・・・のスタンスで返信アクション自体の利用を避けるのもありですが、
今回はTrigger Conditions（トリガー条件）を使って無限ループを回避する方法を紹介します。
願わくば、自動返信フローの作成にトライしている方が、しくじりを起こす前にこの記事が読まれますように！

無限ループが起きるパターン

まず、どんなフローが無限ループを引き起してまうのか確認しておきましょう。
こちら↓のサンプルは、Outlookコネクターを使って、「XXの件について」という件名を含むメールをトリガーにして、何かしたうえで、同じ件名で返信する、というフローです。

一見良さそうなのですが、これを有効化すると、無限ループの完成です

なぜなら、「XXの件について」というメール件名をトリガーにしているので、フローが同じ件名で返信することで、その返信メール自体によって延々と新たなトリガーを引くことになってしまうからです。（実際には、一定回数ループしたら止まります。ですがやはり、テストは十分行ったうえで本番利用した方が良いでしょう）

これを避けるためには、返信メールの件名を変えてしまうのが一番手っ取り早いです。が、もし件名をキープしたい場合は、

① 送信者が自分の場合は、トリガーしないようにする。（＝送信者が自分でないときのみトリガーする）もしくは、
② 件名が「RE: XXの件について」の場合は、トリガーしないようにする（＝件名が「RE: XXの件について」でないときだけトリガーする）

といったように、トリガー発生に対する追加条件を加えれば良さそうです。
これが、Trigger Condition（トリガーの条件）と呼ばれるものです。

Trigger Conditionsはどこから設定する？

トリガー条件は、

トリガーの右上 三点ボタン ＞ 設定 ＞ 「トリガーの条件」 にある ＋追加 をクリック ＞ 条件を入力し、完了

で設定できます。今回加えたいトリガー条件が「送信者が自分でないときのみ」だとすると、以下のように入力してください。

@not(equals(triggerBody()?[‘From’], ‘youremail@domain.com’))

（youremail@domain.comはご自分のアドレスに置き換えてください）

この条件を分解すると、

・トリガー内の本文の情報のうち、『triggerBody()』
・ Fromという項目が、『?[‘From’]』
・ youremail@domain.comとイコールでない、『not(equals(省略, ‘youremail@domain.com’))』

ということを示しています。トリガー条件は＠アットマークで始めるのが決まりです。

インテリセンスによる補助が効かないのが辛いところですが、Excelの式と似たようなものなので、雰囲気は大体わかると思います。
@に続く演算子としては、and（かつ）、contains（~を含む）、startsWith （~で始まる）などもありますし、
カッコをネストすることで複雑な条件も表現できます。
例：and(contains(), startsWith())
条件に合わせて変えてみましょう。
なお、＋追加 で複数の条件を追加した場合は、「または」の意味になります。

triggerBody()で、条件に指定する項目名を把握する

さて、上の条件に挙げたうちの triggerBody()?[‘From’] は、トリガーの本文内に示されたメールの差出人を示しているのですが、?以降の項目名はどこから調べれば良いのでしょうか？

トリガーの中身を調べるには、組み込み ＞ データ操作 の 「作成」アクションを使いましょう。
これに、triggerBody()という式を入れて、保存してください。その後テスト実行し、メールを送ってみましょう。

ちなみに、組み込み ＞ コントロールの 「終了」アクションを次に配置しておくのがおススメです。
終了を使うと、以降のアクションは実行されなくなります。ですので、VBA等におけるブレークポイントと同じような使い方が可能です。

テスト成功後、実行結果の画面で、作成アクションを開きましょう。未加工出力の表示をクリックすると、トリガー本文部分のJSONが表示されています。
ここから、差出人メールアドレスは from という項目名であるということがわかります。

このようにして、トリガー条件として使う項目の名前を把握することが出来ます。確認出来たら、作成および終了アクションは削除します。

※追記ですが、トリガーのヘッダーも含めた情報を知りたいときは、代わりにtriggerOutput()を使ってください。

おわりに（＋おまけ）

以上、今回はトリガー条件の使い方と、トリガー本文内の項目名の調べ方を紹介しました。

トリガー条件を使うと、トリガーの発生を細かく限定することが出来るため、「無駄打ち」が少なくなります。

ですから、トリガー時点では広めに掬っておいて、その後の条件分岐で合致する場合だけ実行する、というようなフローの作り方よりも、トリガー条件を使う方が、APIコールの回数も抑えられる分、効率の良いやり方と言えるでしょう。

SharePointやDataverseトリガーでも役立つので、使ってみてください。

最後に、トリガー条件の書き方がややこしいというか、すぐ忘れそうだな、と思われるかもしれません。そういうときは、ChatGPTに頼ってみると良いでしょう。
試したみたところ、GPT3.5だとおかしな回答でしたが、GPT4ではバッチリ正答してくれました。

Trigger Conditionsが出始めたころ、Power AutomateがMicrosoft Flowと呼ばれていた数年前は、こんなこと出来るんだ！と感動しつつも、ずいぶん苦労して、ああでもないこうでもないとやっておりました。おかげで身に付いたので、良かったのですが、今ではこんな便利なモノがあります。

さらには今後Power PlatformでCo-Pilot機能が順次強化されていくようですから、
ChatGPTを使わずともPower Automateの中で、AIが助けてくれるようになるのでしょう。

（参考リンク）Power Platform is leading a new era of AI-generated low-code app development

いつになるかわかりませんが、そう遠くない将来でしょうし、今から楽しみです。
うまく活用しながら、省エネでやっていきたいですね。

Power Automate（クラウドフロー）のOutlookコネクタは、メールの送信・返信などが出来る便利なコネクタです。・・・が、メールの下書きを作成するというアクションが用意されていません。

そこで今回は、「HTTP要求を送信」アクションからMicrosoft Graph APIを使うことで、下書きメールを作成する方法をご紹介します。

Outlookメール下書きの作成には「HTTP要求を送信します」を使おう

活用シーン

定型的なメールの送信には、Power Automate（クラウドフロー）のOutlookコネクタが便利です。

よくあるパターンは、Excel OnlineやSharePointリストで、メーリングリストを用意するやり方です。そのExcelテーブルまたはSharePointリストから、宛先メールアドレスや氏名などを取得し、動的な値として「メールの送信」アクションに当て嵌めると、メール一斉送信フローの出来上がりです。

これはこれでとても有用なのですが、「メールの作成だけしておいて、内容確認のうえ自分のタイミングで送りたい」とか、「イレギュラーなケースには、送信前に自分で手を加えたい」とか、いったん下書きに保存しておきたいというニーズには対応できません。

こういうときは、標準アクションではなくMicrosoft Graph API呼び出しを使いましょう。今後、ChatGPTのようなAIにメールを書いてもらう使い方も出て来るでしょうから、送信前にワンクッション置くやり方の一つとして覚えておくと良さそうです。

「HTTP要求を送信します」でメールを作成

下書きメールの作成には、「HTTP要求を送信します」アクションを使います。① Office 365 Outlook、② Offce 365 Users、③ Office 365 Groups と異なる３種類のコネクタで「HTTP要求を送信します」がありますが、どれを使ってもOKです。
（ただし前二者はプレビューです）

アクションの設定ですが、
① URIに https://graph.microsoft.com/v1.0/me/messages と入力、
② メソッドには POST を選びます。
③ 本文の部分は、以下サンプルを参考に、必要な箇所を動的な値に置き換えましょう。

{
    "subject":"Did you see last night's game?",
    "importance":"Low",
    "body":{
        "contentType":"HTML",
        "content":"They were <b>awesome</b>!"
    },
    "toRecipients":[
        {
            "emailAddress":{
                "address":"AdeleV@contoso.onmicrosoft.com"
            }
        }
    ]
}

↑公式サイトのサンプルを掲載しています
https://learn.microsoft.com/en-us/graph/api/user-post-messages?view=graph-rest-1.0&tabs=http#example-1-create-a-new-message-draft-using-json-format

これで完成です。テスト実行してみて、自分のメールボックスの下書きにメールが出来ているか確認しましょう。

添付ファイルも付けてみる

ついでに、下書きしたメールに添付ファイルも付けてみます。
手順としては、下書きメール作成後、

① SharePointからファイルを取得する（OneDriveからでも可）、
② 作成アクションでファイルコンテンツをBase64に変換（直接HTTP要求アクションの本文内に式を書いてもOK）、
③ 再びHTTP要求で添付ファイルをくっ付ける、

という流れです。

まず、①のSharePointアクションでファイルコンテンツを取得したら、②の作成アクションで、以下↓のようにbase64関数で変換してください。

③のHTTP要求を送信で、設定するURIは、 https://graph.microsoft.com/v1.0/me/messages/{メールID}/attachments です。
メールIDの部分は、先に行ったアクションから動的な値を拾って来ればよいので、
https://graph.microsoft.com/v1.0/me/messages/@{body(‘HTTP_要求を送信します（メール作成）’)[‘id’]}/attachments
になります。

メソッドは先ほどと同じくPOSTです。

最後に、要求本文には、以下のJSONを参考に、contentBytesにBase64変換した出力結果を当て嵌めます。

{
  "@odata.type": "#microsoft.graph.fileAttachment",
 "name": "ファイル名.拡張子",
  "contentBytes": "@{outputs('作成（Base64へ変換）')}"
}

↑name, contentBytesの値をご自分の業務に合わせて変えてください。

こちらのスクリーンショットも参考にしてください。

以上で、添付ファイル付きの下書きメールも完成です。

おわりに（お礼）

このように、HTTP要求を使うとPower Automateの標準アクションでは出来ないコトも可能になるので、活用の幅が広がります。

特に、ここで紹介したアクションは、Graph APIを使うのに下準備がほとんど要らず、見よう見まねでやってもどうにかなる、というのも大きな利点です。他にも出来ることが無いか調べてみると良いかもしれません。

なお、このテクニックは、Damien BirdさんのYouTubeで紹介されていたものです。
（もっとスマートなやり方で添付ファイルを処理しているので、リンク先でご覧ください。）