# Widget to Socket Utility

Widget to Socket verwandelt eine Node-Widget-Steuerung in eine Eingangs-Socket. Verwenden Sie es, wenn ein Wert, der normalerweise in einer Node eingegeben, ausgewählt oder verschoben wird, stattdessen von einem anderen Block kommen soll.

Beispiele:

* Einen Schwellenwert aus einer Berechnung steuern.
* Einen Parameter per HMI oder manueller Eingabe kontrollieren.
* Einstellungen von einer SPS, einem Barcode-Leser, einer Rezeptdatei oder einem Headless-Skript einspeisen.
* Mehrere Parameterwerte testen, ohne die Node jedes Mal zu öffnen und das Widget zu bearbeiten.

Diese Seite führt Sie durch ein kleines Szenario. Sie wandeln ein Widget in eine Socket um, verbinden einen dynamischen Wert, führen das Szenario aus und wandeln es bei Bedarf wieder zurück.

## Was Sie bauen werden

Sie erstellen einen Bereichswert aus zwei Number-Inputs und speisen ihn in die konvertierte Widget-Socket ein.

<figure><img src="/files/EfrPkWixgskhkd92Cegg" alt="Scenario before converting a widget to a socket"><figcaption><p>Starten Sie mit einer Node, die noch ihr normales On-Node-Widget verwendet.</p></figcaption></figure>

## Schritt 1: Beispielblöcke hinzufügen

Erstellen Sie ein neues Szenario und fügen Sie diese Blöcke hinzu:

1. Zwei `Number Input`-Blöcke.
2. Einen `Mux`-Block.
3. Einen `Number Range`-Block.
4. Einen Ausgabe- oder Debug-Block, damit Sie das Ergebnis betrachten können.

Stellen Sie den ersten `Number Input` auf den unteren Wert, z. B. `10`.

Stellen Sie den zweiten `Number Input` auf den oberen Wert, z. B. `80`.

Verbinden Sie beide Number Inputs mit dem `Mux`.

{% hint style="info" %}
Dieses Beispiel verwendet `Number Range`, weil der Bereichs-Slider leicht erkennbar ist. Der gleiche Ablauf gilt für andere Node-Widgets, die die API-Konvertierungsaktion anzeigen.
{% endhint %}

## Schritt 2: Das Widget-Menü öffnen

Rechtsklicken Sie auf das Widget, das Sie von einem anderen Block steuern möchten.

Beim `Number Range`-Block: Rechtsklicken Sie auf das `Range Slider`-Widget.

<figure><img src="/files/JSH8aSaL6HRzSZrybtIk" alt="Widget context menu with API conversion action"><figcaption><p>Rechtsklicken Sie das Widget und wählen Sie die API-Konvertierungsaktion.</p></figcaption></figure>

Wählen Sie:

```
[API] Convert to socket
```

## Schritt 3: Die neue Socket bestätigen

Nach der Konvertierung verschwindet das Widget und eine neue Eingangs-Socket erscheint an der Node.

<figure><img src="/files/tP9DfGngngQwj8OLmIu5" alt="New input socket created from the converted widget"><figcaption><p>Die Widget-Einstellung ist jetzt als Eingangs-Socket verfügbar.</p></figcaption></figure>

Der Socket-Name entspricht dem Namen des konvertierten Widgets. Das macht es leichter zu erkennen, welchen Parameter Sie steuern.

## Schritt 4: Den dynamischen Wert verbinden

Verbinden Sie den `Mux`-Ausgang mit der neuen konvertierten Socket am `Number Range`.

<figure><img src="/files/nD5TEpf0Y3C679No00iz" alt="Mux output connected to the converted widget socket"><figcaption><p>Der Node-Parameter kommt jetzt aus einem anderen Teil des Szenarios.</p></figcaption></figure>

Führen Sie das Szenario aus. Der `Number Range`-Block liest nun den eingehenden Wert statt des versteckten Slider-Widgets.

Ändern Sie einen der `Number Input`-Werte und führen Sie erneut aus. Der Bereich aktualisiert sich über die Socket-Verbindung.

## Schritt 5: Bei Bedarf zurückkonvertieren

Wenn Sie keine externe Steuerung mehr möchten, rechtsklicken Sie die konvertierte Socket und wählen:

```
Convert to widget
```

<figure><img src="/files/Z872le1PiIxO7Kk2MsZW" alt="Converted socket menu with Convert to widget action"><figcaption><p>Konvertierte Sockets lassen sich wieder in ihr ursprüngliches Widget zurückverwandeln.</p></figcaption></figure>

Die Eingangs-Socket wird entfernt und das ursprüngliche Widget erscheint wieder.

## Wann Sie es verwenden sollten

Nutzen Sie Widget to Socket, wenn ein Parameter durch Szenario-Logik gesteuert werden soll.

Gute Anwendungsfälle:

* Rezeptgesteuerte Schwellenwerte.
* Bediener-Steuerungen über ein HMI.
* Headless-Szenarien, in denen Werte aus einem Skript oder einer Datei stammen.
* Automatisierte Tests, die viele Parameterwerte durchlaufen.
* Gemeinsame Parameterwerte, die von mehreren Nodes verwendet werden.

Vermeiden Sie es, wenn der Wert immer konstant ist. Ein normales Widget ist einfacher, wenn kein anderer Block den Wert steuern muss.

## Fehlerbehebung

* Wenn `[API] Convert to socket` fehlt, ist dieses Widget nicht konvertierbar.
* Wenn sich das Node-Ergebnis nicht ändert, prüfen Sie, ob der verbundene Block bei jedem Lauf einen Wert liefert.
* Wenn die konvertierte Socket eine Verbindung ablehnt, stimmt möglicherweise der Typ des Quellwerts nicht mit dem erwarteten Widget-Typ überein. Verwenden Sie einen Konverter, `Mux`, `Demux` oder einen passenden Eingangsblock.
* Wird das Szenario unübersichtlicher, benennen Sie nahegelegene Blöcke um, damit die Quelle des Parameters klar erkennbar ist.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/hauptfunktionen/widget-to-socket.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.