chore: update swagger, add exception log

doc/swagger.json

@@ -211,13 +211,27 @@
                         "type": "string",
                         "required": false
                     },
+                    {
+                        "name": "overwriteTest",
+                        "in": "formData",
+                        "description": "Deprecated: use `overwriteTestUri` parameter with the URI of the test to be replaced. Flag that indicates if already existed tests and all related items are removed in a case they have the same title and class as uploaded tests. Can be used to replace existing test and avoid creating a new one with the same title and class. 'true' value counts as true, 'false' as false",
+                        "type": "string",
+                        "required": false
+                    },
                     {
                         "name": "overwriteTestUri",
                         "in": "formData",
                         "description": "Test URI, that can be used to replace existing test and avoid creating a new one with the same title and class",
                         "type": "string",
                         "required": false
                     },
+                    {
+                        "name": "packageLabel",
+                        "in": "formData",
+                        "description": "Label for items folder and test label, which will be used instead of QTI test title",
+                        "type": "string",
+                        "required": false
+                    },
                     {
                         "name": "enableMetadataGuardians",
                         "in": "formData",
@@ -350,13 +364,27 @@
                         "type": "string",
                         "required": false
                     },
+                    {
+                        "name": "overwriteTest",
+                        "in": "formData",
+                        "description": "Deprecated: use `overwriteTestUri` parameter with the URI of the test to be replaced. Flag that indicates if already existed tests and all related items are removed in a case they have the same title and class as uploaded tests. Can be used to replace existing test and avoid creating a new one with the same title and class. 'true' value counts as true, 'false' as false",
+                        "type": "string",
+                        "required": false
+                    },
                     {
                         "name": "overwriteTestUri",
                         "in": "formData",
                         "description": "Test URI, that can be used to replace existing test and avoid creating a new one with the same title and class",
                         "type": "string",
                         "required": false
                     },
+                    {
+                        "name": "packageLabel",
+                        "in": "formData",
+                        "description": "Label for items folder and test label, which will be used instead of QTI test title",
+                        "type": "string",
+                        "required": false
+                    },
                     {
                         "name": "enableMetadataGuardians",
                         "in": "formData",

models/classes/class.CrudQtiTestsService.php

@@ -19,6 +19,7 @@
  *
  */
 
+use oat\oatbox\log\LoggerAwareTrait;
 use oat\tao\model\TaoOntology;
 
 /**
@@ -32,6 +33,8 @@
  */
 class taoQtiTest_models_classes_CrudQtiTestsService extends tao_models_classes_CrudService
 {
+    use LoggerAwareTrait;
+
     /** (non-PHPdoc)
      * @see tao_models_classes_CrudSservice::getClassService()
      */
@@ -106,7 +109,26 @@ public function importQtiTest(
 
             return $report;
         } catch (common_exception_UserReadableException $e) {
+            $this->logException($e);
+
             return new common_report_Report(common_report_Report::TYPE_ERROR, __($e->getUserMessage()));
+        } catch (Throwable $exception) {
+            $this->logException($exception);
+
+            return new common_report_Report(common_report_Report::TYPE_ERROR, __('QTI test import failed'));
         }
     }
+
+    private function logException(Throwable $exception): void
+    {
+        $this->logError(
+            sprintf(
+                'QTI test import failed: %s. File: %s, Line: %s. Stack trace: %s',
+                $exception->getMessage(),
+                $exception->getFile(),
+                $exception->getLine(),
+                $exception->getTraceAsString()
+            )
+        );
+    }
 }