Skapa ett dokumentöversättningsflöde (förhandsversion)

Viktigt!

Translator-anslutningsappen är för närvarande tillgänglig i offentlig förhandsversion. Funktioner, metoder och processer kan ändras, före allmän tillgänglighet (GA), baserat på användarfeedback.

Den här självstudien vägleder dig genom att konfigurera ett molnflöde för Microsoft Translator V3-anslutningsprogram som stöder dokumentöversättning. Translator V3-anslutningsappen skapar en anslutning mellan din Translator Service-instans och Microsoft Power Automate så att du kan använda en eller flera fördefinierade åtgärder som steg i dina appar och arbetsflöden.

Dokumentöversättning är en molnbaserad REST API-funktion i Azure AI Translator-tjänsten. API:et för dokumentöversättning möjliggör flera och komplexa dokumentöversättningar samtidigt som den ursprungliga dokumentstrukturen och dataformatet bevaras.

I den här självstudien:

• Skapa ett bloblagringskonto med containrar för käll- och målfilerna.
• Konfigurera en hanterad identitet med rollbaserad åtkomstkontroll (RBAC).
• Översätta dokument från ditt Azure Blob Storage-konto.
• Översätta dokument från din SharePoint-webbplats.

Förutsättningar

Det här behöver du för att komma igång: Translator-resurs, Azure Storage-konto med minst två containrar och en systemtilldelad hanterad identitet med rollbaserad åtkomst.

Translator-resurs

• Om du inte har ett aktivt Azure-konto kan du skapa ett kostnadsfritt.

• Skapa en Translator-resurs med en enda tjänst (inte en Azure AI-tjänstresurs med flera tjänster). När du har slutfört fälten Translator-projekt och instansinformation bör du ägna särskild uppmärksamhet åt följande poster:

  • Resursregion. Välj en geografisk region som USA , västra (inte den globala regionen).

  • Prisnivå. Välj Standard S1 för att prova tjänsten.

• Använd nyckeln och namnet från Translator-resursen för att ansluta ditt program till Power Automate. Dina Translator-resursnycklar finns under avsnittet Resurshantering i Azure-portalen och resursnamnet finns överst på sidan.

  

• Kopiera och klistra in nyckeln och resursnamnet på en lämplig plats, till exempel Microsoft Anteckningar.

Azure Storage

• Därefter behöver du ett Azure Blob Storage-konto och minst två containrar för dina käll- och målfiler:

  • Källcontainer. I den här containern laddar du upp dina filer för översättning (krävs).
  • Målcontainer. I den här containern lagras dina översatta filer (krävs).

• Om ditt lagringskonto finns bakom en brandvägg måste du aktivera ytterligare konfigurationer:

  1. Gå till Azure-portalen och logga in på ditt Azure-konto.

  2. Välj ditt lagringskonto.

  3. I gruppen Säkerhet + nätverk i den vänstra rutan väljer du Nätverk.

  4. På fliken Brandväggar och virtuella nätverk väljer du Aktiverad från valda virtuella nätverk och IP-adresser.

     

  5. Avmarkera alla kryssrutor.

  6. Kontrollera att Microsofts nätverksroutning är markerad.

  7. Under avsnittet Resursinstanser väljer du Microsoft.CognitiveServices/accounts som resurstyp och väljer din Translator-resurs som instansnamn.

  8. Kontrollera att rutan Tillåt Azure-tjänster i listan över betrodda tjänster att komma åt det här lagringskontot är markerad. Mer information om hur du hanterar undantag finns iKonfigurera Azure Storage-brandväggar och virtuella nätverk.

     

  9. Välj Spara. Det kan ta upp till 5 minuter innan nätverksändringarna sprids.

Hanterad identitet med RBAC

Innan du kan använda Translator V3-anslutningsappens åtgärder för dokumentöversättning måste du slutligen ge Translator-resursen åtkomst till ditt lagringskonto med hjälp av en hanterad identitet med rollbaserad identitetskontroll (RBAC).

Skapa en hanterad identitet

