.Net: Add Summary property to OpenApiOperation model class (#12235)

### Motivation, Context and Description

This PR adds the `Summary` property to the `RestApiOperation` model
class so it's possible to access it via function metadata.

Author: SergeyMenshykh

dotnet/src/Functions/Functions.OpenApi/Model/RestApiOperation.cs

@@ -48,6 +48,19 @@ public string? Description
         }
     }
 
+    /// <summary>
+    /// The operation summary.
+    /// </summary>
+    public string? Summary
+    {
+        get => this._summary;
+        set
+        {
+            this._freezable.ThrowIfFrozen();
+            this._summary = value;
+        }
+    }
+
     /// <summary>
     /// The operation path.
     /// </summary>
@@ -399,6 +412,7 @@ value is string { } strValue &&
     private IDictionary<string, object?> _extensions = s_emptyDictionary;
     private readonly Freezable _freezable = new();
     private string? _description;
+    private string? _summary;
 
     #endregion
 }

dotnet/src/Functions/Functions.OpenApi/OpenApi/OpenApiDocumentParser.cs

@@ -219,7 +219,8 @@ internal static List<RestApiOperation> CreateRestApiOperations(OpenApiDocument d
                         securityRequirements: CreateRestApiOperationSecurityRequirements(operationItem.Security)
                     )
                     {
-                        Extensions = CreateRestApiOperationExtensions(operationItem.Extensions, logger)
+                        Extensions = CreateRestApiOperationExtensions(operationItem.Extensions, logger),
+                        Summary = operationItem.Summary
                     };
 
                     operations.Add(operation);

dotnet/src/Functions/Functions.UnitTests/OpenApi/Extensions/OpenApiKernelExtensionsTests.cs

@@ -287,6 +287,7 @@ public async Task ItShouldReplicateMetadataToOperationAsync(string documentFileN
         Assert.NotNull(operation);
         Assert.Equal("GET", additionalProperties["method"]);
         Assert.Equal("/api-with-open-api-extensions", operation.Path);
+        Assert.Equal("Get API with open-api specification extensions", operation.Summary);
         var serverUrls = additionalProperties["server-urls"] as string[];
         Assert.NotNull(serverUrls);
         Assert.Equal(["https://my-key-vault.vault.azure.net"], serverUrls);

dotnet/src/Functions/Functions.UnitTests/OpenApi/OpenApiDocumentParserV20Tests.cs

@@ -114,6 +114,7 @@ public async Task ItCanParsePutOperationMetadataSuccessfullyAsync()
         var putOperation = restApi.Operations.Single(o => o.Id == "SetSecret");
         Assert.NotNull(putOperation);
         Assert.Equal("Sets a secret in a specified key vault.", putOperation.Description);
+        Assert.Equal("Create or update secret value", putOperation.Summary);
         Assert.Equal("https://my-key-vault.vault.azure.net", putOperation.Servers[0].Url);
         Assert.Equal(HttpMethod.Put, putOperation.Method);
         Assert.Equal("/secrets/{secret-name}", putOperation.Path);
@@ -166,6 +167,7 @@ public async Task ItCanUseOperationSummaryAsync()
         var operation = restApi.Operations.Single(o => o.Id == "Excuses");
         Assert.NotNull(operation);
         Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Description);
+        Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Summary);
     }
 
     [Fact]
@@ -435,6 +437,7 @@ public async Task ItCanFilterOutSpecifiedOperationsAsync()
         Assert.Contains(restApiSpec.Operations, o => o.Id == "SetSecret");
         Assert.Contains(restApiSpec.Operations, o => o.Id == "GetSecret");
     }
+
     [Fact]
     public async Task ItCanParsePathItemPathParametersAsync()
     {

dotnet/src/Functions/Functions.UnitTests/OpenApi/OpenApiDocumentParserV30Tests.cs

@@ -122,6 +122,7 @@ public async Task ItCanParsePutOperationMetadataSuccessfullyAsync()
         var putOperation = restApi.Operations.Single(o => o.Id == "SetSecret");
         Assert.NotNull(putOperation);
         Assert.Equal("Sets a secret in a specified key vault.", putOperation.Description);
+        Assert.Equal("Create or update secret value", putOperation.Summary);
         Assert.Equal("https://my-key-vault.vault.azure.net", putOperation.Servers[0].Url);
         Assert.Equal(HttpMethod.Put, putOperation.Method);
         Assert.Equal("/secrets/{secret-name}", putOperation.Path);
@@ -197,6 +198,7 @@ public async Task ItCanUseOperationSummaryAsync()
         var operation = restApi.Operations.Single(o => o.Id == "Excuses");
         Assert.NotNull(operation);
         Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Description);
+        Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Summary);
     }
 
     [Fact]

dotnet/src/Functions/Functions.UnitTests/OpenApi/OpenApiDocumentParserV31Tests.cs

@@ -122,6 +122,7 @@ public async Task ItCanParsePutOperationMetadataSuccessfullyAsync()
         var putOperation = restApi.Operations.Single(o => o.Id == "SetSecret");
         Assert.NotNull(putOperation);
         Assert.Equal("Sets a secret in a specified key vault.", putOperation.Description);
+        Assert.Equal("Create or update secret value", putOperation.Summary);
         Assert.Equal("https://my-key-vault.vault.azure.net", putOperation.Servers[0].Url);
         Assert.Equal(HttpMethod.Put, putOperation.Method);
         Assert.Equal("/secrets/{secret-name}", putOperation.Path);
@@ -174,6 +175,7 @@ public async Task ItCanUseOperationSummaryAsync()
         var operation = restApi.Operations.Single(o => o.Id == "Excuses");
         Assert.NotNull(operation);
         Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Description);
+        Assert.Equal("Turn a scenario into a creative or humorous excuse to send your boss", operation.Summary);
     }
 
     [Fact]

dotnet/src/Functions/Functions.UnitTests/OpenApi/OpenApiKernelPluginFactoryTests.cs

@@ -300,6 +300,7 @@ public async Task ItShouldReplicateMetadataToOperationAsync(string documentFileN
         Assert.NotNull(operation);
         Assert.Equal("GET", additionalProperties["method"]);
         Assert.Equal("/api-with-open-api-extensions", operation.Path);
+        Assert.Equal("Get API with open-api specification extensions", operation.Summary);
         var serverUrls = additionalProperties["server-urls"] as string[];
         Assert.NotNull(serverUrls);
         Assert.Equal(["https://my-key-vault.vault.azure.net"], serverUrls);