odoo@2.1.5
- create(model, data, options)
- deleteRecord(model, recordId)
- read(model, recordId, fields)
- searchReadRecord(model, domain, fields, [options])
- searchRecord(model, domain)
- update(model, recordId, data)
This adaptor exports the following from common:
Functions
create
create(model, data, options) ⇒ Operation
Create a record in Odoo. You can pass an external ID to the options object to create a record with a specific ID. You can also pass a downloadNewRecord option to download the whole created resource in the response.
| Param | Type | Description | 
|---|---|---|
| model | string | The specific record model i.e. "res.partner" | 
| data | object | The data to be created in JSON. | 
| options | CreateOptions | Options to send to the request. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | The response body (as JSON) | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example: Create a partner record with an external Id
create('res.partner', { name: 'Kool Keith' }, { externalId: 23 });
Example: Create a partner record and download the whole record in the response
create('res.partner', { name: 'Kool Keith' }, { downloadNewRecord: true });
deleteRecord
deleteRecord(model, recordId) ⇒ Operation
Delete a record from Odoo
| Param | Type | Description | 
|---|---|---|
| model | string | The specific record model i.e. "res.partner" | 
| recordId | number | The specific recordId to be deleted. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | The response body (as JSON) | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example
deleteRecord("res.partner", 54 );
read
read(model, recordId, fields) ⇒ Operation
Get a record from Odoo. Returns all fields unless a field list is provided as a third argument
| Param | Type | Description | 
|---|---|---|
| model | string | The specific record model from i.e. "res.partner" | 
| recordId | number | An array of record IDs to read. | 
| fields | Array.<string> | An optional array of field strings to read from the record. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | The response body (as JSON) | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example: Download records with select fields
read("res.partner", [1] , ['name']);
Example: Download a single record with all fields
read("res.partner", $.recordIds);
searchReadRecord
searchReadRecord(model, domain, fields, [options]) ⇒ Operation
Search and a read record from Odoo. It returns the records that match the search criteria, with the specified fields or full records if no fields are given.
| Param | Type | Default | Description | 
|---|---|---|---|
| model | string | The specific record model i.e. "res.partner" | |
| domain | object | Optional search domain to filter records. | |
| fields | Array.<string> | An optional array of field strings to read from the record. i.e ['name', 'state_id'] | |
| [options] | object | {} | Additional options to configure the search. | 
| [options.limit] | number | 1000 | Maximum number of records to fetch. If undefined, defaults to 1000, and all records available will be fetched. | 
| [options.offset] | number | 0 | The index of the first record to return. | 
| [options.pageSize] | number | 200 | The number of records to fetch in each request. Defaults to 200. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | The response body (as JSON) | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example: Search and read a record with a domain filter
searchReadRecord('res.partner', {
  country_id: 'United States',
});
Example: Search and read a record with specific fields
searchReadRecord(
  'res.partner',
  {
    is_company: true,
  },
  ['name']
);
Example: Fetch records with a limit
searchReadRecord('res.partner', {}, [], {
  limit: 200,
});
searchRecord
searchRecord(model, domain) ⇒ Operation
Search a record from Odoo. Only returns record IDs. Use searchReadRecord to download full
records which match the criteria.
| Param | Type | Description | 
|---|---|---|
| model | string | The specific record model i.e. "res.partner" | 
| domain | object | Optional search domain to filter records. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | An array of matching record IDs | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example
searchRecord('res.partner', {
  country_id: 'United States',
});
update
update(model, recordId, data) ⇒ Operation
Update a record in Odoo
| Param | Type | Description | 
|---|---|---|
| model | string | The specific record model i.e. "res.partner" | 
| recordId | number | The specific recordId to be updated. | 
| data | object | The data to be updated in JSON. | 
This operation writes the following keys to state:
| State Key | Description | 
|---|---|
| data | The response body (as JSON) | 
| response | The HTTP response from the Odoo server (excluding the body) | 
| references | An array of all previous data objects used in the Job | 
Example
update("res.partner", 54 , {name: 'Jane Doe'});
Interfaces
CreateOptions
Options object
Properties
| Name | Type | Description | 
|---|---|---|
| externalId | number | An optional id to be used in the request | 
| downloadNewRecord | boolean | An option defaulted to falseincase a user intends to receive the whole created resource in the response. The collective response will be written instate.data. | 
SearchOptions
Options object
Properties
| Name | Type | Description | 
|---|---|---|
| limit | number | Limit the number of records to return | 
| offset | number | Set to the number of records to skip | 
| order | string | Order to sort the records by. i.e "name, desc" | 
| context | object | Context to be used in the request. i.e {lang: 'en_US', timezone: 'UTC'}. |