Instanzoptionen für Filteraspekt-Widget konfigurieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer
  • Konfigurieren Sie Widget-Instanzoptionen für die Filteraspekt-Widgets auf der Seite mit den Suchergebnissen des Serviceportals Wissensmanagement.

    Vorbereitungen

    Erforderliche Rolle: sp_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die Homepage verwendet mehrere Widgets, um die Elemente in der Suchergebnisliste zu filtern. Es gibt zwei Arten von Aspekt-Widgets:
    • Einfache Feldaspekte, die auf den Wissenstabellenfeldern basieren
    • Erweiterte Abfrageaspekte auf Grundlage benutzerdefinierter Abfragen der Wissenstabelle
    Verwenden Sie die Widget-Instanzoptionen, um diese Aspekt-Widgets zu konfigurieren:
    • Wissensfeldaspekt (zum Filtern nach Knowledge Base, Wissenskategorie und Autor)
    • Wissens-Tag-Aspekt (zum Filtern nach Tags)
    • Wissensressourcenaspekt (zum Filtern nach Ressource, z. B. Artikel)
    • Wissensabfrageaspekt (zum Filtern nach Bewertung, letzter Änderung und Anzahl der Aufrufe)
      Hinweis:
      Abfrageaspekte werden angezeigt, wenn der Seite mindestens ein Wissensfeldaspekt hinzugefügt wird.

    Verwenden Sie das standardmäßige Widget „Wissenssprache“, um Sprachfilter in die Suchergebnisseite des Wissens aufzunehmen. Um ein anwenderdefiniertes Sprach-Widget hinzuzufügen, müssen Sie das Widget „Wissenssprache“ auf der Seite „Wissenssuchergebnis“ deaktivieren.

    Prozedur

    1. Navigieren Sie zur Seite der Suchergebnisse des Knowledge Management Service Portals.
    2. Drücken Sie strg und klicken Sie mit der rechten Maustaste auf ein Filteraspekt-Widget.
    3. Klicken Sie auf Instanzoptionen.
    4. Konfigurieren Sie die gewünschten Einstellungen für den ausgewählten Aspekt-Widget-Typ.
      Instanzoption Beschreibung
      Titel Titel des Filteraspekt-Widgets
      Glyphe Symbol, das links neben dem Titel angezeigt wird.
      Auftrag Reihenfolge, in der die Filteraspekt-Widgets auf der linken Seite der Suchergebnisseite angezeigt werden. Wenn leer, werden die Filteraspekt-Widgets alphabetisch sortiert.
      Bootstrap-Farbe Farbe des Headers des Filteraspekt-Widgets.
      CSS Anwenderdefinierte Konfigurationen, die das Erscheinungsbild der Elemente im Widget bestimmen. Weitere Informationen finden Sie unter Serviceportal-SCSS-Primer.
      Quelltabelle Tabelle, die das Quellfeld enthält, das zum Bereitstellen der Optionen des Filteraspekt-Widgets verwendet wird. Die Standardtabelle ist Knowledge (kb_knowledge).
      Quellfeld Feld in der Quelltabelle, das die Optionen für das Filteraspekt-Widget bereitstellt. Zu den Feldtypen, die als Quellfeld verwendet werden können, gehören Zeichenfolge, Glide-Liste, Ganzzahl, Referenz und boolescher Wert.
      Aspekt-Identifier Eindeutiger Name für den anwenderdefinierten Abfrageaspekt, der im Skriptcode verwendet werden kann.
      Aspektvorlage Vorlage, die den Typ der Aspektinteraktion bestimmt.
      Vorlagen für Aspekt-Widget für Wissensfelder:
      • Einzelauswahl: Benutzer können nur einen Filter aus diesem Widget auswählen.
      • Mehrfachauswahl: Benutzer können mehr als einen Filter aus diesem Widget auswählen.
      • Dropdown-Auswahl: Anwender können mehr als einen Filter aus einem Dropdown-Menü auswählen.
      Vorlagen für Abfrageaspekt-Widget für Knowledge
      • Einfache Abfrage: zeigt eine Bezeichnung für jeden Aspektwert.
      • Bewertung: zeigt Bewertungssterne.
      Benutzerdefinierte Vorlage Anwenderdefinierte Vorlage, die die Aspektinteraktion und die Wertauswahl bestimmt.
      Aspektoptionen Anwenderdefinierte Abfrage im JSON-Format für Bezeichnung, ID, Reihenfolge und Abfrage für jeden Aspektwert. Enthält die Tabelle, den Wert (kodierte Abfrage) und den Anzeigewert (kodierte Abfrage).
      Anordnen nach Reihenfolge der Filteroptionen im Aspekt-Widget. Die Standardreihenfolge ist Bezeichnung, bei der die Optionen in alphabetischer Reihenfolge sortiert werden. Für Referenzfelder können Sie auch einen Auftrag aus der Referenzfeldtabelle angeben.
      Minimale Anzahl von Ergebnissen für die Anzeige der Filtersuchleiste Mindestanzahl von Ergebnissen, die erforderlich sind, um eine Suchleiste oben im Filteraspekt-Widget anzuzeigen.
      Minimale Anzahl von Ergebnissen für die Anzeige des Scrollbalkens Mindestanzahl von Ergebnissen, die erforderlich sind, um eine Bildlaufleiste im Filteraspekt-Widget anzuzeigen.
      Maximale Länge für das Feld Zeichenfolge Maximale Feldlänge. Nur Felder, deren Länge kleiner als dieser Wert ist, dürfen als Filteraspekt hinzugefügt werden.
      Alternative URL-Parameter Namen der URL-Parameter, die zum Initialisieren dieses Filteraspekts verwendet werden, wenn sie in der URL als Suchparameter verwendet werden.
      Höchstwerte abrufen

      Option zum Abrufen von Filterwerten aus allen Wissensartikeln in den Suchergebnissen.

      Die Auswahl der Option „Höchstwerte abrufen“ kann sich auf die Ladezeit für Suchergebnisse auswirken. Wenn diese Option deaktiviert ist, verbessert sich die Ladezeit basierend auf dem Eigenschaftswert glide.knowman.search.facet_depth.

      Wenn die Eigenschaft glide.knowman.search.apply_acls auf „true“ festgelegt ist, kann ein Filterwert in einem Filteraspekt angezeigt werden, auch wenn für diesen Filterwert keine Suchergebnisse vorhanden sind. Beispielsweise kann eine Knowledge Base ohne Artikel als Wert im Knowledge Base-Filteraspekt angezeigt werden.

      Leeren Wert anzeigen Wenn dies aktiviert ist, wird eine leere Filteraspektoption angezeigt, die Benutzer zum Filtern nach Artikeln auswählen können, für die dieses Feld nicht festgelegt ist.

      Wenn einem Artikel beispielsweise keine Kategorie zugeordnet ist, werden durch Klicken auf die leere Option alle Artikel aufgelistet, denen keine Kategorie zugewiesen ist.

      Nur übereinstimmende Ergebnisse der Aspektwerte anzeigen Erstellt ein dynamisches Filteraspekt-Widget, das nur die Filterwerte anzeigt, die mit den Suchergebnissen übereinstimmen, und nicht alle Werte. Wenn Sie diese Instanzoption deaktivieren, wird die zum Laden der Filteraspektdaten erforderliche Zeit reduziert.
      Kategoriehierarchie anzeigen (nur gültig für kb_category) Wenn diese Option aktiviert ist, werden Kategorien mit ihrer Hierarchieliste bis zur vierten Ebene angezeigt. Wenn Sie diese Option aktivieren, können Sie jeweils nur eine Kategorie auswählen. Alle Artikel, die in den Unterkategorien jenseits der vierten Ebene enthalten sind, werden auch in der vierten Ebene der Kategorie angezeigt. Die Suchergebnisse, die nach einer ausgewählten übergeordneten Kategorie gefiltert werden, umfassen Artikel innerhalb dieser Kategorie und alle zugehörigen untergeordneten Kategorien.
      Hinweis:
      • Wenn die Anzahl der in Suchergebnissen zurückgegebenen Wissensartikel größer ist als die Suchfacettentiefe, werden alle Kategorien in dieser Facette angezeigt. Daher sind einige in diesem Aspekt angezeigte Kategorien möglicherweise nicht mit Wissensartikeln in den Suchergebnissen verknüpft. Standardmäßig ist die Aspekttiefe auf 300 festgelegt und wird von einem Administrator in der Eigenschaft glide.knowman.search.facet_depth konfiguriert.
      • Um die Seiten-Widgets der Wissenssuche durch Hinzufügen weiterer Filter zu konfigurieren. Insbesondere wenn Filter auf die Sprache angewendet werden müssen, sollte das OOB Knowledge Language Widget verwendet werden. Das Feldaspekt-Widget kann mit dem Sprachfeld in Instanzoptionen für ein ähnliches Verhalten konfiguriert werden. In diesem Fall sollte die Instanz des OOB-Wissens-Sprachwidgets jedoch auf der Seite mit den Wissenssuchergebnissen deaktiviert werden.
    5. Klicken Sie auf Speichern.