【Power Automate】workflow関数でフローのURLや実行結果のURLを取得する方法

Power Automateで使える関数の一つに「workflow関数」というものがあります。

実行したフローの情報を取得できる関数です。この記事では「workflow関数」の取得できる情報や使い道についてまとめていきます。

取得できるデータ

workflow関数で取得できるjson形式のデータはこちら。

（※値はそれっぽいものを適当に入れています。）

{
    "id": "/workflows/a756b5f39fca4e72afb2f02bc0ae0901",
    "name": "21644460-be8d-40bf-bf58-5594c59e6618",
    "type": "Microsoft.Logic/workflows",
    "location": "japaneast",
    "tags": {
        "flowDisplayName": "workflow関数テスト",
        "environmentName": "Default-99b882ac-b043-6d2e-9579-dbbec4dfb778",
        "logicAppName": "21644460-be9d-40bf-af58-5594d59e7718",
        "environmentFlowSuspensionReason": "Default:2D97b882ac:2Da045:2D4d2e:2E9579:2Ddbbef4dccc629-None"
    },
    "run": {
        "id": "/workflows/b756b5f39fca4e72afb2f02bc0ae0901/runs/08585429441071882851047185048CU56",
        "name": "08585429441071882851047185048CU56",
        "type": "Microsoft.Logic/workflows/runs"
    }
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "tags": {
      "type": "object",
      "properties": {
        "flowDisplayName": {
          "type": "string"
        },
        "environmentName": {
          "type": "string"
        },
        "logicAppName": {
          "type": "string"
        },
        "environmentFlowSuspensionReason": {
          "type": "string"
        }
      }
    },
    "run": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "type": {
          "type": "string"
        }
      }
    }
  }
}

取得データの中身

公式ドキュメントに記載が見当たらず、色々な場所を確認して調べました。（間違っていたらごめんなさい）

workflow関数でできること

workflow関数を利用することで、下記のことができます。

• 実行されたフローの表示名が取得できる。
• 実行されたフローのページへのURLが作成できる。
• 実行されたフローの実行結果画面へのURLが作成できる。

フローの実行された結果を管理したり、アクションと組み合わせれば色々な使い方が出来そうです。

フローのURL

workflow関数を利用することでフローの画面へのURLを作成することができます。

この画面へのURLを作成することができます。

フローのページへのURLの構成はこのようになっています。

https://japan.flow.microsoft.com/manage/environments/【環境ID】/flows/【フローID】/details

workflow関数で実行されたフローの情報を取得してURLを作成することこのようになります。

https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details

実行結果画面のURL

次に実行画面へのURLです。

実行されたフローの詳細を確認することができる画面です。

フロー実行結果へのページへのURLの構成はこのようになっています。

https://japan.flow.microsoft.com/manage/environments/【環境ID】/flows/【フローID】/runs/【実行ID】

workflow関数で実行されたフローの情報を取得してURLを作成することこのようになります。

https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/runs/@{workflow()['run']['name']}

workflow関数の使い道「エラーが発生した時に便利」

フローでエラーが発生した際、Teamsへ実行結果へのURLの通知を送ることでエラー内容の確認がスムーズにできます。

作り方

エラーが起こる（起こりそう）なアクションの１つ後ろにTeasmやメールなど通知できるアクションを作成します。今回はTeamsで作成していきます。

メッセージの内容にエラーが出たフローやフローの実行結果画面へのURLを設定します。

↓こちらをコピペしてご利用ください。

<p>処理が失敗しました。
<br>
<br>■フローはこちら
<br>
<a href="https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/details"> @{workflow()['tags']['flowDisplayName']}</a>
<br>
<br>■実行結果はこちら
<br>
<a href="https://flow.microsoft.com/manage/environments/@{workflow()['tags']['environmentName']}/flows/@{workflow()['name']}/runs/@{workflow()['run']['name']}">実行結果を開く</a></p>

右上の3点リーダーから「実行条件の構成」で実行されるタイミングを設定します。

最初は「に成功しました」にチェックが入っているので、それ以外の項目にチェックを入れます。

エラーが出るとTeamsにメッセージでが送信されます。

フローの画面や実行結果の画面などにアクセスできるので、フローへのアクセスがスムーズにできます。

参考記事など

workflow関数のドキュメントです。

参考

式関数のリファレンス ガイド – Azure Logic Apps

docs.microsoft.com