WIP: Feat/subform service task

src/Altinn.App.Core/Extensions/ServiceCollectionExtensions.cs

@@ -377,6 +377,7 @@ private static void AddProcessServices(IServiceCollection services)
 
         services.AddTransient<IServiceTask, PdfServiceTask>();
         services.AddTransient<IServiceTask, EFormidlingServiceTask>();
+        services.AddTransient<IServiceTask, SubformPdfServiceTask>();
     }
 
     private static void AddActionServices(IServiceCollection services)

src/Altinn.App.Core/Internal/Pdf/IPdfService.cs

@@ -31,13 +31,32 @@ Task GenerateAndStorePdf(
         string? customFileNameTextResourceKey,
         List<string>? autoGeneratePdfForTaskIds = null,
         CancellationToken ct = default
-    ) => GenerateAndStorePdf(instance, taskId, ct);
+    ) => throw new NotImplementedException();
+
+    /// <summary>
+    /// Generate a PDF of what the user can currently see from the given instance of an app. Saves the PDF
+    /// to storage as a new binary file associated with the predefined PDF data type in most apps.
+    /// </summary>
+    /// <param name="instance">The instance details.</param>
+    /// <param name="taskId">The task id for which the PDF is generated</param>
+    /// <param name="subformComponentId">The subform component identifier.</param>
+    /// <param name="subformDataElementId">The subform data element identifier.</param>
+    /// <param name="customFileNameTextResourceKey">A text resource element id for the file name of the PDF. If no text resource is found, the literal value will be used. If null, a default file name will be used.</param>
+    /// <param name="ct">Cancellation token for when a request should be stopped before it's completed.</param>
+    Task GenerateAndStoreSubformPdfs(
+        Instance instance,
+        string taskId,
+        string? customFileNameTextResourceKey,
+        string subformComponentId,
+        string subformDataElementId,
+        CancellationToken ct
+    ) => throw new NotImplementedException();
 
     /// <summary>
     /// Generate a PDF of what the user can currently see from the given instance of an app.
     /// </summary>
     /// <param name="instance">The instance details.</param>
-    /// <param name="taskId">The task id for which the pdf is generated</param>
+    /// <param name="taskId">The task id for which the PDF is generated</param>
     /// <param name="ct">Cancellation token for when a request should be stopped before it's completed.</param>
     Task<Stream> GeneratePdf(Instance instance, string taskId, CancellationToken ct);
 

src/Altinn.App.Core/Internal/Pdf/PdfService.cs

@@ -62,7 +62,7 @@ public async Task GenerateAndStorePdf(Instance instance, string taskId, Cancella
     {
         using var activity = _telemetry?.StartGenerateAndStorePdfActivity(instance, taskId);
 
-        await GenerateAndStorePdfInternal(instance, taskId, null, null, ct);
+        await GenerateAndStorePdfInternal(instance, taskId, null, null, null, null, ct);
     }
 
     /// <inheritdoc/>
@@ -80,11 +80,34 @@ await GenerateAndStorePdfInternal(
             instance,
             taskId,
             customFileNameTextResourceKey,
+            null,
+            null,
             autoGeneratePdfForTaskIds,
             ct
         );
     }
 
