Inputs

Inputs

generateInputs(id, config) rendert Eingaben für IOTA-Attribute und Commands. Alle Felder mit data-iota werden von extractData() erfasst.

Top-Level Config

Feld	Required	Typ	Default	Beschreibung
typeId	Ja	string	-	Blocktyp, z.B. block_inputs oder block_mail_inputs.
typeConfig	Ja	object	-	Block-spezifische Konfiguration.
saveButton	Nein	ActionConfig	-	Globaler Speichern-Button.
actionButtons	Nein	ActionConfig[]	-	Zusätzliche Action Buttons.
layout	Nein	{ type?: 'splitActionButtons'; actionButtonsPosition?: 'left' | 'right' }	-	Layout für Action Buttons.

Action Functions

Actions werden nur im Input-Kontext genutzt: in saveButton, actionButtons, input.action.onclick oder onchange.

addMail

Fügt den Inhalt eines Mail-Inputs der Chip-Liste unter dem Feld hinzu.

Verhalten

• Validiert einzelne Mail-Adressen.
• Ignoriert Duplikate.
• Leert das Eingabefeld nach erfolgreichem Hinzufügen.

Beispiel

{
  typeId: 'addMail',
}

offlineInput

Synchronisiert das Offline-Zeitfeld mit der Offline-Checkbox.

Verhalten

• Setzt die Checkbox auf aktiv, wenn der Input nicht leer und nicht 0 ist.

Beispiel

{
  typeId: 'offlineInput',
}

offlineCheckbox

Setzt beim Aktivieren der Offline-Checkbox einen Default-Wert in das Offline-Zeitfeld.

Config

Feld	Required	Typ	Default	Beschreibung
defaultValue	Nein	string | number	48	Wert in Stunden, der in das Offline-Zeitfeld geschrieben wird.

Beispiel

{
  typeId: 'offlineCheckbox',
  config: {
    defaultValue: initVarGraf('${OFFLINE}', 2),
  },
}

updateSelectDependency

Aktualisiert Optionen, Wert und Disabled-State eines Ziel-Selects anhand eines Quell-Selects.

Config

Feld	Required	Typ	Default	Beschreibung
targetIotaVar	Ja	string	-	data-iota des Ziel-Selects.
defaultValue	Nein	string	-	Fallback-Wert, wenn keine Regel passt.
rules	Nein	Array<{ when: string; options?: Array<{ label: string; value: string }>; value?: string; disabled?: boolean }>	-	Regeln pro Quellwert.

Beispiel

{
  typeId: 'updateSelectDependency',
  config: {
    targetIotaVar: 'alarm_level',
    rules: [
      {
        when: 'advanced',
        options: [{ label: 'High', value: 'high' }],
      },
    ],
  },
}

saveAttributes

Speichert alle Inputs, Selects, Checkboxes und Mail-Chips mit data-iota auf dem aktuellen Device.

Verhalten

• Validiert Number-Felder vor dem Speichern.
• Sendet PATCH an /Device/${deviceid}.
• Aktualisiert danach das Dashboard.

Beispiel

{
  typeId: 'saveAttributes',
}

saveNote

Speichert den Wert eines Input-Feldes zuerst im Userlog und danach als description am Device. Die Notiz verwendet den normalen block_inputs; ein eigener Notiz-Block ist nicht notwendig.

Config

Feld	Required	Typ	Default	Beschreibung
deviceId	Nein	string | number	${deviceid}	Device, dessen Beschreibung aktualisiert wird.
iotaVar	Nein	string	note	Input-Feld, dessen Wert gespeichert wird.
savingButton	Nein	string	Speichert …	Button-Text während der Schreibzugriffe.
serial	Nein	string	''	Seriennummer im Userlog-Eintrag.
userLogDeviceId	Nein	string | number	5	DeviceId für den Userlog-Result.

Verhalten

• Leere Notizen, Konfigurationsfehler und API-Fehler werden mit myAlert() angezeigt.
• Während des Speicherns ist der Button deaktiviert.
• Nach einem erfolgreichen Userlog-Eintrag wird { description: note } am Device gespeichert.
• Schlägt nur das Aktualisieren der Device-Beschreibung fehl, wird der Teilerfolg ausdrücklich per myAlert() angezeigt.
• Bei Erfolg wird das Input geleert, notes.success per myAlert() angezeigt und das Dashboard nach dem Device-Update neu geladen. Der Userlog-Request löst keinen Reload aus.
• Liegt saveButton im selben inputAttributes-Eintrag wie das Feld, wird der Button rechts neben dem Feld gerendert.

