Belge Çevirisi akışı oluşturma (önizleme)

Önemli

Translator bağlayıcısı şu anda genel önizlemede kullanılabilir. Genel Kullanılabilirlik (GA) öncesinde kullanıcı geri bildirimlerine göre özellikler, yaklaşımlar ve süreçler değişebilir.

Bu öğretici, belge çevirisini destekleyen bir Microsoft Çeviri V3 bağlayıcısı bulut akışı yapılandırma konusunda size yol gösterir. Translator V3 bağlayıcısı Translator Hizmeti örneğinizle Microsoft Power Automate arasında bir bağlantı oluşturur ve uygulamalarınızda ve iş akışlarınızda bir veya daha fazla önceden oluşturulmuş işlemi adım olarak kullanmanızı sağlar.

Belge Çevirisi, Azure AI Translator hizmetinin bulut tabanlı bir REST API özelliğidir. Belge Çevirisi API'si, özgün belge yapısını ve veri biçimini korurken birden çok ve karmaşık belge çevirisini etkinleştirir.

Bu öğreticide:

• Kaynak ve hedef dosyalarınız için kapsayıcılarla bir blob depolama hesabı oluşturun.
• Rol tabanlı erişim denetimi (RBAC) ile yönetilen kimlik ayarlama.
• belgeleri Azure Blob Depolama hesabınızdan çevirin.
• SharePoint sitenizden belgeleri çevirin.

Önkoşullar

Başlamak için şunları yapmanız gerekir: Translator kaynağı, en az iki kapsayıcıya sahip Azure depolama hesabı ve rol tabanlı erişime sahip sistem tarafından atanan yönetilen kimlik.

Translator kaynağı

• Etkin bir Azure hesabınız yoksa ücretsiz olarak bir hesap oluşturabilirsiniz.

• Tek hizmetli translator kaynağı oluşturma (çok hizmetli bir Azure AI hizmetleri kaynağı değil ). Translator projesi ve örnek ayrıntıları alanlarını tamamladığınızda aşağıdaki girişlere özellikle dikkat edin:

  • Kaynak Bölgesi. Batı ABD (Küresel bölge değil) gibi bir coğrafi bölge seçin.

  • Fiyatlandırma katmanı. Hizmeti denemek için Standart S1'i seçin.

• Uygulamanızı Power Automate'e bağlamak için Translator kaynağınızdaki anahtarı ve adı kullanın. Translator kaynak anahtarlarınız Azure portalındaki Kaynak Yönetimi bölümünde bulunur ve kaynak adınız sayfanın en üstünde yer alır.

  

• Anahtarınızı ve kaynak adınızı kopyalayıp Microsoft Not Defteri gibi uygun bir konuma yapıştırın.

Azure depolama alanı

• Ardından, kaynak ve hedef dosyalarınız için bir Azure Blob Depolama hesabına ve en az iki kapsayıcıya ihtiyacınız vardır:

  • Kaynak kapsayıcı. Bu kapsayıcı, dosyalarınızı çeviri için karşıya yüklediğiniz yerdir (gerekli).
  • Hedef kapsayıcı. Bu kapsayıcı, çevrilen dosyalarınızın depolandığı yerdir (gereklidir).

• Depolama hesabınız bir güvenlik duvarının arkasındaysa ek yapılandırmaları etkinleştirmeniz gerekir:

  1. Azure portalına gidin ve Azure hesabınızla oturum açın.

  2. Depolama hesabınızı seçin.

  3. Sol bölmedeki Güvenlik + ağ grubunda Ağ'ı seçin.

  4. Güvenlik duvarları ve sanal ağlar sekmesinde Seçili sanal ağlardan ve IP adreslerinden etkinleştirildi'yi seçin.

     

  5. Tüm onay kutularının seçimini kaldırın.

  6. Microsoft ağ yönlendirmesi'nin seçili olduğundan emin olun.

  7. Kaynak örnekleri bölümünde kaynak türü olarak Microsoft.CognitiveServices/accounts öğesini seçin ve örnek adı olarak Translator kaynağınızı seçin.

  8. Güvenilen hizmetler listesindeki Azure hizmetlerinin bu depolama hesabına erişmesine izin ver kutusunun işaretli olduğundan emin olun. Özel durumları yönetme hakkında daha fazla bilgi için bkz. Azure Depolama güvenlik duvarlarını ve sanal ağları yapılandırma.

     

  9. Kaydet'i seçin. Ağ değişikliklerinin yayılması 5 dakika kadar sürebilir.

