Listendefinition/Listenvorlage 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 Erstellen von Listendefinitionen/Listenvorlagen 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 wurden benutzerdefinierte Listendefinitionen/Listenvorlagen mit deklarativem Code erstellt und über SharePoint-Lösungen bereitgestellt.

In einem SharePoint-Add-In-Modellszenario können keine benutzerdefinierten Listendefinitionen erstellt werden. Es ist einfach unmöglich, dies zu tun. Das Remotebereitstellungsmuster kann jedoch zum Bereitstellen benutzerdefinierter Listenvorlagen (STP-Dateien) in Office 365 verwendet werden.

Allgemeine Richtlinien

Als Faustregel möchten wir die folgenden allgemeinen Richtlinien zur Implementierung von Listendefinitionen / Listenvorlagen bereitstellen.

  • Verwenden Sie das Remotebereitstellungsmuster, um Listenvorlagen (STP-Dateien) auf SharePoint-Websites bereitzustellen.
  • Sie können das Standardverhalten bei der Listenerstellung außer Kraft setzen, um standardisierte Einstellungen auf alle Listen anzuwenden, die auf einer SharePoint-Website erstellt wurden. Weitere Informationen zu diesem Ansatz finden Sie weiter unten.
  • Sie können ein SharePoint-Add-In erstellen, um Listen mit standardisierten Einstellungen zu erstellen. Weitere Informationen zu diesem Ansatz finden Sie weiter unten.

Optionen, um sicherzustellen, dass standardisierte Einstellungen (Vorlagen) beim Erstellen von Listen auf SharePoint-Listen angewendet werden

Sie haben eine Reihe von Optionen, um sicherzustellen, dass standardisierte Einstellungen (Vorlagen) beim Erstellen von Listen auf SharePoint-Listen angewendet werden.

  • Außerkraftsetzen des Verhaltens bei der Erstellung von vordefinierten Listen.
  • Erstellen eines SharePoint-Add-Ins.

Außerkraftsetzen des Verhaltens bei der Erstellung von vordefinierten Listen

In diesem Muster ändern Sie das Verhalten bei der Erstellung von Listen, indem Sie dem ListAdded-Ereignis einen Ereignisempfänger hinzufügen. Verwenden Sie dann in dem für das ListAdded-Ereignis konfigurierten Ereignisempfänger das Remotebereitstellungsmuster, um standardisierte Konfigurationen auf jede erstellte Liste anzuwenden.

Diese standardisierten Konfigurationen umfassen möglicherweise das Hinzufügen von Inhaltstypen, das Festlegen des Standardinhaltstyps, das Hinzufügen von Listenspalten, das Festlegen der Versionseinstellungen und alle anderen Listentypkonfigurationen, die festgelegt werden können.

  • Mit diesem Ansatz können Sie standardisierte Einstellungen für alle Listen anwenden.
  • Mit diesem Ansatz können Sie standardisierte Einstellungen auf verschiedene Listentypen anwenden.
    • Beispiel: Wenn Sie eine Dokumentbibliothek und eine Aufgabenliste erstellen, können Sie im ListAdded-Ereignisempfänger festlegen, welche Art von Liste Sie erstellt haben, und Sie können verschiedene standardisierte Einstellungen basierend auf dem Listentyp anwenden. Möglicherweise benötigen alle Dokumentbibliotheken einen Satz von Inhaltstypen, der auf sie angewendet wird, während auf alle Aufgabenlisten ein anderer Satz von Inhaltstypen angewendet werden muss.
  • Bei diesem Ansatz wird das Anwenden mehrerer verschiedener Vorlagenoptionen auf Listen nicht unterstützt.
    • Beispiel: Wenn Sie eine Dokumentbibliothek und eine Aufgabenliste erstellen, können Sie im ListAdded-Ereignisempfänger festlegen, welche Art von Liste Sie erstellt haben, und Sie können verschiedene standardisierte Einstellungen basierend auf dem Listentyp anwenden. Sie können jedoch keine unterschiedlichen Vorlagen auf eine erstellte Dokumentbibliothek oder eine andere von Ihnen erstellte Dokumentbibliothek anwenden.

Wann ist die Option geeignet?

Wenn Sie standardisierte globale Einstellungen auf alle Listen oder Listen eines bestimmten Typs anwenden müssen.

Wann passt es nicht?

Wenn Sie mehrere verschiedene Vorlagenoptionen auf Listen anwenden müssen.

Erste Schritte

Im folgenden Rezept des SharePoint-Add-In-Modells wird beschrieben, wie Ereignisempfänger implementiert werden.

Erstellen eines SharePoint-Add-Ins

In diesem Muster erstellen Sie ein SharePoint-Add-In zum Erstellen von Listen mit standardisierten Einstellungen und weisen Ihre Benutzer an, das SharePoint-Add-In zum Erstellen neuer Listen zu verwenden. Im Wesentlichen bietet das SharePoint-Add-In Benutzern die Auswahl verschiedener Listen zum Erstellen. Die verschiedenen Listen, die das SharePoint-Add-In Benutzern erstellen kann, werden vom Unternehmen definiert und von einem Entwickler implementiert. Benutzer füllen ein Formular im SharePoint-Add-In aus, um die Listenmetadaten anzugeben und auszuwählen, welche Liste aus den vom Add-In angebotenen Optionen erstellt werden soll. Das Add-In verwendet das Remote-Bereitstellungsmuster, um die Liste entsprechend zu erstellen.

  • Mit diesem Ansatz können Sie standardisierte Einstellungen für alle Listen anwenden.
  • Mit diesem Ansatz können Sie standardisierte Einstellungen auf verschiedene Listentypen anwenden.
  • Mit diesem Ansatz können Sie mehrere verschiedene Vorlagenoptionen auf Listen anwenden.

Wann ist die Option geeignet?

Wenn Sie mehrere verschiedene Vorlagenoptionen auf Listen anwenden müssen.

Erste Schritte

Das folgende O365 PnP-Codebeispiel und -Video veranschaulicht, wie ein SharePoint-Add-In erstellt wird, das eine Benutzeroberfläche bereitstellt, die Endbenutzern das Erstellen neuer Dokumentbibliotheken ermöglicht. Außerdem wird veranschaulicht, wie eine Dokumentbibliothek mit bestimmten Konfigurationen erstellt wird, die zusammen eine Vorlage darstellen.

Das folgende Video führt Sie durch das Codebeispiel.

PnP-Beispiele

Gilt für

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

Muster für dedizierte und lokale Umgebungen sind identisch mit SharePoint-Add-In-Modelltechniken, aber es gibt Unterschiede bezüglich der verwendbaren Technologien.

  • Zuletzt aktualisiert um