Clientseitige Webpart-Einstellungen auf den Registerkarten von Microsoft Teams
In dieser Einheit erfahren Sie, wie Sie die Einstellungen Ihres clientseitigen SharePoint-Framework-Webparts konfigurieren, wenn es als Registerkarte in Microsoft Teams verwendet wird.
Konfigurationsoptionen einer benutzerdefinierten Registerkarte von Microsoft Teams
Clientseitige SharePoint-Webparts können öffentliche Eigenschaften aufweisen. Entwickler können diese Eigenschaften für Formularsteuerelemente im SharePoint-Eigenschaftenbereich offenlegen, damit Benutzer sie bearbeiten können.
Der Eigenschaftenbereich steht nur zur Verfügung, wenn sich die Seite im Bearbeitungsmodus befindet und der Benutzer das Bearbeitungssteuerelements im Webpart ausgewählt hat. Der aktuelle Benutzer muss auch auf die Seite zugreifen können, um die Einstellungen des Webparts zu ändern.
In Microsoft Teams angezeigter Eigenschaftenbereich eines Webparts
Die Eigenschaften, die als Einstellungen bezeichnet werden, können auf einer Registerkarte in Microsoft Teams auch von einem Benutzer geändert werden. Wählen Sie zum Ändern von Einstellungen einer Registerkarte das Kontextmenü der Registerkarte aus, und wählen Sie die Option Einstellungen aus.
Wenn die Menüoption Einstellungen ausgewählt wird, wird von Microsoft Teams-Registerkarten ein Dialogfeld geöffnet, das vom Entwickler der Registerkarte implementiert wird.
Wenn jedoch ein Webpart als Registerkarte von Microsoft Teams verwendet wird, lädt die Registerkarte eine SharePoint-Seite, die das clientseitige Webpart hostet. Wenn in Teams das Menüelement Einstellungen ausgewählt wird, wird SharePoint von Microsoft Teams benachrichtigt, dass sich die Seite jetzt im Bearbeitungsmodus befindet.
Dann wird die native Benutzeroberfläche des Eigenschaftenbereichs von SharePoint verwendet, um die öffentlichen Eigenschaften des Webparts anzuzeigen und zu bearbeiten:
Konfigurieren von Einstellungen – nur bei der Installation bearbeiten
Benutzer mit den erforderlichen Berechtigungen können clientseitige SharePoint-Framework-Webparts immer bearbeiten, auch unmittelbar nachdem sie der Seite hinzugefügt wurden und zu jedem beliebigen späteren Zeitpunkt.
Die Registerkarten von Microsoft Teams unterscheiden sich von Webparts darin, dass die Oberfläche für die Einstellungen nur einmal angezeigt wird, wenn die Registerkarte einem Kanal hinzugefügt wird, und optional zu einem späteren Zeitpunkt. Auf diese Weise kann eine Person mit der Berechtigung zum Hinzufügen einer Registerkarte zu einem Kanal die Einstellungen ändern, aber optional die Benutzer daran hindern, die Einstellungen zu einem späteren Zeitpunkt zu ändern.
Entwickler können diese Einstellung für die Registerkarte in der Manifestdatei der Microsoft Teams-App steuern.
Die canUpdateConfiguration
-Eigenschaft der Registerkarte wird standardmäßig auf true
festgelegt, aber Sie können diese Einstellung außer Kraft setzen und auf false
festlegen.
{
...
"configurableTabs": [
{
"configurationUrl": "https://..",
"canUpdateConfiguration": false,
"scopes": [ "team" ]
}
]
}
Wenn die Eigenschaft auf false
festgelegt ist, wird die Seite „Einstellungen“ nur unmittelbar vor dem Hinzufügen der Registerkarte zu dem Kanal angezeigt. In diesem Szenario ist die Schaltfläche Einstellungen nicht im Kontextmenü der Registerkarte vorhanden:
Zusammenfassung
In dieser Einheit haben Sie erfahren, wie Sie die Einstellungen Ihres clientseitigen SharePoint-Framework-Webparts konfigurieren, wenn es als Registerkarte in Microsoft Teams verwendet wird.