Attribut-Typen

Beim Hinzufügen eines neuen Objektattributs haben Sie die Wahl zwischen den auf dieser Seite beschriebenen Attributtypen.

Warnung

Sie können das Format und den Typ des Attributs nicht mehr ändern, sobald es gespeichert wurde. Wenn Sie ein Objektattribut nicht mehr benötigen, sollten Sie es deaktivieren, anstatt es zu entfernen.

Boolean-Feld

Bietet ein Dropdown-Feld mit Anzeigewerten für true und false. Das Festlegen eines Standardwerts ist erforderlich.

Verfügbare Einstellungen für boolesche Felder

Datumsfeld

Bietet ein Datumsauswahlfeld. Bei der Objekterstellung (z.B. bei der Erstellung eines Tickets) wird es mit dem aktuellen Datum vorausgefüllt und die angegebene Differenz/der angegebene Versatz wird angewendet.

Standard-Zeit-Differenz (Stunden): Definieren Sie die Standard-Zeitdifferenz (in Stunden), die angewendet wird, wenn das Feld bei der Objekterstellung vorausgefüllt wird.

Verfügbare Einstellungen für Datumsfelder

Datum & Zeit-Feld

Bietet ein Feld zur Auswahl von Datum und Uhrzeit. Bei der Objekterstellung (z.B. bei der Erstellung eines Tickets) wird es mit dem aktuellen Datum und der aktuellen Uhrzeit vorausgefüllt und die angegebene Differenz/der angegebene Versatz wird angewendet.

  • Werte in der Zukunft erlauben: Erlaubt die Eingabe von Datum und Zeit in der Zukunft. Standard: Ja.

  • Werte in der Vergangenheit erlauben: Erlaubt Datum und Zeit in der Vergangenheit. Standard: Ja.

  • Standard-Zeitdifferenz (Minuten): Definieren Sie die Standard-Zeitdifferenz (in Minuten), die angewendet wird, wenn das Feld bei der Objekterstellung vorausgefüllt wird.

Verfügbare Einstellungen für Datum- und Zeitfelder

Zahlen-Feld

Bietet ein Eingabefeld, das nur die Verwendung von Ganzzahlen erlaubt. Sie können einen Standardwert definieren. Dezimalstellen sind nicht erlaubt bzw. werden ignoriert.

  • Minimum: Der Mindestwert, den das Feld akzeptiert.

  • Maximum: Der Höchstwert, den das Feld akzeptiert.

Verfügbare Einstellungen für Integer-Felder

Mehrfachauswahl-Feld

Bietet ein Feld mit vordefinierten Werten, aus denen Benutzer einen oder mehrere auswählen können. Es unterstützt keine Hierarchie (wie ein Mehrfach-Baumauswahl-Feld). Sie können einen Standardwert festlegen.

Tipp

Vergessen Sie nicht, nach dem Hinzufügen Ihrer Werte nochmal auf „+ Hinzufügen“ zu klicken. Ansonsten könnte der letzte Wert nicht gespeichert werden.

Link-Vorlage: Siehe Link-Vorlage für weitere Informationen.

Verfügbare Einstellungen für Mehrfachauswahlfelder

Tipp

↕️ Dieser Feldtyp erlaubt die Positionierung der Werte ↔️

Um die Feldwerte neu anzuordnen, bearbeiten Sie das Feld und scrollen Sie unter die Werte. Vergewissern Sie sich, dass Sie die Option „Verwende benutzerdefinierte Sortierung“ aktiviert haben. Ziehen Sie die Werte nun mit ☰ an die richtige Position. Übermitteln Sie anschließend Ihre Änderungen, um das Objektattribut zu speichern.

Screencast, der zeigt, wie man Einträge neu positioniert

Einfachauswahl-Feld

Bietet ein Feld mit vordefinierten Werten, aus denen Benutzer einen auswählen können. Es unterstützt keine Hierarchie (wie ein Einfach-Baumauswahl-Feld). Sie können einen Standardwert festlegen.

