Integrasikan aplikasi kanvas ke dalam tapak web dan perkhidmatan lain

Aplikasi yang anda bina selalunya paling berguna apabila ia tersedia di tempat orang melakukan kerja mereka. Dengan membenamkan aplikasi kanvas dalam iframe, anda boleh mengintegrasikan aplikasi tersebut ke dalam tapak web dan perkhidmatan lain seperti Power BI atau SharePoint.

Dalam topik ini, kami akan menunjukkan anda cara menetapkan parameter untuk pembenaman aplikasi; maka kami akan membenamkan aplikasi Pemesanan Aset dalam tapak web.

Nota

• Hanya pengguna Power Apps dalam penyewa sama yang boleh mengakses aplikasi terbenam.
• Pembenaman aplikasi kanvas dalam aplikasi desktop asli tidak disokong. Ini tidak termasuk integrasi pihak pertama seperti Power Apps dalam Pasukan).

Anda juga boleh mengintegrasikan aplikasi kanvas ke dalam SharePoint Online tapa menggunakan iframe. Maklumat lanjut: Gunakan bahagian web Power Apps.

Tetapkan parameter URI untuk aplikasi anda

Jika anda mempunyai aplikasi yang ingin dibenamkan, langkah pertama adalah menetapkan parameter untuk Pengecam Sumber Seragam (URI) supaya iframe tahu tempat untuk mencari aplikasi itu. URI dalam borang berikut:

https://apps.powerapps.com/play/[AppID]?source=iframe

Untuk pengguna GCC

https://apps.gov.powerapps.us/play/[AppID]?source=iframe

Penting

Mulai Ogos 2019, format URI telah berubah daripada https://web.powerapps.com/webplayer kepada https://apps.powerapps.com/play. Sila kemas kini mana-mana iframe terbenam untuk menggunakan format URI yang baharu. Rujukan ke format sebelumnya akan dihala semula ke URI baharu untuk memastikan keserasian.

Format sebelumnya:

https://web.powerapps.com/webplayer/iframeapp?source=iframe&appId=/providers/Microsoft.PowerApps/apps/[AppID]

Satu-satunya perkara yang perlu anda lakukan adalah menggantikan ID aplikasi anda untuk [AppID] dalam URI (termasuk '[' & ']'). Kami akan menunjukkan anda cara untuk mendapatkan nilai itu sebentar lagi tetapi berikut adalah semua parameter yang tersedia dalam URI:

• [appID] - Ia memberikan ID aplikasi untuk dijalankan.
• tenantid - adalah parameter pilihan untuk menyokong akses tetamu dan menentukan penyewa yang akan membuka aplikasi.
• screenColor - digunakan untuk memberikan pengalaman pemuatan aplikasi yang lebih baik untuk pengguna anda. Parameter ini berada dalam format RGBA (nilai merah, nilai hijau, nilai biru, alfa) dan mengawal warna skrin semasa aplikasi dimuatkan. Sebaiknya, tetapkan pada warna yang sama dengan ikon aplikasi anda.
• sumber - tidak mempengaruhi aplikasi tetapi kami mengesyorkan anda menambahkan nama deskriptif untuk merujuk kepada sumber pembenaman.
• Akhir sekali, anda boleh menambahkan sebarang parameter tersuai yang anda inginkan, menggunakanfungsi Param() dan nilai tersebut dapat digunakan oleh aplikasi anda. Ia ditambahkan pada penghujung URI seperti [AppID]?source=iframe&param1=value1&param2=value2. Parameter ini hanya dibaca semasa pelancaran aplikasi. Jika anda perlu mengubahnya, anda mesti melancarkan semula aplikasi. Perhatikan bahawa hanya item pertama selepas [appid] yang harus mempunyai "?"; setelah itu gunakan "&" seperti yang digambarkan di sini.

Dapatkan ID Aplikasi

ID aplikasi tersedia pada powerapps.com. Untuk aplikasi yang ingin anda benamkan:

1. Dalam powerapps.com, pada tab Aplikasi, klik atau ketik elipsis ( . . . ), kemudian Butiran.

   

2. Salin ID Aplikasi.

   

3. Gantikan nilai [AppID] dalam URI. Untuk aplikasi Pemesanan Aset kami, URI kelihatan seperti ini:

   https://apps.powerapps.com/play/76897698-91a8-b2de-756e-fe2774f114f2?source=iframe
   

Anda mungkin perlu membenarkan pop timbul dalam pelayar semasa membenamkan aplikasi dalam tapak web anda yang menggunakan fungsi Launch() untuk melancarkan tapak web atau aplikasi.

Benamkan aplikasi anda dalam tapak web

Membenamkan aplikasi anda sekarang adalah semudah menambahkan iframe kepada kod HTML untuk tapak web anda (atau perkhidmatan lain yang menyokong iframe seperti Power BI atau SharePoint):

<iframe width="[W]" height="[H]" src="https://apps.powerapps.com/play/[AppID]?source=website&screenColor=rgba(165,34,55,1)" allow="geolocation; microphone; camera"/>

Tentukan nilai untuk lebar dan tinggi iframe serta gantikan ID aplikasi anda dengan [AppID].

Nota

Sertakan allow="geolocation; microphone; camera" dalam kod HTML iframe anda untuk membenarkan aplikasi anda menggunakan keupayaan ini pada Google Chrome.

Imej berikut menunjukkan aplikasi Pemesanan Aset yang terbenam dalam tapak web sampel Contoso.

Ingat perkara berikut untuk mengesahkan pengguna aplikasi anda:

• Jika laman web anda menggunakan Microsoft Entra pengesahan berasaskan ID, tiada daftar masuk tambahan diperlukan.
• Jika tapak web anda menggunakan mekanisme daftar masuk lain atau tidak disahkan, pengguna anda akan melihat gesaan daftar masuk pada iframe. Setelah mereka daftar masuk, mereka akan boleh menjalankan aplikasi selagi penulis aplikasi mengongsinya dengan mereka.

Seperti yang anda lihat, pembenaman aplikasi adalah mudah dan hebat. Pembenaman membolehkan anda membawa aplikasi ke tempat yang anda dan pelanggan anda bekerja - tapak web, papan pemuka Power BI, halaman SharePoint dan banyak lagi.

Nota

Adakah anda boleh memberitahu kami tentang keutamaan bahasa dokumentasi anda? Jawab tinjauan pendek. (harap maklum bahawa tinjauan ini dalam bahasa Inggeris)

Tinjauan akan mengambil masa lebih kurang tujuh minit. Tiada data peribadi akan dikumpulkan (pernyataan privasi).