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 unterstützt das Hinzufügen eines sogenannten Dynamisches Feld, um Texte, Ganzzahlen, Dropdown-Listen, Mehrfach-Auswahlfelder, Datum/Uhrzeit, Kontrollkästchen und mehr zu verarbeiten. OTOBO-Administratoren können definieren, wo diese Felder sichtbar oder editierbar sein sollen, und natürlich sind die Dynamischen Felder auch in Statistiken und Berichten verfügbar.

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.

Dynamic Field Management Screen

Verwaltung Dynamischer Felder

Dynamische Felder verwalten

So erstellen Sie ein Dynamisches Feld:

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

Neues Dynamisches Feld erstellen

So bearbeiten Sie ein Dynamisches Feld:

  1. Click on a dynamic field in the dynamic fields list.
  2. Ändern Sie die Felder.
  3. Klicken Sie auf die Schaltfläche Speichern oder Speichern und abschließen.
Edit Dynamic Field Screen

Dynamisches Feld bearbeiten

So löschen Sie ein Dynamisches Feld:

  1. Klicken Sie in der letzten Spalte der Übersichtstabelle auf das Papierkorb-Symbol.
  2. Klicken Sie auf die Schaltfläche Bestätigen.
Delete Dynamic Field Screen

Dynamisches Feld löschen

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.

Dynamic Field General Screen

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.

Checkbox Dynamic Field Settings

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

Standardwert

Der Standardwert für das Kontrollkästchen

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.

Contact With Data Dynamic Field Settings

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

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

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.

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

Komma-separierte Liste von Pflichtfeldern

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 TicketsKontaktdaten bearbeiten führt, um einige Daten hinzuzufügen.

Contact With Data Management Screen

Kontaktdaten-Verwaltung

So fügen Sie neue Kontaktdaten hinzu

  1. Wählen Sie im Widget Aktionen in der linken Seitenleiste ein Dynamisches Feld aus der Dropdown-Liste.
  2. Klicken Sie in der linken Seitenleiste auf die Schaltfläche Kontaktdaten hinzufügen.
  3. Füllen Sie die Pflichtfelder aus.
  4. Klicken Sie auf die Schaltfläche Speichern.
Add Contact With Data Screen

Kontaktdaten hinzufügen

So bearbeiten Sie Kontaktdaten:

  1. Klicken Sie in der Liste mit den Kontaktdaten auf einen Eintrag.
  2. Ändern Sie die Felder.
  3. Klicken Sie auf die Schaltfläche Speichern oder Speichern und abschließen.
Edit Contact With Data Screen

Kontaktdaten bearbeiten

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

  1. Erstellen Sie ein neues Dynamisches Feld vom Typ „Kontaktdaten“.
  2. 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).
  3. Fügen Sie die komma-separierten Liste der Attributeschlüssel hinzu (Name und ValidID werden nicht benötigt).
  4. Setzen Sie Attributeschlüssel-Sortierliste komma-separiert als: Name,Telefon``,``ValidID``.
  5. Fügen Sie die komma-separierte Liste der durchsuchbaren Attributeschlüssel hinzu. (Name wird nicht benötigt).
  6. Füllen Sie die Datenquelle, indem Sie mindestens einen Kontakt in der neu erstellten Datenquelle hinzufügen, indem Sie TicketsKontakte mit Daten bearbeiten aus der Hauptnavigationsleiste verwenden.
  7. 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.
  8. 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.
  9. Wählen Sie einen vorhandenen Kontakt mit Hilfe der automatischen Vervollständigung und wählen Sie einen Kontakt aus.
  10. Der zugewiesene Kontakt und seine Attribute der Ticket-Detailansicht angezeigt.
  11. 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).
  12. 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.

Date Dynamic Field Settings

Einstellungen für Dynamisches Feld vom Typ „Datum“

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.

Date / Time Dynamic Field Settings

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

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“

Multiselect Dynamic Field Settings

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.

Text Dynamic Field Settings

Einstellungen für Dynamisches Feld vom Typ „Text“

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

Hier können Sie einen regulären Ausdruck definieren um den Wert zu prüfen. Der RegEx wird mit den Modifikatoren xms ausgeführt. Beispiel:

^[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.

Textarea Dynamic Field Settings

Einstellungen für Dynamisches Feld vom Typ „Textfeld“

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

Hier können Sie einen regulären Ausdruck definieren um den Wert zu prüfen. Der RegEx wird mit den Modifikatoren xms ausgeführt. Beispiel:

^[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“

Bemerkung

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

Dynamische Felder auf Ansichten anzeigen

So zeigen Sie Dynamische Felder auf Ansichten an:

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

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.

  1. Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
  2. Navigieren Sie zu CoreEventTicket und suchen Sie nach der Einstellung Ticket::EventModulePost###9600-TicketDynamicFieldDefault.
  3. Klicken Sie auf die „Diese Einstellung bearbeiten“-Schaltfläche, um diese Einstellung zu aktivieren.
  4. Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
  5. Nehmen Sie die geänderte Systemkonfiguration in Betrieb.
Activate Ticket Event Module

Ticket-Event-Modul aktivieren

Beispiel: Field1 im TicketCreate-Event aktivieren:

  1. Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
  2. Navigieren Sie zu CoreEventDynamicFieldDefault und suchen Sie nach der Einstellung Ticket::EventModulePost###9600-TicketDynamicFieldDefault.
  3. Klicken Sie auf die „Diese Einstellung bearbeiten“-Schaltfläche, um diese Einstellung zu aktivieren.
  4. Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
  5. Nehmen Sie die geänderte Systemkonfiguration in Betrieb.
Activate Dynamic Field in Ticket Create Event

Dynamisches Feld im TicketCreate-Event aktivieren

Bemerkung

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

Siehe auch

Werden mehr als 16 Felder benötigt, müssen Sie sich eine eigene XML erstellen und diese im Verzeichnis $OTOBO_HOME/Kernel/Config/files ablegen, um dieses Feature zu erweitern.

Setzen eines Standardwertes via Benutzereinstellungen

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

  1. Öffnen Sie das Modul Systemkonfiguration im Admin-Interface.
  2. Navigieren Sie zu FrontendAgentViewPreferences und suchen Sie nach der Einstellung PreferencesGroups###DynamicField.
  3. Klicken Sie auf die „Diese Einstellung bearbeiten“-Schaltfläche, um diese Einstellung zu aktivieren.
  4. Klicken Sie auf die Schaltfläche mit dem grünen Haken, um diese Einstellung zu speichern.
  5. Nehmen Sie die geänderte Systemkonfiguration in Betrieb.
Activate Dynamic Field in Personal Preferences

Dynamisches Feld in Persönlichen Einstellungen aktivieren

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

Dynamic Field in Personal Preferences

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

Wenn mehrere Einstellungen in einer neuen XML-Datei hinzugefügt werden, muss jeder Feldname eindeutig und ein anderer als in „PreferencesGroups###DynamicField“ sein. Zum Beispiel:

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