Membuat alur Terjemahan Dokumen (pratinjau)

Penting

Konektor Penerjemah saat ini tersedia di pratinjau publik. Fitur, pendekatan, dan proses dapat berubah, sebelum Ketersediaan Umum (GA), berdasarkan umpan balik pengguna.

Tutorial ini memandu Anda mengonfigurasi alur cloud konektor Microsoft Penerjemah V3 yang mendukung terjemahan dokumen. Konektor Penerjemah V3 membuat koneksi antara instans Layanan Penerjemah dan Microsoft Power Automate yang memungkinkan Anda menggunakan satu atau beberapa operasi bawaan sebagai langkah-langkah dalam aplikasi dan alur kerja Anda.

Terjemahan Dokumen adalah fitur REST API berbasis cloud dari layanan azure AI Penerjemah. DOCUMENT Translation API memungkinkan beberapa terjemahan dokumen yang kompleks sekaligus mempertahankan struktur dokumen asli dan format data.

Dalam tutorial ini:

• Buat akun penyimpanan blob dengan kontainer untuk file sumber dan target Anda.
• Siapkan identitas terkelola dengan kontrol akses berbasis peran (RBAC).
• Terjemahkan dokumen dari akun Azure Blob Storage Anda.
• Terjemahkan dokumen dari situs SharePoint Anda.

Prasyarat

Inilah yang Anda butuhkan untuk memulai: Penerjemah sumber daya, akun penyimpanan Azure dengan setidaknya dua kontainer, dan identitas terkelola yang ditetapkan sistem dengan akses berbasis peran.

Sumber daya Penerjemah

• Jika Anda tidak memiliki akun Azure aktif, Anda dapat membuatnya secara gratis.

• Buat sumber daya Penerjemah layanan tunggal (bukan sumber daya layanan Azure AI multi-layanan). Saat Anda menyelesaikan bidang proyek Penerjemah dan detail instans, perhatikan entri berikut:

  • Wilayah Sumber Daya. Pilih wilayah geografis seperti US Barat (bukanwilayah Global).

  • Tingkat harga. Pilih Standar S1 untuk mencoba layanan.

• Gunakan kunci dan nama dari sumber daya Penerjemah Anda untuk menyambungkan aplikasi Anda ke Power Automate. Kunci sumber daya Penerjemah Anda ditemukan di bawah bagian Manajemen Sumber Daya di portal Azure dan nama sumber daya Anda terletak di bagian atas halaman.

  

• Salin dan tempel nama kunci dan sumber daya Anda di lokasi yang nyaman, seperti Microsoft Notepad.

Penyimpanan Azure

• Selanjutnya, Anda memerlukan akun Azure Blob Storage dan setidaknya dua kontainer untuk file sumber dan target Anda:

  • Kontainer sumber. Kontainer ini adalah tempat Anda mengunggah file yang akan diterjemahkan (wajib).
  • Kontainer target. Kontainer ini adalah tempat file terjemahan Anda disimpan (diperlukan).

• Jika akun penyimpanan Anda berada di belakang firewall, Anda harus mengaktifkan konfigurasi tambahan:

  1. Buka portal Azure dan masuk ke akun Azure Anda.

  2. Pilih akun Penyimpanan Anda.

  3. Di grup Keamanan + jaringan di panel kiri, pilih Jaringan.

  4. Di tab Firewall dan jaringan virtual, pilih Diaktifkan dari jaringan virtual dan alamat IP yang dipilih.

     

  5. Batal pilih semua kotak centang.

  6. Pastikan perutean jaringan Microsoft dipilih.

  7. Di bawah bagian Instans sumber daya, pilih Microsoft.CognitiveServices/accounts sebagai jenis sumber daya dan pilih sumber daya Penerjemah Anda sebagai nama instans.

  8. Pastikan bahwa kotak Izinkan layanan Azure pada daftar layanan tepercaya untuk mengakses akun penyimpanan ini dicentang. Untuk informasi selengkapnya tentang mengelola pengecualian, lihatMengonfigurasi firewall Azure Storage dan jaringan virtual.

     

  9. Pilih Simpan. Mungkin perlu waktu hingga 5 menit agar perubahan jaringan disebarluaskan.

