Power Automate の Microsoft SharePoint コネクタ

  • [アーティクル]

Power Automate では、Microsoft SharePoint Connector では、次のフロー トリガーとアクションがサポートされています。

SharePoint トリガー

SharePoint トリガーを使用すると、SharePoint リストまたはライブラリ内の変更を監視するフローを作成できます。 サブスクライブされたリストで 1 つ以上の変更が発生した場合、そのフローが実行されるようにトリガーされます。

アイテムを作成した場合

SharePoint リストにアイテムを作成するときにフローをトリガーします。

アイテムを作成か変更した場合

アイテムを作成するときにフローをトリガーし、SharePoint リストで変更するたびにフローをトリガーします。

アイテムまたはファイルが変更されたとき

SharePoint リストまたはドキュメント ライブラリ内のアイテムまたはファイルを変更するときにフローをトリガーします。

このトリガーの使用方法の詳細については、このチュートリアルビデオ「アイテムまたはファイルが変更されたとき」トリガーと「変更を取得する」アクションを参照してください

アイテムを削除した場合

リスト内の項目を削除するときにフローをトリガーします。 削除済みアイテムのプロパティを取得するには、サイト コレクション ユーザー アカウントを使用して、このトリガーを実行する必要がある関連する SharePoint サイトに接続する必要があります。

選択したアイテムに対して

リスト内のアイテムを選択した後で、リストのユーザーがフローをトリガーできるようにします。

注:

SharePoint リストから手動で実行できるのは、既定の環境内のフローのみです。

ファイルがコンテンツ理解モデルによって分類される場合

Microsoft Syntexコンテンツ理解モデルがファイルを分類するときにフローをトリガーします。ファイルの分類日付プロパティに表示されます。

Microsoft Syntexのタイミングとファイルの分類方法の詳細については、「Microsoft Microsoft Syntexの概要」を参照してください。

ファイルの作成時 (プロパティのみ)

ドキュメント ライブラリでファイルを作成するときにフローをトリガーし、そのファイルに関連付けられているカスタム ファイル プロパティのみを返します。

フォルダーにファイルが作成されたとき [非推奨]

注:

このトリガーは非推奨であり、期待どおりに機能しない可能性があります。

SharePoint フォルダーにファイルを作成するときにフローをトリガーします。 このトリガーが動作しているフォルダー内のサブフォルダーにファイルを追加または更新した場合、このトリガーは実行されません。 サブフォルダーでトリガーするフローが必要な場合は、1 つ以上のサブフォルダーに対して異なるフローを作成します。

ファイルが作成または変更されたとき (プロパティのみ)

ファイルを作成するとき、およびライブラリ内のファイル プロパティを変更するたびにフローをトリガーします。 特定のフォルダーを対象とする "Folder" プロパティに値を指定します。それ以外の場合、トリガーはライブラリ全体に適用されます。 そのファイルに関連付けられているカスタム ファイル プロパティのみを返します。

フォルダー内でファイルが作成または変更された場合 [非推奨]

注:

このトリガーは非推奨であり、期待どおりに機能しない可能性があります。

ファイルが作成されるときにトリガーされます。また、ファイルが SharePoint フォルダーで変更されるたびにトリガーされます。 ファイルがサブフォルダーに追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

ファイルを削除する場合

ドキュメント ライブラリ内のファイルを削除するときにフローをトリガーします。 必要に応じて、watchするフォルダーを指定できます。 フォルダーを削除すると、トリガーは削除されたフォルダー (サブフォルダーを含む) に対して 1 回だけアクティブになります。 削除されたファイルのプロパティを取得するには、このトリガーを、サイト コレクション ユーザー アカウントを使用して、トリガーの実行が予期される関連する SharePoint サイトに接続する必要があります。

選択したファイルに対して

ドキュメント ライブラリのユーザーは、ファイルを選択した後にフローをトリガーできます。

注:

SharePoint ライブラリから手動で実行できるのは、既定の環境内のフローのみです。

