Websitespalten und Inhaltstypen im SharePoint-Add-In-Modell

  • Artikel

Der Ansatz, den Sie zum Erstellen von Websitespalten und Inhaltstypen in SharePoint-Websites verwenden, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem mit voll vertrauenswürdigem Code. In einem typischen FTC-Szenario (Full Trust Code) bzw. farm solution verwenden Sie deklarativen Code, um Websitespalten und Inhaltstypen zu erstellen. Im deklarativen Codeansatz definieren Sie die Websitespalten und Inhaltstypen in XML und verwenden dann die Featureframeworkelemente von SharePoint, um sie zu packen und bereitzustellen.

In einem SharePoint-Add-In-Modellszenario verwenden Sie das SharePoint Client Side Object Model (CSOM) oder SharePoint REST-APIs, um Websitespalten und Inhaltstypen zu erstellen.

Richtlinien auf hoher Ebene

Als Faustregel empfehlen wir die folgenden allgemeinen Richtlinien zum Erstellen von Websitespalten und Inhaltstypen.

  • Sie sollten die SharePoint-CSOM- oder REST-APIs verwenden, um Websitespalten und Inhaltstypen zu erstellen.
  • Sie sollten keine Featureframeworkelemente verwenden, um Websitespalten und Inhaltstypen zu erstellen.
    • Die einzige Ausnahme von dieser Richtlinie ist die Verwendung der deklarativen XML-basierten Bereitstellung für ein SharePoint-Add-In-Web in einem von SharePoint gehosteten SharePoint-Add-In. Dies liegt daran, dass das CSOM in einem von SharePoint gehosteten SharePoint-Add-In nicht verfügbar ist.
  • Sie können die Erstellung von Websitespalten und Inhaltstypen im Rahmen des Websitebereitstellungsprozesses automatisieren. Weitere Informationen finden Sie im Websitebereitstellungsrezept .

Herausforderungen beim Erstellen von Websitespalten und Inhaltstypen in SharePoint-Websites

Erstellen in einem Webbrowser im Vergleich zum Erstellen mit Code

Es ist wichtig zu verstehen, dass das Erstellen von Websitespalten und Inhaltstypen über den Webbrowser oder über Code unterschiedlich ist. In der folgenden Liste werden die verschiedenen Optionen beschrieben.

  • Erstellen über einen Webbrowser
    • Bei dieser Option greifen Benutzer über einen Webbrowser auf eine SharePoint-Website zu und verwenden die Administrative Seiten, um Websitespalten und Inhaltstypen zu erstellen.
    • Normalerweise verwenden Sie den Webbrowser zum manuellen Erstellen von Websitespalten und Inhaltstypen nur dann, wenn Sie eine einzelne SharePoint-Website erstellen oder ändern, die nicht erweitert werden soll, um andere Websitesammlungen oder Unterwebsites einzuschließen.
  • Erstellen mit Code
    • In dieser Option führen Sie SharePoint-CSOM-/REST-Code aus, um Websitespalten und Inhaltstypen zu erstellen.
    • Weiter unten in diesem Artikel erfahren Sie mehr über einige Optionen, die Sie zum Ausführen des SharePoint-CSOM-/REST-Codes verwenden können.

Berücksichtigen Sie beim Erstellen über einen Webbrowser die folgenden Punkte.

  • Das Erstellen von Websitespalten und Inhaltstypen über den Webbrowser ist in der Regel ein komplizierter und zeitaufwändiger Prozess.
    • Diese Faktoren machen es anfällig für Fehler.
  • Sie steuern nicht die GUIDs für Websitespalten oder Inhaltstypen, die Sie über einen Webbrowser erstellen.
    • Dadurch ist es schwierig , die Websitespalten und Inhaltstypen in verschiedenen Umgebungen bereitzustellen und in branchenspezifischen Anwendungen konsistent darauf zu verweisen.

Berücksichtigen Sie beim Erstellen mit Code die folgenden Punkte.

  • Das Erstellen von Websitespalten und Inhaltstypen mit Code umfasst in der Regel die Verwendung benutzerdefinierter Hilfsprogrammbibliotheken zum Ausführen von SharePoint CSOM/REST-Code.
    • Diese Bibliotheken sind in vielen Projekten im OfficeDev PnP-GitHub-Repository verfügbar. Auf diese wird an mehreren Stellen in diesem Artikel und am Ende verwiesen.
    • Diese Faktoren machen das Erstellen von Websitespalten und Inhaltstypen mit Code anfällig für den Erfolg.
  • Sie können die GUIDs für Websitespalten oder Inhaltstypen steuern, die über das SharePoint-CSOM/REST erstellt werden.
    • Dies erleichtert die Bereitstellung der Websitespalten und Inhaltstypen in verschiedenen Umgebungen und das konsistente Verweisen in branchenspezifischen Anwendungen.

Bereitstellung muss schnell erfolgen