+    /// <inheritdoc/>
+    public async Task GenerateAndStoreSubformPdfs(
+        Instance instance,
+        string taskId,
+        string? customFileNameTextResourceKey,
+        string subformComponentId,
+        string subformDataElementId,
+        CancellationToken ct
+    )
+    {
+        await GenerateAndStorePdfInternal(
+            instance,
+            taskId,
+            customFileNameTextResourceKey,
+            subformComponentId,
+            subformDataElementId,
+            null,
+            ct
+        );
+    }
+
     /// <inheritdoc/>
     public async Task<Stream> GeneratePdf(Instance instance, string taskId, bool isPreview, CancellationToken ct)
     {
@@ -96,7 +119,7 @@ public async Task<Stream> GeneratePdf(Instance instance, string taskId, bool isP
 
         var language = GetOverriddenLanguage(queries) ?? await auth.GetLanguage();
 
-        return await GeneratePdfContent(instance, language, isPreview, null, ct);
+        return await GeneratePdfContent(instance, language, isPreview, null, null, null, ct);
     }
 
     /// <inheritdoc/>
@@ -109,6 +132,8 @@ private async Task GenerateAndStorePdfInternal(
         Instance instance,
         string taskId,
         string? customFileNameTextResourceKey,
+        string? subformComponentId,
+        string? subformDataElementId,
         List<string>? autoGeneratePdfForTaskIds = null,
         CancellationToken ct = default
     )
@@ -123,6 +148,8 @@ private async Task GenerateAndStorePdfInternal(
             instance,
             language,
             false,
+            subformComponentId,
+            subformDataElementId,
             autoGeneratePdfForTaskIds,
             ct
         );
@@ -143,6 +170,8 @@ private async Task<Stream> GeneratePdfContent(
         Instance instance,
         string language,
         bool isPreview,
+        string? subformComponentId,
+        string? subformDataElementId,
         List<string>? autoGeneratePdfForTaskIds,
         CancellationToken ct
     )
@@ -156,7 +185,15 @@ CancellationToken ct
             autoGeneratePdfForTaskIds
         );
 
-        Uri uri = BuildUri(baseUrl, pagePath, language, autoPdfTaskIdsQueryParams);
+        Uri uri = BuildUri(
+            instance.Process?.CurrentTask?.ElementId ?? string.Empty,
+            baseUrl,
+            pagePath,
+            language,
+            subformComponentId,
+            subformDataElementId,
+            autoPdfTaskIdsQueryParams
+        );
 
         bool displayFooter = _pdfGeneratorSettings.DisplayFooter;
 
