Artikel-Meta-Filter für die Dokumentensuche

Mit den Artikel-Metafiltern können Sie eine Konfiguration mit regulären Ausdrücken von Suchkriterien definieren, nach denen Sie in einem Artikel suchen möchten. Die Funktion kann Links bereitstellen, die diese Suchkriterien verwenden, nach denen Sie in einem Artikel gesucht haben. Dies ist ähnlich wie der Meta-Filter für CVE-Nummern, der im OTRS-Framework integriert ist.

Die Idee dieses Features ist es, eine sehr ähnliche Funktion bereitzustellen, wie sie bereits im OTRS-Framework vorhanden ist, aber anstatt nach bestimmten Kriterien im Internet zu suchen oder etwas aus dem Internet anzuzeigen, möchten wir, dass dieser Meta-Filter die Dokumentensuchmaschine nutzt, um nach allem zu suchen, was man in einem Artikel und in anderen Objekten von OTRS wie Tickets, Wissensdatenbank-Artikeln, Terminen oder anderen Business-Objekten suchen möchte.

By default, there are some article meta filters shipped with OTRS. If you search for host names or servers, it creates buttons with links to the document search.

Die Funktion kann mit der Einstellung AgentFrontend::TicketDetailView::ArticleMeta aktiviert werden. Diese Einstellung ist für die Meta-Filter des OTRS-Frameworks erforderlich, aber auch für den Meta-Filter der Dokumentensuche für Artikel.

There are two examples in the AgentFrontend::TicketDetailView::ArticleMetaFilters::DocumentSearch###0001-Framework setting, but all of them are inactive by default. To activate any of them, just change the value of the Active key to 1.

The first example will search for host names, the second example will search for servers. You can see what regular expressions are defined in the RegExp array.

Es gibt eine weitere Einstellung AgentFrontend::TicketDetailView::ArticleMetaFilters::DocumentSearch####0002-Custom, in der Administratoren benutzerdefinierte Metafilter definieren können.

Bemerkung

Es wird nicht empfohlen, die Beispiele zu ändern oder zu erweitern, da die eingebauten Beispiele in der Zukunft geändert werden können. Bitte verwenden Sie die benutzerdefinierte Einstellung, um die eigenen Meta-Filter zu definieren.

Die Vorschaufunktion erfordert eine zusätzliche Einstellung. Der vollqualifizierte Domänenname (FQDN) der STORM-Instanz muss dem Schlüssel frame-src in der Einstellung WebApp::Server::AdditionalOrigins hinzugefügt werden. Andernfalls wird die Vorschau-Funktion nicht funktionieren.

This example will show how to use this feature to search for IP addresses.

To setup the document search article meta filter for IP addresses:

Gehen Sie zur Ansicht Systemkonfiguration.
Search for the setting AgentFrontend::TicketDetailView::ArticleMeta and enable it.
Search for the setting AgentFrontend::TicketDetailView::ArticleMetaFilters::DocumentSearch###0002-Custom.

Fügen Sie der Einstellung eine Regelkonfiguration im YAML-Format hinzu.

- Label: IP Address (DS)
  Name: Example Document Search for IP Address
  Target: _blank
  DocumentSearchString: <MATCH1>
  ShowPreview: 1
  ShowTotal: 1
  LiteralSearch: 0
  RegExp:
  - (\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})
  Active: 1

Um alle Möglichkeiten des Features zu sehen, werden Termine, Wissensdatenbank-Artikel und Tickets benötigt, die in ihren Textfeldern eine IP-Adresse (192.168.0.1 und 255.255.255.0) haben. Für dieses Beispiel:

Erstellen Sie einen Termin mit einer IP-Adresse in der Beschreibung.
Erstellen Sie einen Wissensdatenbank-Artikel mit der gleichen IP-Adresse in den Feldern Symptom oder Problem.
Erstellen Sie mehrere Tickets mit Artikeln, die die gleiche IP-Adresse enthalten.

So suchen Sie nach IP-Adressen:

Erstellen Sie ein neues Ticket.
Füllen Sie die Pflichtfelder aus.
Geben Sie den folgenden Text in den Textkörper ein: Ihre IP-Adresse ist 192.168.0.1 und Ihre Subnetzmaske ist 255.255.255.0.
Gehen Sie zur Ticket-Detailansicht des neu erstellten Tickets.
Erweitern Sie den ersten Artikel im Communication Stream Widget, um die Schaltflächen unter dem Artikel zu sehen.

Die Suchmaschine sucht nach allen möglichen IP-Adressen im Artikel, wie durch den regulären Ausdruck konfiguriert.

Die Schaltflächen verweisen auf die Suchergebnisse einer Dokumentensuche. Es sollten die gleichen Suchergebnisse zurückgegeben werden, wenn ein Agent eine Suche nach den angegebenen IP-Adressen startet. Der Text für die Schaltflächen (IP-Adresse in diesem Beispiel) stammt aus dem Schlüssel Bezeichnungl der zugrunde liegenden Systemkonfigurations-Einstellung.

Wenn die Agenten mit der Maus über eine Schaltfläche fahren, erhalten sie eine Vorschau auf die Ansicht der Suchergebnisse. Wenn sie auf die Schaltflächen klicken, öffnet sich die Ansicht der Suchergebnisse.

Diese Funktion funktioniert für alle Artikel eines Tickets.

Facebook X LinkedIn