Teams App Bereitstellung

Teams App Bereitstellung

In diesem Artikel werden die Schritte beschrieben, die zum Installieren der Teams-App erforderlich sind.

Initiale App Bereitstellung

1. Registrieren Sie eine App: Klicken Sie in Teamsware Studio auf der Registerkarte "Veröffentlichen" > "App-Bereitstellung" > auf die Schaltfläche "Veröffentlichen". Stellen Sie im Veröffentlichungsassistenten sicher, dass der Typ "App-Bereitstellung" ausgewählt ist


Geben Sie den App-Titel an, und wählen Sie die Paketversion aus, die Sie veröffentlichen möchten.

Der Titel der Teams-App lautet "TeamsApp_<AppTitle>_v1.0.0.0".



Klicken Sie auf die Schaltfläche Weiter, um zur Registerkarte Bereitstellungen umzuleiten, wo Sie auswählen können: Standardbereitstellung oder Selektive Bereitstellung. Die  Option Standardbereitstellung ist standardmäßig ausgewählt und stellt alle Lösungselemente im Paket auf der Zielwebsite bereit.




Der Schritt Zusammenfassung enthält Informationen über den App-Titel, die Paketversion und den Bereitstellungstyp sowie Protokolle darüber, was in der Bereitstellung enthalten sein wird




2. Nachdem die App registriert wurde, können Sie das Teams-App-Paket im rechten Bereich herunterladen.




Im Dialogfeld Teams-App-Paket können Sie entweder die Teams-App ohne Demo-URL herunterladen oder Ihre eigene Demo-URL angeben. Wenn eine Demo-URL bereitgestellt wird, ist die Registerkarte "Demo" im Team verfügbar





Nachdem Sie das .zip Archiv heruntergeladen haben, extrahieren Sie dessen Inhalt. Das Archiv enthält die folgenden Dateien:

  • readme.txt - Anweisungen und Informationen über das Paket
  • teamsapp_<apptitle>.zip – Teams App Package bereit zum Hochladen in das Entwicklerportal
  • update-demo-actions.json - eine Konfigurationsdatei für den Status der Update-Demo-Anfrage