Beispiel

var config = {
  typeConfig: {
    inputAttributes: [
      {
        input: {
          autocomplete: 'off',
          iotaVar: 'note',
          label: translate('notes.label'),
          maxLength: 1000,
          placeholder: translate('notes.placeholder'),
          required: true,
          type: 'textarea',
        },
        saveButton: {
          config: {
            deviceId: '${deviceid}',
            serial: initVarGraf('${EDITVARS}', 0),
            userLogDeviceId: 5,
          },
          typeId: 'saveNote',
        },
      },
    ],
  },
  typeId: 'block_inputs',
};

generateInputs(id, config);

changeDeviceType

Speichert Attribute, wechselt den DeviceType und leitet danach auf das neue Details-Dashboard weiter.

Config

Feld	Required	Typ	Default	Beschreibung
changeDeviceType.iotaVar	Ja	string	-	Attribut, dessen Wert für die Typauswahl verwendet wird.
changeDeviceType.array	Ja	Array<{ value: string; typeId: string | number }>	-	Mapping von Attributwert zu neuem DeviceType.

Beispiel

{
  typeId: 'changeDeviceType',
  config: {
    changeDeviceType: {
      iotaVar: 'measuring_direction',
      array: [
        { value: 'consumption', typeId: 20437 },
        { value: 'supply', typeId: 20438 },
      ],
    },
  },
}

saveCommand

Sendet einen IOTA Command mit den Werten der Felder im aktuellen Input-Block. Die Config liegt am jeweiligen saveButton, in einem Eintrag von actionButtons oder an einer Feld-Action.

Config

Feld	Required	Typ	Default	Beschreibung
commandType | type	Ja	string	-	Command-Typ. commandType hat Vorrang; type ist der Legacy-Alias.
deviceId | deviceid	Nein	string	${deviceid}	Zielgerät. deviceId hat Vorrang; deviceid ist der Legacy-Alias.
parameterMap	Nein	Record<string, string>	-	Wählt Input-iotaVars aus und benennt sie für den Command um.
staticParameters | parameters	Nein	Array<{ name: string; value: unknown }>	-	Hängt feste Parameter an. staticParameters hat Vorrang; parameters ist der Legacy-Alias.
parameterTransform	Nein	{ type: 'thresholdAlarm'; low?: string; high?: string; active?: string; control?: string }	-	Ersetzt den normalen Parameteraufbau durch den angegebenen Transform. Unterstützt thresholdAlarm.

Die jeweils erstgenannten Feldnamen sind die empfohlenen Varianten. Statische Parameter akzeptieren zusätzlich die Legacy-Schreibweisen Name und Value.

Ablauf

1. Alle Number-Inputs im aktuellen Block werden anhand von min, max und step validiert. Bei einem Fehler wird kein Command gesendet.
2. extractData() liest alle Felder mit data-iota aus demselben Block aus.
3. Die Parameter werden entweder standardmäßig oder über parameterTransform aufgebaut.
4. Der Command wird als PUT /Commands?tenantId=${tenantid} gesendet. Ein erfolgreicher Request zeigt die Erfolgsmeldung und aktualisiert das Dashboard.

Die erzeugte Payload hat immer diese Form:

{
  deviceId: 'target-device-id',
  parameters: [{ name: 'state', value: '1' }],
  type: 'out_set',
}

Standard-Parameter

Ohne unterstützten parameterTransform gelten folgende Regeln:

• Ohne parameterMap wird jedes extrahierte Feld als { name: iotaVar, value } übernommen.
• Mit parameterMap werden nur die dort aufgeführten iotaVars übernommen. Der Map-Key ist die Quell-iotaVar, der Map-Wert der Parametername im Command.
• staticParameters werden anschließend in der angegebenen Reihenfolge angehängt.
• Parameter werden nicht dedupliziert. Configs sollten deshalb keine Namen mehrfach erzeugen.

Beispiel

{
  typeId: 'saveCommand',
  config: {
    commandType: 'out_set',
    parameterMap: {
      relay_state: 'state',
    },
    staticParameters: [{ name: 'source', value: 'grafana' }],
  },
}

Bei einem Feld mit iotaVar: 'relay_state' und dem Wert '1' entstehen daraus:

[
  { name: 'state', value: '1' },
  { name: 'source', value: 'grafana' },
];

parameterTransform: thresholdAlarm

thresholdAlarm bildet zwei optionale Schwellwerte und den Aktiv-Status auf die von IOTA erwarteten Alarmparameter ab.

Feld	Default	Bedeutung
low	threshold_low	iotaVar des unteren Schwellwerts und zugleich Name dieses Parameters im Command.
high	threshold_high	iotaVar des oberen Schwellwerts und zugleich Name dieses Parameters im Command.
active	alarm_active	iotaVar des Aktiv-Status. Dieses Feld wird nur ausgewertet und nicht als Parameter mitgesendet.
control	ctrl	Name des erzeugten Steuerparameters.

Sobald dieser Transform aktiv ist, ersetzt er den Standard-Parameteraufbau vollständig: parameterMap, staticParameters und parameters werden nicht berücksichtigt.

Der Transform behandelt undefined, null und '' als leeren Schwellwert. Andere Werte, einschließlich 0, gelten als gesetzt. Für den Aktiv-Status deaktiviert exakt ein zu '0' konvertierbarer Wert den Alarm.

Aktiv-Status	Unterer Wert	Oberer Wert	Erzeugte Parameter
'0'	beliebig	beliebig	{ name: control, value: 'disabled' }
nicht '0'	gesetzt	gesetzt	low, high, danach { name: control, value: 'below or above' }
nicht '0'	gesetzt	leer	low, danach { name: control, value: 'below' }
nicht '0'	leer	gesetzt	high, danach { name: control, value: 'above' }
nicht '0'	leer	leer	Keine Parameter

Beispiel mit Standard-Feldnamen

{
  typeId: 'saveCommand',
  config: {
    commandType: 'threshold_alarm',
    parameterTransform: {
      type: 'thresholdAlarm',
    },
  },
}

Bei threshold_low: '10', threshold_high: '20' und alarm_active: '1' wird folgende Parameterliste gesendet:

[
  { name: 'threshold_low', value: '10' },
  { name: 'threshold_high', value: '20' },
  { name: 'ctrl', value: 'below or above' },
];

Beispiel mit abweichenden Feldnamen

{
  typeId: 'saveCommand',
  config: {
    commandType: 'temperature_alarm',
    parameterTransform: {
      type: 'thresholdAlarm',
      low: 'temperature_min',
      high: 'temperature_max',
      active: 'temperature_alarm_active',
      control: 'temperature_ctrl',
    },
  },
}

Die zu low, high und active angegebenen Namen müssen den iotaVar-Werten der Felder im selben Input-Block entsprechen. control muss dagegen dem gewünschten Parameter-Namen des IOTA Commands entsprechen.

saveAttributesAndCommand

Speichert zuerst Attribute auf dem aktuellen Device ohne Alert oder Reload und sendet danach einen Command. Der Command verwendet denselben Parameteraufbau wie saveCommand, einschließlich parameterTransform: { type: 'thresholdAlarm' }.

Config

Feld	Required	Typ	Default	Beschreibung
commandType | type	Ja	string	-	Command-Typ.
deviceId | deviceid	Nein	string	${deviceid}	Zielgerät des Commands.
parameterMap	Nein	Record<string, string>	-	Mappt gespeicherte Rohdaten auf Command-Parameter.
staticParameters | parameters	Nein	Array<{ name: string; value: unknown }>	-	Zusätzliche feste Parameter.
parameterTransform	Nein	{ type: 'thresholdAlarm'; low?: string; high?: string; active?: string; control?: string }	-	Alternativer Parameteraufbau wie bei saveCommand.

Verhalten

• Der Command wird nur gesendet, wenn das Attributspeichern erfolgreich war.
• Die Attribute werden immer auf ${deviceid} gespeichert. deviceId beziehungsweise deviceid ändert nur das Ziel des nachfolgenden Commands.

Beispiel

{
  typeId: 'saveAttributesAndCommand',
  config: {
    commandType: 'threshold_set',
    parameterMap: {
      threshold: 'value',
    },
  },
}

saveCommandType

Sendet je nach Checkbox-Wert einen von zwei Command-Typen.

Config

Feld	Required	Typ	Default	Beschreibung
type_1	Ja	string	-	Command-Typ bei Wert 1.
type_0	Ja	string	-	Command-Typ bei Wert 0.
deviceId | deviceid	Nein	string	${deviceid}	Zielgerät.

