> ## 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.

# Volltextsuche für Kundendaten anbieten

> Wie Sie Käufern in WEBSALE V8s eine Suche innerhalb ihrer gespeicherten Lieferadressen, Bankdaten und Kreditkartendaten anbieten.

Wer viele Lieferadressen gespeichert hat, findet die gesuchte nicht mehr durch Scrollen. Eine Volltextsuche innerhalb der Verwaltungsseite löst das: Der Käufer tippt einen Namen, eine Stadt oder eine Postleitzahl ein und bekommt nur noch die passenden Einträge.

Dieselbe Funktion steht für drei Bereiche des Kundenkontos zur Verfügung: Lieferadressen, Bankdaten und Kreditkartendaten. Der Aufbau ist in allen drei Fällen derselbe, nur die Tag-Präfixe unterscheiden sich.

Die Suche lohnt sich erst ab einer gewissen Menge. Bei drei gespeicherten Adressen stört das Eingabefeld mehr, als es hilft. Klammern Sie es deshalb gegebenenfalls so, dass es erst ab einer bestimmten Anzahl erscheint.

## Aufbau am Beispiel der Lieferadressen

Die Suche gehört auf das Template zur Verwaltung der Lieferadressen, innerhalb des Bereichs `{D-Overview}`.

### Eingabefeld und Zurücksetzen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{D-Overview}
   <form action="~FORM-DelivAddrSearch~" method="post">
      <label for="addrSearch">Suche</label>
      <input type="text" id="addrSearch" name="~D-SearchInput~" value="~D-SearchTerm~">
      <input type="submit" name="~BT-DelivAddrSearch~" value="finden">

      {D-SearchTerm}
         <a href="~WS-DelivAddrManageLink~">Suche zurücksetzen</a>
      {/D-SearchTerm}
   </form>
{/D-Overview}
```

[`~D-SearchInput~`](https://dokumentation.websale.de/v8s/referenz/tags/d-lieferadresse) gibt den Feldnamen aus, unter dem der Shop den Suchbegriff erwartet. [`~D-SearchTerm~`](https://dokumentation.websale.de/v8s/referenz/tags/d-lieferadresse) gibt den zuletzt eingegebenen Begriff aus, sodass er nach dem Absenden im Feld stehen bleibt. Der Shop maskiert den Wert dabei HTML-gerecht, Sonderzeichen im Suchbegriff zerstören das Formular also nicht.

Dasselbe Tag dient als Klammerung. Der Link zum Zurücksetzen erscheint damit nur, wenn tatsächlich eine Suche aktiv ist.

Der Suchbegriff wird nicht im Sitzungskontext gehalten. Er gilt nur für den einen Seitenaufruf, in dem gesucht wurde. Navigiert der Käufer zwischendurch woandershin und kehrt zurück, sieht er wieder die vollständige Liste.

### Trefferanzeige

Ob der Käufer gerade sucht oder seine vollständige Liste betrachtet, macht für die Formulierung einen Unterschied. Mit `{D-SearchTerm}` und `{!D-SearchTerm}` unterscheiden Sie beide Fälle, mit `{D-Data}` und `{!D-Data}` zusätzlich, ob überhaupt etwas gefunden wurde.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{D-Overview}
   {D-Data}
      {!D-SearchTerm}
         Gespeicherte Lieferadressen: ~D-Data~
      {/!D-SearchTerm}
      {D-SearchTerm}
         Ihre Suche nach <strong>~D-SearchTerm~</strong> ergab ~D-Data~ Treffer.
      {/D-SearchTerm}
   {/D-Data}

   {!D-Data}
      {!D-SearchTerm}
         Sie haben noch keine Lieferadressen gespeichert.
      {/!D-SearchTerm}
      {D-SearchTerm}
         Ihre Suche nach <strong>~D-SearchTerm~</strong> ergab keinen Treffer.
      {/D-SearchTerm}
   {/!D-Data}
{/D-Overview}
```

