# 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://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FedgFI5fuKKYaQmhy6HGU%2F182C97F8-7F88-4267-91E2-4B5C2323FFDB.png?alt=media&#x26;token=b872e226-f1ed-4548-94d6-68275dc9769c" alt=""><figcaption><p>The "Input Switch" widget with 2 connected assets</p></figcaption></figure></div>

You can link multiple assets with this widget and see the value and an analog trend for each individual asset. Via a switch, you can toggle between 2 values for each asset.

{% hint style="info" %}
**Example:** You link several air conditioner assets to the widget. You can see for each individual air conditioner:

* the current or aggregated temperature (value)
* the temperature curve (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://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FlhP6wzNQJlJbiLbyVsYO%2F25F847C8-4B91-45B9-A7C6-BDDD73BB7FFB.png?alt=media&#x26;token=a7402382-1c3b-4746-b291-6d512eeb9733" alt=""><figcaption><p>Overview of the "Input Switch" widget</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="69.73332722981769"></th><th width="225"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Title</td><td>Title of the widget. Is influenced by the selection of the "Primary Asset" (see below).</td></tr><tr><td><strong>[B]</strong></td><td>Icon</td><td>Icon of the widget</td></tr><tr><td><strong>[C]</strong></td><td>"Values" section</td><td>This section displays the values of the assets that were linked to the widget under <strong>[I]</strong>.</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 when configuring the widget for each asset <strong>[I5]</strong></td></tr><tr><td><strong>[D]</strong></td><td>"Switch" section</td><td>In this section, the switches that are configured in <strong>[J]</strong> are displayed</td></tr><tr><td><strong>[D1]</strong></td><td>Title of the switches</td><td>The titles that are displayed here can be adjusted under <strong>[X]</strong>.</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>.<br><br>In the example, the switch refers to "Air conditioner 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>.<br><br>In the example, the switch refers to "Air conditioner Office 2" and is in the "Off" state.</td></tr><tr><td><strong>[E]</strong></td><td>"Trends" section</td><td>Displays the value history of the assets that were linked under <strong>[K]</strong>.</td></tr><tr><td><strong>[F]</strong></td><td>Set scale</td><td>Click to choose 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 -> Navigate via widgets</td></tr></tbody></table>

## Configuration

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FjIXTFMZa5G8RN57v0ueQ%2FECA91A81-3867-41D0-8DCF-40B76430149F.png?alt=media&#x26;token=230e789d-aa15-4404-924a-4ace7e70ad18" alt=""><figcaption><p>The configuration window in detail</p></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="58.93333943684894"></th><th width="185"></th><th></th></tr></thead><tbody><tr><td><strong>[H]</strong></td><td>Primary Asset</td><td>Select the 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 are displayed in the "Values" section <strong>[C]</strong></td></tr><tr><td><strong>[I1]</strong></td><td>Linked Asset</td><td>A linked asset. The data of this asset is displayed in the "Values" section <strong>[C]</strong></td></tr><tr><td><strong>[I2]</strong></td><td>Handle</td><td>If multiple assets are present: Use this handle to rearrange assets via 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 when field [I4] has been filled out)</em></td><td>You can give the linked asset an individual title. This title is displayed in the widget under <strong>[C2]</strong></td></tr><tr><td><strong>[I6]</strong></td><td>Current Value / Aggregated Value<br><em>(This field only appears when field [I4] has been filled out)</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 "Values" section</td></tr><tr><td><strong>[J]</strong></td><td>Switch</td><td>Here you can link one or more assets that are displayed in the "Switch" section <strong>[D]</strong>. 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 is displayed in the "Switch" section <strong>[D]</strong> 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 give it an individual name. This name is displayed in the widget under <strong>[D1]</strong></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 are displayed in the "Trend" section [E] displayed.</td></tr><tr><td><strong>[K1]</strong></td><td>Linked Asset</td><td>A linked asset. The data of this asset is displayed in the "Trend" section [E].</td></tr><tr><td><strong>[K2]</strong></td><td>Handle</td><td>If multiple assets are present: Use this handle to rearrange assets via 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>Choose 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] displayed.</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>Choose how much space the widget should occupy on the dashboard.</td></tr></tbody></table>

## Control Values

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

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

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3emagpeGr97ZbY6sFjiP%2F98D43939-AC3D-414E-B546-1C9ECC35A7C5.png?alt=media&#x26;token=753cc585-ea87-429e-9cf9-85c0aab81e46" 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/platform/live-cockpit/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.