> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/plattform/platform-core/script-engine.md).

# Script Engine

Die Script Engine bietet Ihnen die Möglichkeit, Daten in BuildingPro Suites mithilfe von Python- und SQL-Skripten zu bearbeiten.

Das Besondere an Skripten ist, dass sie wiederholt und in regelmäßigen Abständen auf die Daten angewendet werden.

{% hint style="info" %}
Für einfache Datenmanipulationen, z. B. das Hinzufügen von Werten, kann der ↗ Rechner verwendet werden.
{% endhint %}

## Anwendungsszenarien

Hier sind einige typische und fortgeschrittene Anwendungsfälle, in denen Skripte effektiv eingesetzt werden können:

#### Zähler auswerten und zurücksetzen

Zähler, wie z. B. Personenzähler, müssen regelmäßig zurückgesetzt werden, um genaue Werte sicherzustellen. Skripte können so programmiert werden, dass sie diese Zähler zu festgelegten Zeiten automatisch zurücksetzen.

#### Maximalwerte ermitteln

Skripte können verwendet werden, um den höchsten Wert aus einer Reihe von Werten zu ermitteln und ihn hervorzuheben oder weiterzuverarbeiten.

#### Machine-Learning-Modelle und Vorhersagen

Ein fortgeschrittenes Anwendungsszenario umfasst die Integration von Machine-Learning-Modellen. Skripte können verwendet werden, um Vorhersagen auf Basis historischer Daten zu treffen, Optimierungen durchzuführen oder Zusammenhänge zwischen verschiedenen Datensätzen zu erkennen.

#### Anhänge verarbeiten

Skripte können so programmiert werden, dass sie hochgeladene Anhänge automatisch scannen und die extrahierten Daten direkt in das entsprechende Asset schreiben.

#### Plausibilitätsprüfungen

Eine weitere Anwendung ist die Plausibilitätsprüfung von Daten. Ein Skript kann prüfen, ob die Daten innerhalb bestimmter Grenzen liegen. Wenn die Daten plausibel sind, wird der Wert auf 0 gesetzt, andernfalls auf 1.

## Akzeptierte Sprachen

Skripte können in *Python* oder *SQL*.

## Skriptübersicht öffnen

<figure><img src="/files/427fa52008c5dc9775e8df99c09730c0c1f059f0" alt=""><figcaption></figcaption></figure>

1. Klicken Sie auf **Engineering** **\[A]**
2. Klicken Sie auf **Script Engine** **\[B]**

   ▷Die Skriptübersicht öffnet sich

{% hint style="info" %}
BuildingPro Suites enthält integrierte Skripte, sogenannte *Systemskripte*.

Diese Skripte sind nur für Benutzer mit den entsprechenden Berechtigungen auf hoher Rollenebene sichtbar. Siehe [Rollen](/collection/german/pflichtbasis/platform-core/workspace-and-identity/roles/tenant-roles.md).

Für alle anderen Benutzer erscheinen diese Systemskripte nicht in der Skriptübersicht. Systemskripte sind daran zu erkennen, dass die Bearbeitungsoption **\[Q]** ausgegraut und nicht verfügbar ist.
{% endhint %}

### Details

In der Script Engine stehen Ihnen die folgenden Optionen zur Verfügung:

<table data-full-width="true"><thead><tr><th width="67.20001220703125">Element</th><th width="199.5999755859375">Titel</th><th>Details</th></tr></thead><tbody><tr><td><strong>[C]</strong></td><td>Bereich „Skripte“</td><td>Zeigt eine Übersicht aller bereits erstellten Skripte an</td></tr><tr><td><strong>[D]</strong></td><td>Suche</td><td>Öffnet die Seitenleiste „Suche“. Dort können Sie gezielt nach einzelnen Skripten suchen</td></tr><tr><td><strong>[E]</strong></td><td>Neues Skript erstellen</td><td>Klicken Sie, um ein neues Skript zu erstellen</td></tr><tr><td><strong>[F]</strong></td><td>Skript pausieren/aktivieren</td><td>Klicken Sie, um ein laufendes Skript zu pausieren oder ein pausiertes Skript wieder zu aktivieren</td></tr><tr><td><strong>[G]</strong></td><td>Skriptstatus</td><td>Zeigt an, ob ein Skript aktiviert („Aktiv“) oder pausiert („Inaktiv“) ist</td></tr><tr><td><strong>[H]</strong></td><td>Name</td><td>Zeigt den Namen des Skripts an. Der Name des Skripts wird vom Benutzer bei der Erstellung des Skripts vergeben. Der Name kann nachträglich geändert werden.</td></tr><tr><td><strong>[I]</strong></td><td>Zeigt die Beschreibung des Skripts an.</td><td>Die Beschreibung des Skripts wird vom Benutzer bei der Erstellung des Skripts vergeben. Der Name kann nachträglich geändert werden.</td></tr><tr><td><strong>[J]</strong></td><td>Typ</td><td>Zeigt an, ob das Skript in SQL oder Python erstellt wurde.</td></tr><tr><td><strong>[K]</strong></td><td>Fehler</td><td>Zeigt an, ob das Skript Fehler enthält</td></tr><tr><td><strong>[L]</strong></td><td>Wiederholung</td><td>Zeigt das <a href="/pages/c30f4f0194926489c5009718c0ba27fd857c536e#raster">↗ Raster</a> an, das für dieses Skript ausgewählt wurde.</td></tr><tr><td><strong>[M]</strong></td><td>Letzter Lauf</td><td>Zeigt an, wann das Skript zuletzt ausgeführt wurde.</td></tr><tr><td><strong>[N]</strong></td><td>Nächster Lauf</td><td>Zeigt an, wann das Skript das nächste Mal ausgeführt wird.</td></tr><tr><td><strong>[O]</strong></td><td>Dauer</td><td>Zeigt an, wie lange der letzte Lauf gedauert hat.</td></tr><tr><td><strong>[P]</strong></td><td>Löschen</td><td>Löscht das ausgewählte Skript.</td></tr><tr><td><strong>[Q]</strong></td><td>Bearbeiten</td><td>Klicken Sie, um das Skript zu bearbeiten. Ruft das Menü auf <a href="/pages/c30f4f0194926489c5009718c0ba27fd857c536e">↗ Skript konfigurieren.</a></td></tr><tr><td><strong>[R]</strong></td><td>Fehler</td><td>Zeigt an, dass ein Fehler mit dem Skript vorliegt.</td></tr></tbody></table>

## Ein neues Skript erstellen

1. Öffnen Sie die Skriptübersicht wie in [↗ Skriptübersicht öffnen](#open-script-overview)
2. Klicken Sie auf **\[E]**

   ▷ Das Fenster **\[S]** öffnet sich
3. Im Feld **\[T]**&#x61;ngegeben, und geben Sie dem Skript einen Namen.

   ◈ Dieser Name wird später im Feld angezeigt **\[H]**
4. Im Feld **\[U]**&#x75;nd wählen Sie, ob das Skript in Python oder SQL geschrieben wird
5. Klicken Sie auf **\[V]** um das Skript zu erstellen

   ▷Das Menü „Skript konfigurieren“ öffnet sich
6. Fahren Sie fort wie in Kapitel [↗ Skripte konfigurieren](/collection/german/plattform/platform-core/script-engine/configure-scripts.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/german/plattform/platform-core/script-engine.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.