Skapa först en systemtilldelad hanterad identitet för din Translator-resurs och ge den identiteten specifika behörigheter för att få åtkomst till ditt Azure-lagringskonto:

1. Gå till Azure-portalen och logga in på ditt Azure-konto.

2. Välj Translator-resursen.

3. I gruppen Resurshantering i den vänstra rutan väljer du Identitet.

4. På fliken Systemtilldelat aktiverar du växlingsknappen Status .

5. Välj Spara.

   

Rolltilldelning

Tilldela sedan en Storage Blob Data Contributor roll till den hanterade identiteten i lagringsomfånget för lagringsresursen.

1. Gå till Azure-portalen och logga in på ditt Azure-konto.

2. Välj Translator-resursen.

3. I gruppen Resurshantering i den vänstra rutan väljer du Identitet.

4. Under Behörigheter väljer du Azure-rolltilldelningar:

   

5. På sidan Azure-rolltilldelningar som öppnades väljer du din prenumeration på den nedrullningsbara menyn och väljer sedan + Lägg till rolltilldelning.

   

6. Tilldela slutligen rollen Storage Blob Data Contributor till din Translator-tjänstresurs. Rollen Storage Blob Data Contributor ger Translator (representeras av den systemtilldelade hanterade identiteten) läs-, skriv- och borttagningsåtkomst till blobcontainern och data. I popup-fönstret Lägg till rolltilldelning fyller du i fälten på följande sätt och väljer Spara:

   Fält	Värde
   Definitionsområde	Lagring.
   Abonnemang	Prenumerationen som är associerad med din lagringsresurs.
   Resurs	Namnet på lagringsresursen.
   Roll	Storage Blob Data-deltagare.

7. När bekräftelsemeddelandet Om rolltilldelning har lagts till visas uppdaterar du sidan för att se den tillagda rolltilldelningen.

   

8. Om du inte ser den nya rolltilldelningen direkt väntar du och försöker uppdatera sidan igen. När du tilldelar eller tar bort rolltilldelningar kan det ta upp till 30 minuter innan ändringarna börjar gälla.

   

Konfigurera ett dokumentöversättningsflöde

Nu när du har slutfört förutsättningarna och den inledande installationen ska vi komma igång med translator V3-anslutningsappen för att skapa ditt dokumentöversättningsflöde:

1. Logga in på Power Automate.

2. Välj Skapa på menyn på den vänstra sidopanelen.

3. Välj Direkt molnflöde från huvudinnehållsområdet.

   

4. I popup-fönstret namnger du flödet och väljer sedan Utlösa ett flöde manuellt och väljer Skapa.

   

5. Det första steget för ditt omedelbara flöde – utlösa ett flöde manuellt – visas på skärmen. Välj Nytt steg.

   

Översätta dokument

Nu är vi redo att välja en åtgärd. Du kan översätta dokument som finns i ditt Azure Blob Storage - eller Microsoft SharePoint-konto .

Använda Azure Blob Storage

Azure Blob Storage

Här följer stegen för att översätta en fil i Azure Blob Storage med hjälp av Translator V3-anslutningsappen:

• Välj Translator V3-anslutningsappen.
• Välj dokumentöversättning.
• Ange dina Azure Blob Storage-autentiseringsuppgifter och containerplatser.
• Översätt dokument som väljer käll- och målspråk.
• Hämta status för översättningsåtgärden.

1. I popup-fönstret Välj en åtgärd anger du Translator V3 i sökfältet Sök efter anslutningsappar och åtgärder och väljer ikonen Microsoft Translator V3.

   

2. Välj åtgärden Starta dokumentöversättning.

3. Om du använder Translator V3-anslutningsappen för första gången måste du ange dina autentiseringsuppgifter för resursen:

   • Anslutningens namn. Ange ett namn för anslutningen.

   • Prenumerationsnyckel. Dina Translator-resursnycklar finns under avsnittet Resurshantering i resurslisten i Azure-portalen. Ange en av dina nycklar. Kontrollera att din Translator-resurs är tilldelad till en geografisk region, till exempel USA , västra (inte globalt).

   • Translator-resursnamn. Ange namnet på din Translator-resurs längst upp på resurssidan i Azure-portalen. Välj Skapa.

     

     Kommentar

     När du har konfigurerat anslutningen behöver du inte ange dina autentiseringsuppgifter igen för efterföljande flöden.

