Launch Param dan fungsi

Digunakan untuk: Apl kanvas

Melancarkan halaman web atau aplikasi kanvas dan menyediakan akses ke parameter pelancaran.

Launch

Melancarkan halaman web atau aplikasi kanvas. Fungsi menyokong:

Alamat (diperlukan), URL halaman web apl kanvas.
Parameter (pilihan), nilai dinamakan untuk dihantar ke halaman web atau aplikasi kanvas. Dalam apl kanvas, parameter boleh dibaca dengan Param fungsi.
Sasaran (pilihan), tab penyemak imbas untuk melancarkan halaman web atau aplikasi kanvas.

Launch hanya boleh digunakan dalam formula tingkah laku.

Nota

Jika Launch formula digunakan untuk membuka Power Apps dan apl tidak kelihatan kepada pengguna akhir, adalah disyorkan untuk menyemak sama ada apl disekat oleh penyekat timbul penyemak imbas atau jika penyemak imbas sedang menunggu respons pengguna kepada kotak dialog yang bertanya sama ada mereka mahu menavigasi ke skrin baharu.
Hanya https: URI disokong apabila digunakan Launch dalam Visual Power Apps dalam PowerBI.

Alamat

Halaman web dilancarkan melalui alamat URL. Contohnya:

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

Anda boleh melancarkan apl kanvas dengan pautan Web atau URI Apl (id apl yang diawali dengan/providers/Microsoft.PowerApps/apps/). Untuk mencari nilai ini untuk aplikasi:

Pergi ke Power Apps.
Pilih Aplikasi dari anak tetingkap navigasi kiri.
Pilih aplikasi anda.
Pilih Butiran dari menu atas.
Anda juga boleh memilih ... (Lebih Banyak Perintah) dan kemudian pilih Butiran dari menu juntai bawah.
Salin pautan Web.

Pautan web boleh digunakan di mana-mana halaman web dan akan melancarkan aplikasi kanvas. Ia juga boleh digunakan dengan fungsi tersebut Launch . Contohnya:

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

Aplikasi asli pada peranti tidak boleh dilancarkan secara terus. Mungkin ada pilihan tidak langsung yang tersedia di beberapa platform, seperti aplikasi asli memasang skema URL tersuai atau mendaftar dengan pelayar web untuk menawarkan pilihan untuk tapak web tertentu.

Parameter

Launch boleh menghantar parameter ke halaman web atau apl kanvas. Parameter boleh disediakan dalam dua cara:

Senarai argumen pasangan nilai nama. Contohnya:

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

Rekod bagi nilai medan. Contohnya:
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
Borang ini boleh menjadi lebih senang digunakan kerana ia menjadikan hubungan antara nama dan nilai lebih jelas. Ini satu-satunya borang yang menyokong pilihan argumen LaunchTarget.

Alamat dan parameter dikodkan URL sebelum dihantar untuk menggantikan aksara bukan aksara abjad angka tertentu dengan % dan nombor perenambelasan seolah-olah fungsi EncodeUrl telah digunakan pada setiap.

Semasa melancarkan halaman web, rentetan pertanyaan parameter boleh disertakan di akhir alamat URL. Sebarang parameter tambahan yang diberikan kepada Launch akan ditambah pada penghujung rentetan pertanyaan. Rentetan pertanyaan tidak berfungsi semasa melancarkan aplikasi kanvas.

Apabila melancarkan apl pada peranti mudah alih yang apl itu sudah berjalan, parameter tidak akan dimuat semula dalam apl yang sedang berjalan. Muat semula apl diperlukan untuk parameter dimuat semula.

Sasaran

Gunakan argumen LaunchTarget untuk menentukan tetingkap pelayar sasaran untuk membuka halaman web atau aplikasi. Gunakan salah satu daripada nilai enum LaunchTarget berikut atau sediakan nama tetingkap tersuai.

Enum LaunchTarget	Penerangan
Baru	Halaman web atau aplikasi dibuka dalam tetingkap atau tab baharu.
Menggantikan	Halaman web atau aplikasi menggantikan tetingkap atau tab semasa.
Nama	Daripada nilai enum, gunakan rentetan teks anda sendiri untuk menamakan tetingkap atau tab. Diri ialah nama dalaman sahaja yang hanya digunakan oleh Launch fungsi. Ini tidak memberi kesan dan tidak akan sepadan dengan tajuk tetingkap yang dilihat oleh pengguna anda. Jika tetingkap atau tab dengan yang diberikan nama telah wujud, kandungannya akan digantikan. Jika tidak, tetingkap atau tab baharu akan dicipta. nama tidak boleh bermula dengan aksara garis bawah "_".

Baru ialah enum lalai apabila dijalankan dalam pelayar web dengan Gantikan dan nama sebagai pilihan yang tersedia. Dalam pemain mudah alih, Baharu ialah lalai untuk laman web dengan nama sebagai pilihan tersedia; sementara aplikasi kanvas semasa akan sentiasa digantikan dengan aplikasi kanvas lain.

