From 6579ade1e3ada6367324a91700839821c3d938e3 Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Thu, 16 Sep 2021 14:08:08 -0600 Subject: [PATCH] [Maps] Update search docs to clarify how to disable global search, global time filter, and global refresh for layers (#111625) * [Maps] Update search docs to clarify how to disable global search, global time filter, and global refresh for layers * clean up * make timeslider icon smaller * use more common headers * clean up * review feedback * global time consistency * remove links Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com> --- docs/maps/images/timeslider_toggle_icon.png | Bin 0 -> 3955 bytes docs/maps/index.asciidoc | 2 +- docs/maps/search.asciidoc | 97 +++++++++++++------- 3 files changed, 66 insertions(+), 33 deletions(-) create mode 100644 docs/maps/images/timeslider_toggle_icon.png diff --git a/docs/maps/images/timeslider_toggle_icon.png b/docs/maps/images/timeslider_toggle_icon.png new file mode 100644 index 0000000000000000000000000000000000000000..00b09215782ec86bee22e4c0e073a9d054d9ace4 GIT binary patch literal 3955 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 E03nS$fdBvi literal 0 HcmV?d00001 diff --git a/docs/maps/index.asciidoc b/docs/maps/index.asciidoc index cbc00e965e56..157eb0f04466 100644 --- a/docs/maps/index.asciidoc +++ b/docs/maps/index.asciidoc @@ -68,7 +68,7 @@ Customize each layer to highlight meaningful dimensions in your data. For exampl [float] === Focus on only the data that’s important to you -Search across the layers in your map to focus in on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. Draw a polygon on the map or use the shape from features to create spatial filters. Filter individual layers to compares facets. +Search across the layers in your map to focus on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. Draw a polygon on the map or use the shape from features to create spatial filters. Filter individual layers to compares facets. -- diff --git a/docs/maps/search.asciidoc b/docs/maps/search.asciidoc index ada7551f3e57..af6939eb8ae1 100644 --- a/docs/maps/search.asciidoc +++ b/docs/maps/search.asciidoc @@ -2,35 +2,72 @@ [[maps-search]] == Search geographic data -Search across the layers in your map to focus in on just the data you want. +Search across the layers in your map to focus on just the data you want. Combine free text search with field-based search using the <>. Set the time filter to restrict layers by time. -Layers that request data from {es} are narrowed when you submit a <>. -Layers narrowed by semi-structured search and filters contain the filter icon image:maps/images/filter_icon.png[] next to the layer name in the legend. - -Layers that request data from {es} using an <> with a configured time field are narrowed by the <>. -These layers contain the clock icon image:maps/images/clock_icon.png[clock icon] next to the layer name in the legend. Use the time slider to quickly select time slices within the global time filter range. -Click previous and next buttons to advance the time slice backward or forward. Click play to animate your spatial temporal data. - -You can create a layer that requests data from {es} from the following: - -* <> with: - -** Documents - -** Clusters and grid - -** Point to point - -** <> - -** Top hits per entity - -** Tracks - -* <> +This image shows an example of global search and global time narrowing results. [role="screenshot"] -image::maps/images/global_search_bar.png[] +image::maps/images/global_search_bar.png[global search and global time narrowing results] + +Only layers requesting data from {es} are narrowed by global search and global time. +To add a layer that requests data from {es} to your map, click *Add layer*, then select one of the following: + +* Documents + +* Choropleth + +* Clusters and grid + +* Heat map + +* Point to point + +* Top hits per entity + +* Tracks + +[float] +[[maps-narrow-layer-by-global-search]] +==== Narrow layers by global search + +Layers that request data from {es} are narrowed when you submit a <>. +Layers narrowed by semi-structured search and filters contain the filter icon image:maps/images/filter_icon.png[] next to the layer name in the legend. + +To prevent the global search from applying to a layer, configure the following: + +* In *Filtering*, clear the *Apply global search to layer data* checkbox to turn off global search for the layer source. + +* In *Term joins*, clear the *Apply global search to join* checkbox to turn off global search for the <>. + +[float] +[[maps-narrow-layer-by-global-time]] +==== Narrow layers by global time + +Layers that request data from {es} using an <> with a configured time field are narrowed by the <>. +These layers contain the clock icon image:maps/images/clock_icon.png[clock icon] next to the layer name in the legend. + +Use the time slider to quickly select time slices within the global time range: + +. Click image:maps/images/timeslider_toggle_icon.png[timeslider icon] to open the time slider. +. Click previous and next buttons to advance the time slice backward or forward. +. Click play to animate your spatial temporal data. + +To prevent the global time filter from applying to a layer, configure the following: + +* In *Filtering*, clear the *Apply global time to layer data* checkbox to turn off the global time for the layer source. + +* In *Term joins*, clear the *Apply global time to join* checkbox to turn off the global time for the <>. + +[float] +[[maps-refresh-layer]] +==== Refresh layer data + +Layers that request data from {es} re-fetch data when <> fires and when you click *Refresh*. + +To prevent refreshing layer data, configure the following: + +* In *Filtering*, clear the *Apply global refresh to layer data* checkbox to turn off refresh for the layer source. + [role="xpack"] [[maps-create-filter-from-map]] @@ -114,13 +151,9 @@ The most common cause for empty layers are searches for a field that exists in o [float] [[maps-disable-search-for-layer]] -==== Disable search for a layer +==== Disable global search for a layer -You can prevent the search bar from applying search context to a layer by configuring the following: - -* In *Filtering*, clear the *Apply global filter to layer data* checkbox to turn off the global search context for the layer source. - -* In *Term joins*, clear the *Apply global filter to join* checkbox to turn off the global search context for the <>. +One strategy for eliminating unintentional empty layers from a cross index search is to <>. [float] [[maps-add-index-search]]