Membangun aplikasi multi-bahasa

Pada artikel ini, Anda akan mempelajari cara membuat aplikasi multi-bahasa dengan pengalaman yang dilokalkan. Dengan metode ini, Anda dapat menggunakan komponen aplikasi kanvas dan membuat terjemahan yang tersedia dalam aplikasi menggunakan sintaks rumus yang sama.

Penting

Metode yang dijelaskan di artikel ini menggunakan komponen untuk aplikasi kanvas yang ada dalam pratinjau publik. Untuk informasi lebih lanjut, lihat Membuat komponen untuk aplikasi kanvas

Buat komponen terjemahan

Bila menggunakan aplikasi multi-bahasa, langkah pertama adalah membuat komponen yang dapat digunakan kembali untuk penerjemahan. Di komponen ini, Anda akan menyimpan tabel yang berfungsi sebagai kamus untuk semua terjemahan yang diperlukan. Properti output akan digunakan untuk menyediakan string output dari tabel kamus ini berdasarkan bahasa pengguna yang menjalankan aplikasi yang menggunakan komponen ini.

1. Masuk ke Power Apps.

2. Di panel kiri, pilih Aplikasi.

3. Dalam Aplikasi, pilih Pustaka komponen (pratinjau).

   

4. Pilih + Pustaka komponen baru (pratinjau).

5. Masukkan nama, seperti "Komponen terjemahan", lalu pilih Buat untuk membuka komponen di Power Apps Studio.

6. Ganti nama "Component1" dengan memilih ... di panel kiri, lalu pilih Ganti nama sebagai "Komponen terjemahan".

   

7. Dari panel properti di sisi kanan layar, pilih + Properti kustom baru

8. Atur nilai properti berikut:

   Nama properti	Nilai
   Nama tampilan	Bahasa
   Nama	Bahasa
   KETERANGAN	Bahasa yang akan diterjemahkan teksnya.
   Jenis Properti	Input
   Tipe data	Teks

9. Pilih kotak centang Tambah OnReset bila nilai berubah.

   

10. Pilih Buat.

    Catatan

    Properti input ini akan menerima ID lokal (LCID) pengguna yang masuk saat ini.

11. Dari panel properti di sisi kanan layar, pilih + Properti kustom baru

12. Atur nilai properti berikut:

    Nama properti	Nilai
    Nama tampilan	Label
    Nama	Label
    KETERANGAN	Label terjemahan.
    Jenis Properti	Output
    Tipe data	Rekaman

    

13. Pilih Buat.

    Catatan

    Properti output ini memperlihatkan label terjemahan berdasarkan ID lokal input.

14. Di sisi kiri atas layar, pilih drop-down daftar properti, lalu pilih properti OnReset untuk komponen.

    

15. Salin dan tempel rumus berikut di bilah rumus untuk properti OnReset.

    Set(
     varTranslations,
     Table(
             {
                 Language: "en-us",
                 Labels: {
                     Title: "UI Tips for building canvas apps",
                     JobTitle: "Power Platform Specialist"
                 }
             },
             {
                 Language: "pt-br",
                 Labels: {
                     Title: "Dicas de UI para construir canvas apps",
                     JobTitle: "Especialista de Power Platform"
                 }
             }
         )
        )
    

    Rumus menggunakan fungsi Set() untuk membuat tabel dengan label dalam bahasa yang berbeda sebagai kamus. Untuk menyesuaikan tabel ini sebagai kamus terjemahan, ubah nama kontrol seperti Judul, JobTitle, Platform, Tutup, Buka, Batal, dan sebagainya. Anda dapat menambah, atau menghilangkan terjemahan untuk nama kontrol, tergantung pada kebutuhan bisnis Anda.

    Tabel juga harus memiliki entri untuk setiap bahasa yang didukung aplikasi Anda. Setiap entri akan memiliki properti Label yang akan berisi konten terjemahan dari semua tombol, input, dan label yang mungkin di aplikasi Anda.

16. Di sisi kiri atas layar, pilih drop-down daftar properti, lalu pilih properti Label untuk komponen.

    

17. Salin dan tepuk rumus berikut di bilah rumus untuk properti Label.

       LookUp(
        varTranslations,
        Language = Lower(
            Coalesce(
                Self.Language,
                Language()
            )
        )).Labels
    

    Rumus menemukan entri terjemahan yang tepat berdasarkan bahasa input menggunakan fungsi Lookup(). Jika bahasa tidak diatur, rumus akan menggunakan bahasa pengguna saat ini sebagai filter melalui fungsi Coalesce.

18. Pilih File -> Simpan untuk menyimpan pustaka komponen.

19. Pilih Publikasikan untuk mempublikasikan pustaka komponen.

    Tip

    Untuk mempelajari lebih lanjut tentang membuat, menyimpan, dan mempublikasikan pustaka komponen, buka Buat pustaka komponen contoh

Pustaka komponen terjemahan Anda dibuat, disimpan, dan dipublikasikan untuk digunakan.

