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

# Produkt mit bestimmter Variantenkombination anzeigen

> Wie Sie in WEBSALE V8s festlegen, mit welcher abhängigen Variantenkombination ein Produkt aufgerufen wird, entweder über die Produktdaten oder direkt im Template.

Ruft ein Käufer ein Produkt mit abhängigen Varianten auf, ist zunächst keine Kombination gewählt. Sie können stattdessen eine Kombination vorauswählen, sodass das Produkt sofort in einer sinnvollen Ausführung erscheint. Ein Hemd zeigt dann beispielsweise gleich Armlänge 65 cm und Größe 42. Ändern kann der Käufer die Auswahl weiterhin.

Dafür gibt es zwei Wege, die sich darin unterscheiden, wo die Vorauswahl gepflegt wird.

| Weg | Vorauswahl steht in | Sinnvoll, wenn |
| - | - | - |
| Produktdaten | einem Produktdatenfeld je Produkt | jedes Produkt seine eigene Vorauswahl bekommen soll |
| Template | dem Tag `PR-PreSelectDepVariation()` | für alle Produkte eines Templates dieselbe Regel gelten soll |

## Weg 1: Vorauswahl in den Produktdaten

Diese Vorauswahl lässt sich für einfache Produkte und für Sets definieren. Eine Freischaltung durch WEBSALE ist nicht nötig.

