フローで行のリストを使用する

  • [アーティクル]

行の一覧 アクションを使用して、構造化クエリで Microsoft Dataverse から一度に複数の行を取得します。

行の一覧を取得する

次の手順に従って、行を一覧表示 アクションをフローに追加して、Dataverse の アカウント テーブルから 最大 5000 アカウント を返します。

注意

Power Automate 従来のクラウド フロー デザイナーまたは Copilot を備えたクラウド フロー デザイナーのいずれかを使用します。 どのデザイナーを使用しているかを確認するには、コパイロット機能を使用した新しいクラウド フロー デザイナーを理解する の メモ セクションをご覧ください。

  1. 新しいステップ を選択して、アクションをフローに追加します。
  2. 操作の選択カードのコネクタとアクションを検索する検索ボックスに、行を一覧化する と入力します。
  3. Microsoft Dataverse を選択して、検索結果をフィルタリングして、Microsoft Dataverse のアクションとトリガーのみを表示します。
  4. 行の一覧表示 を選択します。
  5. テーブル名 リストから アカウント テーブルを選択します。
  6. フローを保存して実行し、5,000 行以下だけが返されることを確認します。

5000 行以上をリクエストするには、ページ付けをオンにします

クエリから 5000 行を超える行を自動的に取得するには、設定 から ページ付け 機能をオンにします。

ページ割り付けが設定されていて、行数が構成されたしきい値の数を超えると、要求には次の行セットを要求するための @odata.nextLink パラメーターが含まれません。 ページ割り付けをオフにして、応答に次の行セットを要求するために使用できる @ odata.nextLinkパラメーターが含まれるようにします。 使用方法については、スキップ トークンをご覧ください。

コンテンツ スループットの制限 および メッセージ サイズの制限 が一般的なサービス保証を保証するために適用されます。

  1. 行を一覧表示する カードの右上隅で、メニュー (...) を選択します。

  2. 設定を選択します。

  3. まだオンになっていない場合は、ページ付け スライダーに オン に配置します。

  4. しきい値で、要求された行の最大数を入力します。 構成可能な最大しきい値は 100,000 です。

    内部的には、この数値は規定のページサイズの増分で四捨五入されます。 たとえば、そのページサイズが 5,000 で、7,000 と入力すると、返される行数は 10,000 になります。

詳細オプション

行を一覧表示アクションの詳細オプションを使用すると、クエリの結果を並べ替え、フィルタリング、配置、および拡張できます。

詳細オプションは、行の一覧化 で直接設定できます。 オプションにアクセスするには、高度なオプションを表示する を選択します。 これを選択すると、名前が 高度なオプションを隠す に変わります。

行のリスト化カードの詳細オプションのスクリーンショット。

列を選択する

取引先企業テーブルの "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" のように、返す列のリストをカンマで区切って入力します。

行のフィルター

OData 形式のフィルター式を定義して、Dataverse が返す行のセットを絞り込みます。例: 「createdon ge 2021-01-01T00:00:00-00:00」では、2021 年またはそれ以降の createdon を含む行を返します。

標準のフィルター演算子 およびクエリ関数 を使用してフィルター クエリ式を作成する方法を学びます。

&、#、+ などの特定の文字は、URL エンコードされた同等のものに置き換える必要があります。 詳細: URL エンコード特殊文字

重要

API を直接使用する場合にのみ適用されるため、フィルター式に文字列 $filter= を含めることはできません。

並べ替え順

「name desc」など、項目が返される順序を定義する OData スタイルの式を定義するために使用します。 asc または desc 接尾辞を使用して、それぞれ昇順または降順を示します。 既定の順序は昇順です。

クエリの展開

Dataverse が関連テーブルから返すデータを定義する OData 形式の式を指定するために使用します。たとえば、primarycontactid($select=contactid,fullname) はアカウントの primarycontactid を使用して、レスポンス内の contactid という ID を持つ関連コンタクトから fullname カラムを取得します。

クエリの展開で使用できるナビゲーション プロパティには 2 つの種類があります:

  1. 単一値ナビゲーション プロパティは、多対一のリレーションシップをサポートし、別のテーブルへの参照を設定できる検索列に対応します。

  2. コレクション値 ナビゲーション プロパティは、一対多または多対多のリレーションシップに対応します。

ナビゲーション プロパティ名のみを含める場合、関連する行のすべてのプロパティが表示されます。 詳細については、クエリで関連するテーブル行を取得する を参照してください。

フロー ステップで使用するには、展開クエリ フィールドに次の Odata 式を入力します: primarycontactid(contactid,fullname)。 この例では、各 取引先企業の primarycontactid の contactid 列と fullname 列を取得する方法を示しています。

行数

Dataverse が返す行数を指定します。 これは、10 行を要求する方法を示す例です。

Fetch Xml クエリ

FetchXML クエリで 行のリスト化 アクションを使用する場合、集計クエリ は現在サポートされていません。 ただし、個別の演算子はサポートされています。

Dataverse-style FetchXML クエリを使用することで、カスタム クエリをさらに柔軟に構築できます。 これらのクエリは、複数の関連テーブルがあるテーブルを操作する場合、またはページ割り付けを処理する場合に役立ちます。 次のスクリーンショットは、FetchXML の使用方法を示しています。

Xml クエリの取得 フィールドに次のように入力します。

FetchXML を使用した取引先企業の一覧表示の例。

個別の演算子は現在、行のリスト アクションからの FetchXML クエリで直接サポートされていないため、union 関数を使って、重複する行を削除できます。 たとえば、アクションを選択を使って、リスト行接続の応答を必要な特定の配列形式に変換してから、 union(body(‘Select’),body(‘Select’)) 式を使って変数を作成し、個別の行を持つ配列を取得できます。

スキップ トークン

Power Automate では、一般的なサービス保証を確保するために、コンテンツのスループット制限や メッセージのサイズ制限 を適用しているため、既定で 返されるテーブル行数の制限 ではなく、ページ割り付けを使用してより少ない数の行を一括して返すことが有効な場合があります。

ページ割り付けを使用しない場合は、デフォルトのページ制限である 5,000 行が適用されます。

これを使用するには、ループを実装して JSON 応答の odata.nextLink 値を解析し、スキップ トークン を抽出して、必要な行数が一覧されるまで別の要求を送信します。

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0  
Content-Length: 402  
Preference-Applied: odata.maxpagesize=3  
  
{  
   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name)",
   "value":[  
      {  
         "@odata.etag":"W/\"437194\"",
         "name":"Fourth Coffee (sample)",
         "accountid":"7d51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"437195\"",
         "name":"Litware, Inc. (sample)",
         "accountid":"7f51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"468026\"",
         "name":"Adventure Works (sample)",
         "accountid":"8151925c-cde2-e411-80db-00155d2a68cb"
      }
   ],
   "@odata.nextLink":"[Organization URI]/api/data/v9.1/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b8151925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520first%253d%2522%257b7D51925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20/%3E"
}

パーティション ID

NoSQL テーブルのデータを取得する際に partitionId を指定するオプションです。 詳細については、テーブルデータにアクセスするときにストレージ パーティションを使用してパフォーマンスを向上させる を参照してください。