4. Fönstret Starta dokumentöversättning visas nu. Fyll i fälten på följande sätt:

   • För Lagringstyp för indatadokumenten. Välj Fil eller mapp.

   • Välj ett källspråk på den nedrullningsbara menyn eller behåll standardalternativet Automatisk identifiering .

   • Källdokumentens plats. Ange URL:en för dina dokument i azure-lagringskällans dokumentcontainer.

   • Plats för de översatta dokumenten. Ange URL:en för din Azure Storage-måldokumentcontainer.

     Så här hittar du dina käll- och mål-URL:er:

     • Navigera till ditt lagringskonto i Azure-portalen.

     • I det vänstra sidofältet går du till Datalagring och väljer Containrar:

       Source	Target
       Markera kryssrutan bredvid källcontainern	Markera kryssrutan bredvid målcontainern.
       I huvudfönstret väljer du en fil eller ett dokument för översättning.	Välj de ellipser som finns till höger och välj sedan Egenskaper.
       Käll-URL:en finns överst i listan Egenskaper. Välj ikonen Kopiera till Urklipp.	Mål-URL:en finns överst i listan Egenskaper. Välj ikonen Kopiera till Urklipp.
       Gå till power automate-flödet och klistra in käll-URL:en i fältet Plats för källdokumenten .	Gå till power automate-flödet och klistra in mål-URL:en i fältet Plats för de översatta dokumenten .

   • Välj ett målspråk på den nedrullningsbara menyn och välj Spara.

     

Hämta dokumentstatus

Nu när du har skickat dina dokument för översättning ska vi kontrollera åtgärdens status.

1. Välj Nytt steg.

2. Ange Translator V3 i sökrutan och välj Microsoft Translator V3.

3. Välj Hämta dokumentstatus (inte åtgärden Hämta dokumentstatus ).

   

4. Nu ska du ange ett uttryck för att hämta operation ID värdet.

5. Välj åtgärds-ID-fältet. Listrutan Uttryck för dynamiskt innehåll / visas.

6. Välj fliken Uttryck och ange följande uttryck i funktionsfältet:

   
      body('Start_document_translation').operationID
   
   

   

7. Välj OK. Funktionen visas i fönstret Åtgärds-ID . Välj Spara.

   

Testa anslutningsflödet

Dags att kontrollera resultatet av flödes- och dokumentöversättningen.

1. Det finns ett grönt fält överst på sidan som anger att flödet är klart.

2. Välj Testa i det övre högra hörnet på sidan.

   

3. Välj följande knappar: Testa Flow → manuellt → Testa från det högra fönstret.

4. I nästa fönster väljer du knappen Kör flöde .

5. Välj slutligen knappen Klar .

6. Du bör få meddelandet Ditt flöde har körts och gröna bockmarkeringar överensstämmer med varje lyckat steg.

   

7. Välj steget Hämta dokumentstatus och välj sedan Visa råutdata från avsnittet Utdata.

8. Statusfönstret Hämta dokument visas. Överst i JSON-svaret visas "statusCode":200 som anger att begäran lyckades.

   

9. Som en sista kontroll går du till din Azure Blob Storage-målkällacontainer. Där bör du se det översatta dokumentet i avsnittet Översikt . Dokumentet kan finnas i en mapp som är märkt med översättningsspråkkoden.

Använda Microsoft SharePoint

Microsoft SharePoint

Här följer stegen för att ladda upp en fil från SharePoint-webbplatsen till Azure Blob Storage, översätta filen och returnera den översatta filen till SharePoint:

• Hämta källfilinnehållet från Din SharePoint-webbplats.
• Skapa en Azure Storage-blob från källfilen.
• Översätt källfilen.
• Hämta dokumentstatus.
• Hämta blobinnehåll och metadata.
• Skapa en ny SharePoint-mapp.
• Skapa din översatta fil i Sharepoint.

