This is the documentation for older versions of Odoo (formerly OpenERP).

See the new Odoo user documentation.

See the new Odoo technical documentation.

To connect to Open ERP

Since this is the first time you've connected to it you'll have to go through the Setup wizard in steps:

  1. Select a profile : select Minimal Profile and click Next.

  2. At the Define Main Company step you should select your own Company Name and Currency, and address details on the first tab General Information; and add more details on the second tab Report Information including a logo, if you have one, that appears on reports. Click Next.

  3. At the Summary page you can go back to change details if you need. Click the Install button.

  4. Finally, at the Installation done page, click Start Configuration.

Configuration consists of a set of wizards that help you through options for the installed modules. Hardly anything is installed so this is a very simple process at the moment.

  1. At the first screen click Continue to go into the first wizard. Choose View Mode : Simplified Interface and then click Set to save it.

  2. Click Skip Step to step over the next wizard, which would enable you to add other users.

  3. You've now reached the end of the configuration so click Continue to start using the system as the Administrator.

Once you're displaying the main menu you're able to see the following screen items, as shown in screenshot Openerp 第二章(openerp_ch02) 数据库 主目录:

  • the Preferences toolbar to the top right, showing the user name, links to the Home page, Preferences, About and Logout,

  • just below you'll find information about the Request system,

  • links to the MAIN MENU and the SHORTCUTS,

  • information about copyright and the database you're logged into at the bottom of the page,

  • the main contents of the window with by the menu toolbar to the left: links generally line up on the right but there are none to show at the moment.


Openerp 第二章(openerp_ch02) 数据库 主目录

Two menus are available on the left:

  • Partners,

  • Administration.

Preferences toolbar

