> 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/verpflichtende-basis/platform-core/connect-hub/data-processing-function-formats.md).

# Datenverarbeitung (Funktion/Formate)

Eingehende Daten müssen zugeordnet werden, bevor BuildingPro Suites sie dem richtigen Asset und Attribut speichern kann. Dies geschieht mit **Formaten** und, falls nötig, **Funktionen**.

## Wofür Formate gedacht sind

Ein **Format** definiert, wie eingehende Payload-Daten in BuildingPro Suites den Asset-Daten zugewiesen werden.

Verwenden Sie ein Format, um:

* Payload-Werte bestimmten Asset-Attributen zuzuordnen
* zu identifizieren, welches Asset die Daten erhalten soll
* festzulegen, ob die Kennung aus dem Payload oder dem Topic stammt
* festzulegen, wie der Zeitstempel erkannt wird
* Pfadangaben wie **JSONPath** um Werte aus strukturierten Payloads auszuwählen
* verwenden Sie **MQTT-Platzhalter** wenn die Asset-Kennung Teil des Topics ist

Ein Format beantwortet vereinfacht gesagt diese Frage:

> **Welcher eingehende Wert gehört zu welchem Asset-Attribut?**

{% hint style="success" %}
Erstellen Sie nach Möglichkeit neue Formate beim Konfigurieren einer Verbindung. Dies ist der empfohlene Ablauf.
{% endhint %}

{% hint style="warning" %}
Verwenden Sie die direkt in der Dokumentation verlinkten Bereiche **Formate** Menü hauptsächlich zum Anzeigen und Bearbeiten vorhandener Formate.
{% endhint %}

## Wofür Funktionen gedacht sind

Ein **Funktion** wird verwendet, wenn ein Format allein nicht ausreicht.

Verwenden Sie eine Funktion, um:

* neue Werte aus eingehenden Daten zu berechnen
* Werte vor dem Speichern zu konvertieren oder zu normalisieren
* mehrere Payload-Felder zu einer Kennung zu kombinieren
* eingehende Daten für die Zuordnung neu zu strukturieren
* benutzerdefinierte Logik anzuwenden, die sich mit der Formatkonfiguration allein nicht ausdrücken lässt

Einfach ausgedrückt beantwortet eine Funktion diese Frage:

> **Wie sollen die eingehenden Daten vor der Zuordnung transformiert werden?**

## Wie Formate und Funktionen zusammenarbeiten

Formate und Funktionen werden oft gemeinsam verwendet:

1. Eine Verbindung empfängt Daten.
2. Das Format identifiziert das Ziel-Asset und ordnet Payload-Felder Attributen zu.
3. Eine angehängte Funktion kann die Daten bei Bedarf transformieren oder anreichern.

Dies ist besonders nützlich, wenn:

* der Payload keine direkt verwendbare Kennung enthält
* Werte kombiniert, bereinigt oder konvertiert werden müssen
* das relevante Asset aus Topic-Teilen oder verschachtelten JSON-Feldern abgeleitet werden muss

## Verwandte Seiten

* [Ein Encoder/Decoder-Format konfigurieren](/collection/german/verpflichtende-basis/platform-core/connect-hub/data-processing-function-formats/configure-a-format.md)
* [Funktionen](/collection/german/verpflichtende-basis/platform-core/connect-hub/data-processing-function-formats/functions.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/verpflichtende-basis/platform-core/connect-hub/data-processing-function-formats.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.