chore(migrate): add migration for keywordTermUri and placeholder configuration #10288

Introduces a new migration script to update `keywordValue` fields containing HTTP values to `keywordTermUri` (as seen in the release notes). Updates the POM to include a placeholder for toggling this migration, ensuring flexibility during upgrades.

Using a Flyway placeholder, we can inject a Maven property into the SQL script and conditionally execute the migration. Defaulting to false (don't execute).

See also: https://documentation.red-gate.com/fd/migration-placeholders-275218550.html

Author: poikilotherm

modules/dataverse-migrate-db/extra-migrations/V6.2.0.2__migrate_keywordTermUri.sql

@@ -0,0 +1,17 @@
+--
+DO
+$$
+    DECLARE
+        should_migrate BOOLEAN := CASE WHEN UPPER('${V6_3_migrate_keywordTermUri}') = 'TRUE' THEN TRUE ELSE FALSE END;
+    BEGIN
+        IF should_migrate THEN
+            RAISE NOTICE 'Migrating keywordValue fields with http... to keywordTermUri as requested';
+            UPDATE datasetfield df
+            SET datasetfieldtype_id = (SELECT id FROM datasetfieldtype WHERE name = 'keywordTermURI')
+            FROM datasetfieldvalue dfv
+            WHERE dfv.datasetfield_id = df.id
+              AND df.datasetfieldtype_id = (SELECT id FROM datasetfieldtype WHERE name = 'keywordValue')
+              AND dfv.value ILIKE 'http%';
+        END IF;
+    END
+$$;

modules/dataverse-migrate-db/pom.xml

@@ -42,6 +42,10 @@
         <postgresql.dump.target>${project.build.directory}</postgresql.dump.target>
         <!-- Default: wait for 30s (DMP default is 10s) -->
         <postgresql.waitForSec>30</postgresql.waitForSec>
+        
+        <!-- Migrations Placeholders -->
+        <!-- See https://github.com/IQSS/dataverse/releases/tag/v6.3#upgrade-instructions-6-3, https://github.com/IQSS/dataverse/pull/10371  -->
+        <migrate.keywordTermUri>false</migrate.keywordTermUri>
     </properties>
 
     <build>
@@ -245,6 +249,9 @@
                                 <location>filesystem:../../src/main/resources/db/migration</location>
                                 <location>filesystem:extra-migrations</location>
                             </locations>
+                            <placeholders>
+                                <V6_3_migrate_keywordTermUri>${migrate.keywordTermUri}</V6_3_migrate_keywordTermUri>
+                            </placeholders>
                         </configuration>
                     </execution>
                     <execution>