8.0
  1. データ交換フレームワークの利用

ウォークスルー

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

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

このトピックでは、Experience Formsのカスタムデータ交換フレームワーク(DEF)セーブアクションを設定する方法の例を示します。

このウォークスルーでは、以下の方法を説明します:

  • フォームを作成する
  • テナントを作成する
  • 値アクセスツールを作成する
  • パイプラインの作成
  • 価値を創造する読者
  • パイプラインコンテキストビルダーの作成
  • テナントサービスエンドポイントの作成
  • フォームの設定をしてください。

フォームを作成する

ウェブサイトの訪問者がウェブサイト上でフォームを送信すると、保存アクションがトリガーされます。

フォームを作成するには:

  1. Sitecore Formsのフォームダッシュボードで 「作成」をクリックします。フォームの基にするテンプレートを選択します。

  2. フォーム要素ペインから要素をフォームにドラッグして、少なくとも1つのフィールドを追加してください。

  3. ツールバーで 「保存 」をクリックしてフォームを保存し、名前を付けます。

    !注必要に応じてフォームデザイナーを使って、さまざまなフォーム要素を使って フォームのデザインを 続けることができます。

  4. ウェブページでフォームを利用可能にするには、「 ウェブページにフォームを追加」の指示に従ってください。

!注Sitecoreスケールドデプロイメント(XP1)を行っている場合、フォームの .cshtmlファイルがコンテンツデリバリー(CD)サーバーにコピーされていることを確実にしてください。例えば、\Views\Shared\.cshtml。

テナントを作成する

テナントはセーブアクションのために設定しなければならない設定のコンテナです。

テナントを作成するには:

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

  2. フォルダタブで「空のデータ交換テナント」をクリックします。

  3. 作成したテナントを選択し、上部メニューバーのData Exchange SDKタブをクリックします。リボンの上で 「テナントをアップグレードする」をクリックします。

  4. テナント のアップグレード ダイアログの命令 セット 欄で「 テナントサービス」をクリックします。

  5. テナントのIDをメモしてください。 <tenant service>\App_Config\ConnectionStrings.configファイルの接続文字列Sitecoreに、テナントID、ホスト、認証情報を追加します。例えば:

    !注Sitecoreスケールドデプロイ(XP1)を行っている場合は、データベースパラメータをWebに変更し、ホストパラメータをCDサーバーのURLに変更してください。

  6. Sitecoreコンテンツ管理サーバーのApp_Config\connectionstring.configファイルに、そのテナントのウェブサービスに関連付けられた接続文字列があることを確認してください。例えば:

    <xmlversion="1.0" encoding="utf-8">

  7. Sitecoreスケールドデプロイメント(XP1)の場合は、CDサーバーのconnectionstring.configファイルにもテナントサービスの接続文字列を追加する必要があります。

値アクセスツールを作成する

値のアクセルは、フォームのフィールドの値を読み取ります。バリューアクセサはバリューアクセサセットに集められます。

値アクセスを作成するには:

  1. /data access/value accessor set/providersへ移動してください。すでにFormsフォルダがある場合は開いてください。もしなければ、フォルダタブでForms Value Accessor SetをクリックしてFormsフォルダを作成・開いてください。

  2. Formsフォルダのフォルダタブで**「フォーム 値 アクセルセット**」をクリックして新しいアイテムを作成します。例えば「*フォームに連絡する」*と名付けてください。

    Get in touch form element in the content tree

  3. 作成したアイテムを選択し、「 コンテンツ 」タブに切り替えます。作成したフォームを選択してアイテムを保存します。

    Settings section on the Content tab on the Get in touch form item

  4. 上部メニューバーで 「データ交換」をクリックし、「 フォームフィールドを追加」をクリックします。

    Add Form Fields button on the Data Exchange tab on the menu ribbon

  5. 値のアクセルを作成するには、読みたい値のフォームフィールドを選択し、OKをクリックします。

    Form field value accessors dialog

    値のアクセス器は値のアクセス器セット項目の下に位置します。

    Full name value accessor under the Get in touch form item in the content tree

パイプラインの作成

パイプラインは、アクションを実行する個々のプロセスであるパイプラインステップを収集・整理します。

