# GP Joule

### GP Joule Benutzerhandbuch

#### Einleitung

> Die GP Joule App bietet Integration und Synchronisierung zwischen BuildingPro Suites und GP Joule-Diensten.

#### Übersicht

Dieses Handbuch enthält Anweisungen zum Konfigurieren, Installieren und Verwenden der GP Joule App zur Verwaltung von Ressourcen und zur Synchronisierung von Daten zwischen BuildingPro Suites und GP Joule-Diensten.

#### Installation

Installieren Sie die GP Joule App über den BuildingPro Suites App Store.

#### Konfiguration

Die GP Joule App erfordert eine Konfiguration über die BuildingPro Suites-Einstellungen. Im Folgenden finden Sie die allgemeinen Schritte und Details, die erforderlich sind, um die App effektiv zu konfigurieren.

#### Registrierung der App beim GP Joule-Dienst

Erstellen Sie im GP Joule-Dienst Anmeldedaten, um die GP Joule-Dienste von BuildingPro Suites aus zu verbinden. Alle erforderlichen Anmeldedaten sind im Konfigurationsabschnitt unten aufgeführt.

Bitte wenden Sie sich an GP Joule, um die URL für den API-Zugriff und Ihren Zugriffsschlüssel zu erhalten.

#### Konfiguration der GP Joule App

Konfigurationen können in BuildingPro Suites unter `Apps > GP Joule > Einstellungen`, wodurch die App- [Allgemeine Benutzeroberfläche](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps)öffnet. Hier können Sie den entsprechenden Endpunkt mit der POST-Methode verwenden. Jede Konfiguration erfordert die folgenden Daten:

| Attribut          | Beschreibung                                                        |
| ----------------- | ------------------------------------------------------------------- |
| `rootUrl`         | URL der GP Joule-API-Dienste.                                       |
| `apiKey`          | Vom GP Joule-Dienst erhaltene Client-Geheimnisse.                   |
| `assetFilter`     | Filterung von Assets während der kontinuierlichen Asset-Erstellung. |
| `enable`          | Schalter zum Aktivieren oder Deaktivieren dieser Konfiguration.     |
| `refreshInterval` | Intervall in Sekunden für die Datensynchronisierung.                |
| `requestTimeout`  | Zeitüberschreitung für API-Anfragen in Sekunden.                    |
| `tenantIDs`       | Liste der BuildingPro Suites Mandanten-IDs für die Datenerfassung.  |

Beispiel für eine Konfigurations-JSON:

```json
{
  "rootUrl": "[http://gpjoule.api.url/](http://gpjoule.api.url/)",
  "apiKey": "s3cr3t",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "tenantIDs": [
    "10"
  ]
}
```

### Kontinuierliche Asset-Erstellung

Sobald die App konfiguriert ist, startet sie die kontinuierliche Asset-Erstellung (CAC). Erkannte Ressourcen werden automatisch als Assets in BuildingPro Suites erstellt, und Benutzer werden über das Benachrichtigungssystem von BuildingPro Suites informiert.

Die GP Joule-Infrastruktur wird über das Ladestations-Asset verwaltet, das alle Ladestationen nach ihrem Cluster-Namen gruppiert. Jede Ladestation kann eine oder mehrere Verbindungen haben, wobei jede über eigene Ladeeigenschaften verfügt.

Zusätzlich wird für jede Verbindung ein Session-Log-Asset erstellt, das historische Aufzeichnungen aller Ladesitzungen bereitstellt.

### Zusätzliche Funktionen

#### Dashboard-Vorlagen

Die App bietet ein vordefiniertes Dashboard, das die wichtigsten Informationen übersichtlich darstellt. Sie können ein solches Dashboard unter erstellen `Dashboards > Dashboard kopieren > Aus App > GP Joule`.