Funkcje Launch i Param

Artykuł
03/22/2024

Dotyczy: aplikacje kanwy

Uruchamia stronę sieci Web lub aplikację kanwy oraz daje dostęp do parametrów uruchamiania.

Launch

Uruchamia stronę sieci Web lub aplikację kanwy. Funkcja obsługuje:

Adres (wymagany), adres URL strony internetowej lub identyfikatora URI aplikacji (identyfikator aplikacji z prefiksem /providers/Microsoft.PowerApps/apps/) aplikacji kanwy.
Parametry (opcjonalne), nazwane wartości do przekazania do strony sieci Web lub aplikacji kanwy. W przypadku aplikacji kanwy parametry można odczytywać za pomocą funkcji Param.
Wartość docelowa (opcjonalna) – karta przeglądarki, w której ma zostać uruchomiona aplikacja sieci Web lub kanwy.

Funkcja Launch może być używana tylko w formułach zachowania.

Adres

Strony sieci Web są uruchamiane za pośrednictwem adresu URL. Na przykład:

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

Możesz uruchomić aplikacje kanwy za pomocą Łącza sieci Web lub Identyfikatora URI aplikacji (identyfikator aplikacji z /providers/Microsoft.PowerApps/apps/). Aby znaleźć te wartości w aplikacji:

Przejdź do Power Apps.
W lewym okienku nawigacji wybierz Aplikacje.
Wybierz aplikację.
Wybierz polecenie Szczegóły z górnego menu.
Można też użyć funkcji ... (Więcej poleceń) dla aplikacji, a następnie wybrać polecenie Szczegóły z menu rozwijanego.
Skopiuj łącze sieci Web lub Identyfikator aplikacji.

Łącze sieci Web może być użyte na dowolnej stronie sieci Web i zostanie uruchomiona aplikacja kanwy. Może być także używany za pomocą funkcji Launch.

Identyfikator aplikacji może być używany za pomocą funkcji Launch, ale musi być poprzedzony prefiksem /providers/Microsoft.PowerApps/apps/. Na przykład:

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

Macierzyste aplikacje na urządzeniu nie mogą być uruchamiane bezpośrednio. Na niektórych platformach mogą znajdować się opcje pośrednie, takie jak instalowanie niestandardowego schematu URL przez macierzystą aplikację lub rejestrowanie za pomocą przeglądarki sieci Web w celu oferowania opcji dla konkretnych witryn.

Parametry

Funkcja Launch może przekazać parametry do strony sieci Web lub aplikacji kanwy. Parametry można ustalić na dwa sposoby:

Lista argumentów z wartościami par nazw. Na przykład:

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

Rekord pól wartości. Na przykład:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Praca z tym formularzem może być łatwiejsza, ponieważ skojarzenie między nazwiskiem i wartością jest wyraźniejsze. Jest to jedyny formularz obsługujący opcjonalny argument LaunchTarget.

Adres i parametry są adresami URL zakodowanymi przed przesłaniem, aby zastępować niektóre znaki inne niż alfanumeryczne za pomocą % oraz cyfry szesnastkowe, tak jak gdyby dla każdej z nich była używana funkcja EncodeUrl.

Przy uruchamianiu strony sieci Web, ciąg zapytania parametrów może być dołączony na końcu adresu URL. Wszystkie dodatkowe parametry dodane do Launch, zostaną dodane na końcu ciągu zapytania. Ciągi zapytania nie działają podczas uruchamiania aplikacji kanwy.

Podczas uruchamiania aplikacji na urządzeniu mobilnym, na którym ta aplikacja jest już uruchomiona, parametry nie będą odświeżane w działającej aplikacji. Aby można było odświeżyć parametry, konieczne jest ponowne załadowanie aplikacji.

Target

Użyj argumentu LaunchTarget, aby określić docelowe okno przeglądarki, w którym ma zostać otwarta strona sieci Web lub aplikacja. Użyj jednej z następujących wartości wyliczanych LaunchTarget lub wprowadź niestandardową nazwę okna.

Wyliczenie LaunchTarget	Opis
New	Strony sieci Web lub aplikacji są otwierane w nowym oknie lub na karcie.
Replace	Strony sieci Web lub aplikacji nadpisują obecne okno lub kartę.
name	Zamiast wartości wyliczenia należy użyć własnego ciągu tekstowego w celu naliczenia nazwy okna lub karty. Wartość Self to nazwa, która jest tylko nazwą wewnętrzną, używaną tylko przez funkcję Launch. Nie ma wpływu na tytuł wyświetlanego okna, które widzą użytkownicy. Jeśli okno lub karta z podaną nazwą już istnieje, jego zawartość zostanie podmieniona. W przeciwnym razie zostanie utworzone nowe okno lub karta. Nazwa nie może zaczynać się od znaku podkreślenia „_”.

