Difference between revisions of "Thai Localisation Project"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
m (Finalize the Installation)
(Download Source Codes)
 
(43 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''THIS PAGE IS UNDER CONSTRUCTION''' --[[User:Kittiu|Kittiu]] 03:36, 3 December 2010 (UTC)
+
== Headline text ==
 +
'''AUTHOR:''' [[User:Kittiu|Kittiu]]
  
'''AUTHOR:''' -
+
'''COMPANY:''' [http://www.ecosoft.co.th ecosoft]
 
+
'''COMPANY:''' -
+
  
 
Instructions for Adempiere version 3.6.0lts
 
Instructions for Adempiere version 3.6.0lts
 +
 +
==Overview of Features from this project==
 +
Localisation is an important need for implementing ERP in Thailand. In addition to Thai translation, there are certain features that is quite different from the use in other countries. The functionalities to be include in this project will include but not limited to
 +
*Localised Chart of Accounts
 +
*Localised Language of Translation
 +
*Localised Extension for [http://www.adempiere.com/index.php/Ecosoft/Thai_Withholding_Tax Thai Partial Withholding Tax]
 +
*Localised [[Billing feature]]
 +
*Localised Taxation
 +
*Localised City and Region Location Table (In Progress)
 +
 +
==Download Source Codes==
 +
This section contain all the source code that I did for this project. Everyone are free to download, explore and even enhance. This is by no mean the best solution for Thailand, but mere the result of a project implemented in Thailand by EcoSoft.
 +
#Thai Localisation and extension for Partial Withholding Tax ([https://bitbucket.org/kittiu/lco_360_extend_th_20110719/downloads Download])
 +
#*Source Codes
 +
#*Language Pack th_TH
 +
#*Sample Chart of Account - CoA_Thai_SME_manufacturing.xls
 +
#Bill Module ([https://bitbucket.org/kittiu/billing/downloads Download])
  
 
==Install Adempeire 3.6.0lts==
 
==Install Adempeire 3.6.0lts==
Line 12: Line 28:
 
You will find installation guides [[Getting Started]]. Do not forget to download and install the patches as instructed by [[Patches Installation]]
 
You will find installation guides [[Getting Started]]. Do not forget to download and install the patches as instructed by [[Patches Installation]]
  
==Install the language pack th_TH==
+
==Thai Language Pack Installation==
===Download files===
+
<pending>
+
 
+
All files required for this installation are on sourceforge in the folder Adempiere Localization Thailand, the instructions have the individual link for each file.
+
Download the script Change_language_to_es_CO.sql and run it in your database
+
Download the xml file of the translation, you can download them all as one file th_TH_XXXXXX.zip
+
Unzip in a directory th_TH_XXXXXX.zip
+
 
+
==Language Pack Installation==
+
  
 
Package install Translation
 
Package install Translation
Line 38: Line 45:
  
 
==Installation Steps==
 
==Installation Steps==
The Thai Localisation is based on Colombian Colombia Localisation, as such, there are certain JAR and Packages that are required to install first. The Thai Localisation's JAR files will overwrite the Colombian one to extend some features that is required for Thailand, i.e., Partial Withholding Tax.
+
The Thai Localisation is based on Colombia Localisation, as such, there are certain JAR and Packages that are required to install first. Although, not all the JAR and Packages is needed, you might want to explore these excellent package from here [http://translate.google.com/translate?hl=en&ie=UTF-8&sl=es&tl=en&u=http://www.adempiere.com/index.php/LCO_Instrucciones_Instalacion&prev=_t&rurl=translate.google.com#Instalar_Localizaci.C3.B3n_Colombia LCO Installation Instruction].
  
'''Install Prerequisite'''
+
The Thai Localisation's JAR files will overwrite the Colombian one to extend some features that is required for Thailand, i.e., Partial Withholding Tax.
#Download the Colombian JAR file packages_LCO360lts_20100617.jar
+
 
#*Renaming to packages_LCO360lts_20100617.jar --> LCO_original.jar
+
===Install Prerequisite (Colombian's JAR)===
 +
#Download the Colombian JAR file [https://sourceforge.net/projects/adempiere/files/Adempiere%20Localization/Colombia/360lts/packages_LCO360lts_20110504.jar/download packages_LCO360lts_20110504.jar]
 +
#*Renaming to packages_LCO360lts_20110504.jar --> LCO_original.jar
 
#*Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
 
#*Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
 
#*Copy this LCO_original.jar into this directory (not that, the naming is important to ensure that the Run Time pickup JAR files in correct order)
 
#*Copy this LCO_original.jar into this directory (not that, the naming is important to ensure that the Run Time pickup JAR files in correct order)
#Download the PackIn Package LCO_Retenciones.zip
+
#Download the PackIn Package [https://sourceforge.net/projects/adempiere/files/Adempiere%20Localization/Colombia/342s/LCO_Retenciones_20090827.zip/download LCO_Retenciones_20090827.zip]
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Type: File
 
#*Type: File
#*Source: [directory] / LCO_Retenciones.zip
+
#*Source: [directory] / LCO_Retenciones_20090827.zip
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*NO MARK Dict Override
 
#*NO MARK Dict Override
#*WARNING! Import the package LCO_Retenciones.zip - model adds a validator for all existing companies at the time of import.
+
#*WARNING! Import the package LCO_Retenciones_20090827.zip - model adds a validator for all existing companies at the time of import.
  
'''Install Thai Localisation Standard'''
+
===Install Extension for Partial Withholding Tax===
#Download the Thai JAR file <LCO_extension.jar>
+
Download Page: [https://bitbucket.org/kittiu/lco_360_extend_th_20110719/downloads here]
 +
#Download the Thai JAR file '''package_lco_360_extend_th_20110719.jar'''
 
#*Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
 
#*Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
 
#*Copy this file -- LCO_extension.jar -- into the same LCO / lib directory
 
#*Copy this file -- LCO_extension.jar -- into the same LCO / lib directory
 
#*WARNING! the naming is important to ensure that the Run Time pickup JAR files in correct order
 
#*WARNING! the naming is important to ensure that the Run Time pickup JAR files in correct order
#Download the PackIn Package LCO_Partial_Withholding.zip
+
#Download the PackIn Package '''LCO_Partial_Withholding.zip'''
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Type: File
 
#*Type: File
Line 64: Line 74:
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*NO MARK Dict Override
 
#*NO MARK Dict Override
#Download the PackIn Package Thai - Geography.zip
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Type: File
 
#*Source: [directory] /  Thai - Geography.zip
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*NO MARK Dict Override
 
  
'''Thai Withholding Tax Configuration'''
+
===Run migration script for function '''openinvoice'''===
 +
*Download the migration file '''Fix_func_openinvoice_for_withholding.sql''' and patch for underlining database.
 +
 
 +
===Thai Geography (Cities/Provinces)===
 +
When installing the package [[File:Thai-Geography.zip]] installed all Cities / Provinces in Thailand. You can always make changes in Country Region and City window.
 +
 
 +
===Thai Withholding Tax Configuration===
 +
 
 +
When installing the package [[File:Thai-Taxation.zip]] installed an example of Withholding Taxation Rules in Thailand. You can always make changes in Partial Withholding Configuration windows.
  
When installing the package Thai - Taxation.zip installed an example of Withholding Taxation Rules in Thailand. You can always make changes in Partial Withholding Configuration windows.
+
'''Note:''' This sample will upload for GardenWorld client. If you are playing with other client, make sure <data clientname="[your client]"> in PackOut.xml
  
 
==Install Additional Feature==
 
==Install Additional Feature==
'''Bill Acceptance Module (ใบวางบิล)'''
+
===Billing Module===
#Download the JAR file <BillAcceptance.jar>
+
#Download the JAR file Billing.jar from [https://bitbucket.org/kittiu/billing/downloads here]
#*Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ BillAcceptance \ lib
+
#*Copy this file --Billing.jar -- into the same LCO / lib directory
#*Copy this file -- BillAcceptance.jar -- into the same BillAcceptance / lib directory
+
#Download the Packin Package - Billing.zip from [https://bitbucket.org/kittiu/billing/downloads here]
#Download the Packin Package BillAcceptance.zip
+
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Enter Adempiere with System Administrator role and run Packin the following values:
 
#*Type: File
 
#*Type: File
#*Source: [directory] / BillAcceptance.zip
+
#*Source: [directory] / Billing.zip
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*Package dir: c: \ temp - anyone with write permission is temporary
 
#*NO MARK Dict Override
 
#*NO MARK Dict Override
Line 91: Line 102:
 
#Login as Client Admin
 
#Login as Client Admin
 
##Run Role Access Update to ensure that all newly installed process, the Client Admin will have the right to access.
 
##Run Role Access Update to ensure that all newly installed process, the Client Admin will have the right to access.
 +
##Run Verify Document Type to ensure the new Document Type and Periods is created for this client
 
##Run Update Sequence No to ensure that the new Document Type (i.e., Billing) will have the document sequence setup properly.
 
##Run Update Sequence No to ensure that the new Document Type (i.e., Billing) will have the document sequence setup properly.
 +
 +
[[Category:Localisation]]

Latest revision as of 21:13, 3 July 2012

Headline text

AUTHOR: Kittiu

COMPANY: ecosoft

Instructions for Adempiere version 3.6.0lts

Overview of Features from this project

Localisation is an important need for implementing ERP in Thailand. In addition to Thai translation, there are certain features that is quite different from the use in other countries. The functionalities to be include in this project will include but not limited to

Download Source Codes

This section contain all the source code that I did for this project. Everyone are free to download, explore and even enhance. This is by no mean the best solution for Thailand, but mere the result of a project implemented in Thailand by EcoSoft.

  1. Thai Localisation and extension for Partial Withholding Tax (Download)
    • Source Codes
    • Language Pack th_TH
    • Sample Chart of Account - CoA_Thai_SME_manufacturing.xls
  2. Bill Module (Download)

Install Adempeire 3.6.0lts

Install Adempiere normally 3.6.0lts

You will find installation guides Getting Started. Do not forget to download and install the patches as instructed by Patches Installation

Thai Language Pack Installation

Package install Translation

  1. Enter Adempiere with System Administrator role
  2. Open the "Language" window
    1. Setup Thai Language (TH) as System Language
    2. Click button "Language Maintenance" and click to "Add missing translation"
  3. Open the "Translation Import / Export"
    1. Select Thai Language option
    2. Leave fields blank (Client and Table)
    3. Press the Import button and select the directory where you downloaded or unzipped files th_TH xml translation
    4. When this process is complete you can close the window
  4. Run Synchronize Terminology process now
  5. Login again with Thai language, you will start seeing labels in Thai

Note: Not all the translation is completed. But you can always modify or add your own translation by using feature "Language Translation Check" window.

Installation Steps

The Thai Localisation is based on Colombia Localisation, as such, there are certain JAR and Packages that are required to install first. Although, not all the JAR and Packages is needed, you might want to explore these excellent package from here LCO Installation Instruction.

The Thai Localisation's JAR files will overwrite the Colombian one to extend some features that is required for Thailand, i.e., Partial Withholding Tax.

Install Prerequisite (Colombian's JAR)

  1. Download the Colombian JAR file packages_LCO360lts_20110504.jar
    • Renaming to packages_LCO360lts_20110504.jar --> LCO_original.jar
    • Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
    • Copy this LCO_original.jar into this directory (not that, the naming is important to ensure that the Run Time pickup JAR files in correct order)
  2. Download the PackIn Package LCO_Retenciones_20090827.zip
    • Enter Adempiere with System Administrator role and run Packin the following values:
    • Type: File
    • Source: [directory] / LCO_Retenciones_20090827.zip
    • Package dir: c: \ temp - anyone with write permission is temporary
    • NO MARK Dict Override
    • WARNING! Import the package LCO_Retenciones_20090827.zip - model adds a validator for all existing companies at the time of import.

Install Extension for Partial Withholding Tax

Download Page: here

  1. Download the Thai JAR file package_lco_360_extend_th_20110719.jar
    • Create the directory $ ADEMPIERE_HOME / packages / LCO / lib - in windows ->% ADEMPIERE_HOME% \ packages \ LCO \ lib
    • Copy this file -- LCO_extension.jar -- into the same LCO / lib directory
    • WARNING! the naming is important to ensure that the Run Time pickup JAR files in correct order
  2. Download the PackIn Package LCO_Partial_Withholding.zip
    • Enter Adempiere with System Administrator role and run Packin the following values:
    • Type: File
    • Source: [directory] / LCO_Partial_Withholding.zip
    • Package dir: c: \ temp - anyone with write permission is temporary
    • NO MARK Dict Override

Run migration script for function openinvoice

  • Download the migration file Fix_func_openinvoice_for_withholding.sql and patch for underlining database.

Thai Geography (Cities/Provinces)

When installing the package File:Thai-Geography.zip installed all Cities / Provinces in Thailand. You can always make changes in Country Region and City window.

Thai Withholding Tax Configuration

When installing the package File:Thai-Taxation.zip installed an example of Withholding Taxation Rules in Thailand. You can always make changes in Partial Withholding Configuration windows.

Note: This sample will upload for GardenWorld client. If you are playing with other client, make sure in PackOut.xml

Install Additional Feature

Billing Module

  1. Download the JAR file Billing.jar from here
    • Copy this file --Billing.jar -- into the same LCO / lib directory
  2. Download the Packin Package - Billing.zip from here
    • Enter Adempiere with System Administrator role and run Packin the following values:
    • Type: File
    • Source: [directory] / Billing.zip
    • Package dir: c: \ temp - anyone with write permission is temporary
    • NO MARK Dict Override

Finalize the Installation

  1. At %ADEMPIERE_HOME%, Run RUN_setup. [Bat / sh] or RUN_silentsetup. [Bat / sh] - this step should be integrated into the classes Adempiere.jar Colombia location
  2. Login as Client Admin
    1. Run Role Access Update to ensure that all newly installed process, the Client Admin will have the right to access.
    2. Run Verify Document Type to ensure the new Document Type and Periods is created for this client
    3. Run Update Sequence No to ensure that the new Document Type (i.e., Billing) will have the document sequence setup properly.