サイトがハブ サイトへの参加を要求した場合

ハブ サイト参加承認要求時にフローをトリガーします。

SharePoint アクション

添付ファイルを追加

指定したリスト アイテムに新しい添付ファイルを追加します。

ハブ サイト参加要求を承認する

ハブ サイト参加要求を承認します。 このアクションは、参加ハブ サイト アクションを使用して、参加要求を完了するための承認トークンを返します。

ハブ サイト参加要求を取り消す

ハブ参加要求を取り消します。 該当する場合は、[ ハブ サイトの参加状態を保留中に設定 する] アクションで使用されるのと同じ承認相関 ID を指定します。

ファイルをチェックイン

ドキュメント ライブラリのチェックアウト ファイルをチェックインします。これにより、ドキュメントのバージョンを他のユーザーが使用できるようになります。

ファイルをチェックアウト

ドキュメント ライブラリ内のファイルをチェックアウトして、他のユーザーがドキュメントを編集できないようにし、ドキュメントにチェックするまで変更が表示されないようにします。

ファイルをコピー

ファイルをコピーします。 SharePoint ライブラリの [コピー先 ] コマンドと同様に機能します。 コピー後、新しいファイルに関する情報を返します。

ファイルのコピー [非推奨]

注:

このアクションは非推奨であり、期待どおりに機能しない可能性があります。

ファイルを SharePoint サイトにコピーします。

フォルダーをコピー

フォルダーをコピーします。 SharePoint ライブラリの [コピー先 ] コマンドと同様に機能します。 コピー後、新しいフォルダーに関する情報を返します。

ファイルの作成

SharePoint サイトにファイルをアップロードします。 必ず既存のライブラリを選択してください。

アイテムの作成

SharePoint リストに新しい項目を作成します。

新しいフォルダーを作成

新しいフォルダーまたはフォルダー パスを作成します。

ファイルまたはフォルダーの共有リンクを作成します。

添付ファイルを削除

指定した添付ファイルを削除します。

ファイルを削除する

ファイル識別子で指定されたファイルを削除します。

アイテムの削除

SharePoint リストからアイテムを削除します。

チェック アウトを破棄

ファイルをチェックして変更を加えない場合、または保持したくない変更を加えた場合は、ファイルを保存するのではなく、チェックアウトを破棄します。 organizationがバージョンを追跡する場合、ファイルをライブラリにチェックするたびに新しいバージョンが作成されます。 チェックアウトを破棄することで、ファイルに変更を加えていないときに新しいバージョンを作成しないようにすることができます。

フォルダーの抽出

アーカイブ ファイルを SharePoint フォルダー (たとえば、.zip) に抽出します。

すべてのリストとライブラリを取得する

すべてのリストとライブラリを取得します。

添付ファイルの内容を取得

ファイル識別子を使用して、ファイルの内容を返します。 内容は別の場所にコピーすることも、添付ファイルとして使用することもできます。

添付ファイルを取得する

指定したリスト アイテムの添付ファイルの一覧を返します。 ファイルの内容を取得するには、[ 添付ファイルのコンテンツの取得 ] ステップを追加し、このアクションによって返される [ファイル識別子 ] プロパティを使用します。

項目またはファイルの変更を取得する (プロパティのみ)

指定した時間間隔以降に変更されたすべての列またはファイル プロパティを取得します。 項目またはファイルが変更されたときに変更されたすべての列を取得するには:

  • 項目またはファイルが変更された場合は を使用します。トリガーと、
  • [トリガー ウィンドウの開始トークン] & 項目またはファイルが変更されたときのトリガーからのトリガー ウィンドウ終了トークンの出力を使用して、項目またはファイルの更新を最後にチェックしたフロー以降に変更された列を推測します。

このアクションの使用方法の詳細については、このチュートリアルビデオ「アイテムまたはファイルが変更されたとき」トリガーと「変更を取得する」アクションを参照してください。

