yti-datamodel-api

Interoperability workbench data model editor backend

Requirements

• Java 17
• Docker
• Gradle 7.6

Development

Checkout library projects

• yti-spring-migration
• yti-spring-security

Checkout corresponding tag for version defined in build.gradle, e.g. git checkout v0.2.0 Install package to local maven repository ./gradlew publishToMavenLocal

Checkout other required projects

• yti-groupmanagement
• yti-fuseki

For each project run build.sh located at the project root folder. The script builds a docker image for the project.

Checkout yti-compose project

Start dependant containers

docker-compose up -d yti-groupmanagement yti-fuseki-v4 yti-datamodel-opensearch

Copy content from main/resources/config/application.properties.template to file application-local.properties and adjust values as needed.

Populate data to the database

./src/scripts/init.admin.sh

API docs

http://localhost:9004/datamodel-api/swagger-ui/index.html

Troubleshooting

Error: index external_v2 doesn't exist

Solution: Run re-indexing (requires super user). Also JSESSIONID cookie can be used for authorization.

curl -X POST -H 'Authorization: Bearer <api_key>' <host>/datamodel-api/v2/index/reindex

External resources don't appear in the search dialogs

Solution: External resources are not resolved by default on startup. Define property namespaces.resolveDefault=true in application-local.properties and restart the application. Once resolved, set this property to false to make starting application faster.