RBAC ile yönetilen kimlik

Son olarak, Belge çevirisi için Translator V3 bağlayıcısının işlemlerini kullanabilmeniz için önce Rol tabanlı kimlik denetimi (RBAC) ile yönetilen bir kimlik kullanarak Translator kaynağınıza depolama hesabınıza erişim izni vermelisiniz.

Yönetilen kimlik oluşturma

İlk olarak Translator kaynağınız için sistem tarafından atanan bir yönetilen kimlik oluşturun ve bu kimliğe Azure depolama hesabınıza erişmek için belirli izinler verin:

1. Azure portalına gidin ve Azure hesabınızla oturum açın.

2. Translator kaynağını seçin.

3. Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.

4. Sistem tarafından atanan sekmesinde Durum iki durumlu düğmesini açın.

5. Kaydet'i seçin.

   

Rol ataması

Ardından, depolama kaynağınızın depolama kapsamında yönetilen kimliğe bir Storage Blob Data Contributor rol atayın.

1. Azure portalına gidin ve Azure hesabınızla oturum açın.

2. Translator kaynağını seçin.

3. Sol bölmedeki Kaynak Yönetimi grubunda Kimlik'i seçin.

4. İzinler'in altında Azure rol atamaları'ı seçin:

   

5. Açılan Azure rol atamaları sayfasında, açılan menüden aboneliğinizi seçin ve ardından + Rol ataması ekle'yi seçin.

   

6. Son olarak, Translator hizmet kaynağınıza bir Depolama Blobu Veri Katkıda Bulunanı rolü atayın. Depolama Blob Verileri Katkıda Bulunanı rolü, Translator'a (sistem tarafından atanan yönetilen kimlik tarafından temsil edilir) blob kapsayıcısına ve verilerine okuma, yazma ve silme erişimi verir. Rol ataması ekle açılır penceresinde, alanları aşağıdaki gibi doldurun ve Kaydet'i seçin:

   Alan	Değer
   Scope	Depolama.
   Abonelik	Depolama kaynağınızla ilişkili abonelik.
   Kaynak	Depolama kaynağınızın adı.
   Rol	Depolama Blob Verileri Katkıda Bulunanı.

7. Rol ataması eklendi onay iletisi görüntülendikten sonra eklenen rol atamasını görmek için sayfayı yenileyin.

   

8. Yeni rol atamasını hemen görmüyorsanız bekleyin ve sayfayı yenilemeyi yeniden deneyin. Rol atamalarını atadığınızda veya kaldırdığınızda değişikliklerin geçerlilik kazanması 30 dakika kadar sürebilir.

   

Belge Çevirisi akışı yapılandırma

Önkoşulları ve ilk kurulumu tamamladığınıza göre, belge çevirisi akışınızı oluşturmak için Translator V3 bağlayıcısını kullanmaya başlayalım:

1. Power Automate'te oturum açın.

2. Sol kenar çubuğu menüsünden Oluştur'u seçin.

3. Ana içerik alanından Anlık bulut akışı'nı seçin.

   

4. Açılan pencerede akışınızı adlandırın, ardından Akışı el ile tetikle'yi seçin ve Oluştur'u seçin.

   

5. Anlık akışınız için ilk adım (Akışı el ile tetikleme) ekranda görünür. Yeni adım'ı seçin.

   