注:

  • リストまたはライブラリは、前回の変更以降に変更された列またはプロパティを推測するために、バージョン管理を構成する必要があります。
  • リストとライブラリでは、列の変更のみがサポートされます。
  • ファイル コンテンツの変更はサポートされていません。
  • 添付ファイルの変更はサポートされていません。
  • トリガー ウィンドウの開始トークン & トリガー ウィンドウの終了トークン は、 アイテムまたはファイルが変更されたトリガーを使用する場合 にのみ使用できます。

ファイル コンテンツを取得する

ファイル識別子を使用してファイルの内容を取得します。 コンテンツは別の場所にコピーすることも、添付ファイルとして使用することもできます。

パスを使用してファイル コンテンツを取得する

ファイル パスを使用して、ファイルの内容を取得します。

ファイル メタデータを取得する

サイズ、etag、作成日などのファイルに関する情報を取得します。 ファイル識別子を使用してファイルを選択します。 ライブラリ内の列に格納されている値を取得するには、[ ファイル プロパティの取得 ] アクションを使用します。

パスを使用してファイル メタデータを取得する

サイズ、etag、作成日などのファイルに関する情報を取得します。 ファイル パスを使用してファイルを選択します。 ライブラリ内の列に格納されている値を取得するには、[ ファイル プロパティの取得 ] アクションを使用します。

ファイル プロパティを取得

項目 ID で指定された項目のライブラリ内の列に保存されているプロパティを取得します。ファイルの内容を取得するには、"ファイル コンテンツの取得" 手順を追加し、このアクションによって返される "ファイル識別子" プロパティを使用します。 オンプレミス データ ゲートウェイでこれを使用する場合は、接続するライブラリの名前を手動で入力する必要がある場合があります。

ファイルの取得 (プロパティのみ)

ライブラリに格納されているすべてのフォルダーとファイルの、ライブラリ内の列に保存されているプロパティを取得します。 条件に一致する項目を絞り込むこともできます。 このアクションの出力を操作するには、 各セクションに適用を 使用します。 オンプレミス データ ゲートウェイでこれを使用する場合は、接続するライブラリの名前を手動で入力する必要がある場合があります。 このアクションの詳細については、「 Power Automate でのフローの アイテムの取得 とファイルの SharePoint アクションの取得」の詳細な分析に関するページを参照してください。

フォルダー メタデータを取得する

フォルダーに関する情報を取得します。 ファイル識別子を使用してフォルダーを選択します。

パスを使用してフォルダー メタデータを取得する

フォルダーに関する情報を取得します。 フォルダー パスを使用してフォルダーを選択します。

項目を取得する

SharePoint リストから ID で 1 つの項目を取得します。

アイテムを取得

SharePoint リストから項目を取得します。 このアクションの詳細については、「 Power Automate でのフローの アイテムの取得 とファイルの SharePoint アクションの取得」の詳細な分析に関するページを参照してください。

リスト ビューを取得する

SharePoint リストからビューを取得します。

リストを取得する

サイトから SharePoint リストを取得します。

アイテムまたはフォルダーへのアクセスを許可

特定のユーザーに SharePoint のアイテムまたはフォルダーへのアクセスを許可します。

ハブ サイトに参加する

要求されたサイトをハブ サイトに参加します。 そのハブで承認が必要な場合は、参加を正常に完了するために承認トークンが必要です。 該当する場合は、[ ハブ サイトの参加状態を保留中に設定 する] アクションで使用されるのと同じ承認相関 ID を指定します。

フォルダーの一覧表示

SharePoint フォルダーに含まれるファイルを返します。

ルート フォルダーを一覧表示する

ルート SharePoint フォルダー内のファイルを返します。

ファイルを移動

ファイルを移動します。 SharePoint ライブラリの [移動 ] コマンドと同様に機能します。 移動後の新しいファイルに関する情報を返します。

フォルダーの移動