Verhalten

• Erwartet exakt ein extrahiertes Feld, sonst wird ein Fehler angezeigt.

Beispiel

{
  typeId: 'saveCommandType',
  config: {
    type_1: 'relay_on',
    type_0: 'relay_off',
    deviceId: 'target-device-id',
  },
}

saveAttributesMapped

Speichert nur gemappte Attribute. Nützlich, wenn UI-Feldnamen nicht den IOTA-Attributen entsprechen.

Config

Feld	Required	Typ	Default	Beschreibung
attributeMap	Ja	Record<string, string>	-	Mapping von Input-iotaVar zu Zielattribut.

Beispiel

{
  typeId: 'saveAttributesMapped',
  config: {
    attributeMap: {
      ui_threshold: 'temperature_threshold',
    },
  },
}

saveAttributesToMulitpleDevices

Speichert dieselben Attribute auf mehrere Devices aus einer Grafana-Variable.

Config

Feld	Required	Typ	Default	Beschreibung
usecaseDevicesVarGraf	Ja	string	-	Kommagetrennte DeviceIds, typischerweise aus einer Grafana-Variable.

Verhalten

• Zeigt vorab einen Zeit-Hinweis.
• Sendet Updates nacheinander mit kurzem Delay.

Beispiel

{
  typeId: 'saveAttributesToMulitpleDevices',
  config: {
    usecaseDevicesVarGraf: '${all_usecase_devices}',
  },
}

Feldtypen

input - Input

Standard-Eingabefeld für Text, längere Texte, Zahlen, Passwörter, E-Mail und Selects.

Feld	Required	Typ	Default	Beschreibung
input.label	Nein	string	-	Label oberhalb des Feldes.
input.placeholder	Nein	string	-	Placeholder im Feld.
input.init	Nein	string | number	-	Initialer Wert, meistens aus initVarGraf().
input.iotaVar	Ja	string	-	IOTA-Attribut. Kommagetrennte Werte schreiben denselben Wert auf mehrere Attribute.
input.type	Nein	'text' | 'textarea' | 'email' | 'number' | 'password' | 'select'	text	HTML-Input-Typ. Bei select wird createSelectField genutzt.
input.min	Nein	number	-	Minimalwert für Number-Validierung.
input.max	Nein	number	-	Maximalwert für Number-Validierung.
input.maxLength	Nein	number	-	Maximale Textlänge für Input und Textarea.
input.step	Nein	number | string	-	Schrittweite für Number-Validierung.
input.autocomplete	Nein	string	-	Wert für das native autocomplete-Attribut.
input.required	Nein	boolean	false	Markiert das Feld als erforderlich; Save- und Command-Actions validieren den Wert.
input.icon	Nein	string	-	Classic-Regular-Icon links im Feld; akzeptiert Alias oder direkten FA-Slug.
input.onchange	Nein	ActionConfig	-	Action bei Wert-Änderung.
input.action	Nein	{ icon: string; onclick?: ActionConfig }	-	Classic-Regular-Icon rechts; akzeptiert Alias oder direkten FA-Slug.
input.options	Bedingt	Array<{ label: string; value: string }>	-	Optionen, wenn input.type = select ist.
input.disabled	Nein	boolean	-	Deaktiviert Select-Inputs.
input.shortField	Nein	boolean	false	Begrenzt das Feld auf 16rem. Die Zeile übernimmt die 32rem-Standardbreite und nutzt zwischen kurzen Feldern einen festen Abstand.

Zahlenfeld mit Validierung

{
  input: {
    label: 'Alarm Schwellwert [°C]',
    iotaVar: 'temp_threshold',
    type: 'number',
    min: -10,
    max: 50,
    step: 0.5,
    init: initVarGraf('${THRESHOLD}', 0),
  },
}

Input mit Action-Button

{
  input: {
    label: 'E-Mail',
    iotaVar: 'notification_emails',
    type: 'email',
    icon: 'mail',
    action: {
      icon: 'add',
      onclick: { typeId: 'addMail' },
    },
  },
}

Mehrzeiliges Textfeld

{
  input: {
    iotaVar: 'description',
    label: 'Beschreibung',
    maxLength: 1000,
    type: 'textarea',
  },
}

select - Select

Eigenes Select-Feld oder Input mit type select.