Belgeleri çevirme

Ardından, bir eylem seçmeye hazırız. Azure Blob Depolama veya Microsoft SharePoint hesabınızda bulunan belgeleri çevirebilirsiniz.

Azure Blob Depolama kullanma

Azure Blob Storage

Translator V3 bağlayıcısını kullanarak Azure Blob Depolama'da bir dosyayı çevirme adımları şunlardır:

• Translator V3 bağlayıcısını seçin.
• Belge çevirisi'ne tıklayın.
• Azure Blob Depolama kimlik bilgilerinizi ve kapsayıcı konumlarınızı girin.
• Kaynak ve hedef dilleri seçerek belgelerinizi çevirin.
• Çeviri işleminin durumunu alın.

1. İşlem seçin açılır penceresinde, Bağlayıcılar ve eylemler arama çubuğuna Translator V3 yazın ve Microsoft Çeviri V3 simgesini seçin.

   

2. Belge çevirisini başlat eylemini seçin.

3. Translator V3 bağlayıcısını ilk kez kullanıyorsanız kaynak kimlik bilgilerinizi girmeniz gerekir:

   • Bağlantı adı. Bağlantınız için bir ad girin.

   • Abonelik Anahtarı. Translator kaynak anahtarlarınız Azure portalındaki kaynak kenar çubuğunun Kaynak Yönetimi bölümünde bulunur. Anahtarlarınızdan birini girin. Translator kaynağınızın Batı ABD (genel değil) gibi bir coğrafi bölgeye atandığından emin olun.

   • Translator kaynak adı. Azure portalında kaynak sayfanızın üst kısmında bulunan Translator kaynağınızın adını girin. Oluştur'u belirleyin.

     

     Not

     Bağlantınızı ayarladıktan sonra, sonraki akışlar için kimlik bilgilerinizi yeniden kullanmanız gerekmez.

4. Belge çevirisini başlat eylem penceresi şimdi görüntülenir. Alanları aşağıdaki gibi tamamlayın:

   • Giriş belgelerinin Depolama türü için. Dosya veya Klasör'e tıklayın.

   • Açılan menüden bir Kaynak Dil seçin veya varsayılan Otomatik algılama seçeneğini koruyun.

   • Kaynak belgelerin konumu. Azure depolama kaynağı belge kapsayıcınızda belgelerinizin URL'sini girin.

   • Çevrilen belgelerin konumu. Azure depolama hedef belge kapsayıcınızın URL'sini girin.

     Kaynak ve hedef URL'lerinizi bulmak için:

     • Azure portalda depolama hesabınıza gidin.

     • Sol kenar çubuğundaki Veri depolama altında Kapsayıcılar'ı seçin:

       Source	Target
       Kaynak kapsayıcının yanındaki onay kutusunu seçin	Hedef kapsayıcının yanındaki onay kutusunu seçin.
       Ana pencere alanından çeviri için bir dosya veya belge seçin.	Sağ tarafta bulunan üç noktayı ve ardından Özellikler'i seçin.
       Kaynak URL, Özellikler listesinin en üstünde bulunur. Panoya Kopyala simgesini seçin.	Hedef URL, Özellikler listesinin en üstünde bulunur. Panoya Kopyala simgesini seçin.
       Power automate akışınıza gidin ve kaynak URL'yi kaynak belgelerin konumu alanına yapıştırın.	Power automate akışınıza gidin ve hedef URL'yi çevrilmiş belgelerin konumu alanına yapıştırın.

   • Açılan menüden bir Hedef Dil seçin ve Kaydet'i seçin.

     

Belgelerin durumunu alma

Belgelerinizi çeviri için gönderdiğinize göre işlemin durumunu denetleyelim.

1. Yeni adım'ı seçin.

2. Arama kutusuna Translator V3 yazın ve V3'Microsoft Çeviri seçin.

3. Belgeleri al durumunu seçin (tekil Belge durumunu al eylemini değil).

   

