Freigeben über

Konfigurieren der Standardoptionen für die Teams-App

  • Artikel

Es ist üblich, dass eine App mehrere Szenarien in Teams unterstützt, aber Sie haben sie möglicherweise unter Berücksichtigung eines bestimmten Umfangs und einer bestimmten Funktion entworfen. Wenn Ihre App beispielsweise hauptsächlich für die Team- oder Kanalverwendung vorgesehen ist, können Sie sicherstellen, dass die erste Installationsoption, die Benutzern im Microsoft Teams Store angezeigt wird, zu einem Team hinzufügen ist.

Screenshot: Option

Wenn die primäre Funktion Ihrer App ein Bot ist, können Sie den Bot auch zur Standardfunktion machen, wenn ein Benutzer Ihre App in einem Team installiert.

Konfigurieren des Standardinstallationsbereichs Ihrer App

Konfigurieren Sie den Standardinstallationsbereich für Ihre App. Sie können 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 des Installationsbereichs entweder personalauf , team, groupchatoder meetingsfest.

    "defaultInstallScope": "meetings",

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 Gruppenfunktionen, bot, 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