Tipp

Vergessen Sie nicht, nach dem Hinzufügen Ihrer Werte nochmal auf „+ Hinzufügen“ zu klicken. Ansonsten könnte der letzte Wert nicht gespeichert werden.

Link-Vorlage: Siehe Link-Vorlage für weitere Informationen.

Verfügbare Einstellungen für Einfachauswahl-Felder

Tipp

↕️ Dieser Feldtyp erlaubt die Positionierung der Werte ↔️

Um die Feldwerte neu anzuordnen, bearbeiten Sie das Feld und scrollen Sie unter die Werte. Vergewissern Sie sich, dass Sie die Option „Verwende benutzerdefinierte Sortierung“ aktiviert haben. Ziehen Sie die Werte nun mit ☰ an die richtige Position. Übermitteln Sie anschließend Ihre Änderungen, um das Objektattribut zu speichern.

Screencast, der zeigt, wie man Einträge neu positioniert

Textbereich-Feld

Bietet ein Eingabefeld für einen Textbereich (mehrere Zeilen). Sie können einen Standardwert festlegen. Es unterstützt keine Textformatierung oder HTML-Inhalte (Rich Text).

  • Standard: Dieser Text wird in nicht ausgefüllten Feldern angezeigt.

  • Maximale Länge: Legt die maximale Anzahl an Zeichen für das Feldes fest. Standard: 500.

  • Zeilen: Legen Sie die Anzeigegröße des Feldes fest. In jedem Fall ist das Feld scrollbar, wenn der Inhalt die Anzahl der angezeigten Zeilen überschreitet. Standard: 4.

Verfügbare Einstellungen für Textbereich-Felder

Textfeld

Bietet ein Textfeld (eine Zeile). Sie können einen Standardwert festlegen.

  • Typ: Legt den Typ des Eingabefeldes fest. Auf diese Weise stellt der Browser sicher, dass das entsprechende Format verwendet wird. Verfügbare Optionen:

    • E-Mail

    • Telefon

    • Text

    • Url (Hinweis: deaktiviert die Verfügbarkeit von Link-Vorlagen)

  • Maximale Länge: Legt die maximale Anzahl an Zeichen für das Feld fest. Standard: 120.

  • Link-Vorlage: Siehe Link-Vorlage für weitere Informationen.

Verfügbare Einstellungen für Textfelder

Einfach-Baumauswahl-Feld

Bietet ein Feld mit vordefinierten Werten, aus denen Benutzer einen auswählen können. Es werden bis zu 6 Hierarchiestufen unterstützt. Um die Auswahl eines Wertes einzuschränken (z.B. für übergeordnete Werte), deaktivieren Sie das Kontrollkästchen in der Spalte „Aktiv“.

Tipp

↕️ Dieser Feldtyp erlaubt die Positionierung der Werte ↔️

Um die Feldwerte neu anzuordnen, bearbeiten Sie zunächst das Feld. Dann können Sie mit ☰ die betreffenden Werte an die richtige Stelle ziehen. Wenn Sie die Ebenentiefe ändern möchten, doppelklicken Sie auf ☰. Damit können Sie durch die verfügbaren Ebenen wechseln.

Verfügbare Einstellungen für Baumauswahlfelder

Mehrfach-Baumauswahl-Feld

Bietet ein Feld mit vordefinierten Werten, aus denen Benutzer einen oder mehrere auswählen können. Es werden bis zu 6 Hierarchiestufen unterstützt. Um die Auswahl eines Wertes einzuschränken (z.B. für übergeordnete Werte), deaktivieren Sie das Kontrollkästchen in der Spalte „Aktiv“.

Tipp

↕️ Dieser Feldtyp erlaubt die Positionierung der Werte ↔️

