Mindbreeze InSpire Suchanwendungen in Microsoft SharePoint Online

Einführung

Dieses Dokument beschreibt die Integration von Mindbreeze InSpire-Suchanwendungen in Microsoft SharePoint Online.

Software-Voraussetzungen

Die in diesem Dokument enthaltenen Beschreibungen und Anweisungen basieren auf Microsoft SharePoint Online.

Einbetten einer Suchanwendung

Suchanwendungen werden als Textdokumente in Microsoft SharePoint gespeichert und in Seiten mit dem „Content Editor“ Web Part eingebettet. So kann eine Suchanwendung auf mehreren Seiten genutzt werden und bleibt dennoch einfach zu pflegen.

Speichern einer Suchanwendung in einem Textdokument

Kopieren Sie das Snippet aus dem Mindbreeze InSpire Designer in ein Textdokument. Klicken Sie hier für weitere Informationen: Entwicklung von Suchanwendungen.

Hochladen des Textdokuments

Laden Sie das Dokument in eine Dokumentenbibliothek hoch:

Hinweis: Ändern Sie die Suchanwendung (in searchapp.txt) so, dass sie den folgenden hervorgehobenen Text enthält, um die Query-Parameter von Microsoft SharePoint zu verwenden:

new Application({ queryURLParameter: "k" });

Kopieren Sie die Adresse des Dokuments in die Zwischenablage:

Hinweis: Der obige Link ist die URL der Dokumentvorschau-Seite.

Ändern Sie die URL folgendermaßen und kopieren Sie sie:

        https://<your-tenant>.sharepoint.com/sites/<your-site>/Shared%20Documents/searchapp.txt

Hinweis: Ersetzen Sie die Klammern durch Ihren Tenant- und Site-Namen. Kopieren Sie die angepasste URL in einen neuen Browser-Tab und stellen Sie sicher, dass sie funktioniert.

Erstellen einer neuen Webpart-Seite

Navigieren Sie zu "Site Contents" > "Site Pages":

Erstellen Sie eine neue "Web Part Page":

Wählen Sie einen Namen und ein Design. Erstellen Sie die Seite:

Fügen Sie ein neues "Content Editor" Web Part hinzu:

Anmerkung: Das Webpart “Content Editor” wird für “modern pages” oder “modern sites” nicht unterstützt: Offizielle Microsoft Dokumentation

Bearbeiten Sie die Webpart-Einstellungen:

Geben Sie die Adresse (angepasste URL) des Textdokuments in "Content Link" ein und klicken Sie dann auf "Apply":

Klicken Sie auf " Stop Editing", um die Bearbeitung einer Seite abzuschließen: Klicken

(Modern Site) Script Editor Web Part

Um die Suchergebnisse auf eine „Modern Site“ umzuleiten, müssen Sie einen Skript Editor Web Part hinzufügen und konfigurieren. Bitte folgen Sie diesen Schritten:

1. Laden Sie MicrosoftSharePointOnline-ModernScriptEditor-<xx.x.x.xxx>.sppkg vom Mindbreeze Update Center herunter.
2. Gehen Sie zum App-Katalog Ihres Tenants: https://<tenant>.sharepoint.com/sites/AppCatalog/AppCatalog
3. Wählen Sie aus dem linken Menü die Bibliothek „Apps for SharePoint“. Laden Sie dann das sppkg hoch oder ziehen Sie es per Drag & Drop rein.
   
   
4. Klicken Sie im Popup-Fenster auf „Deploy“.
   
   
5. Stellen Sie sicher, dass das Paket fehlerfrei deployed wurde.
   
   
6. Installieren Sie die „App“ auf Ihrer Modern Site:
   1. Von der „Home“-Seite: Klicken Sie auf „+New“ > „App“.
      
      
   2. Klicken Sie im Abschnitt „Apps you can add“ auf „Modern Script Editor web part“, um sie zu installieren.
      
      
      Hinweis: Bitte warten Sie eine Minute, bis die App installiert und in der Liste "Site Contents" nicht mehr ausgegraut ist. Möglicherweise müssen Sie die Seite aktualisieren, falls der Eintrag noch immer noch ausgegraut ist.
      
      
