Freigeben über

Benutzersteuerelemente und Websteuerelemente im SharePoint-Add-In-Modell

  • Artikel

Der Ansatz, den Sie verwenden, um benutzerdefinierte Steuerelemente in Ihrem Code zu implementieren, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem bei voll vertrauenswürdigem Code. In einem typischen FTC-Szenario (Full Trust Code) / Farm Solution wurden benutzerdefinierte Steuerelemente als Benutzersteuerelemente oder Websteuerelemente erstellt und über SharePoint-Lösungen bereitgestellt.

In einem SharePoint-Add-In-Modellszenario ist JavaScript in SharePoint-Seiten eingebettet, um benutzerdefinierte Steuerelemente zu implementieren.

Richtlinien auf hoher Ebene

Als Faustregel möchten wir die folgenden allgemeinen Richtlinien zum Erstellen benutzerdefinierter Steuerelemente im neuen SharePoint-Add-In-Modell bereitstellen.

  • Verwenden Sie eingebettetes JavaScript, um benutzerdefinierte Steuerelemente zu erstellen.
  • Verwenden Sie das SharePoint ECMA Client Side Object Model (CSOM) und/oder die SharePoint/Office 365 REST-APIs, um mit SharePoint-Daten und -Diensten zu interagieren.

Optionen zum Einbetten von JavaScript in SharePoint-Seiten

Sie haben einige Optionen zum Einbetten von JavaScript in SharePoint-Seiten.

  • Verwenden von benutzerdefinierten Benutzeraktionen
  • Direktes Einbetten von JavaScript in Seitenlayouts
  • Direktes Einbetten von JavaScript in benutzerdefinierte master Seiten (nicht empfohlen)

Verwenden von benutzerdefinierten Benutzeraktionen

In diesem Muster werden benutzerdefinierte Benutzeraktionen verwendet, um JavaScript zur Laufzeit in eine Seite einzubetten.

  • Dieser Ansatz wird absolut unterstützt und ist ein gültiger Ansatz.

Wann ist die Option geeignet?

Wenn Sie JavaScript in alle SharePoint-Seiten einbetten müssen, eignet sich diese Option gut.

Erste Schritte

Im folgenden Artikel und im zugehörigen Video wird veranschaulicht, wie Sie benutzerdefinierte Benutzeraktionen verwenden, um JavaScript in SharePoint-Seiten einzubetten.

Direktes Einbetten von JavaScript in Seitenlayouts

In diesem Muster wird JavaScript direkt in Seitenlayouts in Veröffentlichungswebsites eingebettet.

  • Dieser Ansatz wird absolut unterstützt und ist ein gültiger Ansatz.
  • Dieser Ansatz funktioniert mit Veröffentlichungswebsites.

Wann ist die Option geeignet?

Wenn Sie JavaScript in bestimmte SharePoint-Seitenlayouts in Veröffentlichungswebsites in einem WCM-Szenario einbetten müssen, eignet sich diese Option gut.

Direktes Einbetten von JavaScript in benutzerdefinierte master Seiten

In diesem Muster wird JavaScript direkt in benutzerdefinierte master-Seiten eingebettet.

  • Dieser Ansatz wird nicht empfohlen.
  • Dieser Ansatz ist ein gültiger Ansatz.
  • Sie können JavaScript direkt in benutzerdefinierte master-Seiten einbetten. Beachten Sie jedoch, dass dies bei zukünftigen Updates zu zusätzlichen langfristigen Kosten und Herausforderungen führt.
    • Falls Sie benutzerdefinierte Gestaltungsvorlagen verwenden, müssen Sie möglicherweise Änderungen an diesen vornehmen, wenn wichtige funktionale Updates auf Office 365 angewendet werden.

Wann ist die Option geeignet?

Wenn Sie JavaScript pro master Seite einbetten müssen, ist dies eine gute Option, da Sie damit steuern können, in welche master Seiten das JavaScript eingebettet ist.

PnP-Beispiele

Gilt für

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