Skip to main content
close Search
Close search

チャレンジ

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

7 タスク

30 分

Visible to all users
中級 Pega Platform 8.4 データ統合 日本語

シナリオ

ロードサイド アシスタンスのリクエストでは、サービスプロバイダがサービス依頼に備えられるように、車両を識別する必要があります。 たとえば、特定の車両では、平台牽引トラックやハイオク混合燃料が必要になることがあります。 サービスプロバイダがより適切にサービス依頼に備えられるように、利害関係者は、車両のメーカー、モデル、年式について、有効な組み合わせのみがユーザーによって確実に入力されるようにしたいと考えています。 車両に関して利用可能と思われるいくつかのデータソースを検討した結果、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つの呼び出しをサポートするように統合を設定します。

 

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

ロール オペレーター ID パスワード
アプリケーションデベロッパー author@gogoroad pega123!

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

You must initiate your own Pega instance to complete this チャレンジ.

Initialization may take up to 5 minutes so please be patient.

詳細なタスク

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

NHTSA RESTサービスに車両のモデル情報を問い合わせる新しいデータオブジェクトを作成します。

  1. App Studioの左側のナビゲーション パネルで、「Data」 >「Data objects and integrations」をクリックし、「Data objects and integrations」ランディングページを開きます。
    Data Source - Challenge - Configure Data Type - Access Data Type
  2. ランディングページの右上隅の「New」をクリックして、「Data Object」ウィザードを開き、NHTSAサービスにアクセスするデータオブジェクトを作成します。
  3. 「Data Object」ウィザードの「Data objects name」フィールドに、「NHTSA Model data」と入力します。
  4. 「System」ドロップダウンで、「Create new」を選択します。 ウィザードが更新され、新しいデータソースを定義するための追加フィールドが表示されます。
  5. 「Name」フィールドに「NHTSA vPIC」と入力します。
  6. 「Description」フィールドに、「NHTSA Product Information Catalog Vehicle Listing」と入力します。
    Configuration settings for naming the data object used to connect to the NHTSA data source.
  7. 「Endpoint URL」フィールドに、「https://vpic.nhtsa.dot.gov/api/vehicles/GetModelsForMakeYear/make/Ford/modelyear/2015/vehicletype/Truck?format=json」と入力してNHTSAウェブサービスのURLを指定します。 Parametersセクションを展開すると、サービスURLのURL構成要素が表示されます。
  8. 次の表を使用して、サービスURLのメーカー、年式、車種の各部のパラメーターを追加します。
    URL構成要素 パラメーター名
    Ford make
    2015 modelyear
    Truck vehicletype
    Connection settings for the NHTSA REST service, including parameter definitions
  9. 「Initialize call」をクリックして、RESTサービスを呼び出し、ウィザードの2番目の手順に進みます。

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

NHTSA RESTサービスからのレスポンスデータのサンプルを表示して、レスポンスをデータオブジェクトのデータモデルにマッピングします。

補足: レスポンスは7つの結果が返されたことを示し、その7つの結果のうちの1つのデータが表示されます。 返される結果の数は、サービスに渡されるパラメーターによって異なります。
  1. SearchCriteria行で、「Add new」をクリックして、RESTレスポンスの「SearchCriteria」フィールドをデータオブジェクトのフィールドにマッピングします。 行の内容が更新されて、「Map to」フィールドと、ドロップダウン リストのフィールドタイプが表示されます。
  2. SearchCriteria行で、「Add/Edit map to」アイコンをクリックして、デフォルトのマッピングを受け入れ、「SearchCriteria」という名前のテキストフィールドをデータオブジェクトに作成します。
    Add/Edit map to icon highlighted on the Data mapping step of the Data Object wizard
  3. Results配列および「Make_Name」「Model_Name」「VehicleTypeName」の各応答フィールドについて手順1と2を繰り返します。
    response data from the NHTSA REST service, mapped to the fields of the data object in Pega Platform
  4. 「Next」をクリックして、データマッピングを完了し、ウィザードの3番目の手順に進みます。

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

統合設定を入力して、NHTSA RESTサービスへの統合の設定を完了させます。