Gunakan komponen terjemahan di aplikasi Anda

Sebelumnya, Anda telah membuat pustaka komponen terjemahan untuk digunakan kembali. Di bagian ini, Anda akan membuat aplikasi yang menggunakan pustaka komponen terjemahan dan memperagakan terjemahan bahasa berdasarkan bahasa yang dipilih.

1. Mulailah dengan membuat aplikasi kanvas kosong dengan tata letak Telepon.

2. Di sisi kiri layar, pilih + (Masukkan).

3. Di sisi kiri bawah layar, pilih Dapatkan komponen lainnya.

4. Buat komponen terjemahan.

   

   Catatan

   Nama mungkin berbeda jika Anda menyimpan pustaka komponen yang dibuat sebelumnya dengan nama lain.

5. Pilih impor.

6. Di sisi kiri layar, pilih + (Masukkan).

7. Dalam Komponen Pustaka, pilih komponen Terjemahan untuk menambahkan komponen ke aplikasi ini.

8. Di sisi kiri layar, pilih tampilan hierarki.

9. Pilih komponen terjemahan.

10. Di sisi kiri atas layar, pilih drop-down daftar properti, lalu pilih properti Terlihat untuk komponen.

11. Atur nilai properti Terlihat ke salah untuk membuat komponen tidak terlihat pada aplikasi.

12. Dalam Input dalam daftar kontrol, pilih Alihkan.

13. Di sisi kiri atas layar, pilih drop-down daftar properti, lalu pilih properti OnChange untuk komponen.

14. Perbarui rumus untuk properti OnCheck dari kontrol alih ke berikut.

        Set(varLanguage,"pt-br")
    

    Dalam rumus ini, pengalih akan mengatur variabel yang disebut varLanguage dengan nilai "pt-br" menggunakan fungsi Set(), untuk kode bahasa Portugis (BR).

15. Perbarui rumus untuk properti OnUncheck dari kontrol alih ke berikut.

        Set(varLanguage,"en-us")
    

    Dalam rumus ini, pengalih akan mengatur variabel yang disebut varLanguage dengan nilai "en-us" menggunakan fungsi Set(), untuk kode bahasa Inggris (AS).

16. Di sisi kiri layar, pilih komponen terjemahan.

17. Di sisi kiri atas layar, pilih drop-down daftar properti, lalu pilih properti Bahasa untuk komponen.

18. Atur nilai rumus untuk properti Bahasa ke varLanguage Variabel varLanguage ditentukan berdasarkan toggle yang dikonfigurasi sebelumnya. Bila toggle dicentang, bahasa diatur ke "pt-br". Bila tidak dicentang, bahasa diatur ke "en-us".

19. Di sisi kiri layar, pilih + (Masukkan).

20. Pilih Label teks.

21. Perbarui nama kontrol label ke Judul dari sisi kanan layar menggunakan panel properti.

22. Pilih Label teks lagi untuk menambahkan satu label lagi.

23. Perbarui nama kontrol label ke JobTitle.

24. Atur Judul, dan label JobTitle di bawah kontrol alih sehingga kedua label terlihat.

25. Atur properti Teks untuk Judul, dan label JobTitle dari sisi kiri atas layar ke yang berikut.

    Label	Rumus
    Judul	'Translation component_1'.Labels.Title
    JobTitle	'Translation component_1'.Labels.JobTitle

    Catatan

    Ganti 'Translation component_1' dalam rumus ini ke nama komponen di aplikasi Anda, jika berbeda.

    Anda juga dapat menggunakan label, dan properti yang berbeda, sebagaimana ditentukan dalam komponen yang Anda buat sebelumnya untuk meneruskan nilai properti lainnya. Contohnya, selain Judul, dan JobTitle, Anda dapat membuat properti lainnya seperti Deskripsi, atau Petunjuk di pustaka komponen dengan teks terjemahan. Selanjutnya, gunakan properti tersebut di label masing-masing, sebagai 'Translation component_1'.Labels.Description, atau 'Translation component_1'.Labels.Instructions.

26. Pilih File -> Simpan, perbarui nama aplikasi, lalu pilih Simpan untuk menyimpan aplikasi. Informasi lebih lanjut: Simpan dan publikasikan aplikasi

Uji aplikasi Anda dengan terjemahan bahasa

Sekarang aplikasi Anda menggunakan komponen terjemahan. Buka Power Apps dan pilih aplikasi untuk dijalankan.

Bila toggle dipilih, bahasa diubah ke Portugis (BR) untuk label. Bila tidak dicentang, bahasa diatur kembali ke Inggris (AS).

Dengan pendekatan ini, Anda sekarang dapat membuat komponen anda sendiri yang memiliki kamus terjemahan yang sesuai dengan kebutuhan bisnis Anda. Selanjutnya, buat aplikasi kanvas lainnya yang menggunakan komponen yang memungkinkan pengguna bisnis menggunakan bahasa yang berbeda.

Lihat juga

Menambahkan dan mengonfigurasi kontrol
Memahami variabel
Referensi rumus