Dokumentumfordítási folyamat létrehozása (előzetes verzió)

Fontos

A Translator-összekötő jelenleg nyilvános előzetes verzióban érhető el. A funkciók, a megközelítések és a folyamatok az általános rendelkezésre állás (GA) előtt változhatnak a felhasználói visszajelzések alapján.

Ez az oktatóanyag végigvezeti a Dokumentumfordítást támogató Microsoft Translator V3-összekötő felhőfolyamatának konfigurálásával. A Translator V3-összekötő kapcsolatot hoz létre a Translator Service-példány és a Microsoft Power Automate között, amely lehetővé teszi egy vagy több előre összeállított művelet használatát az alkalmazások és munkafolyamatok lépéseiként.

A dokumentumfordítás az Azure AI Translator szolgáltatás felhőalapú REST API-funkciója. A Dokumentumfordítás API több és összetett dokumentumfordítást tesz lehetővé az eredeti dokumentumstruktúra és adatformátum megőrzése mellett.

Ebben az oktatóanyagban:

• Hozzon létre egy Blob Storage-fiókot a forrás- és célfájlok tárolóival.
• Felügyelt identitás beállítása szerepköralapú hozzáférés-vezérléssel (RBAC).
• Dokumentumok fordítása Az Azure Blob Storage-fiókból.
• Dokumentumok fordítása a SharePoint-webhelyről.

Előfeltételek

A következőkre van szüksége az első lépésekhez: Translator-erőforrás, legalább két tárolóval rendelkező Azure Storage-fiók és egy szerepköralapú hozzáféréssel rendelkező, rendszer által hozzárendelt felügyelt identitás.

Translator-erőforrás

• Ha nem rendelkezik aktív Azure-fiókkal, ingyenesen létrehozhat egyet.

• Hozzon létre egy egyszolgáltatásos Translator-erőforrást (nem többszolgáltatásos Azure AI-szolgáltatási erőforrást). A Translator projekt és a példány részletei mezőinek elvégzése során különös figyelmet kell fordítania a következő bejegyzésekre:

  • Erőforrásrégió. Válasszon egy olyan földrajzi régiót, mint az USA nyugati régiója (nem a globális régió).

  • Tarifacsomag. A szolgáltatás kipróbálásához válassza a Standard S1 lehetőséget.

• A Translator-erőforrás kulcsával és nevével csatlakoztassa az alkalmazást a Power Automate-hez. A Translator erőforráskulcsai az Azure Portal Erőforrás-kezelés szakaszában találhatók, az erőforrás neve pedig a lap tetején található.

  

• Másolja és illessze be a kulcsot és az erőforrás nevét egy kényelmes helyre, például a Microsoft Jegyzettömb.

Azure Storage

• Ezután szüksége lesz egy Azure Blob Storage-fiókra és legalább két tárolóra a forrás- és célfájlokhoz:

  • Forrástároló. Ebben a tárolóban töltheti fel a fájlokat fordításra (kötelező).
  • Céltároló. Ez a tároló tárolja a lefordított fájlokat (kötelező).

• Ha a tárfiók tűzfal mögött található, további konfigurációkat kell engedélyeznie:

  1. Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.

  2. Válassza ki a Tárfiókot.

  3. A bal oldali panel Biztonság + hálózatkezelés csoportjában válassza a Hálózatkezelés lehetőséget.

  4. A Tűzfalak és virtuális hálózatok lapon válassza az Engedélyezve lehetőséget a kiválasztott virtuális hálózatok és IP-címek közül.

     

  5. Törölje az összes jelölőnégyzet kijelölését.

  6. Győződjön meg arról, hogy a Microsoft hálózati útválasztása be van jelölve.

  7. Az Erőforráspéldányok szakaszban válassza a Microsoft.CognitiveServices/accounts lehetőséget erőforrástípusként, és válassza ki a Translator-erőforrást a példány neveként.

  8. Győződjön meg arról, hogy a megbízható szolgáltatások listájában szereplő Azure-szolgáltatások hozzáférésének engedélyezése a tárfiókhoz jelölőnégyzet be van jelölve. A kivételek kezelésével kapcsolatos további információkért lásd: Azure Storage-tűzfalak és virtuális hálózatok konfigurálása.

     

  9. Válassza a Mentés parancsot. A hálózati módosítások propagálása akár 5 percet is igénybe vehet.

