====== Migration de contenu vers Drupal ======

Cours: [[https://understanddrupal.com/courses/31-days-of-migrations/]]


===== Écrire un module de migration =====

<code>
|-- modules
|   `-- custom
|       `-- mes_migrations
|           |-- migrations
|           |   `-- mig_test_1.yml
|           `-- mes_migrations.info.yml
</code>

**modules/custom/mes_migrations/mes_migrations.info.yml**

<code yaml>
name: Mes Migrations
type: module
package: Custom
description: Premier test de migration
core_version_requirement: ^10
dependencies:
  - drupal:migrate
</code>

**modules/custom/mes_migrations/migrations/mig_test_1.yml**

<code yaml>
id: mig_test_1
label: Migration Test 1
source:
  plugin: embedded_data
  data_rows:
    -
      unique_id: 1
      creative_title: 'Page importée #1'
      engaging_content: 'Texte de la page importée #1'
    -
      unique_id: 2
      creative_title: 'Page importée #2'
      engaging_content: 'Texte de la page importée #2'
    -
      unique_id: 3
      creative_title: 'Page importée #3'
      engaging_content: 'Texte de la page importée #3'
  ids:
    unique_id:
      type: integer
process:
  title: creative_title
  body: engaging_content
destination:
  plugin: 'entity:node'
  default_bundle: page
</code>

===== Exécution =====

Activer ce module (**Migrate** sera également activé s'il ne l'est pas déjà).

Voir le status des migrations :

<code bash>
vendor/bin/drush migrate:status
</code>

Exécuter une migration (ou plusieurs) :

<code bash>
vendor/bin/drush migrate:import mig_test_1
</code>

===== Process =====

Si aucun plugin n'est défini, c'est le plugin **get** qui est utilisé par défaut :

<code yml>
process:
  title: creative_title
  body: engaging_content
</code>

Plugin **get** :

<code yml>
source:
  ...
process:
  title:
    plugin: get
    source: creative_title
  body:
    plugin: get
    source: engaging_content
</code>

Plugin **default_value** :

<code yml>
process:
  type:
    plugin: default_value
    default_value: page
destination:
  plugin: 'entity:node'
  
# plus besoin de spécifier la propriété "default_bundle" puisqu'on
# a défini une valeur pour le champ "type".
</code>

Plugin **concat** :

<code yml>
source:
  plugin: embedded_data
  data_rows:
    -
      unique_id: 1
      first_name: 'Marc'
      last_name: 'Lebrun'
process:
  title:
    plugin: concat
    source:
      - first_name
      - last_name
    delimiter: ' '
</code>

Plugin **callback** :

<code yml>
process:
  title:
    plugin: callback
    source: first_name
    callable: ucwords
    
    # callable est une fonction PHP
</code>

Chaînage de plugins :

<code yml>
process:
  title:
    -
      plugin: concat
      source:
        - first_name
        - last_name
      delimiter: ' '
    -
      plugin: callback
      callable: ucwords
      
      # le paramètre "source" du plugin callback n'est pas nécessaire 
      # lorsqu'il fait partie d'une chaîne de plugins
</code>