General Description of the Feature

Two new page have been developed, which give the opportunity to the admin users to handle and configure the available Address Formats and available Countries for these formats. A user can select and create a new "Address Format" which will be available per selected country.

The newly developed pages can be accessed through the following URLs and include grid lists with all the available Address Format and Countries records.

  • Address Formats: ~/SetupEntities/AddressFormatGridListPage
  • Countries: ~/SetupEntities/List/Administration/Country

Address Format

The related B1 table is OADF (Address Formats) with the primary key "Code". After the setup of an Address Format it is mandatory to bind this Address Format to the relevant Country/Region.

There are four possibly action within the Address format page:

  • The "+" symbol redirects you to the address format creation page
  • The row action "Edit" redirects you to the address format edit page
  • The row action "Delete" deletes the entry
  • Action button "Go to Country Setup" which redirect the user to the Country page.

In case that an Address format for a country already exists, the value can be edited and updated instead of creating a new one.

Address Format Creation/Edit Page: 

Details Tab:

  • Section Details
    • Address Format Code: Address Format primary key (On edit the value is not editable. On creation a unique integer value should be inserted)
    • Name: Address Format Name
    • OUSR Code: Select the User that will be noted as the owner. Usually is the admin user of the environment (i.e. manager)
  • 2nd Section
    • Check Format: Validates and represent you an example format according to the bellow choices
    • Format Example: Is filled with an example format from an existing address format (case of an edited format) or with an example format loaded by the "Check Format" button
  • Address Format Section: Position 0 to Position 11 are the address format types, that an address is filled from left to right in a formatted address. Position 0 Extra Format to Position 11 Extra Format are the extra formats of the position properties. (i.e. if "Position 0" = Country and in "Position 0 Extra Format" = Upper Case → This means that the Street inside any address that used this Address Format will always be displayed with all Capital letters)

 

Position Choices: 

  • Select: Leaves the position empty. This is where the user will choose to end the address format. Do not leave or set "Select", if there is a position with address format after this position. Do not set extra format for a position with this entry.
  • Block:  Set this position to represents a Block (e.g. Ave.) 
  • Building:  Set this position to represents a Building / Floor / Room (e.g. A1)
  • City:  Set this position to represents a City (e.g. San Francisco)
  • Country:  Set this position to represents a Country (e.g. USA)
  • County:  Set this position to represents a County (e.g. West Coast)
  • Delimiter:  Set this position to represents a Delimiter (","). Do not set extra format for a position with this entry.
  • Empty Space: Set this position to represents an Empty Space (" "). Do not set extra format for a position with this entry.
  • Street:  Set this position to represents a Street (e.g. Lombard)
  • Street No:  Set this position to represents a Street No (e.g. 34)
  • Zip Code:  Set this position to represents a Zip Code (e.g. 80300)

 

Position Extra Format Choices: 
Do not set extra format for an empty, "Delimiter", "Empty Space" Position

  • Select: Leaves the position without extra format. 
  • Capitalize: Set to upper the first letter of a format type
  • Lower Case: Set to lower case the letters of a format type
  • Upper Case: Set to upper case the letters of a format type

Countries

The related B1 table is OCRY (Countries) with the primary key "Code". This page is mostly created to set address formats to each Country on decoupled systems or check what are the available country entries. The grid list includes a big variety of countries, which can be edited through the relevant "Edit" row action for further information. The pop-up window includes several information that are relevant to accounting from each country when the system is linked with a DMS such as B1. 

When a user is creating a new Address format it is mandatory to edit the relevant country and in the field "Address Format" to select and add the relevant format.

Business Benefit

The administrator users are able to manage and configure new Address Formats from within DSW in cases of decoupled environments.

Configuration

None

  • The URL to access the Address Format page is: ~/SetupEntities/AddressFormatGridListPage
  • The Menu item is called: Address Format
  • The URL to access the Countries page is: ~/SetupEntities/List/Administration/Country
  • The Menu item is called: Countries

Additional Information

Feature No.: ODP-1155

Write a comment…