OOOR 项目技术文档

1. 安装指南

安装步骤

1. 首先，确保你已经安装了Ruby环境。如果没有，请先安装Ruby。
2. 使用以下命令安装OOOR gem：

   $ gem install ooor
   

注意事项

• OOOR gem已经有一段时间没有发布新版本，建议使用git版本以获取最新功能和修复。

2. 项目的使用说明

基本使用

安装完成后，你可以通过以下命令启动OOOR命令行工具：

$ ooor username:password@host:port/database

这将启动一个IRB解释器，并连接到指定的Odoo服务器，你可以在其中直接操作Odoo模型。

示例

在IRB控制台中，你可以这样使用OOOR：

require 'rubygems'
require 'ooor'
Ooor.new(:url => 'http://localhost:8069/xmlrpc', :database => 'mybase', :username => 'admin', :password => 'admin')

这将加载所有Odoo模型到Ruby代理对象中。你可以通过以下命令查找用户ID为1的用户：

ResUsers.find(1)

3. 项目API使用文档

基本查找

ProductProduct.find(1)
ProductProduct.find([1,2])
ProductProduct.find([1])
ProductProduct.find(:all)
ProductProduct.find(:last)

Odoo域支持

ResPartner.find(:all, :domain=>[['supplier', '=', 1],['active','=',1]])

Odoo上下文支持

ProductProduct.find(1, :context => {:my_key => 'value'})

关系支持

SaleOrder.find(1).order_line #one2many relation
p = ProductProduct.find(1)
p.product_tmpl_id #many2one relation
p.taxes_id #automagically reads man2many relation inherited via the product_tmpl_id inheritance relation
p.taxes_id = [1,2] #save a many2many relation
p.save

加载特定字段

ProductProduct.find(1, :fields=>["state", "id"])

创建对象

pc = ProductCategory.new(:name => 'Categ From Rails!')
pc.create
pc.id

更新对象

pc.name = "A new name"
pc.save

复制对象

copied_object = pc.copy({:categ_id => 2})

4. 项目安装方式

通过Gem安装

$ gem install ooor

通过Git安装

如果你需要使用最新版本的OOOR，可以通过Git安装：

$ git clone https://github.com/akretion/ooor.git
$ cd ooor
$ bundle install

通过以上步骤，你可以成功安装并使用OOOR项目。