チャレンジ

外部データソースのデータタイプへの追加

7 タスク

25 分

表示の対象：All users Applies to: Pega Platform '24.2

中級

データ統合

日本語

シナリオ

ロードサイドアシスタンスのリクエストでは、サービスプロバイダがサービス依頼に備えられるように、車両を識別する必要があります。たとえば、特定の車両では、平台牽引トラックやハイオク混合燃料が必要になることがあります。サービスプロバイダがより適切にサービス依頼に備えられるように、利害関係者は、車両のメーカー、モデル、年式について、有効な組み合わせのみがユーザーによって確実に入力されるようにしたいと考えています。車両に関して利用可能と思われるいくつかのデータソースを検討した結果、US National Highway Traffic Safety Administration（NHTSA）ウェブサービス（https://vpic.nhtsa.dot.gov/api）をデータソースとすることにしました。

NHTSAが提供するRepresentational State Transfer（REST）サービスを使用して、現在のシミュレートされたデータソースを統合して乗用車とトラックのモデル情報を取得します。ユーザーが入力する年式とメーカーに基づいて、D_VehiclemodelsListデータページにNHTSAの応答データを入力します。

補足： NHTSAのデータには、GoGoRoadのロードサイドアシスタンスサービスで対応していない他の種類の車両（バスなど）に関する情報も含まれています。該当する車両のモデルのみが表示されるようにするため、1つは乗用車用、もう1つはトラック用というように、NHTSAサービスに対する2つの呼び出しをサポートするように統合を設定します。

以下の表は、チャレンジに必要なログイン情報をまとめたものです。

ロール	ユーザー名	パスワード
アプリケーションデベロッパー	author@gogoroad	pega123!

補足： 練習環境では、複数のチャレンジの完了をサポートする場合があります。その結果、チャレンジのウォークスルーに表示される設定は、お客様の環境と完全に一致しない場合があります。

このチャレンジを完了するには、Pegaインスタンスを起動する必要があります。

起動には5分ほどかかることがありますので、しばらくお待ちください。

ログイン

チャレンジウォークスルー

詳細なタスク

1 外部データソースを使用してデータオブジェクトを作成する

チャレンジのPegaインスタンスに、以下のログイン情報を入力します。
1. User nameフィールドに「author@gogoroad」と入力します。
2. Passwordフィールドに「pega123!」と入力します。
App Studioナビゲーションペインで「Data」をクリックします。
Data objects and integrationsランディングページの右上隅の「New」をクリックして、「Data Object」ウィザードを開き、NHTSAサービスにアクセスするデータオブジェクトを作成します。
Data ObjectウィザードのData object nameフィールドに、「NHTSA Model data」と入力します。
「Next」をクリックして、データオブジェクト接続の詳細を構成します。
「System」ドロップダウンで、「Create new」を選択します。ウィザードが更新され、新しいデータソースを定義するための追加フィールドが表示されます。
Nameフィールドに「NHTSA vPIC」と入力します。
Descriptionフィールドに、「NHTSA Product Information Catalog Vehicle Listing」と入力します。
Endpoint URLフィールドに、「https://vpic.nhtsa.dot.gov/api/vehicles/GetModelsForMakeYear/make/Ford/modelyear/2015/vehicletype/Truck?format=json」と入力してNHTSAウェブサービスのURLを指定します。
Parametersセクションを展開して、サービスURLのURLパーツを表示します。
次の表を使用して、サービスURLのメーカー、年式、車種の各部のパラメーターを追加します。

URLパーツパラメーター名

Ford make

2015 modelyear

Truck vehicletype
「Initialize call」をクリックして、RESTサービスを呼び出し、ウィザードの3番目の手順に進みます。

URLパーツ	パラメーター名
Ford	make
2015	modelyear
Truck	vehicletype

2 データソースからのレスポンスをマッピングする

補足： レスポンスは7つの結果が返されたことを示し、その7つの結果のうちの1つのデータが表示されます。返される結果の数は、サービスに渡されるパラメーターによって異なります。

データマッピングダイアログボックスの「SearchCriteria」行で、「Add new」をクリックして、RESTレスポンスのSearchCriteriaフィールドをデータオブジェクトのフィールドにマッピングします。行の内容が更新されて、Map toフィールドと、ドロップダウンリストのフィールドタイプが表示されます。
SearchCriteria行で、「Add/Edit map to」アイコンをクリックして、デフォルトのマッピングを受け入れ、「SearchCriteria」という名前のテキストフィールドをデータオブジェクトに作成します。
「Make_Name」、「Model_Name」、「VehicleTypeName」の各応答フィールドについて手順1と2を繰り返します。
「Next」をクリックして、データマッピングを完了し、ウィザードの4番目の手順に進みます。

3 統合のエンドポイント設定を定義する

補足： NHTSAでは、サービスにアクセスしてレスポンスデータを受け取るためのユーザー認証は不要です。他のデータプロバイダでは認証が必要になる場合があります。ウェブサービスへの統合を設定する場合は認証要件を確認してください。

