Bagikan melalui

Lokalkan label, pesan, dan tip alat pada halaman kustom

[Topik ini adalah dokumentasi prarilis dan dapat berubah.]

Artikel ini menguraikan cara menambahkan konten yang dilokalkan ke halaman kustom dengan mengunggah file RESX sumber daya web untuk setiap bahasa ke dalam solusi Anda.

Artikel ini menampilkan cara menggunakan Power Fx untuk mengatur konten kontrol pada halaman kustom. Anda dapat menggunakan langkah-langkah serupa untuk tooltip dan pesan apa pun yang menggunakan kontrol teks pada halaman kustom.

Melokalkan label pada halaman kustom

Menyediakan konten yang dilokalkan pada halaman kustom dalam aplikasi berdasarkan model sangat penting ketika membangun aplikasi yang mendukung pengguna global atau organisasi multibahasa. Terjemahan dapat dilakukan dengan mengunggah file teks dalam format .resx sebagai sumber daya web. File tersebut berisi teks terjemahan yang ingin Anda gunakan untuk label pada halaman kustom Anda.

Proses memiliki langkah-langkah berikut:

  1. Aktifkan bahasa untuk lingkungan Anda.
  2. Tambahkan file sumber daya web RESX yang dilokalkan ke dalam solusi.
  3. Tambahkan file yang dilokalkan ke halaman kustom Anda.
  4. Mengelola sumber daya web yang dilokalkan.
  5. Tambahkan string yang dilokalkan ke kontrol Anda.
  6. Jalankan aplikasi dengan konten yang dilokalkan.

Aktifkan bahasa untuk lingkungan Anda

Untuk menambahkan bahasa pada halaman kustom, Anda harus terlebih dulu mengaktifkan bahasa yang akan didukung di aplikasi berdasarkan model yang akan dijalankan halaman kustom Anda. Pastikan Anda telah mengaktifkan bahasa dari pusat admin Power Platform. Informasi selengkapnya: Mengaktifkan bahasa

Setelah menyelesaikan langkah-langkah untuk mengaktifkan bahasa di lingkungan, buat file RESX untuk setiap bahasa dalam format yang sesuai untuk string yang ingin Anda lokalkan pada halaman kustom untuk aplikasi berdasarkan model Anda.

Setelah Anda membuat file RESX dengan string yang dilokalkan, tambahkan ke solusi Anda sebagai sumber daya web. Ada dua cara untuk menyelesaikan tugas ini, pertama adalah membuka solusi di make.powerapps.com dan memilih pilihan untuk menambahkan sumber daya web ke solusi di lingkungan Anda atau Anda dapat menambahkan sumber daya web saat mengerjakan halaman kustom. Informasi selengkapnya: Sumber daya web RESX

Menambahkan sumber daya web saat mengerjakan halaman kustom dibahas nanti dalam artikel ini di bagian Menambahkan file yang dilokalkan ke halaman kustom Anda.

Konten yang dilokalkan akan didasarkan pada pengguna atau lokal organisasional untuk aplikasi yang menjalankan halaman kustom. Bahasa untuk aplikasi Anda didasarkan pada preferensi bahasa yang ditentukan pengguna atau admin dalam pengaturan aplikasi pengguna atau pengaturan admin di pusat admin Power Platform. Jika tidak ditetapkan, maka rangkaian bahasa dasar saat lingkungan dibuat digunakan.

Catatan

Konten yang ditampilkan dalam kontrol ( Power Apps Control Framework PCF) akan dilokalkan ke bahasa lokal aplikasi tanpa perubahan tambahan yang diperlukan pada halaman kustom. Informasi Lebih Lanjut Melokalkan Kontrol PCF

Tambahkan file sumber daya web RESX yang dilokalkan ke dalam solusi

  1. Buka make.powerapps.com, pilih area Solusi , lalu buka solusi yang Anda inginkan.
  2. Pada bilah perintah, pilih Sumber Daya> Web Baru>Lainnya. Panel akan terbuka untuk menambahkan file sumber daya web RESX Anda.

Semua file yang ditambahkan ke solusi Anda harus mengikuti format tertentu yang mencakup {filename}LanguageID.resx., di mana ID bahasa adalah nilai numerik untuk bahasa tersebut. Format ini diperlukan karena kerangka kerja mengandalkan konvensi penamaan untuk mengidentifikasi file sumber daya yang harus digunakan untuk mengaitkan string lokal yang sesuai ke kontrol label.

Penting

RESX {filename} harus sama untuk semua file.

