FeedsモジュールでEnityにデータインポート

モジュール（Feature）が開発ソース管理、コンテンツデータ移行などに利用されます

• 最初モジュール（Feature）が何に使うかはあまりわからなかったです（いろいろな説明がちゅ抽象的）。
• 実はDrupalの開発ソース管理（例：開発環境ー＞ステージん環境ー＞本番環境）、コンテンツデータの移行に使用されます
  

データ移行例：コンテンツデータ（Article）＋Viewsで作成したコンテンツ検索一覧画面

• データ移行の簡単な例として、既存のコンテンツデータ（例：Article⇒記事）、Viewsで作成したコンテンツ一覧画面を移行します
• コンテンツデータ移行に必須なモジュール：
  • Feature
  • Node Export （FeatureモジュールにサポートするNode export featuresサブモジュールを有効化）
• Feature管理画面で必要なモジュール、モジュールの関連、コンテンツデータを選択して、一つのモジュールとして作成し、ダウンロードします
• 作成されたモジュール（tarファイル）を移行先で通常のモジュールインストールをして、有効化を行います。Feature管理画面で移行元の内容を適用、保存します
• 具体的な操作はビデオをご参考ください

FeatureがDurupalのすべての設定、構成の移行はできません

• 移行はモジュール単位で、構成は出力可能なものを中心にしています。以下は移行可能な部分
  • Core ： Content Types、 Fields、 Menus、 Taxonomies、 Text formats、 Image styles、 User roles 、 permissions
  • Contribute： Views、 CTools、 Context 、 Panels、 Rules 、 Contexts、 Display Suite
• 移行できない部分は、例：テーマ、コンテンツに挿入した画像などがあります
  • コンテンツに含まるメディア（例：写真、ビデオ、ファイルなど）がローカル（sites/default/files）に保存したため、移行先の保存パス修正、およびメディアファイルのコピーが手動で行う必要があります

Drupal共有ソースサイトへの移行計画

• Drupal7で複数のサイト（ドメイン）を構築しました。それぞれのバージョンアップ、ソースのバグ管理に手間がかかります。
• 一つの共有ソースにすれば、Drupalのバージョンアップ、ソースのバグ管理に効率は良いと考えられています
• 例：以下イメージのようにサイト移行
  
• サイト移行時の両側の違い：
  • Drupalのバージョンは同じ：７
  • モジュール：共有ソース側の方が多い、また同じモジュールに違うバージョンが存在している可能性があります
  • DB：移行先に各サイトは別々のDBで違うコンテンツを有します

サイト移行の一番大きな問題点：メディア保存のフォルダが変わる

• サイト移行にどんな方法を使っても、元サイトのメディア（例：写真など）保存フォルダー（sites/default）が、共有ソース側に別名のフォルダ（それぞれのサイトのメディア保存フォルダ）に変わります
• 元サイトにあるメディア（写真、ファイル、ビデオなど）のパスが共有ソース側に移行先フォルダ名で書き換えなければならないです

移行方法１：共有ソース側で新規サイトを構築して、Featureモジュールで旧サイトの設定、Node Exportモジュールでコンテンツを移行します

• 共有ソース側で以降先のフォルダ（例：pine ⇒ sites/pine）を作成します
  • defaultフォルダ（sites/default）にあるdefault.settings.phpをコピーして、移行先のフォルダ（pine）にペストし、settings.phpに名前を変更します
  • sites.php（sites/sites.php）設定ファイルに移行元のドメイン名とフォルダ名を関連つけます（設定方法：「Drupalのソースを共有する複数サイトの構築」をご参考）
• 設定されたドメイン名で新サイトへアクセスし、Drupalのインストール手法で新しいサイトを構築します（新しいサイト、移行元のものはなにもない状態）
• モジュール（Feature）で元サイトの設定を移行します(Drupalのモジュール（Feature）を用いてサイト間のデータ移行/開発管理を行いますをご参考)
  • すべての元サイト設定移行はできません。例：テーマの設定が最初からやり直しが必要はあります（結構手間がかかる作業）
• モジュール（Node Export）でコンテンツ（例：Article）を元サイトから出力して、移行先にインポートします
  • 大量なコンテンツがある場合、Drushのコマンドで出力したほうが良いでしょう
  • コンテンツに含まれている画像、ビデオ、ファイルなどのパスを移行先のフォルダ名に合わせて変更しなければならない（今回：sites/default ➡ sites/pine すべてのパスを検索して、変更）
