# Ein Encoder-/Decoder-Format konfigurieren

Verwendung eines *Formats*werden eingehende Daten in BuildingPro Suites den einzelnen Attributen eines Assets beliebiger Art zugewiesen. Einfach ausgedrückt: Formate ordnen eingehende Daten einzelnen BuildingPro-Suites-Assets zu.

## Ein Format erstellen

Es gibt zwei Möglichkeiten, ein Format zu erstellen:

1. Beim Konfigurieren einer Verbindung
2. Über das Menü „Format“

### Option 1 - Beim Konfigurieren einer Verbindung

Beim Konfigurieren einer Verbindung haben Sie die Möglichkeit, ein vorhandenes Format auszuwählen oder ein neues Format zu erstellen. Der entsprechende Menüpunkt ist in der Dokumentation der jeweiligen Verbindungsart vermerkt.

{% hint style="success" %}
Dies ist die empfohlene Option, um ein neues Format zu erstellen.
{% endhint %}

### Option 2 - Im Menü „Format“

Im Menü „Formate“ sehen Sie eine Übersicht aller vorhandenen Formate. Dort können Sie vorhandene Formate bearbeiten und neue Formate erstellen.

{% hint style="warning" %}
Hinweis: Verwenden Sie diese Option nur zum Bearbeiten vorhandener Formate. Wir empfehlen **NICHT** vorerst, neue Formate auf diese Weise zu erstellen.
{% endhint %}

## Format konfigurieren

### Übersicht

<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%2F1HizkUAv1Mq9Jb0DzmJ6%2FDocsVerbindungen%20-%20Formate%201.png?alt=media&#x26;token=58718296-7922-41fc-8dc6-e73b1de74d98" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="70.93333943684894">Element</th><th width="213">Titel</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Abschnitt „Konfiguration“</td><td>In diesem Abschnitt werden die Details zum Format konfiguriert</td></tr><tr><td><strong>[A1]</strong></td><td>Name</td><td>Geben Sie dem Format in diesem Feld einen Namen</td></tr><tr><td><strong>[A2]</strong></td><td>Asset-Typ</td><td>Wählen Sie aus, für welchen Asset-Typ dieses Format gilt. Diese Auswahl beeinflusst, welche Werte im Abschnitt angezeigt werden <strong>[D]</strong></td></tr><tr><td><strong>[B]</strong></td><td>Abschnitt „Payload“</td><td>In diesem Abschnitt wird eine Vorschau der eingehenden Daten angezeigt.</td></tr><tr><td><strong>[B1]</strong></td><td>Code-Vorschau</td><td>Klicken Sie hier, um die Code-Vorschau zu öffnen. Die Code-Vorschau zeigt die Informationen aus Abschnitt <strong>[D]</strong> in Form eines Payloads an.</td></tr><tr><td><strong>[B2]</strong></td><td>Thema</td><td>Das Topic</td></tr><tr><td><strong>[B3]</strong></td><td>Topic-Pfad</td><td>Der Pfad zum jeweiligen Payload-Eintrag</td></tr><tr><td><strong>[B4]</strong></td><td>Payload</td><td>Dies ist der übertragene Payload. Ziehen Sie Werte aus dem Payload auf die entsprechenden Pfade <strong>[D2]</strong>. Wenn Sie ein Format über Option 1 erstellen, erscheint der Payload in diesem Bereich. Wenn ein Format anschließend bearbeitet wird, erscheint hier der Inhalt der ↗ Payload-Vorschau</td></tr><tr><td><strong>[B5]</strong></td><td>Payload-Eintrag</td><td>Eine einzelne Komponente des Payloads. Sie können diese Komponenten per Drag-and-drop auf die Pfade in den Attributen ziehen <strong>[D2]</strong></td></tr><tr><td><strong>[C]</strong></td><td>Abschnitt „Pfadkonfiguration“</td><td>In diesem Abschnitt legen Sie fest, welchem Asset die eingehenden Daten zugeordnet werden.</td></tr><tr><td><strong>[C1]</strong></td><td>Bezeichner</td><td>Hier wählen Sie das einzelne Asset aus, dem die eingehenden Daten zugeordnet werden. Optionen sind: - GAI: Die GAI wird verwendet, um das Asset zu bestimmen, dem die Daten zugeordnet werden - Extern: Statt der GAI wird die „zugehörige ID“ eines Assets verwendet. <a href="../../../../assets/configure-an-asset#available-settings">↗ <em>Siehe <strong>[M1]</strong> in Asset -> Asset konfigurieren -> Verfügbare Einstellungen</em></a></td></tr><tr><td><strong>[C2]</strong></td><td>Position des Bezeichners</td><td><p>Hier wählen Sie aus, woher der Bezeichner genommen wird. Optionen sind:</p><ul><li>Payload: Der Bezeichner befindet sich im Payload</li><li>Topic: Der Bezeichner befindet sich im Topic</li></ul></td></tr><tr><td><strong>[C3]</strong></td><td>Bezeichner</td><td>Geben Sie hier den Bezeichner ein. Wenn der Bezeichner das Topic sein soll, können Sie einfach „<strong>#"</strong> im Pfad eingeben</td></tr><tr><td><strong>[C4]</strong></td><td>Zeitstempel-Auswahl</td><td>Wählen Sie, wie der Zeitstempel erkannt werden soll. Optionen sind: - Auto: Der Zeitstempel wird automatisch erkannt - Feld: Ziehen Sie einen Payload-Eintrag in das Feld <strong>[C5]</strong></td></tr><tr><td><strong>[C5]</strong></td><td>Feld für Zeitstempel-Eingabe</td><td>Wenn Sie <em>Feld</em> in <strong>[C4]</strong>ausgewählt haben: Ziehen Sie einfach den Zeitstempel <strong>[B5]</strong> in das Feld</td></tr><tr><td><strong>[C6]</strong></td><td>Anhängefunktion</td><td>klicken Sie, um eine JavaScript-Funktion anzuhängen</td></tr><tr><td><strong>[C7]</strong></td><td>Alle Funktionen</td><td>Alle vorhandenen Funktionen anzeigen</td></tr><tr><td><strong>[D]</strong></td><td>Eingang</td><td>In diesem Abschnitt werden die Payload-Einträge den einzelnen Attributen zugewiesen.</td></tr><tr><td><strong>[D1]</strong></td><td>Attribut</td><td>Dies ist eines der Attribute, die für diesen Asset-Typ festgelegt sind.</td></tr><tr><td><strong>[D2]</strong></td><td>Pfad zum Payload-Eintrag</td><td>Dies ist eines der Attribute, die für diesen Asset-Typ festgelegt sind.</td></tr><tr><td><strong>[E]</strong></td><td>Speichern</td><td>Klicken Sie hier, um die Einstellungen zu speichern</td></tr></tbody></table>

