From f0472bdb0263c37e31773725c9915c76379dc360 Mon Sep 17 00:00:00 2001 From: GeoNetwork opensource <59019313+geonetworkbuild@users.noreply.github.com> Date: Fri, 9 Feb 2024 11:08:49 +0100 Subject: [PATCH] [Backport 4.2.x] Documentation / Elasticsearch query endpoint - query samples (#7732) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Documentation / Elasticsearch query endpoint - query samples * Add step by step instructions for running eamples * Update docs/manual/docs/api/search.md Co-authored-by: François Prunayre * Update docs/manual/docs/api/search.md Co-authored-by: François Prunayre * Update docs/manual/docs/api/search.md Co-authored-by: François Prunayre --------- Co-authored-by: Jose García Co-authored-by: Jody Garnett Co-authored-by: François Prunayre --- .../docs/api/img/swagger-search-endpoint.png | Bin 0 -> 101387 bytes docs/manual/docs/api/search.md | 161 +++++++++++++++++- 2 files changed, 157 insertions(+), 4 deletions(-) create mode 100644 docs/manual/docs/api/img/swagger-search-endpoint.png diff --git a/docs/manual/docs/api/img/swagger-search-endpoint.png b/docs/manual/docs/api/img/swagger-search-endpoint.png new file mode 100644 index 0000000000000000000000000000000000000000..881492551c2a9f217b7e784dae6589c819c0e68b GIT binary patch literal 101387 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 z zzCgz_nrL%DJMNEW@B2b(R}+%@i4H8LV3Q%EbjXvUyK)7RVu8?~DN|4o0y%uz8})uV z3DqlkxaVj4a+Tgzx_Z{U6q*DYZ(hp=d7G>d*I?3)S74iEZDJxx!B4+Nj8Rb-SK7Ev zGMJR8tewHgMOcqK*V10JwR=~1xfmZjS}&wq@qv1W_)JRI)5HuPM|t41BiCig{-d(e z{)@P6HNt(Y37~gp(Xg(jEu5Ed`uT4MCM}=kD+nMpAZg!`nF=`>zkJN>#)m@pQh^(b zHI0@(>ZlsOZ>Glfz1TeQndqk??-w>8vsWVcREm3afkd1?@JqPb)*}9o{TQ5Zb0!h6 zIFAhPq-HV6bU0P06zJ@AB)ok4p~!#aAmfpAJHeC0Ca$k_NG{(>LC8q^x<3>EEoE6t z6tTYRHs8yaHc-Iw9(P+TsmfiBn$m8@yWLN*r(rWc(3P>i*ST4+93STOA|Kt~qGbj? zNLd44Fj-Lsg*xxM+fvIp3>_+Xzx;~{%Wqtfa!a9LQzuIbjL#uE$jFZ_$n0_*T1rF! zwO{q?^fM!~{T1A+T0!|GLsbhOY?Mh-YqX}NM#%$Da7sGlB54El0BO6vn6MuvR&1>@ zY$FB{k3y2ZWyhUoIn1Y9}qap{j0hG z6+KLz)>L@b+mg?U|Bnw?DK&+RMl<#=y6k0WX(W8uJscq(P;=l69fSjRPGaZW+N@J#Eq|Q(_^y^!*D0K2!3vJ zDWPbfk8ovkg+ix^$_azf*ZFt=wZ`IeNa+X=#)42b7o!|B&hJCK^9|y+-hAMHzy7as z&Gk8v*a4ZjfukmD)2Hgq_$qtJYmIE%!DWG2JofX4f2 za6awAHrbtDBL5ZCI$oO}+A%^Y> z=+02^WSsgJZ~lu1yg&=|0Ms*$oDLkIgaTlQGx;Ry)8of87t_@W$sQBci0*yzOPv#= zS)*+u_ezsT`fC7bv%PwS9L<*Ocw^TqS}VH3g)y^BLE2-97i1sHA32W z?lug$24k3iTi8*|IL@S5WbfbyI$??q%})po6Yh8h&8nKM{*kBMxXk0{5;+O?dVIBN zX*+FWl6FT2W1kw&`pqbv@&^_5DsPC^`t#l7S*&P4?HbAOJxl-BQQs}!&y+@0GΜ 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 literal 0 HcmV?d00001 diff --git a/docs/manual/docs/api/search.md b/docs/manual/docs/api/search.md index e75b5cd1369..c33350f8ad6 100644 --- a/docs/manual/docs/api/search.md +++ b/docs/manual/docs/api/search.md @@ -1,9 +1,162 @@ # Search Service -## Elasticsearch - -GeoNetwork provides a full Elasticsearch end-point: ``/srv/api/search/records/_search`` +GeoNetwork provides a access to ***Elasticsearch*** `/srv/api/search/records/_search` and `/srv/api/search/records/_msearch` end-points. These endpoints accept `POST` requests, with request body containing an Elasticsearch JSON query. Reference -- [Search API](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html) (Elasticsearch) +- [Search API](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html) ( Elasticsearch Guide ) +- [Multi search API](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html) (Elasticsearch Guide) + +## Search API examples + +This section provides some query `POST` examples of `/srv/api/search/records/_search` end-point: + +1. To test examples navigate Swagger API documentation at `/srv/api/index.html` + +2. Locate the *search* heading, and the `/search/records/_search` `POST` end-point + +3. Use the *Try it out* button with: + + * **bucket**: `metadata` + * **relatedType**: + * **Request body**: Chosen from the examples below + +4. Press **Execute** to run the example. + + ![](img/swagger-search-endpoint.png) + +### Text search query + +Query with any field for metadata containing the string `infrastructure`, using a query with Lucene syntax and excluding metadata templates: + +```json +{ + "query": { + "bool": { + "must": [ + { + "query_string": { + "query": "+anytext:infrastructure " + } + } + ], + "filter": [ + { + "term": { + "isTemplate": { + "value": "n" + } + } + } + ] + } + } +} +``` + +### Subset results + +Query with any field for metadata containing the string `infrastructure`, using a query with Lucene syntax and excluding metadata templates, returning a subset of the information: + +```json +{ + "query": { + "bool": { + "must": [ + { + "query_string": { + "query": "+anytext:infrastructure " + } + } + ], + "filter": [ + { + "term": { + "isTemplate": { + "value": "n" + } + } + } + ] + } + }, + "_source": { + "includes": [ + "uuid", + "id", + "resourceType", + "resourceTitle*", + "resourceAbstract*" + ] + } +} +``` + +### Dataset query + +Query datasets with title containing the string `infrastructure`, using a query with Lucene syntax and excluding metadata templates: + +```json +{ + "query": { + "bool": { + "must": [ + { + "query_string": { + "query": "+anytext:infrastructure +resourceType:dataset" + } + } + ], + "filter": [ + { + "term": { + "isTemplate": { + "value": "n" + } + } + } + ] + } + } +} +``` + +### Revision date query + +Query datasets with a revision date in June 2019 and excluding metadata templates: + +```json +{ + "query": { + "bool": { + "must": [ + { + "term": { + "resourceType": { + "value": "dataset" + } + } + }, + { + "range": { + "resourceTemporalDateRange": { + "gte": "2019-06-01", + "lte": "2019-06-30", + "relation": "intersects" + } + } + } + ], + "filter": [ + { + "term": { + "isTemplate": { + "value": "n" + } + } + } + ] + } + } +} +```