Skip to main content

チャレンジ

SOAPコネクターの作成

SOAPコネクターの作成

3 タスク

30 分

 表示の対象：All users Applies to: Pega Platform '23
中級
データ統合
日本語
バージョンタグがご希望のコンテンツと一致しているかご確認ください。 または、最新バージョンをご利用ください。

シナリオ

人事部（HR）のビジネスパートナーは、従来のアプリケーションを使用して、従業員が自宅近くで利用できる割引サービスを探しています。 このアプリケーションでは、割引サービスを見つけるために経度と緯度の値が必須です。 このレガシーアプリケーションを使用しやすくするために、人事部のビジネスパートナーから、HR Appsアプリケーションの機能を拡張して、指定された郵便番号の緯度と経度を特定したいという依頼がありました。

SOAP統合ルールを作成してSOAPコネクターを呼び出すデータページを設定します。

  • SOAP統合ルールを作成し、郵便番号ルックアップサービスに接続します。
  • XMLパースルールを作成し、SOAPコネクターのレスポンスから緯度と経度の値を抽出します。
  • データページを作成して設定し、SOAPコネクターを呼び出します。
  • オプション：Location Lookupケースタイプを作成して設定し、データページを呼び出します。

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

ロール ユーザー名 パスワード
シニアシステムアーキテクト SSA@TGB pega123!

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

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

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

詳細なタスク

1 SOAP統合ルールを作成して郵便番号ルックアップサービスに接続する

  1. チャレンジのPegaインスタンスに、以下のログイン情報を入力します。
    1. User nameフィールドに「SSA@TGB」と入力します。
    2. Passwordフィールドに「pega123!」と入力します。

  2. Dev Studioで、「Configure」>「Integration」>「Connectors」>「Create SOAP Integration」をクリックして、New SOAP Integration画面を開きます。

  3. New SOAP Integration画面で、「Upload WSDL from URL」をクリックし、URLに接続するオプションを有効にします。

  4. Upload WSDL from URLフィールドに、「https://graphical.weather.gov/xml/SOAP_server/ndfdXMLserver.php?wsdl」と入力します。

  5. 「Next」をクリックしてSelect Operationsステップに進みます。

  6. 有効化された操作のチェックボックスをすべて外し、「LatLonListZipCode」を選択して操作を有効にします。

    Creating the SOAP connector
  7. 「Next」をクリックしてReviewステップに進みます。
  8. Nameフィールドに「LatLongLkp」と入力して、サービスにクラス名と識別子を指定します。
  9. Parent classフィールドで、値がPegaHR-Intであることを確認します。
  10. HR Appsアプリケーションレイヤーを選択したことを確認します。
  11. Add to rulesetセクションで、「Existing」をクリックしてルールセット名およびバージョンオプションを有効にします。
  12. 可用性の最も高いHRAppsIntルールセットのバージョンを選択します。
    review screen
  13. 「Create」をクリックして、新しいSOAP統合に関連するすべてのルールを作成します。

2 XMLパースルールを作成してSOAPコネクターのレスポンスから緯度と経度の値を抽出する