Um die Feldwerte neu anzuordnen, bearbeiten Sie zunächst das Feld. Dann können Sie mit ☰ die betreffenden Werte an die richtige Stelle ziehen. Wenn Sie die Ebenentiefe ändern möchten, doppelklicken Sie auf ☰. Damit können Sie durch die verfügbaren Ebenen wechseln.

Verfügbare Einstellungen für Baumauswahlfelder

Feld für externe Datenquelle

Bietet ein durchsuchbares Feld, das Daten aus einem externen System abruft. Dies kann nützlich sein, wenn Sie Daten außerhalb von Zammad haben und nicht beide Datenquellen pflegen wollen. Es funktioniert wie folgt:

  • Zammad sendet eine Anfrage mit einem Suchstring (freier Text vom Agent oder basierend auf einer Variable) in einem vordefinierten Format („Such URL“) an ein externes System.

  • Dieses externe System sucht nach Übereinstimmungen und gibt eine Antwort in Form einer JSON-Struktur an Zammad.

  • Zammad sucht nur nach den definierten Suchergebnis-Schlüsseln und -Werten, liest den Inhalt und zeigt dem Benutzer den Wert an. Es gibt keine Suche auf der Seite von Zammad.

Warnung

  • Nur GET wird als Request-Methode unterstützt.

  • Die Datenstruktur muss im JSON-Format sein und die Objekte in einem Array bereitgestellt werden.

  • Der Endpunkt für die externe Datenquelle muss die Suche unterstützen. Auf Zammad-Seite ist keine Suche/Logik implementiert; Sie können jedoch den Suchergebnis-Schlüssel und -Wert auf der Grundlage des Ergebnisses der Antwort definieren (die bereits gefilterte Inhalte auf der Grundlage der Suche bereitstellt).

  • Wenn Sie mehr Ergebnisse als erwartet erhalten, funktioniert die Suche in Ihrer externen Datenquelle möglicherweise nicht richtig oder die Struktur der URL ist nicht korrekt. Sie sollten sich mit einer zuständigen Person des externen Systems in Verbindung setzen.

Bitte schauen Sie sich unser Beispiel an, wo Sie eine mögliche Konfiguration unter Verwendung eines öffentlichen Dummy-Endpunkts finden.

Verfügbare Einstellungen für externe Datenquelle Felder
Such-URL

Legen Sie den Endpunkt fest, an dem Zammad die Daten abruft. Bitte stellen Sie sicher, dass Sie eine gültige Variable als URL-Parameter angeben. Beispiel für eine Freitextsuche bei Benutzereingabe: #{suche.begriff}

Fragen Sie im Zweifelsfall die für die externe Datenquelle verantwortliche Person, wie die Struktur der URL aufgebaut sein muss.

Bemerkung

Je nach Suchvariable kann die Vorschau ggf. nicht funktionieren. Der Grund dafür ist, dass der Objektkontext in der Konfiguration möglicherweise nicht verfügbar ist. Dies ist kein Fehler.

Achten Sie bitte auch darauf, dass Sie eine Variable verwenden, die in Ihrem Objektkontext verfügbar ist. Zum Beispiel können Sie in einem Benutzerobjektkontext nicht nach einem Ticket suchen.

SSL-Verizifierung

Hier können Sie die SSL-Verifizierung auf nein stellen.

Gefahr

Bitte beachten Sie, dass das Deaktivieren der SSL-Verifizierung ein Sicherheitsrisiko darstellt. Es sollte nur vorübergehend oder zu Testzwecken verwendet werden. Wenn diese Option deaktiviert ist, findet keine Überprüfung des Zertifikats statt, was bedeutet, dass jedes vorgelegte Zertifikat akzeptiert wird.

Wenn Ihr externes Datenquellensystem selbstsignierte Zertifikate verwendet, sehen Sie sich bitte SSL Zertifikate an. Dort finden Sie weitere Informationen darüber, wie diese in Zammad hinterlegt werden können, damit Sie die SSL-Verifizierung aktiviert lassen können.

HTTP-Authentifizierung

