Proporciona los modelos abstractos que dan una lectura fonética (カナ / ふりがな) a un modelo -- de su nombre, o de cualquier otro campo -- y la configuración que elige el formato de kana en el que se almacenan las lecturas.
Una lectura se almacena en una forma canónica, de modo que la misma pronunciación coincide sin importar cómo se escribió: los kana toman el formato configurado, el ASCII y los dígitos de ancho completo se convierten a ancho medio (ＡＢＣショウジ se almacena como ABCショウジ), y los espacios se reducen a espacios de ancho medio simples. Un término de búsqueda pasa por la misma normalización antes de compararse.
Este módulo no añade ningún campo a ningún modelo por sí mismo; las lecturas residen en los módulos que aplican los mixins a un modelo.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 20.0Añade un ajuste que elige cómo se almacenan las lecturas fonéticas japonesas (kana), y proporciona bloques de construcción reutilizables para que otros módulos puedan dar a cualquier registro una lectura kana normalizada de su nombre que también sea buscable.
Este módulo es la base para la localización japonesa: no añade ningún campo a las pantallas estándar de Odoo por sí mismo, pero proporciona el mecanismo que otros módulos utilizan para almacenar y buscar lecturas fonéticas (furigana) de nombres.
Lo que obtienen los usuarios: - Una nueva sección "Japanese Kana" en la aplicación Ajustes con una opción "Kana Format". Los usuarios eligen si las lecturas se guardan como katakana de ancho completo, katakana de ancho medio o hiragana. El katakana de ancho completo es el valor predeterminado. - El formato elegido se aplica a las lecturas guardadas a partir de ese momento; las lecturas ya almacenadas conservan su formato anterior hasta que se vuelvan a guardar. - Se puede asignar un formato propio a un modelo concreto mediante un parámetro del sistema, que entonces prevalece sobre la configuración general.
Comportamiento automático: - Cada vez que se guarda una lectura, se limpia: las letras y los dígitos de ancho completo se convierten a ancho medio, los espacios adicionales se reducen a espacios simples y el texto se convierte al estilo de kana seleccionado. Una lectura formada solo por espacios se almacena como vacía. - Los términos de búsqueda escritos en un campo de kana se limpian de la misma forma antes de la coincidencia, de modo que la misma pronunciación encuentra el registro independientemente de cómo se haya escrito. - Cuando un modelo utiliza el mixin de lectura de nombres, la búsqueda por el nombre visible normal también consulta la lectura en kana, por lo que un registro se puede encontrar por su pronunciación. - Un valor de formato no válido se rechaza con un mensaje de error.
Áreas afectadas: la pantalla de ajustes, los parámetros del sistema (ir.config_parameter) y los mixins abstractos kana.mixin y name.kana.mixin que otros módulos aplican a sus modelos.
Depende de
Lo necesitan otros módulos
Modelos y campos (4)
- kana.mixin · modelo nuevo
- name.kana.mixin · modelo nuevoname_kana (Name (Kana)), name_kana_search (Name (Kana) Search)
- ir.config_parameter · amplía un modelo existente
- res.config.settings · amplía un modelo existentekana_format
Texto generado por IA (DeepSeek) al leer el código de la versión 20.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 2 confirmadas, 7 sin información de 9 versiones.
Fuentes · Odoo 19.0
Confirmado el 2026-11-03 en la rama 19.0 de OCA/l10n-japan.
terminal Instalación y uso
Documentación de OCA · Odoo 20.0Configuración
Fuente · Odoo 20.0Selecciona el formato kana en Ajustes > Ajustes generales > Japanese Kana. El katakana de ancho completo es el predeterminado; el katakana de ancho medio y el hiragana son las alternativas.
Un modelo individual puede apartarse de esa configuración, para el caso en que el furigana personal se mantiene en hiragana mientras que los contactos y los productos permanecen en katakana. Esto es poco frecuente, por lo que no tiene un ajuste propio: añade un parámetro del sistema en Ajustes > Técnico > Parámetros del sistema cuya clave sea el nombre del modelo añadido a la global, y cuyo valor sea uno de full_width_katakana, half_width_katakana o hiragana.
| Clave | Se aplica a | |---|---| | l10n_jp_kana.format | todos los modelos con una lectura | | l10n_jp_kana.format.res.partner | contactos | | l10n_jp_kana.format.hr.employee | empleados | | l10n_jp_kana.format.product.template | productos y sus variantes |
Una clave por modelo vacía o ausente significa que el modelo sigue el formato global.
Cambiar un formato afecta solo a las lecturas guardadas posteriormente -- consulta Problemas conocidos.
Instala el módulo que lleva la lectura al modelo que necesites:
l10n_jp_kana_partner_name-- contactosl10n_jp_kana_product_name-- productosl10n_jp_kana_hr_employee_name-- empleados
Para dar a otro modelo una lectura de su nombre, hereda kana.mixin y name.kana.mixin junto con el modelo y añade el campo name_kana a las vistas de formulario y de lista. En la vista de búsqueda, usa name_kana_search en lugar de name_kana: una vista de búsqueda compara el término con la columna tal como se escribe, y ese campo es el que normaliza el término primero. Las lecturas se normalizan entonces al crear y al escribir, y un término escrito en la búsqueda del modelo encuentra el registro, sea cual sea la forma kana en que esté.
Para una lectura de algo distinto del nombre -- una dirección, por ejemplo -- hereda kana.mixin solo y declara los campos Char con kana=True. Se normalizan al crear y al escribir como una lectura de nombre; añade un onchange en ellos si el formulario debe mostrar la forma almacenada antes de guardar.
En un modelo que delega en otro (_inherits, como hace una variante de producto con su plantilla), hereda kana.mixin ahí también. La lectura se almacena en el padre, y el hijo, de lo contrario, mantendría el valor tal como se escribió hasta que el registro se lea de nuevo desde la base de datos.
name.kana.mixin necesita kana.mixin a su lado, que es donde reside la normalización. Ninguno deriva del otro, así que un módulo que extiende kana.mixin llega a todos los modelos que lo adoptaron.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.