Инструмент «Целостность данных 3KL»

Полина Андреева
11.09.2025
Инструмент «Целостность данных СЭО 3КL» (tool_dbcheckup3kl) позволяет определить, есть ли нарушения в целостности данных различных компонентов системы: модулей курса, оценок, файлов и связей между модулями курса и секциями.. . . . . .
Функционал, описанный в данной статье, в полном объеме доступен в СЭО 3КL, начиная с версий 4.1.19b и 4.5.5b.
Если вы используете более раннюю версию системы — обратитесь с заявкой на проведение обновления в службу технической поддержки ООО «Открытые технологии».
Действия в данной инструкции с пометкой требуются права администратора могут быть выполнены только при наличии доступа «Полный Администратор». Начиная с 2022 года для вновь заключаемых договоров такой набор прав предоставляется роли «Диспетчер-администратор» по умолчанию. Если ваш договор был заключен раньше, вы можете обратиться в техподдержку с соответствующей заявкой на расширение набора прав диспетчера-администратора.
Важно! Неосторожные действия полного администратора могут повредить систему и контент таким образом, что исправление последствий вмешательства выйдет за рамки гарантийной технической поддержки. В случае внесения правок в глобальные настройки рекомендуем вам убедиться в том, что вы полностью понимаете, за что отвечают данные настройки. Если у вас возникают сомнения в назначении глобальных настроек, обратитесь за помощью в техническую поддержку.
Подробная информация в статье «Полный административный доступ».
Информация, приведенная в статье, является ознакомительной. При неосторожном использовании функционала плагина он может повредить ваши данные. Рекомендуем перед использованием инструмента убедиться, что у вас есть свежая резервная копия системы, и проконсультироваться с технической поддержкой.

1. Общая информация

В общем смысле целостность данных – это состояние, при котором данные, содержащиеся в системе, остаются в правильном и ожидаемом состоянии, сохраняют логические связи между собой и являются непротиворечивыми и согласованными.
Целостность данных в контексте Moodle означает, что записи в таблицах базы данных системы соответствуют реальному состоянию объектов в системе. При этом нарушение целостности будет заключаться в том, что в таблице базы данных запись о хранящемся в системе файле есть, а сам файл физически уже отсутствует на сервере, либо связь между объектами системы некорректная.
Инструмент «Целостность данных 3KL» предназначен для анализа целостности данных в СЭО 3KL. Компоненты плагина позволяют:

  • проверить нарушения целостности в базе данных с записями о модулях курса, которые могли появиться при удалении экземпляра модуля из СЭО 3KL;
  • выявить несогласованность в таблицах базы данных с оценками и восстановить целостность;
  • найти расхождения, когда запись о файле есть в базе данных, но файл физически отсутствует на сервере;
  • выявить несогласованность между записями о модулях курса и секциями и восстановить целостность.

-Вернуться к содержанию-

2. Возможности

2.1. Ситуации, в которых полезно применение плагина

Инструмент «Целостность данных 3KL» может быть полезен либо в случае, когда по какой-либо причине существуют сомнения в целостности данных компонентов системы, либо в случае, если в системе возникают ошибки, связанные с целостностью данных, и их необходимо устранить.

Таким образом можно выделить два типа ситуаций, когда полезен плагин:

1. Система была обновлена с версии, правильность администрирования которой подвергается сомнениям. Например, у системы не было компетентного администратора или система пережила нештатные ситуации: аварийное отключение сервера, проблемы с жесткими дисками, нестабильную работу из-за нехватки оперативной памяти, установку нестабильных сторонних плагинов, прямое вмешательство в базу данных и т. п.

2. Если система демонстрирует одну или несколько из следующих ошибок:

-Вернуться к содержанию-

2.2. Проверка и восстановление целостности оценок и связи между модулями курса и секциями

Администратору СЭО 3KL нужно проверить, есть ли несоответствия в таблицах базы данных с оценками и расхождения связи между секциями и модулями курса. Для этого администратор переходит на страницу «Проверка целостности данных СЭО 3KL», расположенную по следующему пути: Администрирование -> Плагины -> Инструменты администрирования -> Целостность данных 3KL -> Проверка целостности данных СЭО 3KL (Рис. 2.1.1). На этой странице администратор запускает процесс проверки показателей, последовательно нажав на кнопки «Обновить данные» в строках с показателями «Целостность оценок» и «Целостность связи между модулями курса и секциями» (поз. 1, 2 Рис. 2.2.1).