Felügyelt identitás RBAC-vel

Végül, mielőtt használhatja a Translator V3-összekötő műveleteit a dokumentumfordításhoz, hozzá kell adnia a Translator erőforrás-hozzáférését a tárfiókhoz egy felügyelt identitással, szerepköralapú identitásvezérléssel (RBAC).

Felügyelt identitás létrehozása

Először hozzon létre egy rendszer által hozzárendelt felügyelt identitást a Translator-erőforráshoz, és adja meg az identitásspecifikus engedélyeket az Azure Storage-fiók eléréséhez:

1. Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.

2. Válassza ki a Translator-erőforrást.

3. A bal oldali panel Erőforrás-kezelés csoportjában válassza az Identitás lehetőséget.

4. A Rendszerhez rendelt lapon kapcsolja be az Állapot váltógombot.

5. Válassza a Mentés parancsot.

   

Role assignment

Ezután rendeljen hozzá egy szerepkört Storage Blob Data Contributor a felügyelt identitáshoz a tárolási erőforrás tárolási hatókörében.

1. Nyissa meg az Azure Portalt, és jelentkezzen be Azure-fiókjába.

2. Válassza ki a Translator-erőforrást.

3. A bal oldali panel Erőforrás-kezelés csoportjában válassza az Identitás lehetőséget.

4. Az Engedélyek területen válassza ki az Azure-szerepkör-hozzárendeléseket:

   

5. A megnyitott Azure-szerepkör-hozzárendelések lapon válassza ki az előfizetését a legördülő menüből, majd válassza a + Szerepkör-hozzárendelés hozzáadása lehetőséget.

   

6. Végül rendeljen hozzá egy Storage Blob Data Contributor szerepkört a Translator szolgáltatás erőforrásához. A Storage Blob Data Contributor szerepkör olvasási, írási és törlési hozzáférést biztosít a Translatornek (amelyet a rendszer által hozzárendelt felügyelt identitás képvisel) a blobtárolóhoz és az adatokhoz. A Szerepkör-hozzárendelés hozzáadása előugró ablakban töltse ki a mezőket az alábbiak szerint, és válassza a Mentés lehetőséget:

   Mező	Érték
   Hatókör	Tárhely.
   Előfizetés	A tárolási erőforráshoz társított előfizetés.
   Erőforrás	A tárolási erőforrás neve.
   Szerepkör	Tárolóblobadatok közreműködője.

7. Miután megjelenik a Szerepkör-hozzárendelés hozzáadása megerősítő üzenet, frissítse a lapot a hozzáadott szerepkör-hozzárendelés megtekintéséhez.

   

8. Ha nem látja azonnal az új szerepkör-hozzárendelést, várjon, és próbálkozzon újra a lap frissítésével. Szerepkör-hozzárendelések hozzárendelése vagy eltávolítása akár 30 percet is igénybe vehet, amíg a módosítások érvénybe lépnek.

   

Dokumentumfordítási folyamat konfigurálása

Most, hogy elvégezte az előfeltételeket és a kezdeti beállításokat, először használja a Translator V3-összekötőt a dokumentumfordítási folyamat létrehozásához:

1. Jelentkezzen be Power Automate.

2. Válassza a Bal oldali oldalsáv menüjében a Létrehozás lehetőséget.

3. Válassza az Azonnali felhőfolyamat lehetőséget a fő tartalomterületről.

   

4. Az előugró ablakban nevezze el a folyamatot, majd válassza a Folyamat manuális aktiválása, majd a Létrehozás lehetőséget.

   

5. Az azonnali folyamat első lépése – a folyamat manuális aktiválása – megjelenik a képernyőn. Válassza az Új lépés lehetőséget.

   

Dokumentumok fordítása

Ezután készen állunk egy művelet kiválasztására. Az Azure Blob Storage-ban vagy a Microsoft SharePoint-fiókban található dokumentumokat lefordíthatja.

Az Azure Blob Storage használata

Azure Blob Storage

