テキストファイルからSitecoreへのデータの同期チュートリアルシリーズ

チュートリアル: パイプラインの作成と実行

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このチュートリアルは、テキストファイルからSitecoreへのデータの同期チュートリアルシリーズのパート3であり、テキストファイルとSitecoreの間でデータ同期を実行できるパイプラインを作成する方法について説明します。

このチュートリアルでは、次の方法について説明します。

ソースファイルを読み取るパイプラインを追加します。
パイプラインステップを追加して、ソースファイルからデータを読み取る。
パイプラインステップを追加して、ソースファイルから読み取られたデータを反復処理します。
ソースファイルから1つの行を同期するパイプラインを追加します。
パイプラインステップを追加して、ターゲット項目を解決します。
マッピングを適用するパイプラインステップを追加します。
パイプラインステップを追加して、ターゲット項目を更新します。
パイプラインバッチを追加する
パイプラインバッチのテスト

ソースファイルを読み取るパイプラインを追加する

テキストファイルからデータを読み取り、データを反復処理し、1行のデータを処理するパイプラインにデータを渡すパイプラインを実装する必要があります。

ソースファイルを読み取るパイプラインを追加するには:

コンテンツエディターで、/sitecore/System/Data Exchange/File System Provider Test Tenant/Pipelinesに移動します。
右側のペインで、Pipelineをクリックします。新しいアイテムにRead City Info from File Pipelineという名前を付けます。
新しいアイテムをPipelinesフォルダの最初の位置にドラッグアンドドロップします。

メモ

フォルダ内のパイプラインの順序は重要ではありません。ただし、パイプラインが別のパイプラインを呼び出す場合は、他のパイプラインを呼び出すパイプラインを、呼び出すパイプラインの前に配置すると便利です。

ソースファイルからデータを読み取るパイプラインステップを追加する

テキストファイルエンドポイントで指定されたテキストファイルからデータを読み取ることができるパイプラインステップを構成する必要があります。また、パイプラインステップでは、後続のパイプラインステップがデータにアクセスできる場所にデータへのポインターを配置する必要があります。

ソースファイルからデータを読み取るパイプラインステップを追加するには:

コンテンツエディターで、パイプラインアイテム ( Read City Info from File Pipelineなど) に移動します。
右側のペインで、Read Text File Pipeline Stepをクリックします。新しいアイテムにRead Text Fileという名前を付けます。
コンテンツツリーで、新しいアイテムを選択します。

右側のペインで、次のフィールド値を指定します。

畑	価値
Endpoint From	File System/City Information File

アイテムを保存します。

パイプラインステップを追加して、ソースファイルから読み取られたデータを反復処理します

このパイプラインの最初の手順では、後続のパイプラインステップがアクセスできる場所へのポインターを追加します。2番目の手順では、テキストファイルから読み取られた行を反復処理し、データを処理する他のパイプラインにデータを渡すことができるように、データにアクセスするように構成する必要があります。

パイプラインステップを追加してデータを反復処理するには:

コンテンツエディタで、パイプラインアイテムCity Info from File to City Info Item Sync Pipelineに移動します。
右側のペインで、Iterate Data and Run Pipelines Pipeline Stepをクリックします。新しいアイテムにIterate Rows from Text File and Run Pipelineという名前を付けます。
コンテンツツリーで、新しいアイテムを選択します。

右側のペインのSettingsセクションで、次のフィールド値を指定します。

畑	価値
Pipelines	Pipelines/City Info from File to City Info Item Sync Pipeline
Iterable Data Location	Pipeline Context Iterable Data
Data Location	Pipeline Context Source

アイテムを保存します。
新しいアイテムをPipelinesフォルダーの2番目の位置にドラッグアンドドロップします。

ソースファイルから1つの行を同期するパイプラインを追加する

モデル化する同期プロセスは、2つのパイプラインで構成されます。最初のパイプラインは、ソースオブジェクト (テキストファイル) からデータを読み取ります。2番目のパイプラインは、テキストファイルの1つの行を処理します。

最初のパイプラインは2番目のパイプラインを呼び出すため、最初のパイプラインを構成する前に2番目のパイプラインを構成する必要があります。

テキストファイルから1つの行を処理するパイプラインを追加するには:

コンテンツエディターのコンテンツツリーで、テナントを選択します。 Pipelinesに移動します。
右側のウィンドウのFolderタブで、Pipelineをクリックして新しいアイテムを追加し、City Info from File to City Info Item Sync Pipelineという名前を付けます。

パイプラインステップを追加して、ターゲット項目を解決する

最初のパイプラインステップでは、テキストファイル行の値と一致する既存のSitecoreアイテムがあるかどうかを確認する必要があります。

パイプラインで一致する項目が見つかった場合は、その項目をパイプラインコンテキストのターゲットオブジェクトとして設定する必要があります。つまり、マッピングプロセス中に、パイプラインは一致する項目を新しい値で更新します。