ヒント： これで、XMLルールが受信したXMLレスポンスを解析する準備が整い、< latLonList>との間に含まれる情報を抽出することができます。

  1. Records Explorerで、「Integration-Connectors」>「Connect SOAP」をクリックし、SOAPコネクタールールインスタンスのリストを表示します。

  2. 「Service Name」列をフィルタリングして、新しく作成した「LatLonListZipCode」SOAPコネクターを検索して開きます。
  3. Request parametersのRequestタブで、「.LatLonListZipCodeZipCodeList」プロパティを含むMap from Keyフィールドが設定されていることを確認します。 

  4. ResponseタブのResponse parametersセクションにある、「Map to」リストで、「XML Parse Rule」を選択します。

  5. Map to keyフィールドに、「ParseLatLongResponseXML」と入力し、新しい解析XMLルールの名前を指定します。

    Response xml
     
  6. ParseLatLongResponseXMLフィールドの横にある「Open」アイコンをクリックして、Parse XMLレコードを作成します。
  7. Root Element Nameフィールドに、「dwml」と入力し、サービスレスポンスでXMLルート要素を特定します。
  8. 「Add to ruleset」リストで、HRAppsIntおよび可用性の最も高いバージョンを選択します。
  9. Parse XMLルールを作成して開きます。
  10. Mappingタブで、「dwml」を選択し、「Add Element」をクリックして新しい子要素を追加します。 
    create-a-soap-connector-parse-xml
  11. 「_new_」要素をダブルクリックして、その要素の「User Data」ダイアログを開きます。
  12. Node Nameフィールドに「latLonList」と入力します。
  13. Propertyフィールドに、「.LatLonListZipCodeListLatLonOut」を入力するか、選択します。
    create_a_soap_connector_nodename_details
  14. Parse XMLルールへの変更を保存します。
  15. LatLonListZipCodeConnect SOAPルールタブに戻ります。
  16. ResponseタブのResponse parametersセクションにある、Map to keyフィールドで、「ParseLatLongResponseXML dwml」を新しい値として入力するか、選択します。
    response-parameters
  17. ワーニングセクションで、「Review/Edit」をクリックすると、ガードレールワーニングが表示されます。 
    guardrail warnings
    補足： 上記の3つのガードレールワーニングは、次のステップの設定で対処します。
  18. ServiceタブのConnection セクションにあるService endpoint URLフィールドに「=D_pxGetApplicationSettingValue[OwningRuleset:PegaHR, Purpose:ServiceEndpointURL].pySettingValue」と入力します。

    データページD_pxGetApplicationSettingValueルールでは、「OwningRuleset」および「Purpose」の2つのパラメーターが必須です。

  19. 次の表で詳細を使用してResponse timeoutフィールドおよびAuthentication profileフィールドに手順18を繰り返します。
    OwningRuleset Purpose
    PegaHR ResponseTimeout
    PegaHR AuthenticationProfile
    guardrail-correction
  20. SOAPコネクタールールを保存して、3つのワーニングがクリアされていることを確認します。

3 データページを作成して設定し、SOAPコネクターを呼び出す

  1. Dev Studioで、「Create」>「Data Model」>「Data Page」をクリックして、Data Page Record Configuration画面を起動します。
  2. Labelフィールドに「LatLongLookup」と入力します。
  3. Apply toフィールドに「PegaHR-Int-LatLongLkp-ndfdXML」と入力するか、または選択し、SOAPコネクターと同じコンテキストにデータページを作成します。
  4. Add to rulesetリストで、HRAppsIntおよび可用性の最も高いバージョンを選択します。
  5. データページを作成して開きます。
  6. DefinitionタブのData sourcesセクションのTypeリストで、「SOAP」を選択します。
  7. Nameフィールドに、「LatLonListZipCode」と入力するか、選択します。
  8. Request Data Transformフィールドに「LatLongRequest」と入力します。
  9. Open アイコンをクリックして、新しいデータトランスフォームを作成します。
    create_a_soap_connector_datapage_datasources
  10.  データトランスフォームを作成して開きます。
  11. Definitionタブで、以下のプロパティ値を使用して「Step 1」を設定します。
    プロパティ名 値
    Action Set
    Target .LatLonListZipCodeZipCodeList
    Relationship equal to
    Source Param.ZipCode
  12. データトランスフォームへの変更を保存します。
  13. Edit: LatLongLookupデータページタブに戻ります。
  14. Data sourcesセクションのRequest Data Transformフィールドで、「Parameters」をクリックします。
    create_a_soap_connector_datapage_datasources_parameters
  15. 「Parameters for LatLongRequest」ダイアログボックスで、「Pass current parameter page」を選択して、「Request」データトランスフォーム用のパラメーターを有効にします。
  16. 「Submit」をクリックします。
  17. Parametersタブで、以下の情報を使用する新しいパラメーターを追加します。
    フィールド 値
    Name ZipCode
    Description Please enter a zip code for which you want to fetch latitude and longitude
    Data type string
    Required Yes
    In/Out In
  18. Load Managementタブで「Limit to a single data page」を選択します。
  19. データページへの変更を保存します。

このチャレンジは、下記のモジュールで学習したことを実践するための内容です。

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

ミッションのトップに戻る
トレーニングを実施中に問題が発生した場合は、Pega Academy Support FAQsをご確認ください。

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

はい
いいえ

改善できるところはありますか？
修正を提案する

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