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

#### Maximalwerte bestimmen

Skripte können verwendet werden, um aus einer Reihe von Werten den höchsten Wert 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 auf Basis 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. Wenn die Daten plausibel sind, wird der Wert auf 0 gesetzt, andernfalls auf 1.

## Akzeptierte Sprachen

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

## Script-Übersicht öffnen

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FQcAZZtdUQJNbTh1IIZPH%2FDocs%20ScriptEngine%201.png?alt=media&#x26;token=5e6c06de-0916-4b6d-a4d8-62db66961b86" alt=""><figcaption></figcaption></figure></div>

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

   ▷Die Script-Übersicht öffnet sich

{% hint style="info" %}
BuildingPro Suites wird mit integrierten Skripten geliefert, sogenannten *Systemskripten*.

Diese Skripte sind nur sichtbar für [Systemeigentümer](https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/workspace-and-identity/roles#system-roles).

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 Optionen:

<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, 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 beim Erstellen des Skripts vom Benutzer vergeben. Der Name kann anschließend 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 beim Erstellen des Skripts vom Benutzer vergeben. Der Name kann anschließend 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="configure-scripts#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, um das Skript zu bearbeiten. Ruft das Menü <a href="script-engine/configure-scripts">↗ 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 beschrieben 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 angezeigt **\[H]**
4. 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 beschrieben im Kapitel [↗ Skripte konfigurieren](https://docs.buildings.ability.abb/collection/german/plattform/platform-core/script-engine/configure-scripts)