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

Power AutomateでSharePointのリストやライブラリを扱うフローを作成したものの、添付ファイルに関連するアクションでエラーが発生し、原因がわからず困った経験はありませんか。特に「添付ファイルの取得」や「ファイルコンテンツの取得」アクションが失敗するケースは多く、実行履歴を正しく読み解くことで迅速に原因を特定できます。この記事では、添付ファイルまわりのトラブルシューティングに必須の実行履歴の見方と、具体的な原因特定の手順を解説します。

1. 添付ファイル関連フローで頻発するエラーとその傾向

SharePointで添付ファイルを扱うPower Automateフローでは、以下のようなエラーが頻繁に報告されています。

• ファイルが見つからないエラー(404): トリガーで取得したアイテムIDと実際の添付ファイルが一致しない場合に発生します。
• アクセス拒否(403): フロー実行アカウントに添付ファイルを読み取る権限がない場合や、SharePointライブラリのアクセス制限が原因です。
• ファイルサイズ超過: Power Automateのコネクタ制限(通常100MB)を超える添付ファイルを扱おうとした場合に発生します。
• 無効なファイル形式: 空の添付ファイルや、サポートされていない特殊なファイル形式が含まれているとエラーになります。

これらのエラーは、実行履歴からエラーコードやメッセージを確認することで、ある程度原因を絞り込めます。

2. 実行履歴画面の基本構成と確認ポイント

Power Automateの実行履歴は、フローの各アクションごとに詳細なログを提供します。まずは基本的な見方を押さえましょう。

2-1. 実行履歴へのアクセス方法

1. Power Automateポータル(make.powerautomate.com)にサインインします。
2. 左メニューから「マイフロー」を選択し、対象のフローをクリックします。
3. フローの詳細画面で「実行履歴」タブを選び、失敗した実行をクリックします。
4. 画面が開くと、各アクションの状態(成功・失敗)がツリー状に表示されます。
5. 失敗したアクションをクリックして、詳細ペインを開きます。

2-2. 詳細ペインで確認すべき要素

• ステータスコード: HTTPステータスコード(200, 400, 403, 404, 500など)が表示されます。これが原因推定の第一歩です。
• エラーメッセージ: 「FileNotFound」「AccessDenied」など、テキストで理由が示されます。
• 入力ペイロード: アクションに渡されたデータの一部が表示されます。添付ファイル関連では「Id」や「FileIdentifier」などが正しいか確認します。
• 出力ペイロード: 成功時にはファイルのメタデータやコンテンツが一部表示されますが、バイナリデータは省略されることが多いです。

3. エラーメッセージ別の原因特定方法

ここでは、代表的なエラーメッセージごとの原因と対処法を解説します。

3-1. 「ファイルが見つかりません」エラー

このエラーは、トリガーから渡されたアイテムIDやファイル識別子が実際の添付ファイルと一致しない場合に発生します。例えば、SharePointリストの「添付ファイルの取得」アクションで、アイテムIDが正しくないと「FileNotFound」が返ります。確認手順としては、実行履歴の入力ペイロードで「Id」の値をコピーし、SharePoint側で該当アイテムに添付ファイルが存在するか直接確認します。また、トリガー条件が「アイテムが作成されたとき」のみで、更新時に添付ファイルが追加されたケースを拾えていない可能性もあります。

3-2. 「アクセスが拒否されました」エラー

フローの実行アカウントがSharePointの対象ライブラリやリストに対して適切な権限を持っていないと発生します。特に、添付ファイルを保存するライブラリのアクセス許可が「すべてのユーザー」ではなく特定のユーザーグループに限定されている場合に起こります。このエラーが頻発する場合は、IT管理者に依頼してフローで使用している接続アカウント(通常はフロー所有者のアカウント)に「読み取り」または「編集」権限が付与されているか確認してください。

3-3. 「ファイルサイズが制限を超えています」エラー

Power Automateのコネクタには、1回のアクションで処理できるファイルサイズに制限があります。SharePointコネクタの場合、デフォルトで約100MB(環境によって異なる)。これを超える添付ファイルを取得しようとするとエラーになります。実行履歴のエラーメッセージに「The file size exceeds the limit」と表示されます。対処法としては、ファイルを分割するか、OneDriveやAzure Blob Storageなど別のストレージを経由する方法を検討します。

4. 失敗パターン別のトラブルシューティング手順

実際の運用でよくある失敗パターンをもとに、手順を追って原因を特定する方法を紹介します。

1. ステップ1: エラーコードとメッセージを記録する
   実行履歴の失敗アクションから、ステータスコード(例:404)とエラーメッセージ(例:FileNotFound)をメモします。
2. ステップ2: 入力ペイロードの値を検証する
   「入力」タブを開き、添付ファイルに関連するパラメータ(Id、FileIdentifier、ItemIdなど)が正しいかを確認します。例えば、リストアイテムのIDが空文字になっていないか、ファイル名に特殊文字が含まれていないかチェックします。
3. ステップ3: 該当するSharePointアイテムを直接確認する
   ブラウザでSharePointを開き、フローが対象としているリストアイテムやライブラリフォルダを開きます。実際に添付ファイルが存在するか、権限でアクセスできるか確認します。
4. ステップ4: フローの接続参照を調べる
   フロー編集画面で「データ」→「接続」を開き、SharePoint接続が有効であり、使用しているアカウントに権限があるかを確認します。接続が期限切れになっていないかも重要です。