Identitas terkelola dengan RBAC

Terakhir, sebelum Anda dapat menggunakan operasi konektor Penerjemah V3 untuk terjemahan dokumen, Anda harus memberikan akses sumber daya Penerjemah ke akun penyimpanan Anda menggunakan identitas terkelola dengan kontrol identitas berbasis peran (RBAC).

Buat identitas terkelola

Pertama, buat identitas terkelola yang ditetapkan sistem untuk sumber daya Penerjemah Anda dan berikan izin khusus identitas tersebut untuk mengakses akun penyimpanan Azure Anda:

1. Buka portal Azure dan masuk ke akun Azure Anda.

2. Pilih sumber daya Penerjemah.

3. Di grup Manajemen Sumber Daya di panel kiri, pilih Identitas.

4. Di dalam tab Sistem yang ditetapkan, aktifkan tombol Status .

5. Pilih Simpan.

   

Penetapan peran

Selanjutnya, tetapkan Storage Blob Data Contributor peran ke identitas terkelola di cakupan penyimpanan untuk sumber daya penyimpanan Anda.

1. Buka portal Azure dan masuk ke akun Azure Anda.

2. Pilih sumber daya Penerjemah.

3. Di grup Manajemen Sumber Daya di panel kiri, pilih Identitas.

4. Di bawah Izin pilih Penetapan peran Azure:

   

5. Pada halaman penetapan peran Azure yang dibuka, pilih langganan Anda dari menu drop-down lalu pilih + Tambahkan penetapan peran.

   

6. Terakhir, tetapkan peran Kontributor Data Blob Penyimpanan ke sumber daya layanan Penerjemah Anda. Peran Kontributor Data Blob Penyimpanan memberi Penerjemah (diwakili oleh identitas terkelola yang ditetapkan sistem) akses membaca, menulis, dan menghapus ke kontainer dan data blob. Di jendela pop-up Tambahkan penetapan peran, isi bidang seperti berikut dan pilih Simpan:

   Bidang	Nilai
   Cakupan	Penyimpanan.
   Langganan	Langganan yang terkait dengan sumber daya penyimpanan Anda.
   Sumber daya	Nama sumber daya penyimpanan Anda.
   Peran	Kontributor Data Blob Penyimpanan.

7. Setelah pesan konfirmasi Penetapan Peran Ditambahkan muncul, refresh halaman untuk melihat penetapan peran yang ditambahkan.

   

8. Jika Anda tidak segera melihat penetapan peran baru, tunggu dan coba refresh halaman lagi. Saat Anda menetapkan atau menghapus penetapan peran, diperlukan waktu hingga 30 menit agar perubahan diterapkan.

   

Mengonfigurasi alur Terjemahan Dokumen

Sekarang setelah Anda menyelesaikan prasyarat dan penyiapan awal, mari kita mulai menggunakan konektor Penerjemah V3 untuk membuat alur terjemahan dokumen Anda:

1. Masuk ke Power Automate.

2. Pilih Buat dari menu bilah sisi kiri.

3. Pilih Alur cloud instan dari area konten utama.

   

4. Di jendela popup, beri nama alur Anda lalu pilih Pemicu alur secara manual dan pilih Buat.

   

5. Langkah pertama untuk alur instan Anda—Memicu alur secara manual—muncul di layar. Pilih Langkah baru.

   

Menerjemahkan dokumen

Selanjutnya, kita siap untuk memilih tindakan. Anda dapat menerjemahkan dokumen yang terletak di Akun Azure Blob Storage atau Microsoft SharePoint Anda.

