Implementation Guide for
configuring Internationalization for
Kuali OLE
Version 1.0
Table of Contents
1.
Date FORMAT Configuration
3
2.
CURRENCY SYMBOL AND FORMAT Configuration
4
3.
CUSTOM LABELS Configuration
5
4.
POSTAL CODE VALIDATION Configuration
8
5.
PHONE NUMBER VALIDATION Configuration
9
APPENDIX
OLE- I18N Configuration guide
10
Page 1 of 12
DOCUMENT HISTORY
Version
Ver 1.0
Author
Gayathri Ahok
OLE- I18N Configuration guide
Date
Dec 23, 2014
Review
Srini Induri
Page 2 of 12
1. Date FORMAT Configuration
This section helps to configure date format for Kuali OLE.
Please follow the following steps to configure the date format:
1. Go to “custom-common-config-defaults.xml” file
(/ole-app/olefs/src/main/resources/org/kuali/ole/custom-common-config-defaults.xml)
To configure application date format as “DD/MM/YYYY” uncomment/ unblock section “Date
Format : dd/MM/yyyy (date-month-year)”
To configure application date format as “MM/DD/YYYY” uncomment/ unblock section “Date
Format : MM/dd/yyyy (month-date-year)”
2. Go to “oledocstore-config-defaults.xml” file
(ole-docstore/ole-docstore-webapp/src/main/resources/org/kuali/ole/oledocstore-configdefaults.xml)
Configure the required date format for the parameter “info.DateFormat”.
Example:
<param name="info.DateFormat">MM/dd/yyyy</param>
OLE- I18N Configuration guide
Page 3 of 12
2. CURRENCY SYMBOL AND FORMAT Configuration
To configure currency symbol and formats please follow the below steps:
1. Add Locale code in VM options : -Duser.country=US
2. Go to “custom-common-config-defaults.xml”
(/ole-app/olefs/src/main/resources/org/kuali/ole/custom-common-config-defaults.xml)
Change the “config.base.currency” parameter to the institution specific currency name.
Example:
<param name="config.base.currency">US Dollar</param>
Below table lists few LOCALE Codes and Currency of the country. For full list please see the
appendix.
S.No
1
2
3
4
5
6
Country
United States
United Kingdom
France
Germany
India
Japan
Code
US
GB
FR
DE
IN
JP
OLE- I18N Configuration guide
Currency
US Dollar
Pound Sterling
Euro
Euro
Indian Rupee
Japanese Yen
Page 4 of 12
3. CUSTOM LABELS Configuration
To configure custom labels for internationalization, development team followed RICE guidelines.
Rice framework has a feature to externalize the Message Repositories, where messages are
stored in a property file and it can read and displayed anywhere in the KNS and KRAD screens.
wiki link - > https://wiki.kuali.org/display/KULRICE/External+Messages+Repository
Changing labels in screens (primarily in view XML files)
Step 1: Create these properties file in the corresponding paths.
A property file to hold name value (new label) pair should be created for each module in OLE.
Country code in the name of the file will be different for each country. Following are the list for
files for United States.
1. Chart of Accounts: Labels-Coa_en_US.properties
Path: ole-app/olefs/src/main/resources/org/kuali/ole/coa/
2. Deliver: Labels-Deliver_en_US.properties
Path: ole-app/olefs/src/main/resources/org/kuali/ole/deliver/
3. Describe: Labels-Describe_en_US.properties
Path: ole-app/olefs/src/main/resources/org/kuali/ole/describe/
4. General Ledger: Labels-Gl_en_US.properties
Path: /ole-app/olefs/src/main/resources/org/kuali/ole/gl/
5. Module: Labels-Module_en_US.properties
Path: /ole-app/olefs/src/main/resources/org/kuali/ole/module/
6. Select and Acquire: Labels-Select_en_US.properties
Path: ole-app/olefs/src/main/resources/org/kuali/ole/select/
7. Vendor: Labels-vnd_en_US.properties
Path: /ole-app/olefs/src/main/resources/org/kuali/ole/vnd/
Step 2: To change the labels in a screen add Bean IDs in the respective property file based on
the module.
Example: To replace labels in the select and acquire module (acquisitions), add Bean IDs in the
Labels-Select_en_US.properties file.
To change the label “* Dollar $” in accounting lines of requisition screen to “* Amount”
Edit the below property file with following name/value pair
OLE- I18N Configuration guide
Page 5 of 12
File : /org/kuali/ole/select/Labels-Select_en_GB.properties
Value :@cmp{additionalItem-amount}#label=Amount
Syntax for value : @cmp(<bean_id>)#<propertyName>=<value>
Screen with label “* Dollar $” (Before Label Change)
Screen with label “* Amount” (After Label Change)
Changing label text for
1.
2.
3.
4.
Section Header
Links
Tab Text
Screen Header Text
Note: Primarily these labels are in tag and jsp files
Example:
Changing 'Cataloging Admin' to 'Cataloguing Admin' in oleCatalogingAdmin.tag
Step 1: Go to ole-lable-properties-config.xml properties file.
Path: ole-app/olefs/src/main/resources/org/kuali/ole/
Step 2: Add or Change the parameter.
<param name="CatalogingAdmin">Cataloguing Admin</param>
Step3: Modify the oleCatalogingAdmin.tag (ole-app/olefs/src/main/webapp/WEBINF/tags/portal/channel/oleMaintenance/oleCatalogingAdmin.tag)
OLE- I18N Configuration guide
Page 6 of 12
From:
<channel:portalChannelTop channelTitle="Cataloging Admin"/>
To:
<channel:portalChannelTop channelTitle="${ConfigProperties.CatalogingAdmin}"/>
OLE- I18N Configuration guide
Page 7 of 12
4. POSTAL CODE VALIDATION Configuration
This section helps to configure Postal Code Validation for Kuali OLE.
Please follow the following steps to configure the postal code.
1. Go to “ApplicationResources.properties” file
(/ole-app/olefs/src/main/java/org/kuali/rice/krad/ApplicationResources.properties)
And
ole-app/olefs/src/main/resources/org/kuali/rice/krad/ApplicationResources.properties
To configure application postal code validation, change the required Regex in the
“validationPatternRegex.zipcode” property for the zip code validation in both the files.
Example :
validationPatternRegex.zipcode= [\\w\\s]{0,20}
OLE- I18N Configuration guide
Page 8 of 12
5. PHONE NUMBER VALIDATION Configuration
This section helps to configure Phone Number Validation for Kuali OLE.
Please follow the following steps to configure the phone number.
1. Go to “ApplicationResources.properties” file
(/ole-app/olefs/src/main/java/org/kuali/rice/krad/ApplicationResources.properties)
And
ole-app/olefs/src/main/resources/org/kuali/rice/krad/ApplicationResources.properties
To configure application phone number validation, change required the Regex for the phone
number in the 'validationPatternRegex.phoneNumber' property in both the files
Example :
validationPatternRegex.phoneNumber=[a-zA-Z0-9\-+!.>@#$%^&*()_<?,]{0,20}+$
OLE- I18N Configuration guide
Page 9 of 12
APPENDIX
S No
Country Name
1
2
3
4
5
6
7
8
9
Albania
Algeria
Argentina
Australia
Austria
Bahrain
Belarus
Belgium
Bolivia
Bosnia and
Herzegovina
Brazil
Bulgaria
Canada
Chile
China
Colombia
Costa Rica
Croatia
Cyprus
Czech Republic
Denmark
Dominican Republic
Ecuador
Egypt
El Salvador
Estonia
Finland
France
Germany
Greece
Guatemala
Honduras
Hong Kong
Hungary
Iceland
India
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
OLE- I18N Configuration guide
Country
Code
AL
DZ
AR
AU
AT
BH
BY
BE
BO
BA
BR
BG
CA
CL
CN
CO
CR
HR
CY
CZ
DK
DO
EC
EG
SV
EE
FI
FR
DE
GR
GT
HN
HK
HU
IS
IN
Currency
Albanian Lek
Algerian Dinar
Argentine Peso
Australian Dollar
Euro
Bahraini Dinar
Belarusian Ruble
Euro
Bolivian Boliviano
Bosnia-Herzegovina Convertible
Mark
Brazilian Real
Bulgarian Lev
Canadian Dollar
Chilean Peso
Chinese Yuan
Colombian Peso
Costa Rican Col‫ﺃ‬٣n
Croatian Kuna
Euro
Czech Republic Koruna
Danish Krone
Dominican Peso
US Dollar
Egyptian Pound
Salvadoran Col‫ﺃ‬٣n
Estonian Kroon
Euro
Euro
Euro
Euro
Guatemalan Quetzal
Honduran Lempira
Hong Kong Dollar
Hungarian Forint
Icelandic Kr‫ﺃ‬٣na
Indian Rupee
Page 10 of 12
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
Indonesia
Iraq
Ireland
Israel
Italy
Japan
Jordan
Kuwait
Latvia
Lebanon
Libya
Lithuania
Luxembourg
Macedonia
Malaysia
Malta
Mexico
Montenegro
Morocco
Netherlands
New Zealand
Nicaragua
Norway
Oman
Panama
Paraguay
Peru
Philippines
Poland
Portugal
Puerto Rico
Qatar
Romania
Russia
Saudi Arabia
Serbia
Serbia and Montenegro
Singapore
Slovakia
Slovenia
South Africa
OLE- I18N Configuration guide
ID
IQ
IE
IL
IT
JP
JO
KW
LV
LB
LY
LT
LU
MK
MY
MT
MX
ME
MA
NL
NZ
NI
NO
OM
PA
PY
PE
PH
PL
PT
PR
QA
RO
RU
SA
RS
CS
SG
SK
SI
ZA
Indonesian Rupiah
Iraqi Dinar
Euro
Israeli New Sheqel
Euro
Japanese Yen
Jordanian Dinar
Kuwaiti Dinar
Latvian Lats
Lebanese Pound
Libyan Dinar
Lithuanian Litas
Euro
Macedonian Denar
Malaysian Ringgit
Euro
Mexican Peso
Euro
Moroccan Dirham
Euro
New Zealand Dollar
Nicaraguan C‫ﺃ‬٣rdoba
Norwegian Krone
Omani Rial
Panamanian Balboa
Paraguayan Guarani
Peruvian Nuevo Sol
Philippine Peso
Polish Zloty
Euro
US Dollar
Qatari Rial
Romanian Leu
Russian Ruble
Saudi Riyal
Serbian Dinar
Serbian Dinar (2002-2006)
Singapore Dollar
Slovak Koruna
Euro
South African Rand
Page 11 of 12
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
South Korea
Spain
Sudan
Sweden
Switzerland
Syria
Taiwan
Thailand
Tunisia
Turkey
Ukraine
United Arab Emirates
United Kingdom
United States
Uruguay
Venezuela
Vietnam
Yemen
OLE- I18N Configuration guide
KR
ES
SD
SE
CH
SY
TW
TH
TN
TR
UA
AE
GB
US
UY
VE
VN
YE
South Korean Won
Euro
Sudanese Pound
Swedish Krona
Swiss Franc
Syrian Pound
New Taiwan Dollar
Thai Baht
Tunisian Dinar
Turkish Lira
Ukrainian Hryvnia
United Arab Emirates Dirham
Pound Sterling
US Dollar
Uruguayan Peso
Venezuelan Bol‫ﺝﺃ‬var
Vietnamese Dong
Yemeni Rial
Page 12 of 12