Creating a SOAP connector

Use the technical documentation linked in the Journey map above to complete the assigned tasks. The technical documentation might have more information than you need to complete the tasks.

Acceptance criteria

Task 1: Create the SOAP Integration Rule

• A SOAP Integration Rule is created using the WSDL URL https://graphical.weather.gov/xml/SOAP_server/ndfdXMLserver.php?wsdl.
• The endpoint URL is set to https://graphical.weather.gov/xml/SOAP_server/ndfdXMLserver.php.
• Only the LatLonListZipCode operation is enabled; all others are cleared.
• The Integration Rule record is configured as follows:

  Field	Value
  Name	LatLongLkp
  Parent class	TGB-Int
  Application Layer	HRAppsV2
  Add to Ruleset	Existing
  Ruleset	HRAppsV2Int
  Version	New Version

  

Task 2: Create the XML Parse Rule

• The LatLonListZipCode Connect SOAP rule is configured as follows:
  • Style and use (Service tab): RPC/literal
  • Request tab: First Map from Key is .LatLonListZipCodeZipCodeList
  • Response tab: Map to is set to XML Parse Rule, Map to key is ParseLatLongResponseXML
• An XML Parse Rule named ParseLatLongResponseXML is created with the following configuration:

  Field	Value
  Root Element Name	dwml
  Ruleset	HRAppsV2Int (highest available version)

• On the Mapping tab, an element is added under dwml with the following values:

  Field	Value
  Node Name	latLonList
  Property	.LatLonListZipCodeListLatLonOut

• The LatLonListZipCode Connect SOAP rule Response tab Map to key field is set to ParseLatLongResponseXML dwml.

Task 3: Create Application Settings

• Three Application Settings records are created with the following configuration:

  Field	Value
  Owning Ruleset	HRAppsV2Int
  Application Layer	HRAppsV2
  Add to Ruleset	HRAppsV2Int, highest available unlocked version

• The three records are configured with the following labels and values:

  Label	Identifier	Value
  Service endpoint URL	ServiceEndpointURL	https://graphical.weather.gov:443/xml/SOAP_server/ndfdXMLserver.php (all environments)
  Response timeout	ResponseTimeout	120000
  Authentication Profile	AuthenticationProfile	(blank)

• The LatLonListZipCode Connect SOAP rule Service tab Connection section is configured with the following expressions:

  Field	Expression
  Service endpoint URL	=D_pxGetApplicationSettingValue[OwningRuleset:HRAppsV2Int, Purpose:ServiceEndpointURL].pySettingValue
  Response timeout	=D_pxGetApplicationSettingValue[OwningRuleset:HRAppsV2Int, Purpose:ResponseTimeout].pySettingValue
  Authentication Profile	=D_pxGetApplicationSettingValue[OwningRuleset:HRAppsV2Int, Purpose:AuthenticationProfile].pySettingValue

• Guardrail warnings on the LatLonListZipCode Connect SOAP rule are cleared after applying the settings.

Task 4: Create and configure the Data Page

• A Data Page named LatLongLookup is created with the following configuration:
  • Apply to: TGB-Int-LatLongLkp-ndfdXML
  • Ruleset: HRAppsV2Int (highest version)
• The Definition tab Data Source is configured as follows:
  • Type: SOAP
  • Name: LatLonListZipCode
  • Request Data Transform: LatLongRequest
• A Data Transform named LatLongRequest is created with the following step:

  Field	Value
  Action	Set
  Target	.LatLonListZipCodeZipCodeList
  Relationship	equal to
  Source	Param.ZipCode

• The Request Data Transform parameter is set to Pass current parameter page.
• The LatLongLookup Data Page Parameters tab includes the following parameter:

  Field	Value
  Name	ZipCode
  Description	Please enter a zip code for which you want to fetch the latitude and longitude
  Data type	String
  Required	Yes
  In/Out	In

• The LatLongLookup Data Page Load Management tab is set to Limit to a single Data Page.

Directions

1. Navigate to Configure > Integration > Connectors and create a new SOAP Integration by uploading the WSDL from the URL defined in the Acceptance criteria.
2. Select only the LatLonListZipCode operation and configure the record as detailed in the Acceptance criteria.
   
3. Open the LatLonListZipCode Connect SOAP rule and configure the Service, Request, and Response tabs as detailed in the Acceptance criteria.
4. Create the ParseLatLongResponseXML XML Parse Rule and configure the Mapping tab as detailed in the Acceptance criteria.
5. Return to the LatLonListZipCode Connect SOAP rule Response tab and set the Map to key field, and then save your changes.
6. Create the three Application Settings records as detailed in the Acceptance criteria.
7. Open the LatLonListZipCode Connect SOAP rule and apply the Application Settings expressions to the Connection section of the Service tab as detailed in the Acceptance criteria.
8. Create the LatLongLookup Data Page, configure the Definition tab with the SOAP data source, and create the LatLongRequest Data Transform as detailed in the Acceptance criteria.
9. Add the ZipCode parameter on the Parameters tab and configure Load Management as detailed in the Acceptance criteria.