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