Misalnya, semua file string yang dilokalkan memiliki nama CustomPageLoc.LanguageID.resx, yang berarti untuk bahasa Inggris adalah CustomPageLoc.1033.resx, untuk Prancis CustomPageLoc.1036.resx, dan untuk Arab CustomPageLoc.1025.resx. File nama tampilan untuk setiap file yang ditambahkan juga harus memiliki nama yang sama.

Dalam contoh di bawah ini, semua file memiliki CPLoc nama tampilan. Nama tampilan harus sama untuk memastikan semua konten yang dilokalkan digunakan dengan benar pada halaman khusus untuk setiap bahasa. Sebaiknya tambahkan nama yang sesuai untuk bahasa di bidang Deskripsi untuk membantu mengidentifikasi konten saat Anda melihat file di perancang halaman kustom. Selain itu, Anda harus menambahkan file RESX dalam bahasa yang sama seperti yang anda kerjakan. Misalnya, jika Anda menulis dalam bahasa Inggris, pastikan untuk menambahkan file RESX bahasa Inggris.

Power Apps Studio dialog sumber daya web.

Setelah menambahkan sumber daya web ke solusi, pastikan untuk mempublikasikan perubahan tersebut. Mempublikasikan memastikan file tersedia untuk ditambahkan ke halaman kustom Anda. Berikut adalah contoh file RESX sumber daya web yang telah ditambahkan ke solusi dan sekarang tersedia untuk ditambahkan ke halaman kustom.

Power Apps Studio panel sumber daya web.

Tambahkan file yang dilokalkan ke halaman kustom Anda

Tambahkan file yang dilokalkan ke halaman kustom saat Anda membuat atau mengedit halaman.

Untuk menambahkan bahasa ke halaman Anda, pilih ikon Sumber daya di sebelah kiri untuk membuka panel Sumber Daya .

Power Apps Studio sumber daya halaman khusus.

Pilih Tambahkan sumber daya di salah satu dari dua tempat.

Power Apps Studio halaman kustom menambahkan sumber daya web.

Dialog akan terbuka yang mencantumkan semua sumber daya web yang tersedia di solusi Anda. Untuk menemukan file Anda dengan cepat, Anda dapat menggunakan pencarian di bagian atas dialog untuk mencari Nama tampilan yang menampilkan semua file RESX yang dilokalkan. Anda hanya perlu memilih dan menambahkan file yang sesuai dengan bahasa yang Anda gunakan untuk menulis halaman. Dalam contoh ini, file bahasa Inggris adalah satu-satunya file yang perlu Anda tambahkan.

Power Apps Studio dialog Halaman kustom menambahkan sumber daya web.

Catatan

Anda tidak perlu menambahkan setiap file, namun hanya perlu menambahkan satu. Solusi dan platform memetakan bahasa yang diunggah berdasarkan nama tampilan ke file sumber daya web bahasa yang Anda tambahkan ke solusi. Saat Anda menambahkan beberapa file, dialog akan ditampilkan dengan pesan kesalahan, yang menyatakan bahwa file telah dimuat ke halaman Anda.

Jika sumber daya web RESX tidak melihat bahasa yang akan ditambahkan dalam dialog, Anda harus menambahkan file tersebut ke solusi menggunakan langkah-langkah yang telah dijelaskan sebelumnya di artikel ini.

Setelah memilih Tambahkan , panel ditutup, dan sumber daya web tercantum dipanel Sumber Daya .

File RESX sumber daya web tercantum di panel Sumber Daya.

Mengelola sumber daya web yang dilokalkan

Setelah bahasa sumber daya web ditambahkan ke halaman Anda, Anda dapat mengelola file dengan memilih ... elips di samping file. Flyout akan terbuka di mana Anda dapat me-refresh sumber daya web jika telah diperbarui. Anda juga dapat menghapus sumber daya dari halaman Anda. Anda harus me-refresh sumber daya RESX di halaman jika nama tampilan telah berubah atau salah satu tombol string telah diperbarui di file RESX yang telah dipublikasikan ke solusi Anda. Perlu diketahui bahwa memperbarui terjemahan dalam file RESX dan mempublikasikan solusi tidak mengharuskan RESX pada halaman Anda di-refresh.

Power Apps Studio Sumber daya web halaman kustom dengan file REX.

Tambahkan string yang dilokalkan ke kontrol label Anda

