Detalles de Conexión de Odoo¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8383 del conector.

Empezando¶

Compatibilidad con la versión de Odoo

El conector se puede conectar a la versión 8 de Odoo y superior. El conector aprovecha la interfaz XML-RPC de Odoo que está disponible de forma predeterminada tanto en la versión local como en muchos servicios de alojamiento como odoo.sh

Establecer una Conexión¶

Conexión a Odoo¶

Para conectarse, configure URL a un sitio Odoo válido, User y APIToken a los detalles de conexión del usuario con el que se está conectando, y Database a la base de datos de Odoo.

Si no está utilizando tokens API (solo se admiten en Odoo 14 y superior), también puede proporcionar la contraseña en APIToken campo.

Derechos de Acceso¶

Para que el conector determine a qué modelos puede acceder en Odoo, el usuario con el que se conecta debe tener permisos para leer desde "ir.model.access" (un modelo interno de Odoo que rige los derechos de acceso). Normalmente esto está reservado para los administradores, pero se puede otorgar a cualquier usuario creando un grupo de servicios:

1. Como administrador, abra la página de configuración de Odoo y habilite el "modo desarrollador ". Si esto no está disponible, es posible que deba iniciar sesión como superusuario.
2. Abra la página Grupos (en el menú desplegable Usuarios) y cree un nuevo grupo.
3. Establezca la aplicación en "Administración" y el nombre en "Acceso al servicio"
4. Agregue cualquier usuario que necesite acceso al servicio en la pestaña Usuarios
5. En la pestaña Derechos de acceso, agregue una entrada para el objeto "ir.model.access" (puede llamarse "Acceso al modelo"), marque Acceso de lectura y asígnele el nombre "Inspeccionar modelos".
6. Guardar el grupo

Si no es posible realizar este cambio, debe configurar CheckPermissions opción a falso. Eso enumerará todos los modelos en Odoo como tablas, independientemente de los permisos que su usuario tenga realmente para esos modelos.

Características Avanzadas¶

Esta sección detalla una selección de características avanzadas del conector Odoo.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Odoo le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Utilizando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM res_users WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

El conector representa los modelos de Odoo como tablas y vistas relacionales. Las definiciones de la tabla se obtienen dinámicamente del sitio de Odoo al que se conecta, y las exactas que estarán disponibles para usted serán diferentes según las aplicaciones que haya instalado. Las tablas enumeradas aquí son solo ejemplos, que pueden diferir de las disponibles para usted.

Mesas

Al conectarse, el conector determina qué modelos puede modificar y cuáles son de solo lectura. Los modelos que se pueden modificar se representan como tablas, que tienen soporte para leer, insertar, actualizar y eliminar datos.

Puntos de vista

Todos los modelos que son de solo lectura se representan como vistas. Puede leer datos de ellos de la misma manera que lo haría con una tabla, pero no se permite insertar, actualizar ni eliminar.

Columnas Many2One, One2Many y Many2Many

Dentro de Odoo, además de las columnas con valores simples como texto y fechas, también hay columnas que contienen múltiples valores en cada fila. El conector decodifica este tipo de valores de forma diferente, según el tipo de columna de la que procede el valor:

Muchos2uno¶

Las columnas Many2One son referencias a una sola fila dentro de otro modelo. Dentro del conector, las columnas Many2One se representan como números enteros, cuyo valor es el ID al que hacen referencia en el otro modelo.

Por ejemplo, el módulo Calendario incluye un modelo para eventos llamado "calendar_event", que tiene una columna llamada "opportunity_id" que hace referencia a una oportunidad en el modelo "crm_lead". Al crear o actualizar un evento de calendario, puede establecer el id_oportunidad en el ID del líder para el que es la reunión:

INSERT INTO calendar_event(name, start, stop, opportunity_id) VALUES ('Meet With Potential Customer', '...', '...', 42)

Si tuviera que leer este evento más tarde, el valor de id_oportunidad sería el número 42.

Muchos2muchos¶

Las columnas Many2Many son referencias a muchas filas dentro de otro modelo. Dentro del conector, las columnas Many2Many se representan como texto que contiene una lista de enteros separados por comas. Cada valor de esa lista es el ID de una fila a la que se hace referencia.

Por ejemplo, el módulo Calendario incluye un modelo para eventos llamado "calendar_event", que tiene una columna llamada "partner_ids" que hace referencia a contactos en el modelo "res_partner". Al crear o actualizar un evento de calendario, puede establecer los ID_socios en los ID de las personas que asisten a la reunión:

INSERT INTO calendar_event(name, start, stop, partner_ids) VALUES ('Meet With Potential Customer', '...', '...', '13,57')

