グループを検索する

現在のサイトにあるグループのリストを返します。

オプション

フィールド 定義 タイプ 必須

結果セット(Result Set)

検索結果のフィルタリング方法を選択します。

  • First Matching Record:一致する最初のレコードが返されます。

  • First 200 Matching Records:最初に一致する200レコードを返します。

  • Stream Matching Records:一致するすべてのレコードが親フローからヘルパーフローに渡されます。

    このオプションを選択すると、ストリーミング用のヘルパーフローを選択したりカスタム拡張可能フィールドを追加したりできるストリーミング(Streaming)入力セクションがカードに追加されます。

ドロップダウン

入力

フィールド 定義 タイプ 必須

入力(Inputs)

フィルター式(Filter Expression)

フィルター式の構文はfield:operator:valueです。

カンマで複数のフィールドを区切ります(例:userCount:lte:10,isLocal:eq:true)。

Tableauのフィルター式」を参照してください。

テキスト FALSE

ソート式(Sort Expression)

ソート式の構文はfield:directionです。

方向の値はascまたはdescです(例:name:asc)。

Tableauのソート式」を参照してください。

テキスト FALSE

ストリーミング(Streaming)

フロー(Flow)

フローの選択(Choose Flow)をクリックして検索結果をストリーミングするヘルパーフローを参照および選択し、選択(Choose)をクリックして確定します。

オプションとして、クリックまたはここにドロップして作成(Click or drop here to create)の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の状態(State)出力オブジェクトの下にキーと値のペアとして追加されます。

このフィールドは、結果セット(Result Set)オプションでStream Matching Recordsを選択した場合に表示されます。

フロー

レコード制限(Record Limit)

ストリーミングするレコードの数を指定します。

  • Record Limitフィールドを0に設定すると、カードは400 Bad Requestエラーを返します。

  • Record Limitフィールドに0より大きい値を設定すると、最大で指定された最大レコード数までのレコードが返されます。

  • Record Limitフィールドを空または選択しない場合、ストリームは全レコードを返します。

  • デフォルト値は1000000(100万)です。

  • 有効な範囲は11000000です。

このフィールドは、結果セット(Result Set)オプションでStream Recordsを選択した場合に表示されます。

数値 FALSE

出力

フィールド 定義 タイプ

結果(Result)

グループ(Groups)

このフィールドは、結果セット(Result Set)オプションでFirst 200 Matching Recordsを選択した場合に表示されます。

オブジェクトのリスト

ID

グループの一意識別子。 テキスト

名前(Name)

グループの名前。 テキスト

最小限のサイトロール(Minimum Site Role)

このTableau Cloudサイトにサインインするグループユーザーに付与された最小限のライセンスとサイトロールです。

テキスト

ユーザー数(User Count)

グループ内のユーザー数です。

数値

ドメイン名(Domain Name)

グループがActive Directoryからインポートされた場合、このフィールドにはグループのActive Directoryドメインが含まれます。

グループがローカル認証を使用する場合、このフィールドの値はlocalです。

テキスト

インポート(Import)

インポート(Import)オブジェクトにはそれぞれ、ドメイン名(Domain Name)サイトロール(Site Role)、およびライセンス付与モード(Grant License Mode)が含まれます。

onLoginをライセンス付与モードに使用するローカルグループでは、インポート(Import)オブジェクトにlocalドメイン名(Domain Name)が含まれます。

ローカルグループにライセンス付与モードが設定されていない場合、レスポンスにImportオブジェクトは存在しません。

オブジェクト

ドメイン名(Domain Name)

グループがActive Directoryからインポートされた場合、このフィールドにはグループのActive Directoryドメインが含まれます。

グループがローカル認証を使用する場合、このフィールドの値はlocalです。

テキスト

サイトのロール(Site Role)

このグループの場合、ライセンス付与モードを使って自動的にライセンスが付与されたユーザーに割り当てられたサイトロールのことです。

テキスト

ライセンス付与モード(Grant License Mode)

このグループの場合、ライセンスをグループメンバーに自動的に適用するモードのことです。

テキスト

ストリーミングされたレコード(Records Streamed)

ストリーミングフロー内でストリーミングされたレコードの数。

このフィールドは、結果セット(Result Set)オプションでStream Matching Recordsを選択した場合に表示されます。

数値