【Power Automate】接続参照が壊れてインポートできない時の直し方

Power Automateでフローを他の環境に移行する際、接続参照が原因でインポートに失敗することがあります。特に、開発環境から本番環境へのデプロイや、テナント間の移行時に「接続参照が見つからない」「接続の種類が一致しない」といったエラーが発生し、作業が止まってしまうケースは少なくありません。接続参照は、フロー内で使用するコネクタの認証情報や接続先を動的に切り替えるための仕組みですが、正しく構成されていないとインポート処理を正常に完了できません。本記事では、接続参照が壊れてインポートできない原因を具体的に解説し、再現可能な修正手順をステップバイステップで説明します。また、よくある失敗パターンや管理者に確認すべき項目も整理しましたので、Power Automateの移行作業でお困りの方はぜひ参考にしてください。

接続参照が壊れる原因とインポート失敗の仕組み

Power Automateのフローをパッケージ(.zip)としてエクスポートし、別の環境にインポートする際、フロー内で参照している接続を動的に解決するために接続参照が使われます。接続参照は、コネクタの接続情報(接続IDや認証情報)を直接フローに埋め込まず、名前で参照する仕組みです。このため、インポート先の環境に同名の接続参照が存在しない場合や、参照しているコネクタの種類が異なる場合にエラーが発生します。

接続参照が壊れる主な原因は以下のとおりです。

• 原因1: 接続参照のキー名が一致しない エクスポート元とインポート先で、同じフロー内で使われている接続参照の名前(キー)が異なると、インポート時に「見つからない」エラーになります。例えば、元環境では「SharePoint接続」という名前でも、先環境では「SharePoint接続_本番」のように微妙に変わっていると一致しません。
• 原因2: コネクタの種類が異なる 接続参照は特定のコネクタタイプ(例: SharePoint、Office 365 Users、SQL Server)に紐づいています。インポート先に同名の接続参照があっても、紐づいているコネクタが異なる場合(例えば、SharePointからSQL Serverに変わっている)、インポート時に「コネクタの種類が一致しません」というエラーが発生します。
• 原因3: 接続参照が未作成または削除されている インポート先の環境に、フローが想定する接続参照がそもそも存在しないケースです。特に環境を新規作成した直後や、以前の接続参照を誤って削除した場合に発生します。
• 原因4: 接続参照が別のソリューションに含まれている ソリューション管理機能を使っている場合、接続参照が異なるソリューションに属しているとインポート先で参照できないことがあります。

エラーメッセージの具体例

インポートに失敗した際に表示されるエラーメッセージの例をいくつか示します。

• 「接続参照 ‘XXXX’ が見つかりません。フローをインポートする前に、対象環境に接続参照を作成してください。」
• 「接続参照 ‘YYYY’ のコネクタの種類(SharePoint)が、対象環境の接続参照のコネクタの種類(SQL Server)と一致しません。」
• 「1つ以上の接続参照が使用できません。新しい接続を作成するか、既存の接続参照を選択してください。」

インポート失敗時の確認手順

エラーが発生した場合、まずは以下の手順で原因を切り分けます。

1. エラーメッセージを読み、不足している接続参照の名前をメモする。 エラー画面には「不足している接続参照: ConnectionRefName1, ConnectionRefName2…」と表示されます。この名前を記録します。
2. Power Automate管理センター(make.powerautomate.com)にアクセスし、インポート先環境の接続参照を確認する。 左メニューから「データ」→「接続参照」を開き、エラーメッセージにあった名前が存在するか確認します。存在しない場合は新規作成が必要です。
3. 存在する場合は、その接続参照の詳細を開き、「コネクタの種類」がフローが要求するコネクタと一致するか確認する。 例えば、フロー内でSharePointコネクタが使われているのに、接続参照のコネクタの種類がOffice 365 Usersになっていれば不一致です。
4. 不一致の場合は、正しいコネクタの種類で新しい接続参照を作成するか、既存の接続参照を修正する。 ただし、既存の接続参照のコネクタの種類は作成後変更できないため、削除して再作成する必要があります。
5. インポート先に接続参照が不足していることが判明したら、必要な接続参照をすべて作成する。 作成手順は後述します。
6. 再度フローをインポートする。 インポートウィザードで、各接続参照に対して適切な接続を割り当て、「インポート」ボタンをクリックします。

接続参照の作成手順

インポート先の環境に接続参照を作成する手順は以下のとおりです。

1. Power Automate管理センターで「データ」→「接続参照」を開きます。
2. ツールバーの「+新しい接続参照」をクリックします。
3. 表示名、接続参照名(キー)、コネクタの種類を設定します。接続参照名は、フロー内で使用されている名前と完全に一致させる必要があります(大文字小文字区別あり)。
4. 必要に応じて説明を入力し、「作成」をクリックします。
5. 作成後、接続参照の一覧に新しいアイテムが表示されることを確認します。

状況別の比較表:インポート前にチェックすべき項目

インポートを試みる前に、以下の表を参考に事前準備の状態を確認すると失敗を防げます。

