Dibaca dalam bahasa Inggeris

Kongsi melalui


Setempatkan label, mesej dan petua alat pada halaman tersuai

[Topik ini ialah dokumentasi prapelancaran dan tertakluk pada perubahan.]

Artikel ini menggariskan cara untuk menambah kandungan disetempatkan pada halaman tersuai dengan memuat naik fail sumber web RESX untuk setiap bahasa ke dalam penyelesaian anda.

Artikel ini menunjukkan anda cara untuk menggunakan Power Fx untuk menetapkan kandungan kawalan pada halaman tersuai. Anda boleh menggunakan langkah yang sama untuk petua alat dan sebarang mesej yang menggunakan kawalan teks pada halaman tersuai.

Menyetempatkan label pada halaman tersuai

Menyediakan kandungan disetempatkan pada halaman tersuai dalam aplikasi berpandukan model adalah penting apabila membina aplikasi yang menyokong pengguna global atau organisasi berbilang bahasa. Penterjemahan boleh dilakukan dengan memuat naik fail teks dalam format. resx sebagai sumber web. Fail mengandungi teks yang diterjemah yang anda mahu gunakan untuk label pada halaman tersuai anda.

Proses mempunyai langkah berikut:

  1. Dayakan bahasa untuk persekitaran anda.
  2. Tambah fail sumber web RESX disetempatkan ke dalam penyelesaian anda.
  3. Tambah fail disetempatkan ke halaman tersuai anda.
  4. Urus sumber web disetempatkan.
  5. Tambah rentetan disetempatkan dengan kawalan anda.
  6. Jalankan aplikasi anda dengan kandungan disetempatkan.

Dayakan bahasa untuk persekitaran anda

Untuk menambah bahasa untuk halaman tersuai, anda perlu mendayakan bahasa yang anda mahu sokong terlebih dahulu dalam aplikasi berpandukan model di mana halaman tersuai anda akan berjalan. Pastikan anda telah mendayakan bahasa daripada pusat pentadbir Power Platform. Maklumat lanjut: Dayakan bahasa

Selepas melengkapkan langkah untuk mendayakan bahasa dalam persekitaran, cipta fail RESX untuk setiap bahasa dalam format yang betul untuk rentetan yang anda mahu setempatkan pada halaman tersuai anda untuk aplikasi berpandukan model anda.

Selepas anda telah mencipta fail RESX dengan rentetan disetempatkan, tambahkannya ke dalam penyelesaian anda sebagai sumber web. Terdapat dua cara untuk menyelesaikan tugas ini, yang pertama adalah membuka penyelesaian anda dalam make.powerapps.com dan memilih pilihan untuk menambah sumber web ke penyelesaian anda dalam persekitaran anda atau anda boleh menambah sumber web semasa bekerja pada halaman tersuai. Maklumat lanjut: Sumber web RESX

Menambahkan sumber web semasa bekerja pada halaman tersuai diliputi kemudian dalam artikel ini dalam bahagian Tambah fail disetempatkan ke halaman tersuai anda.

Kandungan disetempatkan akan berdasarkan tempat pengguna atau organisasi untuk aplikasi yang halaman tersuai jalankan. Bahasa untuk aplikasi anda adalah berdasarkan keutamaan bahasa ditakrifkan pengguna atau pentadbir dalam tetapan aplikasi pengguna atau tetapan pentadbir dalam pusat pentadbir Power Platform. Jika tidak ditetapkan, bahasa asas yang ditetapkan apabila persekitaran dicipta digunakan.

Nota

Kandungan yang ditunjukkan dalam kawalan a Power Apps Control Framework (PCF) akan disetempatkan kepada bahasa penempatan aplikasi tanpa perubahan tambahan yang diperlukan pada halaman tersuai. Maklumat lanjut Menyetempatkan Kawalan PCF

Tambah fail sumber Web RESX disetempatkan ke penyelesaian anda

  1. Pergi ke make.powerapps.com, pilih kawasan Penyelesaian dan kemudian buka penyelesaian yang anda mahu.
  2. Pada bar perintah, pilih Baharu > Selanjutnya > Sumber Web. Ini membuka panel untuk menambah fail sumber web RESX anda.

Semua fail yang ditambah kepada penyelesaian anda perlu mengikut format khusus termasuk {filename}.LanguageID.resx, di mana ID bahasa ialah nilai angka bahasa itu. Format ini adalah perlu kerana rangka kerja bergantung pada konvensyen penamaan untuk mengenal pasti fail sumber yang sepatutnya digunakan untuk mengaitkan rentetan disetempatkan yang sesuai dengan kawalan label.

Penting

