Importieren und Exportieren angepasster Suchkonfigurationseinstellungen

Als globaler Administrator oder SharePoint-Administrator in Microsoft 365 können Sie benutzerdefinierte Suchkonfigurationseinstellungen zwischen Mandanten, Websitesammlungen und Websites exportieren und importieren. Die Einstellungen, die Sie exportieren und importieren, umfassen alle benutzerdefinierten Abfrageregeln, Ergebnisquellen, Ergebnistypen, Bewertungsmodelle und Websitesucheinstellungen. Es ist auch möglich, benutzerdefinierte Suchkonfigurationseinstellungen aus einer Suchdienst-Anwendung zu exportieren und die Einstellungen in Mandanten, Websitesammlungen oder Websites zu importieren. Sie können die Standardkonfigurationseinstellungen nicht exportieren.

Übersicht

Wenn Sie benutzerdefinierte Suchkonfigurationseinstellungen exportieren, erstellt SharePoint eine Suchkonfigurationsdatei im XML-Format. Diese Suchkonfigurationsdatei enthält alle exportierbaren benutzerdefinierten Suchkonfigurationseinstellungen auf der Mandanten-, Websitesammlungs- oder Websiteebene, von der aus Sie mit dem Export beginnen. Eine Suchkonfigurationsdatei für eine Websitesammlung enthält keine Suchkonfigurationseinstellungen der einzelnen Websites innerhalb der Websitesammlung.

Wenn Sie eine Suchkonfigurationsdatei importieren, erstellt und aktiviert SharePoint jede benutzerdefinierte Suchkonfigurationseinstellung in dem Mandanten, der Websitesammlung oder der Website, von der aus Sie den Import starten.

In dieser Tabelle sind die Einstellungen aufgeführt, die Sie exportieren oder importieren können. Für jede Einstellung finden Sie Abhängigkeiten von anderen benutzerdefinierten Suchkonfigurationseinstellungen. Wenn die benutzerdefinierten Suchkonfigurationseinstellungen von einer angepassten Suchkonfigurationseinstellung auf einer anderen Ebene abhängig sind, z. B. wenn eine Websiteabfrageregel von einer Ergebnisquelle auf Websitesammlungsebene abhängt, müssen Sie Einstellungen auf allen relevanten Ebenen exportieren und importieren.

Bedingungen, die dazu führen können, dass der Import fehlschlägt

Wenn die Suchkonfigurationsdatei und das Importziel Einstellungen mit dem gleichen Namen aufweisen, schlägt der Import der Suchkonfigurationsdatei fehl, wenn diese Einstellung angetroffen wird. Es gibt jedoch Ausnahmen:

• Wenn Sie eine Suchkonfigurationsdatei erneut importieren, führen die Einstellungen, die in der Suchkonfigurationsdatei und im Ziel den gleichen Namen aufweisen, nicht zu einem Importfehler.

• Verwaltete Eigenschaften mit dem gleichen Namen führen nicht zu einem Importfehler, wenn die Einstellungen der einzelnen verwalteten Eigenschaften mit den Einstellungen in der Suchkonfigurationsdatei und im Ziel übereinstimmen.

• Verwaltete Eigenschaften mit dem gleichen Namen führen nicht zu einem Importfehler, wenn die Aliase und Zuordnungen zu durchforsteten Eigenschaften in der verwalteten Eigenschaft in der Suchkonfigurationsdatei und im Ziel unterschiedlich sind. Der Import fügt die Aliase und Zuordnungen in der verwalteten Eigenschaft in der Suchkonfigurationsdatei den Aliasen und Zuordnungen in der verwalteten Eigenschaft des Ziels hinzu.

Wenn die Suchkonfigurationsdatei Namen verwalteter Eigenschaften oder Aliase enthält, die ungültige Zeichen enthalten, schlägt der Import fehl, sobald der Name dieser verwalteten Eigenschaft oder dieses Alias angetroffen wird.

Die Namen verwalteter Eigenschaften oder Aliase eines Suchschemas müssen für eine Website und die übergeordnete Websitesammlung eindeutig sein. Das heißt:

• Wenn Ihre Suchkonfigurationsdatei eine verwaltete Eigenschaft enthält, die den gleichen Namen wie ein Alias für eine verwaltete Eigenschaft auf Ihrer Zielwebsite oder in der übergeordneten Websitesammlung Ihrer Zielwebsite aufweist, schlägt der Import fehl.

