埋め込みダッシュボードのフィルタリング

フィルタ可能なフィールドの指定

ダッシュボード作成者は、埋め込みアプリケーション コードによって設定される、またはダッシュボード ビューアによって追加される事前フィルターとフィルターに含めることができるフィールドを指定します。 ダッシュボード作成者は、特定のフィールドのみをフィルタリングできるようにすることで、データへのアクセスを制限できます。 デフォルトでは、フィールドは許可されていません。つまり、少なくとも 1 つのフィールドを明示的に許可するまで、ダッシュボードをフィルタリングできません。

フィルタ可能なフィールドを定義するには、次の手順に従います。

1. Dashboards ページから、目的のダッシュボードを選択します。ダッシュボードに移動する手順については、「ダッシュボード」を参照してください。

2. 目的のダッシュボードで、次をクリックします: [] ボタンをクリックし、ドロップダウンから [ Embed ] を選択します。

3. Allowed filter fieldsセクションで、 [] ボタン。

   注意

   このオプションは、 非認証または認証済みの埋め込みアクセスがすでに有効になっている場合にのみ表示されます。

   ダッシュボード ビューがデータをフィルタリングできるフィールドは、次の方法で指定できます。

   • ドロップダウンを使用してフィールドを選択します

   • ドロップダウンにリストされていないフィールドを追加するには、値を手動で入力します

   • 選択 Allow all fields in the data source used in this dashboard

4. 必要なフィールドをすべて選択したら、ドロップダウンの下の [ Save ] をクリックします。

ダッシュボード ビューアとダッシュボードをレンダリングするアプリケーションは、指定されたフィールドに基づくフィルターを使用して、元のダッシュボード データのサブセットを表示できるようになりました。許可されているフィルター フィールド リストに含まれていないフィールドにフィルターを使用しようとすると、Atlas Charts はエラーを返します。

{
  "name": "Alice",
  "favorites" :
  {
    "color": "green",
    "animal": "turtle",
    "season": "autumn"
  }
}

iFrame に埋め込まれたダッシュボードのデータを事前フィルタリング

多数のコレクションを持つ埋め込みチャートとダッシュボードには事前フィルターを使用します。 事前フィルターは埋め込みチャートのパイプラインの早い段階で実行され、次の結果を得ることができます。

• データを早期にフィルタリングしてクエリの実行時間を短縮

• ビューの後にクエリを実行する前にフィルターを適用し、集計を含むクエリにはフィルターを適用します

プレフィルターは フィルターと完全に一致し、同じ構文を使用します。 唯一の違いは、ビューの後に実行され、クエリとフィルターが開始される前に実行されることです。 パイプライン セグメントの順序の詳細については、「集計パイプライン 」を参照してください。

iFrame に埋め込まれたダッシュボードのデータをフィルタリング

filterクエリ パラメータを使用して、指定されたMQLフィルターに一致するデータのみを iFrame に埋め込まれたダッシュボードに表示します。

クエリ filterパラメータはUnauthenticated ダッシュボードでのみ使用できます。認証されていないダッシュボードでは、ダッシュボード作成者は、埋め込みアプリケーションコードによって設定されるフィルター、またはダッシュボード ビューアによって追加されるフィルターに含めることができるフィールドを指定します。フィルタ可能なフィールドを指定する方法については、「 フィルタ可能なフィールドの指定 」を参照してください。

https://charts.mongodb.com/charts-atlasproject1-piocy/embed/dashboards?
id=93584ddb-1115-4a12-afd9-5129e47bbb0d&
filter={"imdb.rating":%20{$gte:%208}}

{"imdb.rating": {$gte: 8}}

SDK が埋め込まれたダッシュボードのデータを事前フィルタリング

preFilterオプションを使用して埋め込みダッシュボードにpreFilterを追加できます。 事前フィルタリングにより、ダッシュボード作成者はクエリ実行前にフィルターを実行できます。

Embedモーダルで、事前フィルターに含めるフィールドを指定する必要があります。 Embedモーダルには、フィルタリングを許可するフィールドのドロップダウン メニューが含まれています。

次の例では、 preFilterオプションを使用してオーストラリア内のドキュメントのみを表します。

createDashboard({
  baseUrl: '<your-base-url>',
  dashboardId: '<your-chart-id>',
  width: 500,
  height: 500,
  preFilter: { "address.country": "Australia" }
})

SDK が埋め込まれたダッシュボードのデータをフィルタリング

filterオプションを使用して埋め込みダッシュボードにフィルターを追加できます。フィルタリングにより、ダッシュボード作成者は、指定されたMQLフィルターに一致する埋め込みダッシュボード内のデータのみを表示できます。

Embedモーダルで、フィルターに含めるフィールドを指定する必要があります。 Embedモーダルには、フィルタリングを許可するフィールドのドロップダウン メニューが含まれています。

次の では、 filterオプションを使用して、 totalフィールドが100より大きいドキュメントのみを表します。

createDashboard({
  baseUrl: '<your-base-url>',
  dashboardId: '<your-dashboard-id>',
  width: 500,
  height: 500,
  filter: { "total": { "$gt": 100 } }
})

function getFilter(context) {
  return { ownerId: context.token.sub };
}