Endpoint URLセクションのNameフィールドに「GetVehicleModels_BaseURL」と入力して、接続設定を指定します。
DevセクションのBase URLフィールドに「https://vpic.nhtsa.dot.gov 」と入力して、アプリケーションを開発システムで開発しながら使用するURLを作成します。
StageセクションのBase URLフィールドに「https://vpic.nhtsa.dot.gov」と入力して、アプリケーションをステージングシステムに移行した後に使用するURLを作成します。
ProdセクションのBase URLフィールドに「https://vpic.nhtsa.dot.gov」と入力して、アプリケーションを本番システムに移行した後に使用するURLを作成します。
AuthenticationセクションのNameフィールドに「AuthProfile_NHTSA_vPIC. 」と入力します。
「Submit」をクリックして、データオブジェクトとREST統合の設定を完了します。

4 List Vehicle modelsデータソースを更新する

App Studioのナビゲーションペインで「Data」をクリックすると、GoGoRoadアプリケーション用に定義されているデータオブジェクトがリストされます。
「Vehicle models」をクリックして、データオブジェクトを開きます。
「Data pages」タブでCreate simulated sourcesをクリックします。
「OK 」をクリックして、「Rule generation status」ウィンドウを閉じます。
「List Vehicle models」行で、右側のその他メニューアイコンをクリックし、「Open in Dev Studio 」をクリックして、Dev Studioでデータページを開きます。
「Data Sources」セクションで「Simulate data source」チェックボックスをオフにして、シミュレーションデータソースをデータページから削除します。
D_VehiclemodelsList dataページでは、シミュレーションデータソースが使用されます。シミュレーションデータソースを置き換えるには、「Replacing a simulated data source」を参照してください。
「Source」ドロップダウンで、「Aggregate sources」を選択して、2つのREST呼び出しを使ってデータページをソースにします。
Aggregate source nameフィールドに「NHTSA vPIC」と入力して、データページのデータソースを指定します。
「Source」ドロップダウンで、「Data Transform」を選択します。
「Add source」をクリックして、データページの2番目のソースを追加します。
2番目の「Source」ドロップダウンで、「Data Transform」を選択します。

5 ソースデータトランスフォームを設定する

1番目のソースについて、Data Transform nameフィールドに「MapModels」と入力します。
「Open 」アイコンをクリックして、データトランスフォームを作成します。
「Create and open」をクリックして、デフォルト設定を受け入れ、データトランスフォームルールフォームを開きます。
Parameters タブをクリックして、nhtsaサービスで必要な3つのパラメーターを定義します。
1. parametersタブで、「Add 」アイコンをクリックして、パラメーターを定義するための行を追加します。
2. 空のパラメーター行のnameフィールドに「make」と入力します。
3. 「Required」ドロップダウンで、「Yes」を選択します。
4. 次の表の情報を使用して、手順4a〜4Cを繰り返し、2番目以降のパラメーターをデータトランスフォームに追加します。
  
  Name Required
  
  modelyear Yes
  
  vehicletype Yes
Pages & Classesタブをクリックして、データトランスフォームで使用されるページと各ページのクラスを指定します。
1. Pages & Classesタブで、Page nameフィールドに「Primary.pxResults」と入力して、データトランスフォームの出力が含まれるページを指定します。
2. Classフィールドで「GoGo-GoGoRoad-Data-VehicleModels」を入力または選択して、出力ページのクラスを指定します。
3. 「Add item」アイコンをクリックして、2番目の行を「Pages & Classes」タブに追加します。
4. Page nameフィールドに「D_NHTSAModelData.Results」と入力して、データトランスフォームの出力が含まれるページを指定します。
5. Classフィールドで「GoGo-GoGoRoad-Data-NHTSAModelData-Results」を入力または選択して、出力ページのクラスを指定します。
Definitionタブをクリックして、データトランスフォームロジックを設定します。
1. 手順1について、「Action」ドロップダウンで「Append and Map to」を選択して、返される結果ごとに新しいページを作成します。データトランスフォームによって手順1の下位に1.1とラベル付けされた子の行が追加されます。
2. 手順1について、Targetフィールドに「Primary.pxResults」と入力します。
3. 「Relation」ドロップダウンで、「each page in」を選択します。
4. sourceフィールドに「d_nhtsamodeldata[vehicletype:param.vehicletype,modelyear:param.modelyear,make:param.make].results」と入力して、nhtsaサービスを呼び出してレスポンスをキャッシュするデータページに必須パラメーターが渡されるようにします。
5. 手順1.1について、Targetフィールドで「.Make」を入力または選択して、ターゲットページのMakeプロパティの値を設定します。
6. Sourceフィールドで「.Make_Name」を入力または選択して、ターゲットにコピーするプロパティを指定します。
7. 「Add a row 」アイコンを2回クリックして、手順1.2と1.3をデータトランスフォームに追加します。
8. 次の表の情報を使用して、手順1.2と1.3のフィールドを作成します。
  
  Action Target Source
  
  1.2 Set .Model .Model_Name
  
  1.3 Set .VehicleType .VehicleTypeName