Untuk menambahkan konten yang dilokalkan ke kontrol label, pilih label, dan atur fungsi ke sumber daya menggunakan fungsi teks Power Fx kontrol itu. Untuk melakukan ini, pilih kontrol label, lalu pilih fungsi Teks .

Power Apps Studio opsi teks halaman kustom pada kontrol.

Dengan menggunakan fungsi teks, atur nilai ke sumber daya web dan nilai yang diinginkan di file RESX sumber daya web. Setelah mengatur ekspresi, konten akan muncul dalam pratinjau untuk halaman.

Power Apps Studio fungsi teks halaman kustom untuk kontrol.

Simpan terbitkan penyesuaian perubahan Anda ke halaman.

Catatan

Pastikan Anda juga menyimpan dan mempublikasikan perubahan pada aplikasi. Menyimpan dan mempublikasikan halaman dan aplikasi diperlukan untuk memastikan label yang dilokalkan dirender dengan string yang sesuai saat runtime.

Penting

Saat menambahkan kontrol formulir, pastikan Anda melokalkan label. Label tidak menarik label yang dilokalkan secara otomatis bila Anda ikat kontrol ke tabel Microsoft Dataverse. Saat ini, Anda harus menambahkan string untuk label ke file resx Anda, membuka kunci kontrol formulir, lalu mengatur displayName properti ke string yang dilokalkan menggunakan ekspresi yang sama untuk label kustom, teks, tooltips, dll. Power Apps Studio Label formulir edit halaman kustom

Jalankan aplikasi dengan konten yang dilokalkan

  1. Setelah memublikasikan halaman dan aplikasi Anda, pilih Putar di perancang aplikasi untuk membuka aplikasi di tab browser terpisah.

  2. Di peta situs, Pilih halaman kustom.

    Power Apps Studio runtime halaman kustom.

  3. Label untuk kontrol Anda akan menampilkan konten yang dilokalkan. Uji setiap bahasa yang ditambahkan ke aplikasi dan halaman Anda dengan memilih Pengaturan Personalisasi di bawah Setelan (ikon roda gigi) di bagian atas aplikasi.

    Power Apps Studio Opsi pengaturan runtime halaman kustom.

  4. Kemudian, pada tab Bahasa , atur Bahasa Antarmuka Pengguna ke bahasa yang ingin Anda uji.

    Power Apps Studio dialog pengaturan runtime halaman kustom.

Dukungan kanan ke kiri untuk halaman kustom

Dengan konten yang dilokalkan, ada beberapa bahasa yang memerlukan orientasi kanan ke kiri untuk konten yang ditampilkan pada halaman Anda. Kanan ke kiri (RTL) sepenuhnya didukung untuk bahasa seperti Arab dan Ibrani dan halaman akan berubah saat runtime secara otomatis untuk bahasa ini.

Penting

Orientasi kanan ke kiri untuk ikon, bentuk, dan gambar saat ini tidak didukung dalam halaman kustom. Jika Anda menambahkan ikon, bentuk, atau gambar, ikon mungkin tidak berperilaku sebagaimana yang diharapkan, jadi hati-hati saat menggunakan jenis kontrol ini pada halaman kustom Anda.

Untuk memeriksa RTL bila membuat halaman kustom, Anda harus membuka pengaturan halaman, memilih fitur mendatang, mencari RTL, dan mengaktifkan pengaturan. Pengaturan pilihan ini akan menampilkan tombol RTL atau LTR di jendela pratinjau yang memungkinkan Anda beralih antara orientasi tanpa harus menjalankan aplikasi. Jika ingin melihat halaman kustom Anda menjalankan RTL, Anda dapat menambahkan &flags=isRTL=true ke akhir URL di browser saat menjalankan aplikasi untuk menguji RTL untuk halaman Anda.

Power Apps Studio halaman kustom dari kanan ke kiri.

Pembatasan yang diketahui dengan mengekspor solusi dengan file resx

File Resx tidak secara otomatis ditambahkan saat Anda mengekspor solusi dan mengimpornya ke lingkungan baru.  Pembatasan ini diketahui dan akan mengharuskan Anda mengunggah file resx ke lingkungan baru Anda.  Jadi, jika Anda memiliki lingkungan pengembang, dan mengekspor solusi serta mengimpor ke lingkungan produksi, maka Anda harus menambahkan file lokalisasi resx ke dalam solusi lingkungan produksi.

Baca juga

Membuat atau mengedit sumber daya web aplikasi berbasis model untuk memperluas aplikasi

Ringkasan halaman kustom untuk aplikasi berbasis model

  • Last updated on