4. Ardından, değeri almak operation ID için bir ifade gireceksiniz.

5. İşlem kimliği alanını seçin. Dinamik içerik / İfadesi açılan penceresi görüntülenir.

6. İfade sekmesini seçin ve işlev alanına aşağıdaki ifadeyi girin:

   
      body('Start_document_translation').operationID
   
   

   

7. Tamam'ı seçin. İşlev, İşlem Kimliği penceresinde görüntülenir. Kaydet'i seçin.

   

Bağlayıcı akışını test edin

Akış ve belge çevirisi sonuçlarımızı denetleme zamanı.

1. Sayfanın üst kısmında Akışınız'ın kullanıma hazır olduğunu gösteren yeşil bir çubuk vardır.

2. Sayfanın sağ üst köşesinden Test'i seçin.

   

3. Aşağıdaki düğmeleri seçin: Sağ taraftaki pencerede Test Akışı → El ile → Test .

4. Sonraki pencerede Akışı çalıştır düğmesini seçin.

5. Son olarak Bitti düğmesini seçin.

6. Akışınız başarıyla çalıştı iletisini almanız ve yeşil onay işaretlerinin her başarılı adımla uyumlu olması gerekir.

   

7. Belgeleri al durum adımını ve ardından Çıkışlar bölümünden Ham çıkışları göster'i seçin.

8. Belgeleri al durum penceresi görüntülenir. JSON yanıtının en üstünde, isteğin başarılı olduğunu belirten bir ifade görürsünüz "statusCode":200 .

   

9. Son denetim olarak Azure Blob Depolama hedef kaynak kapsayıcınıza gidin. Burada, çevrilmiş belgeyi Genel Bakış bölümünde görmeniz gerekir. Belge, çeviri dil koduyla etiketlenmiş bir klasörde olabilir.

Microsoft SharePoint'i kullanma

Microsoft SharePoint

SharePoint sitenizden Azure Blob Depolama dosya yükleme, dosyayı çevirme ve çevrilen dosyayı SharePoint'e döndürme adımları şunlardır:

• Kaynak dosya içeriğini SharePoint sitenizden alın.
• Kaynak dosyadan bir Azure depolama blobu oluşturun.
• Kaynak dosyayı çevirin.
• Belgelerin durumunu alma.
• Blob içeriğini ve meta verilerini alın.
• Yeni bir SharePoint klasörü oluşturun.
• Çevrilmiş dosyanızı Sharepoint'te oluşturun.

Dosya içeriğini alma

1. İşlem seçin açılır penceresinde SharePoint yazın ve dosya içeriği al'ı seçin. Power Automate, sharepoint hesaplarınızda otomatik olarak oturum açar.

   

2. Dosya içeriğini al adım penceresinde aşağıdaki alanları doldurun:

   • Site Adresi. Açılan listeden dosyanızın bulunduğu SharePoint sitesi URL'sini seçin.
   • Dosya Tanımlayıcısı. Klasör simgesini seçin ve çeviri için belgeleri seçin.

Depolama blobu oluşturma

1. Yeni adım'ı seçin ve arama kutusuna Azure Blob Depolama girin.

2. Blob oluştur (V2) eylemini seçin.

3. Azure depolama adımını ilk kez kullanıyorsanız depolama kaynağı kimlik doğrulamanızı girmeniz gerekir:

4. Kimlik doğrulama türü alanında Microsoft Entra tümleşik'i ve ardından Oturum aç düğmesini seçin.

   

5. Azure Blob Depolama ve Translator kaynak hesaplarınızla ilişkili Microsoft Entra hesabını seçin.

