コンテンツとタクソノミーの翻訳をCSVでインポートします I made English version https://www.slideshare.net/TakafumiOinuma/import-contents-taxonomies-and-translations-in-drupal8

1. Drupal8でのCSVインポート
コンテンツ、タクソノミー、翻訳でのマイグレーション

2. コンテンツをCSVインポート

3. 準備 モジュールのダウンロード
・Migrate Plus
・Migrate Tools
・Migrate Source CSV
・Configuration development
Drushを使用

4. コンテンツのCSVデータ例

5. YAMLの知識
キーとバリューをコロンで区切る
改行してインデントを付けると配
列になる
ハイフンで通常の配列、キーとバ
リューを設定すると連想配列
id: import_test
label: Importのテスト
source:
plugin: csv
header_row_count: 1
keys:
- id
process:
type:
plugin: default_value
default_value: 'article'

6. モジュールを作成 以下の構成でモジュールを作成
article_migrate
article_migrate.info.yml
config
import
migrate_plus.migration.article.yml
config/import/ディレクトリに
migrate_plus.migration.[id].ymlで
YAMLファイルを用意しておくと
モジュールインストール時に読み込ま
れます

7. モジュールを作成
article_migrate.info.yml
name: Article CSV Import
description: 記事のCSVインポーター
core: 8.x
type: module
package: Migration
dependencies:
- migrate_source_csv
以下の構成でモジュールを作成
article_migrate
article_migrate.info.yml
config
import
migrate_plus.migration.article.yml
config/importディレクトリ内のファ
イルが読み込まれる

8. CSVインポート用YAMLの構成
migrate_plus.migration.article.yml
id: article
label: 記事のCSVインポート
migration_group: articles
source:
process:
destination:
plugin: entity:node
ファイル名は
migrate_plus.migration.[id].ymlにす
る
IDとラベルを指定
migration_groupを指定すると複数の
インポートを一括で行える
source以下には基本的な情報
process以下にはフィールドの情報
destination以下にはエンティティの
情報を記述する

9. インポートの基本情報を記述する
source:
plugin: csv
header_row_count: 1
# path: public://csv/article.csv
path: /tmp/csv/article.csv
keys:
- ID
pluginにcsvを指定する
ヘッダーの行数を省くことができる
pathにインポートするCSVを指定す
る
サーバールートから指定したり、
drupalのファイルディレクトリを指
定したりできる
keysにプライマリーキーを指定する
ことで、重複を避ける（アップデー
トできる）

10. フィールド情報を記述する
process:
type:
plugin: default_value
default_value: article
title: title
status:
plugin: default_value
default_value: 1
'body/value': body
'body/summary': summary
コンテンツタイプ、タイトル等を設
定する
設定する値はCSVのラベルを使用す
る
default_valueプラグインでは、CSV
からではなく、任意の値を設定でき
る

11. 完成系
id: article
label: 記事のCSVインポート
migration_group: articles
source:
plugin: csv
# path: public://csv/article.csv
path: /tmp/csv/article.csv
header_row_count: 1
keys:
- ID
process:
type:
plugin: default_value
default_value: article
title: title
status:
plugin: default_value
default_value: 1
'body/value': body
'body/summary': summary
destination:
plugin: entity:node

12. インポート モジュールをインストールすると
YAMLの設定が読み込まれる
drush en article_migrate
更新したい場合はcdiコマンドを使う
drush cdi article_migrate
mimコマンドでインポートを実行
グループでも実行できる
drush mim article
drush mim --group=articles

13. タクソノミーをCSVインポート

14. タクソノミのCSVデータ例

15. CSVインポート用YAMLの構成
migrate_plus.migration.tags.yml
id: tags
label: タグのCSVインポート
migration_group: articles
source:
process:
destination:
plugin: entity:taxonomy_term
新しいタグ用のファイルを作成
migration_groupはarticleの時と同じ
にする
destinationをタクソノミーのプラグ
インに変更する

16. インポートの基本情報を記述する
source:
plugin: csv
header_row_count: 1
# path: public://csv/tags.csv
path: /tmp/csv/tags.csv
keys:
- tag
基本コンテンツの時と同じ
タクソノミー用にcsvを書き換える
プライマリーキーはタグの名前にし
ておくと重複しないため、便利

17. フィールド情報を記述する
vid:
plugin: default_value
default_value: tags
name: tag
ボキャブラリーはvidでシステム名称
で設定できる
ターム名はnameで指定する
フィールドを設定している場合は、
フィールドも追加できる

