Odoo 19.0 Community · Persistente

survey.survey: campos, relaciones y API

El modelo survey.survey («Encuesta») es un modelo persistente declarado por el módulo Encuestas y ampliado por 4 módulos más. Expone 96 campos, 66 de ellos declarados directamente en el modelo; 10 campos de otros modelos apuntan a él. A continuación encontrará cada campo con su nombre técnico, tipo, etiqueta en español y relaciones, y un ejemplo de llamada a la API JSON-2 de Odoo 19.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: survey.survey
Etiqueta: Encuesta
Tipo: Persistente (models.Model)
Tabla SQL: survey_survey
Módulo de origen: Encuestas (survey)
Ampliado por: hr_recruitment_survey, hr_skills_survey, survey_crm, website_slides_survey
Orden por defecto (_order): create_date DESC
Campo mostrado (_rec_name): title
Hereda de (mixins): mail.thread mail.activity.mixin

Campos del modelo

66 campos propios, 24 heredados de mixins y 6 campos automáticos del ORM. Haga clic en un nombre para obtener el enlace directo al campo.

Ocultar los campos heredados

96 de 96 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
access_mode	Modo de acceso	`selection`	obligatorio Valores: `public` (Cualquier persona con el enlace), `token` (Solo personas invitadas)
access_token	Token de acceso	`char`
active	Activo	`boolean`
allowed_survey_types	Tipos de encuestas permitidos	`json`	calculado
answer_count	Registrado	`integer`	calculado
answer_done_count	Intentos	`integer`	calculado
answer_duration_avg	Duración media Duración media de la encuesta (en horas)	`float`	calculado
answer_score_avg	Puntuación media (%)	`float`	calculado
attempts_limit	Número de intentos	`integer`
background_image	Imagen de fondo	`image`
background_image_url	URL del fondo	`char`	calculado
certification	Es una certificación	`boolean`	calculado, almacenado
certification_badge_id	Insignia de certificación	`many2one` → gamification.badge
certification_badge_id_dummy	Insignia de certificación	`many2one` → gamification.badge	related: `certification_badge_id`
certification_give_badge	Otorgar insignia	`boolean`	calculado, almacenado
certification_mail_template_id	Plantilla de correo electrónico de la certificación Correo electrónico automático enviado al usuario cuando aprueba la certificación, contiene el documento de su certificación.	`many2one` → mail.template
certification_report_layout	Plantilla de certificación	`selection`	Valores: `modern_purple` (Morado moderno), `modern_blue` (Azul moderno), `modern_gold` (Oro moderno), `classic_purple` (Morado clásico), `classic_blue` (Azul clásico), `classic_gold` (Oro clásico)
certification_validity_months	Validez Especifique el número de meses de validez de la certificación tras su emisión. Escriba 0 si no expira.	`integer`	añadido por Certificación de habilidades (`hr_skills_survey`)
color	Índice de Colores	`integer`
description	Descripción La descripción aparecerá en la página de inicio de la encuesta. Puede usar esto para proporcionarle el propósito y las reglas a sus candidatos antes de que comiencen.	`html`	traducible
description_done	Mensaje final Este mensaje será mostrado cuando se complete la encuesta	`html`	traducible
generate_lead	Generación de oportunidades (leads)	`boolean`	calculado añadido por Survey CRM (`survey_crm`)
has_conditional_questions	Contiene preguntas condicionales	`boolean`	calculado
hr_job_ids	Puesto de trabajo	`one2many` → hr.job	inverso: `survey_id` añadido por Formulario de entrevista de reclutamiento de recursos humanos (`hr_recruitment_survey`)
is_attempts_limited	Número limitado de intentos Seleccione esta opción si desea limitar el número de intentos por usuario	`boolean`	calculado, almacenado
is_time_limited	La encuesta tiene tiempo limitado	`boolean`
lang_ids	Idiomas Deje el campo vacío para admitir todos los idiomas instalados.	`many2many` → res.lang
lead_count	Leads Número de leads generados por esta encuesta	`integer`	calculado añadido por Survey CRM (`survey_crm`)
lead_ids	Lead	`one2many` → crm.lead	inverso: `origin_survey_id` añadido por Survey CRM (`survey_crm`)
page_ids	Páginas	`one2many` → survey.question	calculado
progression_mode	Mostrar progreso como Si se selecciona Número, mostrará el número de preguntas respondidas sobre el número total de preguntas para responder.	`selection`	Valores: `percent` (Porcentaje restante), `number` (Número)
question_and_page_ids	Secciones y preguntas	`one2many` → survey.question	inverso: `survey_id`
question_count	N.° de preguntas	`integer`	calculado
question_ids	Preguntas	`one2many` → survey.question	calculado
questions_layout	Paginación	`selection`	obligatorio Valores: `page_per_question` (Una página por pregunta), `page_per_section` (Una página por sección), `one_page` (Una página con todas las preguntas)
questions_selection	Selección de preguntas Si se selecciona aleatorio, puede configurar el número de preguntas aleatorias por sección. Este modo se ignora en sesiones en vivo.	`selection`	obligatorio Valores: `all` (Todas las preguntas), `random` (Aleatorio por sección)
restrict_user_ids	Restringido a	`many2many` → res.users
scoring_max_obtainable	Puntuación máxima obtenible	`float`	calculado
scoring_success_min	Puntuación obligatoria (%)	`float`
scoring_type	Puntuación	`selection`	obligatoriocalculado, almacenado Valores: `no_scoring` (Sin puntuación), `scoring_with_answers_after_page` (Puntuación con respuestas después de cada página), `scoring_with_answers` (Puntuación con respuestas al final), `scoring_without_answers` (Puntuación sin respuestas)
session_answer_count	Número de respuestas	`integer`	calculado
session_available	Sesión en vivo disponible	`boolean`	calculado
session_code	Código de sesión Los asistentes utilizarán este código para acceder a la sesión. Puede modificarlo a su gusto.	`char`	calculado, almacenado
session_link	Enlace de sesión	`char`	calculado
session_question_answer_count	Número de preguntas y respuestas	`integer`	calculado
session_question_id	Pregunta actual La pregunta actual de la sesión de la encuesta.	`many2one` → survey.question
session_question_start_time	Hora de inicio de la pregunta actual La hora a la que ha comenzado la pregunta actual, utilizada para controlar el temporizador para los asistentes.	`datetime`
session_show_leaderboard	Mostrar tabla de clasificación de la sesión Si queremos o no mostrar la tabla de clasificación de asistentes para esta encuesta.	`boolean`	calculado
session_speed_rating	Recompensa para respuestas rápidas Los asistentes obtienen más puntos si responden rápidamente	`boolean`
session_speed_rating_time_limit	Límite de tiempo (segundos) El tiempo por defecto para recibir puntos adicionales por las respuestas correctas	`integer`
session_start_time	Hora de inicio de la sesión actual	`datetime`
session_state	Estado de sesión	`selection`	Valores: `ready` (Listo), `in_progress` (En proceso)
slide_channel_count	Número de cursos	`integer`	calculado añadido por Certificaciones de curso (`website_slides_survey`)
slide_channel_ids	Cursos de certificación Los cursos a los que está vinculada esta encuesta a través de la aplicación eLearning	`one2many` → slide.channel	calculado añadido por Certificaciones de curso (`website_slides_survey`)
slide_ids	Diapositivas de certificación Las diapositivas a las que está vinculada esta encuesta a través de la aplicación eLearning	`one2many` → slide.slide	inverso: `survey_id` añadido por Certificaciones de curso (`website_slides_survey`)
success_count	Éxito	`integer`	calculado
success_ratio	Porcentaje de éxito (%)	`integer`	calculado
survey_type	Tipo de encuesta	`selection`	obligatorio Valores: `survey` (Encuesta), `live_session` (Sesión en directo), `assessment` (Valoración), `custom` (Personalizado)
team_id	Asignar leads a	`many2one` → crm.team	añadido por Survey CRM (`survey_crm`)
time_limit	Límite de tiempo (minutos)	`float`
title	Título de la encuesta	`char`	obligatoriotraducible
user_id	Responsable	`many2one` → res.users
user_input_ids	Respuestas del usuario	`one2many` → survey.user_input	solo lectura inverso: `survey_id`
users_can_go_back	Los usuarios pueden volver atrás Si está marcado, los usuarios pueden volver a las páginas anteriores.	`boolean`
users_can_signup	Los usuarios pueden registrarse	`boolean`	calculado
users_login_required	Es necesario iniciar sesión Si está marcado, los usuarios deben iniciar sesión antes de responder incluso con un token válido.	`boolean`
activity_calendar_event_id	Siguiente evento en el calendario de actividades.	`many2one` → calendar.event	calculado heredado de mail.activity.mixin
activity_date_deadline	Fecha límite de la siguiente actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
activity_exception_decoration	Decoración de Actividad de Excepción Tipo de actividad de excepción en el registro.	`selection`	calculado Valores: `warning` (Alerta), `danger` (Error) heredado de mail.activity.mixin
activity_exception_icon	Icono Icono para indicar una actividad de excepción.	`char`	calculado heredado de mail.activity.mixin
activity_ids	Actividades	`one2many` → mail.activity	inverso: `res_id` heredado de mail.activity.mixin
activity_state	Estado de la actividad Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculado Valores: `overdue` (De retraso), `today` (Hoy), `planned` (Planificado) heredado de mail.activity.mixin
activity_summary	Resumen de la siguiente actividad	`char`	related: `activity_ids.summary` heredado de mail.activity.mixin
activity_type_icon	Icono de tipo de actividad	`char`	related: `activity_ids.icon` heredado de mail.activity.mixin
activity_type_id	Tipo de la siguiente actividad	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` heredado de mail.activity.mixin
activity_user_id	Usuario responsable	`many2one` → res.users	solo lecturacalculado heredado de mail.activity.mixin
has_message	Tiene un mensaje	`boolean`	calculado heredado de mail.thread
message_attachment_count	Número de archivos adjuntos	`integer`	calculado heredado de mail.thread
message_follower_ids	Seguidores	`one2many` → mail.followers	inverso: `res_id` heredado de mail.thread
message_has_error	Error de envío de mensaje Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_has_error_counter	Número de errores Número de mensajes con error de envío	`integer`	calculado heredado de mail.thread
message_has_sms_error	Error de envío del SMS Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_ids	Mensajes	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
message_is_follower	Es un seguidor	`boolean`	calculado heredado de mail.thread
message_needaction	Acción requerida Si está marcada, hay nuevos mensajes que requieren su atención.	`boolean`	calculado heredado de mail.thread
message_needaction_counter	Número de acciones Número de mensajes que requieren una acción	`integer`	calculado heredado de mail.thread
message_partner_ids	Seguidores (Contactos)	`many2many` → res.partner	calculado heredado de mail.thread
my_activity_date_deadline	Fecha límite de mi actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
rating_ids	Calificaciones	`one2many` → rating.rating	inverso: `res_id` heredado de mail.thread
website_message_ids	Mensajes del sitio web Historial de comunicación del sitio web	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
create_date	Creado el	`datetime`	solo lecturaautomático
create_uid	Creado por	`many2one` → res.users	solo lecturaautomático
display_name	Nombre mostrado	`char`	solo lecturacalculadoautomático
id	ID	`integer`	solo lecturaautomático
write_date	Última actualización el	`datetime`	solo lecturaautomático
write_uid	Última actualización por	`many2one` → res.users	solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

crm.lead: lead_ids
crm.team: team_id
gamification.badge: certification_badge_id, certification_badge_id_dummy
hr.job: hr_job_ids
mail.template: certification_mail_template_id
res.lang: lang_ids
res.users: restrict_user_ids, user_id
slide.channel: slide_channel_ids
slide.slide: slide_ids
survey.question: page_ids, question_and_page_ids, question_ids, session_question_id
survey.user_input: user_input_ids

Campos de otros modelos que apuntan aquí

crm.lead: origin_survey_id
gamification.badge: survey_id
hr.applicant: survey_id
hr.job: survey_id
hr.resume.line: survey_id
slide.slide: survey_id
survey.invite: survey_id
survey.question: survey_id
survey.user_input: survey_id
survey.user_input.line: survey_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 19: lectura de los cinco primeros registros con campos reales del modelo. Sustituya la instancia, la base y la clave API por las suyas.

curl

curl -X POST "https://su-instancia.odoo.com/json/2/survey.survey/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["title","access_mode","questions_layout","questions_selection","scoring_type"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://su-instancia.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "su-base"}

res = requests.post(
    f"{BASE_URL}/survey.survey/search_read",
    headers=headers,
    json={"domain": [], "fields": ["title","access_mode","questions_layout","questions_selection","scoring_type"], "limit": 5},
)
res.raise_for_status()
print(res.json())

El acceso a la API externa está reservado al plan Custom de Odoo.
XML-RPC y JSON-RPC se retirarán en Odoo 22 (otoño de 2028): use JSON-2.
Se aplican los permisos de acceso y las reglas de registro del usuario de la clave.

Citar esta herramienta

¿Escribe un tutorial, una documentación interna o una respuesta en un foro? Copie este enlace para dirigir a sus lectores a la ficha actualizada.

<a href="https://aidoo.ai/es/outils/explorateur-modeles-odoo/survey-survey">survey.survey (Odoo 19.0)</a>

Fuentes

Datos verificados el 23 de septiembre de 2026 · Odoo 19.0 Community

¿Tiene un proyecto Odoo o quiere aprovechar su ERP con la IA? Hablemos

Implantación, desarrollo de módulos, conexión de Claude o ChatGPT a sus datos: cuéntenos su contexto y le responderemos en 24 horas laborables.

Contactarnos Ver una demo