updated advanced pack to 3.12.0:

Reports:

    Non-aggregated columns in Grid report export.
    Normalized table mode for 2-dimensional Grid reports.
    Ability to create internal reports via the UI.
    Ability to show/hide and resize columns in the list report result view.

custom/Espo/Modules/Advanced/Reports/GridReport.php

@@ -11,13 +11,15 @@
  * usage to the software or any modified version or derivative work of the software
  * created by or for you.
  *
- * Copyright (C) 2015-2025 EspoCRM, Inc.
+ * Copyright (C) 2015-2026 EspoCRM, Inc.
  *
  * License ID: 19bc86a68a7bb01f458cb391d43a9212
  ************************************************************************************/
 
 namespace Espo\Modules\Advanced\Reports;
 
+use Espo\Core\Exceptions\BadRequest;
+use Espo\Core\Exceptions\Forbidden;
 use Espo\Core\Select\SearchParams;
 use Espo\Core\Select\Where\Item as WhereItem;
 use Espo\Entities\User;
@@ -25,9 +27,22 @@ use Espo\Modules\Advanced\Tools\Report\GridType\Result;
 use Espo\Modules\Advanced\Tools\Report\ListType\Result as ListResult;
 use Espo\Modules\Advanced\Tools\Report\ListType\SubReportParams;
 
+/**
+ * The Report entity instance is passed to the constructor.
+ */
 interface GridReport
 {
+    /**
+     * Use ResultPreparator to build the result object.
+     *
+     * @throws BadRequest
+     * @throws Forbidden
+     */
     public function run(?WhereItem $where, ?User $user): Result;
 
+    /**
+     * @throws BadRequest
+     * @throws Forbidden
+     */
     public function runSubReport(SearchParams $searchParams, SubReportParams $subReportParams, ?User $user): ListResult;
 }