1. Data Exchange Frameworkの使用

チュートリアル: テナント サービス エンドポイントの実装

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

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

このトピックでは、コンテンツがJSON値であるデータの読み取り要求を処理するテナント サービス エンドポイント (TSE) を作成する方法について説明します。

メモ

ソース コードと 、この例の完成したソリューション を含むSitecoreパッケージをGitHubからダウンロードできます。

これらの手順を実行する前に、テナント サービス (Webサービス) を設定し、テナント サービスをData Exchange Frameworkに追加する必要があります。また、同期プロセスを記述するユーザー ストーリーを作成するなどして、プロバイダの要件を定義する必要もあります。たとえば、次のユーザーストーリーでは、同期プロセスの構築とマッピングの責任者がリクエストのJSONコンテンツをどのように処理できるかを説明しています。

  • I can specify a request path一致条件を設定するには。

  • I can map the value from JSON content to a field on a Sitecore itemを使用して、リクエスト コンテンツのデータを使用してSitecoreアイテムを作成できます。

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

  • データ交換テナントを作成する

  • テナント サービス エンドポイントの追加

  • 一致条件を作成する

  • パイプラインを設定する

  • パイプライン コンテキスト ビルダーを構築する

プロセスモデリングが完了すると、テナントサービスを使用して、モデルに従って受信するWebリクエストを処理し、同期プロセスを実行できます。

データ交換テナントを作成する

データ交換テナントを作成するには:

  1. Sitecoreコンテンツ エディターで、/sitecore/System/Data Exchangeに移動します。

  2. 新しいテナントを作成するには、FolderタブでEmpty Data Exchange Tenantをクリックします。

  3. Tenant Nameフィールドに、関連するテナント名を入力します。

  4. 作成したテナントをテナントサービス機能でアップグレードします。

テナント サービス エンドポイントの追加

TSEを追加するには:

  1. 作成したテナントの下で、Tenant Service Endpointsに移動します。

  2. 新しいエンドポイントを作成するには、FolderタブでPipeline Tenant Service Endpointをクリックします。

  3. TSEの名前を入力します。

    先端

    TSEには、その機能を説明する項目名を付けることをお勧めします。たとえば、TSEにCRM Contact to SitecoreやForm submitted data to Sitecoreという名前を付けます。

一致条件を作成する

一致条件を作成するには:

  1. テナントの下で、Tenant Service Settings/Matching Conditionに移動します。

  2. 新しい項目を作成するには、FolderタブでAbsolute Path Matching Conditionをクリックし、項目の名前を入力します。

  3. created条件のPathフィールドで、要求パスを設定します。

  4. Condition Operatorフィールドで、Containsをクリックします。

  5. テナント サービス エンドポイントに移動し、作成した条件を割り当てます。

たとえば、受信リクエストhttp://<tenantservice>/api/tenantservice/dosomething/?<query>に対してTSEからパイプラインを実行するには、次の設定で一致条件を設定します。

設定

価値

パス

/dosomething/

条件演算子

Contains

パイプラインを設定する

パイプラインは、データ交換フレームワーク (DEF) と同じ意味を持ちます。

処理されたリクエストからパイプラインを実行するには:

  • 作成したTSEアイテムについて、Pipelineフィールドにパイプラインを設定します。

手記

設定できるパイプラインは1つだけです。

パイプライン コンテキスト ビルダーを構築する

パイプライン コンテキストは、DEFと同じ意味を持ちます。

リクエストデータをパイプラインに渡すには、プラグインを介して渡されるデータを使用してパイプラインコンテキストを構築する必要があります。

パイプライン コンテキストを構築するには:

  1. テナントの下で、Tenant Service Settings/Pipeline Context Buildersに移動します。

  2. Folderタブで、関連するパイプライン コンテキスト ビルダーをクリックします。

    Empty Pipeline Context builder

    リクエストは、パイプラインコンテキストを経由するデータを渡さずに実行できます。つまり、パイプライン ステップを含むパイプラインでは、要求からのデータを処理する必要はありません。

    Pipeline Context Plugin Builder

    プラグインを作成し、パイプライン コンテキストに追加します。パイプライン コンテキストは、選択したパイプラインで使用されます。リクエストから値を変換し、変換された値を割り当てられたプラグインリーダーに渡すことができます。割り当てられたすべてのプラグインがパイプライン コンテキストに追加されます。

  3. Pipeline Context Plugin Builderを使用する場合は、DEFで2つの値リーダーを指定する必要があります。

    Value Transformer

    リクエストから任意のデータを読み取り、その読み取りデータが割り当てられたプラグインリーダーに渡されます。

    Plugin Readers

    複数のプラグインリーダーを割り当てることができ、読み取り値はIPluginタイプである必要がある。すべてのプラグインは、新しく作成されたパイプライン コンテキストに追加されます。

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