Skip to main content

SOAPコネクターの作成

3 タスク

30 分

Visible to: All users
中級
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 parametersRequestタブで、「.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. データページへの変更を保存します。

作業の確認

  1. 「D_LatLongLookup」データページを開きます。
  2. 「Actions」>「Run」とクリックして、データページを実行します。
  3. RunウィンドウのValueフィールドに、ZipCodeパラメーターとして「02142」と入力します。
    補足: Value フィールドには、任意の有効な米国Zip Codeを入力できます。
  4. 「Run」をクリックします。
  5. LatLonListZipCodeListLatLonOutプロパティが、指定したZip Codeの緯度と経度の座標値を返すことを確認します。
    create_a_soap_connector_datapage_runresults

オプション:Location lookupケースタイプを作成してデータページを開始するように構成する

  1. parse XMLルールと同じクラスに新しいセクションを作成し、「Location」という名前を付けます。
    ヒント: parse XMLルールのクラス名は、「PegaHR-Int-LatLongLkp-ndfdXML」です。
  2. Location セクションルールに、.LatLonListZipCodeListLatLonOut を読み取り専用プロパティとして追加します。
     create_a_soap_connector_location_section_xmlfield_edited
     
  3. Locationケースタイプを作成し、次に、Createステージ名を「Location Details」に変更します。
  4. Locationケースタイプを、次の画像に示すように構成します。
    location case type
  5. ZipCodeフィールドを「Location information」ビューに追加します。
  6. Check location detailsセクションにボタン要素を追加し、Refresh this sectionアクションを追加してセクションをリフレッシュし、「.LatLonListZipCodeListLatLonOut 」のプロパティ値を表示します。
    Check location details section
  7. LocationセクションをCheck location detailsセクション内に埋め込み、埋め込まれたセクションがデータページをPageコンテキストとして使用して「.ZipCode」プロパティをパラメーター値として渡すように構成します。
    ヒント: セクションを埋め込むには、Check location detailsセクションで「Add new」>「Advanced」>「Embedded section」とクリックします。
    create_a_soap_connector_datapage_embeded_section
  8. Locationケースタイプのインスタンスを作成して、ワークを確認します。
  9. 「Location information」ページで、Zip Codeを入力し、「Check」をクリックしてセクションをリフレッシュし、「LatLongListZipCodeListLatLonOut」プロパティ値を表示します。

    create_a_soap_connector_datapage_verification

 


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


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

トレーニングを実施中に問題が発生した場合は、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