dashboard.php

См. документацию.

<?php
namespace Bitrix\Report\VisualConstructor\Helper;
 
use Bitrix\Main\Config\Option;
use Bitrix\Main\SystemException;
use Bitrix\Report\VisualConstructor\Entity\Dashboard as DashboardEntity;
use Bitrix\Report\VisualConstructor\Entity\Widget as WidgetEntity;
use Bitrix\Report\VisualConstructor\RuntimeProvider\DefaultBoardProvider;

class Dashboard
{
    public static function getDashboardByKeyForCurrentUser($boardKey)
    {
        global $USER;
        $userId = $USER->getId();
        $dashboardForUser = DashboardEntity::loadByBoardKeyAndUserId($boardKey, $userId);
        if (!$dashboardForUser)
        {
            self::renewDefaultDashboard($boardKey);
            $defaultDashboard = DashboardEntity::getDefaultBoardWithEverythingByBoardKey($boardKey);
 
            $dashboardForUser = $defaultDashboard->getCopyForCurrentUser();
            $dashboardForUser->setVersion('');
            $dashboardForUser->setUserId($userId);
            $dashboardForUser->save();
        }
        return $dashboardForUser;
    }

    public static function addWidgetToDashboardsWithKey($boardKey, WidgetEntity $widget)
    {
        $dashboards = DashboardEntity::loadByBoardKeyMultiple($boardKey);
        $dashboardIds = array();
        foreach ($dashboards as $dashboard)
        {
            $cellId = 'cell_' . randString(4);
            $row = Row::getRowDefaultEntity(array(
                'cellIds' => array($cellId)
            ));
            $widget->setWeight($cellId);
            $widget->setBoardId($boardKey);
            $row->addWidgets($widget->getCopyForCurrentUser());
            $dashboard->addRows($row);
            $dashboard->save();
            $dashboardIds[] = $dashboard->getId();
        }
        return $dashboardIds;
    }
 

    public static function renewDefaultDashboard($boardKey)
    {
        $board = new DefaultBoardProvider();
        $board->addFilter('boardKey', $boardKey);
        $board = $board->execute()->getFirstResult();
        if ($board)
        {
            if (!$board->getVersion())
            {
                throw new SystemException("To renew default dashboard in db state, version of dashboard should exist");
            }
 
            $boardFromDb = DashboardEntity::getDefaultBoardByBoardKey($boardKey);
 
            if ($boardFromDb && $boardFromDb->getVersion() !== $board->getVersion())
            {
                $boardFromDb->delete();
                $board->save();
            }
            elseif (!$boardFromDb)
            {
                $board->save();
            }
        }
    }
 

    public static function getBoardModeIsDemo($boardKey)
    {
        $boardModes = \CUserOptions::GetOption('report_dashboard', 'IS_DEMO_MODE_MARKERS', array());
        if (isset($boardModes[$boardKey]))
        {
             return $boardModes[$boardKey];
        }
        return self::getBoardCustomDefaultModeIsDemo($boardKey);
    }
 
    public static function setBoardModeIsDemo($boardKey, $mode)
    {
        $boardModes = \CUserOptions::GetOption('report_dashboard', 'IS_DEMO_MODE_MARKERS', array());
        $boardModes[$boardKey] = $mode;
        \CUserOptions::SetOption('report_dashboard', 'IS_DEMO_MODE_MARKERS', $boardModes);
    }
 
    public static function updateBoardCustomDefaultMode($boardKey, $demo = false)
    {
        if (self::checkBoardCustomDefaultModeIsExist($boardKey))
        {
            if (self::getBoardCustomDefaultModeIsDemo($boardKey) != $demo)
            {
                self::setBoardCustomDefaultModeIsDemo($boardKey, $demo);
            }
            
        }
        else
        {
            self::setBoardCustomDefaultModeIsDemo($boardKey, $demo);
        }
    }
 
    private static function setBoardCustomDefaultModeIsDemo($boardKey, $demo = false)
    {
        $modes = Option::get('report', 'BOARD_CUSTOM_DEFAULT_MODES', serialize(array()));
        $modes = unserialize($modes, ['allowed_classes' => false]);
        $modes[$boardKey] = $demo ? 1 : 0;
        Option::set('report', 'BOARD_CUSTOM_DEFAULT_MODES', serialize($modes));
    }
 
    private static function checkBoardCustomDefaultModeIsExist($boardKey)
    {
        $modes = Option::get('report', 'BOARD_CUSTOM_DEFAULT_MODES', serialize(array()));
        $modes = unserialize($modes, ['allowed_classes' => false]);
        return isset($modes[$boardKey]);
    }
 
    private static function getBoardCustomDefaultModeIsDemo($boardKey)
    {
        $modes = Option::get('report', 'BOARD_CUSTOM_DEFAULT_MODES', serialize(array()));
        $modes = unserialize($modes, ['allowed_classes' => false]);
        return !empty($modes[$boardKey]);
    }
 
}