Feld	Required	Typ	Default	Beschreibung
select.label	Nein	string	-	Label oberhalb des Selects.
select.init	Nein	string	-	Initial ausgewählter Wert.
select.iotaVar	Ja	string	-	IOTA-Attribut für den Select-Wert.
select.options	Ja	Array<{ label: string; value: string }>	-	Optionen.
select.onchange	Nein	ActionConfig	-	Action, z.B. updateSelectDependency.
select.disabled	Nein	boolean	-	Rendert den Select deaktiviert.

Einfacher Select

{
  select: {
    label: 'Messrichtung',
    iotaVar: 'measuring_direction',
    init: initVarGraf('${INPUTS}', 1),
    options: [
      { label: 'Verbrauch', value: 'consumption' },
      { label: 'Einspeisung', value: 'supply' },
    ],
  },
}

Select mit abhängigen Optionen

{
  select: {
    label: 'Modus',
    iotaVar: 'mode',
    options: [
      { label: 'Standard', value: 'standard' },
      { label: 'Erweitert', value: 'advanced' },
    ],
    onchange: {
      typeId: 'updateSelectDependency',
      config: {
        targetIotaVar: 'alarm_level',
        rules: [
          {
            when: 'advanced',
            options: [{ label: 'High', value: 'high' }],
          },
        ],
      },
    },
  },
}

checkbox - Checkbox

Toggle, der als 1 oder 0 extrahiert und gespeichert wird.

Feld	Required	Typ	Default	Beschreibung
checkbox.label	Nein	string	-	Text neben der Checkbox.
checkbox.init	Nein	string | number	-	0 = aus, 1 = an.
checkbox.iotaVar	Ja	string	-	IOTA-Attribut.
checkbox.onchange	Nein	ActionConfig	-	Action bei Statuswechsel.
checkbox.center	Nein	boolean	false	Zentriert die Checkbox.

Checkbox mit Save

{
  checkbox: {
    label: 'Alarm aktiv',
    iotaVar: 'alarm_active',
    init: initVarGraf('${ALARMS}', 0),
  },
  saveButton: { typeId: 'saveAttributes' },
}

checkbox2 - Zweite Checkbox

Optionaler zweiter Toggle in demselben Feld.

Feld	Required	Typ	Default	Beschreibung
checkbox2.label	Nein	string	-	Text neben der zweiten Checkbox.
checkbox2.init	Nein	string | number	-	0 = aus, 1 = an.
checkbox2.iotaVar	Ja	string	-	IOTA-Attribut.
checkbox2.onchange	Nein	ActionConfig	-	Action bei Statuswechsel.

Zwei Checkboxen in einem Feld

{
  checkbox: {
    label: 'Eingang',
    iotaVar: 'io_in',
    init: initVarGraf('${IO}', 0),
  },
  checkbox2: {
    label: 'Ausgang',
    iotaVar: 'io_out',
    init: initVarGraf('${IO}', 1),
  },
}

dependentCheckbox - Abhängige Checkbox

Checkbox, die nur aktiv ist, wenn checkbox oder checkbox2 aktiv ist.

Feld	Required	Typ	Default	Beschreibung
dependentCheckbox.label	Nein	string	-	Text neben der abhängigen Checkbox.
dependentCheckbox.init	Nein	string | number	-	Initialwert. Wird ignoriert, wenn keine Hauptcheckbox aktiv ist.
dependentCheckbox.iotaVar	Ja	string	-	IOTA-Attribut.

Abhängige Benachrichtigung

{
  checkbox: {
    label: 'Alarm aktiv',
    iotaVar: 'alarm_active',
    init: initVarGraf('${ALARM}', 0),
  },
  dependentCheckbox: {
    label: 'Push zusätzlich aktivieren',
    iotaVar: 'alarm_push',
    init: initVarGraf('${ALARM}', 1),
  },
}

display - Display

Statische Textanzeige für Werte, die nicht bearbeitet oder gespeichert werden.

Feld	Required	Typ	Default	Beschreibung
display.label	Nein	string	-	Label oberhalb des Textes.
display.value	Ja	string | number	-	Anzuzeigender Textwert.
display.emptyText	Nein	string	-	Text, wenn value leer ist.

Statischen Text anzeigen

{
  display: {
    emptyText: 'Keine Einstellung vorhanden!',
    label: 'Alarmeinstellung auf dem Sensor:',
    value: initVarGraf('${SENSOR_THRESHOLD}', 0),
  },
}

