Launch- und Param-Funktionen

Gilt für: Canvas-Apps

Startet eine Webseite oder eine Canvas-App und bietet Zugriff auf Startparameter.

Launch

Startet eine Webseite oder eine Canvas-App. Die Funktion unterstützt:

  • Adresse (erforderlich), die URL der Webseite oder die App-URI (App-ID mit vorangestelltem Präfix /providers/Microsoft.PowerApps/apps/) der Canvas-App.
  • Parameters (optional), benannte Werte, die an die Webseite oder die Canvas-App übergeben werden sollen. In einer Canvas-App können Parameter mit der Param-Funktion gelesen werden.
  • Target (optional), die Browser-Registerkarte, auf der die Webseite oder die Canvas-App gestartet werden kann.

Launch kann ausschließlich in Verhaltensformeln eingesetzt werden.

Adresse

Webseiten werden über eine URL-Adresse gestartet. Zum Beispiel:

Launch( "https://bing.com" )

Sie können Canvas-Apps mit Weblink oder App-URI (App-ID mit vorangestelltem Präfix /providers/Microsoft.PowerApps/apps/) starten. So finden Sie diese Werte für eine App:

  1. Wechseln Sie zu Power Apps.

  2. Wählen Sie im linken Navigationsbereich die Option Apps aus.

  3. Wählen Sie Ihre App aus.

  4. Wählen Sie aus dem oberen Menü Details aus.
    Sie können auch ... (Weitere Befehle) für die App und dann Details aus dem Dropdown-Menü auswählen.

    Option für App-Details

  5. Kopieren Sie Weblink oder App ID.

    App-Details mit Weblink und App-ID

Der Weblink kann auf jeder Webseite verwendet werden und startet die Canvas-App. Es kann auch mit dem Launch-Funktion verwendet werden.

Die App-ID kann mit der Launch-Funktion verwendet werden, es muss aber /providers/Microsoft.PowerApps/apps/ vorangestellt werden. Beispiel:

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

Native Apps auf einem Gerät können nicht direkt gestartet werden. Auf einigen Plattformen sind möglicherweise indirekte Optionen verfügbar, z. B. eine native App, die ein benutzerdefiniertes URL-Schema installiert oder sich beim Webbrowser registriert, um eine Option für bestimmte Websites anzubieten.

Parameter

Launch kann Parameter an die Webseite oder die Canvas-App übergeben. Parameter können auf zwei Arten bereitgestellt werden:

  • Eine Argumentliste von Name-Wert-Paaren. Beispiel:

    Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • Eine Aufzeichnung von Feldwerten. Beispiel:

    Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
    

    Dieses Formular kann einfacher zu bearbeiten sein, da es die Zuordnung zwischen Name und Wert klarer macht. Es ist das einzige Formular, das das optionale LaunchTarget-Argument unterstützt.

Die Adresse und die Parameter werden vor der Übergabe URL-codiert, um bestimmte nicht alphanumerische Zeichen durch % zu ersetzen und eine hexadezimale Zahl, als ob die EncodeUrl-Funktion auf jede verwendet wurde.

Wenn Sie eine Webseite starten, kann eine Abfragezeichenfolge am Ende der URL-Adresse angegeben werden. Alle zusätzlichen Parameter für Launch werden am Ende der Abfragezeichenfolge hinzugefügt. Abfragezeichenfolgen funktionieren beim Starten einer Canvas-App nicht.

Wenn Sie eine App auf einem mobilen Gerät starten, auf dem diese App bereits ausgeführt wird, werden die Parameter in der ausgeführten App nicht aktualisiert. Für die Aktualisierung der Parameter ist ein Neuladen der App erforderlich.

Zielsprache

Verwenden Sie das LaunchTarget-Argument, um das Zielbrowserfenster anzugeben, in dem die Webseite oder App geöffnet werden soll. Verwenden Sie einen der folgenden LaunchTarget-Aufzählungswerte oder stellen Sie ein benutzerdefiniertes Fenster Name bereit.