Opcja New jest domyślnym typem enum przy uruchamianiu w przeglądarce sieci Web zawierającej opcje Replace i name jako dostępne. W odtwarzaczu mobilnym Nowy jest domyślny dla stron sieci Web z nazwą dostępną jako dostępna; w czasie, gdy bieżąca aplikacja kanwy będzie zawsze zastępowana inną aplikacją kanwy.

Uwaga

Używanie wartości LaunchTarget z innymi wartościami niż Nowe w scenariuszach osadzonych (na przykładach Power BI lub SharePoint) nie jest obsługiwane i może powodować nieoczekiwane zachowanie. W przyszłości to zachowanie może ulec zmianie lub może powodować błąd.

Param

Funkcja Param pobiera parametr przekazywany do aplikacji podczas jej uruchamiania. Jeśli parametr o danej nazwie nie został przekazany, funkcja Param zwraca wartość pustą.

Podczas uruchamiania aplikacji kanwy z innej aplikacji kanwowej należy użyć argumentów Parameter w funkcji Launch. Nazwy parametrów i wartości będą automatycznie kodowane w adresie URL.
Podczas uruchamiania aplikacji kanwy ze strony sieci Web należy dodać parametry do ciągu zapytania łącza sieci Web aplikacji kanwy. Polega to na dodaniu &parametername=parametervalue, zakładając, że ciąg zapytania jest już uruchamiany dla tenantId. Na przykład dodanie &First%20Name=Vicki&category=3 skutkowałoby dodaniem dwóch parametrów: First Name o wartości "Vicki" lub category z wartością parametru "3" (typ wartości to tekst). Nazwa parametru i wartość atrybutu muszą być zakodowane w adresie URL, jeśli zawierają spacje lub znaki specjalne, podobnie jak w przypadku korzystania z funkcji EncodeURL.
W nazwach Param jest rozróżniana wielkość liter.
Nazwy parametrów i wartości będą automatycznie zdekodowane z adresu URL w celu użycia w aplikacji.
Wartości parametrów nie zmieniają się, jeśli aplikacja nie zostanie ponownie załadowana. Używanie funkcji Uruchom na urządzeniu mobilnym, na którym aplikacja jest już uruchomiona, nie powoduje odświeżenia parametrów.
Nawet jeśli parametr zawiera cyfrę, typem zwracanym przez Param jest zawsze ciąg tekstowy. Konwersja na inne typy będzie wykonywana automatycznie lub użyj konwersji jawnej, np. funkcja Value jawnie przeprowadzi konwersję na liczbę.

Uwaga

W przypadku stron niestandardowych jedynymi parametrami akceptowanych przez tę stronę są: recordId i entityName.

Składnia

Launch( Adres [, NazwaParametru1, WartośćParametru1, ... ] )

Adres – wymagane. Adres strony internetowej lub identyfikator aplikacji do uruchomienia.
NazwaParametru (lub nazwy parametrów) – opcjonalne. Nazwa parametru.
WartośćParametru (lub wartości parametrów) – opcjonalne. Odpowiednie wartości parametrów do przekazania do aplikacji lub strony internetowej.

Launch( Adres, { [ NazwaParametru1: WartośćParametru1, ... ] } [, LaunchTarget ] )

Adres – wymagane. Adres strony internetowej lub identyfikator aplikacji do uruchomienia.
NazwaParametru (lub nazwy parametrów) – opcjonalne. Nazwa parametru.
WartośćParametru (lub wartości parametrów) – opcjonalne. Odpowiednie wartości parametrów do przekazania do aplikacji lub strony internetowej.
LaunchTarget – opcjonalne. Wartość wyliczenia LaunchTarget niestandardowa nazwa.

Param( NazwaParametru )

NazwaParametru – wymagane. Nazwa parametru przekazywanego do aplikacji.

Parametry zastrzeżone

Poniższe słowa kluczowe są zarezerwowane (bez względu na wielkość liter) do użytku wewnętrznego i nie powinny być używane jako niestandardowe parametry w funkcji Param():

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

Przykłady

Proste uruchomienie

Uruchamianie aplikacji kanwy na stronie:

Formuła	Podpis
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Zostanie otwarta strona https://bing.com/search?q=Power%20Apps&count=1. Zostanie otwarte nowe okno lub karta.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Taki samo jak w poprzednich przykładach, przy użyciu równoważnych notacji rekordów. Zostanie otwarte nowe okno lub karta.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, LaunchTarget.Replace )	Taki samo, jak w poprzednich przykładach; powoduje zastąpienie bieżącego okna lub karty w celu wykonania operacji w przeglądarce sieci Web.
Launch( "http://bing.com/search", { q: "Power Apps", count: 1 }, "Search Results" )	Taki samo, jak poprzedni przykład, tworzenie lub zamienianie zawartości okna lub karty o nazwie Wyniki wyszukiwania.

