[Grid] [Filter] Add filter for system.id (#535)

* Add Filter for id

* Apply php-cs-fixer changes

* Fix Test

* Fix Test

* use is_int().

* Apply php-cs-fixer changes

---------

Co-authored-by: martineiber <[email protected]>

Author: martineiber

config/data_index_filters.yaml

@@ -41,6 +41,9 @@ services:
   Pimcore\Bundle\StudioBackendBundle\DataIndex\Filter\UserFilter:
     tags: [ 'pimcore.studio_backend.open_search.filter' ]
 
+  Pimcore\Bundle\StudioBackendBundle\DataIndex\Filter\IdFilter:
+    tags: [ 'pimcore.studio_backend.open_search.filter' ]
+
   # DataObject
   Pimcore\Bundle\StudioBackendBundle\DataIndex\Filter\DataObject\ClassNameFilter:
       tags: [ 'pimcore.studio_backend.open_search.data_object.filter' ]

config/grid.yaml

@@ -75,6 +75,9 @@ services:
   Pimcore\Bundle\StudioBackendBundle\Grid\Column\Definition\System\IntegerDefinition:
     tags: [ 'pimcore.studio_backend.grid_column_definition' ]
 
+  Pimcore\Bundle\StudioBackendBundle\Grid\Column\Definition\System\IdDefinition:
+    tags: [ 'pimcore.studio_backend.grid_column_definition' ]
+
   Pimcore\Bundle\StudioBackendBundle\Grid\Column\Definition\System\StringDefinition:
     tags: [ 'pimcore.studio_backend.grid_column_definition' ]
 

doc/03_Grid.md

@@ -43,6 +43,7 @@ Available filters are:
 |  system.datetime  |       integer       |    `from`, `to`, or `on`    |      true      |
 |    system.tag     |       object        | `considerChildTags`, `tags` |     false      |
 |    system.pql     |       string        |          PQL Query          |     false      |
+|     system.id     |       integer       |                             |     false      |
 
 
 

src/DataIndex/Filter/IdFilter.php

@@ -0,0 +1,50 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\DataIndex\Filter;
+
+use Pimcore\Bundle\StudioBackendBundle\DataIndex\Query\QueryInterface;
+use Pimcore\Bundle\StudioBackendBundle\Exception\Api\InvalidArgumentException;
+use Pimcore\Bundle\StudioBackendBundle\Grid\Column\ColumnType;
+use Pimcore\Bundle\StudioBackendBundle\MappedParameter\Filter\SimpleColumnFiltersParameterInterface;
+use function is_int;
+
+/**
+ * @internal
+ */
+final class IdFilter implements FilterInterface
+{
+    public function apply(mixed $parameters, QueryInterface $query): QueryInterface
+    {
+        if (!$parameters instanceof SimpleColumnFiltersParameterInterface) {
+            return $query;
+        }
+
+        $filter = $parameters->getSimpleColumnFilterByType(ColumnType::SYSTEM_ID->value);
+
+        if (!$filter) {
+            return $query;
+        }
+
+        if (!is_int($filter->getFilterValue())) {
+            throw new InvalidArgumentException('Filter value for this filter must be a integer');
+        }
+
+        $query->searchByIds([$filter->getFilterValue()]);
+
+        return $query;
+    }
+}

src/Grid/Column/ColumnType.php

@@ -24,6 +24,7 @@ enum ColumnType: string
     case SYSTEM_STRING = 'system.string';
     case SYSTEM_FILE_SIZE = 'system.fileSize';
     case SYSTEM_INTEGER = 'system.integer';
+    case SYSTEM_ID = 'system.id';
     case SYSTEM_DATETIME = 'system.datetime';
     case SYSTEM_TAG = 'system.tag';
     case SYSTEM_PQL_QUERY = 'system.pql';

src/Grid/Column/Definition/System/IdDefinition.php

@@ -0,0 +1,52 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Grid\Column\Definition\System;
+
+use Pimcore\Bundle\StudioBackendBundle\Grid\Column\ColumnDefinitionInterface;
+use Pimcore\Bundle\StudioBackendBundle\Grid\Column\ColumnType;
+use Pimcore\Bundle\StudioBackendBundle\Grid\Column\FrontendType;
+
+/**
+ * @internal
+ */
+final readonly class IdDefinition implements ColumnDefinitionInterface
+{
+    public function getType(): string
+    {
+        return ColumnType::SYSTEM_ID->value;
+    }
+
+    public function getConfig(mixed $config): array
+    {
+        return  [];
+    }
+
+    public function isSortable(): bool
+    {
+        return true;
+    }
+
+    public function getFrontendType(): string
+    {
+        return FrontendType::INPUT->value;
+    }
+
+    public function isExportable(): bool
+    {
+        return true;
+    }
+}

src/Grid/Mapper/ColumnMapper.php

@@ -27,7 +27,7 @@
 {
     private const COLUMN_MAPPING = [
         'preview' => 'image',
-        'id' => 'integer',
+        'id' => 'id',
         'type' => 'string',
         'fullpath' => 'string',
         'filename' => 'string',

tests/Unit/Grid/Mapper/ColumnMapperTest.php

@@ -43,7 +43,7 @@ public function testMapperForPreview(): void
     public function testMapperForId(): void
     {
         $mapper = new ColumnMapper();
-        $this->assertSame('integer', $mapper->getType('id'));
+        $this->assertSame('id', $mapper->getType('id'));
     }
 
     public function testMapperForType(): void

tests/Unit/Grid/Service/SystemColumnServiceTest.php

@@ -32,7 +32,7 @@ public function testGetSystemColumnsForAssets(): void
 
         $this->assertSame([
             'preview' => 'image',
-            'id' => 'integer',
+            'id' => 'id',
             'type' => 'string',
             'fullpath' => 'string',
             'filename' => 'string',
@@ -48,7 +48,7 @@ public function testGetSystemColumnsForDataObjects(): void
         $systemColumnService = new SystemColumnService($mapper);
 
         $this->assertSame([
-            'id' => 'integer',
+            'id' => 'id',
             'fullpath' => 'string',
             'key' => 'string',
             'published' => 'boolean',