Menggunakan Azure Blob Storage

Penyimpanan Blob Azure

Berikut adalah langkah-langkah untuk menerjemahkan file di Azure Blob Storage menggunakan konektor Penerjemah V3:

• Pilih konektor Penerjemah V3.
• Pilih terjemahan dokumen.
• Masukkan kredensial Azure Blob Storage dan lokasi kontainer Anda.
• Terjemahkan dokumen Anda memilih bahasa sumber dan target.
• Dapatkan status operasi terjemahan.

1. Di jendela pop-up Pilih operasi, masukkan Penerjemah V3 di bilah pencarian Cari konektor dan tindakan dan pilih ikon Microsoft Penerjemah V3.

   

2. Pilih tindakan Mulai terjemahan dokumen.

3. Jika Anda menggunakan konektor Penerjemah V3 untuk pertama kalinya, Anda perlu memasukkan kredensial sumber daya Anda:

   • nama Koneksi ion. Masukkan nama untuk koneksi Anda.

   • Kunci Langganan. Kunci sumber daya Penerjemah Anda ditemukan di bawah bagian Manajemen Sumber Daya pada bilah sisi sumber daya di portal Azure. Masukkan salah satu kunci Anda. Pastikan bahwa sumber daya Penerjemah Anda ditetapkan ke wilayah geografis seperti US Barat (bukan global).

   • Penerjemah nama sumber daya. Masukkan nama sumber daya Penerjemah Anda yang ditemukan di bagian atas halaman sumber daya Anda di portal Azure. Pilih Buat.

     

     Catatan

     Setelah menyiapkan koneksi, Anda tidak akan diharuskan memasukkan kembali kredensial untuk alur berikutnya.

4. Jendela Tindakan mulai terjemahan dokumen sekarang muncul. Lengkapi bidang sebagai berikut:

   • Untuk Jenis penyimpanan dokumen input. Pilih File atau Folder.

   • Pilih Bahasa Sumber dari menu dropdown atau pertahankan opsi Deteksi otomatis default.

   • Lokasi dokumen sumber. Masukkan URL untuk dokumen Anda di kontainer dokumen sumber penyimpanan Azure Anda.

   • Lokasi dokumen yang diterjemahkan. Masukkan URL untuk kontainer dokumen target penyimpanan Azure Anda.

     Untuk menemukan URL sumber dan target Anda:

     • Navigasikan ke akun penyimpanan Anda di portal Microsoft Azure.

     • Di bilah sisi kiri, di bawah Penyimpanan data , pilih Kontainer:

       Sumber	Target
       Pilih kotak centang di samping kontainer sumber	Pilih kotak centang di samping kontainer target.
       Dari area jendela utama, pilih file atau dokumen untuk terjemahan.	Pilih elipsis yang terletak di sebelah kanan, lalu pilih Properti.
       URL sumber terletak di bagian atas daftar Properti. Pilih ikon Salin ke Clipboard.	URL target terletak di bagian atas daftar Properti. Pilih ikon Salin ke Clipboard.
       Navigasikan ke alur Power automate Anda dan tempelkan URL sumber di bidang Lokasi dokumen sumber.	Navigasikan ke alur Power automate Anda dan tempelkan URL target di lokasi bidang dokumen yang diterjemahkan.

   • Pilih Bahasa Target dari menu dropdown dan pilih Simpan.

     

Dapatkan status dokumen

Sekarang setelah Anda mengirimkan dokumen untuk diterjemahkan, mari kita periksa status operasi.

1. Pilih Langkah baru.

2. Masukkan Penerjemah V3 di kotak pencarian dan pilih Microsoft Penerjemah V3.

3. Pilih Dapatkan status dokumen (bukan tindakan dapatkan status dokumen tunggal).

   

4. Selanjutnya, Anda akan memasukkan ekspresi untuk mengambil nilai.operation ID

