f47e89a9bd
Aggregation of report columns allows the report editor to perform common types of data aggregation (concatenation, sum, count, etc) on given columns.
78 lines
2.2 KiB
PHP
78 lines
2.2 KiB
PHP
<?php
|
|
// This file is part of Moodle - http://moodle.org/
|
|
//
|
|
// Moodle is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// Moodle 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 General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace core_reportbuilder\local\aggregation;
|
|
|
|
use lang_string;
|
|
use core_reportbuilder\local\report\column;
|
|
|
|
/**
|
|
* Base class for column aggregation types
|
|
*
|
|
* @package core_reportbuilder
|
|
* @copyright 2021 Paul Holden <paulh@moodle.com>
|
|
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
|
|
*/
|
|
abstract class base {
|
|
|
|
/**
|
|
* Return the class name of the aggregation type
|
|
*
|
|
* @return string
|
|
*/
|
|
final public static function get_class_name(): string {
|
|
$namespacedclass = explode('\\', get_called_class());
|
|
|
|
return end($namespacedclass);
|
|
}
|
|
|
|
/**
|
|
* Return the display name of the aggregation
|
|
*
|
|
* @return lang_string
|
|
*/
|
|
abstract public static function get_name(): lang_string;
|
|
|
|
/**
|
|
* Whether the aggregation is compatible with the given column type
|
|
*
|
|
* @param int $columntype The type as defined by the {@see column::set_type} method
|
|
* @return bool
|
|
*/
|
|
abstract public static function compatible(int $columntype): bool;
|
|
|
|
/**
|
|
* Return the aggregated field SQL
|
|
*
|
|
* @param string $field
|
|
* @param int $columntype
|
|
* @return string
|
|
*/
|
|
abstract public static function get_field_sql(string $field, int $columntype): string;
|
|
|
|
/**
|
|
* Return formatted value for column when applying aggregation
|
|
*
|
|
* @param mixed $value
|
|
* @param array $values
|
|
* @param array $callbacks
|
|
* @return mixed
|
|
*/
|
|
abstract public static function format_value($value, array $values, array $callbacks);
|
|
}
|