Verwalten einer veröffentlichten Vorlagen-App

Wenn sich Ihre Power BI-Vorlagen-App in der Produktionsphase befindet, können Sie für gewünschte Änderungen an der App in die Testphase übergehen, ohne dass sich dies auf die App in der Produktionsphase auswirkt.

Aktualisieren Ihrer App

Navigieren Sie zum Arbeitsbereich für Vorlagen-Apps. Beginnen Sie dann mit Schritt 1, wenn Sie die Änderungen in Power BI Desktop vorgenommen haben. Beginnen Sie mit Schritt 2, wenn Sie keine Änderungen in Power BI Desktop vorgenommen haben.

  1. Laden Sie Ihr aktualisiertes Semantikmodell hoch, und stellen Sie sicher, dass Sie das vorhandene Semantikmodell überschreiben.

    • Wenn die hochgeladene PBIX-Datei den gleichen Namen wie das Semantikmodell und der Bericht aufweist, die in der App verwendet werden, wird das vorhandene Semantikmodell durch das Hochladen überschrieben.

    • Gehen Sie wie folgt vor, wenn Sie den Namen des in der App verwendeten Semantikmodells und Berichts ändern und die hochzuladende PBIX-Datei einen anderen Namen aufweist als das Semantikmodell und der Bericht, die in der App verwendet werden:

      • Benennen Sie das Semantikmodell und den Bericht um, die in der App verwendet werden, sodass deren Namen exakt mit dem Namen der hochgeladenen PBIX-Datei übereinstimmen.
      • Laden Sie die PBIX-Datei hoch und überschreiben Sie das Semantikmodell und den Bericht, die Sie soeben umbenannt haben.

      Um eine lokale PBIX-Datei in den Dienst hochzuladen, wählen Sie die Option Hochladen>Suchen aus, navigieren Sie zur Datei, und wählen Sie Öffnen aus. In einem Dialogfeld müssen Sie bestätigen, dass Sie das von der App verwendete Semantikmodell überschreiben möchten. Wenn Sie das vorhandene Semantikmodell nicht überschreiben, können Kunden Ihre aktualisierte App nicht installieren.

    Screenshot that shows the dialog requesting permission to overwrite the semantic model with the same name.

    Wichtig

    Löschen Sie niemals das Semantikmodell, das die App verwendet. Wenn Sie das Semantikmodell löschen, können Kunden ihre Kopien der App nicht aktualisieren.

  2. Wählen Sie im Release Management-Bereich der App App erstellen.

  3. Wiederholen Sie den Vorgang zum Erstellen einer App. Wenn Sie das Semantikmodell und den Bericht, die in der App verwendet werden, umbenannt haben, sollten Sie auch die App umbenennen.

  4. Nachdem Sie Branding, Navigation, Steuerung, Parameter, Authentifizierungund Zugriff festgelegt haben, wählen Sie erneut App erstellen aus, um Ihre Änderungen zu speichern, und wählen Sie dann Schließenaus.

  5. Wählen Sie erneut Release Management aus.

    Im Release Management-Bereich werden jetzt zwei Versionen der App angezeigt: die Version in der Produktionsphaseund eine neue Version in der Testphase.

    Screenshot that shows two versions of a template app.

  6. Wenn Sie bereit sind, Ihre App in die Präproduktionsphase höherzustufen, um Tests außerhalb Ihres Mandanten durchzuführen, wechseln Sie zurück in den Release Management-Bereich und wählen Sie Promote app (App höher stufen) neben Testing (Tests) aus.

    Sie verfügen jetzt über eine Version in der Produktions- und eine Version in der Präproduktionsumgebung.

    Screenshot that shows two versions of a template app with Promote app greyed out.

    Ihr Link ist nun live geschaltet.

    Hinweis

    Die Schaltfläche App höher stufen ist in der Präproduktionsphase ausgeblendet. Hierdurch wird verhindert, dass der Liveproduktionslink versehentlich mit der aktuellen App-Version überschrieben wird, bevor das Cloud-Partnerportal (CPP) diese überprüft und genehmigt.

  7. Senden Sie den Link noch mal an das CPP, indem Sie die Schritte unter Erstellen eines Power BI-App-Angebots befolgen. Im CPP müssen Sie Ihr Angebot nochmals veröffentlichen, überprüfen und genehmigen. Wenn Sie den Namen der App geändert haben, sollten Sie sicherstellen, dass Sie diesen auch im CPP ändern. Wenn Sie Ihr Angebot genehmigen, wird die Schaltfläche App höher stufen wieder aktiviert.

  8. Stufen Sie Ihre App in die Produktionsphase hoch.