5. Pilih bidang ID operasi. Jendela dropdown Ekspresi konten / dinamis muncul.

6. Pilih tab Ekspresi dan masukkan ekspresi berikut ke dalam bidang fungsi:

   
      body('Start_document_translation').operationID
   
   

   

7. Pilih OK. Fungsi muncul di jendela ID Operasi. Pilih Simpan.

   

Menguji alur konektor

Saatnya memeriksa alur dan hasil terjemahan dokumen kami.

1. Ada bilah hijau di bagian atas halaman yang menunjukkan bahwa alur Anda siap untuk digunakan.

2. Pilih Uji dari sudut kanan atas halaman.

   

3. Pilih tombol berikut: Uji Alur → Pengujian → Secara Manual dari jendela sisi kanan.

4. Di jendela berikutnya, pilih tombol Jalankan alur .

5. Terakhir, pilih tombol Selesai .

6. Anda akan menerima pesan Alur Anda berhasil dijalankan dan tanda centang hijau selaras dengan setiap langkah yang berhasil.

   

7. Pilih langkah Dapatkan status dokumen, lalu pilih Tampilkan output mentah dari bagian Output.

8. Jendela Dapatkan status dokumen muncul. Di bagian atas respons JSON, Anda melihat "statusCode":200 menunjukkan bahwa permintaan berhasil.

   

9. Sebagai pemeriksaan akhir, navigasikan ke kontainer sumber target Azure Blob Storage Anda. Di sana, Anda akan melihat dokumen yang diterjemahkan di bagian Gambaran Umum . Dokumen mungkin berada dalam folder berlabel kode bahasa terjemahan.

Menggunakan Microsoft SharePoint

Microsoft SharePoint

Berikut adalah langkah-langkah untuk mengunggah file dari situs SharePoint Anda ke Azure Blob Storage, menerjemahkan file, dan mengembalikan file yang diterjemahkan ke SharePoint:

• Ambil konten file sumber dari situs SharePoint Anda.
• Buat blob penyimpanan Azure dari file sumber.
• Terjemahkan file sumber.
• Mendapatkan status dokumen.
• Mendapatkan konten blob dan metadata.
• Buat folder SharePoint baru.
• Buat file terjemahan Anda di Sharepoint.

Dapatkan isi file

1. Di jendela pop-up Pilih operasi, masukkan SharePoint, lalu pilih konten Dapatkan konten file. Power Automate secara otomatis memasukkan Anda ke akun SharePoint Anda.

   

2. Pada jendela Langkah dapatkan konten file, selesaikan bidang berikut ini:

   • Alamat Situs. Pilih URL situs SharePoint tempat file Anda berada dari daftar dropdown.
   • Pengidentifikasi File. Pilih ikon folder dan pilih dokumen untuk terjemahan.

Membuat blob penyimpanan

1. Pilih Langkah baru dan masukkan Azure Blob Storage di kotak pencarian.

2. Pilih tindakan Buat blob (V2).

3. Jika Anda menggunakan langkah penyimpanan Azure untuk pertama kalinya, Anda perlu memasukkan autentikasi sumber daya penyimpanan Anda:

4. Di bidang Jenis autentikasi, pilih Microsoft Entra terintegrasi lalu pilih tombol Masuk.

   

5. Pilih akun Microsoft Entra yang terkait dengan Azure Blob Storage dan akun sumber daya Penerjemah Anda.

6. Setelah Anda menyelesaikan autentikasi Azure Blob Storage , langkah Buat blob akan muncul. Lengkapi bidang sebagai berikut:

   • Nama akun penyimpanan atau titik akhir blob. Pilih Masukkan nilai kustom dan masukkan nama akun penyimpanan Anda.

   • Jalur folder. Pilih ikon folder dan pilih kontainer dokumen sumber Anda.

   • Nama blob. Masukkan nama file yang sedang Anda terjemahkan.

   • Konten blob. Pilih bidang Konten blob untuk mengungkapkan daftar dropdown Konten dinamis dan pilih ikon Konten File SharePoint.

     