• Wenn Ihre Suchkonfigurationsdatei eine verwaltete Eigenschaft mit einem Alias enthält, die den gleichen Namen wie eine verwaltete Eigenschaft auf Ihrer Zielwebsite oder in der übergeordneten Websitesammlung Ihrer Zielwebsite aufweist, schlägt der Import fehl.

Wenn der Import fehlschlägt, sollten Sie die Bedingung entfernen, die zum Fehler führte, und die Suchkonfigurationsdatei erneut importieren. Wenn z. B. in der Spalte Notes steht, dass bereits eine Abfrageregel mit dem gleichen Namen wie die Abfrageregel, die Sie zu importieren versuchen, vorhanden ist, sollten Sie diese Abfrageregel im Ziel oder in der Importdatei löschen, und die Datei dann erneut importieren. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Ungültige Zeichen, die dazu führen, dass der Import fehlschlägt .

Exportieren benutzerdefinierter Suchkonfigurationseinstellungen aus einem Mandanten

1. Wechseln Sie zu Weitere Features im SharePoint Admin Center, und melden Sie sich mit einem Konto an, das über Administratorberechtigungen für Ihre Organisation verfügt.

2. Wählen Sie unter Suchen die Option Öffnen aus.

3. Wählen Sie Suchkonfiguration exportieren aus.

4. Wählen Sie im Dialogfeld Speichern aus.

Exportieren benutzerdefinierter Suchkonfigurationseinstellungen aus einer Website

1. Wählen Sie auf der Website Einstellungen Einstellungen und dann Websiteeinstellungen aus. Wenn Websiteeinstellungen nicht angezeigt werden, wählen Sie Websiteinformationen und dann Alle Websiteeinstellungen anzeigen aus.

2. Wählen Sie auf der Seite Websiteeinstellungen im Abschnitt Suchen die Option Konfigurationsexport aus.

3. Wählen Sie im Dialogfeld Speichern aus.

Exportieren benutzerdefinierter Suchkonfigurationseinstellungen aus einer Websitesammlung

1. Wählen Sie auf der Website Einstellungen Einstellungen und dann Websiteeinstellungen aus. Wenn Websiteeinstellungen nicht angezeigt werden, wählen Sie Websiteinformationen und dann Alle Websiteeinstellungen anzeigen aus.

2. Wählen Sie auf der Seite Websiteeinstellungen im Abschnitt Websitesammlungsverwaltung die Option Suchkonfiguration Exportieren aus.

3. Wählen Sie im Dialogfeld Speichern aus.

Importieren benutzerdefinierter Suchkonfigurationseinstellungen in einen Mandanten

1. Wechseln Sie zu Weitere Features im SharePoint Admin Center, und melden Sie sich mit einem Konto an, das über Administratorberechtigungen für Ihre Organisation verfügt.

2. Wählen Sie unter Suchen die Option Öffnen aus.

3. Navigieren Sie auf der Seite Suchkonfiguration importieren zu der Datei, die Sie importieren möchten.

4. Wählen Sie Importieren aus.

5. Überprüfen Sie auf der Seite Suchkonfigurationsliste Folgendes:

6. Die von Ihnen importierte Suchkonfigurationsdatei ist in der Liste enthalten, und der Status der Suchkonfigurationsdatei lautet Erfolgreich importiert.

   Wenn die Datei nicht erfolgreich importiert wurde, enthält die Spalte Notizen weitere Details dazu, was passiert ist.

7. Die Spalte Bereich zeigt, dass sich die importierten Einstellungen auf der richtigen Ebene befinden, d. h. auf der Ebene, in die Sie die Datei importieren möchten. Wenn Sie ihre Einstellungen beispielsweise auf Websitesammlungsebene und nicht auf Websiteebene importiert haben, werden diese Informationen in der Spalte Bereich angezeigt. In der Spalte Bereich wird angezeigt, auf welcher Ebene die Suchkonfigurationseinstellungen aktiviert wurden. Die Ebenen sind: Mandant (Mandant), Websitesammlung (SPSite) oder Websiteebene (SPWeb).

Importieren benutzerdefinierter Suchkonfigurationseinstellungen in eine Website

1. Wählen Sie auf der Website Einstellungen Einstellungen und dann Websiteeinstellungen aus. Wenn Websiteeinstellungen nicht angezeigt werden, wählen Sie Websiteinformationen und dann Alle Websiteeinstellungen anzeigen aus.

2. Wählen Sie auf der Seite Websiteeinstellungen im Abschnitt Suchen die Option Konfigurationsimport aus.

3. Navigieren Sie auf der Seite Suchkonfiguration importieren zu der Datei, die Sie importieren möchten.

