Dijeli putem


Launchi funkcije Param

Primjenjuje se na sljedeće: Aplikacije radnog područja

Pokreće web-stranicu ili aplikaciju radnog područja i pruža pristup parametrima pokretanja.

Launch

Pokreće web-stranicu ili aplikaciju radnog područja. Funkcija podržava sljedeće:

  • Adresa (obavezno), URL web stranice aplikacije radnog područja.
  • Parametri (neobavezno), imenovane vrijednosti koje se prosljeđuju web-stranici ili aplikaciji radnog područja. U aplikaciji platna parametri se mogu čitati pomoću Param funkcije.
  • Cilj (opcionalno), kartica preglednika u kojoj se pokreće web-stranica ili aplikacija radnog područja.

Launch može se koristiti samo u formulama ponašanja.

Napomena

  • Launch Ako se formula koristi za otvaranje aplikacije Power Apps, a aplikacija nije vidljiva krajnjem korisniku, preporučuje se da provjerite je li aplikaciju blokirao blokator skočnih prozora preglednika ili je preglednik čekati odgovor korisnika na dijaloški okvir u kojem se pita želi li doći do novog zaslona.
  • Samo https: URI-ji su podržani prilikom korištenja u značajci Launch Power Apps Visual u dodatku PowerBI.

Adresa

Web-stranice pokreću se putem URL adrese. Na primjer:

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

Aplikacije radnog područja možete pokrenuti s web-vezom ili URI-jem aplikacije (ID aplikacije s prefiksom ). /providers/Microsoft.PowerApps/apps/ Da biste pronašli ove vrijednosti za aplikaciju:

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite aplikaciju.

  4. Na gornjem izborniku odaberite Pojedinosti.
    Također, možete odabrati i ... (Dodatne naredbe), a zatim s padajućeg izbornika odabrati Detalji.

    Opcija pojedinosti o aplikaciji.

  5. Kopiraj web-poveznicu.

    Pojedinosti o aplikaciji s web-vezom i ID-om aplikacije.

Web-veza može se upotrebljavati na bilo kojoj web-stranici i pokrenut će aplikaciju radnog područja. Može se koristiti i s funkcijom Launch . Na primjer:

Launch( "https://apps.powerapps.com/e/{environment id}/a/{app id}?tenantId={tenantId}" )

Izvorne aplikacije na nekom uređaju ne mogu se izravno pokrenuti. Na nekim platformama mogu postojati neizravne mogućnosti, poput izvorne aplikacije koja instalira prilagođenu shemu URL-a ili se registrira putem web-preglednika kako bi se ponudila neka mogućnost za određene web-stranice.

Parametri

Launch može proslijediti parametre na web-stranicu ili aplikaciju platna. Parametri se mogu pružiti na dva načina:

  • Popis argumenata s parovima vrijednosti naziva. Na primjer:

    Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • Snimak vrijednosti polja. Na primjer:

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

    S ovim se obrascem može lakše raditi jer povezivanje naziva i vrijednosti postaje jasnije. To je jedini obrazac koji podržava izborni argument LaunchTarget.

Adresa i parametri se kodiraju pomoću URL-a prije nego što ih se proslijedi kako bi se zamijenili određeni nealfanumerički znakovi s % i heksadecimalnim brojem, kao da je za svaki korištena funkcija EncodeUrl.

Prilikom pokretanja neke web-stranice, niz upita parametara može se dodati na kraj URL adrese. Svi dodatni parametri za Launch koje je potrebno dodati će se na kraj niza upita. Nizovi upita ne rade prilikom pokretanja aplikacije radnog područja.

Prilikom pokretanja aplikacije na mobilnom uređaju na kojem je ta aplikacija već pokrenuta, parametri se neće osvježavati u pokrenutoj aplikaciji. Za osvježavanje parametara potrebno je ponovno učitavanje aplikacije.

Cilj

Upotrijebite argument LaunchTarget kako biste odredili ciljni prozor preglednika u kojem će se otvoriti ta web-stranica ili aplikacija. Koristite jednu od sljedećih vrijednosti enumeracije LaunchTarget ili pružite prilagođeni naziv prozora.

LaunchTarget enumeracija Opis
Nov Web-stranica ili aplikacija otvara se u novom prozoru ili kartici.
Nadomjestiti Web-stranica ili aplikacija zamjenjuje trenutačni prozor ili karticu.
ime Umjesto numeratorne vrijednosti prozoru ili kartici dodijelite naziv pomoću vlastitog tekstnog niza. Samo interni je naziv koji koristi samo Launch funkcija. Nema utjecaja niti će odgovarati naslovu prozora koji vide vaši korisnici. Ako prozor ili kartica s danim nazivom već postoji, njegov će se sadržaj zamijeniti. U suprotnom, stvorit će se novi prozor ili kartica. Ime ne može započeti znakom donje crte "_".

Novo je zadana enumeracija kada se izvodi u web-pregledniku s opcijama Zamijeni i nazovite kao dostupne. U mobilnom uređaju za reprodukciju Novo je zadano za web-stranice s nazivom kao dostupnom mogućnošću; dok će trenutnu aplikaciju od gotovih gradivnih elemenata uvijek zamijeniti druga aplikacija od gotovih gradivnih elemenata

