# GP Joule

Translate into German:

## GP Joule User Manual

#### Introduction

> The GP Joule app offers integration and synchronization between Eliona and GP Joule services.

### Overview

This manual provides instructions for configuring, installing, and using the GP Joule app to manage resources and synchronize data between Eliona and GP Joule services.

### Installation

Install the GP Joule app via the Eliona App Store.

### Configuration

The GP Joule app requires configuration via the Eliona settings. Below are the general steps and details required to configure the app effectively.

#### Registration of the app in the GP Joule service

Create credentials in the GP Joule service to connect the GP Joule services from Eliona. All required credentials are listed below in the configuration section.

Please contact GP Joule to obtain the URL for API access and your access key.

#### Configuration of the GP Joule app

Configurations can be created in Eliona under `Apps > GP Joule > Settings` to be created, which enables the [Generic user interface](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps) of the app. Here you can use the corresponding endpoint with the POST method. Each configuration requires the following data:

| Attribute         | Description                                           |
| ----------------- | ----------------------------------------------------- |
| `rootUrl`         | URL of the GP Joule API services.                     |
| `apiKey`          | Client secrets obtained from the GP Joule service.    |
| `assetFilter`     | Filtering of assets during continuous asset creation. |
| `enable`          | Flag to enable or disable this configuration.         |
| `refreshInterval` | Interval in seconds for data synchronization.         |
| `requestTimeout`  | Timeout for API requests in seconds.                  |
| `projectIDs`      | List of Eliona project IDs for data collection.       |

Example configuration JSON:

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

### Continuous asset creation

Once configured, the app starts Continuous Asset Creation (CAC). Discovered resources are automatically created as assets in Eliona, and users are informed via Eliona's notification system.

The GP Joule infrastructure is managed via the charging point asset, which groups all charging points by their cluster name. Each charging point can have one or more connectors, each with its own charging properties.

In addition, a session log asset is created for each connector, providing historical records of all charging sessions.

### Additional features

#### Dashboard templates

The app provides a predefined dashboard that clearly displays the most important information. You can create such a dashboard under `Dashboards > Copy dashboard > From app > GP Joule` .