パイプラインで一致するアイテムが見つからない場合は、新しいアイテムを作成し、パイプラインコンテキストで新しいアイテムをターゲットオブジェクトとして設定する必要があります。

パイプラインでこれらのアクションを設定するには:

コンテンツエディタで、ステップを作成するパイプラインアイテム ( City Info from File to City Info Item Sync Pipelineなど) に移動します。
右側のペインで、Resolve Sitecore Item Pipeline Stepをクリックします。新しいアイテムにResolve City Info Itemという名前を付けます。新しいアイテムを選択します。

右側のペインで、次のフィールド値を指定します。

畑	価値
Template for New Item	Templates/User Defined/City Information
Item Name Value Accessor	Data Access/Value Accessor Sets/Providers/File System/City Information File Fields/City from City Information File
Endpoint From	Sitecore/Sitecore Database Endpoint
Identifier Value Accessor	Data Access/Value Accessor Sets/Providers/File System/City Information File Fields/Identifier from City Information File
Identifier Object Location	Pipeline Context Source
Resolved Object Location	Pipeline Context Target
Parent for Item	sitecore/content/Cities
Matching Field Value Accessor	Data Access/Value Accessor Sets/Providers/Sitecore/City Information Item Fields/Identifier on City Information Item

アイテムを保存します。

パイプラインステップを追加してマッピングを適用する

このパイプラインの最初のステップでは、既存のアイテムを検索するか、新しいアイテムを作成することで、ターゲットオブジェクトが使用可能であることを確認します。2番目の手順では、「値マッピングの追加」で設定した値マッピングセットを使用して、ソースオブジェクトからターゲットオブジェクトに値をマッピングする必要があります。

マッピングを適用するパイプラインステップを追加するには:

パイプラインアイテムCity Info from File to City Info Item Sync Pipelineに移動します。
右側のペインで、Apply Mapping Pipeline Stepをクリックします。新しいアイテムにApply Mappingという名前を付けます。新しいアイテムを選択します。

右側のペインで、次のフィールド値を設定します。

畑	価値
Mapping Set	Value Mapping Sets/Row from City Information File to City Information Item

アイテムを保存します。
アイテムをパイプラインの2番目の位置にドラッグアンドドロップします。

パイプラインステップを追加して、ターゲット項目を更新する

マッピングが適用された後、ターゲットアイテムへの変更をSitecoreデータベースに保存する必要があります。

パイプラインステップを追加してターゲットアイテムを更新するには:

コンテンツエディターで、ステップを追加するパイプラインアイテム ( City Info from File to City Info Item Sync Pipelineなど) に移動します。
右側のペインで、Update Sitecore Item Pipeline Stepをクリックします。新しいアイテムに名前を付けます (例: Update Sitecore Item)。新しいアイテムを選択します。

右側のペインで、次のフィールド値を指定します。

畑	価値
Item Location	Pipeline Context Target
Endpoint To	Sitecore/Sitecore Database Endpoint

アイテムを保存します。
新しい項目をパイプラインの3番目の位置にドラッグアンドドロップします。

パイプラインバッチを追加する

パイプラインを実行するには、パイプラインバッチを構成する必要があります。これは基本的にパイプラインのランタイムです。

パイプラインバッチを設定するには:

コンテンツエディターで、/sitecore/System/Data Exchange/File System Provder Test Tenant/Pipeline Batchesに移動します。
右側のペインで、Pipeline Batchをクリックします。新しいアイテムに名前を付けます (例: City Info from File to City Info Item Sync Pipeline Batch)。
コンテンツツリーで、新しいアイテムを選択します。

右側のペインで、次のフィールド値を指定します。

畑	価値
Pipelines	Pipelines/Read City Info from File Pipeline

アイテムを保存します。

パイプラインバッチのテスト

パイプラインバッチは、さまざまな方法で実行できます。最も簡単な方法は、手動で実行することです。

パイプラインバッチをテストするには:

コンテンツエディターで、/sitecore/System/Data Exchange/File System Provder Test Tenant/Pipeline Batches/City Info from File to City Info Item Sync Pipeline Batchに移動します。
リボンのRun Pipeline Batchをクリックします。
「 OK」をクリックします。

手記

この例では、テキストファイルには数行しか含まれていません。さらに、パイプラインのロジックは非常に限られています。これは、パイプラインバッチがほぼ瞬時に終了することを意味します。

パイプラインバッチが実行されているかどうかは、Stop Pipeline Batchボタンが有効になっているかどうかを確認することで確認できます。このボタンは自動的に更新されないため、パイプラインバッチをクリックしてUIを更新する必要がある場合があります。
コンテンツツリーで、/sitecore/content/Citiesに移動します。

テキストファイル内の各行の項目を表示できます。
レビューするアイテム ( Copenhagenアイテムなど) をクリックします。アイテムに対応するテキストファイル内の行の値を確認できます。