In der Regel erstellen Sie Websitespalten und Inhaltstypen, wenn Sie eine SharePoint-Website bereitstellen. Endbenutzer akzeptieren nicht, dass sie mehrere Stunden warten müssen, bis Sie ihre neuen SharePoint-Websites bereitstellen.

Ergebnis muss durchgehend perfekt sein

Websitespalten und Inhaltstypen sind die Grundlage, die Ihre Informationsarchitektur auf der niedrigsten Ebene definieren, sie müssen perfekt sein!

Eine falsche Bereitstellung von Websitespalten und Inhaltstypen kann sich auf eine gesamte Branchenanwendung auf der SharePoint-Website auswirken, auf der sie bereitgestellt werden, sowie andere Teile von SharePoint und anderen Branchenanwendungen, die auf SharePoint-Dienste zugreifen.

Beispiel: Wenn Ihr Unternehmen SharePoint-Websites zum Verwalten von Projekten verwendet, erstellen Sie höchstwahrscheinlich ein gemeinsames Listenschema für alle. Dazu müssen Sie Websitespalten und Inhaltstypen erstellen. Wenn Sie Informationen auf diesen Websites über die SharePoint-Suchseite suchen, filtern Sie die Ergebnisse nach Inhaltstyp oder Tag (Websitespalte). Wenn Ihre Websitespalten und Inhaltstypen nicht absolut einheitlich auf allen Projektwebsites sind, erhalten Sie keine genauen Suchergebnisse.

Sie können dieses Beispiel auf Content By Search-Webparts, SharePoint-Add-Ins, mobile SharePoint-Add-Ins und alle anderen Systeme anwenden, die auf die Informationen in den SharePoint-Websites zugreifen.

Optionen zum Erstellen von Websitespalten und Inhaltstypen in SharePoint-Websites

Es gibt mehrere Möglichkeiten, wie Sie den CSOM/REST-Code aufrufen können, um Websitespalten und Inhaltstypen zu erstellen. Diese Muster fallen alle in den oben beschriebenen Ansatz Erstellen mit Code . Jedes dieser Muster wird im Rezept für die Websitebereitstellung ausführlich beschrieben.

  • Überschreiben des Links zum Erstellen einer Website
  • Überschreiben des Links zum Erstellen einer Unterwebsite
  • Verwenden eines vom Anbieter gehosteten SharePoint-Add-Ins
  • Verwenden von Windows-/Java-/iOS-Anwendungen oder PowerShell-Skripts

Unabhängig von der Option, die Sie implementieren möchten, verwenden Sie letztendlich CSOM/REST, um Websitespalten und Inhaltstypen zu erstellen.

Es gibt viele verschiedene Artikel und Beispiele, die Sie verwenden können, um zu erfahren, wie Sie Websitespalten und Inhaltstypen mit dem CSOM erstellen. Hier finden Sie diese Beispiele (klassifiziert nach dem Muster, das zum Aufrufen des CSOM-Codes verwendet wird), um Websitespalten und Inhaltstypen zu erstellen.

Verwenden eines vom Anbieter gehosteten SharePoint-Add-Ins

Diese Option eignet sich gut, wenn Sie Ihren Endbenutzern eine Self-Service-Möglichkeit zum Erstellen von SharePoint-Websitesammlungen und Unterwebsites basierend auf benutzerdefinierten Vorlagen bieten müssen.

  • Core.ContentTypesAndFields (O365 PnP-Beispiel)
    • Veranschaulicht, wie Sie einen neuen Inhaltstyp im Hostweb erstellen, ein Taxonomiefeld im Hostweb erstellen und mit der Taxonomie verknüpfen, eine Liste erstellen und einem Inhaltstyp zuordnen sowie Inhaltstypen und Felder in bestimmten Sprachen erstellen.

Verwenden von Windows-/Java-/iOS-Anwendungen oder PowerShell-Skripts

Diese Option eignet sich gut für Dev-Ops-Szenarien. Sie ermöglicht das Erstellen von benutzerdefinierten Anwendungen oder Skripts, die speziell für die Integration in Ihre Dev-Ops-Prozesse entwickelt werden. Diese Option bietet die ultimative Automatisierungsebene, da Sie die SharePoint-Add-Ins und -Skripts erstellen können, die ohne Benutzerinteraktion ausgeführt werden.

  • Core.CreateContentTypes (O365-PnP-Beispiel)
    • In diesem Beispiel wird gezeigt, wie Sie Websitespalten und Inhaltstypen erstellen und dann die Websitespalten zum Inhaltstyp hinzufügen können. Außerdem werden die neuen Lokalisierungsfeatures erläutert, die für Office 365 CSOM-APIs eingeführt wurden.
  • Core.CreateDocumentContentType (O365 PnP-Beispiel)
    • In diesem Beispiel wird gezeigt, wie Sie Dokumentinhaltstypen erstellen und dann dem Inhaltstyp eine Dokumentvorlage zuordnen können.

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.