Reindexar o catálogo

Quando vale a pena forçar uma indexação completa, por onde se faz, e o que fazer quando o botão não chega ao fim.

Na maior parte dos dias não é preciso. O preço e o stock chegam em segundos pelo tempo real, e a sincronização periódica revê o catálogo por sua conta. Este guia é para as vezes em que mudou muita coisa de uma vez e não quer esperar.

Quando vale a pena

• Uma importação grande de produtos, feita por CSV ou direta na base de dados.
• Uma mudança estrutural: renomear categorias, refazer características, mudar a estrutura de combinações.
• Depois de ligar ou desligar a partilha de vendas ou de preço de custo no módulo.
• Depois de mudar os pesos dos campos, se quiser ver o efeito imediatamente em vez de esperar pela reconstrução que a gravação já pediu.

Quando não vale a pena Alterações de preço, de stock e de estado chegam pelo tempo real em segundos. Reindexar por causa disso gasta tempo e não muda nada.

Onde está o botão

No back-office da loja, na configuração do módulo Buskara: Reindexar tudo. Não é no painel, e isso é de propósito: quem tem o catálogo é a loja, e é dela que a exportação parte.

No painel, em Pesquisa → Lojas, acompanha o que está a acontecer: Em fila, A indexar… (enviados / total) e por fim Em dia, com o total de documentos. Uma indexação lançada pelo botão do módulo aparece aí da mesma maneira.

O que se vê enquanto corre

O catálogo sobe em lotes: a página pede um bocado de cada vez, mostra a barra a andar com os itens já enviados, e no fim recarrega com o resultado. É assim porque um pedido único a enviar dezenas de milhares de produtos esbarrava no tempo limite do servidor, e o que aparecia era um Request Timeout sem explicação nenhuma.

Mantenha o separador aberto até ao fim. Se o fechar a meio, o que já subiu fica onde está e o resto entra na indexação seguinte, seja ela outro clique no botão ou a sincronização periódica.

Sem browser, por linha de comandos

Para lojas com muitas referências, ou para deixar a correr fora de horas, o módulo traz o mesmo trabalho em linha de comandos:

php modules/buskara/cli/reindex.php

Não tem tempo limite nenhum e não precisa de ninguém à frente do ecrã.

O que acontece à pesquisa entretanto

Continua a responder, com o índice anterior. A troca é feita no fim: os visitantes nunca apanham resultados a meio de uma reconstrução, nem um catálogo pela metade.

Se o total não bater certo

Compare o total de documentos do motor com o número de produtos ativos da loja. Uma diferença é quase sempre uma destas: produtos inativos ou não visíveis na loja, a opção produtos sem stock: esconder a fazer exatamente o que lhe pediram, ou uma indexação que ainda não acabou.

A lista completa das causas, por ordem de probabilidade, está em produtos que não aparecem.