Az alábbiakban bemutatjuk az Azure Blob Storage-fájl fordításának lépéseit a Translator V3-összekötő használatával:

• Válassza ki a Translator V3-összekötőt.
• Válassza ki a dokumentumfordítást.
• Adja meg az Azure Blob Storage hitelesítő adatait és tárolóhelyeit.
• Lefordíthatja a forrás- és célnyelveket választó dokumentum(ok) fordítását.
• A fordítási művelet állapotának lekérése.

1. A Művelet kiválasztása előugró ablakban írja be a Translator V3 kifejezést a Keresési összekötők és műveletek keresősávba, és válassza a Microsoft Translator V3 ikont.

   

2. Válassza a Dokumentumfordítás indítása műveletet.

3. Ha első alkalommal használja a Translator V3-összekötőt, meg kell adnia az erőforrás hitelesítő adatait:

   • Csatlakozás ion név. Adja meg a kapcsolat nevét.

   • Előfizetési kulcs. A Translator-erőforráskulcsok az Azure Portal erőforrás-oldalsávjának Erőforrás-kezelés szakaszában találhatók. Adja meg az egyik kulcsát. Győződjön meg arról, hogy a Translator-erőforrás egy olyan földrajzi régióhoz van hozzárendelve, mint az USA nyugati régiója (nem globális).

   • Translator-erőforrás neve. Adja meg a Translator-erőforrás nevét az erőforráslap tetején, az Azure Portalon. Válassza a Létrehozás parancsot.

     

     Megjegyzés:

     A kapcsolat beállítása után nem kell újból megadnia a hitelesítő adatait a későbbi folyamatokhoz.

4. Ekkor megjelenik a Dokumentumfordítás indítása művelet ablak. Töltse ki a mezőket az alábbiak szerint:

   • A bemeneti dokumentumok Tárolási típusa esetén. Válassza a Fájl vagy mappa lehetőséget.

   • Válasszon egy forrásnyelvet a legördülő menüből, vagy tartsa meg az alapértelmezett automatikus észlelési beállítást.

   • A forrásdokumentumok helye. Adja meg a dokumentum(ok) URL-címét az Azure Storage-forrásdokumentum tárolójában.

   • A lefordított dokumentumok helye. Adja meg az Azure Storage-céldokumentum tárolójának URL-címét.

     A forrás- és cél URL-címek megkeresése:

     • Az Azure Portalon nyissa meg a tárfiókot.

     • A bal oldali oldalsáv Adattárolás területén válassza a Tárolók lehetőséget:

       Source	Target
       Jelölje be a forrástároló melletti jelölőnégyzetet	Jelölje be a céltároló melletti jelölőnégyzetet.
       A főablak területén válasszon ki egy fájlt vagy dokumentumot a fordításhoz.	Válassza ki a jobb oldalon található három pontot, majd válassza a Tulajdonságok lehetőséget.
       A forrás URL-címe a Tulajdonságok lista tetején található. Válassza a Másolás vágólapra ikont.	A cél URL-cím a Tulajdonságok lista tetején található. Válassza a Másolás vágólapra ikont.
       Lépjen a Power Automate-folyamatra, és illessze be a forrás URL-címét a Forrásdokumentumok helye mezőbe.	Lépjen a Power Automate-folyamatra, és illessze be a cél URL-címet a lefordított dokumentumok helye mezőbe.

   • Válasszon egy célnyelvet a legördülő menüből, és válassza a Mentés lehetőséget.

     

Dokumentumok állapotának lekérése

Most, hogy elküldte a dokumentum(oka)t fordításra, ellenőrizzük a művelet állapotát.

1. Válassza az Új lépés lehetőséget.

2. Írja be a Translator V3 kifejezést a keresőmezőbe, és válassza a Microsoft Translator V3 lehetőséget.

3. Válassza a Dokumentumok lekérése állapotot (nem a dokumentum állapotának lekérése műveletet).

   

4. Ezután egy kifejezést fog megadni az érték lekéréséhez operation ID .

5. Válassza ki a műveletazonosító mezőt. Megjelenik egy Dinamikus tartalomkifejezés / legördülő ablak.