Tabellenverhalten

  • Durch das Aktualisieren der App können Vorlagen-App-Installationsprogramme ihre Vorlagen-App in den bereits installierten Arbeitsbereichen aktualisieren, ohne die Verbindungskonfiguration zu verlieren.

  • Informationen dazu, wie sich Änderungen im Semantikmodell auf die installierte Vorlagen-App auswirken, finden Sie unter Überschreibverhalten.

  • Wenn eine Vorlagen-App überschrieben und aktualisiert wird, wird sie zuerst auf Beispieldaten zurückgesetzt. Anschließend wird die Verbindung mithilfe der Konfigurationsparameter des Installationsprogramms und der Authentifizierung automatisch wiederhergestellt. Bis die Aktualisierung abgeschlossen ist, wird in den Berichten, Dashboards und der Organisations-App das Beispieldatenbanner angezeigt.

  • Wenn Sie dem aktualisierten Semantikmodell, für das Benutzereingaben erforderlich sind, einen neuen Abfrageparameter hinzugefügt haben, müssen Sie das Kontrollkästchen Erforderlich auswählen. Dadurch wird das Installationsprogramm nach dem Aktualisieren der App aufgefordert, die Verbindungszeichenfolge anzugeben.

    Screenshot that shows Required under Parameters.

Extrahieren des Arbeitsbereichs

Das Zurücksetzen auf die vorherige Version einer Vorlagen-App ist mit der Extraktionsfunktion ganz einfach. Die folgenden Schritte extrahieren eine bestimmte App-Version aus einer Releasephase in einen neuen Arbeitsbereich:

  1. Wählen Sie im Release Management-Bereich neben einer App-Version die Option Weitere Optionen (...) und dann Extrahieren aus.

    Screenshot that shows the Release Management pane with Extract selected.

  2. Geben Sie im Bestätigungsdialogfeld einen Namen für den extrahierten Arbeitsbereich ein, und wählen Sie Extrahieren aus. Power BI fügt einen neuen Arbeitsbereich für die extrahierte App hinzu.

    Screenshot that shows the confirmation message to Extract this app.

Ihre neue Arbeitsbereichsversionsverwaltung wird zurückgesetzt, und Sie können die Vorlagen-App aus dem neu extrahierten Arbeitsbereich weiter entwickeln und verteilen.

Löschen der Vorlagen-App-Version

Ein Vorlagen-App-Arbeitsbereich ist die Quelle einer aktiven verteilten Vorlagen-App. Um die Benutzer*innen einer Vorlagen-App zu schützen, ist es nicht möglich, den Arbeitsbereich einer Vorlagen-App zu löschen, ohne zuvor alle erstellten App-Versionen im Arbeitsbereich zu entfernen. Beim Löschen einer App-Version wird gleichzeitig auch die App-URL gelöscht, die dann nicht mehr funktioniert.

  1. Wählen Sie im Release Management-Bereich neben der App-Version, die Sie löschen möchten, die Option Weitere Optionen (...) und dann Löschen aus.

    Screenshot that shows the Release Management pane with Delete selected.

  2. Wählen Sie im Bestätigungsdialogfeld Löschen.

    Screenshot that shows confirmation message to Delete this app.

Hinweis

Achten Sie darauf, dass Sie keine App-Versionen löschen, die von Kund*innen oder AppSource verwendet werden, da diese Versionen sonst nicht mehr funktionieren.