パイプラインを作成するには:

  1. /pipelinesへアクセスしてください。

  2. 右側のペインの フォルダ タブで 「パイプライン」をクリックします。例えば、Form Testing Pipelineと名付けてください。

  3. フォルダタブで「Write to Log Pipeline Step」をクリックすると、新しいパイプラインステップを作成できます。例えば「Write to Log Pipeline Step」と名付けてください。

  4. パイプラインステップを選択し、フル ネーム 値のアクセクターを次のように設定します:

    Configuring the value accessor on the Write to Log Pipeline Step dialog

  5. 変更を保存してください。

価値を創造する読者

フォーム内のフィールドの値を読むために値リーダーを使って読みます。

価値ある読者を生み出すために:

  1. /data access/value readers/Common/ に移動します。

  2. ホームタブで新しいアイテムを作成するには、HttpRequest Content Value ReaderからDot Net Objectをクリックしてください。例えば、FormModel From Http Contentと名付けてください。

  3. タイプフィールドをSitecoreに設定します。DataExchange.ExperienceForms.Models.FormModel, Sitecore.DataExchange.ExperienceForms.Models.

    The Type field in the Settings section for the FormModel From Http Content item

  4. /data access/value readers/Common/ に移動します。

  5. フォルダタブで**「生の値リーダー**」をクリックして新しいアイテムを作成します。例えば、名前をRaw Value Reader。

  6. /data access/value readers/Common/ に移動します。

  7. フォルダタブで「同期設定プラグイン値リーダー」をクリックして新しいアイテムを作成します。「同期設定プラグイン値リーダー」と名付けてください。

  8. ストレージの場所をSourceに設定してください。

    The Storage Location field in the Setting section for the Synchronization Settings Plugin Value Reader item

  9. 変更を保存してください。

パイプラインコンテキストビルダーの作成

パイプラインコンテキストビルダーコンポーネントは、適切な形式でリクエストデータを抽出し、パイプラインコンテキストを構築し、リクエストからデータのコンテキストを提供します。

パイプラインコンテキストビルダーを作成するには:

  1. /テナントサービス設定/パイプラインコンテキストビルダーへ移動してください。

  2. フォルダタブで「パイプラインコンテキストプラグインビルダー」をクリックして新しいアイテムを作成します。例えば、Pipeline Context Plugin Builderと名前を付けます。

  3. Value Transformerフィールドを、前のステップで作成したhttpリクエスト値リーダーに設定してください。

  4. Plugin Readersフィールドを、前のステップで作成した同期設定のプラグイン値リーダーに設定してください。

    The Plugin Readers field in the Content tab of the Pipeline Context Plugin Builder item

  5. 変更を保存してください。

テナントサービスエンドポイントの作成

DEFパイプラインを通じてリクエストデータをプッシュするためには、受信リクエストを解決するためにテナントサービスエンドポイント(TSE)が必要です。

テナントサービスエンドポイントを作成するには:

  1. /Tenant Service Endpointsへ移動してください。

  2. フォルダタブで「パイプラインテナントサービスエンドポイント」をクリックして新しいアイテムを作成します。例えば「フォーム提出エンドポイント」と呼びます。

  3. エンドポイントは以下の表のパラメータで設定します:

    パラメータ

    内容

    リクエスト値リーダー

    Value Readers/Common/Raw Value Reader

    パイプラインコンテキストビルダー

    パイプラインコンテキストビルダー/パイプラインコンテキストプラグインビルダー

    パイプライン

    Pipelines/Form Testing Pipeline

  4. 有効にするチェックボックスを選択してください。変更を保存してください。

フォームの設定

ユーザーがフォームを保存した際にテナントサービスエンドポイントをトリガーするようにフォームを設定する必要があります。

フォームの設定:

  1. Sitecore Launchpadで 「フォーム 」をクリックし、作成したフォームを選択します。

  2. フォームの 「送信 」ボタンを選択してください。 「一般 」タブの 「アクション提出 」セクションでプラス記号をクリックすると、アクションのリストが表示されます。リスト内で**「DEF 同期プロセスをトリガー**」をクリックすると、送信アクションを追加できます。

    The Trigger DEF Sync Process option in the list of Submit actions

  3. 「 テナントサービスエンドポイント選択 」ダイアログのData Exchange構造で、フォーム提出時にトリガーしたいテナントサービスエンドポイントを選択します。

  4. 接続文字列名フィールドに、テナントWebサービスのURLを指す接続文字列を入力します。

    The Select the tenant service endpoint dialog

  5. フォームをウェブページに添付して公開します。ユーザーがフォームを提出すると、テナントサービスエンドポイントが選択したパイプラインを実行します。

プロセスをトラブルシューティングしたい場合は、テナントサービスのログを確認してください。

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