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

チュートリアル: データの読み取りと書き込みを行うコンポーネントの作成

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

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

このチュートリアルは、テキスト ファイルからSitecoreへのデータの同期チュートリアル シリーズの パート2であり、テキスト ファイルからデータを読み取り、Sitecoreに書き込むために必要なコンポーネントを作成する方法について説明します。

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

  • ソースファイルのエンドポイントを追加します。

  • ソース・ファイルの値アクセサのセットを追加します。

  • 対象アイテムのエンドポイントを追加します。

  • ターゲット項目の値アクセサのセットを追加します

  • 値マッピングを追加します。

ソース ファイルのエンドポイントを追加する

エンドポイントを使用して、読み取られるテキストファイルを識別します。

ソースファイルのエンドポイントを追加するには:

  1. コンテンツ エディターで、/sitecore/System/Data Exchange/File System Provider Test Tenant/Endpoints/Providersに移動します。

  2. 新しいテンプレートを追加するには、右側のペインのFolderタブでFile System Endpointsをクリックします。

    メモ

    このテンプレートはコマンド テンプレートです。アイテム名の入力は求められません。コマンド テンプレートによって、アイテムの名前が自動的にFile Systemという名前が割り当てられます。

  3. 新しいFile Systemフォルダに移動します。右側のウィンドウのFolderタブで、Text File Endpointをクリックし、次の項目を追加します。

    テンプレート

    Text File Endpoint

    名前

    City Information File

  4. 新しいCity Information Fileエンドポイントを選択します。

    City Information File text file endpoint in the content tree

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

    畑

    価値

    Path

    C:\Sitecore\cities.dat

    Column Separator

    ,

  6. アイテムを保存します。

ソース ファイルの値アクセサのセットを追加します

ソース ファイルから値を読み取るには、値ごとに値アクセサを作成する必要があります。各値アクセサーは、ソース ファイル内の行の特定の値を表します。関連する値アクセサを値アクセサ セットにグループ化し、値アクセサ セットには1つ以上の値アクセサを含めることができます。

テナントの下では、値アクセサー セットはプロバイダー別に整理されます。新しいプロバイダーの値アクセサー セットを保持するフォルダーを作成する必要があります。次に、ソース ファイルの行から読み取るすべての値を表す値アクセサ セットを作成します。値アクセサ セットでは、ソース ファイルのデータ行から個々の値を読み取ることができる値アクセサを作成します。

値アクセサを含む値アクセサ セットを追加するには、次のようにします。

  1. コンテンツ エディターで、/sitecore/System/Data Exchange/File System Provider Test/Data Access/Value Accessor Sets/Providersに移動します。

  2. 新しいセットを追加するには、右側のペインのFolderタブで、File System Value Accessor Setsをクリックします。

    手記

    このテンプレートはコマンド テンプレートです。アイテム名の入力は求められません。コマンド テンプレートによって、アイテムの名前が自動的にFile Systemという名前が割り当てられます。

  3. 値アクセサ セットを作成するには、新しいFile Systemフォルダに移動します。右側のペインのFolderタブで、Array Value Accessor Setをクリックします。新しいアイテムにCity Information File Fieldsという名前を付けます。

  4. 値アクセサを作成するには、コンテンツ ツリーで新しいCity Information File Fields項目に移動します。右側のペインのFolderタブで、Array Value Accessorをクリックします。新しいアイテムにIdentifier from City Information Fileという名前を付けます。

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

    畑

    価値

    Position

    0

  6. アイテムを保存します。

  7. 手順1から3を繰り返して、さらに2つの配列値アクセサ項目を追加します。

    アイテム名

    位置の値

    Country from City Information Item

    1

    City from City Information Item

    2

対象項目のエンドポイントを追加する

エンドポイントを使用して、Sitecoreアイテムが作成されるSitecoreデータベースを識別します。

エンドポイントを追加するには:

  1. コンテンツ エディターで、/sitecore/System/Data Exchange/File System Provider Test Tenant/Endpoints/Providersに移動します。

    Providers folder in the content tree

  2. 右側のペインで、Sitecore Endpointsをクリックします。

    手記

    このテンプレートはコマンド テンプレートです。アイテム名の入力は求められません。コマンド テンプレートは、アイテム名を自動的に割り当てます。

  3. 新しいアイテムを選択します。

    Sitecore endpoints folder in the content tree

  4. 右側のペインで、Sitecore Item Model Repository Endpointをクリックします。新しいアイテムにSitecore Database Endpointという名前を付けます。

