---
title: "Erstellen einer Control App"
url: "https://help.emalyticscloud.com/de/article/control-app"
language: "de"
last_updated: "2026-06-05T08:05:29.477Z"
---

# Erstellen einer Control App

### Erstellen einer Control app

Um auf API1.docs zuzugreifen, klicken Sie auf Ihren Benutzernamen in der unteren linken Ecke des Frontends und wählen Sie das Dokument im angezeigten Menü aus.

![](https://cdn-assets.productfruits.com/c81fbd00-a08c-4258-b053-ec72689f8356)

Scrollen Sie zum Abschnitt **Controls** und klicken Sie auf **POST/v2/controls/app:**

![](https://cdn-assets.productfruits.com/f9211680-4811-4345-a32d-de028b9da1c2)

Geben Sie die **project\_id**, **componentinproject\_id**, den **Algorithmus** sowie optional eine **Variation**, einen **Namen** und eine **Beschreibung** ein. Zusätzlich müssen **priority** und **reset\_value** im Request-Body konfiguriert werden. Klicken Sie auf „try“, um die POST-Anfrage zu senden und die App zu erstellen.

Informationen zu den Regelungsalgorithmen und deren Varianten finden Sie in der Dokumentation: [https://docs.emalyticscloud.com/en/products/controls/algorithms/](https://docs.emalyticscloud.com/en/products/controls/algorithms/)

Die **project\_id** und **componentinproject\_id** einer bestimmten Komponente können in der URL gefunden werden, wenn im Abschnitt **Optimierung** des Frontends eine Komponente ausgewählt ist.

![](https://cdn-assets.productfruits.com/f323dd3e-2708-4310-9f2a-6f1f447c7943)

Die erste Zahl in der URL nach „…/optimization/components/…“ ist die **project\_id** (z. B. 2 im obigen Beispiel), die zweite Zahl ist die **componentinproject\_id** (z. B. 9 im obigen Beispiel).

Der **name** der Control-App wird im Frontend im Abschnitt **AI Controls** angezeigt. Daher sollte ein aussagekräftiger Name gewählt werden (z. B. App-Name + Komponentenname: „hero AHU 2“).

Für jede Ausgabe der Control-App müssen **priority** und **reset\_value** angegeben werden. Die meisten Control-Apps haben nur eine Ausgabe, sodass der Request-Body für die Control-App „hero“ wie folgt aussieht:

*SUP\_T\_AIR\_SP* ist die *pin\_alphanumeric\_id* des Sollwert-Pins, auf den die Hero Controls-App die berechneten Werte schreibt (in diesem Fall (in diesem Fall "Zuftlufttemperatur-Sollwert"). Die pin\_aphanumeric\_ids finden Sie in der Dokumentation.

```
{
  "setpoint_writing_params": {
                 "SUP_T_AIR_SP": {
                                   "keep_out_of_service": false,
                                   "priority": 13,
                                    "reset_value": "null"
    }
  }
}
```

Der Parameter **priority** ist die BACnet-Priorität (in der Regel sollte ein Wert über 8 gewählt werden).

Der **reset\_value** wird aktiviert, wenn die Control-App deaktiviert wird oder die Verbindung zum Emalytics Connector verloren geht. **Null** bedeutet, dass der Wert im BACnet-Array mit der gewählten Priorität freigegeben wird. Der Wert mit der nächsthöheren Priorität wird nach dem Senden von Null aktiv. Neben **null** können auch numerische Werte angegeben werden.

Die Konfiguration einer Hero-Control-App ist unten dargestellt:  
![](https://cdn-assets.productfruits.com/4323abe0-4331-4e6d-a8a9-e38f856f6a1f)

Wenn die Antwortnachricht die erfolgreiche Erstellung der App bestätigt, kann diese im nächsten Schritt gestartet werden.

Um die Control-App zu starten, gehen Sie im Frontend zum Abschnitt **KI Regelung - App**, wählen Sie die neu erstellte App aus und klicken Sie auf den Umschaltknopf neben dem App-Namen.

![](https://cdn-assets.productfruits.com/7b7d185b-9589-4bbf-979a-4b848200e014)

Wenn der Umschaltknopf nicht grün wird, laden Sie die Seite bitte neu.

Die Control-Apps können auch über den Umschaltknopf deaktiviert werden.

### Löschen einer Control app

Um eine bestimmte Control-App zu löschen, kann **DELETE/v2/controls/app** verwendet werden. Die App muss vor dem Löschen im Abschnitt **AI Controls** ausgeschaltet sein:

![](https://cdn-assets.productfruits.com/15be17f8-8743-4289-8382-d6f606ad99b9)

Die **project\_id** kann in der URL gefunden werden (siehe Abschnitt oben). Um die **controls\_app\_id** zu erhalten, verwenden Sie den API-Endpunkt **GET/v2/controls/apps**. Dieser GET-Endpunkt listet alle Apps eines Projekts mit ihren IDs, Metadaten und Status auf.