Napomena

  • Korištenje LaunchTarget s bilo kojom vrijednošću osim Novo u ugrađenim scenarijima (na primjer, Power BI ili SharePoint) nije podržano i može rezultirati neočekivanim ponašanjem. U budućnosti se takvo ponašanje može promijeniti ili uzrokovati pogrešku.

Param

Funkcija Param dohvaća parametar proslijeđen aplikaciji prilikom pokretanja. Ako imenovani parametar nije proslijeđen, Param vraća polje prazno.

  • Prilikom pokretanja aplikacije platna iz druge aplikacije za platno funkciju koristite argumente Launch Parametar. Nazivi i vrijednosti parametara automatski će se kodirati URL-om.
  • Kada pokrećete neku aplikaciju radnog područja s neke web-stranice, dodajte parametre u niz upita od web-veze aplikacije radnog područja. To obuhvaća dodavanje &parametername=parametervalue pod pretpostavkom da je niz upita već pokrenut za tenantId. Na primjer, dodavanje &First%20Name=Vicki&category=3 proslijedilo bi dva parametra: First Name s vrijednošću "Vicki" i category s vrijednošću "3" (vrsta vrijednosti je tekst). Naziv i vrijednost parametra moraju biti kodirani URL-om ako sadrže razmake ili posebne znakove, slično upotrebi funkcije EncodeURL.
  • Param razlikuju velika i mala slova.
  • Param nazivi i vrijednosti automatski će biti dekodirani URL-om za korištenje u aplikaciji.
  • Vrijednosti parametara ne mijenjaju se ako se aplikacija ponovno ne učita. Korištenje Launch na mobilnom uređaju na kojem je aplikacija već pokrenuta ne osvježava parametre.
  • Čak i ako parametar sadrži broj, vrsta koju vraća Param uvijek će biti tekstni niz. Pretvaranje u druge vrste automatski će se dogoditi ili će upotrijebiti eksplicitne konverzije poput funkcije Value za eksplicitno pretvaranje u broj.

Napomena

Za prilagođene stranice jedini parametri koje stranica prihvaća su: recordId i entityName.

Sintaksa

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

  • Adresa – Obavezno. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
  • ParameterNames – Nije obavezno. Naziv parametra.
  • ParameterValues – Nije obavezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.

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

  • Adresa – Obavezno. Adresa web-stranice ili ID aplikacije koju treba pokrenuti.
  • ParameterNames – Nije obavezno. Naziv parametra.
  • ParameterValues – Nije obavezno. Odgovarajuće vrijednosti parametara koje treba proslijediti aplikaciji ili web-stranici.
  • LaunchTarget – Nije obavezno. LaunchTarget vrijednost enumeracije ili prilagođen naziv.

Param( ParameterName )

  • ParameterName - Obavezno. Naziv parametra proslijeđenog aplikaciji.

Rezervirani parametri

Sljedeće ključne riječi rezervirane su (bez obzira na slučaj) za internu upotrebu i ne smiju se koristiti kao prilagođeni parametar u Paramfunkciji ( ):

  • amp%3Bauthmode
  • amp%3Benableonbehalfof
  • amp%3Bhidenavbar
  • amp%3Blocale
  • appmetadataversion
  • authmode
  • channeltype
  • cordovapath
  • correlationid
  • ispravljanje pogrešaka
  • delegatelaunchurl
  • delegatelaunchurl
  • disablepreviewredirect
  • embedderorigin
  • enableonbehalfof
  • groupid
  • hideappsplash
  • hidenavbar
  • podsjetnik
  • hostclienttype
  • hostmode
  • iframecontainerid
  • isfullscreen
  • ispreviewmode
  • loader
  • loaderType
  • regionalna shema
  • lokacija
  • packagekind
  • packageproperties
  • playerresourcespath
  • playersessionid
  • powerappslanguage
  • screencolor
  • sdkversion
  • mjesto
  • skipappmetadata
  • skipiframecreation
  • skiplaunchappcache
  • ishodište
  • Vrijeme izvora
  • standaloneconsent
  • teamid
  • teamtype
  • tenantId
  • tema
  • uselocalpackagehostresources
  • userteamrole

Primjeri

Jednostavan Launch

Iz aplikacije radnog područja na web-stranicu:

Formula Opis
Launch( "http://bing.com/search",
"q", "Power Apps", "count", 1 )
Otvara web stranicu https://bing.com/search?q=Power%20Apps& broj=1. Otvara se novi prozor ili kartica.
Launch( "http://bing.com/search",
{ q: "Power Apps", broj: 1 } )
Isto kao prethodni primjeri, koristeći ekvivalentnu notaciju zapisa. Otvara se novi prozor ili kartica.
Launch( "http://bing.com/search",
{ q: "Power Apps", broj: 1 },
LaunchTarget.Replace )
Isto kao prethodni primjeri, zamjenjujući trenutačni prozor ili karticu rezultatom ako se izvodi u web-pregledniku.
Launch( "http://bing.com/search",
{ q: "Power Apps", broj: 1 },
"Rezultati pretraživanja" )
Isto kao u prethodnom primjeru, stvaranje ili zamjena sadržaja prozora ili kartice pod nazivom Search Results.

