|
| 1 | +# InvenioRDM v13.1 |
| 2 | + |
| 3 | +*2026-03-19* |
| 4 | + |
| 5 | +We are happy to announce the release of InvenioRDM v13.1. This is a minor release which will become the maintained tip of v13. |
| 6 | +Future patches for v13 will land on this minor version only. |
| 7 | + |
| 8 | + |
| 9 | +## What's new? |
| 10 | + |
| 11 | +InvenioRDM v13.1 primarily backports the [request reviewers feature](/maintenance/architecture/requests/#reviewers-in-requests) to InvenioRDM v13. |
| 12 | + |
| 13 | +This feature allows the selection of users (or groups) as "reviewers" for requests. |
| 14 | +The selected reviewers will gain access to the request and its timeline (i.e. associated events and comments), and be able to comment on the request too. |
| 15 | + |
| 16 | +!!! warning "Enabling the feature requires reindexing the requests" |
| 17 | + The information about the set of reviewers is stored in a new field in the request itself, so the schema has changed. |
| 18 | + Enabling the feature will require the search mappings to be updated, and the requests to be reindexed. |
| 19 | + For more details, see the [upgrade section below](#upgrading-from-v130-to-v131). |
| 20 | + |
| 21 | + |
| 22 | +### Selecting reviewers for requests |
| 23 | + |
| 24 | +The new request reviewers feature is (currently) opt-in, so you'll have to enable the `REQUESTS_REVIEWERS_ENABLED` feature flag via the configuration. |
| 25 | +Additionally, the behavior can be tweaked with a few more configuration items: |
| 26 | + |
| 27 | +```python |
| 28 | +REQUESTS_REVIEWERS_ENABLED = True |
| 29 | +"""Enable the request reviewers feature.""" |
| 30 | + |
| 31 | +REQUESTS_REVIEWERS_MAX_NUMBER = 15 |
| 32 | +"""Maximum number of reviewers allowed for a request.""" |
| 33 | + |
| 34 | +USERS_RESOURCES_GROUPS_ENABLED = True |
| 35 | +"""Config to enable features related to existence of groups. |
| 36 | +
|
| 37 | +Makes groups available for selection as request reviewers, in addition to users. |
| 38 | +""" |
| 39 | +``` |
| 40 | + |
| 41 | +**Note** that the feature flag currently enables the request reviewers feature for *all kinds of requests*. |
| 42 | + |
| 43 | + |
| 44 | +### Other notable changes |
| 45 | + |
| 46 | +Even though the upgrade pulls in a number of major version bumps, there are actually only relatively few large changes. |
| 47 | +Most of the major releases there just bump their own dependencies (to better isolate from breaking changes) rather than introducing breaking changes themselves. |
| 48 | + |
| 49 | +Here are the most noteworthy changes: |
| 50 | + |
| 51 | +* [`Invenio-Users-Resources` v9.0.0](https://pypi.org/project/invenio-users-resources/9.0.3/): Tightened permissions for users endpoints in the REST API, and change of HTTP status code from `403` to `404` on permission errors for increased privacy |
| 52 | +* [`Invenio-RDM-Records` v20.2.0](https://pypi.org/project/invenio-rdm-records/20.2.0/): Renaming of several `React-Overridable` IDs; the full list of changed IDs is available in the [changelog for v20.2.0](https://github.com/inveniosoftware/invenio-rdm-records/blob/v20.2.0/CHANGES.rst?plain=1) |
| 53 | + |
| 54 | + |
| 55 | + |
| 56 | +## Upgrading from v13.0 to v13.1 |
| 57 | + |
| 58 | +The first step of the upgrade process is of course to install the new packages. |
| 59 | +To do so, make sure that the version specifiers for the Invenio-App-RDM dependency in your project definition (`pyproject.toml`, `Pipfile`, ...) allow for the `13.1.x` range of releases, e.g. `invenio-app-rdm[opensearch2]~=13.1.0`. |
| 60 | + |
| 61 | +The new packages should be found and installed via `invenio-cli install`. |
| 62 | +If the v13.1 release of Invenio-App-RDM still doesn't get pulled in, remove your lock file (`uv.lock`, `Pipfile.lock`, ...) and try again. |
| 63 | + |
| 64 | +After installing the new packages, you'll need to update the search mappings for the requests index, and reindex all requests. |
| 65 | + |
| 66 | +```bash |
| 67 | +# update the search mappings for requests to include reviewers |
| 68 | +invenio index update requests-request-v1.0.0 --no-check |
| 69 | + |
| 70 | +# start bulk reindexing for all requests |
| 71 | +invenio rdm rebuild-all-indices --order requests |
| 72 | +``` |
| 73 | + |
| 74 | +That's it. |
| 75 | +Other search indices like request events aren't affected and don't need to be updated. |
| 76 | + |
| 77 | +!!! info "No action needed if you don't want to use the feature" |
| 78 | + If you *do not* intend to enable the request reviewers feature, no further action is necessary after upgrading the installed packages. |
| 79 | + But updating the mappings won't hurt either. |
| 80 | + |
| 81 | +Enjoy v13.1! 😎 |
0 commit comments