# Ein Encoder-/Decoder-Format konfigurieren

Verwendung eines *Formats*, eingehende Daten in BuildingPro Suites den einzelnen Attributen eines Assets eines beliebigen Assets zugewiesen. Einfach gesagt: Formate weisen 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

Wenn Sie eine Verbindung konfigurieren, haben Sie die Möglichkeit, ein bestehendes Format auszuwählen oder ein neues Format zu erstellen. Der entsprechende Menüpunkt ist in der Dokumentation der jeweiligen Verbindungsmethode 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 bestehende Formate bearbeiten und neue Formate erstellen.

{% hint style="warning" %}
Hinweis: Verwenden Sie diese Option nur, um bestehende Formate zu bearbeiten. Wir empfehlen **NICHT** vorerst keine neuen 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 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 <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>Topic</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 übermittelte 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. Die Optionen sind: - GAI: Der GAI wird verwendet, um das Asset zu bestimmen, dem die Daten zugeordnet werden - Extern: Statt des GAI wird die „Verknüpfte 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>Speicherort des Identifiers</td><td><p>Hier wählen Sie aus, woher der Identifier genommen wird. Die Optionen sind:</p><ul><li>Payload: Der Identifier befindet sich im Payload</li><li>Topic: Der Identifier befindet sich im Topic</li></ul></td></tr><tr><td><strong>[C3]</strong></td><td>Bezeichner</td><td>Geben Sie hier den Identifier ein. Wenn der Identifier das Topic sein soll, können Sie einfach „<strong>#"</strong> in den Pfad eingeben</td></tr><tr><td><strong>[C4]</strong></td><td>Zeitstempel-Auswahl</td><td>Wählen Sie aus, wie der Zeitstempel erkannt werden soll. Die 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 den Zeitstempel-Eintrag</td><td>Wenn Sie <em>Feld</em> in <strong>[C4]</strong>: gewählt haben: Ziehen Sie den Zeitstempel einfach <strong>[B5]</strong> in das Feld</td></tr><tr><td><strong>[C6]</strong></td><td>Funktion anhängen</td><td>klicken, 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 gesetzt werden.</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 gesetzt werden.</td></tr><tr><td><strong>[E]</strong></td><td>Ruft weitere Optionen für das ausgewählte Asset auf.</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 in **\[A1]**
2. In **\[A2]**&#x65;inen Namen, wählen Sie einen Asset-Typ

   ▷ Die zum jeweiligen Format gehörenden Attribute erscheinen in **\[D]**
3. In 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 bestehendes Format bearbeiten

Gehen Sie wie folgt vor, um ein bereits bestehendes 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 die 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]** öffnet sich. Die Payload-Vorschau enthält einen Beispiel-Payload. Der Inhalt der Payload-Vorschau wird im Feld **\[B3]** im nächsten Schritt angezeigt.
4. Fügen Sie einen Payload in die Payload-Vorschau ein.
5. Klicken Sie auf **\[J]**

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