Formatting addresses and names in the tools

Address and name formatting in the WebSphere Commerce tools uses XML files to encapsulate the address or name format control information. The XML files hold the address or name control information such as what fields are required, the number of lines that constitute an address or name format, the sequence, and nature of address or name attributes that should be displayed on one line, and so on.

Procedure

  1. Create an XML file to hold your address format information. For example:
    
    <de_DE>
    <line0 elements="nickName"/>
    <line1 elements="title,space,firstName,space,lastName"/>
    <line2 elements="address1,space,address2,space,address3"/>
    <line3 elements="postalCode,space,city"/>
    <line4 elements="region,comma,space,country"/>
    <line5 elements="phoneNumber"/>
    </de_DE>
    

    For a sample implementation, see:

    • AIXLinux WC_installdir/xml/tools/order/addressFormats.xml
    • For IBM i OS operating system WC_userdir/xml/tools/order/addressFormats.xml
    • WindowsWC_installdir\xml\tools\order\addressFormats.xml
    • WebSphere Commerce Developerworkspace_dir\wc\xml\tools\order\addressFormats.xml
  2. Use the tools framework XMLUtil.get(Hashtable tree, String path) to parse your XML file. This method is one of the utility classes to read and write XML files and strings contained in the tools framework. When reading XML files and strings, these parsers convert the XML data into a hashtable.
  3. Use the address format control information stored in the hashtable created in the previous step to display the formatted address attributes to the end user as shown in the following is an example:
    • AIXLinuxWC_installdir/wc.ear/CommerceAccelerator.war/tools/order/OrderBillingAddressPage.jsp
    • For IBM i OS operating system WC_userdir/wc.ear/CommerceAccelerator.war/tools/order/OrderBillingAddressPage.jsp
    • WindowsWC_installdir\wc.ear\CommerceAccelerator.war\tools\order\OrderBillingAddressPage.jsp
    • WebSphere Commerce DeveloperWCDE_installdir\wc.ear\CommerceAccelerator.war\tools\order\OrderBillingAddressPage.jsp