@@ -177,15 +214,35 @@ CancellationToken ct
     }
 
     private static Uri BuildUri(
+        string currentTaskId,
         string baseUrl,
         string pagePath,
         string language,
+        string? subformComponentId,
+        string? subformDataElementId,
         List<KeyValuePair<string, string>>? additionalQueryParams = null
     )
     {
         // Uses string manipulation instead of UriBuilder, since UriBuilder messes up
         // query parameters in combination with hash fragments in the url.
         string url = baseUrl + pagePath;
+
+        if (!string.IsNullOrEmpty(subformComponentId) && !string.IsNullOrEmpty(subformDataElementId))
+        {
+            // Remove the ?pdf=1 part temporarily to insert subform segments
+            int pdfIndex = url.IndexOf("?pdf=1", StringComparison.OrdinalIgnoreCase);
+            if (pdfIndex > 0)
+            {
+                string beforePdf = $"{url[..pdfIndex]}/{currentTaskId}/subform";
+                string afterPdf = url[pdfIndex..];
+                url = $"{beforePdf}/{subformComponentId}/{subformDataElementId}/{afterPdf}";
+            }
+            else
+            {
+                url += $"/{currentTaskId}/subform/{subformComponentId}/{subformDataElementId}";
+            }
+        }
+
         string lang = Uri.EscapeDataString(language);
         if (url.Contains('?'))
         {

src/Altinn.App.Core/Internal/Process/Elements/AltinnExtensionProperties/AltinnSubformPdfConfiguration.cs

@@ -0,0 +1,74 @@
+using System.Diagnostics.CodeAnalysis;
+using System.Xml.Serialization;
+using Altinn.App.Core.Internal.App;
+
+namespace Altinn.App.Core.Internal.Process.Elements.AltinnExtensionProperties;
+
+/// <summary>
+/// Configuration properties for payments in a process task
+/// </summary>
+public class AltinnSubformPdfConfiguration
+{
+    /// <summary>
+    /// Set the filename of the PDF using a text resource key.
+    /// </summary>
+    [XmlElement("filenameTextResourceKey", Namespace = "http://altinn.no/process")]
+    public string? FilenameTextResourceKey { get; set; }
+
+    /// <summary>
+    /// The ID of the subform component to render in the PDFs.
+    /// </summary>
+    [XmlElement("subformComponentId", Namespace = "http://altinn.no/process")]
+    public string? SubformComponentId { get; set; }
+
+    /// <summary>
+    /// The ID of the data type associated with the subform component.
+    /// </summary>
+    [XmlElement("subformDatatTypeId", Namespace = "http://altinn.no/process")]
+    public string? SubformDataTypeId { get; set; }
+
+    /// <summary>
+    /// Whether to generate PDFs for multiple subform data elements in parallel or sequentially.
+    /// Defaults to false (sequential) to avoid overwhelming the PDF microservice.
+    /// Set to true only if your PDF microservice can handle concurrent requests.
+    /// </summary>
+    [XmlElement("parallelExecution", Namespace = "http://altinn.no/process")]
+    public bool ParallelExecution { get; set; }
+
+    internal ValidAltinnSubformPdfConfiguration Validate()
+    {
+        List<string>? errorMessages = null;
+
+        string? normalizedFilename = string.IsNullOrWhiteSpace(FilenameTextResourceKey)
+            ? null
+            : FilenameTextResourceKey.Trim();
+
+        if (SubformComponentId.IsNullOrWhitespace(ref errorMessages, $"{nameof(SubformComponentId)} is missing."))
+            ThrowApplicationConfigException(errorMessages);
+
+        if (SubformDataTypeId.IsNullOrWhitespace(ref errorMessages, $"{nameof(SubformDataTypeId)} is missing."))
+            ThrowApplicationConfigException(errorMessages);
+
+        return new ValidAltinnSubformPdfConfiguration(
+            normalizedFilename,
+            SubformComponentId,
+            SubformDataTypeId,
+            ParallelExecution
+        );
+    }
+
+    [DoesNotReturn]
+    private static void ThrowApplicationConfigException(List<string> errorMessages)
+    {
+        throw new ApplicationConfigException(
+            "Subform pdf service task configuration is not valid: " + string.Join(",\n", errorMessages)
+        );
+    }
+}
+
+internal readonly record struct ValidAltinnSubformPdfConfiguration(
+    string? FilenameTextResourceKey,
+    string SubformComponentId,
+    string SubformDataTypeId,
+    bool ParallelExecution
+);

src/Altinn.App.Core/Internal/Process/Elements/AltinnExtensionProperties/AltinnTaskExtension.cs

@@ -46,6 +46,12 @@ public class AltinnTaskExtension
     [XmlElement("eFormidlingConfig", Namespace = "http://altinn.no/process")]
     public AltinnEFormidlingConfiguration? EFormidlingConfiguration { get; set; }
 
+    /// <summary>
+    /// Gets or sets the configuration for PDF
+    /// </summary>
+    [XmlElement("subformPdfConfig", Namespace = "http://altinn.no/process")]
+    public AltinnSubformPdfConfiguration? SubformPdfConfiguration { get; set; }
+
     /// <summary>
     /// Retrieves a configuration item for given environment, in a predictable manner.
     /// Specific configurations (those specifying an environment) takes precedence over global configurations.

src/Altinn.App.Core/Internal/Process/ProcessEngineAuthorizer.cs

@@ -106,7 +106,7 @@ public static string[] GetActionsThatAllowProcessNextForTaskType(string taskType
     {
         return taskType switch
         {
-            "data" or "feedback" or "pdf" or "eFormidling" => ["write"],
+            "data" or "feedback" or "pdf" or "eFormidling" or "subform-pdf" => ["write"],
             "payment" => ["pay", "write"],
             "confirmation" => ["confirm"],
             "signing" => ["sign", "write"],