Uruchamianie aplikacji kanwy w aplikacji kanwy

Zaktualizuj identyfikator aplikacji, nazwę ekranu i numer rekordu zależnie od potrzeb.

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

Uruchamianie aplikacji kanwy na stronie

Zaktualizuj identyfikator aplikacji, identyfikator dzierżawy, nazwę ekranu i numer rekordu zależnie od potrzeb.

<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>

Zwykły parametr

Proste przykłady uruchomienia umożliwiające uruchomienie aplikacji kanwy z poziomu strony sieci Web lub innej aplikacji kanwy – pokaż proste przykłady dla funkcji Param:

Wzór	Opis	Wynik
Param( "Navigate" )	Parametr Navigate był podawany podczas uruchamiania i zwracania aplikacji.	"Drugi ekran"
Param( "Record" )	Parametr Record był podawany podczas uruchamiania i zwracania aplikacji. Mimo że taki element został przekazany jako liczba do funkcji Launch, wynikiem Param będzie ciąg tekstowy, który może być jawnie lub jawnie konwertowany na inne typy.	"34"
Param( "User" )	Parametr Użytkownik nie został podany. Jest zwracana Pusta wartość, która może być testowana za pomocą funkcji IsBlank.	puste

Przykłady Launch i Param krok po kroku

W poniższych przykładach użyto układu formularzy Przykład reklamowy. Aby utworzyć aplikację z tym szablonem, wykonaj kroki opisane w artykule Tworzenie aplikacjii wybierz Szablon prezentacji produktów. Możesz także użyć własnej aplikacji.

Przykład – Launch

Przejdź do Power Apps.
W lewym okienku nawigacji wybierz Aplikacje.
Wybierz aplikację, a następnie wybierz Edytuj.
Z pierwszego menu wybierz Wstaw, a następnie wybierz opcję Etykieta.
Przenieś etykietę na dół ekranu.
W okienku właściwości po prawej stronie wybierz kolor jako biały i ustaw Grubość obramowania na 1.
Zaznacz właściwość Text po prawej stronie i wprowadź tekst Tablety Surface w wiadomościach.
Z listy właściwości, która znajduje się na górze po lewej, zaznacz pole wyboru OnSelect.
Wprowadź formułę Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Użytkownik może także zastosować wybrane przez siebie adresy URL, parametry i słowa kluczowe.
Zapisywanie i publikowanie aplikacji.
Odtwarzanie aplikacji.
Wybierz etykietęTablety Surface w wiadomościach, aby uruchomić wyszukiwanie wiadomości za pomocą słów kluczowych Tablety Microsoft Surface.

Napiwek

W przypadku pożądania większej skalowalności można zmienić ręcznie wprowadzone słowa kluczowe w funkcji Launch za pomocą zmiennych.

Przykład – Param

Przejdź do Power Apps.
W lewym okienku nawigacji wybierz Aplikacje.
Wybierz aplikację, a następnie wybierz Edytuj.
Z pierwszego menu wybierz Wstaw, a następnie wybierz opcję Etykieta.
Przenieś etykietę na dół ekranu.
Wybierz właściwość Text dla etykiety, na górze po lewej.
Wprowadź formułę Param("browser"). Można również użyć innego parametru dostosowanego przez użytkownika.
Zapisywanie i publikowanie aplikacji.
Skopiuj łącze sieci Web z adresem Twojej aplikacji z programu Power Apps.
Otwórz nową kartę.
Wklej łącze sieci Web aplikacji w przeglądarce i dołącz &browser=Microsoft%20Edge na końcu.
Po uruchomieniu aplikacji na etykiecie zostanie wyświetlona przekazana wartość parametru.
Zamknij odtwarzacz aplikacji i wyedytuj tę aplikację.
Wybierz opcję Aplikacja z widoku drzewa po lewej nawigacji.
Wybierz właściwość StartScreen z lewej górnej strony.
Wprowadź formułę If( Param("screen") = "techspecs", TechSpecs ).

Jeśli funkcja we właściwości StartScreen sprawdza, czy parametr jest równy określonej wartości, w tym przypadku wartość techspecs. Jeśli zostanie dopasowane, zwraca formant ekranu TechSpecs do właściwości StartScreen.

Uwaga

Zastąp nazwę kontrolki TechSpecs w funkcji If nazwą ekranu kontrolki w aplikacji, jeśli nie korzystasz z szablonu aplikacji Prezentacja produktów.
Zapisywanie i publikowanie aplikacji.
Otwórz nową kartę.
Wklej łącze sieci Web aplikacji w przeglądarce i dołącz &screen=techspecs na końcu.
Aplikacja jest bezpośrednio uruchamiana za pomocą TechSpecs na ekranie początkowym.