Move explain to body in search template API (#6098) (#6099)

* Move explain to body in search template API

* Remove BOM

* Correct descriptor default

Co-authored-by: Steve Gordon <[email protected]>

Author: github-actions[bot]

src/ApiGenerator/Configuration/Overrides/Endpoints/SearchTemplateOverrides.cs

@@ -0,0 +1,17 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+using System.Collections.Generic;
+
+namespace ApiGenerator.Configuration.Overrides.Endpoints
+{
+	// ReSharper disable once UnusedMember.Global
+	public class SearchTemplateOverrides : EndpointOverridesBase
+	{
+		public override IEnumerable<string> SkipQueryStringParams => new[]
+		{
+			"explain"
+		};
+	}
+}

src/Elasticsearch.Net/Api/RequestParameters/RequestParameters.NoNamespace.cs

@@ -2030,13 +2030,6 @@ public ExpandWildcards? ExpandWildcards
 			set => Q("expand_wildcards", value);
 		}
 
-		///<summary>Specify whether to return detailed information about score computation as part of a hit</summary>
-		public bool? Explain
-		{
-			get => Q<bool? >("explain");
-			set => Q("explain", value);
-		}
-
 		///<summary>Whether specified concrete, expanded or aliased indices should be ignored when throttled</summary>
 		public bool? IgnoreThrottled
 		{

src/Nest/Descriptors.NoNamespace.cs

@@ -1445,8 +1445,6 @@ public SearchTemplateDescriptor<TDocument> Index<TOther>()
 		public SearchTemplateDescriptor<TDocument> CcsMinimizeRoundtrips(bool? ccsminimizeroundtrips = true) => Qs("ccs_minimize_roundtrips", ccsminimizeroundtrips);
 		///<summary>Whether to expand wildcard expression to concrete indices that are open, closed or both.</summary>
 		public SearchTemplateDescriptor<TDocument> ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards);
-		///<summary>Specify whether to return detailed information about score computation as part of a hit</summary>
-		public SearchTemplateDescriptor<TDocument> Explain(bool? explain = true) => Qs("explain", explain);
 		///<summary>Whether specified concrete, expanded or aliased indices should be ignored when throttled</summary>
 		public SearchTemplateDescriptor<TDocument> IgnoreThrottled(bool? ignorethrottled = true) => Qs("ignore_throttled", ignorethrottled);
 		///<summary>Whether specified concrete indices should be ignored when unavailable (missing or closed)</summary>

src/Nest/Requests.NoNamespace.cs

@@ -3125,13 +3125,6 @@ public ExpandWildcards? ExpandWildcards
 			set => Q("expand_wildcards", value);
 		}
 
-		///<summary>Specify whether to return detailed information about score computation as part of a hit</summary>
-		public bool? Explain
-		{
-			get => Q<bool? >("explain");
-			set => Q("explain", value);
-		}
-
 		///<summary>Whether specified concrete, expanded or aliased indices should be ignored when throttled</summary>
 		public bool? IgnoreThrottled
 		{

src/Nest/Search/SearchTemplate/SearchTemplateRequest.cs

@@ -21,6 +21,9 @@ public partial interface ISearchTemplateRequest : ITypedSearchRequest
 
 		[DataMember(Name ="source")]
 		string Source { get; set; }
+
+		[DataMember(Name = "explain")]
+		public bool? Explain { get; set; }
 	}
 
 	public partial class SearchTemplateRequest
@@ -30,6 +33,9 @@ public partial class SearchTemplateRequest
 		public IDictionary<string, object> Params { get; set; }
 
 		public string Source { get; set; }
+
+		public bool? Explain { get; set; }
+
 		protected Type ClrType { get; set; }
 		Type ITypedSearchRequest.ClrType => ClrType;
 
@@ -54,6 +60,8 @@ public partial class SearchTemplateDescriptor<TDocument> where TDocument : class
 
 		string ISearchTemplateRequest.Source { get; set; }
 
+		bool? ISearchTemplateRequest.Explain { get; set; }
+
 		protected sealed override void RequestDefaults(SearchTemplateRequestParameters parameters) => TypedKeys();
 
 		public SearchTemplateDescriptor<TDocument> Source(string template) => Assign(template, (a, v) => a.Source = v);
@@ -64,5 +72,7 @@ public partial class SearchTemplateDescriptor<TDocument> where TDocument : class
 
 		public SearchTemplateDescriptor<TDocument> Params(Func<FluentDictionary<string, object>, FluentDictionary<string, object>> paramDictionary) =>
 			Assign(paramDictionary, (a, v) => a.Params = v?.Invoke(new FluentDictionary<string, object>()));
+
+		public SearchTemplateDescriptor<TDocument> Explain(bool? explain = true) => Assign(explain, (a, v) => a.Explain = v);
 	}
 }