# Regelkette konfigurieren ## Übersicht


[A]	Kette starten/stoppen	Startet oder stoppt die aktuelle Regelkette.
[B]	ausgelöst	Wählen Sie, ob der Trigger ereignisbasiert oder zyklusbasiert. -> Trigger
[C]	Trigger-Einstellungen	Hier kann der Trigger konfiguriert werden. -> Trigger
[D]	Codeansicht	Zeigt den Codeansicht.
[E]	Fehler	Zeigt an, wie viele Fehler vorliegen. Ein Klick darauf öffnet ein Fenster, das die Fehler im Detail anzeigt.
[F]	Reihenfolge festlegen	Nach dem Klick Reihenfolge festlegenkönnen Sie die Blockreihenfolge bestimmen, in der sie ausgeführt werden sollen, indem Sie auf die Elemente in [L] nacheinander klicken.
[G]	Löschen	Hier kann der Regelkette kann gelöscht werden.
[H]	Speichern	Speichern Sie Ihre Änderungen.
[I]	Knoten	Knoten sind die Schnittstellen zum System BuildingPro Suites, die verschiedene Aktionen oder Datenverknüpfungen darstellen.
[J]	Bedingungen	Wird verwendet, um Bedingungen zwischen den Knoten zu erstellen, einschließlich zeitbasierter Bedingungen.
[K]	Operationen	Führt logische Operationen (z. B. UND, ODER) innerhalb der Regelkette aus.
[L]	Verknüpfungsfeld	Bereich, in dem die Knoten und Verbindungen platziert und miteinander verknüpft werden.

## Schritt für Schritt eine Regelkette erstellen 1. Stellen Sie sicher, dass Sie sich in der Konfiguration der gewünschten Regelkette befinden. [-> Öffnen Sie die Konfiguration einer vorhandenen Regelkette.](https://docs.buildings.ability.abb/collection/german/plattform/alarms-rules-and-escalations/rule-chains/open-the-configuration-of-an-existing-rule-chain) 2. **Trigger auswählen** Entscheiden Sie, ob die Regel ereignisbasiert oder zyklusbasiert ausgelöst werden soll, und konfigurieren Sie den *Objekts* oder das Zeitintervall. [-> Trigger](#trigger) 3. **Bausteine hinzufügen** Ziehen Sie die benötigten Bausteine per Drag-and-drop auf die Arbeitsfläche \[L]. [-> Bausteine hinzufügen](#add-building-blocks) 4. **Bausteine konfigurieren** Klicken Sie auf das Zahnradsymbol im Baustein, um spezifische Einstellungen wie *Objekts*, Attribute oder Bedingungen vorzunehmen.[ -> Einen Baustein konfigurieren](#configure-a-building-block) 5. **Bausteine verbinden** Verbinden Sie die Bausteine, indem Sie eine Linie von einem **Ausgangspin** zu einem **Eingangspin** ziehen (achten Sie auf die gleichen Farben). [-> Bausteine verbinden](#connect-building-blocks) 6. **Auf Fehler prüfen** Verwenden Sie das Fehlerfenster, um Fehler zu finden und zu beheben. [-> Fehler](#errors) 7. **Reihenfolge festlegen** Bestimmen Sie die Ausführungsreihenfolge der Bausteine im Modus „Reihenfolge festlegen“. [-> Reihenfolge festlegen](#set-order) 8. **Änderungen speichern** Vergessen Sie nicht, Ihre Änderungen zu speichern **\[H]** *** ## ausgelöst Unter **Trigger \[B]**, können Sie wählen, ob die Regelkette ausgelöst werden soll **ereignisbasiert** oder **zyklusbasiert**: * **Ereignisbasiert**: In diesem Fall muss ein **Asset und sein Attribut** in **\[C]**ausgewählt werden. Jedes Mal, wenn neue Daten in dieses Attribut geschrieben werden, wird die Regelkette automatisch ausgelöst.

* **Zyklusbasiert**: Wenn die Regelkette zyklisch ausgelöst werden soll, können Sie die Anzahl der **Sekunden** in **\[C]** festlegen, nach denen die Regelkette in regelmäßigen Abständen ausgeführt wird.