6. Jelölje ki a Kifejezés lapot, és írja be a következő kifejezést a függvénymezőbe:

   
      body('Start_document_translation').operationID
   
   

   

7. Kattintson az OK gombra. A függvény megjelenik a Műveletazonosító ablakban. Válassza a Mentés parancsot.

   

Az összekötő folyamatának tesztelése

Itt az idő a folyamat és a dokumentumfordítás eredményeinek ellenőrzésére.

1. Az oldal tetején egy zöld sáv jelzi, hogy a folyamat készen áll a használatra.

2. Válassza a Teszt lehetőséget a lap jobb felső sarkában.

   

3. Válassza a következő gombokat: A folyamat tesztelése → a jobb oldali ablakból → tesztelés manuális →.

4. A következő ablakban válassza a Folyamat futtatása gombot.

5. Végül válassza a Kész gombot.

6. A folyamat sikeresen lefutott üzenetét kell kapnia, és a zöld pipajelek minden sikeres lépéshez igazodnak.

   

7. Válassza a Dokumentumok lekérése állapotlépést, majd a Kimenetek szakaszban válassza a Nyers kimenetek megjelenítése lehetőséget.

8. Megjelenik a Dokumentumok lekérése állapotablak . A JSON-válasz tetején látható "statusCode":200 , hogy a kérés sikeres volt.

   

9. Végső ellenőrzésként keresse meg az Azure Blob Storage célforrás-tárolóját. Itt a lefordított dokumentumnak az Áttekintés szakaszban kell megjelennie . Előfordulhat, hogy a dokumentum egy fordítási nyelvi kóddal ellátott mappában található.

A Microsoft SharePoint használata

Microsoft SharePoint

Az alábbi lépésekkel tölthet fel egy fájlt a SharePoint-webhelyről az Azure Blob Storage-ba, lefordíthatja a fájlt, és visszaküldheti a lefordított fájlt a SharePointba:

• Kérje le a forrásfájl tartalmát a SharePoint-webhelyről.
• Hozzon létre egy Azure Storage-blobot a forrásfájlból.
• Fordítsa le a forrásfájlt.
• Dokumentumok állapotának lekérése.
• Blobtartalmak és metaadatok lekérése.
• Hozzon létre egy új SharePoint-mappát.
• A lefordított fájl létrehozása a SharePointban.

Fájltartalom lekérése

1. A Művelet kiválasztása előugró ablakban írja be a SharePointot, majd válassza a Fájltartalom lekérése lehetőséget. A Power Automate automatikusan bejelentkezteti Önt SharePoint-fiókjába.

   

2. A Fájltartalom lekérése lépésablakban töltse ki a következő mezőket:

   • Webhely címe. Válassza ki azt a SharePoint-webhely URL-címét, ahol a fájl található a legördülő listából.
   • Fájlazonosító. Válassza ki a mappaikont, és válassza ki a fordításhoz szükséges dokumentum(ok)t.

Tárolóblob létrehozása

1. Válassza az Új lépést , és írja be az Azure Blob Storage kifejezést a keresőmezőbe.

2. Válassza a Blob létrehozása (V2) műveletet.

3. Ha első alkalommal használja az Azure Storage lépést, meg kell adnia a tárerőforrás-hitelesítést:

4. A Hitelesítés típusa mezőben válassza az Integrált Microsoft Entra lehetőséget, majd válassza a Bejelentkezés gombot.

   

5. Válassza ki az Azure Blob Storage- és Translator-erőforrásfiókokhoz társított Microsoft Entra-fiókot.

6. Az Azure Blob Storage-hitelesítés befejezése után megjelenik a Blob létrehozása lépés. Töltse ki a mezőket az alábbiak szerint:

   • Tárfiók neve vagy blobvégpont. Válassza az Enter custom value (Egyéni érték megadása) lehetőséget , és adja meg a tárfiók nevét.

   • Mappa elérési útja. Válassza ki a mappa ikont, és válassza ki a forrásdokumentum-tárolót.

   • Blob neve. Adja meg a lefordított fájl nevét.

   • Blobtartalom. A Dinamikus tartalom legördülő lista megjelenítéséhez jelölje ki a Blob tartalom mezőjét, és válassza a SharePoint-fájl tartalma ikont.

     