5. ステップ5: テスト実行で同一条件下で再現する
   手動でトリガーを起動し、同じ添付ファイルを指定してフローをテスト実行します。成功した場合は、トリガーの条件や同時実行数など別の要因が考えられます。
6. ステップ6: 管理者に必要な情報を伝える
   エラーコード、フロー名、実行履歴のスクリーンショット、問題のリストアイテムのURLをまとめてIT管理者に連絡します。

5. 状況別比較表

トリガーやアクションの種類によって、発生しやすいエラーと確認ポイントが異なります。以下の表を参考に、自分の状況に当てはめてください。

状況	よくあるエラー	確認ポイント
「新しいアイテムが作成されたとき」トリガーで添付ファイルを取得	FileNotFound, 400	作成直後では添付ファイルがまだアップロードされていないケースがある。遅延処理を検討。
「アイテムが更新されたとき」トリガーで添付ファイルを取得	AccessDenied, 403	更新者が添付ファイルにアクセスできない権限設定になっていないか確認。
「添付ファイルの取得」アクションを使用	FileNotFound	アクションに指定しているアイテムIDがリストアイテムのIDか、ライブラリのファイルIDかを混同していないか確認。
「ファイルコンテンツの取得」アクションを使用	FileSizeLimitExceeded, 413	ファイルサイズがコネクタ制限を超えていないか。バイナリデータを直接扱う場合に注意。
「ファイルを作成」アクションで添付ファイルを別の場所に保存	BadRequest, 400	出力先パスが正しいか、ファイル名に使用できない文字が含まれていないか確認。

6. 管理者に確認すべき設定項目

自分で権限や設定を変更できない場合は、以下の情報をIT管理者に伝えて調整を依頼しましょう。

• SharePointライブラリのアクセス許可: フローの接続アカウント(通常は自分またはサービスアカウント)が、対象のライブラリに対して「読み取り」以上のアクセス権を持っているか。
• Power Automateのコネクタ制限: テナント全体のファイルサイズ制限がデフォルトの100MBから変更されていないか。また、プレミアムコネクタが必要なアクションを使っている場合はライセンスの割り当て。
• SharePointのファイルアップロード制限: SharePoint管理センターで設定されているファイルアップロードの上限サイズ(通常250GBなど)と、Power Automate側の制限が異なる場合があるので注意。
• フロー実行アカウントのデータ損失防止(DLP)ポリシー: 組織のDLPポリシーにより、SharePointコネクタと他のコネクタ(例:Outlook)の組み合わせが禁止されているとフローがブロックされることがあります。
• 添付ファイルのストレージ場所: SharePointリストの添付ファイルはデフォルトで「添付ファイル」フォルダに保存されますが、カスタムライブラリを使っている場合はパスが異なります。

7. よくある質問(FAQ)

最後に、読者から寄せられる質問とその回答をまとめました。

• Q: 実行履歴にエラーコードが表示されず、アクションが「スキップ」と表示されます。原因は?
  A: スキップは、条件分岐や並列処理で実行されなかったアクションです。フローの条件設定や前のアクションの出力を確認してください。
• Q: 「ファイルコンテンツの取得」で取得したデータをメールに添付したいが、文字化けします。
  A: ファイルコンテンツはバイナリデータです。メール送信アクションでは、添付ファイルとして正しく扱うために「ファイルコンテンツ」を直接使わず、一度一時ファイルとして保存してから添付する方法を試してください。
• Q: SharePointリストの添付ファイルが複数ある場合、すべて取得するにはどうすればいいですか?
  A: 「添付ファイルの一覧」アクションを使ってすべてのファイルIDを取得し、後続の「添付ファイルの取得」をApply to eachでループ処理します。このとき、並列処理の上限やAPIスロットリングに注意してください。
• Q: フローを共有している別のユーザーが実行するとエラーになるのはなぜ?
  A: 共有ユーザーがフローを実行する場合、接続参照がそのユーザーのアカウントで再作成されるため、権限不足が発生することがあります。所有者の接続を共有するか、サービスアカウントを使用する方法を検討してください。
• Q: 実行履歴の出力ペイロードに「Unsupported Media Type」と表示される。
  A: 添付ファイルのMIMEタイプがPower Automateでサポートされていない可能性があります。ファイル形式を一般的なもの(.pdf, .jpg, .docxなど)に変換してから処理することを検討してください。

まとめ

SharePointの添付ファイルを扱うPower Automateフローのトラブルシューティングでは、実行履歴の詳細を正しく読み解くことが重要です。エラーコードとメッセージを手がかりに、入力ペイロードの値や権限設定を確認することで、多くの問題は切り分けられます。また、自分で解決できない場合は、本記事で紹介した管理者向けの情報を整理して伝えることで、迅速な対応が期待できます。フローの安定運用のために、定期的な実行履歴の確認と、エラー発生時の原因特定を習慣化しましょう。

👥

Teams/Outlookトラブル完全解決データベース サインイン、接続エラー、メール送受信の不具合など、特有のトラブル解決策を網羅。困った時の逆引きに活用してください。

🔐

会社アカウント・認証トラブル完全解決データベース 職場または学校アカウント、MFA、Authenticator、VPN、権限、会社ポリシーで止まる問題を横断的に確認できます。