Copyright ©
Mindbreeze GmbH, A-4020 Linz, 2020.
Alle Rechte vorbehalten. Alle Hard- und Softwarenamen sind Handelsnamen und/oder Warenzeichen ihrer jeweiligen Eigentümer.
Diese Dokumente sind streng vertraulich. Die Lieferung und Präsentation dieser Dokumente allein begründet keinerlei Rechte an unserer Software, unseren Dienstleistungen und Leistungsergebnissen oder anderen Schutzrechten. Die Offenlegung, Veröffentlichung oder Vervielfältigung ist nicht gestattet.
Aus Gründen der besseren Lesbarkeit wurde auf eine Geschlechterdifferenzierung verzichtet. Im Hinblick auf die Gleichbehandlung gelten für beide Geschlechter geeignete Begriffe.
Dieses Dokument beschreibt die Integration von Mindbreeze InSpire-Suchanwendungen in Microsoft SharePoint Online.
Die in diesem Dokument enthaltenen Beschreibungen und Anweisungen basieren auf Microsoft SharePoint Online.
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.
Kopieren Sie das Snippet aus dem Mindbreeze InSpire Designer in ein Textdokument. Klicken Sie hier für weitere Informationen: Entwicklung von Suchanwendungen.
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.
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
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:
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">
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?”:
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.
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