Iz jedne aplikacije radnog područja u drugu

Ažurirajte ID aplikacije, zaslonsko ime i broj zapisa prema potrebi.

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

S web-straniceu aplikaciju radnog područja

Ažurirajte ID aplikacije, ID klijenta, zaslonsko ime i broj zapisa prema potrebi.

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

Jednostavan Param

Gore navedeni primjeri jednostavnog pokretanja radi pokretanja aplikacije platna s web-stranice ili iz druge aplikacije za platno prikazuju jednostavne primjere Param za funkciju:

Formula Opis Rezultat
Param( "Navigacija" ) Parametar Navigate navodi se pri pokretanju aplikacije i vraća se. „Drugi zaslon”
Param( "Record" ) ("Zapis") Parametar Record navodi se pri pokretanju aplikacije. Iako je funkciji proslijeđen Launch kao broj, Param rezultat će biti tekstni niz koji se može implicitno ili eksplicitno pretvoriti u druge vrste. „34”
Param( "Korisnik" ) Parametar User nije naveden. Vraća se vrijednost prazno koja se može ispitati funkcijom IsBlank. prazno

Primjeri korak-po-korak za i LaunchParam

Za sljedeće primjere upotrijebljen je predložak izgleda za tablet Predstavljanje proizvoda. Da biste stvorili neku aplikaciju s ovim predloškom, slijedite korake iz članka stvaranje aplikacije i odaberite predložak Predstavljanje proizvoda. Možete koristiti i vlastitu aplikaciju.

Primjer- Launch

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite svoju aplikaciju, a zatim odaberite Uredi.

  4. U izborniku odaberite Umetni, a zatim odaberite Label.

  5. Pomaknite oznaku u donji desni dio zaslona.

  6. U oknu svojstava na desnoj strani, za Color odaberite white i postavite Border thickness na 1.

  7. Odaberite svojstvo Text s desne strane i unesite tekst kao Surface tablets in news.

  8. S popisa svojstava u gornjem lijevom kutu odaberite OnSelect.

  9. Unesite formulu kao Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Također, možete koristiti bilo koji drugi URL, parametar i ključne riječi po izboru.

    Launch primjer.

  10. Spremite i objavite aplikaciju.

  11. Pokrenite aplikaciju.

  12. Odaberite oznaku Surface tablets in news kako biste pokrenuli pretraživanje vijesti s ključnim riječima Microsoft Surface tablets.

Savjet

Za skalabilnost ručno unesene ključne riječi u funkciji možete zamijeniti Launchvarijablama.

Primjer- Param

  1. Idite na Power Apps.

  2. U lijevom navigacijskom oknu odaberite Aplikacije.

  3. Odaberite svoju aplikaciju, a zatim odaberite Uredi.

  4. U izborniku odaberite Umetni, a zatim odaberite Label.

  5. Pomaknite oznaku u donji desni dio zaslona.

  6. Odaberite svojstvo Text za oznaku u gornjem lijevom kutu.

  7. Unesite formulu kao Param("browser"). Također, možete koristiti neki drugi parametar po svom izboru.

    Param primjer.

  8. Spremite i objavite aplikaciju.

  9. Kopirajte internetsku vezu za vašu aplikaciju iz Power Apps,

  10. Otvorite novi preglednik.

  11. Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &browser=Microsoft%20Edge.

    Web adresa.

  12. Kad se vaša aplikacija pokrene, oznaka prikazuje proslijeđenu vrijednost parametra.

    Param primjer oznake.

  13. Zatvorite reproduktor aplikacije i uredite aplikaciju.

  14. Odaberite Aplikacija u prikazu stabla na lijevoj navigaciji.

  15. Odaberite svojstvo StartScreen u gornjem lijevom kutu.

  16. Unesite formulu kao If( Param("screen") = "techspecs", TechSpecs ).

    Param primjer za navigaciju.

    If funkcija u svojstvu StartScreen provjerava je li parametar jednak određenoj vrijednosti, u ovom slučaju vrijednost techspecs. A ako se podudara, vraća kontrolu zaslona Tehničke specifikacije svojstvu StartScreen .

    Napomena

    Zamijenite naziv kontrole Tehničke specifikacije u funkciji If nazivom kontrole zaslona u vlastitoj aplikaciji ako ne koristite predložak aplikacije Product Showcase .

  17. Spremite i objavite aplikaciju.

  18. Otvorite novi preglednik.

  19. Zalijepite internetsku vezu aplikacije u preglednik i na kraj dodajte &screen=techspecs.

    Web adresa za zaslon tehničkih specifikacija.

  20. Aplikacija se izravno pokreće s tehničkim specifikacijama kao početnim zaslonom.

Pogledajte

Referenca formule aplikacije radnog područja