18. インフォファイルにファイル情報を追加
article_migrate.info.yml
...
config_devel:
install:
- migrate_plus.migration.article
- migrate_plus.migration.tags
追加したmigrate_plus.migration.tags
ファイルの情報を追加

19. 完成系
id: tags
label: タグ のCSVインポート
migration_group: articles
source:
plugin: csv
path: /tmp/csv/tags.csv
header_row_count: 1
keys:
- tag
process:
vid:
plugin: default_value
default_value: tags
name: tag
destination:
plugin: entity:taxonomy_term

20. 記事にタクソノミーの情報を付け足す
process:
…
field_tags:
-
plugin: explode
source: tag
delimiter: '|'
-
plugin: callback
callback: trim
-
plugin: migration_lookup
migration: tags
記事用の
migrate_plus.migration.article.ymlを
書き換える
migration_lookupでtags（タグ用のイ
ンポーターのID）とリレーションす
る

21. 記事にタクソノミーの情報を付け足す
migration_dependencies:
optional:
- tags
migration_dependenciesでtagsのマ
イグレーションを使用することを明
示する

22. 完成系
id: tags
label: タグのCSVインポート
migration_group: articles
source:
…
process:
type:
plugin: default_value
default_value: article
title: title
status:
plugin: default_value
default_value: 1
'body/value': body
'body/summary': summary
field_tags:
-
plugin: explode
source: tag
delimiter: '|'
-
plugin: callback
callback: trim
-
plugin: migration_lookup
migration: tags
destination:
plugin: entity:node
migration_dependencies:
optional:
- tags

23. インポート YAMLファイルの設定を反映させる
drush cdi article_migrate
同じグループで設定していたため、
articlesグループとして一括でインポー
トができる
drush mim --group=articles

24. 翻訳をCSVインポート

25. 準備 モジュールのダウンロード
・Content Translation
以下のページでコンテンツ、
タクソノミーの翻訳機能を
ONにしておく
/admin/config/regional/cont
ent-language

26. CSVインポート用YAMLの構成
migrate_plus.migration.article_en.yml
id: article_en
label: 記事の翻訳のCSVインポート
migration_group: articles
destination:
plugin: entity:node
translations: true
migration_dependencies:
required:
- article
記事の翻訳用のYAMLファイルを用意
する
desticationではtranslationsをtrueに
設定する
migration_dependenciesで翻訳前の
インポーターを明示する

27. インポートの基本情報を記述する
source:
plugin: csv
header_row_count: 1
# path: public://csv/article.csv
path: /tmp/csv/article.csv
keys:
- ID
CSVファイルの設定等は翻訳前と同
じ
日本語と英語のデータが同じ行で対
応するようにする

28. フィールド情報を記述する
process:
nid:
plugin: migration_lookup
source: ID
migration: article
langcode:
plugin: default_value
default_value: en
title: title_en
'body/value': body_en
'body/summary': summary_en
nidの設定で翻訳前のデータとリレー
ションするように設定する
langcodeで翻訳する言語を設定する
翻訳するフィールドのみ設定する

29. 完成系
id: article_en
label: 記事の翻訳CSVインポート
migration_group: articles
source:
plugin: csv
# path: public://csv/article.csv
path: /tmp/csv/article.csv
header_row_count: 1
keys:
- ID
process:
nid:
plugin: migration_lookup
source: ID
migration: article
langcode:
plugin: default_value
default_value: en
title: title_en
'body/value': body_en
'body/summary': summary_en
destination:
plugin: entity:node
translations: true
migration_dependencies:
required:
- article

30. タクソノミーの翻訳
同様に翻訳前とのリレーション、
翻訳する言語の設定、
destinationでtranslationを
Trueに設定する
id: tags_en
label: タグ の翻訳のCSVインポート
migration_group: articles
source:
plugin: csv
path: /tmp/csv/tags.csv
header_row_count: 1
keys:
- tag
process:
tid:
plugin: migration_lookup
migration: tags
source: tag
langcode:
plugin: default_value
default_value: en
name: tag_en
destination:
plugin: entity:taxonomy_term
translations: true
migration_dependencies:
required:
- tags

31. インフォファイルにファイル情報を追加
article_migrate.info.yml
...
config_devel:
install:
- migrate_plus.migration.article
- migrate_plus.migration.tags
- migrate_plus.migration.article_en
- migrate_plus.migration.tags_en
追加したファイルの情報を追加

32. インポート YAMLファイルの設定を反映させる
drush cdi article_migrate
今までと同様、articlesグループで一括
インポートする
drush mim --group=articles