Si tuviera que leer este evento más tarde, el valor de partner_ids sería el texto "13,57" (o "57,13", ya que los id pueden estar en cualquier orden).

Uno2muchos¶

Las columnas One2Many son referencias a muchas filas dentro de otro modelo; son similares a las columnas Many2Many, excepto que cada fila en el modelo al que se hace referencia debe pertenecer solo a una en el modelo principal.

Por ejemplo, el módulo Calendario incluye un modelo para eventos llamado "calendar_event", que tiene una columna llamada "attendee_ids" que hace referencia a las invitaciones a reuniones almacenadas en el modelo "event_attendee". A diferencia de partner_ids, donde diferentes reuniones pueden compartir los mismos socios y diferentes socios pueden ir a la misma reunión, cada invitación está vinculada a un solo evento.

Actualmente, estas columnas se leen igual que las columnas Many2Many (como texto que contiene una lista de ID separados por comas), pero no se pueden escribir en ellas.

Puntos de Vista¶

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Odoo¶

CampoReferencias¶

Recupera referencias de un solo valor y de varios valores de una tabla.

Columnas¶

Procedimientos Almacenados¶

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Conector Jitterbit para Procedimientos Almacenados de Odoo¶

Procedimiento de Llamada¶

Llama a un RPC del lado del servidor dentro de Odoo.

Información Específica del Procedimiento¶

Odoo expone sus RPC utilizando la API externa. Esta API usa un método XML-RPC llamado execute_kw para llamar a los procedimientos de Odoo en módulos específicos. Internamente, el método se ve así:

execute_kw(database, user_id, password, model, operation, arguments, keyword_args)

El conector proporcionará la información de conexión automáticamente, por lo que los únicos parámetros necesarios para CallProcedure son el modelo, la operación, una lista de argumentos y un mapa de argumentos de palabras clave. Los argumentos y los argumentos de palabras clave se proporcionan como una matriz JSON y un objeto, respectivamente. El conector tomará el resultado de la RPC y lo volverá a convertir en JSON para la salida del procedimiento.

Por ejemplo, podría llamar al método 'leer' en el modelo 'hr.employee' para leer información sobre empleados específicos. En este caso, recuperaría el nombre y el departamento de los empleados con los ID 2 y 4:

EXECUTE CallProcedure
  Model = 'hr.employee',
  Operation = 'read',
  -- The read RPC takes one argument, which is the list of IDs
  Arguments = '[[4, 2]]',
KeywordArgs = '{"fields": ["department_id", "name"]}'

Llamar a este procedimiento en los datos de muestra de Odoo devolverá este resultado JSON:

[
  {"department_id": [4, "Investigación y desarrollo"], "id": 4, "name": "Sharlene Rhodes"},
  {"department_id": [4, "Investigación y desarrollo"], "id": 2, "name": "Ronnie Hart"}
]

Aporte¶

Columnas del Conjunto de Resultados¶

Tablas del Sistema¶

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema¶

Las siguientes tablas devuelven metadatos de la base de datos para Odoo:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos¶

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consulta¶

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs¶

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

Sys_tablecolumns¶

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla res_users:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='res_users' 

Columnas¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

Sys_procedureparameters¶

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado CallProcedure:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='CallProcedure' AND Direction=1 OR Direction=2

Columnas¶

Sys_keycolumns¶

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla res_users:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='res_users'

Columnas¶

Sys_foreignkeys¶

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas¶

Sys_indexes¶

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas¶

Sys_connection_props¶

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:odoo:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas¶

Sys_sqlinfo¶

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas¶

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos¶

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas¶

Sys_identidad¶

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity

Columnas¶

Propiedades de Configuraciones Avanzadas¶

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

SSL

Esquema

Misceláneas

Autenticación¶

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

URL¶

La URL base del sitio de Odoo al que se está conectando. Por ejemplo, http://my.odoo.com/.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

La URL base del sitio de Odoo al que se está conectando. Por ejemplo, http://my.odoo.com/.

Base de Datos¶

El nombre de la base de datos de Odoo a la que te estás conectando.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Cuando se conecta a Odoo en línea, este valor suele ser el nombre de su dominio Odoo personalizado. Por ejemplo, si se conecta a https://contoso.odoo.com, la base de datos debe establecerse en contoso.

Al conectarse a una instancia local de Odoo, puede encontrar este valor cerrando sesión en Odoo y abriendo la página Administrar bases de datos desde la pantalla de inicio de sesión. Allí, puede determinar la base de datos a la que necesita conectarse.

Usuario¶

La cuenta de usuario de Odoo utilizada para la autenticación.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Junto con APIToken, este campo se usa para autenticarse contra el servidor Odoo.

APIToken¶

