コネクタのトラブルシューティング

SharePoint コネクタの一般的な問題

以下のセクションでは、SharePoint コネクタで発生する可能性のある一般的な問題と、その問題をトラブルシューティングする方法について説明します。

アクセス許可の問題

問題 - SharePoint のリストやライブラリに対するアクセス許可が不十分なため、フローが失敗する可能性があります。

解決策 - さまざまなアプローチを使用してこの問題に対処できます。

• SharePoint コネクタに接続されているアカウントに、リスト/ライブラリに対する必要なアクセス許可があることを確認します。
• 項目の作成や更新などのアクションを必要とするフローの場合、接続にサインインしているユーザーに適切な書き込みアクセス権があることを確認します。
• 他のユーザーの代わりにフローが動作する必要がある場合、管理者アクセス許可を持つサービス アカウントの使用を検討します。

スキーマの不整合

問題 - データのコピーや移行などの操作中、ソース リストのスキーマがターゲット リストのスキーマと一致しない場合、エラーが発生します。

解決策 - さまざまなアプローチを使用してこの問題に対処できます。

• ソース リストとターゲット リスト間で列名とデータ型が一致していることを確認します。
• 選択肢、ルックアップ、個人/グループなどの列タイプには、特別な処理 (テキストではなく ID や値を渡すなど) が必要になることが多いため、特に注意してください。

ルックアップ列と選択肢列の処理方法

問題 - ルックアップ列にはテキストではなく ID 値が必要ですが、選択肢列には正確なテキスト値 (大文字と小文字が区別されます) が必要です。

解決策 - これらの列タイプには、次のようにアプローチします。

• ルックアップ列の場合、ソース リストから関連する項目の ID を渡します。
• 選択肢列の場合、必ず、ターゲット リストのスキーマに表示されるとおりに選択肢値を渡します。

ページネーションと大規模なデータセットの処理

以下のセクションでは、ページネーションと大規模なデータセットの処理方法について説明します。

ページネーションの概要

ページネーションを使用すると、項目の取得アクションなどの SharePoint コネクタ アクションを実行し、既定の制限である 100 個を超える項目を取得できます。 SharePoint では、各要求に返される項目の数が制限されていますが、ページネーションを許可すると、構成可能な最大値までこの制限が引き上げられます。

ページネーションのアクティブ化

ページネーション機能をオンにするには、次の手順に従います。

1. 項目を取得アクションで、設定 タブを選択します。
2. ページネーション トグルをオンにします。
3. 取得する項目の最大数を指定します (要求ごとに最大 5,000 項目)。

大規模なデータセットのベスト プラクティス

大規模なデータセットを使用する場合、以下のベスト プラクティスに従います。

• OData フィルターを使用して、返される品目の数を制限すると、処理時間と API の使用量が削減されます。 フィルター クエリや上位カウントを一切使用せずに項目の取得アクションを実行しようとすると、大規模なリストに対してクエリを実行した場合、実行時間が予想外に長くなるのを防ぐため、Power Automate に警告が表示されることがあります (ただし、続行は可能です)。

• 大規模なデータのセットが必要な場合、バッチ処理を検討してください。 つまり、日付範囲や特定の ID などの条件を使用して、より小さいデータ チャンクを取得します。

ID 列と一意識別子の違い

問題 - 場合によっては、項目の取得 (単数形。複数形の項目の取得とは異なります) や項目の削除などのアクションでは、アクションを実行する行の ID が必要になります。 他の状況、特にライブラリ内のファイルを操作している場合は、システムによりファイルの GUID (識別子とも呼ばれます) が使用されます。 このような状況では、どちらを使用すればよいのか分からず混乱することがあります。

解決策 - 以下の条件を考慮して、ID 列と識別子列のどちらを使用すればよいのかを判断します。

• ID 列は、リスト内の項目ごとに増分される、1 から始まる自動増分整数です。 項目の取得、項目の削除、添付ファイルの取得など、特定のリスト項目の ID を必要とするほとんどのアクションに使用します。 通常、システムではリスト項目の一意識別子として ID 列が使用されます。

• 識別子列は GUID 値です。これは、32 文字からなる 128 ビットの 16 進数であり、00000000-0000-0000-0000-000000000000 のように、5 つのセクションに分割されています。 アルゴリズムにより、複数のシステムや環境をまたがっても 2 つの GUID が同じになる可能性が極めて低くなるよう GUID が作成されます。 ファイルの内容の取得、ファイルのプロパティの取得、フォルダーの移動、ファイルの削除など、ファイルとフォルダーに対するアクションには識別子列を使用します。 通常、システムでは、ファイルとフォルダーの一意識別子として識別子列が使用されます。

  

共有ドキュメント ライブラリの名称

問題 - SharePoint のドキュメント ライブラリは、SharePoint コネクタでは共有ドキュメントとして表示されることが多いため、アクションを構成するときに混乱する可能性があります。 ただし、この変則的な名称には一貫性がないため、あるアクションではドキュメント フォルダーとして識別され、他のアクションでは同じフォルダーが共有ドキュメントとして識別されます。次に例を示します。

• ファイルの取得 (プロパティのみ) - このアクションでは、ライブラリ名を選択するときにドキュメント フォルダーが表示されます。

• ファイルの内容の取得 - このアクションでは、フォルダーをドリルスルーしてファイルを見つけるときに、共有ドキュメント フォルダーが表示されます。

どちらの例でも、ドキュメントと共有ドキュメントは同じフォルダーです。