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