Difference between revisions of "FAQ"

From ADempiere
Jump to: navigation, search
This Wiki is read-only for reference purposes to avoid broken links.
(I Cannot Add New Record in Role Record Access)
m (Fix Link)
 
(18 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
PENDING TASK: Merge this page with -> [[HOWTOs_and_FAQs]]
 +
 
==Frequently Asked Questions==
 
==Frequently Asked Questions==
  
Line 7: Line 9:
 
=== Starting ===
 
=== Starting ===
  
==== I have this problem (generic) ====
+
{{FAQ|question=I have this problem (generic)|answer=Are you sure you have already searched the proper resources?
  
Are you sure you have already searched the proper resources?
+
:Before posting a forum message or opening a tracker, please search information about your issue with these links:
  
Please before posting a forum message or opening a tracker search information about your issue with these links:
+
:* [https://sourceforge.net/search/?group_id=176962&type_of_search=forums Adempiere forums search]
 +
:* [https://sourceforge.net/search/?group_id=176962&type_of_search=artifact Adempiere trackers search]
 +
:* [https://sourceforge.net/search/?group_id=29057&type_of_search=forums Compiere forums search]
 +
:* [https://sourceforge.net/search/?group_id=29057&type_of_search=artifact Compiere trackers search]
 +
:* [http://www.google.com/coop/cse?cx=016889972604713699431%3Avravql1hghw Wiki google search]
  
* [https://sourceforge.net/search/?group_id=176962&type_of_search=forums Adempiere forums search]
+
:{{Note|Recommendation, bookmark all those links in a firefox folder, and when looking for an issue use the firefox tool "Open all in tabs".}}
* [https://sourceforge.net/search/?group_id=176962&type_of_search=artifact Adempiere trackers search]
+
* [https://sourceforge.net/search/?group_id=29057&type_of_search=forums Compiere forums search]
+
* [https://sourceforge.net/search/?group_id=29057&type_of_search=artifact Compiere trackers search]
+
* [http://www.google.com/coop/cse?cx=016889972604713699431%3Avravql1hghw Wiki google search]
+
  
Recommendation, bookmark all those links in a firefox folder, and when looking for an issue use the firefox tool "Open all in tabs".
+
:Also, don't forget to search this wiki.  You can search by term, or look at the special pages, like the categories, to find information.}}
  
==== Which are the user and password to enter into the "out of the box" installation ====
+
{{FAQ|question=Which are the user and password to enter into the "out of the box" installation?|answer=Find the answers here: [[Logging In to the Client]]}}
 +
{{FAQ|question=How can I create a new client?|answer=Please check this [[ManPageX_InitialClientSetup|Manual Page for Initial Client Setup]]}}
 +
{{FAQ|question=How can I find out what error has occured?|answer=Adempiere has several possibilities for finding out what went wrong.
  
Check the [[OnlineLoginHelp|Online Login Help]]
+
:* Starting Adempiere from a console, you'll see log messages on it. The granularity of the log messages can be controlled via menue Tools/Preference. There you select the desired trace level.
 +
:* If you check the check box "Trace file" in menue Tools/Preference, you'll find the log in $ADEMPIERE_HOME/log
 +
:* In Adempiere, menue Tools/Preference, tab "errors" also contain information about errors.
 +
:* The bottom-left button "Notice" in Adempiere main window shows mostly accounting machine error messages. There is a reference to the documents involved. These messages are also seen on the Application Server console.
 +
:* If you start a process (like "Complete"), you'll find error messages on the bottom-left side of the corresponding window, like "Period closed" in a Sales Order.
 +
:* If you start a process and it is aborted for whatever reason, you can find the process involved and the errors; you can even abort the process. In order to achieve this, select icon "Processes involved"in the error window, then navigate in the "Workflow Process" window. You can abort the process in the "Process" tab, "Reference", button "Manage Process".
 +
:* If you work with Eclipse, you'll see log messages on the console view.
 +
:{{Note|'''''IMPORTANT''''': When asking for support in forums you'll get better attention if you post the log somewhere for people to check.  If the log is too big to be copied in a forum the recommendation is to open a support tracker and attach the log there.}} }}
  
==== I don't want to play with GardenWorld, how can I create a new client ====
+
=== General ===
  
Please check this [[ManPageX_InitialClientSetup|Manual Page for Initial Client Setup]]
+
{{FAQ|question=Where are the translation tabs?|answer=You must check the "Show translations" in Tools -> Preference. Also for some tables (like product) you must enable multi-language document in http://www.adempiere.com/index.php/ManPageW_Client#Window:_Client|Client] window.}}
  
 
=== Accounting ===
 
=== Accounting ===
  
==== "Your role does not allow you to view the accounting information" ====
+
See [[FAQ Accounting]]
  
Short answer:
+
=== Business Partners ===
 
+
1. Role -> Show Accounting
+
 
+
2. Tools -> Preferences -> Show Accounting Tabs
+
 
+
Long answer from Kathy Pink here -> [http://www.jorgjanke.com/2008/01/accounting-info.html Where is my Compiere Accounting Information?]
+
 
+
==== "Period Closed Error When Processing Documents" ====
+
 
+
1. Check if your period is open in Calendar, Year and Period.
+
 
+
2. Check if period control for your document base type is open
+
 
+
3. Untick Automatic Period Control in your accounting schema
+
  
 
=== Sales ===
 
=== Sales ===
  
==== "Product is not on PriceList" ====
+
{{FAQ|question="Product is not on PriceList"|answer=The price lists are specific to business partner groups.  You may have different price lists for each group.  Also, for each price list, you can have several versions of the list.  The product being sold or purchased must exist on the version of the price list associated with the business partner or you will have to change the price list used on the order/requisition. Also check the valid date from field.
  
You need to make sure that you have updated the corresponding version price list, go to the prices list window pricelist then click on the tab and press the create price list button. Do that for every single price list version just to make sure that you have not missed one of them, you must begin with the purchase price list.
+
:You can add products to specific price list versions through either the Price List >> Version window or the Product >> Price List window.}}
 
+
Also check the valid date from field.
+
  
 
=== Purchase ===
 
=== Purchase ===
  
 
=== Business Partners ===
 
  
 
=== Security (User/Role related) ===
 
=== Security (User/Role related) ===
  
==== I Cannot Add New Record in Role Record Access ====
+
{{FAQ|question=I Cannot Add New Record in Role Record Access|answer=Please read the manual page for [[ManPageW_RoleDataAccess#Tab:_Record_Access|Record Access Tab]]}}
  
Please read the manual page for [[ManPageW_RoleDataAccess#Tab:_Record_Access|Record Access Tab]]
+
{{FAQ|question=How can I disable parts of the menu?|answer=Adempiere menu options are role based. For example if you want to hide all the HR related options, you will need to disable all the process, windows, forms, workflows related to HR. To do this:
  
 +
:# You need to login in your Client to the role window.
 +
:# Select the role that you want to disable. For example to disable the Payroll Contract Window:
 +
::# Windows Access:
 +
::# Select Payroll Contract
 +
::# Click on the Active checkbox and make sure that it is unselected.
 +
:# Repeat the same procedure for every single item that you want to disable/enable
  
==== How to disable parts of the menu ====
+
:Another option is to create new menus - one per role - and assign those to the different roles. Follow these steps:
 
+
:# Login to GardenWorld as GardenAdmin.
Adempiere menu options is role based.
+
:# A menu is a "tree" so in System Admin->General Rules-System Rules->Tree window create a new tree called "newMenu" select "Menu" for the type.
 
+
:# In the window below that "Tree Maintenance". Select the tree newMenu from the dropdown top left.
You will need to disable all the process, windows, forms, workflows related to HR.
+
:# Select the menu items on the left and use the arrow to move menu items onto into the menu menu. Be careful because it's not very user friendly and if you make a mistake like hitting the add all button it can be time consuming as you can only add/remove items all together or one at a time.
+
:# When you are done with the newMenu open the System Admin->General Rules->Security->Role window.  Select the GardenUser role and assign the newMenu by selecting it in the menu Tree.
You need to login in your Client to the role window. 
+
:# Logout and login again with GardenUser and you should have the menu as defined by newMenu.
+
}}
Select the role that you want to disable.
+
+
For example to disable the Payroll Contract Window:  
+
+
Windows Access:
+
Select Payroll Contract
+
Click on the Active checkbox and make sure that it is unselected.
+
+
Repeat the same procedure for every single item that you want to disable/enable
+
 
+
Another option is create new menus - one per role - and assign those to the different roles.
+
 
+
Steps
+
1. Login to GardenWorld with GardenAdmin
+
2. A menu is a "tree" so in System Admin->General Rules-System Rules->Tree window
+
create a new tree called "newMenu" select "Menu" for the type.
+
3. In the window below that "Tree Maintenance".
+
  Select the tree newMenu from the dropdown top left.
+
4. select the menu items on the left and use the arrow to move menu items onto
+
into the menu menu. Be careful because it's not very user friendly and if you
+
make a mistake like hitting the add all button it can be time consuming as you
+
can only add/remove items all together or one at a time.
+
5. when you are done with the newMenu open the System Admin->General
+
Rules->Security->Role window.  Select the GardenUser role and assign the newMenu
+
tby selecting it in the menu Tree.
+
6. Logout and login again with GardenUser and you should have the menu as defined
+
by newMenu.
+
 
+
 
=== Technical ===
 
=== Technical ===
  
==== I cannot add new record in my Window ====
+
{{FAQ|question=I cannot add a new record in my Window - why?|answer=Possibly the tab is marked to avoid record insertion
 
+
:# Login into "System" Client  
Possibly the tab is marked to avoid record insertion
+
:# Search for your window in "Window, Tab, & Field"
# Login into "System" Client  
+
:# Move and select your tab
# Search for your window in "Window, Tab, & Field"
+
:# Tick "Insert Record" checkbox
# Move and select your tab
+
}}
# Tick "Insert Record" checkbox
+
 
+
  
 
=== Developing ===
 
=== Developing ===
  
==== Where can I find documentation to help me understand Adempiere's code? ====
+
{{FAQ|question=Where can I find documentation to help me understand Adempiere's code?|answer=See [http://downloads.sourceforge.net/adempiere/DeveloperGuide.pdf? Developer's Guide] by Mario Calderon. Sometimes you better choose another mirror if the default one doesn' work. It is a bit outdated, but helps you understanding the code.
  
See [http://downloads.sourceforge.net/adempiere/DeveloperGuide.pdf? Developer's Guide] by Mario Calderon. Sometimes you better choose another mirror if the default one doesn' work. It is a bit outdated, but helps you understanding the code.
+
:Pelgrim wrote a very detailed graphical description of the classes involved in ADempiere. See his [http://adempiere.org/schema/ADempiereFunctionalbasics.html Adempiere Schema].
  
Also take a look at [http://www.adempiere.com/index.php/Category:Developer_documentation Developer documentation]  and [http://www.adempiere.com/index.php/Category:Development Development] or [http://www.adempiere.com/index.php/Help:Makingsence Makingsence] .
+
:Also take a look at [http://www.adempiere.com/index.php/Category:Developer_documentation Developer documentation]  and [http://www.adempiere.com/index.php/Category:Development Development] , [http://www.adempiere.com/index.php/Help:Makingsence Makingsence] or [http://www.adempiere.com/technical/340/schemaspy Schema spy] by Carlos Ruiz.
  
[http://www.knowledgesuccess.com/local/doc/docbook/compieresurvivalguide/book.html Compiere Survival Guide] by Neil Gordon is eclectic, outdated and about Compiere, but can be helpful because it's also very comprehensive.
+
:[http://www.knowledgesuccess.com/local/doc/docbook/compieresurvivalguide/book.html Compiere Survival Guide] by Neil Gordon is eclectic, outdated and about Compiere, but can be helpful because it's also very comprehensive.
 +
}}
  
 
=== Zk Web Client ===
 
=== Zk Web Client ===
==== Which browser is supported ====
+
{{FAQ|question=Which browser is supported?|answer=The primary browser supported is FireFox 3+. Google Chrome is also supported but is not test as often. IE is not supported at the moment as the underlying Zk framework have significant performance problem on IE.}}
The primary browser supported is FireFox 3+. Google Chrome is also supported but is not test as often. IE is not supported at the moment as the underlying Zk framework have significant performance problem on IE.
+
  
 
[[Category:FAQs]]
 
[[Category:FAQs]]

Latest revision as of 06:55, 11 July 2010

PENDING TASK: Merge this page with -> HOWTOs_and_FAQs

Frequently Asked Questions

Here is a repository to contribute the answers to the frequently asked questions in sourceforge forums.

Please don't ask questions here - answers must be from the most common questions on forums.

Starting

Q: I have this problem (generic)
Are you sure you have already searched the proper resources?
Before posting a forum message or opening a tracker, please search information about your issue with these links:
Note.gif Note:

Recommendation, bookmark all those links in a firefox folder, and when looking for an issue use the firefox tool "Open all in tabs".

Also, don't forget to search this wiki. You can search by term, or look at the special pages, like the categories, to find information.


Q: Which are the user and password to enter into the "out of the box" installation?
Find the answers here: Logging In to the Client
Q: How can I create a new client?
Please check this Manual Page for Initial Client Setup
Q: How can I find out what error has occured?
Adempiere has several possibilities for finding out what went wrong.
  • Starting Adempiere from a console, you'll see log messages on it. The granularity of the log messages can be controlled via menue Tools/Preference. There you select the desired trace level.
  • If you check the check box "Trace file" in menue Tools/Preference, you'll find the log in $ADEMPIERE_HOME/log
  • In Adempiere, menue Tools/Preference, tab "errors" also contain information about errors.
  • The bottom-left button "Notice" in Adempiere main window shows mostly accounting machine error messages. There is a reference to the documents involved. These messages are also seen on the Application Server console.
  • If you start a process (like "Complete"), you'll find error messages on the bottom-left side of the corresponding window, like "Period closed" in a Sales Order.
  • If you start a process and it is aborted for whatever reason, you can find the process involved and the errors; you can even abort the process. In order to achieve this, select icon "Processes involved"in the error window, then navigate in the "Workflow Process" window. You can abort the process in the "Process" tab, "Reference", button "Manage Process".
  • If you work with Eclipse, you'll see log messages on the console view.
Note.gif Note:

IMPORTANT: When asking for support in forums you'll get better attention if you post the log somewhere for people to check. If the log is too big to be copied in a forum the recommendation is to open a support tracker and attach the log there.

General

Q: Where are the translation tabs?
You must check the "Show translations" in Tools -> Preference. Also for some tables (like product) you must enable multi-language document in http://www.adempiere.com/index.php/ManPageW_Client#Window:_Client

Accounting

See FAQ Accounting

Business Partners

Sales

Q: "Product is not on PriceList"
The price lists are specific to business partner groups. You may have different price lists for each group. Also, for each price list, you can have several versions of the list. The product being sold or purchased must exist on the version of the price list associated with the business partner or you will have to change the price list used on the order/requisition. Also check the valid date from field.
You can add products to specific price list versions through either the Price List >> Version window or the Product >> Price List window.

Purchase

Security (User/Role related)

Q: I Cannot Add New Record in Role Record Access
Please read the manual page for Record Access Tab


Q: How can I disable parts of the menu?
Adempiere menu options are role based. For example if you want to hide all the HR related options, you will need to disable all the process, windows, forms, workflows related to HR. To do this:
  1. You need to login in your Client to the role window.
  2. Select the role that you want to disable. For example to disable the Payroll Contract Window:
  1. Windows Access:
  2. Select Payroll Contract
  3. Click on the Active checkbox and make sure that it is unselected.
  1. Repeat the same procedure for every single item that you want to disable/enable
Another option is to create new menus - one per role - and assign those to the different roles. Follow these steps:
  1. Login to GardenWorld as GardenAdmin.
  2. A menu is a "tree" so in System Admin->General Rules-System Rules->Tree window create a new tree called "newMenu" select "Menu" for the type.
  3. In the window below that "Tree Maintenance". Select the tree newMenu from the dropdown top left.
  4. Select the menu items on the left and use the arrow to move menu items onto into the menu menu. Be careful because it's not very user friendly and if you make a mistake like hitting the add all button it can be time consuming as you can only add/remove items all together or one at a time.
  5. When you are done with the newMenu open the System Admin->General Rules->Security->Role window. Select the GardenUser role and assign the newMenu by selecting it in the menu Tree.
  6. Logout and login again with GardenUser and you should have the menu as defined by newMenu.

Technical

Q: I cannot add a new record in my Window - why?
Possibly the tab is marked to avoid record insertion
  1. Login into "System" Client
  2. Search for your window in "Window, Tab, & Field"
  3. Move and select your tab
  4. Tick "Insert Record" checkbox

Developing

Q: Where can I find documentation to help me understand Adempiere's code?
See Developer's Guide by Mario Calderon. Sometimes you better choose another mirror if the default one doesn' work. It is a bit outdated, but helps you understanding the code.
Pelgrim wrote a very detailed graphical description of the classes involved in ADempiere. See his Adempiere Schema.
Also take a look at Developer documentation and Development , Makingsence or Schema spy by Carlos Ruiz.
Compiere Survival Guide by Neil Gordon is eclectic, outdated and about Compiere, but can be helpful because it's also very comprehensive.

Zk Web Client

Q: Which browser is supported?
The primary browser supported is FireFox 3+. Google Chrome is also supported but is not test as often. IE is not supported at the moment as the underlying Zk framework have significant performance problem on IE.