feat: Ability to select a BaselineCollection for bulk export

docs/openapi.json

@@ -597,6 +597,47 @@
         ]
       }
     },
+    "/api/projects/{projectId}/collections/{collectionId}": {
+      "get": {
+        "operationId": "getCollectionItems",
+        "parameters": [
+          {
+            "description": "Project ID",
+            "in": "path",
+            "name": "projectId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "description": "Collection ID",
+            "in": "path",
+            "name": "collectionId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CollectionItem"
+                }
+              }
+            },
+            "description": "List of collection item"
+          }
+        },
+        "summary": "Get items from collection",
+        "tags": [
+          "Collections"
+        ]
+      }
+    },
     "/api/projects/{projectId}/name": {
       "get": {
         "operationId": "getProjectName",
@@ -1504,6 +1545,20 @@
         },
         "type": "object"
       },
+      "CollectionItem": {
+        "description": "Details about the collection item",
+        "properties": {
+          "moduleNameWithSpace": {
+            "description": "The name of the module with spaces",
+            "type": "string"
+          },
+          "revision": {
+            "description": "The revision of the module",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
       "ConfigurationStatus": {
         "properties": {
           "details": {
@@ -1640,6 +1695,7 @@
           "documentType": {
             "description": "Type of the document",
             "enum": [
+              "BASELINE_COLLECTION",
               "LIVE_DOC",
               "LIVE_REPORT",
               "TEST_RUN",

src/main/java/ch/sbb/polarion/extension/pdf_exporter/converter/PdfConverter.java

@@ -136,6 +136,7 @@ public byte[] convertToPdf(@NotNull ExportParams exportParams, @Nullable ExportM
             case LIVE_REPORT -> documentDataHelper.getLiveReport(project, exportParams);
             case TEST_RUN -> documentDataHelper.getTestRun(Objects.requireNonNull(project), exportParams);
             case WIKI_PAGE -> documentDataHelper.getWikiPage(project, exportParams);
+            default -> throw new IllegalArgumentException("Unknown document type: " + exportParams.getDocumentType());
         };
     }
 

src/main/java/ch/sbb/polarion/extension/pdf_exporter/rest/PdfExporterRestApplication.java

@@ -3,6 +3,8 @@
 import ch.sbb.polarion.extension.generic.rest.GenericRestApplication;
 import ch.sbb.polarion.extension.generic.settings.NamedSettingsRegistry;
 import ch.sbb.polarion.extension.pdf_exporter.converter.PdfConverterJobsCleaner;
+import ch.sbb.polarion.extension.pdf_exporter.rest.controller.CollectionApiController;
+import ch.sbb.polarion.extension.pdf_exporter.rest.controller.CollectionInternalController;
 import ch.sbb.polarion.extension.pdf_exporter.rest.controller.ConverterApiController;
 import ch.sbb.polarion.extension.pdf_exporter.rest.controller.ConverterInternalController;
 import ch.sbb.polarion.extension.pdf_exporter.rest.controller.SettingsApiController;
@@ -68,6 +70,8 @@ public PdfExporterRestApplication() {
                 new SettingsInternalController(),
                 new TestRunAttachmentsApiController(),
                 new TestRunAttachmentsInternalController(),
+                new CollectionApiController(),
+                new CollectionInternalController(),
                 new UtilityResourcesApiController(),
                 new UtilityResourcesInternalController()
         );

src/main/java/ch/sbb/polarion/extension/pdf_exporter/rest/controller/CollectionApiController.java

@@ -0,0 +1,19 @@
+package ch.sbb.polarion.extension.pdf_exporter.rest.controller;
+
+import ch.sbb.polarion.extension.generic.rest.filter.Secured;
+import ch.sbb.polarion.extension.generic.service.PolarionService;
+import ch.sbb.polarion.extension.pdf_exporter.rest.model.collections.CollectionItem;
+
+import javax.ws.rs.Path;
+import java.util.List;
+
+@Secured
+@Path("/api")
+public class CollectionApiController extends CollectionInternalController {
+    private static final PolarionService polarionService = new PolarionService();
+
+    @Override
+    public List<CollectionItem> getCollectionItems(String projectId, String collectionId) {
+        return polarionService.callPrivileged(() -> super.getCollectionItems(projectId, collectionId));
+    }
+}

src/main/java/ch/sbb/polarion/extension/pdf_exporter/rest/controller/CollectionInternalController.java

@@ -0,0 +1,47 @@
+package ch.sbb.polarion.extension.pdf_exporter.rest.controller;
+
+
+import ch.sbb.polarion.extension.pdf_exporter.rest.model.collections.CollectionItem;
+import ch.sbb.polarion.extension.pdf_exporter.service.PdfExporterPolarionService;
+import com.polarion.alm.shared.api.transaction.TransactionalExecutor;
+import io.swagger.v3.oas.annotations.Hidden;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.media.Content;
+import io.swagger.v3.oas.annotations.media.Schema;
+import io.swagger.v3.oas.annotations.responses.ApiResponse;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+import javax.ws.rs.GET;
+import javax.ws.rs.Path;
+import javax.ws.rs.PathParam;
+import javax.ws.rs.Produces;
+import javax.ws.rs.core.MediaType;
+import java.util.List;
+
+@Hidden
+@Path("/internal")
+@Tag(name = "Collections")
+public class CollectionInternalController {
+    private final PdfExporterPolarionService pdfExporterPolarionService;
+
+    public CollectionInternalController() {
+        pdfExporterPolarionService = new PdfExporterPolarionService();
+    }
+
+    @GET
+    @Path("/projects/{projectId}/collections/{collectionId}")
+    @Produces(MediaType.APPLICATION_JSON)
+    @Operation(summary = "Get items from collection",
+            responses = {
+                    @ApiResponse(responseCode = "200",
+                            description = "List of collection item",
+                            content = @Content(schema = @Schema(implementation = CollectionItem.class))
+                    )
+            }
+    )
+    public List<CollectionItem> getCollectionItems(@Parameter(description = "Project ID", required = true) @PathParam("projectId") String projectId,
+                                                   @Parameter(description = "Collection ID", required = true) @PathParam("collectionId") String collectionId) {
+        return TransactionalExecutor.executeSafelyInReadOnlyTransaction(transaction -> pdfExporterPolarionService.getCollectionItems(projectId, collectionId, transaction));
+    }
+}

src/main/java/ch/sbb/polarion/extension/pdf_exporter/rest/model/collections/CollectionItem.java

@@ -0,0 +1,18 @@
+package ch.sbb.polarion.extension.pdf_exporter.rest.model.collections;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Schema(description = "Details about the collection item")
+public class CollectionItem {
+    @Schema(description = "The name of the module with spaces")
+    private String moduleNameWithSpace;
+
+    @Schema(description = "The revision of the module")
+    private String revision;
+}

src/main/java/ch/sbb/polarion/extension/pdf_exporter/rest/model/conversion/DocumentType.java

@@ -5,6 +5,9 @@
 
 @Schema(description = "Type of the document")
 public enum DocumentType {
+    @Schema(description = "Baseline collection")
+    BASELINE_COLLECTION,
+
     @Schema(description = "Live document")
     LIVE_DOC,
 

src/main/java/ch/sbb/polarion/extension/pdf_exporter/service/PdfExporterPolarionService.java

@@ -6,17 +6,22 @@
 import ch.sbb.polarion.extension.generic.settings.SettingName;
 import ch.sbb.polarion.extension.generic.util.ScopeUtils;
 import ch.sbb.polarion.extension.pdf_exporter.rest.model.attachments.TestRunAttachment;
+import ch.sbb.polarion.extension.pdf_exporter.rest.model.collections.CollectionItem;
 import ch.sbb.polarion.extension.pdf_exporter.rest.model.settings.stylepackage.StylePackageModel;
 import ch.sbb.polarion.extension.pdf_exporter.rest.model.settings.stylepackage.StylePackageWeightInfo;
 import ch.sbb.polarion.extension.pdf_exporter.settings.StylePackageSettings;
 import ch.sbb.polarion.extension.pdf_exporter.util.WildcardUtils;
 import com.polarion.alm.projects.IProjectService;
+import com.polarion.alm.shared.api.model.baselinecollection.BaselineCollectionReference;
+import com.polarion.alm.shared.api.transaction.ReadOnlyTransaction;
 import com.polarion.alm.tracker.ITestManagementService;
 import com.polarion.alm.tracker.ITrackerService;
 import com.polarion.alm.tracker.model.IModule;
 import com.polarion.alm.tracker.model.ITestRun;
 import com.polarion.alm.tracker.model.ITestRunAttachment;
 import com.polarion.alm.tracker.model.ITrackerProject;
+import com.polarion.alm.tracker.model.baselinecollection.IBaselineCollection;
+import com.polarion.alm.tracker.model.baselinecollection.IBaselineCollectionElement;
 import com.polarion.core.util.StringUtils;
 import com.polarion.platform.IPlatformService;
 import com.polarion.platform.persistence.IDataService;
@@ -28,11 +33,13 @@
 import org.jetbrains.annotations.Nullable;
 
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collection;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
+import java.util.stream.Collectors;
 
 public class PdfExporterPolarionService extends PolarionService {
 
@@ -115,7 +122,7 @@ private boolean isStylePackageSuitable(@Nullable String projectId, @NotNull Stri
             return true;
         } else {
             IDataService dataService = getTrackerService().getDataService();
-            IPObjectList<IModule> suitableDocuments =  dataService.searchInstances(dataService.getPrototype("Module"), model.getMatchingQuery(), "name");
+            IPObjectList<IModule> suitableDocuments = dataService.searchInstances(dataService.getPrototype("Module"), model.getMatchingQuery(), "name");
             for (IModule suitableDocument : suitableDocuments) {
                 if (sameDocument(projectId, spaceId, documentName, suitableDocument)) {
                     return true;
@@ -165,4 +172,21 @@ private boolean sameDocument(@Nullable String projectId, @NotNull String spaceId
         }
         return testRunAttachment;
     }
+
+    public @NotNull List<CollectionItem> getCollectionItems(@NotNull String projectId, @NotNull String collectionId, @NotNull ReadOnlyTransaction transaction) {
+        List<CollectionItem> collectionItemList = new ArrayList<>();
+        IBaselineCollection collection = new BaselineCollectionReference(projectId, collectionId).get(transaction).getOldApi();
+        collection.getElements()
+                .stream()
+                .map(IBaselineCollectionElement::getObjectWithRevision)
+                .filter(IModule.class::isInstance)
+                .map(IModule.class::cast)
+                .forEach(module -> {
+                    String moduleNameWithSpace = Arrays.stream(module.getModuleNameWithSpace().split("/"))
+                            .map(String::trim)
+                            .collect(Collectors.joining("/"));
+                    collectionItemList.add(new CollectionItem(moduleNameWithSpace, module.getLastRevision()));
+                });
+        return collectionItemList;
+    }
 }

src/main/java/ch/sbb/polarion/extension/pdf_exporter/util/DocumentDataHelper.java

@@ -131,7 +131,6 @@ public DocumentData<ITestRun> getTestRun(@NotNull ITrackerProject project, @NotN
         });
     }
 
-
     public DocumentData<IWikiPage> getWikiPage(@Nullable ITrackerProject project, @NotNull ExportParams exportParams) {
         return getWikiPage(project, exportParams, true);
     }

src/main/java/ch/sbb/polarion/extension/pdf_exporter/util/DocumentFileNameHelper.java

@@ -50,6 +50,7 @@ public String getDocumentFileName(@NotNull ExportParams exportParams) {
                     case LIVE_REPORT -> documentDataHelper.getLiveReport(project, exportParams, false);
                     case TEST_RUN -> documentDataHelper.getTestRun(project, exportParams, false);
                     case WIKI_PAGE -> documentDataHelper.getWikiPage(project, exportParams, false);
+                    default -> throw new IllegalArgumentException("Unknown document type: " + exportParams.getDocumentType());
                 };
 
         FileNameTemplateModel fileNameTemplateModel = getFileNameTemplateModel(ScopeUtils.getScopeFromProject(exportParams.getProjectId()));
@@ -80,6 +81,7 @@ public String getDocumentFileName(@NotNull ExportParams exportParams) {
                 yield fileNameTemplateModel.getTestRunNameTemplate();
             case WIKI_PAGE:
                 yield fileNameTemplateModel.getWikiNameTemplate();
+            default: throw new IllegalArgumentException("Unknown document type: " + documentType);
         };
     }
 

src/main/java/ch/sbb/polarion/extension/pdf_exporter/util/HtmlProcessor.java

@@ -185,6 +185,7 @@ public String processHtmlForPDF(@NotNull String html, @NotNull ExportParams expo
                 processingHtml = adjustColumnWidthInReports(processingHtml);
                 yield removeFloatLeftFromReports(processingHtml);
             }
+            default -> throw new IllegalArgumentException("Unknown document type: " + exportParams.getDocumentType());
         };
         html = replaceResourcesAsBase64Encoded(html);
         html = MediaUtils.removeSvgUnsupportedFeatureHint(html); //note that there is one more replacement attempt before replacing images with base64 representation
@@ -196,6 +197,7 @@ public String processHtmlForPDF(@NotNull String html, @NotNull ExportParams expo
                 yield new NumberedListsSanitizer().fixNumberedLists(processingHtml);
             }
             case LIVE_REPORT, TEST_RUN -> html;
+            default -> throw new IllegalArgumentException("Unknown document type: " + exportParams.getDocumentType());
         };
 
         // ----
@@ -217,6 +219,7 @@ public String processHtmlForPDF(@NotNull String html, @NotNull ExportParams expo
         html = switch (exportParams.getDocumentType()) {
             case LIVE_DOC, WIKI_PAGE -> localizeEnums(html, exportParams);
             case LIVE_REPORT, TEST_RUN -> html;
+            default -> throw new IllegalArgumentException("Unknown document type: " + exportParams.getDocumentType());
         };
 
         if (exportParams.isEnableCommentsRendering()) {

src/main/java/ch/sbb/polarion/extension/pdf_exporter/widgets/BulkPdfExportWidget.java

@@ -53,7 +53,7 @@ public ReadOnlyStrictMap<String, RichPageParameter> getParametersDefinition(@Not
         FieldsParameter columns = parameterFactory.fields(localization.getString("richpages.widget.table.columns")).build();
         SortingParameter sortBy = parameterFactory.sorting(localization.getString("richpages.widget.table.sortBy")).build();
         DataSetParameter dataSet = parameterFactory.dataSet(localization.getString("richpages.widget.table.dataSet"))
-                .allowedPrototypes(PrototypeEnum.Document, PrototypeEnum.TestRun, PrototypeEnum.RichPage)
+                .allowedPrototypes(PrototypeEnum.Document, PrototypeEnum.TestRun, PrototypeEnum.RichPage, PrototypeEnum.BaselineCollection)
                 .add("columns", columns)
                 .add("sortBy", sortBy)
                 .dependencySource(true)