README

Laravel 的 Odoo ERP API。 Odoo 网站

安装

在控制台中输入

composer require adapt-it/laravelodoo

通过将其添加到 providers 数组中注册 LaravelOdoo 服务。

'providers' => array(
        ...
        AdaptIT\LaravelOdoo\Providers\OdooServiceProvider::class
    )

添加 Alias facade，并将其添加到 aliases 数组中。

'aliases' => array(
        ...
        'Odoo' => AdaptIT\LaravelOdoo\Facades\Odoo::class,
    )

将包的配置文件发布到应用的配置目录

php artisan vendor:publish --provider="AdaptIT\LaravelOdoo\Providers\OdooServiceProvider" --tag="config"

配置

发布包配置文件后，laravelodoo 包的基本配置位于 config/laravelodoo.php

此外，您还可以通过调用可用的设置器方法动态更新这些值

host($url), username($username), password($password), db($name), apiSuffix($name)

使用示例

实例化主 Odoo 类

$odoo = new \AdaptIT\LaravelOdoo\Odoo();

您可以通过调用版本方法来获取 Odoo API 版本

$version = $odoo->version();

此方法不需要连接/登录到 ERP。

连接并登录到 ERP

$odoo = $odoo->connect();

所有必要的配置数据都来自 laravelodoo.php 配置文件。但如果有需要，您始终可以传递新的值。

$this->odoo = $this->odoo
            ->username('my-user-name')
            ->password('my-password')
            ->db('my-db')
            ->host('https://my-host.com')
            ->connect();

注意： host 应包含 'http://' 或 'https://'

登录后，您可以检查用户标识符如下

$userId= $this->odoo->getUid();

您始终可以检查特定模型上的权限

$can = $odoo->can('read', 'res.partner');

可以检查的权限：'read','write','create','unlink'

方法 `search` 根据您的条件提供一组 ID

$ids = $odoo->where('customer', '=', true)
            ->search('res.partner');

您可以使用 limit 方法限制数据量，并使用所需数量的条件

$ids = $odoo->where('is_company', true)
            ->where('customer', '=', true)
            ->limit(3)
            ->search('res.partner');

如果需要获取模型列表，请使用 get 方法

$models = $odoo->where('customer', true)
                ->limit(3)
                ->get('res.partner');

您可以在 get 方法之前添加 fields 方法来减少模型的所有属性

$models = $odoo->where('customer', true)
                ->limit(3)
                ->fields('name')
                ->get('res.partner');

如果不确定模型有哪些字段，可以通过调用 fieldsOf 方法检索模型结构数据

$structure = $odoo->fieldsOf('res.partner');

到目前为止，我们只从 ERP 中检索数据，但您也可以创建和删除记录。

要创建新记录，只需调用 create 方法如下

$id = $odoo->create('res.partner',['name' => 'Jonh Odoo']);

此方法返回新记录的 ID。

对于删除记录，我们有 delete 方法

$result = $odoo->where('name', 'Jonh Odoo')
            ->delete('res.partner');

注意，在调用 delete 方法之前，您必须使用 where。

您还可以按照如下方式通过 ID 删除记录

$result = $odoo->deleteById('res.partner',$ids);

更新您的 ERP 中的任何记录

$updated = $odoo->where('name', 'John Odoo')
            ->update('res.partner',['name' => 'John Odoo Odoo','email' => 'Johndoe@odoo.com']);

请注意，所有 delete 和 update 方法在出错的情况下始终返回 true。

call 方法也适用于想要设置自定义 API 调用的人

$odoo->call('res.partner', 'search',[
        [
            ['is_company', '=', true],
            ['customer', '=', true]
        ]
    ],[
        'offset'=>1,
        'limit'=>5
    ]);