7. Erstellen Sie eine neue Ergebnisseite auf der „Home“-Page der Website.
   
   
   1. Erstellen Sie eine „Blank“ Seite und klicken Sie auf „Create page“.
      
      
   2. Wählen Sie einen Namen für Ihre Seite und klicken Sie auf „Publish“.
      
      
8. Bearbeiten Sie die Seite, um den Script Editor Web Part hinzuzufügen.
   1. Klicken Sie oben rechts auf der Seite auf " Edit ". Klicken Sie dann auf das Plus-Symbol, um einen neuen Web Part hinzuzufügen.
      
      
   2. Geben Sie „script“ in das Suchfeld ein und wählen Sie „Modern Script Editor“ aus.
      
      
   3. Klicken Sie auf „Edit Markup“. Das Konfigurationsfenster wird geöffnet. Klicken Sie auf „Edit HTML code”.
      1. Kopieren Sie den Inhalt Ihrer searchapp und fügen Sie ihn in den Code-Editor ein.
      2. Folgen Sie den unten beschriebenen Schritten aus „Wichtige erforderlich Änderungen“.
      3. Klicken Sie auf „Save“.
         
         
   4. Klicken Sie auf „Republish“, um die Änderungen wirksam zu machen.

Wichtige erforderliche Änderungen:

Nehmen Sie zunächst den Query-Parameter von Microsoft SharePoint Online in das Application Objekt (im Code-Snippet) auf und exportieren Sie sie in das window Objekt. Dies kann durch Hinzufügen des unten hervorgehobenen Codes erfolgen:

<script>Mindbreeze.require(["client/application"], function(Application) {  

   window.appmb = new Application({

rootEL: document.getElementById("mb-custom-searchapp-wrapper"),

queryURLParameter: "k"

   });

});

</script>

Horchenchen sie zusätzlich auf das Microsoft-Suchfeld mittels "OnSubmitSearch" und leiten Sie die Suchanfragen wie unten gezeigt um:

<script>Mindbreeze.require(["client/application"], function(Application) {

    window.appmb = new Application({

        rootEl: document.getElementById("mysearchapp"),

        queryURLParameter: "k"

    });

});

        window.O365Shell.Search.OnSubmitSearch(function(query) {

           window.appmb.setUnparsedUserQuery(query);

        });

</script>

Um schließlich die CSS-Konflikte zwischen SharePoint Online und Mindbreeze aufzulösen, müssen Sie den <link> oben im Snippet der Suchanwendung auf das minimal-prefixed-adapted.css verweisen:

<link href="https://<your-inspire>/apps/designer/../css/v2/minimal-prefixed-adapted.css" rel="stylesheet">

Ändern der Suchergebnisseite

Klicken Sie auf das Zahnradsymbol „Site Contents“

Klicken Sie auf „Site Settings“

Gehen Sie zum Suchabschnitt und klicken Sie dann auf den Link „Search Settings”

Navigieren Sie zur Konfigurationsseite der „Search Settings“.

Unter “Which search results page should queries be sent to?”:

• Wählen Sie den Auswahlknopf „Send queries to a custom results page URL“
• Geben Sie die benutzerdefinierte Suchergebnisseite in “Result Page URL” an

Klicken Sie auf die Schaltfläche OK und warten Sie dann eine Minute, um die betroffenen Änderungen zu erhalten.

Suchen Sie nun etwas im oberen Suchfeld und drücken Sie Enter - Sie sollten auf die konfigurierte Ergebnisseite weitergeleitet werden.

Troubleshooting

Cross-origin resource sharing (CORS)

Aus Sicherheitsgründen schränken Browser Cross-Origin-HTTP-Anfragen von Skripts ein. Wenn Sie in diesem Fall https://{mytenant}.sharepoint.com in einem Browser öffnen, wird ein Skript vom Webserver Ihrer Appliance geladen. Dieses Skript initiiert dann XHR-Anfragen an Ihre Appliance, was nach den CORS-Richtlinien standardmäßig nicht zulässig ist. Um Anfragen von Ihrem SharePoint-Tenant an Ihre Appliance zuzulassen, müssen Sie Ihren SharePoint-Tenant in den Allowed Origins der CORS-Einstellungen auf Ihrer Appliance hinzufügen. Konfigurieren Sie die folgenden Einstellungen im Mindbreeze Management Center:

Configuration > Client Services > Advanced Settings