Bereitstellen und Installieren von SharePoint-Add-Ins: Methoden und Optionen
In diesem Artikel erfahren Sie mehr über die Optionen für die Veröffentlichung Ihres SharePoint-Add-Ins sowie zum Installieren und Deinstallieren des Add-Ins.
Veröffentlichen im Office Store oder im Add-In-Katalog eines Unternehmens
Sie können Ihr SharePoint-Add-In entweder in den öffentlichen Office Store oder in den privaten Add-In-Katalog einer Organisation hochladen. Ein privater Add-In-Katalog ist eine dedizierte Websitesammlung in einer SharePoint-Webanwendung (oder einem SharePoint Online-Mandanten), die Dokumentbibliotheken für SharePoint-Add-Ins und Office-Add-Ins hostet. Das Einfügen des Katalogs in eine eigene Websitesammlung erleichtert es dem Webanwendungsadministrator oder Mandantenadministrator, Berechtigungen für den Katalog einzuschränken.
Wenn das Add-In in den Office Store hochgeladen wird, führt Microsoft Validierungsprüfungen aus. Es überprüft beispielsweise, ob das Add-In-Manifest-Markup gültig und vollständig ist, und stellt sicher, dass hinzugefügte SharePoint-Lösungspakte (WSP-Dateien) keine unzulässigen Elemente oder Features mit einem breiteren Bereich als Web enthalten. Der Paketinhalt wird außerdem auf unzulässige Inhalte untersucht. Wenn das Add-In alle Prüfungen besteht, wird das Add-In-Paket in eine Datei verpackt und von Microsoft signiert.
Hinweis
Wenn Sie Ihr Add-In mit den Microsoft Office Developer Tools für Visual Studio entwickeln und bereitstellen, wird das Add-In direkt auf der SharePoint-Zieltestwebsite installiert. Da es nicht über den Office Store übergeben wird, findet die oben beschriebene Überprüfung nicht statt.
Ein SharePoint-Add-In in den Add-In-Katalog eines Unternehmens zu laden ist so einfach, wie eine Datei in eine SharePoint Foundation-Dokumentbibliothek zu laden. Sie füllen Sie ein Popupformular aus, in dem Sie die lokale URL des Add-In-Pakets und weitere Informationen, wie z. B. den Namen des Add-Ins, angeben. Wenn das Add-In in den Add-In-Katalog eines Unternehmens geladen wird, werden ähnliche Überprüfungen durchgeführt. Dabei werden Add-Ins, die die Prüfungen nicht bestehen, als ungültig gekennzeichnet oder im Katalog deaktiviert.
Mandantenadministratoren und SharePoint-Webanwendungsadministratoren können SharePoint-Add-Ins im Office Store kaufen. Zum Öffnen des Office Store wählt der Administrator die Option Add-In hinzufügen auf der Seite Websiteinhalte und dann SharePoint Store auf der Seite Eigene Add-Ins aus. Daraufhin wird die Seite SharePoint Store geöffnet, über die der Administrator mehr über SharePoint-Add-Ins erfahren kann, die von Anbietern angeboten werden. (Dies ist auch auf office.com möglich.)
Add-Ins, die eine erforderliche Komponente benötigen, die auf der Anwendungswebsite oder Mandantschaft des Administrators nicht installiert ist, werden abgeblendet angezeigt und sind im Add-In-Store nicht verfügbar. Wenn ein Add-In beispielsweise Suchdienste erfordert und diese nicht installiert sind, wird das Add-In abgeblendet angezeigt. Administratoren können die Liste der Add-Ins sortieren, filtern und durchsuchen, Informationen über Add-Ins lesen, Add-In-Rezensionen anzeigen und Lizenzen für ein Add-In erwerben.
Wenn ein Administrator eine Lizenz erwerben möchte, muss er die Kaufbestimmungen akzeptieren und den für das Add-In erforderlichen Berechtigungen zustimmen, wie z. B. Lesezugriff auf Listen oder Vollzugriff auf die Websitesammlung.
Wenn eine oder mehrere Lizenzen für ein Add-In erworben werden, werden die Lizenzen in die Webanwendung oder Mandanteneinheit heruntergeladen. Das Add-In wird beim Lizenzerwerb nicht automatisch heruntergeladen und installiert, obwohl der Administrator die Option hat, die Installation mit dem Lizenzerwerb zu kombinieren.
Benutzer installieren Apps von der Seite Your Add-Ins (Eigene Add-Ins). Diese Seite enthält eine zusammengeführte Liste mit folgenden Komponenten:
- SharePoint-Add-Ins aus dem Organisations-Add-In-Katalog der Webanwendung (oder des Mandanten).
- SharePoint-Add-Ins aus dem Office Store, für die das Unternehmen oder der Mandant bereits eine Website-Lizenz oder eine dem Benutzer zugewiesene Lizenz besitzt.
Alle Add-Ins, die der Benutzer sofort installieren kann, werden aufgelistet. Benutzer können die auf der Seite enthaltenen Add-Ins filtern, um nur Add-Ins aus dem Add-In-Katalog der Organisation anzuzeigen. Wenn ein Add-In installiert ist, wird es in der Liste der Add-Ins auf der Seite Websiteinhalte der Website angezeigt, auf der es installiert ist.
Installieren von SharePoint-Add-Ins
Websitebesitzer installieren SharePoint-Add-Ins von der Seite Eigene Add-Ins, wie weiter oben in diesem Thema beschrieben. Die Installation erstellt eine Instanz des Add-Ins. Weitere Informationen über das Installieren von Add-Ins finden Sie unter Hinzufügen von SharePoint-Add-Ins zu einer SharePoint-Website.
Hinweis
Manchmal kann ein vorübergehender Verlust der Netzwerkverbindung die Installation blockieren. Wenn die Installation aus irgendeinem Grund fehlschlägt, führt die Installationsinfrastruktur drei Wiederholungsversuche durch. Wenn sie nicht erfolgreich sind, wird dies auf der Benutzeroberfläche angezeigt. Benutzer können die Installation zu einem späteren Zeitpunkt erneut versuchen.
Deinstallieren von SharePoint-Add-Ins
Websitebesitzer können eine Instanz eines SharePoint-Add-In über die SharePoint-Benutzeroberfläche deinstallieren. Die Deinstallation einer Instanz eines SharePoint-Add-Ins ist sauber. Das bedeutet, dass alle vom Add-In installierten Komponenten deinstalliert werden.
Komponenten, die von einem Add-In verwendet , aber separat von der Installation des Add-Ins installiert werden, werden jedoch nicht entfernt. Nehmen Sie beispielsweise an, ein Add-In verfügt über eine Remotewebseite mit Schaltflächen, die Listen im Hostweb erstellen. Durch die Deinstallation des Add-Ins wird die Kachel des Add-Ins von der Seite Websiteinhalte entfernt, wodurch wiederum die Remoteseite im Wesentlichen für Endbenutzer nicht zugänglich oder nicht benutzbar wird. Die Listen, die mit dem Add-In erstellt wurden, werden jedoch nicht entfernt. SharePoint bewahrt keine Aufzeichnung auf, welche Listen im Hostweb mit dem Add-In und welche von Benutzern in der SharePoint-Benutzeroberfläche erstellt wurden, deshalb können mit dem Add-In erstellte Listen nicht gelöscht werden. Im Allgemeinen ist dieses Verhalten wünschenswert, da die Listen möglicherweise Daten enthalten, die für Benutzer auch nach Entfernen des Add-Ins, das die Listen erstellt hat, nützlich bleiben können.
Wenn das SharePoint-Add-In ein Add-In-Web umfasst, wird das Add-In-Web gelöscht. Dies ermöglicht eine sauberere Deinstallation als die systematische Deaktivierung von Funktionen und das Rückgängigmachen der Bereitstellung der Internen WSP-Datei des Add-Ins.
Hinweis
Wenn ein Benutzer ein Add-In entfernt, wird es in den Standardpapierkorb verschoben. Wird es dort gelöscht, wird es in den endgültigen Papierkorb verschoben. Wird es aus dem endgültigen Papierkorb gelöscht, wird es vollständig deinstalliert und kann nicht wiederhergestellt werden.
Außerdem werden die Berechtigungen des Add-Ins beim Entfernen (Recyceln) des Add-Ins entsprechend den folgenden Regeln widerrufen:
- Webgültigkeitsberechtigungen werden immer abgerufen.
- Falls es keine weitere Instanz des Add-Ins in der Websitesammlung gibt, werden die Berechtigungen für die Websitesammlung ebenfalls abgerufen.
- Wenn keine andere Instanz des Add-Ins im Websiteabonnement (Mandantschaft) vorhanden ist, werden auch Berechtigungen im Mandantenbereich widerrufen.
Der Webdienst UninstallingEventEndpoint, falls er im Add-In-Manifest des Add-Ins registriert ist, wird zu Beginn des Deinstallationsvorgangs ausgeführt (tritt auf, wenn das Add-In aus dem endgültigen Papierkorb entfernt wird). Sie sollten den Webdienst UninstallingEventEndpoint installiert haben, wenn Sie gleichzeitig auch InstalledEventEndpoint installiert haben. Sie sollten auch den Dienst UninstallingEventEndpoint entwerfen, um eventuell Schritte im InstalledEventEndpoint-Dienst rückgängig machen zu können. Weitere Informationen finden Sie unter Behandeln von Ereignissen in SharePoint-Add-Ins.