Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Speaker Deck
PRO
Sign in
Sign up for free
Drupal8 Migrate API
kazukomurata
November 23, 2019
Programming
0
140
Drupal8 Migrate API
kazukomurata
November 23, 2019
Tweet
Share
More Decks by kazukomurata
See All by kazukomurata
Migrate Drupal7 to Drpual8
kazukomurata
0
140
Drupal8 Problem of multilingualization of contents
kazukomurata
0
48
Drupalのデモサイト作って明日までに!と言われたら
kazukomurata
0
330
Drupal8 CKEditor TIps
kazukomurata
0
230
Drupal7 & 8 翻訳コンテンツの罠
kazukomurata
0
210
Drupal7×Cloudfront×SSL
kazukomurata
0
160
Drupal8 State API と Configuration API
kazukomurata
0
190
Drupal8 2016/11
kazukomurata
0
37
Other Decks in Programming
See All in Programming
読みやすいコードを書こう
yutorin
0
360
Managing gRPC with Wire
oldergod
2
150
Jakarta EE 10 is Coming Your Way
ivargrimstad
0
1.9k
WindowsコンテナDojo : 第1回 Visual StudioでWindowsコンテナアプリ作成
oniak3ibm
PRO
0
320
Go API クライアントの実装 〜Go Conference に載せれなかったTIPS〜
yyoshiki41
0
180
クリエイティブ系のウェブサイト制作で役立つCSS技法 / CSS for develop creative website
clockmaker
2
1.2k
New Relicを使った Observabilityの実現方法と活用例 / gocon 2022 spring after talk
budougumi0617
0
890
Becoming an Android Librarian
skydoves
3
420
Is Rust a great language for building Kubernetes ecosystem
deepu105
0
140
コードの解析と言語習得の心得
jinjin33333
0
120
よりUXに近いSLI・SLOの運用による可用性の再設計
kazumanagano
3
450
Where and how to run UI tests (Droidcon London, 2021)
nonews
0
200
Featured
See All Featured
Why Our Code Smells
bkeepers
PRO
324
54k
Testing 201, or: Great Expectations
jmmastey
21
5.4k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
237
19k
Git: the NoSQL Database
bkeepers
PRO
415
59k
Keith and Marios Guide to Fast Websites
keithpitt
404
21k
Writing Fast Ruby
sferik
612
57k
Put a Button on it: Removing Barriers to Going Fast.
kastner
56
2.3k
Rebuilding a faster, lazier Slack
samanthasiow
62
7.2k
Optimizing for Happiness
mojombo
365
63k
The Language of Interfaces
destraynor
148
20k
Principles of Awesome APIs and How to Build Them.
keavy
113
15k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
224
49k
Transcript
Drupal8 Migrate API コンテンツ移行
自己紹介 村田和子 @kazuno_ko85 • Drupal歴4年くらい。設計・プロジェクト管理がメイン。 • 月1でDrupal Meetup Tokyo にいます。https://drupal-tokyo.connpass.com/
• フリーランス。2020年からエンジニアとは少し違う分野に挑戦したい。
コンテンツ移行と言うと・・・ Drupal8サイト Drupal9サイト Drupal7サイト 他のCMS etc... HTML群
今日の観点 Drupal8サイト Drupal9サイト Drupal7サイト 他のCMS etc... HTML群
Migrate API • Drupalにはコンテンツ移行専用の APIがある。Migrate API! • 見るべし : https://www.drupal.org/docs/8/api/migrate-api/migrate-api-overview
• 対象 ◦ Content Entity すべて。ノード、タクソノミー、ユーザー、カスタムエンティティも可能。 ◦ 翻訳も登録可能。一緒にターム参照も登録可能。 • なにがいいのか ◦ 移行元と移行先のマッピング用テーブルあるので、新規・更新・削除が簡単 ◦ 移行元と移行先のマッピングを config(yaml)で定義していく作業がメイン。 ◦ カスタマイズは、プラグインとして作成できる。
コンテンツ移行の手順 超簡易版 • 移行元のCSV用意 • config(yaml)作成 ◦ source : CSVの列定義を設定
◦ process: CSVの列とフィールドをマッピング設定 ◦ destination: 移行先のコンテンツやタクソノミータイプを設定 • config(yaml)をインポート (コマンドか管理画面) ◦ 例 drush config:import --partial --source=/app/web/modules/custom/p_demo_migrate/config/install • 実行(コマンド) ◦ 例 drush migrate:import p_demo_migrate_article --update
Migrate APIの仕様にそって カスタマイズを減らそう 簡単!とはいえ、Migrate APIのレールに乗らないと辛くなる。要件を調整しよう。 • config(yaml) 1つに対して、DBにマッピング用テーブルが 1つ出来る。 •
異なるエンティティは一緒に登録できない (ノードとユーザをコマンド1発で登録は無理) • 翻訳は、config(yaml) は別々に作成する必要あり • 例 : 記事コンテンツをカテゴリつきで、メイン :日本語, 翻訳:英語で移行したい。 ◦ カテゴリ(日本語)をタクソノミーで言語=日本語として移行 ◦ カテゴリ(英語)を日本語ノードと紐付けつつ英語翻訳として移行 ◦ 記事コンテンツ(日本語)をノードで言語=日本語として移行 ◦ 記事コンテンツ(英語)を日本語ノードを紐付けつつ英語翻訳として移行 • 4回に移行の実行を分けることで、コードなしで移行が可能 (かも)
ファイルは・・・? • よくあるファイルフィールドであれば、コントリビュートモジュールで可能 ◦ migrate_fileモジュール • メディアにしたい場合は、config(yaml) でコンテンツとは別に移行する必要あり • 本文中の画像やファイルリンク先のファイルはどうする・・・
?奥の手↓ ◦ 素直にやるとファイルフィールドやメディアにアップし、本文内の imgタグやaタグのパス 書き換える必要が・・・。 ◦ 1. 対象ファイルだけ一式抜いてドキュメントルートに置いちゃう (ただしちょっと気持ち悪 い) ◦ 2.対象ファイルだけ一式抜いて publicフォルダ配下に配置 ▪ NginxやApachのリライトでしのぐ or 本文内のパスをpublicフォルダ配下の画像 を見るように置くのが・・・いいかも。
カスタマイズ例 いままで見た・作成したカスタマイズです。 • source ◦ 別CMSのDBからデータを引っこ抜く • process ◦ 指定パスをもとにhtmlファイルを読み込む(そのあと本文フィールドに指定
) ◦ パラグラフ化する ◦ 投稿者が想定のユーザと異なる場合、登録更新スキップ • destination ◦ なし
よく使うコントリビューションモジュール • migrate_plus ◦ processプラグインの提供多し。これがないとマジでつらい。 • migrate_tools ◦ drush実行するなら必須 •
migrate_file ◦ ファイル登録 • migrate_source_csv ◦ CSVから移行するなら必須
実装時に参考になる資料 • 翻訳コンテンツの設定方法 ◦ core/modules/migrate/tests/modules/migrate_external_translated_test/migrations ◦ オリジナル言語と翻訳言語の configがある • process
プラグイン ◦ https://www.drupal.org/docs/8/api/migrate-api/migrate-process-plugins/list-of-core-migrate-proce ss-plugins ◦ https://www.drupal.org/docs/8/api/migrate-api/migrate-process-plugins/list-of-process-plugins-pr ovided-by-migrate-plus • 日本語の説明記事 ◦ https://qiita.com/masam10/items/5b0d14d2af0115307d27