「Save」をクリックして、データトランスフォームの設定を完了します。

Name	Required
modelyear	Yes
vehicletype	Yes

	Action	Target	Source
1.2	Set	.Model	.Model_Name
1.3	Set	.VehicleType	.VehicleTypeName

6 データページのパラメーターを指定して両方のサービス呼び出しを設定する

Dev StudioでD_VehiclemodelsListタブをクリックして、Data Page Ruleフォームに戻ります。
d_vehiclemodelslistデータページルールフォームでparametersタブをクリックして、パラメーターをデータページに追加します。
空の行のnameフィールドに「make」と入力して、データトランスフォームに渡すメーカーのパラメーターを定義します。
必要に応じて「Required」ドロップダウンで「Yes」を選択し、パラメーターをマークします。
「Add item 」アイコンをクリックして、2番目のパラメーターをデータページに追加します。
2番目の行のnameフィールドに「modelyear」と入力し、データトランスフォームに渡す年式のパラメーターを定義します。
必要に応じて「Required」ドロップダウンで「Yes」を選択し、パラメーターをマークします。
Definitionタブをクリックして、集計ソースの設定を再開します。
Data Transform nameフィールドの下にある「Parameters」をクリックして、データトランスフォームに渡す値を設定するためのダイアログボックスを開きます。
1. ダイアログボックスで、make パラメーターのValueフィールドに「param.make」と入力して、「make」パラメーターの値がデータページに渡されるようにします。
2. modelyearパラメーターのValueフィールドに「param.modelyear」と入力して、modelyearパラメーターの値がデータページに渡されるようにします。
3. vehicletypeパラメーターのValueフィールドに「passenger car」と入力して、定数文字列が渡されるようにします。
4. 「Submit」をクリックして、モデルダイアログを閉じ、パラメーター設定を保存します。
2番目の集計ソースについて、Data Transform nameフィールドで「MapModels」と入力または選択して、データトランスフォームが2回呼び出されてデータページにデータが入力されるようにします。
Tab キーを押してフィールドを終了します。Data Transform nameフィールドの下に「Parameters」リンクが表示されます。
2番目の集計ソースについて手順9を繰り返し、次の表の情報を使用して、「MapModels」データトランスフォームのパラメーター値を追加します。

パラメーター値

make param.make

modelyear param.modelyear

vehicletype Truck
「Save」をクリックして、データページの設定を完了します。

パラメーター	値
make	param.make
modelyear	param.modelyear
vehicletype	Truck

7 Vehicle informationセクションを設定する

補足： 「Model」フィールドは現在テキスト入力の操作ですが、設定した外部データソースからの結果が表示されるドロップダウンの操作にする必要があります。次の手順では、そのテキスト入力を削除し、代わりにドロップダウンフィールドを追加します。

App Studioで、「Preview」をクリックしてユーザーポータルに戻ります。
新しいAssistance Requestケースを作成します。
ケースをIdentify vehicleステップに進めて、すべての必須フィールドに入力します。
Design アイコンをクリックして、デザインモードを切り替えます。
Vehicle informationセクションで、セクションの編集アイコンをクリックします。右側に設定ペインが表示されます。
セクションの設定ペインで、Model テキスト入力フィールドにカーソルを合わせ、その他のオプションメニューを選択し、 Deleteを選択して、セクションからフィールドを削除します。
フィールドの上にあるヘッダーの追加アイコンをクリックします。
「Controls > Pickers」で、Dropdownコンポーネントにカーソルを合わせ、追加アイコンをクリックしてセクションに追加します。
セクションの設定ペインで、新しいDropdownフィールドにカーソルを合わせ、ドロップダウンの編集アイコンをクリックします。右側に設定ペインが表示されます。
設定ペインのGeneralセクションで、次の構成を行います。
1. Propertyフィールドに「.Model」と入力するか選択します。
2. Include placeholderチェックボックスを有効にします。
3. Placeholderフィールドに、「Select the model of your vehicle」と入力します。
4. List sourceセクションで、Typeフィールドを「Data Page」に設定します。
5. Data Pageフィールドに「D_VehiclemodelsList」と入力または選択します。
6. makeパラメーターのValueフィールドで「.make」を入力または選択します。
7. modelyearパラメーターのValueフィールドで「.modelyear」を入力または選択します。
8. Property for valueフィールドで「.Model」を入力または選択します。
9. Group itemsチェックボックスを有効にします。
10. Group byフィールドで、「.VehicleType」と入力または選択します。
11. Load behaviorリストで、「 After screen renders」を選択します。
右上にあるApplyボタンをクリックして、設定を適用します。
セクションの設定ペインで、フィールドにカーソルを合わせ、次の順番に並べ替えます。
新しい順番がNew Assistance Requestケースビューに反映されていることを確認します。
1. Model year
2. Make
3. Model
4. Color