Halaman Antara Muka Disatukan (kawalan dihoskan)

Gunakan jenis kawalan yang dihoskan Halaman Antara Muka Disatukan untuk memuatkan URL atau halaman daripada aplikasi Antara Muka Disatukan dalam aplikasi dipacu model. Apabila halaman aplikasi dipacu model dimuatkan dalam kawalan yang dihoskan jenis ini, ia mengimbas halaman secara automatik untuk data daripada entiti dan mengisi parameter penggantian secara automatik.

Jenis kawalan yang dihoskan ini mendedahkan banyak tindakan dan peristiwa UII yang telah ditetapkan yang unik untuk pengendalian aplikasi dipacu model Windows, termasuk tindakan manipulasi senarai dan tindakan cari untuk memaparkan halaman carian pantas atau carian lanjutan.

Cipta kawalan yang dihoskan Halaman Antara Muka Disatukan

Semasa anda mencipta kawalan dihoskan baharu, medan pada skrin Kawalan Dihoskan Baharu berbeza-beza berdasarkan jenis kawalan dihoskan yang anda mahu cipta. Bahagian ini menyediakan maklumat tentang medan khusus yang unik kepada jenis kawalan yang dihoskan Halaman Antara Muka Disatukan.

Pada skrin Kawalan Dihoskan Baharu :

• Dalam kawasan Meja Perkhidmatan Disatukan , pilih Halaman Antara Muka Disatukan daripada senarai juntai bawah Jenis Komponen Meja Perkhidmatan Disatukan .

• Pilih Pra-ambil Data untuk memuatkan maklumat berkaitan bagi rekod entiti dalam konteks bersama-sama dengan halaman rekod entiti, tanpa perlu menunggu halaman web entiti penuh dimuatkan dalam aplikasi klien. Maklumat entiti yang diambil diisi dalam konteks Meja Perkhidmatan Disatukan, sekali gus membolehkan sebarang kawalan yang dihoskan untuk memaparkan maklumat entiti yang berkaitan dengan cepat dalam aplikasi klien. Ini boleh membantu ejen bertindak serta-merta atau memulakan perbincangan dengan pelanggan, menjimatkan masa interaksi yang penting.

• Daripada senarai juntai bawah Benarkan Berbilang Halaman , pilih Tidak (lalai) untuk menggantikan halaman aplikasi dipacu model yang sedang dipaparkan dan kemas kini sejarah penyemak imbas apabila Unified Service Desk menerima panggilan tindakan navigasi atau halaman dihalakan ke tab. Pilih Ya untuk mencipta senarai juntai bawah secara automatik apabila URL kedua dipanggil atau peraturan navigasi tetingkap menghalakan halaman ke tab. Ini membolehkan pengguna mencari dengan cepat antara halaman apl dipacu model yang dilampirkan pada kawalan ini. Selain itu, apabila anda memilih Ya, medan tambahan, Pelayar Maksimum, tersedia di mana anda boleh menentukan bilangan maksimum halaman yang akan dipaparkan dalam senarai juntai bawah.

• Dalam kawasan Sifat Biasa , pilih kotak semak Aplikasi adalah Global untuk mengesetkan kawalan yang dihoskan sebagai global. Kawalan yang dihoskan global boleh dipaparkan di luar sesi pelanggan. Kawalan seperti papan pemuka, dinding atau carian ejen adalah kegunaan biasa untuk kawalan yang dihoskan global. Kawalan yang dihoskan global tidak mempunyai keadaan khusus sesi, jadi apabila anda menukar sesi, kawalan yang dihoskan global yang sama ini kekal. Jika kotak semak ini tidak dipilih, kawalan yang dihoskan menjadi berasaskan sesi. Kawalan berasaskan sesi wujud dalam konteks sesi pelanggan. Jika pengguna bertukar kepada sesi lain, semua halaman daripada sesi sebelumnya disembunyikan.

