Навигация по записям

1. Введение

Если Форма списка, субпанель или всплывающее окно содержит большое количество записей, то система отобразит лишь часть из них. Отображение оставшихся записей возможно следующими способами:

  1. Постранично, при помощи панели навигации, отображаемой в правой части списка записей. Этот способ используется по умолчанию.

    Панель навигации

  2. Постепенно, при помощи кнопки подгрузки записей. В этом случае пользователь может постепенно подгружать записи, не используя панель навигации.

Подгрузка записей доступна в версии 8.3 и выше.

Подгрузка данных

Подгруженные записи не отобразятся при обновлении страницы: система отобразит стандартное количество записей, указанное в настройках конфигурации панели Администратора.

2. Настройка навигации по записям

2.1. Настройка способа навигации

Способ навигации можно изменить отдельно для Форм списка, субпанелей и всплывающих окон. Настройку можно выполнить как для всей системы (Администрирование  Настройка конфигурации), так и в профиле конкретного пользователя (Мои настройки  Параметры макета).
Настройки пользователя приоритетнее системных.

Настройка способа навигации

По умолчанию все записи выводятся постранично.

2.2. Настройка количества отображаемых и подгружаемых записей

Количество отображаемых и подгружаемых записей настраивается для системы в целом (Администрирование  Настройка конфигурации) через установку следующих параметров:

  • Количество отображаемых записей в Формах списка

  • Количество отображаемых записей в субпанелях

  • Количество отображаемых записей во всплывающих окнах

Максимальное количество одновременно отображаемых записей

2.3. Настройка максимальной высоты форм и субпанелей

При необходимости можно настроить максимальную высоту субпанелей, Форм списка и всплывающих окон.

Изменение максимальной высоты субпанели

Добавьте параметр maxHeight в файл public/legacy/custom/modules/<Module>/metadata/subpaneldefs.php где: <Module> - название обновляемого модуля.

В следующем примере параметр maxHeight был изменен в файле public/legacy/custom/modules/Accounts/metadata/subpaneldefs.php:

        'contacts' => array(
            'order' => 30,
            'module' => 'Contacts',
            'sort_order' => 'asc',
            'maxHeight' => 1000,
            'sort_by' => 'last_name, first_name',
            'subpanel_name' => 'ForAccounts',
            'get_subpanel_data' => 'contacts',
            'add_subpanel_data' => 'contact_id',
            'title_key' => 'LBL_CONTACTS_SUBPANEL_TITLE',
            'top_buttons' => array(
                array('widget_class' => 'SubPanelTopCreateAccountNameButton'),
                array('widget_class' => 'SubPanelTopSelectButton', 'mode' => 'MultiSelect')
            ),
        ),

Изменение максимальной высоты Форм списка и всплывающих окон

Добавьте параметр maxHeight в файл public/legacy/custom/modules/<Module>/listviewdefs.php, где: <Module> - название обновляемого модуля.

В следующем примере меняется максимальная высота Формы списка модуля Контрагенты:

'ListView' =>  [
        'maxHeight' => 3000,
        'sidebarWidgets' => [
            'accounts-new-by-month' => [
                'type' => 'chart',
                'labelKey' => 'LBL_QUICK_CHARTS',
                'options' => [
                    'toggle' => true,
                    'headerTitle' => false,
                    'charts' => [
                        [
                            'chartKey' => 'accounts-new-by-month',
                            'chartType' => 'line-chart',
                            'statisticsType' => 'accounts-new-by-month',
                            'labelKey' => 'ACCOUNT_TYPES_PER_MONTH',
                            'chartOptions' => [
                            ]
                        ] ...

По умолчанию установлены следующие значения:

  • Субпанели и всплывающие окна — 10 записей

  • Формы списка — значение по умолчанию не установлено

2.4. Настройка параметров навигации напрямую в файле конфигурации

Вы можете прописать любой из вышеуказанных параметров напрямую в файле config_override.php:

Пример настройки способа навигации:

$sugar_config['listview_pagination_type'] = 'pagination'; // для Форм списка
$sugar_config['record_modal_pagination_type'] = 'pagination'; // для всплывающих окон
$sugar_config['subpanel_pagination_type'] = 'load-more'; // для субпанелей

Настройки способа навигации, прописанные в файле config_override.php имеют меньший приоритет перед теми же параметрами, настроенными в профиле пользователя.

Пример настройки количества отображаемых / подгружаемых записей:

$sugar_config['list_max_entries_per_page'] = '20'; // для Форм списка
$sugar_config['list_max_entries_per_modal'] = '8'; // для всплывающих окон
$sugar_config['list_max_entries_per_subpanel'] = '15'; // для субпанелей

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.