Mail

E-Mail-Eingabe mit Chip-Liste, Semikolon-Trennung und Validierung.

Feld	Required	Typ	Default	Beschreibung
mail.label	Nein	string	-	Label des Mail-Feldes.
mail.init	Nein	string	-	Initiale Mail-Liste, getrennt mit Semikolon.
mail.iotaVar	Ja	string	-	IOTA-Attribut für die gespeicherte Semikolon-Liste.

Mail-Liste

{
  mail: {
    label: 'Benachrichtigungen an:',
    iotaVar: 'notification_emails',
    init: initVarGraf('${MAILS}', 0),
  },
}

Action Buttons

Zusätzliche Buttons unter oder neben dem Input-Inhalt.

Feld	Required	Typ	Default	Beschreibung
actionButtons[].label	Ja	string	-	Button-Text.
actionButtons[].typeId	Ja	Action typeId	-	Action aus der Action-Referenz.
layout.type	Nein	'splitActionButtons'	-	Teilt Inhalt und Buttons in zwei Spalten.
layout.actionButtonsPosition	Nein	'left' | 'right'	right	Position der Buttons im Split-Layout.

Split-Layout mit Command-Buttons

var config = {
  typeId: 'block_inputs',
  layout: {
    type: 'splitActionButtons',
    actionButtonsPosition: 'right',
  },
  actionButtons: [
    {
      label: 'Relais setzen',
      typeId: 'saveCommand',
      config: { commandType: 'relay_set' },
    },
  ],
  typeConfig: {
    inputAttributes: [{ input: { label: 'Status', iotaVar: 'relay_state' } }],
  },
};

Blocktypen

block_inputs - Inputs

Eine Standardzeile mit beliebigen Input-, Select-, Checkbox- oder Display-Feldern.

Config-Pfad: typeConfig.inputAttributes

Feld	Required	Typ	Default	Beschreibung
saveButton	Nein	ActionConfig	-	Globaler Speichern-Button unterhalb aller Felder.
typeConfig.inputAttributes	Ja	Array<FieldConfig>	-	Felder in einer Zeile.
typeConfig.inputAttributes[].saveButton	Nein	ActionConfig	-	Speichern-Button rechts neben dem zugehörigen Feld.

Drei Attribute speichern

var config = {
  typeId: 'block_inputs',
  saveButton: { typeId: 'saveAttributes' },
  typeConfig: {
    inputAttributes: [
      { input: { label: 'Name', iotaVar: 'serial', init: initVarGraf('${EDITVARS}', 0) } },
      {
        input: {
          label: 'Installationsort',
          iotaVar: 'installation_place',
          init: initVarGraf('${EDITVARS}', 1),
        },
      },
      {
        input: { label: 'Kommentar', iotaVar: 'description', init: initVarGraf('${EDITVARS}', 2) },
      },
    ],
  },
};

block_mail - Mail

Standard-Mail-Konfiguration mit optionaler Checkbox, zweiter Checkbox und dependentCheckbox.

Config-Pfad: typeConfig.mailConfig

Feld	Required	Typ	Default	Beschreibung
typeConfig.mailConfig.mail	Ja	MailConfig	-	Mail-Feld.
typeConfig.mailConfig.checkbox	Nein	CheckboxConfig	-	Hauptcheckbox.
typeConfig.mailConfig.checkbox2	Nein	CheckboxConfig	-	Zweite Hauptcheckbox.
typeConfig.mailConfig.dependentCheckbox	Nein	CheckboxConfig	-	Nur aktiv, wenn checkbox oder checkbox2 aktiv ist.
typeConfig.mailConfig.saveButton	Nein	ActionConfig	-	Speichern für die Mail-Zeile.

Mail mit Aktivierungscheckbox

var config = {
  typeId: 'block_mail',
  typeConfig: {
    mailConfig: {
      mail: {
        label: 'Report E-Mails',
        iotaVar: 'report_emails',
        init: initVarGraf('${REPORT}', 1),
      },
      checkbox: {
        label: 'Reporting aktivieren',
        iotaVar: 'report_active',
        init: initVarGraf('${REPORT}', 0),
      },
      saveButton: { typeId: 'saveAttributes' },
    },
  },
};

block_mail_inputs - Mail und Inputs

Zwei Spalten: Attributzeilen und Mail-Konfiguration. Optional kann die Reihenfolge gedreht werden.

