Hitachi Vantara Pentaho Community Wiki
Access Keys:
Skip to content (Access Key - 0)


This step is used to return OpenERP object data using the XMLRPC interface.  It makes use of the standard OpenERP 'read' function and returns rows that satisfy the specified filter.

Since: PDI version 5.0 (PDI-6661)


Option Description
Step Name
Name of the step; the name has to be unique in a single transformation
The OpenERP database connection to read data from
Model Name
The model/object to read data from
Read Batch Size
The maximum amount of rows to return with each call.
Specifies search criteria.  If no filter is specified, all records are returned
Field to retrieve
List of fields to read

Filtering data

The filtering section allows you to specify search criteria.

Supports AND, OR, NOT.  AND is the default option if no operator is specified.  If you need to use OR, please read the OpenERP documentation on filtering.
Model/Object field to filter on
Supports =, !=, >, >=, <, <=, like, ilike, is null, is not null, in, not in, child_of, parent_left, parent_right
Constant value that will be compared to the model field

WARNING: OpenERP filters do not work as you would expect.  Hit the 'Filter Help' button to get the OpenERP description on how to do filters.

Filtering example using OR

To Filter on res.partner where the partner is either a customer OR a supplier:

Model fields

All model fields are returned by the step including related, many2many, many2one, function, selection fields etc. 

Label as it would be displayed in an OpenERP client.
For many2many, one2many and many2one fields it gives an indication of the related object.
The field name on the object.  Also the field name that will be used in the transformation.

many2one fields

many2one fields return the ID and Name of the parent object.  The postfix "_id" and "_name" is added to the original field name.

For example:  The field country returns two fields: country_id (for the ID number) and country_name (for the country name).  The same will go for salesman (user_id_id and user_id_name).

many2many and one2many fields

many2many and one2many fields are returned as a comma separated list of ID numbers.

HINT:  If you need to join with many2many records, use the "Row Normaliser" step to get a row for each value of the comma separated list of IDs.  The ID fields can then be joined with a stream of detail records using the "Merge Join" step.

  1. Jul 11, 2012

    Quang Nguyen says:

    - Hi Guys I now use pentaho data integration 4.3.0 but I don't see module O...

    - Hi Guys

    I now use pentaho data integration 4.3.0 but I don't see module OpenERP on this version like document description.  Please, Do I need set up more module?

  2. May 31, 2013

    Jens Bleuel says:

    It will be in version 5.0, a nightly build to test can be obtained via http://ci...

    It will be in version 5.0, a nightly build to test can be obtained via

This documentation is maintained by the Pentaho community, and members are encouraged to create new pages in the appropriate spaces, or edit existing pages that need to be corrected or updated.

Please do not leave comments on Wiki pages asking for help. They will be deleted. Use the forums instead.

Adaptavist Theme Builder (4.2.0) Powered by Atlassian Confluence 3.3.3, the Enterprise Wiki