Hämta filinnehåll

1. I popup-fönstret Välj en åtgärd anger du SharePoint och väljer sedan Hämta filinnehåll . Power Automate loggar automatiskt in dig på dina SharePoint-konton.

   

2. I fönstret Hämta filinnehållssteg slutför du följande fält:

   • Webbplatsadress. Välj den SharePoint-webbplats-URL där filen finns i listrutan.
   • Filidentifierare. Välj mappikonen och välj dokument för översättning.

Skapa en lagringsblob

1. Välj Nytt steg och ange Azure Blob Storage i sökrutan.

2. Välj åtgärden Skapa blob (V2).

3. Om du använder Azure Storage-steget för första gången måste du ange din lagringsresursautentisering:

4. I fältet Autentiseringstyp väljer du Microsoft Entra integrerat och väljer sedan knappen Logga in .

   

5. Välj det Microsoft Entra-konto som är associerat med dina Azure Blob Storage- och Translator-resurskonton.

6. När du har slutfört Azure Blob Storage-autentiseringenvisas steget Skapa blob . Fyll i fälten på följande sätt:

   • Lagringskontonamn eller blobslutpunkt. Välj Ange anpassat värde och ange namnet på lagringskontot.

   • Mappsökväg. Välj mappikonen och välj källdokumentcontainern.

   • Blobnamn. Ange namnet på filen som du översätter.

   • Blobinnehåll. Välj fältet Blobinnehåll för att visa listrutan Dynamiskt innehåll och välj ikonen SharePoint-filinnehåll.

     

Starta dokumentöversättning

1. Välj Nytt steg.

2. Ange Translator V3 i sökrutan och välj Microsoft Translator V3.

3. Välj åtgärden Starta dokumentöversättning.

4. Om du använder Translator V3-anslutningsappen för första gången måste du ange dina autentiseringsuppgifter för resursen:

   • Anslutningens namn. Ange ett namn för anslutningen.

   • Prenumerationsnyckel. Ange en av dina nycklar som du kopierade från Azure-portalen.

   • Translator-resursnamn. Ange namnet på din Translator-resurs längst upp på resurssidan i Azure-portalen.

   • Välj Skapa.

     

     Kommentar

     När du har konfigurerat anslutningen behöver du inte ange dina autentiseringsuppgifter igen för efterföljande Translator-flöden.

5. Fönstret Starta dokumentöversättning visas nu. Fyll i fälten på följande sätt:

6. För Lagringstyp för indatadokumenten. Välj Fil eller mapp.

7. Välj ett källspråk på den nedrullningsbara menyn eller behåll standardalternativet Automatisk identifiering .

8. Källdokumentens plats. Välj fältet och lägg till Sökväg följt av Namn i listrutan Dynamiskt innehåll .

9. Plats för de översatta dokumenten. Ange URL:en för din Azure Storage-måldokumentcontainer.

   Så här hittar du målcontainerns URL:

   • Navigera till ditt lagringskonto i Azure-portalen.
   • I det vänstra sidofältet går du till Datalagring och väljer Containrar.
   • Markera kryssrutan bredvid målcontainern.
   • Välj de ellipser som finns till höger och välj sedan Egenskaper.
   • Mål-URL:en finns överst i listan Egenskaper. Välj ikonen Kopiera till Urklipp.
   • Gå tillbaka till power automate-flödet och klistra in mål-URL:en i fältet Plats för översatta dokument .

10. Välj ett målspråk på den nedrullningsbara menyn och välj Spara.

    

Hämta dokumentstatus

Innan vi hämtar dokumentstatusen ska vi schemalägga en fördröjning på 30 sekunder för att säkerställa att filen har bearbetats för översättning:

1. Välj Nytt steg. Ange Schema i sökrutan och välj Fördröjning.

   • För Antal. Ange 30.
   • För enhet. Ange Second från listrutan.

   

2. Välj Nytt steg. Ange Translator V3 i sökrutan och välj Microsoft Translator V3.