4. Wählen Sie Importieren aus.

5. Überprüfen Sie auf der Seite Suchkonfigurationsliste Folgendes:

6. Die von Ihnen importierte Suchkonfigurationsdatei ist in der Liste enthalten, und der Status der Suchkonfigurationsdatei lautet Erfolgreich importiert.

   Wenn die Datei nicht erfolgreich importiert wurde, enthält die Spalte Notizen weitere Details dazu, was passiert ist.

7. Die Spalte Bereich zeigt, dass sich die importierten Einstellungen auf der richtigen Ebene befinden, d. h. auf der Ebene, in die Sie die Datei importieren möchten. Wenn Sie ihre Einstellungen beispielsweise auf Websitesammlungsebene und nicht auf Websiteebene importiert haben, werden diese Informationen in der Spalte Bereich angezeigt. In der Spalte Bereich wird angezeigt, auf welcher Ebene die Suchkonfigurationseinstellungen aktiviert wurden. Die Ebenen sind: Mandant (Mandant), Websitesammlung (SPSite) oder Websiteebene (SPWeb).

Importieren benutzerdefinierter Suchkonfigurationseinstellungen in eine Websitesammlung

1. Wählen Sie auf der Website Einstellungen Einstellungen und dann Websiteeinstellungen aus. Wenn Websiteeinstellungen nicht angezeigt werden, wählen Sie Websiteinformationen und dann Alle Websiteeinstellungen anzeigen aus.

2. Wählen Sie auf der Seite Websiteeinstellungen im Abschnitt Websitesammlungsverwaltung die Option Suchkonfiguration importieren aus.

3. Navigieren Sie auf der Seite Suchkonfiguration importieren zu der Datei, die Sie importieren möchten.

4. Wählen Sie Importieren aus.

5. Überprüfen Sie auf der Seite Suchkonfigurationsliste Folgendes:

6. Die importierte Suchkonfigurationsdatei befindet sich in der Liste, und die status ist Erfolgreich importiert.

   Wenn die Datei nicht erfolgreich importiert wurde, enthält die Spalte Notizen weitere Details dazu, was passiert ist.

7. Die Spalte Bereich zeigt, dass sich die importierten Einstellungen auf der richtigen Ebene befinden, d. h. auf der Ebene, in die Sie die Datei importieren möchten. Wenn Sie ihre Einstellungen beispielsweise auf Websitesammlungsebene und nicht auf Websiteebene importiert haben, werden diese Informationen in der Spalte Bereich angezeigt. In der Spalte Bereich wird angezeigt, auf welcher Ebene die Suchkonfigurationseinstellungen aktiviert wurden. Die Ebenen sind: Mandant (Mandant), Websitesammlung (SPSite) oder Websiteebene (SPWeb).

Ungültige Zeichen, die dazu führen, dass der Import fehlschlägt

Wenn verwaltete Eigenschaften oder Aliase eines der aufgeführten Zeichen enthalten, schlägt der Import des benutzerdefinierten Suchschemas fehl, das diese Eigenschaften enthält.

Bekanntes Problem

Die Suchkonfigurationsliste kann nicht geladen werden.

Wenn Sie Suchkonfigurationsdateien in die Seite mit den Einstellungen für die Mandantenadministratorsucheinstellungen importieren, tritt möglicherweise ein Problem auf, bei dem die Suchkonfigurationsliste nicht ordnungsgemäß angezeigt werden konnte, und sie erhalten möglicherweise den Fehler "Datei nicht gefunden".

Dieses Problem verhindert nur, dass die Benutzeroberfläche die Liste der importierten Suchkonfigurationsdateien anzeigt, und die Importfunktion wird nicht unterbrochen. Ihre Suchkonfiguration wird ordnungsgemäß importiert.

Da Sie die status der Suchkonfigurationsdatei, die Sie aus der Benutzeroberfläche importiert haben, nicht überprüfen können, können Sie eine alternative Möglichkeit für den Zugriff auf die Liste auswählen, z. B. die SharePoint CSOM-API oder die SharePoint Online-REST-API.

Veraltete XML-Suchkonfigurationsdatei kann nicht importiert werden

Wenn die Suchkonfigurationsdatei vor langer Zeit exportiert wurde, schlägt der Import möglicherweise fehl.

Wenn die exportierte Suchkonfigurationsdatei veraltet ist, sollten Sie zuerst eine neue Suchkonfiguration exportieren und diese dann verwenden, um die Liste der Suchkonfigurationsdateien zu importieren.