# Input switch

The "Input Switch" widget combines 3 functions: 

* Display values
* Switch values
* Display analog trends

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/jrZov0xI0rmOMW1Uha1M/182C97F8-7F88-4267-91E2-4B5C2323FFDB.png" alt=""><figcaption><p>The "Input Switch" widget with 2 linked assets</p></figcaption></figure></div>

You can link multiple assets to this widget and see the value and an analog trend for each individual asset. Using a switch, you can switch between 2 values for each asset. &#x20;

{% hint style="info" %}
**Example:**\
You link multiple air conditioning assets to the widget. \
For each individual air conditioner, you see:

* the current or aggregated temperature (value)
* the temperature trend (analog trend)

For each air conditioner, you can set new values directly via the widget.
{% endhint %}

## Overview

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/UVIt3vuKZxrInsFtTFKD/25F847C8-4B91-45B9-A7C6-BDDD73BB7FFB.png" alt=""><figcaption><p>Overview of the "Input Switch" widget</p></figcaption></figure></div>

<table><thead><tr><th width="99.33333333333331"></th><th width="253"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Title</td><td>Widget title. Is influenced by the selection of the "Primary Asset" (see below.)</td></tr><tr><td><strong>[B]</strong></td><td>Icon</td><td>Widget icon</td></tr><tr><td><strong>[C]</strong></td><td>Section "Values"</td><td>This section displays the values of the assets that were linked under <strong>[I]</strong> with the widget.</td></tr><tr><td><strong>[C1]</strong></td><td>Value</td><td>The respective value of the asset.</td></tr><tr><td><strong>[C2]</strong></td><td>Asset title</td><td>The respective name of the asset. The name can be freely chosen for each asset during widget configuration <strong>[I5]</strong></td></tr><tr><td><strong>[D]</strong></td><td>Section "Switches"</td><td>This section displays the switches that are configured in <strong>[J]</strong> configured</td></tr><tr><td><strong>[D1]</strong></td><td>Switch titles </td><td>The titles displayed here can be customized under <strong>[X]</strong> adjusted.</td></tr><tr><td><strong>[D2]</strong></td><td>Switch for the first asset</td><td>Switch for the first asset that was added under <strong>[J]</strong> added. <br><br>In the example, the switch refers to "Air Conditioning Office 1" and is in the "On" state.  </td></tr><tr><td><strong>[D3]</strong></td><td>Switch for the second asset</td><td>Switch for the second asset that was added under <strong>[J]</strong> added. <br><br>In the example, the switch refers to "Air Conditioning Office 2" and is in the "Off" state.  </td></tr><tr><td><strong>[E]</strong></td><td>Section "Trends"</td><td>Displays the value trend of the assets that were linked under <strong>[K]</strong> .</td></tr><tr><td><strong>[F]</strong></td><td>Set scaling</td><td>Click to select whether a day, a week, or a month should be displayed.</td></tr><tr><td><strong>[G]</strong></td><td>More options</td><td>See <a href="#ueber-widgets-navigieren">-> Navigate through widgets</a></td></tr></tbody></table>

## Configuration

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/NwVvrKXQseNNmexC2z92/ECA91A81-3867-41D0-8DCF-40B76430149F.png" alt=""><figcaption><p>The configuration window in detail</p></figcaption></figure></div>