補足: NHTSAでは、サービスにアクセスしてレスポンスデータを受け取るためのユーザー認証は不要です。 他のデータプロバイダでは認証が必要になる場合があります。 ウェブサービスへの統合を設定する場合は認証要件を確認してください。
  1. 「Endpoint URL」で、「Name」フィールドに「GetVehicleModels_BaseURL」と入力して、接続設定を指定します。
  2. 「Stage」で、「Base URL」フィールドに「https://vpic.nhtsa.dot.gov」と入力して、アプリケーションをステージング システムに移行した後に使用するURLを作成します。
  3. 「Prod」で、「Base URL」フィールドに「https://vpic.nhtsa.dot.gov」と入力して、アプリケーションを本番システムに移行した後に使用するURLを作成します。
  4. 「Authentication」で、「Name」フィールドに「AuthProfile_NHTSA_vPIC」と入力します。
    Environment settings for accessing the NHTSA REST service
  5. 「Submit」をクリックして、データオブジェクトとREST統合の設定を完了します。

4 データソースからのレスポンスを集計する

NHTSA RESTサービスを2回呼び出して乗用車とトラックの両方の車両モデルのリストを取得するため、最新のシミュレーション データ ソースを設定します。

  1. Dev Studioの左側のナビゲーション パネルで「Data types」をクリックすると、GoGoRoadアプリケーションについて定義されているデータオブジェクトがリストされます。
  2. 「Vehicle model」エントリーを展開すると、データオブジェクトについて設定されているデータビューがリストされます。
  3. 「List vehicle models」をクリックして「D_VehiclemodelsList」データページを開きます。このページには車両モデルのリストがキャッシュされます。
  4. 「Simulate data source」チェックボックスをオフにして、シミュレーション データソースをデータページから削除します。
  5. 「Source」ドロップダウンで、「Aggregate sources」を選択して、2つのREST呼び出しを使ってデータページをソースにします。
  6. 「Aggregate source name」フィールドに「NHTSA vPIC」と入力して、データページのデータソースを指定します。
  7. 「Source」ドロップダウンで、「Data transform」を選択します。
  8. 「Add source」をクリックして、データページの2番目のソースを追加します。
  9. 2番目のSourceドロップダウンで、「Data transform」を選択します。
    Data page configured with an aggregate source consisting of two data transform calls

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

データページにNHTSAサービスからの結果を挿入するためのデータトランスフォームを設定します。

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

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

パラメーターをD_VehiclemodelsListデータページに追加して、集計データソースのパラメーターを設定します。

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

7 作業の確認

  1. App Studioで「Preview application」をクリックしてCase Managerに戻ります。
  2. 新しいAssistance Requestケースを作成します。
  3. ケースを「Identify Vehicle」ビューに進めて、すべての必須フィールドに入力します。
  4. 「Identify Vehicle」フォームで「Configure this view」アイコンをクリックして、必須パラメーターをデータページに渡すためのModelドロップダウン リストを設定します。 ブラウザウィンドウの右側に設定パネルが表示されます。
    Configure this view icon presented on the Identify vehicle view
  5. 「Model」ドロップダウンをクリックして、含まれているビューのプロパティをパネルに表示します。
  6. NHTSAウェブサービスをソースとする値を表示するための「Model」ドロップダウンを設定します。
    1. 設定パネルで、「Model」ドロップダウンにカーソルを合わせ、「Edit」アイコンをクリックしてフィールドを設定します。
    2. List sourceセクションで、「Data Page」フィールドの内容をクリアします。
    3. 「Data page」フィールドで「D_VehiclemodelsList」を入力または選択して、ページを選択し直し、必須パラメーターを表示するためのプロパティーパネルを更新します。
    4. 「make」パラメーターの「Value」フィールドで「.Make」を入力または選択します。
    5. 「modelyear」パラメーターの「Value」フィールドで「.ModelYear」を入力または選択します。
    6. 「Property for value」フィールドで「.Model」を入力または選択します。
      Configuration of the Model drop-down to display the list of vehicle models based on the make and model year provided by the user
    7. パネルの右上隅の「Apply」をクリックして、ドロップダウンの設定を完了します。
    8. パネルを閉じて、ケースに戻ります。
  7. 「Model year」フィールドに「2015」と入力します。
  8. 「Make」フィールドに「Ford」と入力します。
  9. 「Model」ドロップダウンをクリックして、車種別にグループ化した車両モデルのリストを表示します。
    The Models drop-down, populated with data from the NHTSA REST service


下記のミッションにも含まれています。

If you are having problems with your training, please review the Pega Academy FAQs.

このコンテンツは役に立ちましたか?

このコンテンツは 50% のユーザーにとって役に立ちました。

改善できるところはありますか?

修正を提案する。

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice