API: Reihenfolge der Suchergebnisse anpassen

Du kannst die Haiilo-API verwenden, um die Reihenfolge der Suchergebnisse nach Inhaltstyp in der globalen Suche zu ändern. Du benötigst die Berechtigung "Verwaltung der globalen Suche", um die Sucheinstellungen anzupassen.

Um Anfragen an die Haiilo-API zu stellen, musst du dich zuerst authentifizieren. Detaillierte Informationen zur Authentifizierung und Verwendung der API findest du hier.

Alle Sucheinstellungen auflisten

  1. Stelle eine GET-Anfrage an den Endpunkt /web/global-search/settings, um eine Liste aller Sucheinstellungen zu erhalten

Die Antwort sollte ähnlich wie folgt aussehen:

 {
    "settings": {
        "feedbackToolActivation": {
            "value": true,
            "stringValue": "true",
            "readOnly": true
        },
        "typeOrder": {
            "value": [
                "sharepoint",
                "drive",
                "file",
                "blog_article",
                "wiki_article",
                "user",
                "page",
                "comment",
                "timeline_item",
                "app",
                "workspace",
                "event",
                "forum",
                "list-entry",
                "message"
            ],
            "stringValue": "[sharepoint, drive, file, blog_article, wiki_article, user, page, comment, timeline_item, app, workspace, event, forum, list-entry, message]",
            "readOnly": false
        }
    }
}

Reihenfolge der Suchergebnisse aktualisieren

  1. Kopiere die gesamte Einstellungsgruppe, beginnend von der ersten { bis zur letzten } für diese Gruppe. Z.B.,
    {
       "value": [
           "sharepoint",
           "drive",
           "file",
           "blog_article",
           "wiki_article",
           "user",
           "page",
           "comment",
           "timeline_item",
           "app",
           "workspace",
           "event",
           "forum",
           "list-entry",
           "message"
       ]
    }
  2. Füge die gesamte kopierte Einstellungsgruppe in den Anfrage-Body ein. Wenn Du nicht alle Inhaltsarten einschließt, werden die nicht definierten Typen am Ende der Suchergebnisse in alphabetischer Reihenfolge angezeigt.
  3. Nimm die gewünschten Änderungen an der Reihenfolge der Suchergebnisse vor, indem Du die Werte in der Liste verschiebst. Einstellungsgruppen, die mit "readOnly": true markiert sind, können nicht geändert werden.
    • In unserem Beispiel verschieben wir Timeline-Beiträge, Blog-Artikel und Wiki-Artikel nach oben, damit Ergebnisse dieser Typen zuerst in der globalen Suche angezeigt werden.
      {
         "value": [
             "timeline_item",
             "blog_article",
             "wiki_article",
             "sharepoint",
             "drive",
             "file",
             "user",
             "page",
             "comment",
             "app",
             "workspace",
             "event",
             "forum",
             "list-entry",
             "message"
         ]
      }
  4. Stelle eine POST-Anfrage an den Endpunkt /web/global-search/settings/<name_of_setting>, wobei <name_of_setting> der Name der Einstellungsgruppe ist, z.B. typeOrder.

War dieser Beitrag hilfreich?