Dynamische Felder

Beside general information required for all tickets, organizations have individual needs to add specific details to tickets. This needed information takes various formats like texts, integers, date-time and more.

OTOBO supports adding a so-called dynamic field to handle texts, integers, drop-down lists, multi-select fields, date-time, checkboxes and more. OTOBO administrators can define where those fields should be visible or editable, and of course, the dynamic fields are also available in statistics and reports.

Use this screen to manage dynamic fields in the system. A fresh OTOBO installation contains two dynamic fields by default. The dynamic field management screen is available in the Dynamic Fields module of the Processes & Automation group.

Dynamische Felder verwalten

So erstellen Sie ein Dynamisches Feld:

Choose an object type in the left actions sidebar and select a dynamic field type from its drop-down.
Füllen Sie die Pflichtfelder aus.
Klicken Sie auf die Schaltfläche Speichern.

So bearbeiten Sie ein Dynamisches Feld:

Click on a dynamic field in the dynamic fields list.
Ändern Sie die Felder.
Klicken Sie auf die Schaltfläche Speichern oder Speichern und abschließen.

So löschen Sie ein Dynamisches Feld:

Klicken Sie in der letzten Spalte der Übersichtstabelle auf das Papierkorb-Symbol.
Klicken Sie auf die Schaltfläche Bestätigen.

Bemerkung

Wenn dem System mehrere Dynamische Felder hinzugefügt wurden, verwenden Sie das Filterfeld, um einen bestimmten Eintrag zu finden, indem Sie einfach den zu filternden Namen eingeben.

Einstellungen für Dynamische Felder

Die folgenden Einstellungen sind verfügbar, wenn Sie diese Ressource hinzufügen oder bearbeiten. Die mit einem Sternchen gekennzeichneten Felder sind Pflichtfelder.

Allgemeine Einstellungen für Dynamische Felder

Diese Einstellungen gelten für alle Typen von Dynamischen Feldern.

Dynamische Felder - Allgemeine Einstellungen

Name *: The name of this resource. The value should be alphabetic and numeric characters only. The name will be displayed in the overview table.
Beschriftung: Dieser Name wird auf den Ansichten angezeigt, auf denen dieses Feld aktiv ist.

Siehe auch

Es ist möglich, Übersetzungen zu den Beschriftungen für ein Dynamisches Feld hinzuzufügen. Übersetzungen für Beschriftungen müssen manuell den Sprach-Übersetzungsdateien hinzugefügt werden.
Feldreihenfolge: Die Feldreihenfolge steuert die Ausgabe der Felder auf den Ansichten, wo das Dynamische Feld aktiv ist.
Gültigkeit *: Setzt die Gültigkeit dieser Ressource. Jede Ressource kann nur in OTOBO verwendet werden, wenn dieses Feld auf gültig gesetzt ist. Wenn Sie dieses Feld auf ungültig oder ungültig-temporär setzen, wird die Nutzung der Ressource deaktiviert.
Feldtyp: This type has been selected in the left sidebar and can not be changed here anymore. This is a read-only field.
Objekttyp: This type has been selected in the left sidebar and can not be changed here anymore. This is a read-only field.

Bemerkung

The object type determines where the dynamic field can be used. For example a dynamic field with object type Ticket can be used only in tickets, and can not be used in articles.

Die folgenden Einstellungen sind nur für die jeweiligen Typen der Dynamischen Felder relevant.

Einstellungen für Dynamisches Feld vom Typ „Kontrollkästchen“

Dynamische Felder vom Typ „Kontrollkästchen“ werden genutzt, um „wahr“ und „falsch“-Werte zu speichern.

Standardwert

The default value for the checkbox.

Ausgewählt: Das Kontrollkästchen ist standardmäßig ausgewählt.
Nicht ausgewählt: Das Kontrollkästchen ist standardmäßig nicht ausgewählt.

Einstellungen für das Dynamische Feld vom Typ „Kontaktdaten“

Dieses Dynamische Feld ermöglicht das Hinzufügen von Kontaktdaten zu Tickets.

