Normalize Address
  • 30 Jan 2023
  • 1 Minute to read
  • Dark
    Light

Normalize Address

  • Dark
    Light

Article Summary

Step Details

Introduced in Version4.0.0
Last Modified in Version7.1.0
LocationIntegration > USPS

The Normalize Address step returns the full address information, including the full zip code for the address (the 5-digit zip code and the additional 4 digits after the zip code, i.e., 23644-1243).

Prerequisites 

This step requires the USPS module to be installed before it will be available in the toolbox. 


Properties

Inputs

PropertyDescriptionData Type
Address1The desired address informationString
Address2The desired address informationString
CityThe city of the addressString
StateThe 2 character abbreviation of the state (i.e., VA for Virginia) String

Outputs

PropertyDescriptionData Type
OutputOutputs the specified address with zip codeAddress

Example Inputs and Outputs

Address1Address2CityStateOutput
722 Indian River RoadNullVirginia BeachVAEXCEPTION MESSAGE
6633 E Virginia Beach Blvd
NullNorfolkVAAddress2:"6633 E Virginia Beach BLVD", City:"NORFOLK",State:"VA",Zip4:"3013",Zip5:"23502",Error:null
1466 S Idalia StEmptyAururaCOAddress2:"1466 S IDALIA ST", City:"AURORA",State:"CO",Zip4:"",Zip5:"80017",Error:null
NullIgnoreEl PasoTXEXCEPTION MESSAGE
Empty NullDenverCOEXCEPTION MESSAGE


Common Errors

Address Not Found.

If Address1 has a value that is invalid, null, or empty, the step will cause an error.

To correct this, ensure that the value entered or mapped for Address1 is correctly formatted.

Exception Message:

Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Normalize Address 1[NormalizeAddress] in flow [Flow 1]: Exception invoking method NormalizeAddress on class USPSSteps
 ---> DecisionsFramework.LoggedException: Exception invoking method NormalizeAddress on class USPSSteps
 ---> Decisions.USPS.USPSException: Address Not Found.
 at Decisions.USPS.USPSSteps.NormalizeAddress(String address1, String address2, String city, String state)
   --- End of inner exception stack trace --- at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data
 at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData
 at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)
   --- End of inner exception stack trace ---

Related Information

Forum Posts:
USPS Integration: Get State From Zip
USPS Module Example: Get City & State By Zip


Was this article helpful?