【Power Automate】添付ファイル処理でつまずく時の実行履歴から原因を読む方法

Power Automateで添付ファイルを処理するフローは、メールの添付を自動保存したり、Teamsにファイルを投稿したりと便利な反面、エラーが発生しやすい部分でもあります。特に原因がわかりにくい場合、実行履歴(Run history)を正しく読み解くことが解決の近道です。実行履歴には各アクションの入力・出力情報やエラーメッセージが記録されており、それを確認することで問題の切り分けが可能です。本記事では、添付ファイルに関するトラブルの原因を実行履歴から特定する方法を解説します。

1. 添付ファイル処理でよく発生するエラーの種類

Power Automateで添付ファイルを扱うフローは、主に「メールの添付ファイルを保存する」「添付ファイルの内容を読み取る」「添付ファイルを別のサービスに転送する」といった処理で失敗します。実行履歴から原因を読む前に、どのようなエラーが典型的かを知っておくと、ログの注目すべき箇所が絞れます。

ファイル形式に関するエラー

添付ファイルの拡張子やMIMEタイプが想定外の場合、アクションが「ファイルの種類がサポートされていません」と拒否することがあります。実行履歴に表示されるエラーコードは「InvalidFileType」や「UnsupportedMediaType」などです。特にExcelファイル (.xlsx) やPDFが正しく認識されないケースが多く、原因はトリガーの構成やアクションの設定不足にあります。

ファイルサイズ制限エラー

Power Automateの標準コネクタにはファイルサイズの上限があります。例えば、メールトリガーでは添付ファイルの合計サイズが数MBを超えると、トリガー自体がスキップされるか、アクションで「ファイルが大きすぎます」というエラーが発生します。実行履歴では「FileSizeExceeded」や「413 Request Entity Too Large」といったメッセージが確認できます。

アクセス権限エラー

ファイルを保存先フォルダ(SharePointやOneDrive)に書き込む際に、権限が不足していると「Forbidden」や「AccessDenied」が返ります。実行履歴のアクションの出力に、HTTPステータスコード403や具体的なエラーメッセージが含まれます。多くの場合、フローを実行するアカウントに適切な権限が付与されているか、またはサービスプリンシパルの設定が正しいかを確認する必要があります。

2. 実行履歴の確認手順(5ステップ)

失敗したフローの原因を実行履歴から読み解くには、以下の手順で確認します。この手順を踏むことで、エラーの発生箇所と内容を体系的に把握できます。

1. Power Automateポータル(make.powerautomate.com)にアクセスし、左側メニューの「マイフロー」から対象のフローを開きます。
2. フロー詳細画面で「実行履歴」タブをクリックし、失敗した実行の一覧を表示します。通常、ステータスが「失敗」または「キャンセル」になっている行を探します。
3. 失敗した実行の「実行日」をクリックして、実行の詳細画面を開きます。ここにはフローの全アクションがタイムラインで表示され、各アクションのステータス(成功、失敗、スキップ)が確認できます。
4. 最初に赤いアイコン(失敗)が付いているアクションをクリックします。そのアクションの「入力」「出力」「エラーメッセージ」のタブが表示されるので、特に「出力」と「エラーメッセージ」を確認します。エラーメッセージには原因の詳細が英語または日本語で記述されています。
5. 必要に応じて、その直前の成功したアクションの「出力」も確認し、どのようなデータ(添付ファイルの中身など)が渡されたかを比較します。たとえば、トリガーで添付ファイルが空の配列になっている場合、トリガーの設定に問題があります。

3. 実行履歴の各項目の読み方

実行履歴の詳細画面には多くの情報が詰まっています。主要な項目を表にまとめましたので、確認時に役立ててください。

項目	確認すべき内容	添付ファイル関連のポイント
トリガーの出力	添付ファイルの配列「attachments」や各ファイルのプロパティ(name, contentBytes, sizeBytesなど)	attachmentsが空配列([])ならトリガーで添付が認識されていない。sizeBytesが0のファイルは空ファイルの可能性。
アクションの入力	アクションに渡された添付ファイルのデータ構造やパラメータ	ファイル名が文字化けしていないか、contentBytesが正しく渡っているか。
アクションの出力	処理結果(成功時には保存先パスやファイルIDなど)	ファイル作成アクションなら「Id」や「Path」が返る。エラーの場合は特定のエラーコード(403, 404など)とメッセージ。
エラーメッセージ	赤文字で表示されるエラーの説明	「Access Denied」「File size exceeds limit」など。可能であれば全文をコピーして検索する。

4. 失敗パターン別の原因特定方法

実際によく遭遇する失敗パターンごとに、実行履歴のどの部分を見ればよいかを解説します。

パターン1:トリガーで添付ファイルが認識されない

