feat(webapi): Option to include deleted dialogs in ServiceOwner dialog search (#1816)

<!--- Provide a general summary of your changes in the Title above -->

## Description

<!--- Describe your changes in detail -->

## Related Issue(s)

- #1817 

## Verification

- [ ] **Your** code builds clean without any errors or warnings
- [ ] Manual testing done (required)
- [ ] Relevant automated test added (if you find this hard, leave it and
we'll help out)

## Documentation

- [ ] Documentation is updated (either in `docs`-directory, Altinnpedia
or a separate linked PR in
[altinn-studio-docs.](https://github.com/Altinn/altinn-studio-docs), if
applicable)

Co-authored-by: Magnus Sandgren <5285192+MagnusSandgren@users.noreply.github.com>
Co-authored-by: Bjørn Dybvik Langfors <bdl@digdir.no>

Author: 3 people

docs/schema/V1/swagger.verified.json

@@ -327,6 +327,20 @@
         },
         "type": "object"
       },
+      "V1Common_dFilter": {
+        "description": "",
+        "enum": [
+          "Exclude",
+          "Include",
+          "Only"
+        ],
+        "type": "string",
+        "x-enumNames": [
+          "Exclude",
+          "Include",
+          "Only"
+        ]
+      },
       "V1CommonContent_ContentValue": {
         "additionalProperties": false,
         "properties": {
@@ -4073,6 +4087,12 @@
             "format": "date-time",
             "type": "string"
           },
+          "deletedAt": {
+            "description": "If deleted, the date and time when the deletion was performed.",
+            "format": "date-time",
+            "nullable": true,
+            "type": "string"
+          },
           "dueAt": {
             "description": "The due date for the dialog. This is the last date when the dialog is expected to be completed.",
             "example": "2022-12-31T23:59:59Z",
@@ -5688,6 +5708,19 @@
             },
             "style": "form"
           },
+          {
+            "description": "If set to \u0027include\u0027, the result will include both deleted and non-deleted dialogs\nIf set to \u0027exclude\u0027, the result will only include non-deleted dialogs\nIf set to \u0027only\u0027, the result will only include deleted dialogs",
+            "in": "query",
+            "name": "deleted",
+            "schema": {
+              "allOf": [
+                {
+                  "$ref": "#/components/schemas/V1Common_dFilter"
+                }
+              ],
+              "nullable": true
+            }
+          },
           {
             "description": "Only return dialogs created after this date",
             "in": "query",

src/Digdir.Domain.Dialogporten.Application/Features/V1/Common/DeletedFilter.cs

@@ -0,0 +1,8 @@
+namespace Digdir.Domain.Dialogporten.Application.Features.V1.Common;
+
+public enum DeletedFilter
+{
+    Exclude = 1,
+    Include = 2,
+    Only = 3
+}

src/Digdir.Domain.Dialogporten.Application/Features/V1/ServiceOwner/Dialogs/Queries/Search/DialogDtoBase.cs

@@ -102,6 +102,11 @@ public class DialogDtoBase
     /// <example>2022-12-31T23:59:59Z</example>
     public DateTimeOffset? DueAt { get; set; }
 
+    /// <summary>
+    /// If deleted, the date and time when the deletion was performed.
+    /// </summary>
+    public DateTimeOffset? DeletedAt { get; set; }
+
     /// <summary>
     /// The timestamp when the dialog will be made visible for authorized end users.
     /// </summary>
@@ -198,4 +203,3 @@ public sealed class DialogActivityDto
     /// </summary>
     public List<LocalizationDto> Description { get; set; } = [];
 }
-

src/Digdir.Domain.Dialogporten.Application/Features/V1/ServiceOwner/Dialogs/Queries/Search/SearchDialogQuery.cs

@@ -8,6 +8,7 @@
 using Digdir.Domain.Dialogporten.Application.Common.ReturnTypes;
 using Digdir.Domain.Dialogporten.Application.Externals;
 using Digdir.Domain.Dialogporten.Application.Externals.AltinnAuthorization;
+using Digdir.Domain.Dialogporten.Application.Features.V1.Common;
 using Digdir.Domain.Dialogporten.Domain.DialogEndUserContexts.Entities;
 using Digdir.Domain.Dialogporten.Domain.Dialogs.Entities;
 using Digdir.Domain.Dialogporten.Domain.Localizations;
@@ -51,6 +52,13 @@ public sealed class SearchDialogQuery : SortablePaginationParameter<SearchDialog
     /// </summary>
     public List<DialogStatus.Values>? Status { get; init; }
 
+    /// <summary>
+    /// If set to 'include', the result will include both deleted and non-deleted dialogs
+    /// If set to 'exclude', the result will only include non-deleted dialogs
+    /// If set to 'only', the result will only include deleted dialogs
+    /// </summary>
+    public DeletedFilter? Deleted { get; set; } = DeletedFilter.Exclude;
+
     /// <summary>
     /// Only return dialogs created after this date
     /// </summary>
@@ -191,7 +199,10 @@ public async Task<SearchDialogResult> Handle(SearchDialogQuery request, Cancella
                 x.Content.Any(x => x.Value.Localizations.AsQueryable().Any(searchExpression)) ||
                 x.SearchTags.Any(x => EF.Functions.ILike(x.Value, request.Search!))
             )
+            .WhereIf(request.Deleted == DeletedFilter.Exclude, x => !x.Deleted)
+            .WhereIf(request.Deleted == DeletedFilter.Only, x => x.Deleted)
             .Where(x => resourceIds.Contains(x.ServiceResource))
+            .IgnoreQueryFilters()
             .ProjectTo<IntermediateDialogDto>(_mapper.ConfigurationProvider)
             .ToPaginatedListAsync(request, cancellationToken: cancellationToken);