• 元サイトのメディア保存フォルダ(sites/default)にあるすべての内容（settings.php除外）を移行先にフォルダ（sites/pine）にコピーします
• 移行先でファイルシステム設定画面（ホーム » 管理 » 環境設定 » メディア » ファイルシステム）の元サイトと同じファイルパス設定を行います
  

移行方法２：元サイトのDBとメディア保存フォルダを移行先にコピーします

• 元サイトのすべてのものをそのままで移行先にコピーできれば、一番楽です
• 重要なのは、両サイトが側のDrupalバージョン、モジュールバージョンが完全一致していれば、うまく行きます
  • バージョンが合わなければ、移行後にサイトからエラーがでて、完全に動かなくなりことがあります（以下のエラー例で、実は一つのモジュールバージョン差で引き起こされています）
    
  • 移行する前にモジュールのバージョン合わせに十分に気を付ける必要はあります
  • もちろん、移行先にでのモジュールバージョンを変えると、他のサイトにも影響を与えるので、調整が必要となります
• 移行する前に、移行先と移行元のDB、メディアファイルフォルダ（sites/default）の内容をバックアップします（うまく行かなければ、バックアップで戻します）
• 移行するサイトのすべてDBテーブルをSQL文に出力（MySql：mysqldump）します
  • 出力されたファイルにあるすべてのメディア保存フォルダパスを移行先のフォルダパスに書き換えます（sites/default ➡ sites/pine）
    
  • もしドメイン名も変わる場合、新しいドメイン名で古いのを書き換えます
• 移行元のメディア保存フォルダにすべての内容（settings.phpも含む）、移行先にのメディア保存フォルダにコピーします（sites/default ➡ sites/pine）
• 移行先でファイルシステム設定画面（ホーム » 管理 » 環境設定 » メディア » ファイルシステム）の元サイトと同じファイルパス設定を行います
• ブラウザで移行先のページにアクセスし、管理者権限でデータベース更新（http://your-site-domin/update.php）を行います（Drushでも更新可能）
  

結論：新規サイト構築はエラーが少ないが手間がかかります。DBコピーは便利だがエラーが出やすいです。

• 安心で、きれいに移行する場合新規サイトを構築したほうが良いでしょう。多少手間がかかっても、難しいことは少ないです
• DBコピーの方式は上級者向けですね。常にエラーの調査、修正にが必要となります

注意点：Drupalのモジュール（Feeds）の設定が間違うと手動でデータインポートができなくなります

• 環境：Drupal7.54、Feeds7.x-3.0
• やりたいこと：手動でデータをインポート（例：csvファイルからのインポートなど）
• Feedの基本設定のところある二か所をチェックしないと手動でのインポートができない
  • 添付するコンテンツタイプ：スタントアローンのフォームを使う
  • 投稿時にインポート
    
  • 初期としてはこの二つ設定を有効にしています
• ちなみに、「投稿時にインポート」を無効の場合、バッチでデータインポートすることになります（バッチの設定が必要）
• 添付するコンテンツタイプ：「スタントアローンのフォームを使う」以外の選択肢を選択すると、インポート画面（ホーム » インポート）に当該インポーターはありません

手動でインポートできないときに画面上に「インポートされた項目はありません」が表示されます

• 「投稿時にインポート」オプションが無効の場合、手動でデータインポートはできません
• インポートデータがあるにはかかわらず、画面上に「インポートされた項目はありません」として表示されます
• バッチにインポートジョブを入れたメッセージはありません

目的

• Entity Typeデータにほかのデータ（例：ｃｓｖ、xmlなど）からのインポートを可能にする
• Feedsの初期データ変換プロセッサーに「Entity Type」のものがなかった

解決の選択肢

• Feed Importモジュールでのデータインポート
• Feedsモジュールのカスタマイズをする

ここでの解決：Feedsのカスタマイズ

• インストールされたモジュール
  • Feeds :  7.x-2.0
  • ECK  :  7.x-2.0
  • Entity API :  7.x-1.5