フォルダーを移動します。 SharePoint ライブラリの [移動 ] コマンドと同様に機能します。 移動後の新しいフォルダーに関する情報を返します。

人を解決する

person 型の列に割り当てることができるように、一致する 1 つのユーザー値を返します。 一致または複数の一致がない場合、このアクションはエラーになります。

SharePoint に HTTP 要求を送信する

呼び出す SharePoint REST API を構築します。 このアクションの詳細については、「 Power Automate での SharePoint 送信 HTTP 要求フロー アクションの操作」を参照してください。

重要

このアクションは、アクセス権を持つ任意の SharePoint REST API を実行できます。 慎重に進めてください。

コンテンツの承認状態を設定する

コンテンツの承認が有効になっているリストまたはライブラリ内のアイテムのコンテンツ承認状態を設定します。 ページとファイルの ETag を指定する必要があります。 ETag は、[ファイル メタデータの取得] アクションを使用して取得できます。 このアクションは、SharePoint Online と SharePoint 2019 でのみ使用できます。

ハブ サイトの参加状態を [保留中] に設定する

要求されたサイトのハブ参加要求の状態を保留中に設定します。 承認相関 ID は、SharePoint が特定のハブ参加要求を識別するのに役立つ省略可能なパラメーターです。 要求サイトは、特定の時点で保留中の要求を 1 つだけ持つことができます。

アイテムの共有を停止

アイテムまたはファイルへのアクセスを許可するすべてのリンクを削除し、所有者を除く直接アクセス権を持つすべてのユーザーを削除します。

ファイルの更新

ファイル識別子によって指定されたファイルの内容を更新します。

ファイル プロパティを更新

アイテム ID で指定された項目のライブラリ内の列に格納されているプロパティを更新します。 ファイルの内容を更新するには、[ ファイルの更新 ] アクションを使用します。 オンプレミス データ ゲートウェイでこれを使用する場合は、接続するライブラリの名前を手動で入力する必要がある場合があります。

アイテムの更新

SharePoint リスト内のアイテムを更新します。

SharePoint Server のサポート

次の表に、SharePoint オンプレミス 2013、2016、または 2019 でサポートされているすべてのアクションとトリガーを示します。 言及されていないアクションまたはトリガーはサポートされていません。

サポートされているトリガー

トリガー SharePoint 2013 SharePoint 2016 SharePoint 2019
フォルダーにファイルを作成した場合 はい はい はい
フォルダーのファイルを作成または変更した場合 はい はい はい
アイテムを作成した場合 はい1 はい1 はい1
アイテムを作成か変更した場合 はい1 はい1 はい1
ファイルの作成時 (プロパティのみ) いいえ いいえ はい1
ファイルが作成または変更されたとき (プロパティのみ) いいえ いいえ はい1
アイテムを削除した場合 いいえ いいえ はい2
ファイルを削除する場合 いいえ いいえ はい2
人を解決する いいえ いいえ はい
コンテンツの承認状態を設定する いいえ いいえ はい

注:

  1. "ビューによる列の制限" はサポートされていません。
  2. このトリガーは SharePoint 2019 でサポートされていますが、このトリガーを使用して作成されたフローでは、次の問題が発生する可能性があります。
    • リストに 60 日を超えるアクティビティがない場合、またはアクティビティがあるが 60 日間削除されていない場合、トリガーはアクティブ化に失敗します。
    • システム ユーザーによるリスト 項目の削除によって、トリガーがアクティブになります。

サポートされているアクション

