Freigeben über

Konfigurieren der Standardoptionen für die Teams-App

  • Artikel

Es ist üblich, dass eine App mehrere Szenarien in Microsoft Teams unterstützt, aber Sie haben sie möglicherweise unter Berücksichtigung eines bestimmten Bereichs und einer bestimmten Funktion entworfen. Die Teams-Benutzeroberfläche hilft Benutzern, den Standardbereich für die Installation Ihrer App zu identifizieren.

Wenn ein Benutzer eine App aus dem Microsoft Teams Store installiert oder eine benutzerdefinierte App hochlädt, hat der Benutzer die Möglichkeit, die App entweder im persönlichen oder im freigegebenen Bereich zu öffnen:

  • Persönlicher Bereich: Wenn eine App persönlichen Bereich unterstützt, ermöglicht die Option Öffnen im Dialogfeld zur Bereichsauswahl das Öffnen der App im persönlichen Bereich.

  • Freigegebener Bereich: Wenn eine App freigegebene Bereiche unterstützt, werden alle unterstützten Bereiche wie Kanal, Chat und Besprechung aufgelistet, um den erforderlichen Bereich auszuwählen. Wenn Ihre App mit einem Standardinstallationsbereich konfiguriert ist, wird neben dem jeweiligen Bereich die Bezeichnung Empfohlen angezeigt.

    Screenshot des Bereichsauswahldialogfelds zum Auswählen des erforderlichen Bereichs für die Verwendung der App.

Wenn die primäre Funktion Ihrer App ein Bot ist und im persönlichen Bereich verwendet werden soll, können Sie die Standardfunktion als Bot und auch den Standardbereich als persönlich festlegen.

Konfigurieren des Standardinstallationsbereichs Ihrer App

Sie können den Standardinstallationsbereich verwenden, um anzugeben, ob Ihre App für persönliche, Kanal-, Chat- oder Besprechungsbereiche verfügbar ist. Wenn Sie den Standardinstallationsbereich konfigurieren, können Sie jeweils nur einen Bereich festlegen. Weitere Informationen finden Sie unter App-Manifest.

So konfigurieren Sie den Standardinstallationsbereich in Ihrem App-Manifest:

  1. Öffnen Sie Ihr App-Manifest, und fügen Sie die defaultInstallScope -Eigenschaft hinzu.

  2. Legen Sie den Standardwert für den Installationsbereich auf personal, team, groupChatoder meetingsfest.

    "defaultInstallScope": "meetings",

Benutzeroberfläche für die App-Installation

Die App-Installation innerhalb des konfigurierten Standardinstallationsbereichs, z. B. persönliche Bereiche, Kanal-, Chat- oder Besprechungsbereiche, ist schnell und unkompliziert. Die folgenden Verfahren beschreiben den Benutzerflow für die Installation einer App innerhalb des konfigurierten Bereichs:


Nur persönlicher Bereich

Wenn eine App nur mit persönlichem Bereich konfiguriert ist, sehen Sie hier den Benutzerflow zum Hinzufügen der App:

  1. Wechseln Sie zu Apps .

  2. Navigieren Sie zu der App, die Sie installieren möchten, und wählen Sie sie aus.

  3. Wählen Sie im Dialogfeld mit den App-Details die Option Hinzufügen aus.

    Screenshot des Dialogfelds mit den App-Details mit der Option

    Wenn die App hinzugefügt wird, wird ein Dialogfeld zum Öffnen der App im persönlichen Bereich angezeigt.

  4. Klicken Sie auf Öffnen. Die App wird im persönlichen Bereich geöffnet.

    Screenshot des Dialogfelds zur Bereichsauswahl mit hervorgehobener Option


Persönliche und freigegebene Bereiche

