Laravel Odoo ERP API

dev-main 2023-07-07 06:11 UTC

This package is not auto-updated.

Last update: 2024-09-28 10:21:04 UTC


README

Laravel Odoo ERP API. Odoo 网站

安装

在控制台中输入

composer require divyeshjesadiya/ladoo

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

'providers' => array(
        ...
        DivyeshJesadiya\Ladoo\Providers\OdooServiceProvider::class
    )

添加别名外观,并将其添加到别名数组中。

'aliases' => array(
        ...
        'Odoo' => DivyeshJesadiya\Ladoo\Facades\Odoo::class,
    )

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

php artisan vendor:publish --provider="DivyeshJesadiya\Ladoo\Providers\OdooServiceProvider" --tag="config"

配置

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

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

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

使用示例

实例化主要的 Odoo 类

$odoo = new \DivyeshJesadiya\Ladoo\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']);

请注意,所有 deleteupdate 方法始终返回 true,除非出现错误。

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

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