Mulai terjemahan dokumen

1. Pilih Langkah baru.

2. Masukkan Penerjemah V3 di kotak pencarian dan pilih Microsoft Penerjemah V3.

3. Pilih tindakan Mulai terjemahan dokumen.

4. Jika Anda menggunakan konektor Penerjemah V3 untuk pertama kalinya, Anda perlu memasukkan kredensial sumber daya Anda:

   • nama Koneksi ion. Masukkan nama untuk koneksi Anda.

   • Kunci Langganan. Masukkan salah satu kunci yang Anda salin dari portal Azure.

   • Penerjemah nama sumber daya. Masukkan nama sumber daya Penerjemah Anda yang ditemukan di bagian atas halaman sumber daya Anda di portal Azure.

   • Pilih Buat.

     

     Catatan

     Setelah menyiapkan koneksi, Anda tidak akan diharuskan memasukkan kembali kredensial untuk alur Penerjemah berikutnya.

5. Jendela Tindakan mulai terjemahan dokumen sekarang muncul. Lengkapi bidang sebagai berikut:

6. Untuk Jenis penyimpanan dokumen input. Pilih File atau Folder.

7. Pilih Bahasa Sumber dari menu dropdown atau pertahankan opsi Deteksi otomatis default.

8. Lokasi dokumen sumber. Pilih bidang dan tambahkan Jalur diikuti dengan Nama dari daftar dropdown Konten dinamis.

9. Lokasi dokumen yang diterjemahkan. Masukkan URL untuk kontainer dokumen target penyimpanan Azure Anda.

   Untuk menemukan URL kontainer target Anda:

   • Navigasikan ke akun penyimpanan Anda di portal Microsoft Azure.
   • Di bilah sisi kiri, di bawah Penyimpanan data , pilih Kontainer.
   • Pilih kotak centang di samping kontainer target.
   • Pilih elipsis yang terletak di sebelah kanan, lalu pilih Properti.
   • URL target terletak di bagian atas daftar Properti. Pilih ikon Salin ke Clipboard.
   • Navigasi kembali ke alur Power automate Anda dan tempelkan URL target di Lokasi bidang dokumen yang diterjemahkan.

10. Pilih Bahasa Target dari menu dropdown dan pilih Simpan.

    

Dapatkan status dokumen

Sebelum mengambil status dokumen, mari kita jadwalkan penundaan 30 detik untuk memastikan bahwa file telah diproses untuk diterjemahkan:

1. Pilih Langkah baru. Masukkan Jadwal di kotak pencarian dan pilih Tunda.

   • Untuk Hitungan. Masukkan 30.
   • Untuk Unit. Masukkan Kedua dari daftar dropdown.

   

2. Pilih Langkah baru. Masukkan Penerjemah V3 di kotak pencarian dan pilih Microsoft Penerjemah V3.

3. Pilih Dapatkan status dokumen (bukan status dapatkan dokumen tunggal).

   

4. Selanjutnya, Anda akan memasukkan ekspresi untuk mengambil nilai.operation ID

5. Pilih bidang ID operasi. Jendela dropdown Ekspresi konten / dinamis muncul.

6. Pilih tab Ekspresi dan masukkan ekspresi berikut ke dalam bidang fungsi:

   
     body('Start_document_translation').operationID
   
   

   

7. Pilih OK. Fungsi muncul di jendela ID Operasi. Pilih Simpan.

   

Mendapatkan konten blob dan metadata

Dalam langkah ini, Anda mengambil dokumen yang diterjemahkan dari Azure Blob Storage dan mengunggahnya ke SharePoint.

1. Pilih Langkah Baru, masukkan Kontrol di kotak pencarian, dan pilih Terapkan ke masing-masing dari daftar Tindakan .