• Medan Kumpulan Paparan memaparkan panel di mana kawalan yang dihoskan ini dipaparkan. MainPanel ialah pilihan yang paling biasa untuk jenis kawalan yang dihoskan ini.

Maklumat lanjut: Cipta atau edit kawalan yang dihoskan

Tindakan UII yang telah ditetapkan

Berikut ialah tindakan yang telah ditetapkan untuk jenis kawalan yang dihoskan ini.

Paparan Bersekutu

Tindakan ini memuatkan pandangan berkaitan tertentu. Pandangan ini biasanya diakses dengan mengembangkan nama rekod entiti dalam bar navigasi dan memilih entiti yang berkaitan.

Parameter_	Perihalan
etn	Nama entiti yang anda mahu memuatkan senarai rekod entiti yang berkaitan. Ini adalah parameter mandatori.
ID	ID rekod entiti utama untuk memaparkan rekod entiti yang berkaitan.
navItemId	ID item navigasi yang sepadan dengan entiti yang berkaitan. Maklumat lanjut: formContext.ui.navigation
menyembunyikan Bar Perintah	Jika parameter ini dibekalkan dan False, halaman akan dipaparkan bersama-sama dengan bar arahan apl dipacu model.
menyembunyikanBar Navigasi	Jika parameter ini dibekalkan dan False, halaman dipaparkan bersama-sama dengan bar navigasi apl dipacu model.

Tutup

Tindakan ini digunakan untuk menutup kawalan yang dihoskan. Tidak seperti tindakan CloseActive , jika tab ini (kawalan dihoskan) memaparkan lebih daripada satu halaman, tindakan ini menutup semua halaman yang dipaparkan dalam tab dalam aplikasi ejen anda.

Tutup Aktif

Tindakan ini digunakan untuk menutup tetingkap aktif dalam kawalan yang dihoskan ini. Jika tetingkap aktif ialah satu-satunya tetingkap yang dipaparkan dalam kawalan yang dihoskan, kawalan yang dihoskan itu sendiri akan ditutup. Untuk kawalan yang dihoskan Halaman Antara Muka Disatukan yang tidak membenarkan berbilang halaman (Benarkan Berbilang Halaman = Tidak ), tindakan ini bersamaan dengan tindakan Tutup .

Tutup dan Prompt

Tindakan ini menutup kawalan yang dihoskan, tetapi menggesa pengguna untuk menyimpan atau meninggalkan perubahan mereka sebelum menutup.

Mencari

Navigasi ke pandangan senarai carian pantas entiti yang ditentukan.

Parameter_	Perihalan
Lihat penerangan	Parameter data hendaklah menentukan nama logik entiti bagi pandangan senarai carian pantas untuk dipaparkan. Terdapat beberapa nilai kes khas: - Gunakan kes atau insiden untuk memaparkan paparan senarai carian pantas untuk kes. - Gunakan aktiviti atau aktiviti untuk memaparkan paparan senarai carian pantas untuk aktiviti.
menyembunyikanBar Navigasi	Tetapkan kepada Benar untuk menyembunyikan bar navigasi, jika tidak, Salah.
menyembunyikan Bar Perintah	Tetapkan kepada Benar untuk menyembunyikan bar perintah, jika tidak, Salah.

Acara Kebakaran

Melancarkan peristiwa yang ditakrifkan pengguna daripada kawalan yang dihoskan ini.

Parameter_	Perihalan
nama	Nama peristiwa yang ditakrifkan pengguna.

Semua pasangan nama/nilai berikutnya menjadi parameter kepada peristiwa. Maklumat lanjut: Buat acara yang ditakrifkan pengguna

GetSelectedIds

Tindakan ini digunakan untuk mendapatkan semula ID yang dipilih daripada senarai.

Parameter_	Perihalan
Lihat penerangan	Parameter data hendaklah menentukan nama senarai untuk menangkap ID yang dipilih.

