> 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).

# Skript-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 diese Zähler zu festgelegten Zeiten automatisch zurückgesetzt werden.

#### 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 ist die Integration von Machine-Learning-Modellen. Skripte können verwendet werden, um auf Grundlage historischer Daten Vorhersagen 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 durchsuchen 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 sich die Daten innerhalb bestimmter Grenzen befinden. 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="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2F7tbyg5YxlUJNfDNaeG82%2FGroup%20669.png?alt=media&amp;token=38feba09-32f0-469c-8fe8-a0ebc352a75e" 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 für die High-Level-Rolle sichtbar. Siehe [Rollen](/collection/german/verpflichtende-basis/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 haben Sie folgende Möglichkeiten:

<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>Suchen</td><td>Öffnet die Seitenleiste „Suchen“. Dort können Sie gezielt nach einzelnen Skripten suchen</td></tr><tr><td><strong>[E]</strong></td><td>Neues Skript erstellen</td><td>Klicken, um ein neues Skript zu erstellen</td></tr><tr><td><strong>[F]</strong></td><td>Skript pausieren/aktivieren</td><td>Klicken, 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>Wiederholen</td><td>Zeigt das <a href="/collection/german/plattform/platform-core/script-engine/configure-scripts.md#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 als Nächstes 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, um das Skript zu bearbeiten. Ruft das Menü auf <a href="/collection/german/plattform/platform-core/script-engine/configure-scripts.md">↗ Skript konfigurieren.</a></td></tr><tr><td><strong>[R]</strong></td><td>Fehler</td><td>Zeigt an, dass beim Skript ein Fehler 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. Geben Sie im Feld **\[T]**, dem Skript einen Namen.\
   ◈ Dieser Name wird später in Feld **\[H]**
4. Geben Sie im Feld **\[U]**, wählen Sie aus, 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.