チュートリアル: カスタム ファセットとイベントの作成
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このチュートリアルは、xConnectコレクション モデルの拡張チュートリアル シリーズのパート5です。このチュートリアルを完了するには、まずチュートリアル パート1、2、3、および4を完了する必要があります。
このチュートリアルでは、Sitecore Cinemaを使用し、訪問者から情報を収集するためにコレクション モデルを拡張する必要があります。この情報は、訪問者が映画館の1つとやり取りするたびにポイントカードをスワイプすることに依存しており、訪問のインセンティブとして、ポイントカードを10回使用すると無料のポップコーンを提供します。
このチュートリアルでは、次の方法について説明します。
-
SitecoreCinemaソリューションとクラス ライブラリ プロジェクトを作成する
-
CinemaInfoインタラクションファセットクラスの作成
-
CinemaVisitorInfoコンタクト ファセット クラスを作成する
-
WatchMovie結果項目を作成する
-
WatchMovie結果クラスを作成する
-
BuyConcessions結果項目を作成する
-
BuyConcessions結果クラスを作成する
-
UseSelfServiceイベントアイテムを作成する
-
UseSelfServiceイベント クラスを作成する
-
SitecoreCinemaModelコレクション モデル クラスを作成する
-
Console.Deployコンソール アプリ プロジェクトを作成する
-
SitecoreCinemaModelコレクションモデルをシリアル化する
-
Console.Journeyコンソール アプリ プロジェクトを作成する
-
Sitecore Cinemaの訪問をシミュレートする
SitecoreCinemaソリューションとクラス ライブラリ プロジェクトを作成する
SitecoreCinemaソリューションとクラス ライブラリ プロジェクトを作成するには、次のようにします。
-
Visual Studioで、管理者特権を使用して、.NET Framework用の新しいソリューションとクラス ライブラリ プロジェクトを作成します ( SitecoreCinema)。

-
ソリューション エクスプローラーで、SitecoreCinema/Referencesを右クリックし、Add Referenceをクリックします。
-
Reference Managerウィンドウで、「Browse」をクリックし、<xConnect instance>\bin\フォルダから次の参照を追加します。
-
Sitecore.XConnect.Collection.Model.dll
-
Sitecore.XConnect.Core
-
Sitecore.XConnect.dll
-
-
「 OK」をクリックします。
CinemaInfoインタラクション ファセット クラスを作成する
CinemaInfoクラスは、インタラクション中に訪れた映画館に関する情報を含むインタラクションファセットです。
CinemaInfoインタラクションファセットクラスを作成するには:
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaプロジェクトを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 CinemaInfo.cs 」と入力し、Addをクリックします。
-
-
CinemaInfo.csファイルで、内容を次のコードで置き換えます。
-
CinemaInfo.csファイルを保存します。
CinemaVisitorInfo連絡先ファセット クラスを作成する
CinemaVisitorInfoクラスは、ロイヤルティIDなど、訪問者に関する情報を含む連絡先ファセットです。
CinemaVisitorInfoコンタクトファセットクラスを作成するには:
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaプロジェクトを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 CinemaVisitorInfo.cs 」と入力し、Addをクリックします。
-
-
CinemaVisitorInfo.csファイルで、内容を次のコードで置き換えます。
-
CinemaVisitorInfo.csファイルを保存します。
WatchMovie結果項目を作成する
WatchMovie結果アイテムを作成するには:
-
マーケティングコントロールパネルで、「 Marketing Control Panel/Outcomes」をクリックします。
-
Optionsパネルで、Outcome Definitionをクリックします。
-
Messageウィンドウで、「WatchMovie」と入力し、「OK」をクリックします。
-
Quick Infoセクションで、アイテムIDをメモします。
WatchMovie結果クラスを作成する
WatchMovie結果クラスは、訪問者が映画のチケットを購入したときに、POSシステムからWatchMovie結果アイテムをトリガーします。
WatchMovie結果クラスを作成するには、次のようにします。
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaプロジェクトを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 WatchMovie.cs 」と入力し、Addをクリックします。
-
-
WatchMovie.csファイルで、内容を次のコードで置き換えます。
-
WatchMovie結果項目IDを挿入します。
-
WatchMovie.csファイルを保存します。
BuyConcessions結果アイテムを作成する
BuyConcessions結果アイテムを作成するには:
-
マーケティングコントロールパネルで、「 Marketing Control Panel/Outcomes」をクリックします。
-
Optionsパネルで、Outcome Definitionをクリックします。
-
Messageウィンドウで、「BuyConcessions」と入力し、「OK」をクリックします。
-
Quick Infoセクションで、アイテムIDをメモします。
BuyConcessions結果クラスを作成する
BuyConcessions結果クラスは、訪問者が割引を購入するときに、POSシステムからBuyConcessions結果アイテムをトリガーします。
BuyConcessions結果クラスを作成するには、次のようにします。
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaプロジェクトを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 BuyConcessions.cs 」と入力し、Addをクリックします。
-
-
BuyConcessions.csファイルで、内容を次のコードで置き換えます。
-
BuyConcessions結果項目IDを挿入します。
-
BuyConcessions.csファイルを保存します。
UseSelfServiceイベント項目を作成する
UseSelfServiceイベントアイテムを作成するには:
-
マーケティングコントロールパネルで、「 Marketing Control Panel/Events」をクリックします。
-
Optionsパネルで、Eventをクリックします。
-
Messageウィンドウで、「UseSelfService」と入力し、「OK」をクリックします。
-
Quick Infoセクションで、アイテムIDをメモします。
UseSelfServiceイベント クラスを作成する
UseSelfServiceイベント クラスは、訪問者が映画のチケットを購入すると、チケット マシンからUseSelfServiceイベント アイテムをトリガーします。
UseSelfServiceイベント・クラスを作成するには、次のようにします。
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaプロジェクトを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 UseSelfService.cs 」と入力し、Addをクリックします。
-
-
UseSelfService.csファイルで、内容を次のコードで置き換えます。
-
UseSelfServiceイベントアイテムIDを挿入します。
-
UseSelfService.csファイルを保存します。
SitecoreCinemaModelコレクション モデル クラスを作成する
SitecoreCinemaModelコレクションモデルクラスを作成するには:
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、SitecoreCinemaを右クリックし、Add、New Itemの順にクリックします。
-
Add New Itemウィンドウで、次の操作を行います。
-
左側のウィンドウで、Installed/Visual C# Itemsをクリックします。
-
中央のウィンドウで、Classをクリックします。
-
下部のNameフィールドに「 SitecoreCinemaModel.cs 」と入力し、Addをクリックします。
-
-
SitecoreCinemaModel.csファイルで、内容を次のコードで置き換えます。
-
SitecoreCinemaModel.csファイルを保存します。
Console.Deployコンソール アプリ プロジェクトを作成します
Console.Deployコンソール アプリは、SitecoreCinemaModelをJSON形式にシリアル化します。
Console.Deployコンソール アプリ プロジェクトを作成するには:
-
Visual Studioで管理者特権でSitecoreCinemaソリューションを右クリックし、AddをクリックしNew Project .NET Framework用の新しいコンソール アプリ プロジェクトを作成します。次の .NET Framework Console.Deploy