LaunchTarget-Aufzählung Beschreibung
New Die Webseite oder App wird in einem neuen Fenster oder einer neuen Registerkarte geöffnet.
Replace Die Webseite oder App ersetzt das aktuelle Fenster oder die aktuelle Registerkarte.
name Verwenden Sie anstelle eines Aufzählungswerts Ihre eigene Textzeichenfolge, um das Fenster oder die Registerkarte zu benennen. Self ist ein interner Name, der nur von der Launch-Funktion verwendet wird. Es hat keine Auswirkungen auf den Titel des Fensters, den Ihre Benutzer sehen, und stimmt auch nicht mit diesem überein. Ist ein Fenster oder eine Registerkarte mit dem angegebenen Name bereits vorhanden, wird sein Inhalt ersetzt. Andernfalls wird ein neues Fenster oder eine neue Registerkarte erstellt. Name kann nicht mit dem Unterstrichmbeginnen „‑“.

New ist die Standardaufzählung bei der Ausführung in einem Webbrowser mit Replace und Name als verfügbare Optionen. In einem mobilen Player ist New die Standardeinstellung für Webseiten mit Name als verfügbare Option, während die aktuelle Canvas-App immer durch eine andere Canvas-App ersetzt wird.

Notiz

  • Die Verwendung von LaunchTarget mit einem anderen Wert als New in eingebetteten Szenarien (z. B. Power BI oder SharePoint) wird nicht unterstützt und kann zu unerwartetem Verhalten führen. Dieses Verhalten kann sich in Zukunft ändern oder einen Fehler verursachen.

Param

Die Param-Funktion ruft einen an die App übergebenen Parameter ab, wenn sie gestartet wurde. Wenn der benannte Parameter nicht übergeben wurde, gibt Paramleer zurück.

  • Verwenden Sie beim Starten einer Canvas-App von einer anderen Canvas-App die Parameter-Argumente für die Launch-Funktion. Parameternamen und -werte werden automatisch URL-codiert.
  • Fügen Sie beim Starten einer Canvas-App von einer Webseite aus Parameter zur Abfragezeichenfolge des Canvas-App Weblinks hinzu. Dies beinhaltet das Hinzufügen von &parametername=parametervalue, vorausgesetzt, die Abfragezeichenfolge wurde bereits für die tenantId gestartet. Durch das Hinzufügen von &First%20Name=Vicki&category=3 würden zwei Parameter übergeben: First Name mit einem Wert von "Vicki" und category mit einem Wert von "3" (Werttyp ist Text). Der Parametername und der Wert müssen URL-codiert sein, wenn sie Leerzeichen oder Sonderzeichen enthalten, ähnlich wie bei der Verwendung der EncodeURL-Funktion.
  • Bei Param-Namen wird die Groß-/Kleinschreibung beachtet.
  • Parameternamen und -werte werden automatisch zur Verwendung in Ihrer App per URL dekodiert.
  • Parameterwerte ändern sich nicht, es sei denn, die App wird neu geladen. Wenn Sie Starten auf einem mobilen Gerät verwenden, auf dem die App bereits ausgeführt wird, werden die Parameter nicht aktualisiert.
  • Auch wenn der Parameter eine Zahl enthält, wird der von Param zurückgegebene Typ immer eine Textzeichenfolge sein. Die Konvertierung in andere Typen erfolgt automatisch oder es werden explizite Konvertierungen wie die Value-Funktion zum expliziten Konvertieren in eine Zahl verwendet.

Anmerkung

Für benutzerdefinierte Seiten sind die einzigen von der Seite akzeptierten Parameter: recordId und entityName.

Syntax

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

  • Address – Erforderlich. Die Adresse einer Webseite oder die ID einer App, die gestartet werden soll.
  • ParameterName(s) – Optional. Parametername.
  • ParameterValue(s) – Optional. Entsprechende Parameterwerte, die an die App oder Webseite übergeben werden sollen.