RESX {filename} mesti sama untuk semua fail anda.

Sebagai contoh, semua fail rentetan disetempatkan mempunyai nama CustomPageLoc.LanguageID.resx, yang bermaksud untuk Bahasa Inggeris ialah CustomPageLoc.1033.resx, untuk Bahasa Perancis CustomPageLoc.1036.resx dan untuk Bahasa Arab CustomPageLoc.1025.resx. Nama paparan untuk setiap fail yang ditambah mesti nama yang sama juga.

Dalam contoh di bawah semua fail mempunyai CPLoc sebagai nama paparan. Nama paparan mesti sama untuk memastikan semua kandungan disetempatkan digunakan dengan betul pada halaman tersuai untuk setiap bahasa. Kami mengesyorkan anda menambah nama yang sepadan untuk bahasa dalam medan Perihalan untuk membantu mengenal pasti kandungan apabila anda melihat fail dalam pereka bentuk halaman tersuai. Juga, anda perlu menambahkan fail RESX bahasa yang sama yang anda sedang bekerja. Sebagai contoh, jika anda mengarang dalam Bahasa Inggeris, pastikan anda menambah fail RESX Bahasa Inggeris.

Power Apps Studio dialog sumber web.

Selepas anda telah menambah sumber web anda ke penyelesaian anda, pastikan anda menerbitkan perubahan. Penerbitan memastikan fail tersedia untuk ditambah kepada halaman tersuai anda. Ini ialah contoh fail RESX sumber web yang telah ditambah kepada penyelesaian dan kini tersedia untuk ditambah kepada halaman tersuai.

Power Apps Studio panel sumber web.

Tambah fail disetempatkan ke halaman tersuai anda

Tambah fail disetempatkan ke halaman tersuai anda apabila anda mencipta atau mengedit halaman.

Untuk menambah bahasa ke halaman anda, pilih ikon Sumber pada sebelah kiri untuk membuka anak tetingkap Sumber.

Power Apps Studio sumber halaman tersuai.

Pilih Tambah sumber di salah satu daripada dua tempat.

Power Apps Studio halaman tersuai tambah sumber web.

Dialog dibuka yang menyenaraikan semua sumber web yang tersedia dalam penyelesaian anda. Untuk mencari fail anda dengan cepat, anda boleh menggunakan dialog di bahagian atas untuk mencari Nama paparan yang memaparkan semua fail RESX disetempatkan anda. Anda hanya perlu memilih dan menambah fail yang sepadan dengan bahasa yang anda gunakan untuk mengarang halaman anda. Dalam contoh ini, fail Bahasa Inggeris adalah satu-satunya fail yang anda perlu tambah.

Power Apps Studio halaman tersuai tambah dialog sumber web.

Nota

Tidak perlu untuk menambah setiap fail-anda hanya perlu menambah satu. Penyelesaian dan platform memetakan bahasa yang dimuat naik berdasarkan nama paparan kepada fail sumber web bahasa yang anda tambah pada penyelesaian anda. Apabila anda menambahkan berbilang fail, dialog dipaparkan dengan mesej ralat yang menyatakan fail sudah dimuatkan ke halaman anda.

Jika anda tidak melihat sumber web RESX dengan bahasa yang anda mahu tambah dalam dialog, anda perlu menambah fail ke penyelesaian anda menggunakan langkah yang diterangkan lebih awal dalam artikel ini.

Selepas memilih Tambah, panel ditutup dan sumber web disenaraikan dalam anak tetingkap Sumber.

Fail RESX sumber web disenaraikan dalam anak tetingkap Sumber.

Urus sumber web disetempatkan

Selepas bahasa sumber web telah ditambah kepada halaman anda, anda boleh menguruskan fail dengan memilih elipsis ... bersebelahan dengan fail. Terbang keluar dibuka di mana anda boleh segar semula sumber web jika ia telah dikemas kini. Anda juga boleh mengalih keluar sumber daripada halaman anda. Anda perlu segar semula sumber RESX pada halaman anda jika nama paparan telah berubah atau mana-mana kunci rentetan telah dikemas kini dalam fail RESX yang telah diterbitkan ke penyelesaian anda. Ambil perhatian mengemas kini terjemahan dalam fail RESX dan menerbitkan penyelesaian tidak memerlukan RESX pada halaman anda untuk disegar semula.

Power Apps Studio sumber web halaman tersuai dengan fail resx.

Tambah rentetan disetempatkan ke kawalan label anda

Untuk menambah kandungan disetempatkan ke kawalan label anda, pilih label dan tetapkan fungsi kepada sumber menggunakan fungsi teks Power Fx kawalan. Untuk melakukan ini, pilih kawalan label dan kemudian pilih fungsi Teks.