{% hint style="info" %} Ausgangsknoten werden nur ausgelöst, wenn sich der eingehende Wert ändert. {% endhint %} *** ## Codeansicht In der **Codeansicht**, können Sie die erstellte **JSON-Code** Ihrer Regelkette anzeigen und bearbeiten. Um den **Codeansicht**zu erstellen, klicken Sie auf **\[D]**. Sobald dies aktiviert ist, wird der JSON-Code der Regelkette angezeigt, der die Konfiguration und Reihenfolge der Knoten und Bedingungen enthält. Sie haben die Möglichkeit, den Code direkt zu ändern, um spezifische Anpassungen vorzunehmen, anstatt die visuelle Benutzeroberfläche zu verwenden.

*** ## Fehler Wenn Sie auf **Fehler \[E]**klicken, öffnet sich ein Fenster, das alle vorhandenen Fehler im Detail anzeigt.

Durch Klicken auf das **Lokalisierungssymbol**

können Sie direkt zu dem Element springen, das den Fehler im **Verknüpfungsfeld \[L]**. *** ## Reihenfolge festlegen Klicken Sie auf **Reihenfolge festlegen \[F]** um die **Ausführungsreihenfolge** der Knoten in der Regelkette festzulegen. * Sobald dieser Modus aktiviert ist, können Sie auf die Knoten im **Verknüpfungsfeld \[L]** nacheinander klicken, um die Reihenfolge ihrer Ausführung festzulegen. * Die **Sequenznummer** wird automatisch erhöht und erscheint oben rechts an jedem Knoten. So können Sie direkt sehen, in welcher Reihenfolge die Knoten ausgeführt werden. *** ## Bausteine hinzufügen Um eine Regel zu erstellen, können die gewünschten Bausteine aus der rechten Leiste per Drag-and-drop auf das **\[L]** Feld gezogen werden. Jeder Baustein stellt eine bestimmte Funktion dar, die in der Regelkette verwendet werden kann.

## Einen Baustein konfigurieren Um einen Baustein zu konfigurieren, klicken Sie auf das Zahnradsymbol oben rechts im Baustein. Dadurch öffnet sich ein Fenster, in dem die einzelnen Einstellungen des Bausteins angepasst werden können, z. B. die Anzahl der Ein- und Ausgangspins, die *Objekts* verwendet werden soll, die Attribute oder die Bedingungen.

## Bausteine verbinden Bausteine werden miteinander verbunden, indem eine Linie von einem Ausgangspin zu einem Eingangspin eines anderen Bausteins gezogen wird. Achten Sie darauf, dass die Ausgangs- und Eingangspins die gleiche Farbe haben: * **Rot** steht für numerische Werte. * **Blau** steht für boolesche Werte (wahr/falsch). Nur Pins mit der gleichen Farbe können miteinander verbunden werden, um eine korrekte Datenübertragung sicherzustellen. ### Dynamische Pin-Erweiterung Wenn alle vorhandenen Pins eines Bausteins bereits belegt sind, erscheint ein neuer Pin, wenn Sie den Mauszeiger über einen belegten Pin bewegen. Dieser kann verwendet werden, um eine Verbindung zu einem anderen Eingang herzustellen. Sobald die Verbindung erstellt wurde, wird der neue Pin automatisch aktiviert und dauerhaft hinzugefügt.

### Werte nach der Ausführung visualisieren Nachdem eine Regelkette gespeichert und mindestens einmal ausgeführt wurde, werden die aktuellen Werte an den Ein- und Ausgangspins der Bausteine in Lila sichtbar. Diese Werte zeigen an, welche Daten durch die Regelkette fließen, und ermöglichen eine direkte Überprüfung der Logik. {% hint style="info" %} Die angezeigten Werte werden mit jeder neuen Ausführung aktualisiert und helfen bei der Fehlersuche und Optimierung der Regelkette. {% endhint %} *** ## Die Bausteine Bausteine sind die grundlegenden Elemente einer Regelkette. Jeder Baustein führt eine bestimmte Funktion aus, z. B. das Abrufen von Daten, das Setzen von Bedingungen oder das Ausführen von Aktionen wie dem Senden von Alarmen oder E-Mails. Bausteine können miteinander verbunden werden, um komplexe Prozesse zu steuern. Der Datenfluss wird über Ein- und Ausgangspins geregelt, wobei nur kompatible Pins miteinander verbunden werden können. A **Notiz** kann auch in der Konfiguration eines Bausteins gespeichert werden. Dies dient dazu, wichtige Informationen oder Erklärungen direkt im Baustein zu dokumentieren und das Verständnis der Regelkette zu erleichtern.