### Vorgehensweise

{% file src="<https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FdL7oTcY525dPUDQNoPHT%2FFormat%20Drag%20and%20Drop.mp4?alt=media&token=263891d3-95a0-417a-8ea3-5810a75d815e>" %}

1. Geben Sie dem Format einen Namen in **\[A1]**
2. In **\[A2]**&#x77;ählen Sie einen Asset-Typ

   ▷ Die zum jeweiligen Format gehörenden Attribute erscheinen in **\[D]**
3. Im Abschnitt **\[C]**&#x6C;egen Sie fest, welchem einzelnen Asset die Daten zugeordnet werden sollen.
4. Ziehen Sie die einzelnen Payload-Einträge **\[B2]** per Drag-and-drop in die jeweiligen Felder \[D2]
5. Wiederholen Sie Schritt 4, bis alle gewünschten Attribute den jeweiligen Payload-Einträgen zugewiesen wurden.

Sie weisen einzelne Einträge aus dem Payload per Drag-and-drop zu.

## Ein vorhandenes Format bearbeiten

Gehen Sie wie folgt vor, um ein bereits vorhandenes Format nachträglich zu bearbeiten.

<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%2FX5qJkIpqnagiA5kGaalu%2FDocsVerbindungen%20-%20Formate%202.png?alt=media&#x26;token=a244d6be-404f-4663-ab1a-3309357ada29" alt=""><figcaption><p>Abb. 2 - Unten in der Payload-Vorschau</p></figcaption></figure></div>

1. Klicken Sie auf **\[F]**
2. Klicken Sie auf **\[G]**

   ▷ Eine Liste aller Formate erscheint
3. Für das Format, das Sie bearbeiten möchten: Klicken Sie auf **\[H]**

   ▷ Die Payload-Vorschau **\[I]** wird geöffnet. Die Payload-Vorschau enthält einen Beispiel-Payload. Der Inhalt der Payload-Vorschau wird im Feld angezeigt **\[B3]** im nächsten Schritt.
4. Fügen Sie einen Payload in die Payload-Vorschau ein.
5. Klicken Sie auf **\[J]**

   ▷ Die Formatkonfiguration wird geöffnet
6. Nehmen Sie die Einstellungen wie in [↗ Vorgehen](#procedure)


---

# Agent Instructions: 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:

```
GET https://docs.buildings.ability.abb/collection/german/pflichtbasis/platform-core/connect-hub/data-processing-function-formats/configure-a-format.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.