Power Apps Studio pilihan teks halaman tersuai pada kawalan.

Menggunakan fungsi teks, tetapkan nilai kepada sumber web dan nilai yang anda mahu yang berada dalam fail RESX sumber web anda. Selepas menetapkan ungkapan, kandungan akan muncul dalam pratonton untuk halaman.

Power Apps Studio fungsi teksi halaman tersuai untuk kawalan.

Simpan dan terbitkan perubahan anda kepada halaman.

Nota

Pastikan anda juga menyimpan dan menerbitkan perubahan anda pada aplikasi. Menyimpan dan menerbitkan kedua-dua halaman dan aplikasi diperlukan untuk memastikan label disetempatkan anda memaparkan dengan rentetan yang sesuai pada masa jalanan.

Penting

Apabila anda menambah kawalan borang, pastikan anda menyetempatkan label. Ia tidak menarik label disetempatkan secara automatik apabila anda mengikat kawalan kepada jadual Microsoft Dataverse. Pada masa ini, anda perlu menambah rentetan untuk label ke fail resx anda, membuka kunci kawalan borang dan kemudian tetapkan sifat displayName kepada rentetan disetempatkan anda menggunakan ungkapan yang sama untuk label, teks, petua alat dan lain-lain tersuai anda. Power Apps Studio halaman tersuai edit label borang

Jalankan aplikasi anda dengan kandungan disetempatkan

  1. Selepas menerbitkan halaman anda dan aplikasi anda, pilih Main dalam pereka bentuk aplikasi untuk membuka aplikasi dalam tab pelayar berasingan.

  2. Pilih halaman tersuai anda pada peta tapak.

    Power Apps Studio masa jalanan halaman tersuai.

  3. Label untuk kawalan anda memaparkan kandungan disetempatkan. Uji setiap bahasa yang ditambah kepada aplikasi dan halaman dengan memilih Tetapan Pemberibadian di bawah Tetapan (ikon gear) di bahagian atas aplikasi.

    Power Apps Studio pilihan tetapan masa jalanan halaman tersuai.

  4. Kemudian, pada tab Bahasa, tetapkan Bahasa Antara Muka Pengguna kepada bahasa yang anda mahu uji.

    Power Apps Studio dialog tetapan masa jalanan halaman tersuai.

Sokongan kanan ke kiri untuk halaman tersuai

Dengan kandungan disetempatkan, terdapat beberapa bahasa yang memerlukan orientasi kanan ke kiri untuk kandungan yang dipaparkan pada halaman anda. Kanan Ke Kiri (RTL) disokong sepenuhnya untuk bahasa seperti Bahasa Arab dan Ibrani dan halaman akan berubah pada masa jalanan secara automatik untuk bahasa ini.

Penting

Orientasi kanan ke kiri untuk ikon, bentuk dan imej tidak disokong pada masa ini dalam halaman tersuai. Jika anda menambah ikon, bentuk atau imej ia mungkin tidak berkelakuan seperti yang dijangkakan, jadi sila berhati-hati apabila menggunakan jenis kawalan ini pada halaman tersuai anda.

Untuk menyemak RTL apabila membina halaman tersuai, anda perlu pergi ke tetapan halaman, pilih ciri yang akan datang, cari RTL dan dayakan tetapan. Penetapan pilihan ini menunjukkan butang RTL atau LTR dalam tetingkap pratonton di mana anda boleh menukar antara orientasi tanpa perlu menjalankan aplikasi anda. Jika anda mahu melihat halaman tersuai anda menjalankan RTL, anda boleh menambah &flags=isRTL=true kepada penghujung URL dalam pelayar anda apabila menjalankan aplikasi anda untuk menguji RTL untuk halaman anda.

Power Apps Studio kanak ke kiri halaman tersuai.

Had yang diketahui untuk mengeksport penyelesaian dengan fail resx

Fail resx tidak akan ditambah secara automatik apabila anda mengeksport penyelesaian anda dan mengimportnya ke dalam persekitaran baharu. Ini adalah batasan yang diketahui dan memerlukan anda memuat naik fail resx anda ke persekitaran baru anda. Oleh itu, jika anda mempunyai persekitaran pembangun, dan anda mengeksport penyelesaian anda dan mengimport ke dalam persekitaran pengeluaran, anda perlu menambah fail penyetempatan resx anda ke dalam penyelesaian persekitaran pengeluaran anda.

Lihat juga

Cipta atau edit sumber web aplikasi dipacu model untuk memperluaskan aplikasi

Gambaran keseluruhan halaman tersuai untuk aplikasi berpandukan model