埋め込みChartsフィルタリング

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

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

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

1. フィルタ可能なフィールドを定義するチャートを含むダッシュボードに移動します。

2. 目的のグラフで、次をクリックします。 [] ボタンをクリックし、ドロップダウンから [ Embed Chartを選択します。

3. Allowed filter fieldsセクションでは、 ドロップダウンを使用して、チャートユーザーがチャート内のフィルター データを使用できるフィールドを選択します。 ドロップダウンにリストされていないフィールドを追加するために、手動で値を入力することもできます。

   注意

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

   チャート ビューアがデータを事前フィルタリングまたはフィルタリングできるフィールドを指定するには、次の方法があります。

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

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

   • Allow all fields in the data source used in this chart を選択します。

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

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

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

iFrame に埋め込まれたChartsのデータの事前フィルタリング

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

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

• 集計を含むチャートクエリのクエリ実行前にフィルターを適用します。

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

preFilterクエリ パラメータを使用して、iFrame に埋め込まれたグラフのデータをフィルタリングします。

フィルタで使用されるフィールドが許可されているフィルタ可能なフィールドのリストに含まれている場合は、 preFilterクエリ パラメータとして MQL ドキュメントを指定できます。

iFrame に埋め込まれた Atlas Charts のデータのフィルタリング

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

クエリ パラメータは、 チャートと チャートの両方で使用できます。filterUnauthenticatedVerified Signatureフィルタリングの動作は、各認証設定によって異なります。

• 認証されていないチャートの場合、チャート作成者は、埋め込みアプリケーションコードによって設定されるフィルターまたはチャートビューによって追加されるフィルターに含めることができるフィールドを指定します。 フィルタ可能なフィールドを指定する方法については、「 フィルタ可能なフィールドの指定 」を参照してください。

• 検証済み署名を必要とするチャートでは、すべてのドキュメント フィールドをフィルタリングできますが、サーバー側のコードでフィルターを生成し、署名されたペイロードの一部としてフィルターを含める必要があります。

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

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

{ "quantity": { $gte: 20 } }

{ $or: [ { quantity: { $lt: 20 } }, { price: 10 } ] }

https://charts.mongodb.com/charts-atlasproject1-piocy/embed/charts?
id=93584ddb-1115-4a12-afd9-5129e47bbb0d&
timestamp=1564156636&
expires-in=300&
filter=%7B%22imdb.rating%22%3A%20%7B%24gte%3A%208%7D%7D&
autoRefresh=60&
signature=8e0d92b33934c928f6c6974e2f0102ace77f56d851cb0d33893e84c359ab1043

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

SDK に埋め込まれたChartsのデータの事前フィルタリング

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

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

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

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

SDK に埋め込まれた Atlas Charts のデータをフィルタリング

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

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

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

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

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