> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Interne WEBSALE-Suche deaktivieren

> Wie Sie die eingebaute Suche von WEBSALE V8s abschalten, wenn ein externer Suchdienstleister angebunden ist, und wie Sie sie als Rückfallebene wieder anstoßen.

Ist in Ihrem Shop ein externer Suchdienstleister angebunden, läuft die eingebaute Suche von WEBSALE V8s trotzdem bei jedem Suchvorgang mit. Sie liefert Ergebnisse, die niemand anzeigt, und kostet dabei Zeit.

Das Abschalten verkürzt die Antwortzeit der Suchergebnisseite. Der Preis dafür ist eine Abhängigkeit: Fällt der externe Dienst aus, steht der Shop ohne Suche da. Deshalb gehören beide Teile dieser Seite zusammen, das Abschalten und die Rückfallebene.

## Interne Suche abschalten

Zuständig ist der Parameter `InternalSearch-Allow` im Abschnitt `<ProductItemSearch>` der `shop.config`. Legen Sie ihn an, falls er noch nicht vorhanden ist.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ProductItemSearch>
   InternalSearch-Allow = no
</ProductItemSearch>
```

Die Suche ist damit nicht entfernt, sondern nur von selbst nicht mehr aktiv. Sie läuft weiterhin, sobald ein Tag sie ausdrücklich anstößt. Genau darauf baut die Rückfallebene im nächsten Abschnitt auf.

Referenz: [Abschnitt ProductItemSearch](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md#productitemsearch)

## Rückfallebene einrichten

Damit der Shop merkt, dass der externe Dienst nicht antwortet, braucht es einen LiveCheck. Das ist eine hinterlegte Prüfung, die der Shop gegen das externe System ausführt und deren Ergebnis er sich für die Sitzung merkt.

> [!WARNING]
>
> Ob Ihr Suchanbieter eine solche Prüfung überhaupt unterstützt, klären Sie direkt mit ihm. Ohne LiveCheck gibt es keine Rückfallebene, und dann sollten Sie die interne Suche nicht abschalten.

Wegweiser: [Externe Includes verwenden](https://dokumentation.websale.de/v8s/externe-dienste/externe-inhalte-einbinden.md)

### Aufbau auf der Suchergebnisseite

Im folgenden Beispiel ist die interne Suche abgeschaltet und für den externen Suchdienst ist ein LiveCheck mit der ID `extsearch` konfiguriert.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{WS-ExternSystemLiveCheck(extsearch)}
   <!-- Der externe Suchdienst antwortet, seine Ergebnisse einbinden -->
{/WS-ExternSystemLiveCheck(extsearch)}

{!WS-ExternSystemLiveCheck(extsearch)}
   <!-- Der externe Suchdienst antwortet nicht -->

   ~WS-DoInternalSearch~

   {WS-SearchResults}
      <!-- Anzeige der Suchergebnisse von WEBSALE -->
   {/WS-SearchResults}

{/!WS-ExternSystemLiveCheck(extsearch)}
```

> [!WARNING]
>
> [`~WS-DoInternalSearch~`](https://dokumentation.websale.de/v8s/referenz/tags/ws/suche-listen-und-blaettern#die-tags-im-uberblick) muss **vor** der Klammerung `{[WS-SearchResults](/v8s/referenz/tags/ws/suche-listen-und-blaettern#die-tags-im-uberblick)}` stehen. Erst wird gesucht, dann wird ausgegeben. Steht das Tag danach, bleibt die Ergebnisliste leer.

### Worauf Sie beim LiveCheck achten sollten

[`WS-ExternSystemLiveCheck()`](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste#die-tags-im-uberblick) gibt es nur als Klammerung, nicht als einzelnes Tag. Das ist kein Mangel, sondern folgt aus seinem Zweck: Es schaltet Bereiche des Templates ein und aus.

> [!WARNING]
>
> Die im Tag angegebene ID muss genau so in Ihrer Konfiguration stehen. Ist sie unbekannt, liefert das Tag weder ein Ja noch ein Nein. In diesem Fall greift auch die negierte Klammerung nicht, und die Rückfallebene läuft nicht an. Ein Tippfehler in der ID führt also dazu, dass im Ausfall gar nichts passiert. Prüfen Sie die Schreibweise deshalb gegen die Konfiguration.

Zwei weitere Punkte:

* Die Prüfung läuft je Seitenaufruf höchstens einmal, auch wenn das Tag mehrfach im Template steht. Sie brauchen also keine Sorge zu haben, dass mehrere Klammerungen den Shop zusätzlich ausbremsen.
* Je nach Einstellung merkt sich der Shop das Ergebnis für die gesamte Sitzung. Der Käufer bleibt dann für seinen Besuch in der Rückfallebene, auch wenn der externe Dienst zwischendurch wiederkommt. Das ist in der Regel gewollt, weil es ein ständiges Hin und Her verhindert.

## Verwandte Themen

* Wegweiser: [Suche mit Suggest-Funktion, für die Anbindung eines externen Suchdienstleisters](https://dokumentation.websale.de/v8s/suche/suche-mit-suggest-funktion.md)
* Wegweiser: [Suchergebnisse, für die eingebaute Trefferliste](https://dokumentation.websale.de/v8s/suche/suchergebnisse.md)
* Wegweiser: Externe Includes verwenden


## Related topics

- [WEBSALE-Suche und FACT-Finder-Suche parallel betreiben](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-websale-und-fact-finder-suche-parallel.md)
- [Integration von FACT-Finder](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md)
- [Integration von FINDOLOGIC](https://dokumentation.websale.de/v8s/externe-dienste/integration-von-findologic.md)
- [Produkte, Katalog und Suche](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/produkte-katalog-und-suche.md)
- [TestMode](https://dokumentation.websale.de/frontend/referenz/aktionen/testmode.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.