ターゲット項目の値アクセサのセットを追加します

ターゲット オブジェクトとして機能するSitecoreアイテム (ターゲット アイテム) に値を書き込むには、各アイテムのテナントに値アクセサーを作成する必要があります。各値アクセサは、ターゲット項目に使用されるテンプレート上の特定のフィールドを表します。関連する値アクセサをグループ化して、ソースから読み取るすべての項目を表す値アクセサ セットにします。値アクセサ セットは、データ プロバイダの下のフォルダに整理します。

ターゲット項目の値アクセサを追加するには、次のようにします。

  1. 値アクセサ セットのフォルダを作成するには、コンテンツ エディタで /sitecore/System/Data Exchange/File System Provider Test Tenant/Data Access/Value Accessor Sets/Providersに移動します。

    Providers folder in the content tree

  2. 右側のペインで、Sitecore Value Accessor Setsをクリックします。

    手記

    このテンプレートはコマンド テンプレートです。アイテム名の入力は求められません。コマンド テンプレートは、アイテム名を自動的に割り当てます。

  3. 値アクセサ セットを作成するには、コンテンツ エディタでSitecoreプロバイダに移動します。

    Sitecore provider in the content tree

  4. Folderタブで、Sitecore Item Field Value Accessor Setをクリックして新しいアイテムを作成し、「 City Information Item Fields」という名前を付けます。

  5. 値アクセサを作成するには、コンテンツ エディタでCity Information Item Fieldsアイテムに移動します。

    City Information Item Fields value accessor set in the content tree

  6. 右側のペインのFolderタブで、Sitecore Item Field Value Accessorをクリックして新しいアイテムを作成し、Identifier on City Information Itemという名前を付けます。

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

    畑

    価値

    Field

    Templates/User Defined/City Information/Data/Identifier

  8. アイテムを保存します。

  9. 手順6から8を繰り返して、さらに2つのSitecore Item Field Value Accessorフィールドを追加します。

    フィールド名

    フィールド値

    Country on City Information Item

    Templates/User Defined/City Information/Data/Country

    City on City Information Item

    Templates/User Defined/City Information/Data/City

値マッピングを追加する

値マッピングを使用して、ソース・オブジェクトの値アクセッサをターゲット・オブジェクトの値アクセサに関連付けます。関連する値マッピングは、値マッピング セットの下にグループ化されます。

この例では、テキスト ファイルの行からSitecoreアイテムにマッピングする必要があるすべての値を表す値マッピング セットを作成します。次に、Identifier、Country、およびCity Sitecoreアイテムの値マッピングを作成します。これらのマッピングは、テキスト ファイルから値を読み取るために使用する値アクセサーと、対応するSitecoreアイテムに値を書き込むために使用する値アクセサーを関連付けます

値マッピングを使用して値マッピング・セットを作成するには:

  1. 値マッピング セットを作成するには、コンテンツ エディタで /sitecore/System/Data Exchange/File System Provder Test Tenant/Value Mapping Setsに移動します。

    Value Mapping Sets folder in Tenant Settings in the content tree

  2. 右側のペインのFolderタブで、Value Mapping Setをクリックします。名前を付けます Row from City Information File to City Information Item

  3. 値マッピングを作成するには、コンテンツ ツリーで、新しい値マッピング セットに移動します。

    Row from City Information File to City Information Item value mapping set item in Value Mapping Sets folder in Content tree

  4. 右側のペインのFolderタブで、Value Mappingをクリックします。新しいアイテムにIdentifierという名前を付けます。コンテンツ ツリーで新しいアイテムを選択します。

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

    畑

    価値

    Source Accessor

    Data Access/Value Accessor Sets/Providers/File System/City Information File Fields/Identifier from City Information File

    Target Accessor

    Data Access/Value Accessor Sets/Providers/Sitecore/City Information Item Fields/Identifier on City Information Item

    Source and target accessor fields.

  6. アイテムを保存します。

  7. 手順4から7を繰り返して、次の値マッピングを追加します。

    名前

    ソース アクセサー

    ターゲット アクセサー

    Country

    Data Access/Value Accessor Sets/Providers/File System/City Information File Fields/Country from City Information File

    Data Access/Value Accessor Sets/Providers/Sitecore/City Information Item Fields/Country on City Information Item

    City

    Data Access/Value Accessor Sets/Providers/File System/City Information File Fields/City from City Information File

    Data Access/Value Accessor Sets/Providers/Sitecore/City Information Item Fields/City on City Information Item

この記事を改善するための提案がある場合は、 お知らせください!