-
ソリューション エクスプローラーで、Console.Deploy/Referencesを右クリックし、Add Referenceをクリックします。
-
Reference ManagerウィンドウのProjectsタブで、SitecoreCinemaを選択します。
-
Reference Managerウィンドウで、「Browse」をクリックし、<xConnect instance>\bin\フォルダから次の参照を追加します。
-
Sitecore.XConnect.Core.dll
-
Sitecore.XConnect.dll
-
-
「 OK」をクリックします。
-
ソリューション エクスプローラーで、Console.Deploy/Program.csファイルをダブルクリックします。
-
Program.csファイルで、内容を次のコードで置き換えます。
-
Program.csファイルを保存します。
SitecoreCinemaModelコレクション モデルをシリアル化する
SitecoreCinemaModelコレクションモデルをシリアル化するには:
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、Console.Deployプロジェクトを右クリックし、Set as Startup Projectをクリックします。
-
StartをクリックしてConsole.Deployアプリを実行し、モデルがシリアル化されるのを待ちます。

C:\SitecoreCinemaModel, 1.0.jsonファイル内のシリアル化されたモデルには、次のものが含まれている必要があります。
-
C:\SitecoreCinemaModel, 1.0.jsonファイルを<xConnect instance>\App_Data\Models\フォルダにコピーします。
Console.Journeyコンソール アプリ プロジェクトを作成する
Console.Journeyコンソールアプリは、Sitecore Cinemaでの訪問者の移動をシミュレートします。
-
来場者は券売機で映画のチケットを購入します。
-
客は売店でキャンディーを買います。
-
訪問者は映画のチケットをスキャンして映画館に入ります。
Console.Journeyコンソール アプリ プロジェクトを作成するには:
-
Visual Studioで管理者特権でSitecoreCinemaソリューションを右クリックし、AddをクリックしNew Project .NET Framework用の新しいコンソール アプリ プロジェクトを作成します。次の .NET Framework Console.Journey

-
ソリューション エクスプローラーで、Console.Journey/Referencesを右クリックし、Add Referenceをクリックします。
-
Reference ManagerウィンドウのProjectsタブで、SitecoreCinemaを選択します。
-
Reference Managerウィンドウで、「Browse」をクリックし、<xConnect instance>\bin\フォルダから次の参照を追加します。
-
Sitecore.XConnect.Client.dll
-
Sitecore.XConnect.Collection.Model.dll
-
Sitecore.XConnect.Core.dll
-
Sitecore.XConnect.dll
-
Sitecore.Xdb.Common.Web.dll
-
-
「 OK」をクリックします。
-
ソリューション エクスプローラーで、Referencesを右クリックし、Manage NuGet Packagesをクリックします。
-
NuGetウィンドウで、「Browse」をクリックし、次の参照を追加します。
-
Microsoft.Extensions.Configuration.Abstractions
-
System.Interactive.Async.Providers
-
-
ソリューション エクスプローラーで、Console.Journey/Program.csファイルをダブルクリックします。
-
Program.csファイルで、内容を次のコードで置き換えます。
-
CERTIFICATE_THUMBPRINT定数とXCONNECT_URL定数を編集します。
-
Program.csファイルを保存します。
Sitecore Cinemaの訪問をシミュレートする
Sitecore Cinemaの訪問をシミュレートするには:
-
Visual Studioで管理者特権を持つソリューション エクスプローラーで、Console.Journeyプロジェクトを右クリックし、Set as Startup Projectをクリックします。
-
StartをクリックしてConsole.Journeyアプリを実行し、次の操作が行われるのを待ちます。
-
名を登録します。
-
セカンドネームを登録します。
-
お気に入りの映画を登録します。
-
映画のチケットを買うシミュレーションをします。
-
キャンディーの購入をシミュレートします。
-
映画館への入場をシミュレートします。
-
収集された連絡先情報とインタラクションを表示します。

-