Hinweis: Bevor Sie beginnen, stellen Sie Folgendes sicher:- Sie verfügen über Administratorzugriff auf das Teams Developer Portal (https://dev.teams.microsoft.com/)

- Sie verfügen über Administratorzugriff auf das Teams Admin Center (https://admin.teams.microsoft.com/)
- Erlauben Sie Benutzern, benutzerdefinierte Apps in Ihrer Organisation hochzuladen. Weitere Informationen finden Sie im Artikel  https://learn.microsoft.com/en-us/microsoftteams/teams-custom-app-policies-and-settings 
– Sie verfügen über eine Teams-Lizenz


Importieren des Teams App Paketes in das Developer Portal

Gehen Sie ins Developer Portal um die App hochzuladen. Klicken Sie auf die Schaltfläche App importieren




  1. Wenn die App hochgeladen wird, wechseln Sie zu Grundlegende Informationen, und aktualisieren Sie den App-Namen, die Beschreibung, die Version, die Entwicklerinformationen, die App-URLs und die Microsoft-Partner-ID nach Bedarf.




  • Im Abschnitt Branding können Sie das Farbsymbol, das Kontursymbol und die Akzentfarbe aktualisieren.


  • Gehen Sie zu Sprachen (optional). Fügen Sie zusätzliche Sprachen hinzu und geben Sie Schemawerte für Namen, Beschreibungen und Registerkartennamen an. Hinweis: Standardmäßig unterstützt der Inhalt der Registerkarten die folgenden Sprachen: Englisch (en), Deutsch (de), Französisch (fr), Spanisch (es), Niederländisch (nl), Slowakisch (sk), Schwedisch (sv)
  • Wechseln Sie zu App-Validierung, und führen Sie eine Validierungsprüfung durch, um sicherzustellen, dass die App die Veröffentlichungsanforderungen erfüllt



  • Verwenden Sie die Schaltfläche Vorschau in Teams, um die App mit Ihrer aktuellen Organisation zu testen.
  • Wechseln Sie zu In Organisation veröffentlichen, um die App in Ihrer Organisation zu veröffentlichen.
  • Wechseln Sie zu Im Store veröffentlichen, um mit der Veröffentlichung Ihrer App im Teams App Store zu beginnen (optional)

Veröffentlichen der Teams App im Microsoft Teams admin center

Gehen Sie ins Microsoft Teams admin center. Suchen Sie nach Ihrer Teams-App. Öffnen Sie es und klicken Sie auf Veröffentlichen. Es kann einige Zeit dauern, bis der Status aktualisiert wird.




Öffnen Sie Microsoft Teams-App, um die App hinzuzufügen

Wechseln Sie zu Apps -> Erstellt für Ihre Organisation. Wählen Sie die veröffentlichte App aus und klicken Sie auf Hinzufügen



Sobald Sie die hinzugefügte App öffnen, werden Sie zur Startseite mit zwei Optionen weitergeleitet:

  • Installieren Sie Ihre App: Richten Sie Ihre App für Ihre Organisation ein. Diese Option ist nur für Administratoren verfügbar
  • Demo anfordern: Fordern Sie eine kostenlose Demo zum Testen an. Diese Option ist für alle verfügbar, wenn die Teams-App mit einer Demo-URL heruntergeladen wurde


Teams Demo Anfrage

Die Registerkarte "Demo" zeigt das konfigurierte Demo-Anforderungsformular an

TeamsDemo.png




















Demo anfordern

1. Die Seite "Demo-Anforderung" wird innerhalb einer Teams-Registerkarte innerhalb eines iFrames gerendert, einschließlich eines zusätzlichen Parameters (z. B. demoId) in der URL. Zum Beispiel:

    https://YOUR_DEMO_REQUEST_URL?demoId=00000000-0000-0000-00000-0000000000

Hinweis: Stellen Sie sicher, dass die Kopfzeile der Seite "Content-Security-Policy frame-ancestors 'self'" enthält, um Fehler beim Anzeigen der Seite im iframe zu vermeiden.

2. Erfassen Sie den demoId-Parameter, und übergeben Sie ihn an den Bereitstellungsablauf Ihrer Demoanforderung.

3. Sie können Aktionen von UpdateDemoActions.json verwenden, um den Status der Demoanforderung in Teams zu aktualisieren und Benutzern Statusaktualisierungen in Echtzeit bereitzustellen. Importieren Sie es beispielsweise in die Aktion Ausgelöst:

- [[DemoId]] und [[DemoSiteUrl]] -> Platzhalter von Listenfeldern zum Speichern von Demo-Informationen, die zum Aktualisieren der Demo-Anfrage erforderlich sind.

- Platzieren Sie die Aktion "Demo-Anfrage - In Bearbeitung", bevor die Demo-Bereitstellung beginnt. (Die demoId sollte von der Seite "Demoanforderung" erfasst und an diese Aktion übergeben werden.)

- Platzieren Sie die Aktion "Demo-Anfrage - Abgeschlossen", nachdem die Demo-Bereitstellung abgeschlossen ist. (Die demoId sollte von der Seite Demo Request erfasst und an diese Aktion übergeben werden. DemoSiteUrl bezieht sich auf die Demoumgebung, in der die Lösung bereitgestellt wird.)

4. Um die Benutzererfahrung zu verbessern, kann Ihre Demo-Anfrage-Seite eine Post-Nachricht senden, um den Status der Demo-Anfrage sofort zu aktualisieren und Fortschrittsaktualisierungen anzuzeigen. Zum Beispiel:

    ###CODE_BLOCK###
      var msg = "DEMO_INPROGRESS$$DEMO_ID";
    window.parent.postMessage(msg, "*");
    ###CODE_BLOCK###
       where DEMO_ID is value of demoId parameter
 

Teams Installation

Wenn Sie zur Registerkarte Installation wechseln, müssen Sie sich mit Ihrem Teams-Konto anmelden, um mit der Installation fortzufahren.

TeamsLogin.png



















Nachdem Sie angemeldet sind, führen Sie die Schritte aus, um die Installation Ihrer App abzuschließen:

Schritt 1: Vertrauen Sie dem Teamsware App Deployment Connector. Dies sollte vom SharePoint-Administrator des Mandanten einmal pro Mandant durchgeführt werden. 

InstallationStep1.png

















Schritt 2 – Angeben der SharePoint-Website: Dies ist erforderlich, um eine App auf der angegebenen Website zu installieren

InstallationStep2.png

















Schritt 3 – Zuweisen von Berechtigungen: Um die Berechtigung "Vollzugriff" in der Websitesammlung zuzuweisen, können Sie das Skript mithilfe von PnP PowerShell.
Import-Module PnP.PowerShell
Connect-PnPOnline -Url 'https://m365x46891638.sharepoint.com/sites/wineseller' -Interactive -ClientId <client id of your Microsoft Entra ID Application Registration>
Grant-PnPAzureADAppSitePermission -AppId 'f64d6c09-62be-4393-9ef8-45c581fc14e2' -DisplayName 'Teamsware App Deployment Connector' -Site 'https://m365x46891638.sharepoint.com/sites/wineseller' -Permissions fullcontrol
Read more about authentication for PnP PowerShell https://pnp.github.io/powershell/articles/authentication.html

InstallationStep3.png




















Schritt 4: Erstellen eines Websitesammlungs-App-Katalogs: Führen Sie das folgende PowerShell-Skript aus, um einen Websitesammlungs-App-Katalog zu erstellen, wenn er nicht mit PnP PowerShell.
Import-Module PnP.PowerShell
Connect-PnPOnline -Url 'https://m365x46891638.sharepoint.com/sites/wineseller' -Interactive -ClientId <client id of your Microsoft Entra ID Application Registration>
Add-PnPSiteCollectionAppCatalog -Site 'https://m365x46891638.sharepoint.com/sites/wineseller'

Step4AppCatalog.png




















Schritt 5: Bereitstellen der Lösung auf der Website.

InstallationStep5.png




















Warten Sie, bis die Lösung installiert ist

InstallYourApp.png













Schritt 6 – Zusätzlichen Connectors vertrauen (optional): Wenn Ihr Paket Aktionen enthält, die bestimmte Connectors genehmigen müssen, müssen Sie ihnen vertrauen, um die Bereitstellung ordnungsgemäß abzuschließen.

InstallationStep6.png

 















Aktualisieren der Teams App Bereitstellung

Wenn Sie nach der ersten Bereitstellung einige Änderungen an Ihrer Lösung vornehmen, müssen Sie ein neues Paket erstellen und dann die Bereitstellungsdefinition im Abschnitt Veröffentlichen in Teamsware Studio auswählen

TeamAppUpdateDeployment.png

















Klicken Sie auf die Schaltfläche Aktualisieren, um den Assistenten zu öffnen, der Sie durch das Aktualisieren eines Dienstes führt. Darüber hinaus können Sie beim Aktualisieren der Teamsware-App-Registrierung unterschiedliche Bereitstellungskonfigurationen für Erst- und Updatebereitstellungen konfigurieren. Dies bedeutet, dass bei jeder neuen Bereitstellung für diesen Dienst die Konfiguration aus den Erstbereitstellungen verwendet wird, während bei jedem Update die Konfiguration aus den Updatebereitstellungen verwendet wird

AppRegistrationUpdateStandard.png



















Dadurch werden keine Bereitstellungen automatisch aktualisiert, Sie haben jetzt 2 Möglichkeiten, sie separat zu aktualisieren:

- Wählen Sie eine Bereitstellung in Teamsware Studio aus und klicken Sie im rechten Bereich auf Aktualisieren

TeamsAppUpdateSite.png














- Navigieren Sie zur Teams-App in Microsoft Teams -> öffnen Sie die Registerkarte Installation und klicken Sie auf die Schaltfläche App aktualisieren. Die neue Version sollte erkannt werden.

TeamsAppMicrosoftUpdate.png















    • Related Articles

    • Teamsware Add-In-Bereitstellung - Fehler "Add-In ist nicht vertrauenswürdig" beim Navigieren zur Startseite

      Dieser Artikel hilft bei der Behebung eines Problems mit "Add-In ist nicht vertrauenswürdig, Sie sollten ihm vertrauen, bevor Sie es verwenden können" beim Navigieren zur Startseite des installierten Add-Ins. Meistens erscheint diese Meldung für neue ...

    • M365 Changelog: (Aktualisiert) SharePoint-Administratorsteuerung für die App-Registrierung/-Aktualisierung

      MC660075 - (Aktualisiert) SharePoint-Administratorsteuerung für die App-Registrierung/-Aktualisierung Nachrichtenzusammenfassung Hierbei handelt es sich um eine Erweiterung der Sicherheitsmaßnahmen für die administrative Governance, mit der die ...

    • Teamsware Studio Update 22.05.2025

      Neue Funktionen Teams App Bereitstellung Die Bereitstellung der Teams-App wurde hinzugefügt. Weitere Informationen finden Sie im Artikel Teams App deployment Aktion Abschnitt erweitern/reduzieren Die Aktion Abschnitt erweitern/reduzieren wurde zu ...

    • Teamsware Studio Update 21.11.2024

      Neue Funktionen Unterstützte Kommentare in den Formularen Anzeigen und Bearbeiten Die Spalte „Standort“ ist jetzt in den Formularen und im Expression Builder verfügbar Fehlerbehebungen und Verbesserungen Moderne Formulare Version 1.3.70 Geändertes ...

    • Teamsware Studio API deployment

      Hinweis: Um die Teamsware-API-Bereitstellung zu nutzen, überprüfen Sie Ihre Mandanteneinstellungen und erlauben Sie die benutzerdefinierte App-Authentifizierung wie hier hier beschrieben. Was ist das API Deployment Die API-Bereitstellung ist eine Art ...