メール受信トリガー(Office 365 OutlookやOutlook.com)を使っている場合、添付ファイルが空で渡されることがあります。実行履歴でトリガーの出力を確認し、attachmentsフィールドが空配列だったら、メールにファイルが添付されていないか、トリガーのフィルター条件(「添付ファイルあり」のチェック)が正しく設定されているか確認します。また、メールの種類が「添付ファイル付き」でも、トリガーで特定の条件(件名や送信者)で除外されている可能性もあります。

パターン2:アクションでファイル処理が失敗する(サイズ・形式)

例えば「ファイル作成」アクションで、サイズ制限を超える添付ファイルを保存しようとすると、アクションが失敗し、出力に「413 Request Entity Too Large」が表示されます。この場合、フロー内でファイルを分割するか、使用するコネクタの制限値を管理者に確認する必要があります。また、非対応のMIMEタイプ(例:.exeや.zip)は「InvalidFileType」エラーになるため、トリガーで添付ファイルの拡張子を事前にフィルターするか、条件分岐で処理をスキップする設計が求められます。

パターン3:権限エラーで書き込みできない

SharePointやOneDriveにファイルを保存するアクションで「Forbidden」または「AccessDenied」が出力された場合、フローが実行されているアカウント(所有者アカウントまたはコネクターで設定されたアカウント)に書き込み権限がないことが原因です。実行履歴のアクションの出力にHTTPステータスコード403が含まれていれば、権限の問題です。管理者に依頼して、対象のフォルダーまたはサイトに対して適切なアクセス権を付与してもらいましょう。

5. 管理者に確認すべき設定

添付ファイル処理のトラブルが社内環境全体で発生している場合、管理者レベルで確認が必要な設定があります。以下の3点をIT部門に共有すると解決が早まります。

環境のDLPポリシー

データ損失防止(DLP)ポリシーによって、特定のコネクタの組み合わせや添付ファイルの転送が制限されている可能性があります。例えば「メールからSharePointへのファイル保存」が禁止されていると、フローは動作しても権限エラーやポリシー違反で失敗します。管理者はPower Platform管理センターでDLPポリシーを確認し、必要なコネクタを許可するように設定変更を検討してください。

コネクタの認証とライセンス

フローで使用しているコネクタ(Office 365 Outlook、SharePointなど)が正しく認証されているか、またそのアカウントに十分なライセンス(Power Automate有償ライセンスやOffice 365 E3以上)があるかを確認します。認証が切れていると「InvalidAuthenticationToken」エラーが出て添付ファイル処理ができません。管理者はコネクタの接続参照を見直し、必要に応じて再認証を依頼してください。

ファイルサイズの全体制限

SharePointやOneDriveにはファイルアップロードのサイズ上限があります(既定で250GBなど)。しかし、Power Automate経由の場合は、APIレベルでより小さい制限(例えば10MB)がかかっている場合があります。管理者はSharePoint Onlineの管理シェルやPower Automateの制限ドキュメントを確認し、必要に応じて制限値を緩和するか、別の方法(例えばAzure Functionsを経由する)を検討します。

6. よくある質問

読者から寄せられやすい質問とその回答をまとめました。

1. Q: 実行履歴に「アクションがスキップされました」と表示されるのはなぜですか?
   A: スキップは、前のアクションが条件を満たさなかった場合に発生します。例えば、トリガーで添付ファイルがない場合に、ファイル保存アクションが実行されずスキップされます。原因はトリガーの出力を確認し、添付ファイルが存在するかどうかをチェックしてください。
2. Q: 実行履歴のエラーメッセージが英語で読めません。
   A: エラーメッセージはコピーして翻訳ツールにかけるか、Power Automateのコミュニティフォーラムで検索すると解決策が見つかることが多いです。または、エラーコード(例えば400, 500など)で検索するのも有効です。
3. Q: 添付ファイルの中身を読み取るアクションがいつも「InvalidJson」エラーになります。
   A: 添付ファイルがJSON形式でない場合に発生します。ファイルのMIMEタイプを確認し、適切なパースアクション(Parse JSON)を使用しているか見直してください。また、ファイルがテキスト形式でない場合は、事前にBase64デコードが必要なこともあります。

7. まとめ

Power Automateの添付ファイル処理で問題が発生したら、まず実行履歴を開き、失敗したアクションの出力とエラーメッセージを確認することが最短の道です。添付ファイルが空である、サイズ超過、権限不足の3つの軸で切り分けると、原因を特定しやすくなります。会社の環境では管理者の協力が必要なケースもあるため、本記事で紹介した確認ポイントを伝えてスムーズに解決を進めてください。実行履歴の読み方をマスターすれば、添付ファイルトラブルへの対応力が格段に向上します。