When you're connected to Open ERP the Preferences toolbar indicates which user you're connected as. So it should currently be showing Welcome Administrator (unless you logged in as another user and it's reflecting the name of that user instead).

You'll find a link to the Home page to its right. This takes you to either the dashboard or the available menus, depending on the user configuration. In the case of the openerp_ch02database so far the Home page is the Main Menu. But in general each user of the system is presented with a dashboard that's designed to show performance indicators and urgent documents that are most useful to someone of the user's position in the company. You'll see how to assign dashboards to different users in a later chapter, 配置与系统管理.


Multi-nationals and time zones


So if you have a team in India and a team in England, the times will automatically be converted. If an Indian employee sets her working hours from 9 to 6 that will be converted and saved in the server's timezone. When the English users want to set up a meeting with an Indian user, the Indian user's available time will be converted to English time.

The next element in the Toolbar is a link to Preferences. By clicking that link you reach a page where the current user can set their password, a timezone, a working language, and a signature:

  • The Password field gives the user the opportunity to change their own password. You should take steps (perhaps written policies) to prevent users making these too trivial.

  • The Language field enables the user's working language to be changed. But first the system must be loaded with other languages for the user to be able to choose an alternative, which is described in the next subsection of this chapter. This is a mandatory field, although might initially be set as blank.

  • The Timezone setting indicates the user's location to Open ERP. This can be different from that of the server. All of the dates in the system are converted to the user's timezone automatically.

  • 签名 (Signature) 字段是给用户填写签名的位置,这个签名将会附加到从OpenERP发出的信息后面。

The About link gives information about the development of the Open ERP software and various links to other information.

The Logout link enables you to logout and return to the original login page. You can then login to another database, or to the same database as another user. This page also gives you access to the super-administrator functions for managing databases on this server.

The Requests link sits just below this toolbar. It is only visible if you're logged into a database. If your database is new it will say No request. You can click on that link to look at requests that have been sent to you at any time.

Installing a new language



More information about languages

The base version of Open ERP is translated into the following languages: English, German, Chinese, Spanish, Italian, Hungarian, Dutch, Portuguese, Romanian, Swedish and Czech.


As administrator you can install a new main working language into the system.

  1. Select Administration in the Menu Toolbar and click Translations ‣ Load an Official Translation in the main menu window,

  2. Select the language to install, French for example, and click on Start Installation,

  3. When the message Installation done appears in the Language file loaded window, click OK to return to the menu. (Your system will actually need the French locale loaded to be able to do this, so you may not be successful here.)

To see the effects of this installation change the preferences of your user to change the working language (you may first need to ensure that you have explicitly selected English as your language, rather than keep the default, before you're given the French option). The main menu is immediately translated in the selected language. If you're using the GTK client you'll first have to close the menu then open a new main menu to start seeing things in the new language.


Navigating the menu

From this point in the book navigation from the main menu is written as a series of menu entries connected by the character. Instead of seeing “ Select Administration in the Menu toolbar then click Translations > Load an Official Translation ” you'll just get “ use menu Administration ‣ Translations ‣ Load an Official Translation ”.

Requests as a mechanism for internal communication

Requests are a powerful communication mechanism between users of the system. They're also used by Open ERP itself to send system messages to users.

They have distinct advantages over traditional emails:

  • requests are linked to other Open ERP documents,

  • an event's history is attached to the request,

  • you can monitor events effectively from the messages they've sent.

Open ERP uses this mechanism to inform users about certain system events. For example if there's a problem concerning the procurement of a product a request is sent by Open ERP to the production manager.

Send a request to get an understanding of its functionality:

  1. Click on the Requests link that should currently be showing No Requests. This opens a window that lists all of your waiting requests.

  2. Click New to create and send a new request.

  3. Complete the subject of the request, such as How are things? then give a description of the enquiry in the field.

  4. Click the Search button to the right of the To field and select Administrator in the window that opens (that's the user that you're already connected as).

  5. You can then link this request to other system documents using the References field, which could, for example, be a partner or a quotation or a disputed invoice.

  6. Click Send to send the request to the intended recipient – that's yourself in this case. Then click MAIN MENU to return to the original screen.


Creating a new request

To check your requests:

  1. Click on the link to the right of the Requests label to open a list of your requests. (It's possible that you'll still see the statement No Requests because this information is updated periodically rather than instantly.) The list of requests then opens and you can see the requests you've been sent there.

  2. Click the Edit icon, represented by a pencil, at the right hand end of the request line. That opens the request in edit mode.

  3. You can then click the Reply button and make your response in the Request field that appears in place of the original message.

  4. Click Send to save your response and send it to the original sender.


Requests vs. email

The advantage of an Open ERP request compared with a set of emails about one thread of discussion is that a request contains all of the conversation in one place. You can easily monitor a whole discussion with the appropriate documents attached, and quickly review a list of incomplete discussions with the history within each request.

Look at the request and its history, then close it.

  1. Click on the History tab in the Request form to see the original request and all of the responses. By clicking on each line you could get more information on each element.

  2. Return to the first tab, Request and click End of Request to set it to closed. This then appears greyed out.

The request is no longer active. It's not visible to searches and won't appear in your list of waiting requests.


Trigger dates

You can send a request with a future date. This request won't appear in the recipient's waiting list until the indicated date. This mechanism is very useful for setting up alerts before an important event.


The database you created contains minimal functionality but can be extended to include all of the potential functionality available to Open ERP. About the only functions actually available in this minimal database are Partners and Currencies – and these only because the definition of your main company required this. And because you chose to include demonstration data, both Partners and Currencies were installed with some samples.

Because you logged in as Administrator, you have all the access you need to configure users. Click Administration ‣ Users ‣ Users to display the list of users defined in the system. A second user, Demo User , is also present in the system as part of the demonstration data. Click the Demo User name to open a non-editable form on that user.

Click the Groups tab to see that the demo user is a member of only the Employee group, has no roles and is subject to no specialized rules. The admin user is different, as you can see if you follow the same sequence to review the its definition. It's a member of the admin group, which gives it more advanced rights to configure new users.


Roles, Groups and Users


Roles are used in business processes for permitting or blocking certain steps in the workflow of a given document. For example you can assign the role of approving an invoice. Roles answer the question “Who should do what?”

Click Administration ‣ Users ‣ Groups below the main menu to open the list of groups defined in the system. If you open the form view of the admin group by clicking its name in the list, the first tab give you the list of all the users who belong to this group.

Click the Security tab and it gives you details of the access rights for that group. These are detailed later in 配置与系统管理, but you can already see there further up in the window, the list of menus reserved for the admin group. By convention, the admin in Open ERP has rights of access to the Configuration menu in each section. So Partners / Configuration is found in the list of access rights but Partners isn't found there because it's accessible to all users.

你可以创建一些新用户来把他们整合到系统中。将他们分配到预先定义的群组中可以分别授予他们特定的访问权限。然后在你登陆这些用户的时候测试他们的访问权限。关于管理这些访问权限的详细说明请参考 配置与系统管理


Changes to default access rights

新版本OpenERP与较早版本的OpenERP以及Tiny ERP在此处有所不同:许多群组已经预先定义,并且许多菜单和对象都默认键连接到这些群组。这是个与4.2.2及更早版本相比颇为宽松的途径,以前可以定义访问权限,但默认并没有激活。

Managing partners

In Open ERP, a partner represents an entity that you do business with. That can be a prospect, a customer, a supplier, or even an employee of your company.

List of partners

Click Partners ‣ Partners in the main menu to open the list of partners. Then click the name of the first partner to get hold of the details – a form appears with several tabs on it:

  • the General tab contains the main information about the company, such as its corporate name, its primary language, your different contacts at that partner and the categories it belongs to.

  • the Sales & Purchases tab contains information that's slightly less immediate.

  • the History tab contains the history of all the events that the partner has been involved in. These events are created automatically by different system documents: invoices, orders, support requests and so on, from a list that can be configured in the system. These give you a rapid view of the partner's history on a single screen.

  • the Notes tab is an area for free text notes.

To the right of the form is a list of Reports, Actions and Links related to a partner. Click some of them to get a feel for their use.






But there are also Customer, Supplier and Rental checkboxes on the partner form, which are different. These checkboxes are designed to enable OpenERP to quickly select what should appear on some of the system drop-down selection boxes. They, too, need to be set correctly.


You can list your partners by category using the menu Partners ‣ Partners by category . This opens a hierarchical structure of categories where each category can be divided into sub-categories. Click a category to obtain a list of partners in that category. For example, click all of the partners in the category Supplier or Supplier ‣ Components Supplier. You'll see that if a company is in a subcategory (such as Components Supplier ) then it will also show up when you click the parent category (such as Supplier).


Categories of partner in a hierarchical structure, for example Customer, Prospect, Supplier

The administrator can define new categories. So you'll create a new category and link it to a partner:

  1. Use Partners ‣ Configuration ‣ Partner Categories to reach a list of the same categories as above but in a list view rather than a hierarchical tree structure.

  2. Click New to open an empty form for creating a new category

  3. Enter My Prospects in the field Name of Category. Then click on the Search icon to the right of the Parent Category field and select Prospect in the list that appears.

  4. 然后点击 保存(Save) 按钮保存你的新分类。



Fields colored blue are required. If you try to save the form while any of these fields are empty the field turns red to indicate that there's a problem. It's impossible to save the form until you've completed every required field.

You can review your new category structure using Partners ‣ Partners by category. You should see the new structure of Prospects / My Prospects there.



To create a new partner and link it to this new category open a new partner form to modify it.

  1. In the General tab, type New Partner into the Name field.

  2. Then click on the search icon to the right of the Categories field and select your new category from the list that appears: Prospect / My Prospects

  3. Then save your partner by clicking Save The partner now belongs in the category Prospect / My prospects.

  4. Monitor your modification in the menu Partners ‣ Partners by category. Select the category My Prospect. The list of partners opens and you'll find your new partner there in that list.


Searching for documents

If you need to search through a long list of partners it's best to use the available search criteria rather than scroll through the whole partner list. It's a habit that'll save you a lot of time in the long run as you search for all kinds of documents.


Example Categories of partners

A partner can be assigned to several categories. These enable you to create alternative classifications as necessary, usually in a hierarchical form.


  • 地理位置,

  • 在某些产品线的兴趣,

  • 订阅简报,

  • 工业类型。