El token de API (o contraseña) utilizado para autenticar al usuario.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Cuando se usa Odoo 14 y superior, esta opción se puede configurar con un token de API o una contraseña. Se recomiendan tokens API sobre contraseñas.

Comprobar Permisos¶

Si usar los permisos de usuario de Odoo para determinar qué tablas y vistas enumerar.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Cada usuario en Odoo tiene diferentes permisos para algunos modelos: pueden modificar algunos, leer otros y es posible que no puedan acceder a algunos. Cuando CheckPermissions es verdadero (el valor predeterminado), se examinan los permisos del modelo para que los modelos modificables se clasifiquen como tablas, los modelos de solo lectura se clasifiquen como vistas y los modelos inaccesibles no se enumeren.

Cuando CheckPermissions es falso, todos los modelos dentro de Odoo se enumeran como tablas y se omite la verificación de permisos.

Verificar los permisos del modelo requiere que un administrador otorgue a su usuario acceso de solo lectura al modelo "ir.model.access" porque no es legible para la mayoría de los usuarios de forma predeterminada. Si no se puede otorgar acceso a ese modelo al usuario que se conecta, establezca esta opción en falso.

SSL¶

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

SSLServerCert¶

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema¶

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Ubicación¶

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos¶

string

Valor por Defecto¶

"%APPDATA%\\\Odoo Data Provider\\Schema"

Observaciones¶

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\ Odoo Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Esquemas Navegables¶

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas¶

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista¶

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Permitir Campos Calculados¶

Booleano que determina si los nombres calculados de Odoo se asignan a columnas.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

Internamente, Odoo almacena algunos campos directamente en su base de datos y calcula otros campos dinámicamente cuando los solicita. Si bien los campos almacenados suelen recuperarse rápidamente, los campos calculados pueden ser potencialmente mucho más lentos, ya que Odoo tiene que realizar un trabajo adicional en cada fila.

De forma predeterminada, esta propiedad es falsa y los campos calculados no están disponibles. Puede establecer esta propiedad en verdadero si necesita acceder a un campo calculado, aunque esto hará que las consultas (incluidas las consultas con estrellas) en muchas tablas tarden más en ejecutarse.

ExpandirReferencias¶

Booleano que determina si los campos de varios valores Many2Many y One2Many se expanden en filas separadas.

Tipo de Datos¶

bool

Valor por Defecto¶

false

Observaciones¶

De forma predeterminada, los campos Many2Many y One2Many se contraen en valores individuales separados por comas. Por ejemplo, un registro en calendar_event ID generará un resultado como este si asisten los socios 13 y 57.

SELECT id, name,                           partner_ids, x_custom_ids FROM calendar_event
--      1  'Meet With Potential Customer'  '13,57'      '1,2'

Con esta opción habilitada, el conector expandirá cada combinación de valores de campo de varios valores en varias filas. Esto significa que los datos de las filas se duplicarán, pero hace que sea más sencillo UNIRSE entre tablas que están vinculadas por referencias de varios valores.

Además, el conector usará una clave principal separada llamada id:multi ya que id) no es única cuando se duplican las filas. Esta clave principal se genera en el lado del cliente y su uso debe evitarse en los filtros, ya que depende de las filas exactas devueltas por cualquier filtro evaluado por Odoo.

SELECT "id:multi", id, name,                          partner_ids, x_custom_ids FROM calendar_event
--      1:1        1  'Meet With Potential Customer'  13           1
--      1:2        1  'Meet With Potential Customer'  57           1
--      1:3        1  'Meet With Potential Customer'  13           2
--      1:4        1  'Meet With Potential Customer'  57           2

Tenga en cuenta que esta opción no afecta cómo se procesan las inserciones. Si desea insertar un registro que contenga un campo de varios valores, siempre debe insertar utilizando un valor separado por comas.

UseDisplayNames¶

Valor booleano que determina si se deben usar los nombres para mostrar de las columnas en lugar de los nombres de la API.

Tipo de Datos¶

bool

Valor por Defecto¶

true

Observaciones¶

Los nombres para mostrar pueden cambiar en el futuro. Establézcalo en falso si desea asegurarse de que los nombres de las columnas sean siempre constantes.

Misceláneas¶

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Filas Máximas¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos¶

int

Valor por Defecto¶

-1

Observaciones¶

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro¶

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo¶

Tamaño de Página¶

El número máximo de resultados a devolver por página de Odoo.

Tipo de Datos¶

int

Valor por Defecto¶

5000

Observaciones¶

El Pagesize la propiedad afecta el número máximo de resultados a devolver por página de Odoo. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

Pseudocolumnas¶

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos¶

string

Valor por Defecto¶

""

Observaciones¶

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Se Acabó el Tiempo¶

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos¶

int

Valor por Defecto¶

60

Observaciones¶

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.