Launch( Address, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

  • Address – Erforderlich. Die Adresse einer Webseite oder die ID einer App, die gestartet werden soll.
  • ParameterName(s) – Optional. Parametername.
  • ParameterValue(s) – Optional. Entsprechende Parameterwerte, die an die App oder Webseite übergeben werden sollen.
  • LaunchTarget – Optional. Ein LaunchTarget-Aufzählungswert oder ein benutzerdefinierter Name.

Param( ParameterName )

  • ParameterName – Erforderlich. Der Name des Parameters, der an die App übergeben wurde.

Reservierte Parameter

Die folgenden Schlüsselwörter sind für den internen Gebrauch reserviert (ungeachtet des Falls) und sollten nicht als benutzerdefinierter Parameter in der Param() Funktion verwendet werden:

  • amp%3Bauthmode
  • amp%3Benableonbehalfof
  • amp%3Bhidenavbar
  • amp%3Blocale
  • appmetadataversion
  • authmode
  • channeltype
  • cordovapath
  • correlationid
  • Debuggen
  • delegatelaunchurl
  • delegatelaunchurl
  • disablepreviewredirect
  • embedderorigin
  • enableonbehalfof
  • groupid
  • hideappsplash
  • hidenavbar
  • hint
  • hostclienttype
  • hostmode
  • iframecontainerid
  • isfullscreen
  • ispreviewmode
  • loader
  • loaderType
  • locale
  • location
  • packagekind
  • packageproperties
  • playerresourcespath
  • playersessionid
  • powerappslanguage
  • screencolor
  • sdkversion
  • site
  • skipappmetadata
  • skipiframecreation
  • skiplaunchappcache
  • source
  • sourcetime
  • standaloneconsent
  • teamid
  • teamtype
  • tenantId
  • theme
  • uselocalpackagehostresources
  • userteamrole

Beispiele

Einfache Launch-Funktion

Von einer Canvas-App zu einer Webseite:

Formel Description
Launch( „http://bing.com/search" “
„q“, „Power Apps“, „count“, 1 )
Öffnet die Webseite https://bing.com/search?q=Power%20Apps&count=1. Eine neue Registerkarte oder ein neues Fenster wird geöffnet.
Launch( „http://bing.com/search" “
{ q: „Power Apps“, count: 1 } )
Entspricht den vorherigen Beispielen unter Verwendung der entsprechenden Datensatznotation. Eine neue Registerkarte oder ein neues Fenster wird geöffnet.
Launch( „http://bing.com/search" “
{ q: „Power Apps“, count: 1 },
LaunchTarget.Replace )
Entspricht den vorherigen Beispielen und ersetzt das aktuelle Fenster oder die aktuelle Registerkarte durch das Ergebnis, wenn es in einem Webbrowser ausgeführt wird.
Launch( „http://bing.com/search" “
{ q: „Power Apps“, count: 1 },
Suchergebnisse )
Wie im vorherigen Beispiel wird der Inhalt des Fensters oder der Registerkarte mit dem Namen erstellt oder ersetzt Suchergebnisse.

Von einer Canvas-App zu einer Canvas-App

Aktualisieren Sie die App-ID, den Bildschirmnamen und die Datensatznummer entsprechend.

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

Von einer Webseite zu einer Canvas-App

Aktualisieren Sie die App-ID, Mandanten-ID, den Bildschirmnamen und die Datensatznummer entsprechend.

<html>
  <body>
    <a
      href="https://apps.powerapps.com/play/e/YOUR-APP-ENVIRONMENT-ID/a/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34"
    >
      Launch canvas app
    </a>
  </body>
</html>

Einfache Param-Funktion

Einfache Launch-Beispiele zum Starten einer Canvas-App über Webseite oder von einer anderen Canvas-App zeigen einfache Beispiele für die Param-Funktion:

Formel Beschreibung Ergebnis
Param( „Navigate“) Der Navigate-Parameter wurde beim Start der App angegeben und wird zurückgegeben. "Second Screen"
Param( „Record“) Der Record-Parameter wurde beim Start der App angegeben. Obwohl es als Nummer an die Launch-Funktion übergeben wurde, wird das Ergebnis von Param eine Textzeichenfolge sein, die implizit oder explizit in andere Typen konvertiert werden kann. "34"
Param( „User“) Das User-Parameter wurde nicht angegeben. Ein leerer Wert wird zurückgegeben, der mit der IsBlank-Funktion getestet werden kann. leer

Schritt für Schritt Beispiele für Launch und Param

Für die folgenden Beispiele wurde die Tablet-Layoutvorlage Produktvorstellung verwendet. Führen Sie die folgenden Schritte aus dem Artikel Erstellen einer App aus, um eine App mit dieser Vorlage zu erstellen und wählen Sie die Vorlage Produktausstellung aus. Sie können auch Ihre eigene App verwenden.

Beispiel – Launch

  1. Wechseln Sie zu Power Apps.

  2. Wählen Sie im linken Navigationsbereich die Option Apps aus.

  3. Wählen Sie Ihre App aus, und wählen Sie dann Bearbeiten aus.

  4. Wählen Sie Einfügen aus dem Menü aus und wählen Sie dann Label.

  5. Bewegen Sie das Etikett nach rechts unten auf dem Bildschirm.

  6. Wählen Sie im Eigenschaftenbereich auf der rechten Seite die Option Farbe als Weiß aus und legen Sie Border thickness auf 1 fest.

  7. Wählen Sie rechts die Text-Eigenschaft aus und geben Sie Text als Surface tablets in news ein.

  8. Wählen Sie in der Eigenschaftenliste oben links OnSelect aus.

  9. Geben Sie die Formel als Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets") ein. Sie können auch eine URL, einen Parameter und Schlüsselbegriffe Ihrer Wahl verwenden.

    Beispiel – Launch

  10. Sichern und veröffentlichen Sie die App.

  11. Führen Sie die App aus.

  12. Wählen Sie die Beschriftung Surface tablets in news aus, um die Nachrichtensuche mit Schlüsselwörtern Microsoft Surface tablets zu starten.

Tipp

Aus Gründen der Skalierbarkeit können Sie die manuell eingegebenen Schlüsselwörter in der Launch-Funktion durch Variablen ersetzen.

Beispiel – Param

  1. Wechseln Sie zu Power Apps.

  2. Wählen Sie im linken Navigationsbereich die Option Apps aus.

  3. Wählen Sie Ihre App aus, und wählen Sie dann Bearbeiten aus.

  4. Wählen Sie Einfügen aus dem Menü aus und wählen Sie dann Label.

  5. Bewegen Sie das Etikett nach rechts unten auf dem Bildschirm.

  6. Wählen Sie die Text-Eigenschaft für das Etikett von oben links.

  7. Geben Sie die Formel als Param("browser") ein. Sie können auch einen anderen Parameter Ihrer Wahl verwenden.

    Beispiel – Param

  8. Sichern und veröffentlichen Sie die App.

  9. Kopieren Sie den Weblink für Ihre App aus Power Apps.

  10. Öffnen Sie einen neuen Browser.

  11. Fügen Sie den App-Weblink in den Browser ein und hängen Sie ihn an &browser=Microsoft%20Edge am Ende an.

    Webadresse

  12. Beim Start Ihrer App wird auf dem Etikett der übergebene Parameterwert angezeigt.

    Beispieletikett – Param

  13. Schließen Sie den App Player und bearbeiten Sie die App.

  14. Wählen Sie App aus der Baumansicht auf der linken Seite aus.

  15. Wählen Sie die StartScreen-Eigenschaft oben links.

  16. Geben Sie die Formel als If( Param("screen") = "techspecs", TechSpecs ) ein.

    Param-Beispiel für die Navigation

    Die If-Funktion in der StartScreen-Eigenschaft prüft, ob der Parameter einem bestimmten Wert entspricht, in diesem Fall dem Wert techspecs. Und wenn es übereinstimmt, wird das TechSpecs-Bildschirmsteuerelement an die StartScreen-Eigenschaft zurückgegeben.

    Anmerkung

    Ersetzen Sie den Steuerelementnamen TechSpecs in der If-Funktion mit dem Namen eines Bildschirmsteuerelements in Ihrer eigenen App, wenn Sie nicht die App-Vorlage Produktausstellung verwenden.

  17. Speichern und veröffentlichen Sie die App.

  18. Öffnen Sie einen neuen Browser.

  19. Fügen Sie den App-Weblink in den Browser ein und hängen Sie ihn an &screen=techspecs am Ende an.

    Webadresse für den TechSpecs-Bildschirm

  20. Die App startet direkt mit TechSpecs als Startbildschirm.

Siehe auch

Canvas-App-Formelreferenz