Plugin: LCO Detailed Names

From iDempiere en
Jump to: navigation, search
Qss.jpg


Description

This functionality adds six fields in the Business Partner window: Tax ID Type, First Name 1/2, Last Name 1/2, Verification Digit

The tax ID type defines if one name is captured, or first and last names are captured. It also defines if a verification digit must be calculated or verified for the Tax ID field.

Note that functionality adds two first names and two last names, in case you want to use just one is easy to hide the corresponding second fields using the Window Customization

Feedback

Please rate this plugin:

Current user rating: 99/100 (7 votes)

 You need to enable JavaScript to vote


TimeRatingUser
April 27, 2015, 3:49 pm100%Diego.ruiz
December 16, 2013, 12:40 pm93%Ken longnan
December 12, 2013, 8:26 pm100%CarlosRuiz
December 12, 2013, 5:28 pm100%Spina
December 11, 2013, 3:21 pm100%Tioraul
December 10, 2013, 10:10 pm100%IDempierefr
December 10, 2013, 8:52 pm100%Ocurieles


If you want to provide additional comments, please use the Discussion page

Configuration

SysConfig Parameters

The following System Configurator parameters can be used to modify the behavior of this functionality:

  • LCO_USE_DETAILED_NAMES
    • If you define this parameter as N in a client then the whole functionality of detailed names will be disabled for this client
    • Default: Y
    • Scope: Client
  • QSSLCO_FillValueWithTaxID
    • This is used to fill by default the Search Key of a Business Partner from the TaxID field
    • Default: N
    • Scope: Client
  • QSSLCO_NameSeparator
    • When using detailed names, it defines here the separator for the Name field on business partner when concatenating the first names with last names
    • Default: WhiteSpace
    • Scope: Client
  • QSSLCO_NamesFirst
    • When using detailed names, it defines if the first names will be first, otherwise the last names will be first
    • Default: Y
    • Scope: Client

Tax ID Type Window

The Tax Id Type let you define the different types of tax IDs that you want to manage as well as some configuration:

LCO TaxIDType.png

  • Use Tax ID Digit: It defines if a tax ID Digit must be shown on the Business Partner window
  • Is Digit Checked: It defines how is the tax ID Digit checked:
    • Callout: digit check is generated automatically and immediately after the tax ID field is filled
    • Generate: digit check is generated when the record is saved
    • Check: digit check is not generated, but compared and validated against user captured value
  • Country: The country is required to define the digit check validation, the LCO plugin implements the validation for Colombia and Ecuador, this can be OSGi extended for other countries implementing the interface org.globalqss.util.ILCO_TaxIDDigit and defining the property country with the corresponding country code that it implements.
  • Detailed Names: It defines if the business partner must allow capturing first/last name(s) - used for persons
  • Minimum/Maximum Length: It defines the minimum and maximum length allowed for this document type, zero means no validation
  • Tax Code: External code for this tax ID type - for reporting purposes
  • Default: Used to define which is the default tax ID type

Usage

Business Partner

LCO BPDetailedNames.png


How to Install

P2 Repository

The recommended way to install the plugin is using the p2 repository.

REPO=http://ci.idempiere.org/job/globalqss-iDempiere-LCO/ws/buckminster.output/org.globalqss.update_6.2.0-eclipse.feature/site.p2/
cd /opt/idempiere-server  # Where your iDempiere server is installed
bash update-prd.sh $REPO org.globalqss.idempiere.LCO.feature.group

This will install the four plugins of the LCO, you could install also the single plugin changing the org.globalqss.idempiere.LCO.feature.group by org.globalqss.idempiere.LCO.detailednames

Felix console

To install the plugin using the felix console (not recommended) you can download the plugin jar org.globalqss.idempiere.LCO.detailednames* directly from the p2 repo and use the felix console to install as usual.