Config-Pfad: typeConfig

Feld	Required	Typ	Default	Beschreibung
typeConfig.rows	Ja	Array<RowConfig>	-	Attributzeilen.
typeConfig.mailConfig	Ja	MailConfig	-	Mail-Konfiguration.
typeConfig.reverseCols	Nein	boolean	false	Dreht die Spaltenreihenfolge.

RowConfig

Feld	Required	Typ	Default	Beschreibung
attributes	Ja	Array<FieldConfig>	[]	Felder, die innerhalb der Row gerendert werden.
header	Nein	string	-	Zentrierte Überschrift der Row.
extraTopMargin	Nein	boolean	false	Fügt oberhalb der Row zusätzlichen Abstand ein.
hideDividerBefore	Nein	boolean	false	Blendet den Trenner zur vorherigen Row aus.
hideDividerAfter	Nein	boolean	false	Blendet den Trenner zur nachfolgenden Row aus.

Zwischen zwei Rows wird kein Trenner angezeigt, sobald hideDividerAfter an der vorherigen Row oder hideDividerBefore an der nachfolgenden Row gesetzt ist. Vor der ersten und nach der letzten Row wird grundsätzlich kein Trenner erzeugt. Ein display innerhalb von attributes erzeugt eine reine Textzeile.

Schwellwerte und Mails

var config = {
  typeId: 'block_mail_inputs',
  saveButton: { typeId: 'saveAttributes' },
  typeConfig: {
    rows: [
      {
        attributes: [
          {
            input: {
              iotaVar: 'temp_min',
              label: 'unterer Alarm',
              shortField: true,
              step: 0.5,
              type: 'number',
            },
          },
          {
            input: {
              iotaVar: 'temp_max',
              label: 'oberer Alarm',
              shortField: true,
              step: 0.5,
              type: 'number',
            },
          },
        ],
        header: 'Temperatur [°C]',
      },
      {
        attributes: [
          {
            display: {
              emptyText: 'Keine Einstellung vorhanden!',
              label: 'Alarmeinstellung auf dem Sensor:',
              value: initVarGraf('${SENSOR_THRESHOLD}', 0),
            },
          },
        ],
        hideDividerBefore: true,
      },
    ],
    mailConfig: { mail: { label: 'Alarm Mails', iotaVar: 'alarm_mails' } },
    reverseCols: true,
  },
};

block_offline - Offline

Spezialblock für Offline-Benachrichtigungen mit Mail-Liste, Checkbox und Offline-Zeit.

Config-Pfad: typeConfig.offline

Feld	Required	Typ	Default	Beschreibung
typeConfig.offline.checkbox	Ja	CheckboxConfig	-	Aktiviert Offline-Benachrichtigung.
typeConfig.offline.input	Ja	InputConfig	-	Offline-Zeit in Stunden; wird beim Speichern als Minutenwert geschrieben.
typeConfig.offline.mail	Ja	MailConfig	-	Mail-Liste.
typeConfig.offline.saveButton	Nein	ActionConfig	{ typeId: 'saveAttributes' }	Speichern der Offline-Zeit.
typeConfig.reverseCols	Nein	boolean	false	Dreht Mail- und Offline-Spalte.

Offline Alarm

var config = {
  typeId: 'block_offline',
  typeConfig: {
    offline: {
      checkbox: { label: 'Offline Alarm aktiv', onchange: { typeId: 'offlineCheckbox' } },
      input: {
        label: 'Offline-Zeit [h]',
        iotaVar: 'offline_time',
        onchange: { typeId: 'offlineInput' },
      },
      mail: { iotaVar: 'offline_emails', init: initVarGraf('${OFFLINE}', 1) },
    },
  },
};

block_checkbox_row - Checkbox Row

Eine horizontale Reihe aus Checkboxes mit optionalem Save-Button.

Config-Pfad: typeConfig.checkboxRow

Feld	Required	Typ	Default	Beschreibung
typeConfig.checkboxRow.checkboxes	Ja	Array<CheckboxConfig>	-	Checkboxes in der Reihe.
typeConfig.checkboxRow.saveButton	Nein	ActionConfig	-	Speicherbutton unterhalb der Reihe.

IO Richtung