Nilai pulangan mengandungi senarai ID yang dihadkan dengan titik koma yang mengandungi item yang dipilih.

GetSelectedCount

Tindakan ini mendapatkan semula bilangan item yang dipilih. Gunakan tindakan GetSelectedIds untuk mendapatkan senarai sebenar ID untuk entiti.

Parameter_	Perihalan
Lihat penerangan	Parameter data hendaklah menentukan nama senarai untuk mendapatkan semula ID yang dipilih.

Nilai pulangan mengandungi nombor yang mewakili kuantiti item yang dipilih.

Pergi ke Rumah

Tindakan ini pergi ke URL awal yang ditentukan untuk tika penyemak imbas ini.

Kembali

Tindakan ini bersamaan dengan memilih butang kembali dalam contoh penyemak imbas.

Maju ke hadapan

Tindakan ini bersamaan dengan memilih butang hadapan dalam contoh penyemak imbas.

Bergerak ke Panel

Tindakan ini mengalihkan kawalan yang dihoskan Halaman Antara Muka Disatukan ke panel lain pada masa jalan.

Parameter_	Perihalan
Lihat penerangan	Parameter data hendaklah menentukan nama panel sasaran untuk mengalihkan kawalan yang dihoskan (contohnya, FloatingPanel).

Menavigasi

Tindakan ini digunakan untuk menavigasi ke URL aplikasi dipacu model. Id Apl untuk apl yang anda pilih daripada tetingkap Pilih Modul Apl ditambahkan secara automatik.

Parameter_	Perihalan
Url	URL untuk dinavigasi. Ini adalah parameter mandatori.
Sembunyikan Bar Perintah	Jika parameter ini dibekalkan dan Benar, bingkai dalam dipaparkan tanpa memuatkan bar arahan apl dipacu model.
SembunyikanBar Navigasi	Jika parameter ini dibekalkan dan Benar, borang dipaparkan tanpa memuatkan bar navigasi apl dipacu model.
Rangka	Apabila bingkai wujud pada halaman, parameter ini menentukan nama bingkai untuk dinavigasi, dan bukannya menavigasi tetingkap utama.
Postdata	Data yang dihantar ke pelayan sebagai sebahagian daripada transaksi HTTP POST. Transaksi POST biasanya digunakan untuk menghantar data yang dikumpulkan oleh halaman HTML. Dalam Meja Perkhidmatan Disatukan, data ini boleh diterima daripada sebarang peristiwa yang dicetuskan dengan menggunakan "'https://event/?'". Contoh: [[postdata]+] Sebagai alternatif, data boleh dihantar sebagai rentetan yang dikodkan dengan jenis pengepalanya dalam format yang dimaksudkan.
Pengepala	Nilai rentetan yang mengandungi pengepala HTTP tambahan untuk dihantar ke pelayan. Apabila parameter postdata digunakan dalam tindakan Navigasi , anda juga harus menentukan nilai yang sesuai untuk parameter pengepala, contohnya Content-Type: application/x-www-form-urlencoded Jika peristiwa POST Meja Perkhidmatan Disatukan mencetuskan tindakan Navigasi , nilai lalai parameter ini hendaklah header=[[header]+] Untuk menambah berbilang pengepala, nilai parameter ini hendaklah: header=$Multiline(tajuk dipisahkan oleh baris baru) Sebagai contoh: header=$Multiline(accessToken;dummyAccessToken== refreshToken;dummyRefreshToken===)

New_CRM_Page

Mencipta halaman untuk mencipta rekod baharu entiti yang ditentukan dan menganggap halaman sebagai tetingkap pop timbul daripada kawalan yang dihoskan yang ditentukan. Peraturan navigasi tetingkap dinilai untuk menentukan lokasi di mana halaman untuk mencipta rekod entiti dipaparkan.

Parameter_	Perihalan
Nama logik	Nama logik entiti untuk mencipta tika baharu.

Nota