アクション SharePoint 2013 SharePoint 2016 SharePoint 2019
ファイル メタデータを取得する はい はい はい
パスを使用してファイル メタデータを取得する はい はい はい
フォルダー メタデータを取得する はい はい はい
パスを使用してフォルダー メタデータを取得する はい はい はい
ファイル コンテンツを取得する はい はい はい
ファイルの作成 はい1 はい1 はい1
ファイルの更新 はい はい はい
ファイルのコピー [非推奨]2 はい はい はい
フォルダーの一覧表示 はい はい はい
フォルダーの抽出 はい はい はい
添付ファイルを取得する はい はい はい
添付ファイルを追加 はい はい はい
添付ファイルを削除 はい はい はい
アイテムを取得 はい3 はい3 はい3
項目を取得する はい4 はい4 はい4
アイテムの作成 はい4 はい4 はい4
アイテムの更新 はい4 はい4 はい4
アイテムの削除 はい はい はい
SharePoint に HTTP 要求を送信する はい はい はい

注:

  1. 一連のチャンクとしてアップロードすることで大きなファイルを作成することはできません。
  2. このアクションには、表示名に "[非推奨]" が含まれています。 "ファイルのコピー" アクションは、このアクションとは異なります。
  3. このアクションは OData パラメーターのみをサポートします。このパラメーターでは、"エントリをフォルダーに制限する"、"入れ子になった項目を含める"、"ビューによる列の制限" などのパラメーターが除外されます。
  4. "ビューによる列の制限" はサポートされていません。

非推奨のトリガーとアクション

これらのトリガーは非推奨となり、アクティブに維持されなくなります。 Microsoft SharePoint コネクタには引き続き存在しますが、新しいアプリケーションやソリューションで非推奨のトリガーやアクションを使用しないことをお勧めします。

名前 型 サポートされているバージョン 推奨される代替案
フォルダーにファイルが作成されたとき [非推奨] トリガー SharePoint 2019 ファイルの作成時 (プロパティのみ)
フォルダー内でファイルが作成または変更された場合 [非推奨] トリガー SharePoint 2019 ファイルが作成または変更されたとき (プロパティのみ)
ファイルのコピー [非推奨] アクション SharePoint 2019 ファイルをコピー

既知の制限

サポートされているリスト テンプレートとライブラリ テンプレート

リストの Power Automate フローは、汎用リスト (100) と汎用ドキュメント ライブラリ (101) でのみサポートされます。 現在、お知らせ、連絡先、タスクなどのリストを含むがこれに限定されない、カスタム リストとライブラリ テンプレートはサポートされていません。

フローの実行

アイテムに対してトリガーされる Power Automate フローを構築するとき、またはファイルを作成または変更する場合、Power Automate は、フローのトリガーで構成されたリストまたはライブラリの変更を定期的にチェックします。 ほとんどの場合、リストまたはライブラリに 1 つの変更がある場合、その変更後数分でフロー実行が発生する可能性があります。 ただし、最後に有効な変更からフロー間隔までの時間、または項目またはファイルに対する後続の編集により、フローが後続のフロー実行で複数の変更を収集する可能性があります。

ファイルとフローの実行を移動する

1 つ以上のファイルを 1 つのドキュメント ライブラリから別のドキュメント ライブラリに移動すると、元のファイルがソース ライブラリからコピー先ライブラリに移動されます。 ファイルを移動しても、ファイルの作成時や変更時など、カスタム メタデータは変更されません。 そのため、このアクションでは、移動されたライブラリに関連付けられているファイル更新プログラムのフローはトリガーされません。

ファイルを OneDrive for Business および SharePoint ドキュメント ライブラリに同期する

ユーザーが 1 つ以上のファイルを 1 つのドキュメント ライブラリから別のドキュメント ライブラリに同期すると、元のファイルがクライアントからコピー先ライブラリに移動 (同期) されます。 ファイルを同期しても、ファイルの作成時や変更時など、カスタム メタデータは変更されません。 そのため、このアクションでは、そのライブラリ内または OneDrive for business のファイル同期のフローはトリガーされません。

サポートされている参照列

リスト/ライブラリにルックアップ列がある場合、 アイテムの取得 と ファイルの取得 アクションでは、最大 12 個の参照列を持つアイテムの返しがサポートされます。 リストまたはライブラリがこのしきい値を超えると、Power Automate のフローは失敗します。