added possibility to change doi suffix in configuration

Author: Manuel Erdoes

CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-05-06
+
+### Added
+- Possibility to choose DOI suffix between `systemobjectid`, `uuid` and custom fylr field
+
 ## [1.0.0] - 2026-04-14
 
 ### Added

README.md

@@ -36,8 +36,9 @@ Each row defines one DataCite repository. Multiple profiles can be configured an
 | Repository ID | Your DataCite repository ID |
 | Password | Your DataCite repository password |
 | DOI Prefix | DOI prefix including trailing slash, e.g. `10.12345/` |
+| DOI Unique ID Field | The part of the DOI that comes after the prefix. User `systemobjectid`, `uuid` or a dot-separated path to a field in a fylr object. |
 | API URL | DataCite API endpoint. Default: `https://api.test.datacite.org` (test). Use `https://api.datacite.org` for production. |
-| Collector Name | Internal name of the collector as configured in the fylr base config publish settings |
+| Collector Name | Internal name of the collector as configured in the fylr base config publish settings. |
 | Publish as Findable | If enabled, the DOI is immediately published (findable). Requires a Detail URL Template. |
 | Detail URL Template | URL template for the object's landing page. Use `%system_object_id%` as placeholder. |
 | DOI Resolver URL | The first part of the URL that will be written in the publish entry in fylr. The URL setting in the collector base config will be ignored. |

documentation.md

@@ -280,7 +280,7 @@ If the admin forgets the query parameter, the script fails fast with `datacite.c
 4. It reads the selected profile and its matching field mappings from the plugin config.
 5. For each object in `data.objects`:
    - Resolve each field mapping's dot-path into the object. If a path goes into a linked object, fetch the full linked object from the fylr API using the plugin user's Bearer token.
-   - Construct the DOI as `<doi_prefix><system_object_id>`.
+   - Construct the DOI as `<doi_prefix><system_object_id/uuid/custom field>`.
    - Build the DataCite JSON:API payload.
    - POST to `<api_url>/dois`. If DataCite returns 422 (exists), retry with PUT to `<api_url>/dois/<doi>`.
    - POST a publish entry to `<fylr_api_url>/api/v1/publish` (Bearer auth) so the DOI appears in the object's publish tab.

l10n/datacite-loca.csv

@@ -8,6 +8,7 @@ server.config.parameter.system.datacite_profiles.profiles.id.label,Profil-ID (f
 server.config.parameter.system.datacite_profiles.profiles.repository_id.label,Repository ID,Repository ID
 server.config.parameter.system.datacite_profiles.profiles.password.label,Passwort,Password
 server.config.parameter.system.datacite_profiles.profiles.doi_prefix.label,DOI Prefix (z.B. 10.5072/fylr-),DOI Prefix (e.g. 10.5072/fylr-)
+server.config.parameter.system.datacite_profiles.profiles.doi_unique_id_field.label,DOI Unique ID Feld,DOI Unique ID Field
 server.config.parameter.system.datacite_profiles.profiles.api_url.label,DataCite API URL,DataCite API URL
 server.config.parameter.system.datacite_profiles.profiles.collector_name.label,Collector Name,Collector Name
 server.config.parameter.system.datacite_profiles.profiles.publish_as_findable.label,DOI Status,DOI Status
@@ -19,4 +20,4 @@ server.config.parameter.system.datacite_field_mappings.field_mappings.label,Feld
 server.config.parameter.system.datacite_field_mappings.field_mappings.profile_id.label,Profil-ID,Profile ID
 server.config.parameter.system.datacite_field_mappings.field_mappings.datacite_field.label,DataCite Feld,DataCite Field
 server.config.parameter.system.datacite_field_mappings.field_mappings.fylr_field_path.label,fylr Feld-Pfad,fylr Field Path
-server.config.parameter.system.datacite_field_mappings.field_mappings.default_value.label,Standardwert,Default Value
+server.config.parameter.system.datacite_field_mappings.field_mappings.default_value.label,Standardwert,Default Value

manifest.master.yml

@@ -1,6 +1,6 @@
 plugin:
   name: fylr-plugin-datacite
-  version: "1.0.0"
+  version: "1.0.1"
   url: https://github.com/eth-library/fylr-publish-datacite-plugin
   l10n: l10n/datacite-loca.csv
   displayname:
@@ -52,23 +52,27 @@ base_config:
           - name: doi_prefix
             type: text
             position: 3
-          - name: api_url
+          - name: doi_unique_id_field
             type: text
             position: 4
+            default: "systemobjectid"
+          - name: api_url
+            type: text
+            position: 5
             default: "https://api.test.datacite.org"
           - name: collector_name
             type: text
-            position: 5
+            position: 6
           - name: publish_as_findable
             type: bool
-            position: 6
+            position: 7
             default: false
           - name: detail_url_template
             type: text
-            position: 7
+            position: 8
           - name: doi_resolver_url
             type: text
-            position: 8
+            position: 9
             default: "https://doi.org"
   - name: datacite_field_mappings
     parameters:

server/webhook/register-doi.js

@@ -105,6 +105,7 @@ async function main() {
     const publishAsFindable = dataciteConfig.publish_as_findable || false;
     const detailUrlTemplate = dataciteConfig.detail_url_template || '';
     const doiResolverUrl = (dataciteConfig.doi_resolver_url || 'https://doi.org').replace(/\/$/, '');
+    const doiUniqueIdField = dataciteConfig.doi_unique_id_field || 'systemobjectid';
 
     // Validate findable requires detail URL
     if (publishAsFindable && !detailUrlTemplate) {
@@ -143,6 +144,7 @@ async function main() {
     for (const obj of objects) {
         const systemObjectId = obj._system_object_id;
         const objecttype = obj._objecttype;
+        const uuid = obj._uuid;
 
         if (!systemObjectId || !objecttype) {
             errors.push({ system_object_id: systemObjectId, error: 'Missing _system_object_id or _objecttype' });
@@ -173,7 +175,35 @@ async function main() {
         }
 
         // Construct DOI
-        const doi = dataciteConfig.doi_prefix + systemObjectId;
+        let doi_suffix = '';
+        if (doiUniqueIdField === 'systemobjectid') {
+            doi_suffix = systemObjectId;
+        } else if (doiUniqueIdField === 'uuid') {
+            doi_suffix = uuid || systemObjectId;
+        } else {
+            // Strip objecttype prefix if present (e.g. "haustieranatomie.titel" -> "titel")
+            let resolvedPath = doiUniqueIdField;
+            if (resolvedPath && resolvedPath.startsWith(objecttype + '.')) {
+                resolvedPath = resolvedPath.slice(objecttype.length + 1);
+            }
+
+            // Prefer _current which contains the full field data; fall back to top-level obj
+            const sourceObj = (obj._current && obj._current[objecttype]) ? obj._current : obj;
+            const resolvedValue = await resolveFieldPathAsync(sourceObj, objecttype, resolvedPath, fylrApiUrl, accessToken, warnings);
+            if (resolvedValue) {
+                doi_suffix = resolvedValue;
+            } else {
+                errors.push({ system_object_id: systemObjectId, error: `DOI unique ID field "${doiUniqueIdField}" could not be resolved` });
+                continue;
+            }
+        }
+
+        if (!doi_suffix) {
+            errors.push({ system_object_id: systemObjectId, error: 'DOI unique ID field resolved to empty value' });
+            continue;
+        }
+
+        const doi = dataciteConfig.doi_prefix + doi_suffix;
         const doiPrefix = doi.split('/')[0];
 
         // Construct landing URL