Selebihnya parameter hendaklah terdiri daripada pasangan nama/nilai. Ini ialah nilai pra-isi tambahan dalam borang untuk mencipta rekod baharu untuk entiti yang ditentukan.

Open_CRM_Page

Membuka tika sedia ada entiti yang ditentukan dan dikenal pasti oleh ID dan menganggap halaman sebagai tetingkap pop timbul daripada kawalan yang dihoskan yang ditentukan. Peraturan navigasi tetingkap dinilai untuk menentukan lokasi di mana tetingkap pop timbul hendaklah dipaparkan.

Parameter_	Perihalan
Nama logik	Nama logik entiti yang akan dibuka.
ID	ID rekod entiti untuk dibuka.

Popup

"Muncul" URL daripada kawalan yang dihoskan dan menjalankan peraturan navigasi tetingkap terhadapnya untuk menghalakan tetingkap pop timbul ke lokasi yang sesuai.

Parameter_	Perihalan
Url	Menghalakan tetingkap pop timbul daripada kawalan yang dihoskan ini dengan menggunakan URL ini seolah-olah ia adalah tetingkap pop timbul yang diminta daripada kawalan yang dipaparkan.
Rangka	Bingkai dari mana tetingkap pop timbul ini berasal.

Penjajaran Semula Tetingkap

Memaparkan kawalan yang dihoskan di lokasi yang ditentukan pada monitor. Anda boleh memaparkan kawalan yang dihoskan pada sehingga dua monitor. Tindakan ini boleh digunakan untuk tika kawalan yang dihoskan yang dikonfigurasikan untuk diletakkan pada jenis panel USDFloatingPanel atau USDFloatingToolPanel.

Parameter_	Perihalan
Skrin	Menentukan skrin untuk memaparkan kawalan yang dihoskan. Nilai yang sah ialah 1 atau 2. Jika anda tidak menentukan parameter ini, 1 dihantar secara lalai.
Kiri	Menentukan kedudukan, dalam peratusan, dari kiri skrin pada monitor sasaran di mana kawalan yang dihoskan hendaklah dipaparkan. Nilai yang sah adalah dari 0 hingga 100. Jika anda tidak menentukan parameter ini, 0 dihantar secara lalai.
atas	Menentukan kedudukan, dalam peratusan, dari bahagian atas skrin pada monitor sasaran di mana kawalan yang dihoskan hendaklah dipaparkan. Nilai yang sah adalah dari 0 hingga 100. Jika anda tidak menentukan parameter ini, 0 dihantar secara lalai.
lebar	Menentukan lebar, dalam peratusan, tetingkap kawalan yang dihoskan pada monitor sasaran. Nilai yang sah adalah dari 1 hingga 100. Jika anda tidak menentukan parameter ini, 100 dihantar secara lalai.
tinggi	Menentukan ketinggian, dalam peratusan, tetingkap kawalan yang dihoskan pada monitor sasaran. Nilai yang sah adalah dari 1 hingga 100. Jika anda tidak menentukan parameter ini, 100 dihantar secara lalai.

Segar Semula

Tindakan ini menyegarkan semula halaman semasa.

RunScript

Tindakan ini menyuntik JavaScript ke dalam bingkai utama aplikasi. Anda harus mengelak daripada menggunakan panggilan SDK klien Microsoft Dataverse dengan tindakan ini; sebaliknya, gunakan tindakan RunXrmCommand .

Parameter_	Perihalan
Lihat penerangan	Parameter data ialah JavaScript yang disuntik ke dalam borang. Ambil perhatian: Parameter penggantian boleh digunakan dalam skrip, dan ia diganti sebelum skrip dilaksanakan.
Rangka	Apabila bingkai wujud pada halaman, parameter ini menentukan nama bingkai untuk menyuntik JavaScript.

RunXrmCommand

Tindakan ini digunakan untuk menjalankan kod JavaScript yang menggunakan aplikasi dipacu model Rujukan API Pelanggan ke dalam Halaman Antara Muka Disatukan (borang entiti dan grid).