### Knoten #### Daten abrufen

**Funktion**: Dieser Baustein liest Heap-Daten aus einem bestimmten *Objekts* und dessen Attribut. **Konfigurierbare Einstellungen**: * ***Ausgangspins***\*\*: Sie können mehrere Ausgangspins konfigurieren, um die Daten an verschiedene andere Bausteine zu senden. * ***Asset und Attribut***\*\*: Das spezifische *Objekts* und das zugehörige Attribut, dessen Daten abgefragt werden sollen. #### Daten schreiben

**Funktion**: Sendet Daten an ein definiertes *Objekts* und schreibt den angegebenen Wert in ein bestimmtes Attribut. **Konfigurierbare Einstellungen**: * **Eingangspins:** * **Trigger-Pin:** Löst das Schreiben des Werts aus. * **Wert-Pin (optional):** Wenn dieser Pin verwendet wird, wird der Wert aus der verbundenen Quelle übernommen. Andernfalls kann der Wert manuell eingegeben werden. * **Asset, Attribut:** Auswahl des Assets und des zugehörigen Attributs, in das die Daten geschrieben werden sollen. * **Wert:** Wenn kein Wert-Pin verwendet wird, kann hier ein fester Wert definiert werden. #### Alarm

**Funktion**: Löst einen Alarm für ein bestimmtes *Objekts* aus, wenn bestimmte Bedingungen erfüllt sind. **Konfigurierbare Einstellungen**: * ***Asset***\*\*: Das *Objekts* für das der Alarm ausgelöst wird. * ***Priorität***\*\*: Die Dringlichkeit des Alarms (z. B. hoch, mittel, niedrig). * ***Bestätigung***\*\*: Es kann festgelegt werden, ob der Alarm manuell bestätigt werden muss. ### Ticket

**Funktion**: Erstellt ein Ticket zur Verfolgung von Problemen oder Aufgaben, die mit einem *Objekts*. **Konfigurierbare Einstellungen**: * **Asset:** verbunden sind. * **Auswahl des Assets, auf das sich das Ticket bezieht.** Priorität: * **Festlegung der Dringlichkeit des Tickets (z. B. niedrig, mittel, hoch).** Zugewiesene Person: * **Auswahl des Empfängers, der für die Bearbeitung des Tickets verantwortlich ist.** Grund: * **Auswahl des Grundes für das Ticket aus vordefinierten Kategorien.** Titel: * **Beschreibung:** Eingabe eines aussagekräftigen Titels für das Ticket. #### E-Mail senden

**Funktion**: Sendet eine E-Mail-Benachrichtigung an eine bestimmte Person oder Gruppe. **Konfigurierbare Einstellungen**: * ***Betreff***\*\*: Der Betreff der E-Mail. * ***Um***\*\*: Die E-Mail-Adresse(n) des Empfängers. * ***Text***\*\*: Der eigentliche Inhalt der E-Mail. #### Skript