Nota

Menggunakan LaunchTarget dengan sebarang nilai selain Baharu dalam senario terbenam (contohnya, Power BI atau SharePoint) tidak disokong dan mungkin menyebabkan tingkah laku yang tidak diduga. Pada masa hadapan, tingkah laku ini mungkin berubah atau mungkin menyebabkan ralat.

Param

Fungsi ini Param mendapatkan semula parameter yang dihantar kepada apl apabila ia dilancarkan. Jika parameter yang dinamakan tidak diluluskan, Param mengembalikan kosong.

Apabila melancarkan aplikasi kanvas daripada aplikasi kanvas lain, gunakan argumen Parameter kepada Launch fungsi. Nama dan nilai parameter akan URL dikodkan secara automatik.
Semasa melancarkan aplikasi kanvas dari halaman web, tambahkan parameter kepada rentetan pertanyaan bagi pautan web aplikasi. Ini melibatkan penambahan &parametername=parametervalue dengan menganggap rentetan pertanyaan telah dimulakan untuk tenantId. Sebagai contoh, penambahan &First%20Name=Vicki&category=3 akan menghantar dua parameter: First Name dengan nilai "Vicki" dan category dengan nilai "3" (jenis nilai ialah teks). Nama dan nilai parameter harus dikodkan URL jika mengandungi ruang atau aksara khas, sama seperti menggunakan fungsi EncodeURL.
Param nama sensitif huruf besar.
Param nama dan nilai akan dinyahkodkan URL secara automatik untuk digunakan dalam apl anda.
Nilai parameter tidak berubah melainkan apl dimuatkan semula. Menggunakan Launch pada peranti mudah alih yang apl sudah berjalan tidak menyegarkan semula parameter.
Walaupun parameter mengandungi nombor, jenis yang dikembalikan oleh Param akan sentiasa menjadi rentetan teks. Penukaran kepada jenis lain secara automatik akan berlaku atau menggunakan penukaran yang jelas seperti fungsi Value untuk menukar secara jelas kepada nombor.

Nota

Untuk halaman tersuai, satu-satunya parameter yang diterima oleh halaman ialah: recordId dan entityName.

Sintaks

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

Alamat - Diperlukan. Alamat halaman web atau ID aplikasi yang akan dilancarkan.
ParameterNames – Pilihan. Nama parameter.
ParameterValues – Pilihan. Nilai parameter yang sepadan untuk menghantar ke aplikasi atau halaman web.

Launch( Alamat, { [ ParameterName1: ParameterValue1, ... ] } [, Sasaran Pelancaran ] )

Alamat - Diperlukan. Alamat halaman web atau ID aplikasi yang akan dilancarkan.
ParameterNames – Pilihan. Nama parameter.
ParameterValues – Pilihan. Nilai parameter yang sepadan untuk menghantar ke aplikasi atau halaman web.
Sasaran Pelancaran – Pilihan. Nilai LaunchTarget enum atau nama tersuai.

Param( ParameterName )

ParameterName - Diperlukan. Nama parameter yang dihantar ke aplikasi.

Parameter simpanan

Kata kunci berikut dikhaskan (tanpa mengira kes) untuk kegunaan dalaman, dan tidak boleh digunakan sebagai parameter tersuai dalam Paramfungsi ():

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
nyahpepijat
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
petunjuk
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
pemuat
loaderType
tempatan
lokasi
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
laman
skipappmetadata
skipiframecreation
skiplaunchappcache
sumber
Masa sumber
standaloneconsent
teamid
teamtype
tenantId
tema
uselocalpackagehostresources
userteamrole

Contoh

Mudah Launch

Dari aplikasi kanvas ke halaman web:

Formula	Penerangan
Launch( "http://bing.com/search", "q", "Power Apps", "kiraan", 1 )	Membuka halaman web https://bing.com/search?q=Power%20Apps& kiraan=1. Tetingkap atau tab baharu dibuka.
Launch( "http://bing.com/search", { q: "Power Apps", kiraan: 1 } )	Sama seperti contoh sebelumnya menggunakan notasi rekod yang setara. Tetingkap atau tab baharu dibuka.
Launch( "http://bing.com/search", { q: "Power Apps", kiraan: 1 }, LaunchTarget.Replace )	Sama seperti contoh sebelumnya, menggantikan tetingkap atau tab semasa dengan hasilnya jika dijalankan dalam pelayar web.
Launch( "http://bing.com/search", { q: "Power Apps", kiraan: 1 }, "Hasil Carian" )	Sama seperti contoh sebelumnya, mencipta atau mengganti kandungan tetingkap atau tab yang dinamakan Hasil Carian.

Dari aplikasi kanvas ke aplikasi kanvas

Kemas kini ID aplikasi, nama skrin dan nombor rekod yang sesuai.

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

Dari halaman web ke aplikasi kanvas

Kemas kini ID aplikasi, ID penyewa, nama skrin dan nombor rekod yang sesuai.

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