<table><thead><tr><th width="117.33333333333331"></th><th width="185"></th><th></th></tr></thead><tbody><tr><td><strong>[H]</strong></td><td>Primary asset</td><td>Select primary asset. This selection determines which title <strong>[A]</strong> appears in the widget</td></tr><tr><td><strong>[I]</strong></td><td>Value</td><td>Here you can link one or more assets that will be displayed in the "Values" section <strong>[C]</strong> displayed</td></tr><tr><td><strong>[I1]</strong></td><td>Linked asset</td><td>A linked asset. The data of this asset are displayed in the "Values" section <strong>[C]</strong> displayed</td></tr><tr><td><strong>[I2]</strong></td><td>Handle</td><td>If several assets are present: Use this handle to rearrange assets by drag and drop</td></tr><tr><td><strong>[I3]</strong></td><td>Remove</td><td>Remove the respective asset from the widget. <br>This only affects the display in the widget. The actual asset is not deleted.</td></tr><tr><td><strong>[I4]</strong></td><td>Attribute</td><td>Here you can select the attribute</td></tr><tr><td><strong>[I5]</strong></td><td>Title <br><em>(This field only appears after field [I4] has been filled in)</em></td><td>You can give the linked asset an individual title. This title will be shown in the widget under <strong>[C2]</strong> displayed</td></tr><tr><td><strong>[I6]</strong></td><td>Current value / Aggregated value<br><em>(This field only appears after field [I4] has been filled in)</em></td><td>You can choose whether the current value or an aggregated value should appear in the widget.</td></tr><tr><td><strong>[I7]</strong></td><td>Add another asset</td><td>Click here to add another asset that should appear in the "Value" section</td></tr><tr><td><strong>[J]</strong></td><td>Switch</td><td>Here you can link one or more assets that will be displayed in the "Switch" section <strong>[D]</strong> displayed. You will be able to configure these assets directly via the widget.</td></tr><tr><td><strong>[J1]</strong></td><td>Linked asset</td><td>A linked asset. The data of this asset are displayed in the "Switch" section <strong>[D]</strong> displayed and can also be controlled there </td></tr><tr><td><strong>[J2]</strong></td><td>Remove</td><td>Remove the respective asset from the widget. <br>This only affects the display in the widget. The actual asset is not deleted.</td></tr><tr><td><strong>[J3]</strong></td><td>Title</td><td>You can assign an individual name. This name will be shown in the widget under <strong>[D1]</strong> displayed</td></tr><tr><td><strong>[J4]</strong></td><td>Setpoint</td><td>Enter an attribute</td></tr><tr><td><strong>[J5]</strong></td><td>Current value</td><td>Enter an attribute</td></tr><tr><td><strong>[J6]</strong></td><td>Add another asset</td><td>Click here to add another asset that should appear under "Input"</td></tr><tr><td><strong>[K]</strong></td><td>Trend</td><td>Here you can link one or more assets that will be displayed in the "Trend" section [E].</td></tr><tr><td><strong>[K1]</strong></td><td>Linked asset</td><td>A linked asset. The data of this asset are displayed in the "Trend" section [E].  </td></tr><tr><td><strong>[K2]</strong></td><td>Handle</td><td>If several assets are present: Use this handle to rearrange assets by drag and drop</td></tr><tr><td><strong>[K3]</strong></td><td>Remove</td><td>Remove the respective asset from the widget. <br>This only affects the display in the widget. The actual asset is not deleted.</td></tr><tr><td><strong>[K4]</strong></td><td>Attribute</td><td>Select an attribute for which the trend should be created</td></tr><tr><td><strong>[K5]</strong></td><td>Name</td><td>Enter an individual name for the trend</td></tr><tr><td><strong>[K6]</strong></td><td>Value</td><td>Select whether the current or an aggregated value should be used</td></tr><tr><td><strong>[K7]</strong></td><td>Trend color</td><td>Select a color in which the trend for this asset should be displayed</td></tr><tr><td><strong>[K8]</strong></td><td>Add another asset</td><td>Click here to add another asset that should appear under "Trend" [E]</td></tr><tr><td><strong>[L]</strong></td><td>Add</td><td>Apply settings and add widget</td></tr><tr><td><strong>[M]</strong></td><td>Width</td><td>Select how much space the widget should take up on the dashboard.</td></tr></tbody></table>

## Control values

Next to each linked asset in **\[J]** there is a switch **\[D2]/\[D3].**

* Click a switch that is in the "ON" state to set it to "OFF"
* Click a switch that is in the "OFF" state to set it to "ON".

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/uibJQtnIenfDOwhMt7TQ/98D43939-AC3D-414E-B546-1C9ECC35A7C5.png" alt=""><figcaption><p>Left: switch in "ON" state<br>Right: switch in "OFF" state</p></figcaption></figure>


---

# 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.buildings.ability.abb/collection/english-v14/documentation/widgets/predefined-widgets/input-switch.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.