> 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 Skripte 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 zu gewährleisten. 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 bestimmen und ihn hervorzuheben oder weiterzuverarbeiten.

#### Modelle für maschinelles Lernen und Vorhersagen

Ein fortgeschrittenes Anwendungsszenario ist die Integration von Modellen des maschinellen Lernens. 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.

#### Verarbeitung von Anhängen

Skripte können so programmiert werden, dass sie Anhänge automatisch scannen, wenn sie hochgeladen werden, 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. Sind die Daten plausibel, wird der Wert auf 0 gesetzt, andernfalls auf 1.

## Zulässige Sprachen

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

## Script-Übersicht öffnen

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

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

   ▷Die Script-Ü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 hochrangige Rollen 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 Script-Übersicht. Systemskripte sind daran zu erkennen, dass die Bearbeitungsoption **\[Q]** ausgegraut und nicht verfügbar ist.
{% endhint %}

### Details

In der Script Engine haben Sie die folgenden 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 „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 beim Erstellen 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 beim Erstellen 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 aufweist</td></tr><tr><td><strong>[L]</strong></td><td>Wiederholen</td><td>Zeigt den <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. Öffnet das Menü <a href="/pages/c30f4f0194926489c5009718c0ba27fd857c536e">↗ 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 Script-Übersicht wie in [↗ Script-Übersicht öffnen](#open-script-overview)
2. Klicken Sie auf **\[E]**

   ▷ Das Fenster **\[S]** öffnet sich
3. Im Feld **\[T]**, geben Sie dem Skript einen Namen.

   ◈ Dieser Name wird später im Feld **\[H]**
4. Im Feld **\[U]**, wählen Sie, ob das Skript in Python oder SQL geschrieben ist
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.