Mudah Param

Contoh pelancaran mudah di atas untuk melancarkan aplikasi kanvas dari halaman web atau dari aplikasi kanvas lain menunjukkan contoh mudah untuk Param fungsi:

Formula	Penerangan	Hasil
Param( "Menavigasi" )	Parameter Navigasi disediakan semasa aplikasi dilancarkan dan dikembalikan.	"Skrin Kedua"
Param( "Rekod" )	Parameter Rekod disediakan semasa aplikasi dilancarkan. Walaupun ia telah dihantar sebagai nombor kepada Launch fungsi, hasil daripada Param akan menjadi rentetan teks yang boleh ditukar secara tersirat atau eksplisit kepada jenis lain.	"34"
Param( "Pengguna" )	Parameter Pengguna tidak disediakan. Nilai kosong yang dikembalikan boleh diuji dengan fungsi IsBlank.	Kosong

Contoh langkah demi langkah untuk Launch dan Param

Templat tataletak tablet Peragaan Produk digunakan untuk contoh berikut. Untuk mencipta aplikasi dengan templat ini, ikuti langkah-langkah dari artikel cipta aplikasi dan pilih templat Peragaan Produk. Anda juga boleh menggunakan aplikasi anda sendiri.

Sebagai contoh- Launch

Pergi ke Power Apps.
Pilih Aplikasi dari anak tetingkap navigasi kiri.
Pilih aplikasi anda dan kemudian pilih Edit.
Pilih Sisip dari menu dan kemudian pilih Label.
Alihkan label ke kanan bawah skrin.
Dari anak tetingkap sifat di sebelah kanan, pilih Warna sebagai putih dan tetapkan Ketebalan sempadan pada 1.
Pilih sifat Teks dari sebelah kanan dan masukkan teks sebagai Tablet Surface dalam berita.
Daripada senarai sifat di sebelah kiri atas, pilih OnSelect.
Masukkan formula sebagai Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets"). Anda juga boleh menggunakan sebarang URL lain, parameter dan kata kunci pilihan anda.
Simpan dan terbitkan aplikasi.
Main aplikasi.
Pilih label Tablet Surface dalam berita untuk melancarkan carian berita dengan kata kunci tablet Microsoft Surface.

Tip

Untuk kebolehskalaan, anda boleh menggantikan kata kunci yang dimasukkan secara manual dalam fungsi dengan Launchpembolehubah.

Sebagai contoh- Param

Pergi ke Power Apps.
Pilih Aplikasi dari anak tetingkap navigasi kiri.
Pilih aplikasi anda dan kemudian pilih Edit.
Pilih Sisip dari menu dan kemudian pilih Label.
Alihkan label ke kanan bawah skrin.
Pilih sifat Teks untuk label dari kiri atas.
Masukkan formula sebagai Param("browser"). Anda juga boleh menggunakan parameter yang berbeza pilihan anda:
Simpan dan terbitkan aplikasi.
Salin pautan web untuk aplikasi anda dari Power Apps.
Buka pelayar baharu.
Tampal pautan web aplikasi dalam pelayar dan tambahkan &browser=Microsoft%20Edge pada akhirnya.
Apabila aplikasi anda dilancarkan, label menunjukkan nilai parameter yang dihantar.
Tutup pemain aplikasi dan edit aplikasinya.
Pilih Aplikasi dari pandangan pohon di sebelah navigasi kiri.
Pilih sifat StartScreen di bahagian atas sebelah kiri.
Masukkan formula sebagai If( Param("screen") = "techspecs", TechSpecs ).

Jika fungsi dalam sifat StartScreen menyemak sama ada parameter sama dengan nilai tertentu, dalam kes ini nilai techspecs. Dan jika ia sepadan, mengembalikan kawalan skrin TechSpecs kepada sifat StartScreen .

Nota

Gantikan nama kawalan TechSpecs dalam fungsi Jika dengan nama kawalan skrin dalam apl anda sendiri jika anda tidak menggunakan templat apl Pameran Produk.
Simpan dan terbitkan aplikasi.
Buka pelayar baharu.
Tampal pautan web aplikasi dalam pelayar dan tambahkan &screen=techspecs pada akhirnya.
Apl dilancarkan terus dengan TechSpecs sebagai skrin permulaan.

Lihat juga

Rujukan formula apl kanvas

Maklum balas

Adakah halaman ini membantu?

Last updated on 2025-10-10

Kongsi melalui

Launch Param dan fungsi

Launch

Alamat

Parameter

Sasaran

Param

Sintaks

Parameter simpanan

Contoh

Mudah Launch

Dari aplikasi kanvas ke halaman web:

Dari aplikasi kanvas ke aplikasi kanvas

Dari halaman web ke aplikasi kanvas

Mudah Param

Contoh langkah demi langkah untuk Launch dan Param

Sebagai contoh- Launch

Sebagai contoh- Param

Lihat juga

Maklum balas

Sumber tambahan