3. Välj Hämta dokumentstatus (inte singularen Hämta dokumentstatus ).

   

4. Nu ska du ange ett uttryck för att hämta operation ID värdet.

5. Välj åtgärds-ID-fältet. Listrutan Uttryck för dynamiskt innehåll / visas.

6. Välj fliken Uttryck och ange följande uttryck i funktionsfältet:

   
     body('Start_document_translation').operationID
   
   

   

7. Välj OK. Funktionen visas i fönstret Åtgärds-ID . Välj Spara.

   

Hämta blobinnehåll och metadata

I det här steget hämtar du det översatta dokumentet från Azure Blob Storage och laddar upp det till SharePoint.

1. Välj Nytt steg, ange Kontroll i sökrutan och välj Tillämpa på var och en i listan Åtgärder .

2. Välj indatafältet för att visa fönstret Dynamiskt innehåll och välj värde.

   

3. Välj Lägg till en åtgärd.

   

4. Ange Kontroll i sökrutan och välj Gör till ilistan Åtgärder .

5. Välj fältet Välj ett värde för att visa fönstret Dynamiskt innehåll och välj förlopp.

6. Slutför de tre fälten på följande sätt: förlopp → är lika med → 1:

   

7. Välj Lägg till en åtgärd, ange Azure Blob Storage i sökrutan och välj åtgärden Hämta blobinnehåll med sökväg (V2).

8. I fältet Lagringskontonamn eller blobslutpunkt väljer du Ange anpassat värde och anger ditt lagringskontonamn.

9. Välj fältet Blobsökväg för att visa fönstret Dynamiskt innehåll , välj Uttryck och ange följande logik i formelfältet:

   
      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älj Lägg till en åtgärd, ange Azure Blob Storage i sökrutan och välj åtgärden Hämta blobmetadata med sökväg (V2).

11. I fältet Lagringskontonamn eller blobslutpunkt väljer du Ange anpassat värde och anger ditt lagringskontonamn.

    

12. Välj fältet Blobsökväg för att visa fönstret Dynamiskt innehåll , välj Uttryck och ange följande logik i formelfältet:

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

Skapa ny mapp

1. Välj Lägg till en åtgärd, ange SharePoint i sökrutan och välj åtgärden Skapa ny mapp .
2. Välj din SharePoint-URL i listrutan Webbplatsadress .
3. I nästa fält väljer du en lista eller ett bibliotek i listrutan.
4. Namnge den nya mappen och ange den i fältet /Mappsökväg/ (se till att omsluta sökvägens namn med snedstreck).

Skapa SharePoint-fil

1. Välj Lägg till en åtgärd, ange SharePoint i sökrutan och välj åtgärden Skapa fil .

2. Välj din SharePoint-URL i listrutan Webbplatsadress .

3. I fältet Mappsökväg går du till listan Dynamiskt innehåll och under Skapa ny mapp väljer du Fullständig sökväg .

4. I fältet Filnamn i listan Dynamiskt innehåll går du till Hämta blobmetadata med sökvägen (V2) och väljer Namn .

5. I fältet Filinnehåll går du till listan Dynamiskt innehåll och under Hämta blobmetadata med sökvägen (V2) väljer du Filinnehåll .

6. Välj Spara.

   

Testa anslutningsflödet

Nu ska vi kontrollera dokumentets översättningsflöde och resultat.

1. Det finns ett grönt fält överst på sidan som anger att flödet är klart..

2. Välj Testa i det övre högra hörnet på sidan.

   

3. Välj Test flow → manuellt → Test från det högra fönstret.

4. I fönstret Kör flöde väljer du knappen Fortsätt och sedan knapparna Kör flöde .

5. Välj slutligen knappen Klar .

6. Du bör få meddelandet "Ditt flöde har körts" och gröna bockmarkeringar överensstämmer med varje lyckat steg.

   

Det var allt! Du har lärt dig att automatisera dokumentöversättningsprocesser med hjälp av Microsoft Translator V3-anslutningsappen och Power Automate.

Nästa steg

Utforska referensguiden för dokumentöversättning