mjordan/islandora_repository_reports

Drupal 8/9 模块,提供关于 Islandora 存储库各个方面的报告集合。

dev-main 2024-06-19 04:49 UTC

This package is auto-updated.

Last update: 2024-09-19 05:30:16 UTC


README

简介

一个 Drupal 10 模块,提供关于 Islandora 存储库各个方面的报告集合。此模块的目标是为 Islandora 存储库管理员提供一套无需或仅需少量配置即可工作的可视化报告。它不是 Views 的替代品。

此模块包含的报告有:

  • 按集合分组的节点数量
  • 按 Drupal 内容类型分组的节点数量
  • 按创建月份分组的节点数量
  • 按 Islandora 模型分类法术语分组的节点数量
  • 按 Islandora 类型分类法术语分组的节点数量
  • 按 MIME 类型分组的媒体数量
  • 按 Islandora 媒体用途分类法分组的媒体数量
  • 节点字段中唯一值的数量(仅限字符串/文本字段类型)
  • 按 Drupal 文件系统(例如,Fedora、公共、私有)、MIME 类型或集合分组的磁盘使用量
  • 按月份的磁盘使用量

此外还包含几个可选的子模块(每个都需要分别启用),这些子模块允许用户:

  • 生成关于任何分类法/词汇表术语使用的报告
  • 生成关于 Drupal 系统日志条目的报告
  • 生成关于 OAI-PMH 收割次数的报告,按月份分组
  • 查看 ActiveMQ 队列中待处理消息的数量
  • 使用 Matomo 数据生成关于集合级别使用的报告
  • 从 Islandora 存储库报告界面访问 Matomo 仪表板。更多信息请参阅其 README
  • 从 Islandora 存储库报告界面访问由 Islandora Riprap 生成的失败的完整性检查事件报告。更多信息请参阅其 README
  • 从 Islandora 存储库报告界面访问 Islandora Bagger 队列以及与 Islandora Bagger 集成注册的包列表。更多信息请参阅其 README

概述

拥有“查看存储库报告”权限的用户可以访问报告页面,从 Drupal 的报告列表(admin/reports)进入,或者,如果没有权限查看报告列表,可以直接在 admin/reports/islandora_repository_reports 中链接。选择一个可用的报告,然后点击“Go”按钮,将生成一个饼图,如下所示

Random pie chart

或者一个柱状图,如下所示

Random bar chart

所有报告都允许用户在点击“Go”按钮之前勾选一个复选框,以生成此数据的 CSV 文件。如果勾选此框,将出现一个下载 CSV 文件的链接。

要求

安装

  1. 将此存储库克隆到您的 Islandora 的 drupal/web/modules/contrib 目录或通过 Composer: composer require mjordan/islandora_repository_reports
  2. 可以在“管理员 > 扩展”菜单下启用模块,或者通过运行drush en -y islandora_repository_reports命令。

配置

配置选项(饼图与环形图、颜色选项、缓存)可在“Islandora”配置组中找到,或直接在admin/config/islandora/islandora_repository_reports中访问。一些额外的配置相关说明

  • 用户需要具有“查看仓库报告”权限才能查看报告页面。
  • 用户在表单中选择的选项用于选择要生成的报告,这些选项对每个Drupal用户都是特定的。它们不是由网站管理员为所有用户设置的。
  • 在安装时,会安装一个包含一些使用报告的“提示”的块。如果您使用的是Seven作为管理主题,则此块将放置在仓库报告页面的底部。

预生成报告数据

一般来说,随着您仓库的大小增加,生成图表中可视化的数据所需的时间也会更长。如果您选择缓存报告数据,您可以通过预生成数据来使图表在合理的时间内渲染。此模块包含一组Drush命令,用于生成报告中使用的数据并将其缓存

  1. 要列出已启用的报告类型:drush islandora_repository_reports:list_report_types
  2. 要预生成“模型”报告的数据:drush islandora_repository_reports:build_cache model
  3. 要删除“mimetype”报告的数据:drush islandora_repository_reports:delete_cache mimetype

请注意,生成缓存数据的Drush命令使用用户最近通过admin/reports/islandora_repository_reports中的报告选择表单选择的图表选项。无法将图表选项传递给Drush命令(尽管有一个开放问题来添加该功能)。

编写数据源插件

此模块旨在易于仓库管理员使用,也便于开发者扩展。编写提供数据源插件的子模块相当简单。编写子模块

当前维护者

贡献

为此模块做出贡献将提高您的技能。

许可证

GPLv2