Рис. 2.2.1. Страница «Проверка целостности данных СЭО 3KL».

После того, как процесс обновления показателей будет завершен, на странице «Проверка целостности данных СЭО 3KL» отобразятся обновленные статусы показателей и полученные результаты проверки (Рис. 2.2.2). В примере на Рис. 2.2.2. администратор может увидеть, что при проверке показателя «Целостность оценок» не было выявлено несоответствий, а при проверке показателя «Целостность связи между модулями курса и секциями» было выявлено 1 расхождение. Далее администратор должен устранить это расхождение.

Рис. 2.2.2. Страница «Проверка целостности данных СЭО 3KL» с одним из показателей в статусе «Предупреждение».

Нажав на кнопку «Восстановить целостность» (см. поз. 1 Рис. 2.2.2) для показателя «Целостность связи между модулями курса и секциями», администратор запускает процесс восстановления корректной связи между секциями и элементами курса. После завершения этого процесса расхождения между секциями и модулями курса будут устранены и статус показателя изменится на «ОК» (поз. 1 Рис. 2.2.3).

Рис. 2.2.3. Страница «Проверка целостности данных СЭО 3KL», на которой все показатели находятся в статусе «ОК».

-Вернуться к содержанию-

2.3. Проверка и восстановление целостности модулей курса и файлов

Администратору СЭО 3KL нужно проверить, наблюдаются ли расхождения в показателях «Целостность модулей курса» и «Целостность файлов». Т. к. проверка этих показателей выполняется в рамках отдельной задачи Cron, администратору необходимо перейти по пути: Администрирование -> Сервер -> Задачи -> Запланированные задачи. На открывшейся странице следует запустить задачу «Выполнить расчет данных показателей», нажав на кнопку «Запустить сейчас» (поз. 1 Рис. 2.3.1).

Рис. 2.3.1. Запланированная задача «Выполнить расчет данных для показателей».

После этого будут пересчитаны показатели «Целостность модулей курса» и «Целостность файлов», результаты проверки будут отражены на странице по пути: Администрирование -> Плагины -> Инструменты администрирования -> Целостность данных 3KL -> Проверка целостности данных СЭО 3KL (поз. 1, 2 Рис. 2.3.2). В рассмотренном примере проверка не обнаружила несоответствий в проверенных показателях.

Рис. 2.3.2. Страница «Проверка целостности данных СЭО 3KL» с проверенными показателями «Целостность модулей курса» и «Целостность файлов».
Если в ходе проверки показателей «Целостность модулей курса» и «Целостность файлов» будут обнаружены нарушения целостности, которые не получится устранить вручную, вы можете обратиться в наше техническую поддержку. Сотрудники техподдержки удалят из таблиц базы данных записи об отсутствующих модулях курса и файлах и целостность данных будет восстановлена.

-Вернуться к содержанию-

3. Страница «Проверка целостности данных СЭО 3KL»

Страница «Проверка целостности данных СЭО 3KL» (Рис. 3.1) содержит таблицу с описанием показателей проверки целостности данных и с подробностями о дате и результатах проверки.

В таблице можно увидеть статус, который был установлен показателю в результате его последней проверки, дата проверки также регистрируется в таблице. В столбце «Описание» приведено описание показателя, для которого выполняется расчет. В столбце «Результаты последней проверки» отображается результат проверки целостности показателя. Если проверка уже была выполнена, в данном столбце отобразится текстовая ссылка либо на страницу со сводкой о выполненной проверке, либо на файл с результатами проверки (об этом функционале читайте ниже). В столбце «Способ расчета данных показателя» для показателей, вычисляемых в рамках задачи Cron, отображается надпись «По расписанию» и текстовая ссылка на страницу настройки периодичности выполнения задачи Cron; для показателей, которые вычисляются вручную, отображается надпись «Вручную» и текстовая ссылка, после нажатия на которую показатель будет обновлен. Обратите внимание, изменить способ предустановленный расчета показателя (вручную или в рамках задачи Cron) невозможно.

Рис. 3.1. Страница «Проверка целостности данных СЭО 3KL».

Кнопка «Описание статусов показателей» (см. поз. 1 Рис. 3.1) раскрывает спойлер с описанием статусов, которые используются в таблице. Доступны следующие статусы: Табл. 3.1.

Табл. 3.1. Доступные статусы показателей

Статус Описание статуса
Нарушений в целостности данных не обнаружено
Проверка целостности еще не проводилась
  Были обнаружены незначительные нарушения в целостности данных, которые критически не влияют на работоспособность системы
Были обнаружены нарушения в целостности данных, которые в высокой степени вероятности могут привести к возникновению ошибок 
Сбор информации по показателю целостности данных не был корректно завершен

В столбцах таблицы с показателями (Рис. 3.1) доступны опции, которые отличаются для каждого показателя. Далее приведено описание всех текстовых ссылок, с которыми вы можете столкнуться в таблице (для текстовых ссылок с одинаковым названием для разных показателей функционал не отличается):

  • Подробнее (см. поз. 2 Рис. 3.1). Текстовая ссылка перенаправляет на страницу «‎Подробная информация по показателю» (Рис. 3.2), на которой можно посмотреть краткую сводку о результатах последней проверки, а также список найденных расхождений. На странице можно восстановить целостность в показателе (поз. 1 Рис. 3.2) или вернуться обратно к сводке по всем показателям (поз. 2 Рис. 3.2).
  • К задаче (см. поз. 3 Рис. 3.1.). Текстовая ссылка перенаправляет на страницу изменения расписания задачи «Выполнить расчет данных для показателей» (Рис. 3.3). На странице можно определить периодичность выполнения задачи по расчету показателей (поз. 1 Рис. 3.3). Для этого нужно ввести значения даты и времени в соответствующие поля. По умолчанию задача выполняется раз в день. Если отметить опцию «Отключено» (поз. 2 Рис. 3.3), задача будет отключена и перестанет выполняться. Если отметить опцию «Установить расписание по умолчанию» (поз. 3 Рис. 3.3) все значения из полей указания даты и времени будут сброшены до значений по умолчанию. Обновление показателей в рамках описанной задачи доступно только для показателей «Целостность модулей курса» и «Целостность файлов», обновление двух других показателей необходимо запускать вручную.
  • Обновить данные (см. поз. 4 Рис. 3.1). Нажатие на текстовую ссылку запускает процесс пересчета показателя.
  • Файл с результатами (см. поз. 5 Рис. 3.1). При нажатии на текстовую ссылку на компьютер пользователя будет скачан файл формата csv с подробностями об отсутствующих на сервере файлах. Отсутствующие файлы идентифицируются по следующим значениям: хеш файла, компонент, файловая зона, полный путь к файлу, название файла, идентификатор пользователя, название курса, идентификатор контекста. 
  • Восстановить целостность (см. поз. 6 Рис. 3.1). Нажатие на текстовую ссылку запустить скрипт, восстанавливающий несоответствия в показателе.
Обратите внимание, для несоответствий в показателях целостности оценок и целостности связи между модулями курса и секциями доступна опция восстановления целостности данных с помощью функционала СЭО 3KL (кнопка «Восстановить целостность», которая описана выше). Тогда как несоответствия в показателях целостности модулей курса и целостности файлов возможно устранить только вручную. 
Если в ходе проверки «Целостность модулей курса» и «Целостность файлов» будут обнаружены нарушения целостности, которые не получится устранить вручную, вы можете обратиться в наше техническую поддержку. Сотрудники техподдержки удалят из таблиц базы данных записи об отсутствующих модулях курса и файлах и целостность данных будет восстановлена.

Рис. 3.2. Страница «Подробная информация по показателю «Целостность связи между модулями курса и секциями».

Рис. 3.3. Страница изменения расписания для задачи «Выполнить расчет данных для показателей».

-Вернуться к содержанию-

4. Глобальные настойки права администратора

Включить или отключить вычисление каждого из показателей целостности можно на странице, расположенной по пути: Администрирование -> Плагины -> Инструменты администрирования  -> Целостность данных 3KL  -> Настройки показателей (Рис. 3.1). Для того, чтобы включить вычисление, достаточно отметить нужный показатель галочкой, и он будет пересчитываться с периодичностью, определенной по умолчанию: для показателей «Целостность оценок» и «Целостность связи между модулями курса и секциями» пересчет можно выполнить только вручную, для показателей пересчет будет выполняться в рамках задачи Cron, периодичность которую можно переопределить (подробнее о настройках данной задачи читайте в пункте 3. «Страница «Проверка целостности данных СЭО 3KL»). 

Рис. 4.1. Страница «Настройки показателей» со всеми показателями в активированном состоянии.

-Вернуться к содержанию-

Теги: данные, отчет, система
Рейтинг ответа: 0 (0 оценок)

Комментарии запрещены