2. Pilih bidang input untuk menampilkan jendela Konten dinamis dan pilih nilai.

   

3. Pilih Tambahkan tindakan.

   

4. Masukkan Kontrol di kotak pencarian dan pilih Lakukan hingga dari daftar Tindakan .

5. Pilih bidang Pilih nilai untuk memperlihatkan jendela Konten dinamis dan pilih kemajuan.

6. Selesaikan tiga bidang sebagai berikut: → kemajuan sama dengan → 1:

   

7. Pilih Tambahkan tindakan, masukkan Azure Blob Storage di kotak pencarian, dan pilih tindakan Dapatkan konten blob menggunakan jalur (V2).

8. Di bidang Nama akun penyimpanan atau titik akhir blob, pilih Masukkan nilai kustom dan masukkan nama akun penyimpanan Anda.

9. Pilih bidang Jalur blob untuk memperlihatkan jendela Konten dinamis, pilih Ekspresi dan masukkan logika berikut di bidang rumus:

   
      concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
   
   

10. Pilih Tambahkan tindakan, masukkan Azure Blob Storage di kotak pencarian, dan pilih tindakan Dapatkan Metadata Blob menggunakan jalur (V2).

11. Di bidang Nama akun penyimpanan atau titik akhir blob, pilih Masukkan nilai kustom dan masukkan nama akun penyimpanan Anda.

    

12. Pilih bidang Jalur blob untuk memperlihatkan jendela Konten dinamis, pilih Ekspresi dan masukkan logika berikut di bidang rumus:

    
       concat(split(outputs('Get_documents_status')?['body/path'],'/')[3],'/',split(outputs('Get_documents_status')?['body/path'],'/')[4],'/',split(outputs('Get_documents_status')?['body/path'],'/')[5])
    
    

Buat folder baru

1. Pilih Tambahkan tindakan, masukkan SharePoint di kotak pencarian, dan pilih tindakan Buat folder baru.
2. Pilih URL SharePoint Anda dari jendela dropdown Alamat Situs.
3. Di bidang berikutnya, pilih Daftar atau Pustaka dari menu dropdown.
4. Beri nama folder baru Anda dan masukkan di bidang /Folder Path/ (pastikan untuk mengapit nama jalur dengan garis miring).

Membuat file SharePoint

1. Pilih Tambahkan tindakan, masukkan SharePoint di kotak pencarian, dan pilih tindakan Buat file .

2. Pilih URL SharePoint Anda dari jendela dropdown Alamat Situs.

3. Di bidang Jalur Folder, dari daftar Konten dinamis, di bawah Buat folder baru, pilih Jalur Lengkap .

4. Di bidang Nama File, dari daftar Konten dinamis, di bawah Dapatkan Metadata Blob menggunakan jalur (V2), pilih Nama .

5. Di bidang Konten File, dari daftar Konten dinamis, di bawah Dapatkan Metadata Blob menggunakan jalur (V2) pilih Konten File .

6. Pilih Simpan.

   

Menguji alur konektor Anda

Mari kita periksa alur dan hasil terjemahan dokumen Anda.

1. Ada bilah hijau di bagian atas halaman yang menunjukkan bahwa alur Anda siap untuk digunakan..

2. Pilih Uji dari sudut kanan atas halaman.

   

3. Pilih Alur Pengujian → Uji → Secara Manual dari jendela sisi kanan.

4. Di jendela Jalankan alur , pilih tombol Lanjutkan lalu Jalankan alur .

5. Terakhir, pilih tombol Selesai .

6. Anda akan menerima pesan "Alur Anda berhasil dijalankan" dan tanda centang hijau selaras dengan setiap langkah yang berhasil.

   

Itu saja! Anda telah belajar mengotomatiskan proses terjemahan dokumen menggunakan konektor Microsoft Penerjemah V3 dan Power Automate.

Langkah berikutnya

Menjelajahi panduan referensi Terjemahan Dokumen