Skip to main content

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

Archived

6 タスク

30 分

Visible to: All users
中級 Pega Platform 8.6 データ統合 日本語
This content is now archived and is no longer updated. Progress is not calculated. Pega Cloud instances are disabled, and badges are no longer awarded. ここをクリックして to continue your progress in the latest version.

シナリオ

ロードサイド アシスタンスのリクエストでは、サービスプロバイダがサービス依頼に備えられるように、車両を識別する必要があります。 たとえば、特定の車両では、平台牽引トラックやハイオク混合燃料が必要になることがあります。 サービスプロバイダがより適切にサービス依頼に備えられるように、利害関係者は、車両のメーカー、モデル、年式について、有効な組み合わせのみがユーザーによって確実に入力されるようにしたいと考えています。 車両に関して利用可能と思われるいくつかのデータソースを検討した結果、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!
補足: 練習環境では、複数のチャレンジの完了をサポートする場合があります。 その結果、チャレンジのウォークスルーに表示される設定は、お客様の環境と完全に一致しない場合があります。

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

詳細なタスク

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

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

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

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

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

補足: 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
  5. 「Submit」をクリックして、データオブジェクトとREST統合の設定を完了します。

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

  1. Dev Studioのナビゲーションペインで「Data types」をクリックすると、GoGoRoadアプリケーションについて定義されているデータオブジェクトがリストされます。
  2. 「Vehicle models」をクリックすると、データタイプが開きます。  
  3. 「Sources」タブをクリックして使用可能なソースを表示し、List Vehicle modelsをクリックして「D_VehiclemodelsList」データページを開きます。このページには車両モデルのリストがキャッシュされます。
  4. 「Data Sources」セクションで、「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」を選択します。
    aggregate_sources_DP

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

  1. 1番目のソースについて、「Data transform」フィールドに「MapModels」と入力します。
  2. Open アイコンをクリックして、データトランスフォームを作成します。
    Open icon
  3. 「Create and open」をクリックして、デフォルト設定を受け入れ、データトランスフォームルールフォームを開きます。
  4. Parameters 」タブをクリックして、NHTSAサービスで必要な3つのパラメーターを定義します。
    1. 「Parameters」タブで、Add アイコンをクリックして、パラメーターを定義するための行を追加します。
    2. 空のパラメーター行の「Name」フィールドに「make」と入力します。
    3. 「Required」ドロップダウンで、「Yes」を選択します。
    4. 次の表の情報を使用して、手順4a〜4Cを繰り返し、2番目以降のパラメーターをデータトランスフォームに追加します。
      Name 必須
      modelyear はい
      vehicletype はい
  5. 「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」を入力または選択して、出力ページのクラスを指定します。
      Page name
  6. 「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のフィールドを作成します。
        アクション ターゲット 送信元
      1.2 設定 .Model .Model_Name
      1.3 設定 .VehicleType .VehicleTypeName
      map_models_DT
  7. 「Save」をクリックして、データトランスフォームの設定を完了します。

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

  1. Dev Studioで「D_VehiclemodelsList」タブをクリックして、データページ ルールフォームに戻ります。
  2. D_VehiclemodelsListデータページ ルールフォームで「Parameters」タブをクリックして、パラメーターをデータページに追加します。
  3. 空の行の「Name」フィールドに「make」と入力して、データトランスフォームに渡すメーカーのパラメーターを定義します。
  4. 必要に応じて「Required」ドロップダウンで「Yes」を選択し、パラメーターをマークします。
  5. Add itemアイコンをクリックして、2番目のパラメーターをデータページに追加します。
  6. 2番目の行の「Name」フィールドに「modelyear」と入力し、データトランスフォームに渡す年式のパラメーターを定義します。
  7. 必要に応じて「Required」ドロップダウンで「Yes」を選択し、パラメーターをマークします。
  8. 「Definition」タブをクリックして、集計ソースの設定を再開します。
  9. 「Data transform name」フィールドの下にある「Parameters」をクリックして、データトランスフォームに渡す値を設定するためのダイアログボックスを開きます。
    1. ダイアログボックスで、make パラメーターの「Value」フィールドに「param.make」と入力して、「make」パラメーターの値がデータページに渡されるようにします。
    2. 「modelyear」パラメーターの「Value」フィールドに「param.modelyear」と入力して、「modelyear」パラメーターの値がデータページに渡されるようにします。
    3. vehicletypeパラメーターの「Value」フィールドに「Passenger Car」と入力して、定数文字列が渡されるようにします。
    4. 「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」 をクリックして、データページの設定を完了します。

作業の確認

  1. App Studioで、「Preview」をクリックしてユーザーポータルに戻ります。
  2. 新しいAssistance Requestケースを作成します。
  3. ケースを「Identify vehicle」ステップに進めて、すべての必須フィールドに入力します。
  4. 右上隅のDesign アイコンをクリックして、デザインモードを有効にします。
    Design
  5. Vehicle Informationセクションで「Edit this section」アイコンをクリックします。
    Edit the section
  6. Model」フィールドで「Edit this field」アイコンをクリックして、必須パラメーターをデータページに渡すための「Model」ドロップダウンリストを設定します。 ブラウザウィンドウの右側に設定パネルが表示されます。
    1. 「List source」セクションで、「Data Page」フィールドの内容をクリアします。
    2. 「Data page」フィールドで「D_VehiclemodelsList」を入力または選択して、ページを選択し直し、必須パラメーターを表示するためのプロパティーパネルを更新します。
    3. 「make」パラメーターの「Value」フィールドで「.Make」を入力または選択します。
    4. 「modelyear」パラメーターの「Value」フィールドで「.ModelYear」を入力または選択します。
    5. 「Property for value」フィールドで「.Model」を入力または選択します。
      List source
    6. パネルの右上隅の「Apply」をクリックして、ドロップダウンの設定を完了します。
    7. Design をクリックしてデザインモードをオフにします。
  7. 「Model year」フィールドに「2015」と入力します。
  8. 「Make」フィールドに「Ford」と入力します。
  9. 「Model」ドロップダウンをクリックして、車種別にグループ化した車両モデルのリストを表示します。
    Model drop-down


このモジュールは、下記のミッションにも含まれています。

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