ウォークスルー
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このトピックでは、コンテンツがJSON値のデータを読み取るリクエストを処理するテナントサービスエンドポイント(TSE)の作成方法を示します。
!注 この例の完成した解決策 を含むソースコードとSitecoreパッケージはGitHubからダウンロードできます。
これらの指示に従う前に、テナントサービス(ウェブサービス)を設定し、テナントサービスをData Exchange Frameworkに追加する必要があります。また、同期プロセスを記述したユーザーストーリーを作成するなど、プロバイダーの要件も定義しなければなりません。例えば、以下のユーザーストーリーは、同期プロセスの構築とマッピングを担当する人がリクエストのJSON内容をどのように扱うかを説明しています:
- Matching Conditionを設定するためにリクエストパスを指定することができます。
- JSONコンテンツの値をSitecoreアイテムのフィールドにマッピングできるので、リクエストコンテンツのデータを使ってSitecoreアイテムを作成できます。
このウォークスルーでは、以下の方法を説明します:
- データ交換テナントを作成する
- テナントサービスエンドポイントの追加
- マッチング条件を作成する
- パイプラインをセットしてください
- パイプラインコンテキストビルダーを構築する
プロセスモデリングが完了すると、テナントサービスを使って着信ウェブリクエストを処理し、モデルに応じた同期プロセスを実行できます。
データ交換テナントを作成する
データ交換テナントを作成するには:
- Sitecoreコンテンツエディターで /sitecore/System/Data Exchangeに移動します。
- 新しいテナントを作成するには、 フォルダ タブで 「空のデータ交換テナント」をクリックします。
- 「 テナント名 」欄に、関連するテナント名を入力してください。
- 作成したテナントをテナントサービス機能でアップグレードしてください。
テナントサービスエンドポイントの追加
TSEを追加するには:
-
作成したテナントの下で、Tenant Service Endpointsに移動します。
-
新しいエンドポイントを作成するには、フォルダ タブで「 パイプラインテナントサービスエンドポイント」をクリックします。
-
TSEの名前を入力してください。
!ヒントTSEにはその機能を説明するアイテム名を付けるのがベストプラクティスです。例えば、TSE CRM連絡先をSitecoreに、フォーム でデータをSitecoreに提出するなど、
マッチング条件を作成する
マッチング条件を作成するために:
- テナントの下で Tenant Service Settings/Matching Conditionに移動します。
- 新しいアイテムを作成するには、 フォルダ タブで「 絶対パスマッチング条件 」をクリックし、アイテム名を入力してください。
- 作成された条件の パス フィールドでリクエストパスを設定します。
- 条件オペレーターフィールドで「**包含」**をクリックします。
- テナントサービスエンドポイントに行き、作成した条件を割り当ててください。
例えば、TSEから受信リクエストhttp://
舞台設定
価値
経路
/dosomething/
条件演算子
Contains
パイプラインをセットしてください
パイプラインはデータ交換フレームワーク(DEF)と同じ意味を持ちます。
処理されたリクエストからパイプラインを実行するには:
- 作成したTSE項目については、 パイプライン フィールドにパイプラインを設定します。
!注設定できるパイプラインは一つだけです。
パイプラインコンテキストビルダーを構築する
パイプラインの文脈はDEFと同じ意味を持ちます。
リクエストデータをパイプラインに渡すには、プラグインを通じて渡されたデータを使ってパイプラインコンテキストを構築する必要があります。
パイプラインのコンテキストを構築するために:
-
テナントの下で「 テナントサービス設定/パイプラインコンテキストビルダー」へ移動してください。
-
フォルダタブで、該当するパイプラインコンテキストビルダーをクリックしてください:
Empty Pipeline Context builder
リクエストはパイプラインコンテキストを経由するデータなしで実行できます。つまり、パイプラインのステップはリクエストからのデータを処理する必要がないということです。
パイプラインコンテキストプラグインビルダー
プラグインを作成し、パイプラインコンテキストに追加します。パイプラインコンテキストは選択したパイプラインで使用されます。リクエストの値を変換し、変換された値を割り当てられたプラグインリーダーに渡すことができます。割り当てられたすべてのプラグインはパイプラインコンテキストに追加されます。
-
Pipeline Context Plugin Builderを使用する場合、DEFで2つの数値リーダーを指定する必要があります:
バリュートランスフォーマー
リクエストの読み取りデータが割り当てられたプラグインリーダーに渡される前に、リクエストからデータを読み取ります。
プラグインリーダー
複数のプラグインリーダーを割り当て、読み取り値が型 IPluginである必要があります。すべてのプラグインは新たに作成されたパイプラインコンテキストに追加されます。