> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/manual/bedienung-der-plattform/hosts/management/tag-manager/tag-manager-hinzufugen.md).

# Tag-Manager hinzufügen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Tag-Manager hinzufügen** in der rechten oberen Ecke der [Tag-Manager-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/tag-manager.md#tag-manager-ubersicht) und wähle aus dem Untermenü, das sich öffnet, eine der folgenden Optionen aus:

* [Neu anlegen](#tag-manager-erstellen): Wähle diese Option, wenn du einen neuen Tag-Manager erstellen möchtest.
* [Importieren](#tag-manager-importieren): Wähle diese Option, wenn du einen oder mehrere Tag-Manager, die du zuvor bspw. aus anderen Organisationen exportiert hast, importieren möchtest.

***

## Tag-Manager erstellen

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Tag-Manager hinzufügen** in der rechten oberen Ecke der [Tag-Manager-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/tag-manager.md#tag-manager-ubersicht) und wähle aus dem Untermenü, das sich öffnet, die Option <i class="fa-plus">:plus:</i> **Neu anlegen** aus, um einen neuen Tag-Manager zu erstellen.&#x20;

Es öffnet sich die Ansicht **Hosts** → **Tag-Manager** → **Hinzufügen**.

<div align="left"><figure><img src="/files/d2IbYoxctEUtzCGYGfBx" alt=""><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Tag-Manager hinzufügen**, nachdem du alle Einstellungen vorgenommen hast, um den neuen Tag-Manager zu erstellen.

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Zurück**, um zurück zur Listenübersicht zu gelangen.

{% hint style="danger" %}
**Bitte beachte**: Verlässt du diese Ansicht, ohne auf **Tag-Manager hinzufügen** zu klicken, sind alle bisher vorgenommenen Einstellungen unwiederbringlich verloren!
{% endhint %}

***

## Grundeinstellungen

<div align="left"><figure><img src="/files/RSoFPE7tlg5GVP2H6YSo" alt=""><figcaption></figcaption></figure></div>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.03515625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Name</td><td>Gib dem Tag-Manager einen aussagekräftigen Anzeigenamen.</td></tr><tr><td>Beschreibung</td><td><p>Beschreibe den Tag-Manager genauer.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Dieses Feld ist optional.</p></div></td></tr><tr><td>Verwaltete Attribute</td><td>Zeigt den mit dem Tag-Manager verwalteten Wert, in diesem Fall <strong>Tags</strong>.</td></tr></tbody></table>

***

## Verwalteter Wert

<div align="left"><figure><img src="/files/3xwKowOqzM1PCDMhxbmi" alt=""><figcaption></figcaption></figure></div>

Hier legst du fest, wie mit den Tags umgegangen werden soll. Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.70703125">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Tags</td><td><p>Lege die <a href="/pages/IerpCT9IKitWRqBDBDUv">globalen Tags</a> fest, die den ausgewählten Hosts per Bedingung hinzugefügt oder entfernt werden sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Tags</strong>, um eine Liste aller verfügbaren globalen Tags auszuklappen.Wenn du noch keine globalen Tags angelegt hast, ist diese Liste leer.</p><p></p><p>Wähle einen oder mehrere globale Tags aus. Klicke dazu auf das entsprechende <a href="/pages/XLyO49d2fSXMl2c0NBRx#tag-label">Tag-Label</a> und wähle einen der dazugehörigen <a href="/pages/XLyO49d2fSXMl2c0NBRx#tag-werte">Tag-Werte</a>.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Pro Tag-Label kann nur <em>ein</em> zugehöriger Tag-Wert ausgewählt werden.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-xmark">:xmark:</i> neben einem hinzugefügten Tag, um ihn aus dem Feld <strong>Tags</strong> zu entfernen.</p></td></tr><tr><td>Verwalteten Wert hinzufügen</td><td><p>Aktiviere diese Option, um die ausgewählten Tags den per Bedingung definierten Hosts zuzuordnen.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Option ist standardmäßig aktiviert.</p></div></td></tr><tr><td>Strikter Modus</td><td><p><i class="fa-eye">:eye:</i> Diese Option ist nur sichtbar, wenn die Option <strong>Verwalteten Wert hinzufügen</strong> aktiviert ist.<br><br>Aktiviere den strikten Modus, um die Zuordnung von ausgewählten Tags zu den entsprechenden Hosts aufzuheben, sobald für diese Hosts eine definierte Bedingung nicht mehr gegeben ist.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Option ist standardmäßig aktiviert</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben Strikter Modus oder entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i>, um die Checkliste zu deaktivieren.</p></td></tr><tr><td>Verwalteten Wert entfernen</td><td>Aktiviere diese Option, um die Zuordnung der ausgewählten Tags zu den entsprechenden Hosts aufzuheben.</td></tr></tbody></table>

***

## Bedingungen

Hier legst du fest, welche Bedingungen zutreffen müssen, damit die ausgewählten Tags bestimmten Hosts zugeordnet werden oder damit eine Zuordnung aufgehoben wird.

<div align="left"><figure><img src="/files/v7nnXHsWII8cJwdN3xjt" alt=""><figcaption></figcaption></figure></div>

Zwei oder mehr Bedingungen können mit dem Operator UND sowie mit dem Operator ODER verbunden werden. Zudem ist es möglich, einer Bedingung eine Unterbedingung hinzuzufügen.

{% hint style="info" %}
Bedingungen und Unterbedingungen sind beliebig verschachtelbar. Dies wird grafisch als hierarchischer Bedingungsbaum dargestellt.
{% endhint %}

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="200.1484375">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Operatoren</td><td><p>Lege fest, wie du zwei oder mehr Bedingungen verknüpfen möchtest.<br><br>Folgende Operatoren stehen zur Verfügung:</p><ul><li><strong>UND</strong>: Die erste Bedingung und die zweite Bedingung müssen zutreffen.</li><li><strong>ODER</strong>: Die erste Bedingung oder die zweite Bedingung muss zutreffen.</li></ul></td></tr><tr><td>Bedingung</td><td>Gib eine Bedingung an, die zutreffen muss, damit die ausgewählten Tags bestimmten Hosts zugeordnet werden oder die Zuordnung aufgehoben wird.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu auf <i class="fa-plus">:plus:</i> <strong>Bedingung</strong>, um weitere Optionen anzuzeigen.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Löschen</strong>-Symbol <i class="fa-trash">:trash:</i> neben einem Bedingungseintrag, um den entsprechenden Zweig im Bedingungsbaum zu löschen.</td></tr><tr><td>Unterbedingung</td><td>Füge einer Bedingung eine Unterbedingung hinzu, die zutreffen muss, damit die ausgewählten Tags bestimmten Hosts zugeordnet werden oder die Zuordnung aufgehoben wird.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu auf <i class="fa-plus">:plus:</i> <strong>Unterbedingung</strong>, um weitere Optionen anzuzeigen. Es öffnet sich ein untergeordneter Zweig im Bedingungsbaum.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Löschen</strong>-Symbol <i class="fa-trash">:trash:</i> neben einem Bedingungseintrag, um den entsprechenden Zweig im Bedingungsbaum zu löschen.</td></tr><tr><td>Kategorie</td><td><p><i class="fa-eye">:eye:</i> Dieses Feld ist nur sichtbar, wenn du eine <strong>Bedingung</strong> oder <strong>Unterbedingung</strong> hinzufügst.</p><p>Lege eine Host-Kategorie fest, die die zugeordneten Hosts näher definiert.<br><br><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Kategorie</strong>, um eine Liste aller verfügbaren Werte auszuklappen, und wähle eine Kategorie aus.</p></td></tr><tr><td>Pattern (Regex) (Syntax: PCRE)</td><td><i class="fa-eye">:eye:</i> Dieses Feld ist nur sichtbar, wenn du eine <strong>Bedingung</strong> oder <strong>Unterbedingung</strong> hinzufügst.<br><br>Gib eine Perl-Compatible Regex (PCRE) ein, die die Bedingung näher definiert.</td></tr><tr><td>Regex Flags</td><td><p><i class="fa-eye">:eye:</i> Diese Optionen sind nur sichtbar, wenn du im Feld <strong>Pattern (Regex) (Syntax: PCRE)</strong> auf das <strong>Fahnen</strong>-Symbol <i class="fa-flag">:flag:</i> klickst.<br></p><p>Folgende Optionen sind verfügbar:</p><ul><li><strong>Multiline</strong>: Zeilenanfang und -ende in einem mehrzeiligen Text werden automatisch erkannt.</li><li><strong>Case Insensitive</strong>: Groß- und Kleinschreibung werden ignoriert.</li></ul><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Optionen sind nicht standardmäßig aktiviert.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Setze einen Haken in die Checkbox <i class="fa-square">:square:</i> neben einer Option, um diese zu aktivieren. Oder entferne den Haken aus der Checkbox <i class="fa-square-check">:square-check:</i> um die entsprechende Option zu deaktivieren.</p></td></tr></tbody></table>

***

## Zugeordnete Referenzen

Hier kannst du definieren, für welche Hosts oder Gruppen von Hosts die vorgenommenen Einstellungen gelten sollen.

<figure><img src="/files/84OZZ67GYYOtrEa7ikL5" alt=""><figcaption></figcaption></figure>

Folgende Optionen stehen zur Verfügung:

<table><thead><tr><th width="199.625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Hosts</td><td><p>Lege Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Hosts</strong>, um eine Liste aller verfügbaren Hosts auszuklappen, und wähle einen oder mehrere Hosts aus. Oder nutze die Freitexteingabe, um Hosts in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Host, um ihn aus dem Feld <strong>Hosts</strong> zu entfernen.</p></td></tr><tr><td>Tag-Verknüpfung</td><td><p>Lege fest, wie viele Tags ein zugeordneter Host enthalten muss, damit die Einstellungen für ihn gelten.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Die standardmäßig ausgewählte Tag-Verknüpfung ist <strong>Alle Tags sind bei der Referenz vorhanden</strong>.</p></div><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Feld <strong>Tag-Verknüpfung</strong>, um eine Liste aller verfügbaren Optionen auszuklappen.<br><br>Folgende Optionen stehen zur Verfügung:</p><ul><li><strong>Alle Tags sind bei der Referenz vorhanden</strong>: Ein zugeordneter Host muss alle angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li><li><strong>Mindestens einer der angegebenen Tags ist vorhanden</strong>: Ein zugeordneter Host muss mindestens einen der angegebenen Tags enthalten, damit die Einstellungen für ihn gelten.</li></ul></td></tr><tr><td>Tags</td><td><p>Lege Tags für Gruppen von Hosts fest, für die die vorgenommenen Einstellungen gelten sollen.</p><p></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke dazu in das Feld <strong>Tags</strong>, um eine Liste aller verfügbaren Tags auszuklappen, und wähle einen oder mehrere Tags aus. Oder nutze die Freitexteingabe, um Tags in der Liste schneller zu finden.<br></p><p><i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf das <strong>Entfernen</strong>-Symbol <i class="fa-circle-xmark">:circle-xmark:</i> neben einem hinzugefügten Tag, um ihn aus dem Feld <strong>Tags</strong> zu entfernen.</p></td></tr></tbody></table>

### Ausgeschlossene Referenzen

Hier kannst du definieren, welche Hosts oder Gruppen von Hosts von den vorgenommenen Einstellung explizit ausgenommen werden sollen.

{% hint style="info" %}
Die Angabe von ausgeschlossenen Hosts ist optional.
{% endhint %}

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Ausnahmen definieren** neben **Zugeordnete Hosts**, um die Optionen für **Ausgeschlossene Hosts** anzuzeigen.

<div align="left"><figure><img src="/files/Ij7mAIQCONibozppnzEH" alt="" width="563"><figcaption></figcaption></figure></div>

<i class="fa-gear">:gear:</i> Nimm alle Einstellungen wie bei der Angabe eines zugeordneten Hosts vor.

***

## Tag-Manager importieren

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf <i class="fa-plus">:plus:</i> **Tag-Manager hinzufügen** in der rechten oberen Ecke der [Tag-Manager-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/tag-manager.md#tag-manager-ubersicht) und wähle aus dem Untermenü, das sich öffnet, die Option <i class="fa-arrow-down-to-square">:arrow-down-to-square:</i> **Importieren** aus, um einen oder mehrere Tag-Manager zu importieren.

Es öffnet sich das Fenster **Tag-Manager importieren**.

<div align="left"><figure><img src="/files/OqsiyWfeHK2g0NyxDORS" alt="" width="410"><figcaption></figcaption></figure></div>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke in das Fenster, um eine ZIP-Datei, die die für den Import vorgesehenen Objekte enthält, von deinem Gerät auszuwählen. Oder ziehe per Drag-and-Drop eine ZIP-Datei in das Fenster, um diese zu validieren und für den Import vorzubereiten.

<div align="left"><figure><img src="/files/iVecSNmvfQ7hUyFthbqV" alt=""><figcaption></figcaption></figure></div>

Nach der Validierung wird dir angezeigt, ob die Datei, die importiert werden soll, dem erwarteten Format entspricht, und wie viele Objekte importiert werden können. Zudem stehen folgende Optionen für den Import zur Verfügung:

<table><thead><tr><th width="199.84765625">Option</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Neu anlegen</td><td><p>Wähle diese Option, um jeden importierten Tag-Manager als neuen Eintrag anzulegen.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Bitte beachte</strong>: Bereits vorhandene <a href="#tag-label">Tag-Label</a> können nicht dupliziert werden und werden beim Import übersprungen.</p></div></td></tr><tr><td>Aktualisieren</td><td>Wähle diese Option, um bereits vorhandene Tag-Manager beim Import zu aktualisieren. Alle weiteren importierten Tag-Manager werden jeweils als neuer Eintrag angelegt. </td></tr><tr><td>Überspringen</td><td><p>Wähle diese Option, um alle bereits vorhandenen Tag-Manager beim Import zu überspringen. Alle weiteren importierten Tag-Manager werden jeweils als neuer Eintrag angelegt.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Diese Option ist standardmäßig ausgewählt. </p></div></td></tr></tbody></table>

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Importieren**, um mit dem Import der Datei zu beginnen. Neu hinzugefügte Tag-Manager findest du nach erfolgreichem Import in der [Tag-Manager-Übersicht](/docs/manual/bedienung-der-plattform/hosts/management/tag-manager.md#tag-manager-ubersicht).

<i class="fa-computer-mouse">:computer-mouse:</i> Klicke auf **Abbrechen**, um zurück zur Listenübersicht zu gelangen.

***