• 上記モジュールのインストールと有効化
• ECKでインポートデータタイプとBundleを作成する
  • 例：　データタイプ：「組織データ」、Bundle：「ｘｘｘの組織データ」
  • 「組織データ」のプロパティ：title、uid、created、changedを使用する
  • 「ｘｘｘの組織データ」のフィールド：「組織コード」、「正式組織名」をテキストフィールドで追加

Feedsの紹介

• Feedsが三つの部分から構成される：Fetcher、Parser、Processor
  • Fetcher：インポータデータの取得（例：File upload、external RSS Feedなど）
  • Parser：インポートデータの解析方法の指定（csv、xls、xml、RSSなど）
  • Processor：インポートデータの作成（Node、terms、usersなどのデータ作成）
    

FeedsにEntity Typeデータ変換プロセッサーに追加

• PatchファイルをFeedsモジュールに当てる
• Feedsのデータ変換プロセッサー設定画面にEntity Typeのデータ変換プロセッサー追加前後のイメージ
  

目的

• Entity Typeデータにほかのデータ（例：ｃｓｖ、xmlなど）からのインポートを可能にする
• Feedsの初期データ変換プロセッサーに「Entity Type」のものがなかった

解決の選択肢

• Feed Importモジュールでのデータインポート
• Feedsモジュールのカスタマイズをする

ここでの解決：Feedsのカスタマイズ

• インストールされたモジュール
  • Feeds :  7.x-2.0
  • ECK  :  7.x-2.0
  • Entity API :  7.x-1.5
• 上記モジュールのインストールと有効化
• ECKでインポートデータタイプとBundleを作成する
  • 例：　データタイプ：「組織データ」、Bundle：「ｘｘｘの組織データ」
  • 「組織データ」のプロパティ：title、uid、created、changedを使用する
  • 「ｘｘｘの組織データ」のフィールド：「組織コード」、「正式組織名」をテキストフィールドで追加

Feedsの紹介

• Feedsが三つの部分から構成される：Fetcher、Parser、Processor
  • Fetcher：インポータデータの取得（例：File upload、external RSS Feedなど）
  • Parser：インポートデータの解析方法の指定（csv、xls、xml、RSSなど）
  • Processor：インポートデータの作成（Node、terms、usersなどのデータ作成）
    

FeedsにEntity Typeデータ変換プロセッサーに追加

• PatchファイルをFeedsモジュールに当てる
• Feedsのデータ変換プロセッサー設定画面にEntity Typeのデータ変換プロセッサー追加前後のイメージ
  

Feedsの機能

• いろいろなフォーマットのデータをDrupalのデータ構造（例：ユーザー/ノード/Taxonomyなど）に合わせてインポートする
  • 一対一のコンテンツデータ（例：User -> Userデータ）
  • いろいろなフォーマットデータ（例：RSS/OPML/Atom feeds、csvなど）を各種Drupalのコンテンツ（例：User,Articleなど）データのインポート
  • PubSubHubbub のサポート
• Feeds APIが提供されているので、独自のFetcher,Parser,Processorのプラグインの追加が可能
  
• 基本設定：インポーターの名前、実行タイミングなどの設定
• Fetcher：　インポートするデータ/ファイルのフォーマット、場所などの指定
• Parser：　インポートデータの解析方法の指定
• Processor：　出力するデータのフォーマット/コンテンツ、インポートデータのフィールドマッピングの指定

多言語有効なコンテンツごとに「言語」設定があります

• 背景：Drupal7.55
• 多言語有効なコンテンツに言語設定項目があります
  • 翻訳管理画面では「元言語」、「オリジナル言語」などの表示があります
  • 新規コンテンツ作成画面では「言語」選択項目
  • Feedsのプロセッサー管理画面では「言語」選択項目
    
• この選択肢が一つだけなので、有効化された言語と関係はありますか

翻訳されていないコンテンツ内容を選択された「オリジナル言語」の内容を表示されます

• コンテンツごとに「オリジナル言語」があります。これは「デフォルト言語」と言ってもよいでしょう
• 翻訳されていないフィールドに「オリジナル言語」の内容が表示されます
• オリジナル言語選択の意味は言語翻訳失敗した時の回避策と言ってよいでしょう

「ニュートラル」言語選択された意味ま言語翻訳を行わない

• 言語選択肢に「ニュートラル」があります
• 「ニュートラル」が選択された場合にこのコンテンツの翻訳を行わないことです
• コンテンツの「翻訳」タブがありません