Namensfeld *: Das Attribut Name ist immer Pflicht und wird nicht automatisch hinzugefügt, so dass dieses Attribut für jede neue Datenquelle manuell hinzugefügt werden muss. Innerhalb der Datenquellendefinition (oder Dynamischen Feld-Konfiguration) müssen sie durch den Schlüssel Name dargestellt werden und der Wert könnte beispielsweise Name sein.
ValidID-Feld *: Das Attribut ValidID ist immer Pflicht und wird nicht automatisch hinzugefügt, so dass dieses Attribut für jede neue Datenquelle manuell hinzugefügt werden muss. Innerhalb der Datenquellendefinition (oder Dynamischen Feld-Konfiguration) müssen sie durch den Schlüssel ValidID dargestellt werden und der Wert könnte beispielsweise Validität sein.
Andere Felder: These are the possible data attributes for contacts. Clicking on the ⊞ button of the Add Fields will add two new fields, where a Key (internal value) and a Value (displayed value) can be set. With the button you can add multiple key-value pairs.

Warnung

Die Schlüssel Name und ValidID werden bereits durch Namensfeld und ValidID-Feld benutzt. Benutzen Sie diese Schlüssel nicht noch einmal!
Felder hinzufügen: Verwenden Sie diese Schaltfläche, um mehr Dynamische Felder hinzuzufügen.
Pflichtfelder: Comma separated list of mandatory keys.

Bemerkung

Die Schlüssel Name und ValidID sind immer Pflicht und müssen hier nicht aufgeführt werden.
Sortierte Felder: Komma-separierte Liste von Schlüsseln in sortierter Reihenfolge. Schlüssel, die hier gelistet sind, kommen zuerst. Alle anderen Felder danach werden alphabetisch sortiert.
Durchsuchbare Felder: Komma-separierte Liste von durchsuchbaren Schlüsseln.

Bemerkung

Der Schlüssel Name ist immer durchsuchbar und braucht hier nicht gelistet werden.
Übersetzbare Werte: Wenn Sie diese Einstellung aktivieren, werden die Werte in die Sprache des Benutzers übersetzt.

Bemerkung

Sie müssen die Übersetzungen manuell zu den Übersetzungsdateien hinzufügen.

Wenn das Dynamische Feld gespeichert wurde, klicken Sie auf den Namen des neu angelegten Feldes in der Übersichtstabelle. Die Ansicht Dynamische Feld bearbeiten wird geöffnet. Es gibt eine Schaltfläche Kontakte hinzufügen oder bearbeiten, die nach Tickets → Kontaktdaten bearbeiten führt, um einige Daten hinzuzufügen.

To add a new contact with data:

Wählen Sie im Widget Aktionen in der linken Seitenleiste ein Dynamisches Feld aus der Dropdown-Liste.
Klicken Sie in der linken Seitenleiste auf die Schaltfläche Kontaktdaten hinzufügen.
Füllen Sie die Pflichtfelder aus.
Klicken Sie auf die Schaltfläche Speichern.

So bearbeiten Sie Kontaktdaten:

Klicken Sie in der Liste mit den Kontaktdaten auf einen Eintrag.
Ändern Sie die Felder.
Klicken Sie auf die Schaltfläche Speichern oder Speichern und abschließen.

Die Benutzung dieses Typs eines Dynamischen Feldes ist komplexer als die der anderen. Ein Beispiel der Benutzung von Kontaktdaten:

Erstellen Sie ein neues Dynamisches Feld vom Typ „Kontaktdaten“.
Setzen Sie die möglichen Kontaktattribute (Mögliche Werte).
- Geben Sie Name in das Namensfeld ein.
- Geben Sie Gültigkeit in das ValidID-Feld ein.
- Fügen Sie mit der Schaltfläche Felder hinzufügen weitere Attribute wie bspw. Telefon-Attribut hinzu (Schlüssel Telefon , Wert Telefonnummer).
Fügen Sie die komma-separierten Liste der Attributeschlüssel hinzu (Name und ValidID werden nicht benötigt).
Setzen Sie Attributeschlüssel-Sortierliste komma-separiert als: Name,Telefon``,``ValidID``.
Fügen Sie die komma-separierte Liste der durchsuchbaren Attributeschlüssel hinzu. (Name wird nicht benötigt).
Füllen Sie die Datenquelle, indem Sie mindestens einen Kontakt in der neu erstellten Datenquelle hinzufügen, indem Sie Tickets → Kontakte mit Daten bearbeiten aus der Hauptnavigationsleiste verwenden.
Fügen Sie das Dynamische Feld zu einer Ansichtskonfiguration hinzu, in der es angezeigt werden soll. Bspw. in der Ansicht Neues Telefon-Ticket durch Aktualisieren der Konfigurationseinstellung Ticket::Frontend::AgentTicketPhone###DynamicField und auch für Ticket::Frontend::AgentTicketZoom###DynamicField.
Gehen Sie in die Ansicht Neues Telefon-Ticket erstellen und sehen Sie, dass das neue Feld angezeigt wird. Fügen Sie alle benötigten Informationen zum Ticket hinzu.
Wählen Sie einen vorhandenen Kontakt mit Hilfe der automatischen Vervollständigung und wählen Sie einen Kontakt aus.
Der zugewiesene Kontakt und seine Attribute der Ticket-Detailansicht angezeigt.
Es ist möglich, die Attribute des Kontakts zu aktualisieren, indem Sie auf die Schaltfläche Kontaktdaten bearbeiten klicken, die sich auf der rechten Seite des Titels des Kontaktdatenfeldes befindet (wenn der aktuelle Benutzer Mitglied der in der Systemeinstellung Frontend::Module####AdminDynamicFieldContactWithData definierten Gruppen ist).
If it’s necessary to change the contact for this ticket, it can be done via any other ticket action where the dynamic field is configured for display.

Einstellungen für Dynamisches Feld vom Typ „Datum“

Dynamische Felder des Typs „Datum“ werden genutzt, um Datumswerte zu speichern.

Standard-Datumsunterschied

Der Unterschied zu JETZT in Sekunden, mit dem der Standardwert des Feldes berechnet wird (z. B. 3600 oder -60).

Jahresbereich definieren

Aktivieren Sie diese Funktion, um für die Datumsauswahl einen festen Jahresbereich anzugeben (Jahre in der Vergangenheit und Zukunft), der im Jahres-Teil dieses Feldes angezeigt wird. Wenn auf Ja gesetzt, sind die folgenden Optionen verfügbar:

Jahre in der Vergangenheit: Definiert die Anzahl der Jahre in der Vergangenheit die angezeigt werden sollen, ausgehend vom aktuellen Datum.
Jahre in der Zukunft: Definiert die Anzahl der Jahre in der Zukunft die angezeigt werden sollen, ausgehend vom aktuellen Datum.

Link anzeigen

Hier können Sie einen optionalen HTTP-Link für den Feldwert in Übersichten und Ansichtsseiten angeben. Beispiel:

http://some.example.com/handle?query=[% Data.Field1 | uri %]

Link für Vorschau

Diese URL wird (falls vorhanden) für eine Vorschau verwendet, wenn sich die Maus über diesem Link in der Ticket-Detailansicht befindet. Hierfür muss das oben stehende URL-Feld ebenso ausgefüllt werden.

Eingabe von Daten einschränken

Hier können Sie die Eingabe von Daten in dieses Feld einschränken.

Eingabe von zukünftigen Datumswerten verhindern: Wenn diese Option ausgewählt ist, wird die Eingabe von Daten verhindert, die nach dem aktuellen Datum liegen.
Eingabe von vergangenen Datumswerten verhindern: Wenn diese Option ausgewählt ist, wird die Eingabe von Daten verhindert, die vor dem aktuellen Datum liegen.

Einstellungen für Dynamisches Feld vom Typ „Datum / Zeit“

Dynamische Felder des Typs „Datum / Zeit“ werden genutzt, um Datums- und Zeitwerte zu speichern.

Die Einstellungen für diesen Typ von Dynamischen Feld sind die Gleichen wie für den Typ „Datum“.

Einstellungen für Dynamisches Feld vom Typ „Mehrfachauswahl“

Mögliche Werte: Dies sind die möglichen Datenattribute für Kontakte. Durch Anklicken der Schaltfläche ⊞ werden zwei neue Felder hinzugefügt, in denen ein Schlüssel (interner Wert) und ein Wert (angezeigter Wert) eingestellt werden können. Mit der Schaltfläche können Sie mehrere Schlüssel-Werte-Paare hinzufügen.
Standardwert: Das ist der Standardwert für dieses Feld und wird auf den „Bearbeiten“-Ansichten angezeigt.
Leeren Wert hinzufügen: Wenn diese Option aktiviert ist, wird ein extra Wert definiert, der als - in der Liste der möglichen Werte angezeigt wird. Dieser spezielle Wert ist intern als leer gekennzeichnet.
Baumansicht: Aktivieren Sie diese Option um die Werte als Baum anzuzeigen.
Übersetzbare Werte: Wenn Sie diese Einstellung aktivieren, werden die Werte in die Sprache des Benutzers übersetzt.

Bemerkung

Sie müssen die Übersetzungen manuell zu den Übersetzungsdateien hinzufügen.

Einstellungen für Dynamisches Feld vom Typ „Text“

Dynamische Felder vom Typ Text werden benutzt, um Einfachzeilen zu speichern.

Standardwert

Das ist der Standardwert für dieses Feld und wird auf den „Bearbeiten“-Ansichten angezeigt.

Link anzeigen

Hier können Sie einen optionalen HTTP-Link für den Feldwert in Übersichten und Ansichtsseiten angeben. Beispiel:

http://some.example.com/handle?query=[% Data.Field1 | uri %]

Link für Vorschau

Diese URL wird (falls vorhanden) für eine Vorschau verwendet, wenn sich die Maus über diesem Link in der Ticket-Detailansicht befindet. Hierfür muss das oben stehende URL-Feld ebenso ausgefüllt werden.

Auf RegEx prüfen

Here you can specify a regular expression to check the value. The regex will be executed with the modifiers xms. Example:

^[0-9]$

RegEx hinzufügen

Wenn Sie auf die ⊞-Schaltfläche klicken, werden zwei neue Felder hinzugefügt, in denen der reguläre Ausdruck und eine Fehlermeldung eingegeben werden können.

Einstellungen für Dynamisches Feld vom Typ „Textfeld“

Dynamische Felder vom Typ „Textfeld“ werden verwendet, um Mehrfachzeilen zu speichern.

Anzahl der Zeilen

Die Höhe des Feldes (in Zeilen) im Bearbeitungsmodus.

Anzahl der Spalten

Die Breite des Feldes (in Buchstaben) im Bearbeitungsmodus.

Standardwert

Das ist der Standardwert für dieses Feld und wird auf den „Bearbeiten“-Ansichten angezeigt.

Auf RegEx prüfen

Here you can specify a regular expression to check the value. The regex will be executed with the modifiers xms. Example:

^[0-9]$

RegEx hinzufügen

Wenn Sie auf die ⊞-Schaltfläche klicken, werden zwei neue Felder hinzugefügt, in denen der reguläre Ausdruck und eine Fehlermeldung eingegeben werden können.

Dynamischen Feldes vom Typ „Datenbank“

Bemerkung

This dynamic field is already included in OTOBO 10 Standard! The documentation on the field types still needs to be completed.

Dynamisches Feld vom Typ „Web-Service“

A Web Service dynamic field relies upon a working Web Service, more precisely on a Web Service invoker.

For this purpose, an invoker of type PassThrough can be used.

For the outgoing API call, DynamicFieldID, -Label, -Name and -Value, as well as UserID and Ticket and Form data are passed to the invoker.

For the dynamic field Web Service to work, the response data needs to be mapped into this structure:

PossibleValue => [
    {
        Key => 'abc',
        Value => 'ABC',
    },
    {
        Key => 'bcd',
        Value => 'BCD',
    },
    ...
]

This can be accomplished by implementing an XSLT mapping.

Dynamische Felder auf Ansichten anzeigen

So zeigen Sie Dynamische Felder auf Ansichten an:

Stellen Sie sicher, dass die Gültigkeit des Dynamischen Feldes auf gültig gesetzt ist.
Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
Navigieren Sie zu Frontend → Agent → View und wählen Sie eine Ansicht, zu der Sie das Dynamische Feld hinzufügen möchten.
Suchen Sie nach der Einstellung, die mit ###DynamicField endet und klicken Sie auf die Schaltfläche Diese Einstellung bearbeiten.
Klicken Sie auf die +-Schaltfläche, um das Dynamische Feld hinzuzufügen.
Geben Sie den Namen des Dynamischen Feldes in das Eingabefeld ein und klicken Sie auf die Schaltfläche mit dem grünen Haken.
Wählen Sie 1 - Aktiviert oder 2 - Aktiviert und verpflichtend aus.
Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
Nehmen Sie die geänderte Systemkonfiguration in Betrieb.

Angezeigte Dynamische Felder in einer Ansicht

Bemerkung

Es ist möglich, mehrere Felder zur gleichen Zeit hinzuzufügen. Wiederholen Sie dazu die Schritte 5-7.

Setzen eines Standardwertes via Ticket-Event-Modul

Ein Ticket-Event (z.B.: TicketCreate) kann einen Wert für ein bestimmtes Feld auslösen, wenn das Feld noch keinen Wert besitzt.

Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
Navigieren Sie zu Core → Event → Ticket und suchen Sie nach der Einstellung Ticket::EventModulePost###9600-TicketDynamicFieldDefault.
Click on the Edit this setting button to activate the setting.
Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
Nehmen Sie die geänderte Systemkonfiguration in Betrieb.

Beispiel: Field1 im TicketCreate-Event aktivieren:

Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
Navigieren Sie zu Core → Event → DynamicFieldDefault und suchen Sie nach der Einstellung Ticket::EventModulePost###9600-TicketDynamicFieldDefault.
Click on the Edit this setting button to activate the setting.
Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
Nehmen Sie die geänderte Systemkonfiguration in Betrieb.

Dynamisches Feld im TicketCreate-Event aktivieren

Bemerkung

Diese Konfiguration kann in jeder der 16 Ticket::TicketDynamicFieldDefault###Element-Einstellungen gesetzt werden.

Siehe auch

If more than 16 fields needs to be set up, a custom XML file must be placed in $OTOBO_HOME/Kernel/Config/Files/XML directory to extend this feature.

Setzen eines Standardwertes via Benutzereinstellungen

Der Standardwert der Dynamischen Felder kann mit einem Benutzer- spezifischen Wert, der in den Benutzereinstellungen definiert ist, überschrieben werden.

Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
Navigieren Sie zu Frontend → Agent → View → Preferences und suchen Sie nach der Einstellung PreferencesGroups###DynamicField.
Click on the Edit this setting button to activate the setting.
Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
Nehmen Sie die geänderte Systemkonfiguration in Betrieb.

Dynamisches Feld in Persönlichen Einstellungen aktivieren

Klicken Sie auf Ihr Avatar-Bild in der linken oberen Ecke und wählen Sie Persönliche Einstellungen → Verschiedenes, um einen Standardwert für ein Dynamisches Feld hinzuzufügen.

Dynamisches Feld in den Persönlichen Einstellungen

Diese Einstellung ist ein Beispiel dafür, wie Sie einen Eintrag in den Benutzereinstellungen erstellen, um einen exklusiven Dynamisches Feld Name_X-Standardwert für den ausgewählten Benutzer festzulegen. Die Einschränkung dieser Einstellung besteht darin, dass sie nur die Verwendung eines Dynamischen Feldes erlaubt. Wenn zwei oder mehr Felder diese Funktion verwenden, ist es notwendig, eine benutzerdefinierte XML-Konfigurationsdatei zu erstellen, um weitere Einstellungen ähnlich dieser hinzuzufügen.

Bemerkung

If more settings are added in a new XML each setting name needs to be unique in the system and different than PreferencesGroups###DynamicField. For example:

PreferencesGroups###101-DynamicField-Field1
PreferencesGroups###102-DynamicField-Field2
PreferencesGroups###My-Field1
PreferencesGroups###My-Field2

Dynamische Felder

Dynamische Felder verwalten

Einstellungen für Dynamische Felder

Allgemeine Einstellungen für Dynamische Felder

Einstellungen für Dynamisches Feld vom Typ „Kontrollkästchen“

Einstellungen für das Dynamische Feld vom Typ „Kontaktdaten“

Einstellungen für Dynamisches Feld vom Typ „Datum“

Einstellungen für Dynamisches Feld vom Typ „Datum / Zeit“

Einstellungen für Dynamisches Feld vom Typ „Einfachauswahl“

Einstellungen für Dynamisches Feld vom Typ „Mehrfachauswahl“

Einstellungen für Dynamisches Feld vom Typ „Text“

Einstellungen für Dynamisches Feld vom Typ „Textfeld“

Dynamischen Feldes vom Typ „Datenbank“

Dynamisches Feld vom Typ „Web-Service“

Dynamische Felder auf Ansichten anzeigen

Setzen eines Standardwertes via Ticket-Event-Modul

Setzen eines Standardwertes via Benutzereinstellungen