Wenn eine App mit persönlichen und freigegebenen Bereichen zusammen mit einem Standardinstallationsbereich konfiguriert ist, sehen Sie hier den Benutzerflow zum Hinzufügen der App im erforderlichen Bereich:

  1. Wechseln Sie zu Apps .

  2. Navigieren Sie zu der App, die Sie installieren möchten, und wählen Sie sie aus.

  3. Wählen Sie im Dialogfeld mit den App-Details die Option Hinzufügen aus.

    Screenshot des Dialogfelds mit den App-Details mit der Option

    Wenn die App hinzugefügt wird, wird ein Dialogfeld zum Auswählen des Bereichs angezeigt.

  4. Wählen Sie Öffnen aus, um die App im persönlichen Bereich zu öffnen.

    Alternativ können Sie entweder aus dem empfohlenen Bereich auswählen oder den erforderlichen freigegebenen Bereich suchen und auswählen und durch das Dialogfeld wechseln, um Los auszuwählen.

    Screenshot des Bereichsauswahldialogfelds mit den Optionen zum Öffnen der App in persönlichen oder freigegebenen Bereichen.

    Die App wird in dem von Ihnen ausgewählten Bereich geöffnet.

    Hinweis

    • Die Schaltfläche Empfohlen gibt den Bereich an, in dem die App die beste Nutzung bietet.
    • Die Option Mehr anzeigen listet die entsprechenden Kanal-, Chat- oder Besprechungsoptionen auf, die für den Benutzer verfügbar sind.

Freigegebener Bereich

Wenn eine App mit freigegebenen Bereichen zusammen mit einem Standardinstallationsbereich konfiguriert ist, sehen Sie hier den Benutzerflow zum Hinzufügen der App im erforderlichen Bereich:

  1. Wechseln Sie zu Apps .

  2. Navigieren Sie zu der App, die Sie installieren möchten, und wählen Sie sie aus.

  3. Wählen Sie im Dialogfeld mit den App-Details die Option Hinzufügen aus.

    Screenshot des Dialogfelds mit den App-Details mit der Option

    Wenn die App hinzugefügt wird, wird ein Dialogfeld zum Auswählen des Bereichs angezeigt.

  4. Wählen Sie entweder aus dem empfohlenen Bereich aus, oder suchen Sie nach, und wählen Sie den erforderlichen freigegebenen Bereich aus, und navigieren Sie durch das Dialogfeld, um Los auszuwählen.

    Screenshot des Dialogfelds zur Bereichsauswahl mit der Suchoption zur Auswahl aus der Liste der freigegebenen Bereiche.

    Die App wird in dem von Ihnen ausgewählten Bereich geöffnet.


Konfigurieren der Standardfunktion für freigegebene Bereiche

Konfigurieren Sie die Standardfunktion, wenn Ihre App für ein Team, eine Besprechung oder einen Gruppenchat installiert wird. Weitere Informationen finden Sie unter App-Manifest.

Hinweis

defaultGroupCapability stellt die Standardfunktion bereit, die dem Team, dem Gruppenchat oder der Besprechung hinzugefügt wird. Wählen Sie eine Registerkarte, einen Bot oder Connector als Standardfunktion für Ihre App aus. Sie müssen jedoch sicherstellen, dass Sie die ausgewählte Funktion in Ihrer App-Definition bereitgestellt haben.

So konfigurieren Sie Details im App-Manifest:

  1. Öffnen Sie Ihr App-Manifest, und fügen Sie die defaultGroupCapability -Eigenschaft hinzu.

  2. Legen Sie den Wert team, groupchatoder meetingsfest.

  3. Für die ausgewählte Gruppenfunktion sind die verfügbaren botGruppenfunktionen , taboder connector.

    Hinweis

    Sie können nur eine Standardfunktion , botoder tabconnector für die ausgewählte Gruppenfunktion auswählen.

    "defaultGroupCapability": {
    "team": "bot",
    "groupchat": "bot",
    "meetings": "tab"
}

Konfigurieren der Standardzielfunktion Ihrer App

Sie können die Standardzielfunktion für eine App konfigurieren, die sowohl Bot- als auch Registerkartenfunktionen im persönlichen Bereich unterstützt. Basierend auf dieser Konfiguration wird die App standardmäßig entweder als Bot oder als Registerkarte geöffnet.

Sie können eine der folgenden Optionen konfigurieren:

Bot als Standardzielfunktion

Konfigurieren Sie Ihre App so, dass sie standardmäßig als Bot geöffnet wird:

  1. Öffnen Sie Ihr App-Manifest.

  2. Definieren Sie scopes unter bots -Eigenschaft als personal.

    "bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

Hinweis

Der Bot fungiert als Standardzielfunktion, wenn sein Bereich als persönlich definiert ist, auch wenn Sie nicht als conversations in der staticTabs -Eigenschaft angebenentityId.