Dokumentumfordítás indítása

1. Válassza az Új lépés lehetőséget.

2. Írja be a Translator V3 kifejezést a keresőmezőbe, és válassza a Microsoft Translator V3 lehetőséget.

3. Válassza a Dokumentumfordítás indítása műveletet.

4. Ha első alkalommal használja a Translator V3-összekötőt, meg kell adnia az erőforrás hitelesítő adatait:

   • Csatlakozás ion név. Adja meg a kapcsolat nevét.

   • Előfizetési kulcs. Adja meg az Azure Portalról másolt kulcsok egyikét.

   • Translator-erőforrás neve. Adja meg a Translator-erőforrás nevét az erőforráslap tetején, az Azure Portalon.

   • Válassza a Létrehozás parancsot.

     

     Megjegyzés:

     A kapcsolat beállítása után nem kell újból megadnia a hitelesítő adatait a translator-folyamatokhoz.

5. Ekkor megjelenik a Dokumentumfordítás indítása művelet ablak. Töltse ki a mezőket az alábbiak szerint:

6. A bemeneti dokumentumok Tárolási típusa esetén. Válassza a Fájl vagy mappa lehetőséget.

7. Válasszon egy forrásnyelvet a legördülő menüből, vagy tartsa meg az alapértelmezett automatikus észlelési beállítást.

8. A forrásdokumentumok helye. Jelölje ki a mezőt, és adja hozzá az Elérési utat , majd a Név elemet a Dinamikus tartalom legördülő listából.

9. A lefordított dokumentumok helye. Adja meg az Azure Storage-céldokumentum tárolójának URL-címét.

   A céltároló URL-címének megkeresése:

   • Az Azure Portalon nyissa meg a tárfiókot.
   • A bal oldali oldalsáv Adattárolás területén válassza a Tárolók lehetőséget.
   • Jelölje be a céltároló melletti jelölőnégyzetet.
   • Válassza ki a jobb oldalon található három pontot, majd válassza a Tulajdonságok lehetőséget.
   • A cél URL-cím a Tulajdonságok lista tetején található. Válassza a Másolás vágólapra ikont.
   • Lépjen vissza a Power Automate-folyamathoz, és illessze be a cél URL-címet a lefordított dokumentumok helye mezőbe.

10. Válasszon egy célnyelvet a legördülő menüből, és válassza a Mentés lehetőséget.

    

Dokumentumok állapotának lekérése

A dokumentumok állapotának lekérése előtt ütemezzünk be 30 másodperces késleltetést, hogy a fájl feldolgozásra kerüljön fordításra:

1. Válassza az Új lépés lehetőséget. Írja be az Ütemezés kifejezést a keresőmezőbe, és válassza a Késleltetés lehetőséget.

   • A darabszámhoz. Adja meg a 30-at.
   • Egységhez. Adja meg a másodikat a legördülő listából.

   

2. Válassza az Új lépés lehetőséget. Írja be a Translator V3 kifejezést a keresőmezőbe, és válassza a Microsoft Translator V3 lehetőséget.

3. Válassza a Dokumentumok lekérése állapotot (nem az egyes dokumentumállapot lekérése lehetőséget ).

   

4. Ezután egy kifejezést fog megadni az érték lekéréséhez operation ID .

5. Válassza ki a műveletazonosító mezőt. Megjelenik egy Dinamikus tartalomkifejezés / legördülő ablak.

6. Jelölje ki a Kifejezés lapot, és írja be a következő kifejezést a függvénymezőbe:

   
     body('Start_document_translation').operationID
   
   

   

7. Kattintson az OK gombra. A függvény megjelenik a Műveletazonosító ablakban. Válassza a Mentés parancsot.

   

Blobtartalom és metaadatok lekérése

Ebben a lépésben lekéri a lefordított dokumentumot az Azure Blob Storage-ból, és feltölti azt a SharePointba.

1. Válassza az Új lépés lehetőséget, írja be a Vezérlőt a keresőmezőbe, és válassza az Alkalmaz elemet a Műveletek listából.

