Release Azure Cognitive Search Track 2 Library Preview 4 for .NET

[AlexGhiondea]

This tracks the work to release the Azure Cognitive Search Track2 Preview 4 Library for .NET

API Review

• Cross language consistency meeting and API Review (Search: Address Cross-language consistency and API Review Feedback #11162)
• Finalize review and get approval for service APIs

Features

• Document Operations (punted)
  • Design and implement batching operation for document operations (Search: Design and implement batching operation for document operations #11161, Azure.Search: Align on our batching story #10594, Azure.Search: Ensure input and output document order is in sync while batching #10593) (punted)
• Service Operations
  • Complete the onlyIfUnchanged change (seems a critical commit wasn't pushed: Define onlyIfUnchanged boolean parameter for CreateOrUpdate and Delete operations #11052)
  • Implement FieldBuilder (#11166)
  • Add Get{Model}Names methods to various service clients (Search: Handle selected properties for List operations #11393)
  • Move Search index models to new namespace (Move Search index models to new namespace #11874)
  • Split SearchServiceClient operations up into separate clients (Split SearchServiceClient operations up into separate clients #11875)
  • Collection properties should be read-only (Search: collection properties should be read-only #11712)
  • Make discriminating base types abstract (Base classes like ScoringFunction should be abstract #9686)
• Document Operations
  • FacetResults strong types (Azure.Search: Add strongly typed FacetResult helpers #10613)
  • Move spatial types to Azure.Core (Unify on Azure.Core spatial types #10592)
  • Move SearchDocument to Azure.Core (Azure.Search: Investigate a more efficient way of injecting properties into user models with System.Text.Json #10589, Azure.Search: Investigate more robust conversions for dynamic objects #10591, Azure.Search: Clean up JSON parsing #10596, Azure.Search: Verify switching from "NaN" to NaN in dynamic scenarios #10601, Azure.Search: Expose JsonSerializerOptions #10606, Azure.Search: Add Get accessors to SearchDocument #10609, Azure.Search: IndexDocumentsBatch.Upload<T> is not serializing complex fields #10944, [Search][BUG] Wrong dynamic for empty array of string #8699)
  • Other (Azure.Search: Determine the correct approach for nested SearchErrors #10598, Azure.Search: Add model factories for Search #10610, [Search] Adding ClientBuilderExtensions #10848)
  • Tracking from Core (Azure.Search: Fix ClientRequestId tests when supported by the generator #10604)
  • Pushing forward to next release (Azure.Search: Remove ForwardsClientCalls on generated operations #10611, Azure.Search: Verify escaping when splitting OData $select, etc. #10600, Azure.Search: Consistent ref docs best practices #10612, [FEATURE REQ] [Azure Cognitive Search] Add method to escape Lucene queries #8719, Azure.Search: Fix IndexDocuments merge with static documents test from Track 1 #10602)

Testing

• [Write more SearchServiceClient tests (coverage for less-common CRUD operations). (punted)
• Create one index per test instead of one service per test.

Docs

• Write lots of samples for docs and XML doc comments (punted)

[heaths]

Azure.Search.Documents 1.0.0-preview.4 has been shipped.