var config = {
  typeId: 'block_checkbox_row',
  typeConfig: {
    checkboxRow: {
      checkboxes: [
        { label: 'Eingang', iotaVar: 'io_in', init: initVarGraf('${IO}', 0) },
        { label: 'Ausgang', iotaVar: 'io_out', init: initVarGraf('${IO}', 1) },
      ],
      saveButton: { typeId: 'saveAttributes' },
    },
  },
};

block_custom - Custom

Container für mehrere Custom Columns.

Config-Pfad: typeConfig.custom_columns

Feld	Required	Typ	Default	Beschreibung
typeConfig.custom_columns	Ja	Array<CustomColumnConfig>	-	Liste von Custom Columns.

Custom Grid

var config = {
  typeId: 'block_custom',
  typeConfig: {
    custom_columns: [
      {
        typeId: 'custom_column_inputs',
        typeConfig: {
          headers: ['unterer Alarm', 'oberer Alarm'],
          rows: [
            {
              title: 'Distanz [m]',
              inputs: [
                { iotaVar: 'alarm_low', type: 'number', step: 0.01 },
                { iotaVar: 'alarm_high', type: 'number', step: 0.01 },
              ],
            },
          ],
        },
      },
    ],
  },
};

custom_column_mail - Custom Column Mail

Mail-Spalte innerhalb von block_custom.

Config-Pfad: typeConfig.mailConfig

Feld	Required	Typ	Default	Beschreibung
typeConfig.mailConfig	Ja	MailConfig	-	Mail-Konfiguration.

Mail-Spalte in Custom Panel

{
  typeId: 'custom_column_mail',
  typeConfig: {
    mailConfig: {
      mail: {
        label: 'Alarm Mails',
        iotaVar: 'alarm_mails',
        init: initVarGraf('${MAILS}', 0),
      },
      saveButton: { typeId: 'saveAttributes' },
    },
  },
}

custom_column_inputs - Custom Column Inputs

Tabellarisches Input-Grid mit Spaltenüberschriften und Zeilentiteln.

Config-Pfad: typeConfig

Feld	Required	Typ	Default	Beschreibung
typeConfig.headers	Ja	Array<string>	-	Spaltenüberschriften.
typeConfig.rows	Ja	Array<{ title: string; inputs: InputConfig[] }>	-	Grid-Zeilen.

Tabellarische Schwellwerte

{
  typeId: 'custom_column_inputs',
  typeConfig: {
    headers: ['untere Warnung', 'obere Warnung'],
    rows: [
      {
        title: 'Temperatur [°C]',
        inputs: [
          { iotaVar: 'temp_warning_low', type: 'number', step: 0.5 },
          { iotaVar: 'temp_warning_high', type: 'number', step: 0.5 },
        ],
      },
    ],
  },
}

custom_column_checkbox_row - Custom Column Checkbox Row

Checkbox-Reihe innerhalb von block_custom.

Config-Pfad: typeConfig.checkboxRow

Feld	Required	Typ	Default	Beschreibung
typeConfig.checkboxRow.checkboxes	Ja	Array<CheckboxConfig>	-	Checkboxes.

Checkbox-Reihe in Custom Panel

{
  typeId: 'custom_column_checkbox_row',
  typeConfig: {
    checkboxRow: {
      checkboxes: [
        { label: 'Eingang', iotaVar: 'io_in' },
        { label: 'Ausgang', iotaVar: 'io_out' },
      ],
      saveButton: { typeId: 'saveAttributes' },
    },
  },
}

custom_column_checkbox_input - Custom Column Checkbox Input

Kombiniert eine Checkbox mit einem Input in einer Custom Column.

Config-Pfad: typeConfig

Feld	Required	Typ	Default	Beschreibung
typeConfig.checkbox	Ja	CheckboxConfig	-	Checkbox.
typeConfig.input	Ja	InputConfig	-	Input.
typeConfig.saveButton	Nein	ActionConfig	-	Optionaler Speicherbutton.

Checkbox mit Zahlenwert

{
  typeId: 'custom_column_checkbox_input',
  typeConfig: {
    checkbox: {
      label: 'Grenzwert aktiv',
      iotaVar: 'threshold_active',
      init: initVarGraf('${THRESHOLD}', 0),
    },
    input: {
      label: 'Grenzwert',
      iotaVar: 'threshold_value',
      type: 'number',
      step: 0.5,
      init: initVarGraf('${THRESHOLD}', 1),
    },
    saveButton: { typeId: 'saveAttributes' },
  },
}