Suchkonfiguration im SharePoint-Add-In-Modell

Wichtig

SharePoint-Add-Ins haben am 2. April 2026 das Ende der Lebensdauer in SharePoint Online erreicht. Sowohl von SharePoint als auch vom Anbieter gehostete Add-Ins werden eingestellt und funktionieren nicht mehr in SharePoint Online, einschließlich Government-Clouds. Die Hinweise zu Add-Ins-Entwicklung, -Bereitstellung und -Verwendung werden als historische Referenz und für anwendbare SharePoint Server-Szenarien beibehalten, nicht für neue SharePoint Online-Lösungen.

SharePoint Server-Add-Ins, die über einen lokalen App-Katalog bereitgestellt werden, werden durch diese Änderung nicht zurückgezogen. Der Erwerb von SharePoint-Add-Ins aus dem öffentlichen Marketplace endete am 2. April 2026 für SharePoint Server.

Mit dieser Einstellung werden SharePoint-REST-APIs, CSOM, JSOM oder SharePoint-Framework (SPFx) nicht außer Betrieb genommen. Verwenden Sie für SharePoint Online SPFx für Benutzeroberflächenerweiterungen und Microsoft Entra ID für die Authentifizierung bei externen Anwendungen. Weitere Informationen finden Sie in der Ankündigung der Einstellung und in der Anleitung zur Add-In-Migration.

Der Ansatz, den Sie zum Konfigurieren der Suche wählen, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem mit voll vertrauenswürdigem Code. In einem typischen Szenario mit Full Trust Code (FTC)/Farmlösung wurde das SharePoint Server-seitige Objektmodell zum Konfigurieren der Suche verwendet und über SharePoint-Lösungen bereitgestellt.

In einem Szenario mit SharePoint-Add-In-Modell verwenden Sie das clientseitige SharePoint-Objektmodell (CSOM) oder die REST-API, um die Suche zu konfigurieren. Dieses Muster wird häufig als Remotebereitstellungsmuster bezeichnet.

Richtlinien auf hoher Ebene

Als Faustregel möchten wir die folgenden allgemeinen Richtlinien zum Konfigurieren der Suche im neuen SharePoint-Add-In-Modell bereitstellen.

  • Verwenden Sie die API für clientseitiges Objektmodell (Clientseitiges Objektmodell) von SharePoint, um die Suche nach Möglichkeit durch Importieren und Exportieren von Suchkonfigurationseinstellungen zu konfigurieren.
  • Nicht alle Suchkonfigurationseinstellungen sind derzeit über die SharePoint CSOM-API verfügbar.
  • Die SharePoint-REST-API kann (derzeit) keine Suchkonfigurationseinstellungen importieren oder exportieren.

Erste Schritte

Das folgende Beispiel zeigt das Importieren und Exportieren von Sucheinstellungen zwischen SharePoint-Mandanten, Websitesammlungen und Websites.

PnP-Beispiele

Gilt für

  • Office 365 mit mehreren Mandanten (MT)
  • Office 365 dediziert (D)
  • SharePoint 2013 lokal