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.
ヵ y ヶ se convierten en カ en todos los formatos, ya que representan 箇. En katakana de ancho medio, los kana sin forma de ancho medio se convierten a la más cercana que la tenga: ヮ a ﾜ, ヰ y ヱ a ｲ y ｴ, ヷ-ヺ a ｳﾞ con una vocal pequeña, y los katakana pequeños para ainu a sus formas de tamaño completo.
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 19.0Añade una base compartida para almacenar lecturas fonéticas japonesas (kana) en los registros, con una pantalla de ajustes para elegir el formato kana y, opcionalmente, restringir qué caracteres puede contener una lectura.
Este módulo no añade ninguna pantalla propia para introducir datos; proporciona bloques de construcción que otros módulos de localización japonesa utilizan para dar a los registros una lectura fonética de su nombre.
En Ajustes, una nueva sección "Japanese Kana" permite a un administrador elegir el Kana Format en el que se almacenan las lecturas: katakana de ancho completo, katakana de ancho medio o hiragana. También ofrece una opción "Restrict Characters" con un campo "Additional Characters" (un patrón para caracteres adicionales permitidos, como letras o dígitos).
Cuando se guarda una lectura, se limpia automáticamente para que la misma pronunciación siempre se vea igual: las letras y los dígitos de ancho completo pasan a ancho medio, los espacios adicionales se colapsan y el texto se convierte al formato elegido. Las ヵ y ヶ pequeñas se almacenan como カ. Una lectura en blanco se almacena como vacía en lugar de como un espacio.
Si la restricción de caracteres está activada, una lectura que contenga algo distinto de los kana del formato elegido, espacios o los caracteres adicionales permitidos se rechaza con un error al guardarse. La comprobación se ejecuta sobre el valor ya limpio.
La búsqueda por lectura también funciona con la forma limpia, de modo que una búsqueda coincide independientemente de cómo se haya escrito el término. Para los modelos que usan el mixin de lectura del nombre, la búsqueda del nombre mostrado también consulta la lectura.
Se puede establecer un formato por modelo mediante parámetros del sistema, que tienen prioridad sobre la configuración global; los valores de formato no válidos o los patrones de caracteres no válidos se rechazan al guardarse.
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, kana_allowed_chars, kana_restrict_chars
Texto generado por IA (DeepSeek) al leer el código de la versión 19.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: 1 confirmada, 8 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 19.0Configuración
Fuente · Odoo 19.0Seleccione 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 eso, 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ñada 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 después -- consulte Problemas conocidos.
Para rechazar lecturas con caracteres que un sistema receptor no puede aceptar, active Restrict Characters en los mismos ajustes. Una lectura puede entonces contener solo los kana de su formato y espacios, además de lo que permita Additional Characters: una expresión regular que coincida con un carácter, p. ej. [0-9A-Za-z]. Ambos se comprueban en la lectura una vez normalizada, cuando se guarda, y el error nombra los caracteres rechazados. Un modelo puede tener sus propios caracteres adicionales con el parámetro del sistema l10n_jp_kana.allowed_chars.<model>.
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.