![Vorausgew Abh Var](https://mintcdn.com/websaleag-44ee7ea6/Gu3qq65BeVAUJPgW/images/vorausgew.abh.var.png?fit=max\&auto=format\&n=Gu3qq65BeVAUJPgW\&q=85\&s=455be63db953994231b18fcc63ebb2ef)

In dem obigen Beispiel wird das ausgewählte Hemd nach entsprechender Definition standardmäßig mit den vorausgewählten Varianten Armlänge = 65cm und Größe = 42 angezeigt.

### Produktdatenfeld setzen

Für einfache Produkte übergeben Sie dieses Feld:

| Feldname | Länge | Beschreibung |
| - | - | - |
| `DefaultDepVarIndex` | maximal 64 Zeichen | Variantenindex der vorausgewählten abhängigen Variantenkombination |

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<5-3406><12-3406>
```

Für Set-Produkte ist ein eigenes Feld vorgesehen, weil dort mehrere Produkte gleichzeitig betroffen sind:

| Feldname | Länge | Beschreibung |
| - | - | - |
| `DefaultSetDepVarIndex` | maximal 1024 Zeichen | Liste der Variantenindizes für das Set |

Die Liste folgt einem festen Aufbau:

* als Parameter-Wert-Paare im URL-Format, ohne URL-Codierung
* der Variantenindex des Set-Oberprodukts im Parameter `depvar_index_setparent`
* die Variantenindizes der Set-Unterprodukte in den Parametern `depvar_index_set_<Laufindex des Set-Unterprodukts>`

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
depvar_index_setparent=<PFLA644><PFLA644.135...1000>&depvar_index_set_1=<ZFLXXXXA><ZFLXXXXAA01>&depvar_index_set_2=<ZXXXX97N><ZXXXX97NN90>&depvar_index_set_3=<ZFLXXXXD><ZFLXXXXDD00>
```

Die Parameterliste hat damit genau dasselbe Format wie die Ausgabe des Tags `PR-SetLink`. Wenn Sie unsicher sind, wie eine Liste aussehen muss, lassen Sie sich diese Ausgabe für das Set anzeigen und übernehmen sie.

Referenz: [PR-SetLink](https://dokumentation.websale.de/v8s/referenz/tags/pr/bilder-und-links.md#die-tags-im-uberblick)

> [!WARNING]
>
> Geben Sie bei einem Set-Produkt eine Vorauswahl für das gesamte Set an, werden die Vorauswahlen der einzelnen Set-Unterprodukte nicht mehr berücksichtigt. Das gilt auch dann, wenn Ihre Angabe nur Teile des Sets betrifft.

### Vorauswahl im Template ausgeben

Optional geben Sie den hinterlegten Variantenindex auf der Produktdetailansicht aus, beispielsweise zur Kontrolle.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{PR-DefaultDepVarIndex}
   ~PR-DefaultDepVarIndex~       <!-- Variantenindex des Produkts -->
{/PR-DefaultDepVarIndex}

{PR-DefaultSetDepVarIndex}
   ~PR-DefaultSetDepVarIndex~    <!-- Liste der Variantenindizes des Set-Produkts -->
{/PR-DefaultSetDepVarIndex}
```

Referenz: [PR-DefaultDepVarIndex](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)

### Funktion aktivieren

Die gepflegten Felder wirken erst, wenn Sie die Funktion in der Shopkonfiguration `shop.config` im Abschnitt `<Basic>` freigeben. Der Parameter kennt zwei Werte, und die Reihenfolge ist bewusst so gedacht: erst im Testmodus prüfen, dann live schalten.

| Wert | Wirkung |
| - | - |
| `test` | Die Vorauswahl greift nur im Testmodus des Shops |
| `yes` | Die Vorauswahl greift im Produktivbetrieb |

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

Mit dem Wert `test` rufen Sie den Shop im Testmodus auf und prüfen Ihre Produkte:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.xyz.de/?test=on
```

Erscheinen die vorausgewählten Kombinationen wie gewünscht, beenden Sie den Testmodus und stellen den Parameter auf `yes`.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.xyz.de/?test=off
```

Referenz: [Abschnitt Basic](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/grundlagen-und-technik.md#basic)

## Weg 2: Vorauswahl im Template

Statt je Produkt lässt sich die Vorauswahl auch im Template festlegen. Das Tag `PR-PreSelectDepVariation()` erwartet dafür zwei Angaben: die gewünschte Kombination und das Verhalten, falls es diese Kombination nicht gibt.

Die Kombination geben Sie wahlweise über den Variantennamen oder über den Variantenindex an. Für den Fall der Nichtverfügbarkeit stehen drei Verhaltensweisen zur Wahl: das Basisprodukt laden, die nächstliegende Kombination laden oder die erste ermittelte Kombination laden.

Im folgenden Beispiel ist das Produkt in mehreren Farben erhältlich und soll mit "saphirblau" erscheinen. Gibt es diese Farbe nicht, wird die nächstliegende Kombination geladen.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~PR-PreSelectDepVariation(nearestCombination,"Farbe=saphirblau")~
~PR-DepVariations~
```

Eine Freischaltung durch WEBSALE ist auch hier nicht nötig.

In der Vorauswahl lassen sich nur Produktfelder und deren Werte angeben. Andere Informationen, beispielsweise der Lagerbestand, sind als Kriterium nicht möglich.

Greift die Vorauswahl nicht wie erwartet, hilft ein Statuscode bei der Fehlersuche. Die Bedeutung der einzelnen Codes steht in der Tag-Beschreibung.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Statuscode: ~PR-PreSelectDepVariationResultCode~
```

Referenz: [PR-PreSelectDepVariation()](https://dokumentation.websale.de/v8s/referenz/tags/pr/grundlagen-und-produktdaten.md)

## Verwandte Themen

* Wegweiser: [Abhängige Varianten anzeigen](https://dokumentation.websale.de/v8s/abhaengige-varianten/abhaengige-varianten-anzeigen.md)
* Wegweiser: [Set-Produkte](https://dokumentation.websale.de/v8s/warenkorb/warenkorb-anzeigen-loeschen.md#set-produkte)
* Wegweiser: [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md)


## Related topics

- [Abhängige Varianten anzeigen](https://dokumentation.websale.de/v8s/abhaengige-varianten/abhaengige-varianten-anzeigen.md)
- [Abhängige Varianten als grafische Ansicht anzeigen](https://dokumentation.websale.de/v8s/abhaengige-varianten/abhaengige-varianten-als-grafische-ansicht-anzeigen.md)
- [Gewähltes Produkt anzeigen](https://dokumentation.websale.de/v8s/produkte/gewaehltes-produkt-anzeigen.md)
- [Beliebiges Produkt anzeigen](https://dokumentation.websale.de/v8s/produkte/beliebiges-produkt-anzeigen.md)
- [Bekleidungsmodul](https://dokumentation.websale.de/v8s/kategorien/bekleidungsmodul.md)


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