Drupal TPR integration

Integrates Helsinki Service Map and TPR Service Description Register with Drupal.

Requirements

• PHP 8.0 or higher

Usage

Available migrations:

• tpr_unit
• tpr_service
• tpr_errand_service
• tpr_service_channel

Turn on the feature needed to enrich the TPR data

Install HELfi TPR configuration module included in HELfi platform config module.

drush en helfi_tpr_config

Running migrations

Running all TPR migrations:

drush migrate:import --group tpr

Running a single migration:

drush migrate:import {migration_id} Add --update parameter to update existing items.

Reverting a migration:

drush migrate:rollback {migration_id}.

Migration failed and the migration process is stuck at importing:

drush migrate:reset-status {migration_id}.

Speed up migrations

Set PARTIAL_MIGRATE=1 env variable to only migrate changed items. NOTE: running a partial migrate will skip all garbage collection tasks (such as cleaning removed remote entities), so you should periodically run full migrations as well.

Migrate fixtures

drush helfi:migrate-fixture {migrate_id}.

Overwriting url and canonical_url

It's possible to overwrite url and canonical_url per project by adding a configuration file named helfi_tpr.migration_settings.{migrate_id}.yml and defining the URLs there.

Developing

Make sure you have donatj/mock-webserver installed when running tests locally: composer require --dev donatj/mock-webserver

Contact

Slack: #helfi-drupal (http://helsinkicity.slack.com/)