Wenn Ihre externe Datenquelle eine Authentifizierung erfordert, können Sie diese hier hinterlegen. Sie können es leer lassen oder zwischen Basis Authentifizierung oder Token Authentifizierung wählen (die Auswahl einer der beiden Methoden führt zu zusätzlichen Feldern, in die Sie Ihre Anmeldedaten/Token eingeben können).

Schlüssel der Suchergebnisliste

Definiert die Ebene in der JSON-Struktur, die die Liste mit den Suchergebnissen liefert. Sie können es leer lassen, wenn die Daten bereits als Array bereitgestellt werden. Wenn Sie tiefer in die Struktur gehen müssen, können Sie einen Pfad mit . als Trennzeichen angeben, z.B. key.subkey.sub-sub-key.

Schlüssel Suchergebnis-Wert

Definiert das Attribut in der Struktur, in der Ihre externe Datenquelle den Wert für Ihre Daten liefert. Ein Beispiel wäre eine Produkt Nummer. Wenn Sie tiefer in die Struktur eindringen müssen, können Sie einen Pfad mit . als Trennzeichen angeben, z.B. key.subkey.sub-sub-key.

Schlüssel der Suchergebnisbezeichnung

Definiert das Attribut in der Struktur, in der Ihre externe Datenquelle die Bezeichnung für Ihre Daten bereitstellt. Ein Beispiel wäre ein Produkt Name. Wenn Sie tiefer in die Struktur eindringen müssen, können Sie einen Pfad mit . als Trennzeichen angeben, z.B. key.subkey.sub-sub-key.

Vorschau

Im Vorschaubereich finden Sie die folgenden Elemente (abhängig von bisheriger Konfiguration):

  • Fehler-/Hinweismeldung (nur wenn die Konfiguration nicht vollständig ist): Zammad sagt Ihnen, ob es ein Problem gibt und was Sie an Ihrer Konfiguration ändern sollten.

  • Suchfeld: Suchen Sie nach einem vorhandenen Attribut in der Datenquelle, um eine Vorschau zu erhalten. Dies ist erforderlich, damit die nachstehenden Felder angezeigt werden können.

  • Antwort Suchergebnis (nur wenn die Konfiguration nicht vollständig ist): Hier finden Sie eine syntaktisch hervorgehobene JSON-Vorschau der Antwort, die auf dem eingegebenen Suchbegriff basiert.

  • Suchergebnisliste (nur wenn Suchergebnislisten-Schlüssel richtig gesetzt ist): Ausgabe der Struktur unter dem konfigurierten Suchergebnislisten-Schlüssel.

  • Vorschau-Tabelle (wenn vollständig konfiguriert): Zammad zeigt Ihnen eine Tabelle an, die die gefundenen Elemente auf der Grundlage des Suchstrings (Wert, Bezeichnung und optionaler Link) enthält. Sie können diese Vorschau verwenden, wenn Sie nicht die komplette Datenstruktur des externen Systems im Kopf haben.

Ein Beispiel für ein eigenes Feld auf Ticketebene vom Typ externe Datenquelle aus der Sicht eines Agenten:

Screencast zeigt die Suche nach einem Produkt in einem Ticket

Verschiedenes

Feldinhalte übersetzen

Für einige Attribut-Typen können Sie entscheiden, ob deren Werte übersetzbar sein sollen oder nicht. Wenn sie als übersetzbar gekennzeichnet sind, erscheinen sie wie andere Zeichenketten in den Zammad-Einstellungen unter Übersetzungen. Dies funktioniert nur für Felder mit auswählbaren Optionen, da die möglichen Optionen bekannt und begrenzt sind. Sie können die Übersetzbarkeit für diese Typen setzen:

  • Boolean-Feld

  • Einfachauswahl-Feld

  • Mehrfachauswahl-Feld

  • Einfach-Baumauswahl-Feld

  • Mehrfach-Baumauswahl-Feld

Screenshot mit übersetzbaren Attributtypen