**Funktion:** Die **Skript-Baustein** ermöglicht die Ausführung eines Skripts aus dem [-> *Skript-Engine*](https://docs.buildings.ability.abb/collection/german/plattform/platform-core/script-engine) innerhalb der Regelkette. Die Ausführung wird durch einen booleschen Eingabewert gesteuert. **Konfigurierbare Einstellungen:** * **Skript:** Auswahl des auszuführenden Skripts aus dem *Skript-Engine*. {% hint style="warning" %} WICHTIG: Das Skript muss im Raster auf „Ereignisgesteuert“ gesetzt werden {% endhint %} *** ### Bedingungen #### Bedingung

**Funktion**: Stellt eine Bedingung dar, die geprüft wird, bevor die Regelkette fortfährt, und gibt den booleschen Wert der Prüfung aus. Dies kann numerische Vergleiche zwischen Eingaben durchführen. **Konfigurierbare Einstellungen**: * ***Anzahl der Ein- und Ausgangspins***\*\*: Sie können die Anzahl der Pins konfigurieren, um mehrere Bedingungen zu verknüpfen. * ***Vergleichsoperationen***\*\*: Wählen Sie aus „gleich“, „größer als“, „kleiner als“, „größer oder gleich“ und „kleiner oder gleich“. * ***Wert***\*\*: Wenn nur ein Eingangspin verwendet wird, kann ein fester Wert eingegeben werden, mit dem verglichen wird. Wenn mehrere Eingangspins verwendet werden, werden die Eingaben miteinander verglichen. #### Zeit

**Funktion**: Fügt Verzögerungen in die Regelkette ein, um Ereignisse zeitverzögert auszuführen oder zu annullieren. **Konfigurierbare Einstellungen**: * ***Anzahl der Ein- und Ausgangspins***\*\*: Legen Sie fest, wie viele Verzögerungen eingerichtet werden können. * ***Bedingung***\*\*: TON (Einschaltverzögerung) und TOFF (Ausschaltverzögerung). * ***Verzögerungszeit***\*\*: Die Verzögerung in Sekunden, die angewendet werden soll. #### Zeitplan

**Funktion:** Die **Zeitplan-Baustein** ermöglicht es, eine Regelkette basierend auf einem definierten Zeitplan auszulösen. Innerhalb des festgelegten Zeitfensters gibt der Baustein ein **„wahr“** Signal aus; außerhalb dieses Zeitraums bleibt der Ausgang auf **„falsch“**. **Konfigurierbare Einstellungen:** * **Zeitplantyp:** Auswahl des Zeitplans, z. B. * **Zeitplan** – Steuerung basierend auf einer definierten Zeit. * **Tagesplan** – Steuerung basierend auf bestimmten Wochentagen. * **Beginnzeit:** Startzeit des aktiven Zeitraums (hh:mm) (*nur für Zeitplan*). * **Endzeit:** Endzeit des aktiven Zeitraums (hh:mm) (*nur für Zeitplan*). * **Aktive Tage:** Auswahl der Wochentage, an denen die Regel aktiv sein soll (*nur für Tagesplan*). *** ### Bedienung #### Oder

**Funktion**: Prüft, ob eine der Eingabebedingungen wahr oder falsch ist, und gibt den booleschen Wert dieser Prüfung aus. **Konfigurierbare Einstellungen**: * ***Anzahl der Ein- und Ausgangspins***\*\*: Legen Sie die Anzahl der zu prüfenden Bedingungen fest. #### Und

**Funktion**: Prüft, ob alle Eingabebedingungen wahr sind, und gibt den booleschen Wert dieser Prüfung aus. **Konfigurierbare Einstellungen**: * ***Anzahl der Ein- und Ausgangspins***\*\*: Legen Sie die Anzahl der Bedingungen fest, die gleichzeitig wahr sein müssen. #### Arithmetik

**Funktion**: Führt mathematische Berechnungen mit den Eingabeparametern aus, um einen neuen Wert zu erzeugen. **Konfigurierbare Einstellungen**: * ***Anzahl der Eingangspins***\*\*: Legen Sie fest, wie viele Werte in die Berechnung einbezogen werden. * ***Bedienung***\*\*: Wählen Sie zwischen Addition, Subtraktion, Multiplikation und Division. * ***Wert***\*\*: Ein optionaler fester Wert, der in die Berechnung einbezogen wird. ### Sonstiges #### Hinweis

**Funktion:** Die **Notiz-Baustein** dient als reines Informationselement innerhalb der Regelkette. Er ermöglicht es, Notizen oder Kommentare hinzuzufügen, um die Übersichtlichkeit der Regelkette zu verbessern. **Konfigurierbare Einstellungen:** * **Textfeld:** Geben Sie eine beliebige Notiz oder Beschreibung ein. --- # 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/german/plattform/alarms-rules-and-escalations/rule-chains/configure-rule-chain.md?ask= ``` 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.