Das folgende Beispiel zeigt das Öffnen einer App mit einem Bot als Standardzielfunktion und wie ein Benutzer zu einer Registerkarte wechseln kann:

Die Grafik zeigt den Vorgang zum Öffnen einer App mit einem Bot als Standardzielfunktion.

Tabulator als Standardzielfunktion

Konfigurieren Sie Ihre App so, dass sie standardmäßig als Registerkarte geöffnet wird:

  1. Öffnen Sie Ihr App-Manifest.
  2. Unter staticTabs -Eigenschaft:
    1. Fügen Sie die Registerkarteneigenschaften als ersten Eintrag des Arrays hinzu. Informationen zum Definieren von Registerkarteneigenschaften finden Sie unter App-Manifest.
    2. Fügen Sie folgende Eigenschaften hinzu:
      1. Definieren Sie entityId als conversations.
      2. Definieren Sie scopes als personal.

Der folgende Codeausschnitt ist ein Beispiel für das Festlegen der Registerkarte als Standardzielfunktion:

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

Das folgende Beispiel zeigt das Öffnen einer App mit der Registerkarte als Standardzielfunktion und wie ein Benutzer zu einem Bot wechseln kann:

Die Grafik zeigt den Vorgang zum Öffnen einer App mit einer Registerkarte als Standardzielfunktion.

Die staticTabs -Eigenschaft wird auch verwendet, um persönliche Registerkarten anzuheften und Registerkarten neu anzuordnen. Weitere Informationen finden Sie unter App-Manifest.

Standardmäßiges Blockieren von Apps für Benutzer, bis ein Administrator die Genehmigung erteilt

Um die Benutzererfahrung einer Teams-App zu verbessern, müssen IT-Administratoren manchmal eingreifen, bevor Benutzer die App verwenden. Betrachten Sie beispielsweise eine Helpdesk-App, die von Contoso Electronics für Teams erstellt wurde. Um sicherzustellen, dass die App ordnungsgemäß funktioniert, möchte Contoso Electronics, dass Kunden zuerst bestimmte Eigenschaften der App konfigurieren.

Um sicherzustellen, dass IT-Administratoren die relevanten Aufgaben ausführen, können Entwickler eine App für Benutzer blockieren, bis ein Administrator die App zulässt. Um die App standardmäßig zu blockieren, legen Sie die defaultBlockUntilAdminAction -Eigenschaft in der App-Manifestdatei auf true fest. Wenn die -Eigenschaft auf truefestgelegt ist, wird die status der App im Teams Admin Center auf der Seite Apps verwaltenvom Herausgeber blockiert.

Screenshot: Vom Herausgeber blockierte App

Die Administratoren können Ihre App sorgfältig prüfen, und sie können die von Ihnen bereitgestellte App-Dokumentation lesen, bevor sie ihren Benutzern erlauben, Ihre App zu verwenden. Beispielsweise können die Administratoren die erforderlichen Lizenzen erwerben und die Lizenzen verteilen, bevor sie Benutzern die Verwendung der App erlauben. Um die App mit vom Herausgeber blockierten status zuzulassen, kann ein Administrator auf der Seite Apps verwalten im Teams Admin Center die Option Zulassen auswählen.

Screenshot: Option

Wenn Sie nicht möchten, dass Ihre App standardmäßig blockiert wird, aktualisieren Sie die defaultBlockUntilAdminAction Einstellung auf , false und übermitteln Sie Ihre aktualisierte App zur Veröffentlichung. Nachdem wir die neue Version Ihrer App veröffentlicht haben, ist sie standardmäßig zulässig.

Hinweis

Für benutzerdefinierte Apps, die für Ihre Organisation erstellt wurden, defaultBlockUntilAdminAction wird nicht unterstützt. Wenn Sie eine benutzerdefinierte App hochladen, die für Ihre organization mit dieser Eigenschaft erstellt wurde, wird die App nicht blockiert.

Codebeispiel

Beispielname Beschreibung .NET Node.js Manifest
Hello Welt In diesem Beispiel wird veranschaulicht, wie Sie die Standardzielfunktion für eine App konfigurieren, die sowohl Bot- als auch Registerkartenfunktionen im persönlichen Bereich unterstützt. View View View

Nächster Schritt

Erstellen Ihres App-Pakets