6. Azure Blob Depolama kimlik doğrulamasını tamamladıktan sonra Blob oluştur adımı görüntülenir. Alanları aşağıdaki gibi tamamlayın:

   • Depolama hesabı adı veya blob uç noktası. Özel değer girin'i seçin ve depolama hesabı adınızı girin.

   • Klasör yolu. Klasör simgesini seçin ve kaynak belge kapsayıcınızı seçin.

   • Blob adı. Çevirdiğiniz dosyanın adını girin.

   • Blob içeriği. Dinamik içerik açılan listesini görüntülemek için Blob içerik alanını seçin ve SharePoint Dosya İçeriği simgesini seçin.

     

Belge çevirisi başlatma

1. Yeni adım'ı seçin.

2. Arama kutusuna Translator V3 yazın ve V3'Microsoft Çeviri seçin.

3. Belge çevirisini başlat eylemini seçin.

4. Translator V3 bağlayıcısını ilk kez kullanıyorsanız kaynak kimlik bilgilerinizi girmeniz gerekir:

   • Bağlantı adı. Bağlantınız için bir ad girin.

   • Abonelik Anahtarı. Azure portalından kopyaladığınız anahtarlardan birini girin.

   • Translator kaynak adı. Azure portalında kaynak sayfanızın üst kısmında bulunan Translator kaynağınızın adını girin.

   • Oluştur'u belirleyin.

     

     Not

     Bağlantınızı ayarladıktan sonra, sonraki Translator akışları için kimlik bilgilerinizi yeniden kullanmanız gerekmez.

5. Belge çevirisini başlat eylem penceresi şimdi görüntülenir. Alanları aşağıdaki gibi tamamlayın:

6. Giriş belgelerinin Depolama türü için. Dosya veya Klasör'e tıklayın.

7. Açılan menüden bir Kaynak Dil seçin veya varsayılan Otomatik algılama seçeneğini koruyun.

8. Kaynak belgelerin konumu. Alanı seçin ve Dinamik içerik açılan listesinden Yol'u ve ardından Ad'ı ekleyin.

9. Çevrilen belgelerin konumu. Azure depolama hedef belge kapsayıcınızın URL'sini girin.

   Hedef kapsayıcı URL'nizi bulmak için:

   • Azure portalda depolama hesabınıza gidin.
   • Sol kenar çubuğunda, Veri depolama altında Kapsayıcılar'ı seçin.
   • Hedef kapsayıcının yanındaki onay kutusunu seçin.
   • Sağ tarafta bulunan üç noktayı ve ardından Özellikler'i seçin.
   • Hedef URL, Özellikler listesinin en üstünde bulunur. Panoya Kopyala simgesini seçin.
   • Power automate akışınıza geri dönün ve hedef URL'yi çevrilen belgelerin konumu alanına yapıştırın.

10. Açılan menüden bir Hedef Dil seçin ve Kaydet'i seçin.

    

Belgelerin durumunu alma

Belgelerin durumunu almadan önce, dosyanın çeviri için işlenmesini sağlamak için 30 saniyelik bir gecikme zamanlayalım:

1. Yeni adım'ı seçin. Arama kutusuna Zamanlama yazın ve Geciktir'i seçin.

   • Sayı için. 30 girin.
   • Birim için. Açılan listeden İkinci girin.

   

2. Yeni adım'ı seçin. Arama kutusuna Translator V3 yazın ve V3'Microsoft Çeviri seçin.

