Indexieren
Nach dem Verbinden startet die Erstindexierung von selbst. Sie läuft auf unserer Seite; dein Shop-Server liefert die Daten in Blöcken und ist danach wieder in Ruhe.
Was du siehst
Abschnitt betitelt „Was du siehst“Im Panel unter Indexierung läuft die Produktzahl hoch, live. Kein Spinner, kein Fortschrittsbalken ohne Bezug — die Zahl, die steigt, ist die Zahl der Produkte, die bereits gefunden werden können. Du kannst den Tab schließen; die Indexierung läuft weiter, und das Panel zeigt dir beim nächsten Aufruf den aktuellen Stand.
Wie lange das dauert
Abschnitt betitelt „Wie lange das dauert“Die Dauer hängt am Katalog, nicht am Tarif. Grob: kleine Kataloge sind in Minuten durch, große brauchen entsprechend länger. Zwei Dinge verlängern sie spürbar:
- Viele Varianten. Wir indexieren jede Preiskombination, die dein Sales Channel kennt, inklusive Währung. Ein Artikel mit acht Größen in drei Währungen ist mehr Arbeit als ein Artikel ohne Varianten.
- Die KI-Suche. Für jedes Produkt entsteht ein Vektor. Das rechnen wir lokal auf unserer eigenen Hardware (EmbeddingGemma) — es geht dafür nichts an OpenAI oder einen anderen Dienst außerhalb.
Währenddessen bleibt dein Shop online und sucht wie bisher. Kunden merken von der Indexierung nichts.
Was danach automatisch passiert
Abschnitt betitelt „Was danach automatisch passiert“| Auslöser | Was übertragen wird | Wie schnell |
|---|---|---|
| Produkt angelegt, geändert oder gelöscht | Nur das betroffene Produkt | Mit dem nächsten Durchlauf des Scheduled Task |
| Preis- oder Bestandsänderung | Nur die geänderten Felder | Mit dem nächsten Durchlauf des Scheduled Task |
| Bestellung abgeschlossen | Ein Bestellsignal ohne Käuferbezug | Mit dem nächsten Durchlauf des Scheduled Task |
| Neuer Sales Channel oder neue Sprache | Vollständige Indexierung dieses Kanals | Manuell im Panel angestoßen |
Voraussetzung ist, dass Shopwares Scheduled Tasks laufen — bei den meisten Shops tun sie das ohnehin, sonst würden auch Newsletter und Warenkorb-Abbrüche nicht funktionieren. Prüfen kannst du das mit:
bin/console scheduled-task:listVollständig neu indexieren
Abschnitt betitelt „Vollständig neu indexieren“Nötig ist das selten: nach einem großen Import, nach einer Änderung an Kundengruppen-Preisen oder wenn eine Kategorie neu geschnitten wurde. Im Panel unter Indexierung → Vollständig neu aufbauen. Der bestehende Index bleibt aktiv, bis der neue fertig ist; deine Kunden suchen währenddessen ununterbrochen weiter.
Wenn es hängt
Abschnitt betitelt „Wenn es hängt“Bleibt die Zahl stehen, ist fast immer eine dieser drei Ursachen im Spiel:
- Scheduled Tasks laufen nicht. Der häufigste Fall. Siehe Befehl oben.
- Der Shop-Server kommt nicht raus. Der Connector braucht ausgehendes HTTPS zu
api.antares.commergy.de. Eine Firewall-Regel, die nur bestimmte Ziele erlaubt, muss diesen Host enthalten. - Ein Produkt bricht die Übertragung ab. Dann steht im Panel unter Indexierung → Übersprungene Produkte, welches und warum — mit Produktnummer, nicht mit einem Fehlercode.
Mehr dazu in der Fehlerbehebung.