<?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_user\reportbuilder\datasource;
use core_collator;
use core_reportbuilder_testcase;
use core_reportbuilder_generator;
use core_reportbuilder\local\filters\boolean_select;
use core_reportbuilder\local\filters\date;
use core_reportbuilder\local\filters\select;
> use core_reportbuilder\local\filters\tags;
use core_reportbuilder\local\filters\text;
< use core_reportbuilder\local\helpers\user_filter_manager;
> use core_reportbuilder\local\filters\user as user_filter;
defined('MOODLE_INTERNAL') || die();
global $CFG;
require_once("{$CFG->dirroot}/reportbuilder/tests/helpers.php");
/**
* Unit tests for users datasource
*
* @package core_user
* @covers \core_user\reportbuilder\datasource\users
* @copyright 2022 Paul Holden <paulh@moodle.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class users_test extends core_reportbuilder_testcase {
<
/**
* Test default datasource
*/
public function test_datasource_default(): void {
$this->resetAfterTest();
$user2 = $this->getDataGenerator()->create_user(['firstname' => 'Charles']);
$user3 = $this->getDataGenerator()->create_user(['firstname' => 'Brian']);
/** @var core_reportbuilder_generator $generator */
$generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder');
$report = $generator->create_report(['name' => 'Users', 'source' => users::class, 'default' => 1]);
$content = $this->get_custom_report_content($report->get('id'));
$this->assertCount(3, $content);
// Default columns are fullname, username, email. Results are sorted by the fullname.
[$adminrow, $userrow1, $userrow2] = array_map('array_values', $content);
$this->assertEquals(['Admin User', 'admin', 'admin@example.com'], $adminrow);
$this->assertEquals([fullname($user3), $user3->username, $user3->email], $userrow1);
$this->assertEquals([fullname($user2), $user2->username, $user2->email], $userrow2);
}
/**
* Test datasource columns that aren't added by default
*/
public function test_datasource_non_default_columns(): void {
$this->resetAfterTest();
$user = $this->getDataGenerator()->create_user([
'firstname' => 'Zoe',
'idnumber' => 'U0001',
'city' => 'London',
'country' => 'GB',
> 'interests' => ['Horses'],
]);
/** @var core_reportbuilder_generator $generator */
$generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder');
$report = $generator->create_report(['name' => 'Users', 'source' => users::class, 'default' => 0]);
// User.
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:fullnamewithlink']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:fullnamewithpicture']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:fullnamewithpicturelink']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:picture']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:firstname']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:lastname']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:city']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:country']);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:description']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:firstnamephonetic']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:lastnamephonetic']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:middlename']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:alternatename']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:idnumber']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:institution']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:department']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:phone1']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:phone2']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:address']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:lastaccess']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:suspended']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:confirmed']);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:moodlenetprofile']);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:timecreated']);
>
$content = $this->get_custom_report_content($report->get('id'));
> // Tags.
$this->assertCount(2, $content);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'tag:name']);
> $generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'tag:namewithlink']);
// Consistent order by firstname, just in case.
core_collator::asort_array_of_arrays_by_key($content, 'c4_firstname');
$content = array_values($content);
[$adminrow, $userrow] = array_map('array_values', $content);
$this->assertStringContainsString('Admin User', $adminrow[0]);
$this->assertStringContainsString('Admin User', $adminrow[1]);
$this->assertStringContainsString('Admin User', $adminrow[2]);
$this->assertNotEmpty($adminrow[3]);
$this->assertEquals('Admin', $adminrow[4]);
$this->assertEquals('User', $adminrow[5]);
$this->assertStringContainsString(fullname($user), $userrow[0]);
$this->assertStringContainsString(fullname($user), $userrow[1]);
$this->assertStringContainsString(fullname($user), $userrow[2]);
$this->assertNotEmpty($userrow[3]);
$this->assertEquals($user->firstname, $userrow[4]);
$this->assertEquals($user->lastname, $userrow[5]);
$this->assertEquals($user->city, $userrow[6]);
$this->assertEquals('United Kingdom', $userrow[7]);
< $this->assertEquals($user->firstnamephonetic, $userrow[8]);
< $this->assertEquals($user->lastnamephonetic, $userrow[9]);
< $this->assertEquals($user->middlename, $userrow[10]);
< $this->assertEquals($user->alternatename, $userrow[11]);
< $this->assertEquals($user->idnumber, $userrow[12]);
< $this->assertEquals($user->institution, $userrow[13]);
< $this->assertEquals($user->department, $userrow[14]);
< $this->assertEquals($user->phone1, $userrow[15]);
< $this->assertEquals($user->phone2, $userrow[16]);
< $this->assertEquals($user->address, $userrow[17]);
< $this->assertEmpty($userrow[18]);
< $this->assertEquals('No', $userrow[19]);
< $this->assertEquals('Yes', $userrow[20]);
< $this->assertEquals($user->moodlenetprofile, $userrow[21]);
> $this->assertEquals($user->description, $userrow[8]);
> $this->assertEquals($user->firstnamephonetic, $userrow[9]);
> $this->assertEquals($user->lastnamephonetic, $userrow[10]);
> $this->assertEquals($user->middlename, $userrow[11]);
> $this->assertEquals($user->alternatename, $userrow[12]);
> $this->assertEquals($user->idnumber, $userrow[13]);
> $this->assertEquals($user->institution, $userrow[14]);
> $this->assertEquals($user->department, $userrow[15]);
> $this->assertEquals($user->phone1, $userrow[16]);
> $this->assertEquals($user->phone2, $userrow[17]);
> $this->assertEquals($user->address, $userrow[18]);
> $this->assertEmpty($userrow[19]);
> $this->assertEquals('No', $userrow[20]);
> $this->assertEquals('Yes', $userrow[21]);
> $this->assertEquals($user->moodlenetprofile, $userrow[22]);
> $this->assertNotEmpty($userrow[23]);
> $this->assertEquals('Horses', $userrow[24]);
> $this->assertStringContainsString('Horses', $userrow[25]);
}
/**
* Data provider for {@see test_datasource_filters}
*
* @return array[]
*/
public function datasource_filters_provider(): array {
return [
// User.
> 'Filter user' => ['user:userselect', [
'Filter fullname' => ['user:fullname', [
> 'user:userselect_operator' => user_filter::USER_SELECT,
'user:fullname_operator' => text::CONTAINS,
> 'user:userselect_value' => [-1],
'user:fullname_value' => 'Zoe',
> ], false],
], true],
'Filter fullname (no match)' => ['user:fullname', [
'user:fullname_operator' => text::CONTAINS,
'user:fullname_value' => 'Alfie',
], false],
'Filter firstname' => ['user:firstname', [
'user:firstname_operator' => text::IS_EQUAL_TO,
'user:firstname_value' => 'Zoe',
], true],
'Filter firstname (no match)' => ['user:firstname', [
'user:firstname_operator' => text::IS_EQUAL_TO,
'user:firstname_value' => 'Alfie',
], false],
'Filter middlename' => ['user:middlename', [
'user:middlename_operator' => text::IS_EQUAL_TO,
'user:middlename_value' => 'Zebediah',
], true],
'Filter middlename (no match)' => ['user:middlename', [
'user:middlename_operator' => text::IS_EQUAL_TO,
'user:middlename_value' => 'Aardvark',
], false],
'Filter lastname' => ['user:lastname', [
'user:lastname_operator' => text::IS_EQUAL_TO,
'user:lastname_value' => 'Zebra',
], true],
'Filter lastname (no match)' => ['user:lastname', [
'user:lastname_operator' => text::IS_EQUAL_TO,
'user:lastname_value' => 'Aardvark',
], false],
'Filter firstnamephonetic' => ['user:firstnamephonetic', [
'user:firstnamephonetic_operator' => text::IS_EQUAL_TO,
'user:firstnamephonetic_value' => 'Eoz',
], true],
'Filter firstnamephonetic (no match)' => ['user:firstnamephonetic', [
'user:firstnamephonetic_operator' => text::IS_EQUAL_TO,
'user:firstnamephonetic_value' => 'Alfie',
], false],
'Filter lastnamephonetic' => ['user:lastnamephonetic', [
'user:lastnamephonetic_operator' => text::IS_EQUAL_TO,
'user:lastnamephonetic_value' => 'Arbez',
], true],
'Filter lastnamephonetic (no match)' => ['user:lastnamephonetic', [
'user:lastnamephonetic_operator' => text::IS_EQUAL_TO,
'user:lastnamephonetic_value' => 'Aardvark',
], false],
'Filter alternatename' => ['user:alternatename', [
'user:alternatename_operator' => text::IS_EQUAL_TO,
'user:alternatename_value' => 'Zee',
], true],
'Filter alternatename (no match)' => ['user:alternatename', [
'user:alternatename_operator' => text::IS_EQUAL_TO,
'user:alternatename_value' => 'Aardvark',
], false],
'Filter email' => ['user:email', [
'user:email_operator' => text::CONTAINS,
'user:email_value' => 'zoe1',
], true],
'Filter email (no match)' => ['user:email', [
'user:email_operator' => text::CONTAINS,
'user:email_value' => 'alfie1',
], false],
'Filter phone1' => ['user:phone1', [
'user:phone1_operator' => text::IS_EQUAL_TO,
'user:phone1_value' => '111',
], true],
'Filter phone1 (no match)' => ['user:phone1', [
'user:phone1_operator' => text::IS_EQUAL_TO,
'user:phone1_value' => '119',
], false],
'Filter phone2' => ['user:phone2', [
'user:phone2_operator' => text::IS_EQUAL_TO,
'user:phone2_value' => '222',
], true],
'Filter phone2 (no match)' => ['user:phone2', [
'user:phone2_operator' => text::IS_EQUAL_TO,
'user:phone2_value' => '229',
], false],
'Filter address' => ['user:address', [
'user:address_operator' => text::IS_EQUAL_TO,
'user:address_value' => 'Big Farm',
], true],
'Filter address (no match)' => ['user:address', [
'user:address_operator' => text::IS_EQUAL_TO,
'user:address_value' => 'Small Farm',
], false],
'Filter city' => ['user:city', [
'user:city_operator' => text::IS_EQUAL_TO,
'user:city_value' => 'Barcelona',
], true],
'Filter city (no match)' => ['user:city', [
'user:city_operator' => text::IS_EQUAL_TO,
'user:city_value' => 'Perth',
], false],
'Filter country' => ['user:country', [
'user:country_operator' => select::EQUAL_TO,
'user:country_value' => 'ES',
], true],
'Filter country (no match)' => ['user:country', [
'user:country_operator' => select::EQUAL_TO,
'user:country_value' => 'AU',
], false],
> 'Filter description' => ['user:description', [
'Filter username' => ['user:username', [
> 'user:description_operator' => text::CONTAINS,
'user:username_operator' => text::IS_EQUAL_TO,
> 'user:description_value' => 'Hello there',
'user:username_value' => 'zoe1',
> ], true],
], true],
> 'Filter description (no match)' => ['user:description', [
'Filter username (no match)' => ['user:username', [
> 'user:description_operator' => text::CONTAINS,
'user:username_operator' => text::IS_EQUAL_TO,
> 'user:description_value' => 'Goodbye',
'user:username_value' => 'alfie1',
> ], false],
], false],
> 'Filter auth' => ['user:auth', [
'Filter idnumber' => ['user:idnumber', [
> 'user:auth_operator' => select::EQUAL_TO,
'user:idnumber_operator' => text::IS_EQUAL_TO,
> 'user:auth_value' => 'manual',
'user:idnumber_value' => 'Z0001',
> ], true],
], true],
> 'Filter auth (no match)' => ['user:auth', [
'Filter idnumber (no match)' => ['user:idnumber', [
> 'user:auth_operator' => select::EQUAL_TO,
'user:idnumber_operator' => text::IS_EQUAL_TO,
> 'user:auth_value' => 'ldap',
'user:idnumber_value' => 'A0001',
> ], false],
], false],
'Filter institution' => ['user:institution', [
'user:institution_operator' => text::IS_EQUAL_TO,
'user:institution_value' => 'Farm',
], true],
'Filter institution (no match)' => ['user:institution', [
'user:institution_operator' => text::IS_EQUAL_TO,
'user:institution_value' => 'University',
], false],
'Filter department' => ['user:department', [
'user:department_operator' => text::IS_EQUAL_TO,
'user:department_value' => 'Stable',
], true],
'Filter department (no match)' => ['user:department', [
'user:department_operator' => text::IS_EQUAL_TO,
'user:department_value' => 'Office',
], false],
'Filter moodlenetprofile' => ['user:moodlenetprofile', [
'user:moodlenetprofile_operator' => text::IS_EQUAL_TO,
'user:moodlenetprofile_value' => '@zoe1@example.com',
], true],
'Filter moodlenetprofile (no match)' => ['user:moodlenetprofile', [
'user:moodlenetprofile_operator' => text::IS_EQUAL_TO,
'user:moodlenetprofile_value' => '@alfie1@example.com',
], false],
'Filter suspended' => ['user:suspended', [
'user:suspended_operator' => boolean_select::NOT_CHECKED,
], true],
'Filter suspended (no match)' => ['user:suspended', [
'user:suspended_operator' => boolean_select::CHECKED,
], false],
'Filter confirmed' => ['user:confirmed', [
'user:confirmed_operator' => boolean_select::CHECKED,
], true],
'Filter confirmed (no match)' => ['user:confirmed', [
'user:confirmed_operator' => boolean_select::NOT_CHECKED,
], false],
> 'Filter timecreated' => ['user:timecreated', [
'Filter lastaccess' => ['user:lastaccess', [
> 'user:timecreated_operator' => date::DATE_RANGE,
'user:lastaccess_operator' => date::DATE_EMPTY,
> 'user:timecreated_from' => 1622502000,
], true],
> ], true],
'Filter lastaccess (no match)' => ['user:lastaccess', [
> 'Filter timecreated (no match)' => ['user:timecreated', [
'user:lastaccess_operator' => date::DATE_RANGE,
> 'user:timecreated_operator' => date::DATE_RANGE,
'user:lastaccess_from' => 1619823600,
> 'user:timecreated_from' => 1619823600,
'user:lastaccess_to' => 1622502000,
> 'user:timecreated_to' => 1622502000,
], false],
> ], false],
];
>
}
> // Tags.
> 'Filter tag name' => ['tag:name', [
/**
> 'tag:name_operator' => tags::EQUAL_TO,
* Test datasource filters
> 'tag:name_value' => [-1],
*
> ], false],
* @param string $filtername
> 'Filter tag name not empty' => ['tag:name', [
* @param array $filtervalues
> 'tag:name_operator' => tags::NOT_EMPTY,
* @param bool $expectmatch
> ], true],
*
* @dataProvider datasource_filters_provider
*/
public function test_datasource_filters(string $filtername, array $filtervalues, bool $expectmatch): void {
$this->resetAfterTest();
$user = $this->getDataGenerator()->create_user([
'username' => 'zoe1',
'email' => 'zoe1@example.com',
'firstname' => 'Zoe',
'middlename' => 'Zebediah',
'lastname' => 'Zebra',
'firstnamephonetic' => 'Eoz',
'lastnamephonetic' => 'Arbez',
'alternatename' => 'Zee',
'idnumber' => 'Z0001',
'institution' => 'Farm',
'department' => 'Stable',
'phone1' => '111',
'phone2' => '222',
'address' => 'Big Farm',
'city' => 'Barcelona',
'country' => 'ES',
'description' => 'Hello there',
'moodlenetprofile' => '@zoe1@example.com',
> 'interests' => ['Horses'],
]);
/** @var core_reportbuilder_generator $generator */
$generator = $this->getDataGenerator()->get_plugin_generator('core_reportbuilder');
// Create report containing single column, and given filter.
$report = $generator->create_report(['name' => 'Tasks', 'source' => users::class, 'default' => 0]);
$generator->create_column(['reportid' => $report->get('id'), 'uniqueidentifier' => 'user:username']);
// Add filter, set it's values.
$generator->create_filter(['reportid' => $report->get('id'), 'uniqueidentifier' => $filtername]);
< user_filter_manager::set($report->get('id'), $filtervalues);
<
< $content = $this->get_custom_report_content($report->get('id'));
> $content = $this->get_custom_report_content($report->get('id'), 0, $filtervalues);
if ($expectmatch) {
$this->assertNotEmpty($content);
// Merge report usernames into easily traversable array.
$usernames = array_merge(...array_map('array_values', $content));
$this->assertContains($user->username, $usernames);
} else {
$this->assertEmpty($content);
}
}
/**
* Stress test datasource
*
* In order to execute this test PHPUNIT_LONGTEST should be defined as true in phpunit.xml or directly in config.php
*/
public function test_stress_datasource(): void {
if (!PHPUNIT_LONGTEST) {
$this->markTestSkipped('PHPUNIT_LONGTEST is not defined');
}
$this->resetAfterTest();
< $this->getDataGenerator()->create_custom_profile_field(['datatype' => 'text', 'name' => 'Hi', 'shortname' => 'hi']);
< $user = $this->getDataGenerator()->create_user(['profile_field_hi' => 'Hello']);
> $user = $this->getDataGenerator()->create_user();
$this->datasource_stress_test_columns(users::class);
$this->datasource_stress_test_columns_aggregation(users::class);
$this->datasource_stress_test_conditions(users::class, 'user:username');
}
}