Anda mesti mengkonfigurasi skrip sebagai fungsi aplikasi dipacu model JavaScript webResource. Parameter pertama fungsi ialah parameter konteks (parameter terpelihara) yang boleh mempunyai salah satu daripada nilai berikut:

• FormContext pada halaman borang entiti
• GridContext pada halaman grid entiti
• tidak ditakrifkan pada halaman lain

Parameter_	Perihalan
webResourceName	Nama sumber web di mana fungsi JavaScript yang anda mahu laksanakan hadir.
functionName	Nama fungsi.

Parameter lain untuk fungsi ini ditakrifkan oleh pelanggan dan boleh digunakan untuk melepasi parameter penggantian Meja Perkhidmatan Disatukan pada masa jalan. Tindakan ini menerima senarai parameter pilihan tanpa kunci. Senarai parameter pilihan diluluskan sebagai hujah dalam susunan yang sama dari kedudukan kedua selepas penggantian konteks pada masa jalan.

Contoh

Anda mahu melaksanakan tindakan RunXrmCommand untuk mengisi atribut borang borang entiti, di mana borang entiti dihoskan oleh jenis kawalan yang dihoskan Halaman Antara Muka Disatukan. Nilai yang anda mahu isi, dari perspektif Meja Perkhidmatan Bersepadu, ialah parameter penggantian—[[$Context.Key1]].

Untuk melaksanakan tindakan, anda perlu menulis sumber web jenis JavaScript (katakan, webResource1), dan kemudian menulis fungsi dalam sumber web.

function fillAttributeValue(context, attrValue)
{
 context.getAttribute(<attributeName>).setValue(attrValue);
}   

Anda perlu mengkonfigurasi data dalam panggilan tindakan seperti berikut:

webResourceName = webResource1
functionName = fillAttributeValue
'[[$Context.Key1]]'

Nota

Dalam contoh di atas, perhatikan tanda petikan tunggal di sekeliling parameter penggantian, [[$Context.Key1]]. Meja Perkhidmatan Disatukan hanya mempertimbangkan nilai parameter (bukan jenis data) dan menghantar semua aksara dalam nilai digantikan konteks kepada fungsi JavaScript. Anda mesti berhati-hati dan menjaga jenis data semasa mengkonfigurasi.

SetSaiz

Tindakan ini secara eksplisit menetapkan lebar dan ketinggian kawalan yang dihoskan. Ini berguna apabila menggunakan "auto" dalam susun atur panel anda.

Parameter_	Perihalan
lebar	Lebar kawalan yang dihoskan.
tinggi	Ketinggian kawalan yang dihoskan.

Simpan dan Tutup

Tindakan ini menyimpan data "kotor" pada borang apl dipacu model dan menutup kawalan yang dihoskan.

Simpan Semua

Tindakan ini menyimpan semua borang dalam kawalan yang dihoskan yang membolehkan berbilang halaman dipaparkan (Benarkan Berbilang Halaman = Ya). Jika kawalan yang dihoskan membenarkan hanya satu halaman dipaparkan (Benarkan Berbilang Halaman = Tidak ), ini bersamaan dengan tindakan Simpan .

Simpan

Tindakan ini menyimpan Halaman Antara Muka Disatukan semasa.

Peristiwa yang telah ditetapkan

Peristiwa pratakrif berikut dikaitkan dengan jenis kawalan yang dihoskan ini.

AktifTertutup

Berlaku apabila kawalan yang dihoskan aktif ditutup dengan menggunakan tindakan CloseActive .

Parameter_	Perihalan
Url	URL yang dipaparkan dalam kawalan yang dihoskan apabila ia ditutup.

Sedia Data