3. Belgeleri al durumunu seçin (tekil Belge durumunu al'ı değil).

   

4. Ardından, değeri almak operation ID için bir ifade gireceksiniz.

5. İşlem kimliği alanını seçin. Dinamik içerik / İfadesi açılan penceresi görüntülenir.

6. İfade sekmesini seçin ve işlev alanına aşağıdaki ifadeyi girin:

   
     body('Start_document_translation').operationID
   
   

   

7. Tamam'ı seçin. İşlev, İşlem Kimliği penceresinde görüntülenir. Kaydet'i seçin.

   

Blob içeriğini ve meta verilerini alma

Bu adımda, çevrilmiş belgeyi Azure Blob Depolama alır ve SharePoint'e yüklersiniz.

1. Yeni Adım'ı seçin, arama kutusuna Denetim yazın ve Eylemler listesinden Her birine uygula'yı seçin.

2. Giriş alanını seçerek Dinamik içerik penceresini görüntüleyin ve değeri seçin.

   

3. Eylem ekle'yi seçin.

   

4. Arama kutusuna Denetim yazın ve Eylemler listesinden Yap'ı seçin.

5. Dinamik içerik penceresini göstermek için Değer seçin alanını seçin ve ilerleme durumunu seçin.

6. Üç alanı şu şekilde tamamlayın: ilerleme → → 1'e eşittir:

   

7. Eylem ekle'yi seçin, arama kutusuna Azure Blob Depolama girin ve Yolu kullanarak blob içeriği al (V2) eylemini seçin.

8. Depolama hesabı adı veya blob uç noktası alanında Özel değer girin'i seçin ve depolama hesabı adınızı girin.

9. Dinamik içerik penceresini göstermek için Blob yolu alanını seçin, İfade'yi seçin ve formül alanına aşağıdaki mantığı girin:

   
      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. Eylem ekle'yi seçin, arama kutusuna Azure Blob Depolama girin ve Yolu kullanarak Blob Meta Verilerini Al (V2) eylemini seçin.

11. Depolama hesabı adı veya blob uç noktası alanında Özel değer girin'i seçin ve depolama hesabı adınızı girin.

    

12. Dinamik içerik penceresini göstermek için Blob yolu alanını seçin, İfade'yi seçin ve formül alanına aşağıdaki mantığı girin:

    
       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])
    
    

Yeni klasör oluştur

1. Eylem ekle'yi seçin, arama kutusuna SharePoint yazın ve Yeni klasör oluştur eylemini seçin.
2. Site Adresi açılan penceresinden SharePoint URL'nizi seçin.
3. Sonraki alanda, açılan listeden bir Liste veya Kitaplık seçin.
4. Yeni klasörünüzü adlandırın ve /Klasör Yolu/ alanına girin (yol adını eğik çizgilerle çevrelediğinden emin olun).

SharePoint dosyası oluşturma

1. Eylem ekle'yi seçin, arama kutusuna SharePoint yazın ve Dosya oluştur eylemini seçin.

2. Site Adresi açılan penceresinden SharePoint URL'nizi seçin.

3. Klasör Yolu alanında, Dinamik içerik listesinde, Yeni klasör oluştur altında Tam Yol'u seçin.

4. Dosya Adı alanındaki Dinamik içerik listesinde, Yolu kullanarak Blob Meta Verilerini Al (V2) altında Ad 'ı seçin.

5. Dosya İçeriği alanındaki Dinamik içerik listesinde, Yolu kullanarak Blob Meta Verilerini Al (V2) altında Dosya İçeriği'ni seçin.

6. Kaydet'i seçin.

   

Bağlayıcı akışınızı test edin

Şimdi belge çevirisi akışınızı ve sonuçlarınızı denetleyelim.

1. Sayfanın üst kısmında Akışınız'ın kullanıma hazır olduğunu gösteren yeşil bir çubuk vardır..

2. Sayfanın sağ üst köşesinden Test'i seçin.

   

3. Sağ taraftaki pencerede Test Akışı → El ile → Test'i seçin.

4. Akışı çalıştır penceresinde Devam'ı ve ardından Akışı çalıştır düğmelerini seçin.

5. Son olarak Bitti düğmesini seçin.

6. "Akışınız başarıyla çalıştı" iletisini almanız ve her başarılı adımla uyumlu yeşil onay işaretleri almanız gerekir.

   

İşte hepsi bu! Microsoft Çeviri V3 bağlayıcısını ve Power Automate'i kullanarak belge çevirisi işlemlerini otomatikleştirmeyi öğrendinsiniz.

Sonraki adımlar

Belge Çevirisi başvuru kılavuzunu keşfetme