Zabbix

<?php declare(strict_types = 0);

/*

** Copyright (C) 2001-2025 Zabbix SIA

**

** This program is free software: you can redistribute it and/or modify it under the terms of

** the GNU Affero General Public License as published by the Free Software Foundation, version 3.

**

** This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;

** without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

** See the GNU Affero General Public License for more details.

**

** You should have received a copy of the GNU Affero General Public License along with this program.

** If not, see <https://www.gnu.org/licenses/>.

**/

​

​

namespace Widgets\PieChart\Includes;

​

use API,

    CApiInputValidator;

​

use Zabbix\Widgets\CWidgetField;

​

/**

 * Class for data set widget field used in Pie chart widget configuration Data set tab.

 */

class CWidgetFieldDataSet extends CWidgetField {

​

    public const DEFAULT_VIEW = CWidgetFieldDataSetView::class;

    public const DEFAULT_VALUE = [];

​

    public const DATASET_TYPE_SINGLE_ITEM = 0;

    public const DATASET_TYPE_PATTERN_ITEM = 1;

​

    public const ITEM_TYPE_NORMAL = 0;

    public const ITEM_TYPE_TOTAL = 1;

​

    // Predefined colors for data-sets in JSON format. Each next data set takes next sequential value from palette.

    public const DEFAULT_COLOR_PALETTE = [

        'FF465C', 'FFD54F', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D',

        '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D'

    ];

​

    // First color from the default color palette.

    private const DEFAULT_COLOR = 'FF465C';

​

    public function __construct(string $name, string $label = null) {

        parent::__construct($name, $label);

​

        $this

            ->setDefault(self::DEFAULT_VALUE)

            ->setValidationRules(['type' => API_OBJECTS, 'fields' => [

                'dataset_type'          => ['type' => API_INT32, 'in' => implode(',', [self::DATASET_TYPE_SINGLE_ITEM, self::DATASET_TYPE_PATTERN_ITEM])],

                'hosts'                 => ['type' => API_STRINGS_UTF8],

                'items'                 => ['type' => API_STRINGS_UTF8],

                'itemids'               => ['type' => API_IDS],

                'references'            => ['type' => API_STRINGS_UTF8],

                'color'                 => ['type' => API_COLOR, 'flags' => API_REQUIRED | API_NOT_EMPTY],

                'aggregate_function'    => ['type' => API_INT32, 'flags' => API_REQUIRED, 'in' => implode(',', [AGGREGATE_MIN, AGGREGATE_MAX, AGGREGATE_AVG, AGGREGATE_COUNT, AGGREGATE_SUM, AGGREGATE_FIRST, AGGREGATE_LAST])],

                'dataset_aggregation'   => ['type' => API_INT32, 'flags' => API_REQUIRED, 'in' => implode(',', [AGGREGATE_NONE, AGGREGATE_MIN, AGGREGATE_MAX, AGGREGATE_AVG, AGGREGATE_COUNT, AGGREGATE_SUM])],

                'type'                  => ['type' => API_INTS32, 'flags' => null, 'in' => implode(',', [self::ITEM_TYPE_NORMAL, self::ITEM_TYPE_TOTAL])],

                'data_set_label'        => ['type' => API_STRING_UTF8, 'length' => 255]

            ]]);

    }

​

    public function setValue($value): self {

        $data_sets = [];

​

        foreach ((array) $value as $data_set) {

            $data_sets[] = $data_set + self::getDefaults();

        }

​

        return parent::setValue($data_sets);

    }

​

    public static function getDefaults(): array {

        return [

            'dataset_type' => self::DATASET_TYPE_PATTERN_ITEM,

            'hosts' => [],

            'items' => [],

            'itemids' => [],

            'color' => self::DEFAULT_COLOR,

            'aggregate_function' => AGGREGATE_LAST,

            'dataset_aggregation' => AGGREGATE_NONE,

            'type' => [],

            'data_set_label' => ''

        ];

    }

​

    public static function getItemNames(array $itemids, bool $resolve_macros): array {

        $names = [];