Berlaku sebaik sahaja maklumat berkaitan untuk rekod entiti dimuatkan dalam konteks Meja Perkhidmatan Disatukan. Peristiwa ini berlaku sebelum acara PageReadyFor. Jika opsyen Data Pra-Ambil dipilih untuk tika kawalan, peristiwa ini berlaku sebaik sahaja data entiti diambil dalam panggilan selari yang berasingan ke pelayan dan tidak akan menunggu halaman penuh selesai dimuatkan. Data entiti telah diambil terlebih dahulu dan acara DataReady diaktifkan untuk navigasi sebaris juga.

Nota

Untuk papan pemuka, sumber web dan halaman carian, acara DataReady tidak dipecat.

Segarkan Diminta

Berlaku apabila muat semula diminta pada halaman semasa. Muat semula boleh diminta sama ada dengan menekan kekunci F5 atau memanggil tindakan Muat Semula oleh aplikasi.

Parameter_	Perihalan
Url	URL yang dipaparkan apabila muat semula diminta.

Disimpan

Berlaku selepas rekod dalam halaman aplikasi dipacu model disimpan.

Parameter_	Perihalan
newId	ID yang diberikan kepada rekod yang baru dicipta.

Navigasi Diminta

Berlaku apabila navigasi berlaku dalam apl Antara Muka Disatukan.

Parameter_	Perihalan
Url	URL halaman yang dilayari.

Sedia Halaman

Berlaku apabila halaman telah selesai dimuatkan. Pada jenis kawalan yang dihoskan Halaman Antara Muka Disatukan, peristiwa ini berlaku selepas data telah disimpan ke senarai parameter gantian.

Parameter_	Perihalan
Url	URL halaman yang telah selesai dimuatkan.

Nota

Untuk papan pemuka, sumber web dan halaman carian, acara DataReady tidak dipecat.

Penyemak imbasTetingkapSedia

Peristiwa BrowserWindowReady dipanggil apabila tetingkap penyemak imbas sedia dalam aplikasi klien Meja Perkhidmatan Disatukan. Gunakan BrowserWindowReady untuk papan pemuka dan sumber web.

OnClickToAct

Peristiwa OnClickToAct digunakan apabila pengguna memilih medan komunikasi keluar (ClickToAct) dalam borang.

Anda juga boleh menulis kawalan tersuai untuk menaikkan acara tetingkap ClickToAct Rangka Kerja Penyepaduan Saluran dan lulus sebarang eventData mengikut keperluan perniagaan.

Maklumat lanjut: onclicktoact

Artikel OnSendKb

Peristiwa OnSendKbArticle digunakan apabila pengguna memilih Hantar dalam kawalan Pangkalan Pengetahuan. eventData ialah URL dan tajuk artikel KB yang perlu anda luluskan.

Maklumat lanjut: onsendkbarticle

Nota

Kami mengesyorkan agar anda tidak menggunakan window.IsUSD dalam borang aplikasi dipacu model; sebaliknya, gunakan PageReady atau acara lain seperti yang disenaraikan dalam topik ini.

Lihat juga

Sokongan untuk Apl Antara Muka Disatukan dalam Meja Perkhidmatan Disatukan
Panduan Konfigurasi Meja Perkhidmatan Disatukan dan Antara Muka Disatukan
Panduan 1: Bina aplikasi ejen mudah untuk Apl Antara Muka Disatukan
Panduan 2: Paparkan halaman web luaran dalam aplikasi ejen anda
Panduan 3: Paparkan rekod apl Antara Muka Disatukan dalam aplikasi ejen anda
Panduan 4: Paparkan rekod aplikasi Antara Muka Disatukan dalam sesi dalam aplikasi ejen anda
Panduan 5: Paparkan maklumat sesi yang dipertingkatkan dengan memaparkan nama sesi dan data gambaran keseluruhan
Panduan 6: Konfigurasikan kawalan yang dihoskan Penyahpepijat dalam aplikasi ejen anda
Panduan 7: Konfigurasikan skrip ejen dalam aplikasi ejen anda