Fungsi Pelancaran dan Param

Artikel
03/22/2024

Digunakan untuk: Aplikasi kanvas

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

Lancar

Melancarkan halaman web atau aplikasi kanvas. Fungsi menyokong:

Alamat (diperlukan), URL halaman web atau URI Aplikasi (id aplikasi dilekatkan dengan /providers/Microsoft.PowerApps/apps/) aplikasi kanvas.
Parameter (pilihan), nilai dinamakan untuk menghantar ke halaman web atau aplikasi kanvas. Dalam aplikasi kanvas, parameter boleh dibaca dengan fungsi Param.
Sasaran (pilihan), tab pelayar untuk melancarkan halaman web atau aplikasi kanvas.

Lancar hanya boleh digunakan dalam formula tingkah laku.

Alamat

Halaman web dilancarkan melalui alamat URL. Contohnya:

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

Anda boleh melancarkan apl kanvas dengan pautan Web atau URL Apl (id aplikasi dilekatkan 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 atau ID Aplikasi.

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

ID Aplikasi boleh digunakan dengan fungsi Launch tetapi mesti diawalkan dengan /providers/Microsoft.PowerApps/apps/. Contohnya:

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

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

Lancar boleh menghantar parameter ke halaman web atau aplikasi 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 Lancar akan ditambahkan pada penghujung rentetan pertanyaan. Rentetan pertanyaan tidak berfungsi semasa melancarkan aplikasi kanvas.

Apabila melancarkan aplikasi pada peranti mudah alih di mana apl itu sudah berjalan, parameter tidak akan disegar semula dalam apl yang sedang berjalan. Tambah nilai apl diperlukan untuk parameter disegar 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.

LaunchTarget enum	Penerangan
New	Halaman web atau aplikasi dibuka dalam tetingkap atau tab baharu.
Replace	Halaman web atau aplikasi menggantikan tetingkap atau tab semasa.
nama	Daripada nilai enum, gunakan rentetan teks anda sendiri untuk nama tetingkap atau tab. Diri ialah nama dalaman sahaja yang hanya digunakan oleh fungsi Lancar. 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 "_".

New ialah enum lalai apabila dijalankan dalam pelayar web dengan Replace dan name sebagai pilihan 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 Param mendapat kembali parameter yang dihantar ke aplikasi apabila ia dilancarkan. Jika parameter yang dinamakan tidak dihantar, Param akan mengembalikan kosong.

Semasa melancarkan aplikasi kanvas dari aplikasi kanvas lain, gunakan argumen Parameter kepada fungsi Launch. 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.
Nama param adalah sensitif huruf.
Nama dan nilai parameter akan dikod URL secara automatik untuk digunakan dalam aplikasi anda.
Nilai parameter tidak berubah melainkan apl dimuat semula. Menggunakan Pelancaran pada peranti mudah alih di mana aplikasi sudah berjalan tidak menyegarkan parameter.
Walaupun parameter mengandungi nombor, jenis 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

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

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

Lancar( Alamat, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

Alamat – Diperlukan. Alamat halaman web atau ID aplikasi yang akan dilancarkan.
ParameterName – Pilihan. Nama parameter.
ParameterValue – Pilihan. Nilai parameter yang sepadan untuk menghantar ke aplikasi atau halaman web.
LaunchTarget – Pilihan. Nilai LaunchTarget enum atau nama tersuai.

Param( ParameterName )

ParameterName - Diperlukan. Nama parameter yang dihantar ke aplikasi.

Parameter simpanan

Kata kunci berikut disimpan (tanpa mengira kes) untuk kegunaan dalaman dan tidak sepatutnya digunakan sebagai parameter tersuai dalam fungsi Param():

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

Contoh

Pelancaran mudah

Dari aplikasi kanvas ke halaman web:

Formula	Description
Lancar( "http://bing.com/search", "q", "Power Apps", "kiraan", 1 )	Membuka laman https://bing.com/search?q=Power%20Apps& web; kiraan = 1. Tetingkap atau tab baharu dibuka.
Lancar( "http://bing.com/search", { q: "Power Apps", count: 1 } )	Sama seperti contoh sebelumnya menggunakan notasi rekod yang setara. Tetingkap atau tab baharu dibuka.
Lancar( "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.
Lancar( "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>

Param mudah

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

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

Contoh Langkah demi Langkah untuk Lancar 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.

Contoh - Lancar

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 mengganti kata kunci yang dimasukkan secara manual dalam fungsi Lancar dengan pemboleh ubah.

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 ke sifat StartScreen .

Nota

Gantikan nama kawalan TechSpecs dalam fungsi If dengan nama kawalan skrin dalam apl anda sendiri jika anda tidak menggunakan templat aplikasi Product Showcase .
Simpan dan terbitkan aplikasi.
Buka pelayar baharu.
Tampal pautan web aplikasi dalam pelayar dan tambahkan &screen=techspecs pada akhirnya.
Aplikasi ini dilancarkan secara langsung dengan TechSpecs sebagai skrin permulaan.