# Eine Subscription konfigurieren

{% hint style="success" %}
**Voraussetzung** \
Sie haben eine neue Subscription erstellt, wie in [↗ Broker-Details -> Neue Subscription erstellen](https://docs.buildings.ability.abb/collection/german-14.2-freezed/connectivity-as-a-service/gerate-mit-abb-buildingpro-verbinden/client-konfigurieren#neue-subscription-erstellen) erklärt.
{% endhint %}

## Überblick

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9TfB6vpqxjkjEolYGMII/DocsConnection%20Neue_Subscription.png" alt=""><figcaption><p>Abb. 1 – Eine neue Subscription erstellen</p></figcaption></figure></div>

<table><thead><tr><th width="84.33333333333331">Symbol</th><th>Beschreibung</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Topic-Vorschau</td><td>In diesem Abschnitt sehen Sie eine Vorschau der eingehenden Daten</td></tr><tr><td><strong>[A1]</strong></td><td>Eingabe der Topic-Vorschau</td><td>Geben Sie hier ein MQTT Topic ein. Dessen Daten erscheinen in der Vorschau. <br><br>Wichtig: In diesem Feld geben Sie <strong>NICHT</strong> das Topic ein, zu dem Sie eine Subscription erstellen wollen – dies geschieht in <strong>[C]</strong></td></tr><tr><td><strong>[B]</strong></td><td>Name</td><td>Geben Sie der Subscription einen Namen. Unter diesem Namen wird die Subscription in der Subscription-Liste (in den Broker-Details) angezeigt</td></tr><tr><td><strong>[C]</strong></td><td>Topic</td><td>Geben Sie hier das MQTT Topic ein, zu dem Sie eine Subscription erstellen wollen.</td></tr><tr><td><strong>[D]</strong></td><td>QoS (Quality of Service)</td><td>Wählen Sie einen Wert. Der QoS gibt das Level der Nachrichtenzustellung zwischen MQTT-Broker und den verbundenen Clients an</td></tr><tr><td><strong>[E]</strong></td><td>Ein oder mehrere Formate</td><td>Wählen Sie aus, ob auf die Daten ein einziges oder mehrere Formate angewandt werden sollen. -<a href="#ein-oder-mehrere-formate">> Ein oder mehrere Formate</a></td></tr><tr><td><strong>[F]</strong></td><td>Format erstellen</td><td>Wenn Sie ein neues Format definieren wollen, klicken Sie hier. Es öffnet sich das Fenster <a href="../ein-format-konfigurieren">↗ Format </a>konfigurieren</td></tr><tr><td><strong>[G]</strong></td><td>Bestehendes Format auswählen</td><td>Alternativ zu <strong>[F]</strong> können Sie auch ein bestehendes Format auswählen</td></tr><tr><td><strong>[H]</strong></td><td>Speichern</td><td>Klicken Sie, um die Subscription zu speichern</td></tr></tbody></table>

## Ein oder mehrere Formate

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/MiDgK2HgVBqkkp5ffRzj/image.png" alt=""><figcaption></figcaption></figure>

Wählen Sie, ob auf die eingehenden Daten ein einziges Format oder mehrere Formate angewendet werden sollen.

◈ Wenn Sie *Single* auswählen, wird für alle eingehenden Daten das gleiche Format verwendet.

◈ Wenn Sie *Multiple* auswählen, können Sie die Verarbeitung der Daten differenzieren – je nach *Topic*. Das bedeutet: Innerhalb einer Subscription können verschiedene Topics mit unterschiedlichen Formaten verarbeitet werden. Dafür verwenden Sie **Pattern**, um festzulegen, welche Daten zu welchem Format gehören.

**Beispiel:**

Sie abonnieren das Topic `levels/+`.\
Es gibt zwei tatsächliche Topics:

* `levels/level1` → diese Daten sollen mit **Decoder A** verarbeitet werden
* `levels/level2` → diese Daten sollen mit **Decoder B** verarbeitet werden

Dann tragen Sie im Multiple-Modus zwei Paare ein:

| Pattern         | Format    |
| --------------- | --------- |
| `levels/level1` | Decoder A |
| `levels/level2` | Decoder B |

▷ So werden die Daten je nach Topic automatisch mit dem passenden Format dekodiert.<br>