Die vier Fälle unterscheiden sich in dem, was der Käufer als Nächstes tun soll. Ohne Treffer und ohne Suche fehlt ihm eine Adresse, ohne Treffer mit Suche ein passender Suchbegriff. Formulieren Sie deshalb nicht viermal dasselbe.

## Dieselbe Suche für Bankdaten und Kreditkartendaten

Für die beiden anderen Bereiche übernehmen Sie den Aufbau unverändert und tauschen die Tags aus. Die Bankdaten-Suche gehört auf das Template `BankManage` in den Bereich `BANK-Overview`, die Kreditkarten-Suche auf `CreditCardManage` in den Bereich `CC-Overview`.

| Lieferadressen | Bankdaten | Kreditkartendaten |
| - | - | - |
| `D-Overview` | `BANK-Overview` | `CC-Overview` |
| `D-Data` | `BANK-Data` | `CC-Data` |
| [`FORM-DelivAddrSearch`](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare#kundenkonto-und-kundendaten) | [`FORM-BankSearch`](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare#kundenkonto-und-kundendaten) | [`FORM-CCardSearch`](https://dokumentation.websale.de/v8s/referenz/tags/form-formulare#kundenkonto-und-kundendaten) |
| [`BT-DelivAddrSearch`](https://dokumentation.websale.de/v8s/referenz/tags/bt/adressen#die-tags-im-uberblick) | [`BT-BankSearch`](https://dokumentation.websale.de/v8s/referenz/tags/bt/zahlungsarten#die-tags-im-uberblick) | [`BT-CCardSearch`](https://dokumentation.websale.de/v8s/referenz/tags/bt/zahlungsarten#die-tags-im-uberblick) |
| `D-SearchInput` | `BANK-SearchInput` | `CC-SearchInput` |
| `D-SearchTerm` | `BANK-SearchTerm` | `CC-SearchTerm` |
| [`WS-DelivAddrManageLink`](https://dokumentation.websale.de/v8s/referenz/tags/multiple-adressen#die-einstiege-im-kundenkonto) | [`WS-BankManageLink`](https://dokumentation.websale.de/v8s/referenz/tags/ws/kunde-anmeldung-und-konto#die-tags-im-uberblick) | [`WS-CCardManageLink`](https://dokumentation.websale.de/v8s/referenz/tags/cc) |

Achten Sie auf die Präfixe. Sie folgen nicht durchgehend demselben Muster: Der Formular- und Schaltflächenname heißt bei den Kreditkarten `CCard`, das Datenpräfix dagegen `CC`.

## Verwandte Themen

* Wegweiser: [Rechnungs- und multiple Lieferadressen abfragen, für das Anlegen der Adressen](https://dokumentation.websale.de/v8s/adressdaten/rechnungs-und-multiple-lieferadressen-abfragen.md)
* Wegweiser: [Standard-Lieferadresse festlegen](https://dokumentation.websale.de/v8s/kundenkonto/standard-lieferadresse-festlegen.md)
* Wegweiser: [Lastschrift, Bankverbindungen abfragen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/lastschrift.md)
* Wegweiser: [Zahlungsart Kreditkarte](https://dokumentation.websale.de/v8s/referenz/tags/cc.md)


## Related topics

- [Rechnungs- und multiple Lieferadressen abfragen](https://dokumentation.websale.de/v8s/adressdaten/rechnungs-und-multiple-lieferadressen-abfragen.md)
- [Schaltflächen für die Adressen](https://dokumentation.websale.de/v8s/referenz/tags/bt/adressen.md)
- [CC- (Kreditkartendaten)](https://dokumentation.websale.de/v8s/referenz/tags/cc.md)
- [Schaltflächen der Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/tags/bt/zahlungsarten.md)
- [D- (Lieferadresse)](https://dokumentation.websale.de/v8s/referenz/tags/d-lieferadresse.md)


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