2. Válassza ki a beviteli mezőt a Dinamikus tartalom ablak megjelenítéséhez és az érték kiválasztásához.

   

3. Válassza a Művelet hozzáadása lehetőséget.

   

4. Írja be a Control billentyűt a keresőmezőbe, és válassza a Do (Do) elemet a Műveletek listából.

5. Válassza az Érték kiválasztása mezőt a Dinamikus tartalom ablak megjelenítéséhez és a folyamat kiválasztásához.

6. Töltse ki a három mezőt az alábbiak szerint: a folyamat → egyenlő az 1 →:

   

7. Válassza a Művelet hozzáadása lehetőséget, írja be az Azure Blob Storage kifejezést a keresőmezőbe, és válassza a Blobtartalom lekérése elérési út (V2) művelet használatával lehetőséget.

8. A Tárfiók neve vagy blobvégpont mezőjében válassza az Enter custom value (Egyéni érték megadása) lehetőséget, és adja meg a tárfiók nevét.

9. Válassza ki a Blob elérési útja mezőt a Dinamikus tartalom ablak megjelenítéséhez, válassza a Kifejezés lehetőséget, és írja be a következő logikát a képletmezőbe:

   
      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. Válassza a Művelet hozzáadása lehetőséget, írja be az Azure Blob Storage kifejezést a keresőmezőbe, és válassza a Blob Metaadatok lekérése elérési út (V2) művelet használatával.

11. A Tárfiók neve vagy blobvégpont mezőjében válassza az Enter custom value (Egyéni érték megadása) lehetőséget, és adja meg a tárfiók nevét.

    

12. Válassza ki a Blob elérési útja mezőt a Dinamikus tartalom ablak megjelenítéséhez, válassza a Kifejezés lehetőséget, és írja be a következő logikát a képletmezőbe:

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

Új mappa létrehozása

1. Válassza a Művelet hozzáadása lehetőséget, írja be a SharePointot a keresőmezőbe, és válassza az Új mappa létrehozása műveletet.
2. Válassza ki a SharePoint URL-címét a Webhelycím legördülő menüből.
3. A következő mezőben válasszon ki egy listát vagy tárat a legördülő listából.
4. Nevezze el az új mappát, és írja be a /Mappa elérési útja/ mezőbe (ügyeljen arra, hogy az elérési út nevét perjelekkel együtt helyezze el).

SharePoint-fájl létrehozása

1. Válassza a Művelet hozzáadása lehetőséget, írja be a SharePointot a keresőmezőbe, és válassza a Fájl létrehozása műveletet.

2. Válassza ki a SharePoint URL-címét a Webhelycím legördülő menüből.

3. A Mappa elérési útja mezőben a Dinamikus tartalomlistaÚj mappa létrehozása területén válassza a Teljes elérési út lehetőséget.

4. A Fájlnév mező Dinamikus tartalom listájában a Blob metaadatainak lekérése elérési út (V2) területén válassza a Név lehetőséget.

5. A Fájltartalom mezőben a Dinamikus tartalom listából válassza a Blob-metaadatok lekérése elérési út (V2) területen a Fájltartalom lehetőséget.

6. Válassza a Mentés parancsot.

   

Az összekötő folyamatának tesztelése

Nézzük meg a dokumentumfordítási folyamatot és az eredményeket.

1. Az oldal tetején egy zöld sáv jelzi, hogy a folyamat készen áll a használatra.

2. Válassza a Teszt lehetőséget a lap jobb felső sarkában.

   

3. Válassza a Folyamat tesztelése → a jobb oldali ablakból → teszt manuális → lehetőséget.

4. A Folyamat futtatása ablakban válassza a Folytatás, majd a Folyamat futtatása gombot.

5. Végül válassza a Kész gombot.

6. Kapnia kell egy "A folyamat sikeresen futott" üzenetet, és a zöld pipa az egyes sikeres lépésekhez igazodik.

   

Ennyi az egész! Megtanulta, hogyan automatizálhatja a dokumentumfordítási folyamatokat a Microsoft Translator V3-összekötő és a Power Automate használatával.

Következő lépések

A dokumentumfordítási referencia útmutatójának megismerése