Saltar al contenido principal

Soluciones

En el uso de Typesense pueden presentarse algunos inconvenientes o necesidades comunes.
A continuación se documentan los principales y cómo solucionarlos.

1. No se ve ningun producto en Web​

Síntoma:
En el sitio web no se ve ningun producto al usar el buscador y en las paginas de categoria. El log de errores en headless muestra un mensaje que reporta no encontrar algunos atributos en el esquema.

Posibles causas:

  • Cuando el contenedor de typesense fue interrumpido mientras indexaba o actualizaba una coleccion puede provocar que se pierda la configuración del esquema.

Solución:

  • Ingresa al dashboard de typesense, selecciona tu colección y revisa la configuración del esquema. Si la configuración esta vacia o incompleta entonces vuelve a definirla.
    • Te recomiendo usar el visor de esquema en formato JSON, y encontraras un respaldo de la configuración en typesense/esquema. Podras validar su corrección inmediatamente despues de guardar los cambios.

2. Indexar atributo nuevo​

Síntoma:
En Typesense cuando haces un ordenamiento o filtro sobre ese campo no se puede o muestra error.

Posibles causas:
El esquema de la colección no tiene ese atributo definido (a pesar de que existan productos en Typesense que tienen ya ese campo).

Solución:

  1. Ingresa al dashboard de typesense, selecciona tu colección y revisa la configuración del esquema para validar si existe el campo en la definición.
  2. Por ejemplo si el campo que requieres es energy y no esta en el esquema entonces vamos a agregar un nuevo campo usando el botón ADD FIELD.
  3. Defines el nombre del campo 'energy' su tipo de valor 'string' y marcas las opciones que necesitas como podria ser (optional, facet, index, sort), al final guarda los cambios con el botón UPDATE SCHEMA.
  • Para mas información de la indexacion de campos consulta la documentación oficial.
  • Usa la opción 'opcional' si es que no todos los productos cuentan ya con ese atributo.
  • Despues de guardar los cambios toma un par de minutos para que typesense actualice la colección y puedas usar el campo en tus filtros.