確認項目	正常な状態	異常な状態	対処
接続参照の名前	すべての接続参照名がフロー内で使用されている名前と一致している	不足している、またはスペルが異なる	正しい名前で接続参照を作成または修正
コネクタの種類	接続参照のコネクタの種類がフローで使われているコネクタと一致	不一致(例:SharePoint vs SQL Server)	正しいコネクタの種類で接続参照を再作成
接続の有無	各接続参照に対して、有効なコネクタ接続(API接続)が存在する	接続がない、または期限切れ・無効	新しい接続を作成するか、既存の接続を再有効化
ソリューション所属	接続参照がフローと同じソリューションに属している(ソリューション利用時)	異なるソリューションに属している、またはソリューション外	同じソリューション内に接続参照を作成

よくある失敗パターンと対処法

実際の現場でよく発生する失敗パターンをいくつか紹介します。

パターン1: 接続参照名の大文字小文字の違い

接続参照名は大文字と小文字を区別します。例えば、元環境で「SharePointConnection」と作成していたにもかかわらず、インポート先で「sharepointconnection」と作成した場合、エラーになります。これを防ぐには、エクスポートしたフローの定義ファイル(definition.json)を開いて、接続参照名を直接確認するのが確実です。ファイル内の「connectionReferences」セクションに記述されている名前をそのままコピーして使用してください。

パターン2: 接続参照が未割り当てのままインポート

インポートウィザードでは、各接続参照に対して実際の接続を割り当てる手順がありますが、うっかり割り当てをスキップしてインポートしようとすると失敗します。インポート前に、すべての接続参照に「新しい接続」または「既存の接続」が割り当てられていることを確認してください。割り当てられていない場合、エラーが表示されてインポートボタンがグレーアウトすることもあります。

パターン3: コネクタの種類が間違っている

例えば、SharePointのサイトに接続するフローで「SharePoint」コネクタを使っているのに、接続参照のコネクタの種類を「Office 365 Outlook」にしてしまうケースがあります。これは、似たような名前のコネクタが複数あるために起こります。フロー内で実際に使われているコネクタを確認するには、元のフローを開き、アクションのコネクタアイコンをクリックしてコネクタの種類を確認してください。

管理者に確認すべき情報と事前準備

Power Automateの環境移行作業をスムーズに進めるために、管理者に事前に確認しておきたい情報があります。

• 環境ごとのコネクタ制限 一部のコネクタ(プレミアムコネクタやカスタムコネクタ)は、ライセンスや環境ポリシーによって利用できない場合があります。移行先で使用するコネクタが利用可能かどうか、事前に管理者に確認してください。
• Data Loss Prevention (DLP) ポリシー 組織のDLPポリシーで、特定のコネクタがブロックされていることがあります。インポート後にフローが動作しない原因になるため、事前にポリシーを確認し、必要に応じて例外申請を行います。
• ソリューション管理の有無 ソリューションを使用している場合、接続参照はソリューション内で管理する必要があります。管理者にソリューションの構成を確認し、接続参照を正しいソリューションに作成するよう依頼してください。
• 接続の共有と権限 特定の接続は複数のフローで共有されていることがあります。インポート先で同じ接続を使い回す場合は、その接続の共有設定と権限を管理者に調整してもらう必要があります。

よくある質問(FAQ)

• Q: インポート時に「接続参照が見つからない」と出たが、対象環境に同じ名前で接続参照を作成してもまだエラーになる。
  A: 接続参照の名前だけでなく、コネクタの種類も一致しているか確認してください。また、大文字小文字の違いがないか、フローの定義ファイルを直接確認することをおすすめします。
• Q: 接続参照のコネクタの種類を変更したいが、編集できない。
  A: 接続参照のコネクタの種類は作成後に変更できません。該当の接続参照を削除し、正しいコネクタの種類で再作成してください。ただし、他のフローで使用されている場合は影響が出る可能性があるため、管理者に相談してから行ってください。
• Q: 接続参照を新しく作成したが、インポート時に選択できない。
  A: 新しく作成した接続参照が、インポートするフローと同じソリューションに属しているか確認してください。ソリューションが異なる場合、ドロップダウンリストに表示されません。
• Q: インポートは成功したが、フローを実行すると認証エラーになる。
  A: インポート時に割り当てた接続の認証情報が正しくない可能性があります。接続を再度作成し、適切なアカウントでサインインし直してください。また、接続が期限切れでないかも確認しましょう。

まとめ

Power Automateの接続参照が原因でインポートできない問題は、原因を特定して適切な対処を取れば、多くの場合解決可能です。最初にエラーメッセージを確認し、不足している接続参照の名前とコネクタの種類を把握することが重要です。インポート先の環境に正しい名前と種類で接続参照を作成し、インポート時に適切な接続を割り当てることで、失敗を回避できます。また、ソリューションやDLPポリシーなど、組織の設定に影響を受ける場合があるため、管理者と連携して作業を進めることをおすすめします。本記事の手順を参考に、スムーズな環境移行を実現してください。