Een stroom voor documentomzetting maken (preview)

Belangrijk

De Translator-connector is momenteel beschikbaar in openbare preview. Functies, benaderingen en processen kunnen veranderen, vóór algemene beschikbaarheid (GA), op basis van feedback van gebruikers.

In deze zelfstudie wordt u begeleid bij het configureren van een Microsoft Translator V3-connectorcloudstroom die ondersteuning biedt voor documentomzetting. De Translator V3-connector maakt een verbinding tussen uw Translator Service-exemplaar en Microsoft Power Automate, zodat u een of meer vooraf gemaakte bewerkingen kunt gebruiken als stappen in uw apps en werkstromen.

Documentomzetting is een cloudgebaseerde REST API-functie van de Azure AI Translator-service. Met de API voor documentomzetting kunt u meerdere en complexe documentomzettingen uitvoeren, terwijl de oorspronkelijke documentstructuur en gegevensindeling behouden blijven.

In deze zelfstudie:

• Maak een blob-opslagaccount met containers voor uw bron- en doelbestanden.
• Een beheerde identiteit instellen met op rollen gebaseerd toegangsbeheer (RBAC).
• Documenten vertalen vanuit uw Azure Blob Storage-account.
• Documenten vertalen van uw SharePoint-site.

Vereisten

Dit is wat u moet doen om aan de slag te gaan: Translator-resource, Azure-opslagaccount met ten minste twee containers en een door het systeem toegewezen beheerde identiteit met op rollen gebaseerde toegang.

Translator-resource

• Als u geen actief Azure-account hebt, kunt u er gratis een maken.

• Maak een Translator-resource met één service (niet een Azure AI-servicesresource met meerdere services). Let bij het voltooien van de velden translator-project en instantiedetails op de volgende vermeldingen:

  • Resourceregio. Kies een geografische regio, zoals VS - west (niet de globale regio).

  • Prijscategorie. Selecteer Standard S1 om de service uit te proberen.

• Gebruik de sleutel en naam van uw Translator-resource om uw toepassing te verbinden met Power Automate. Uw Translator-resourcesleutels vindt u in de sectie Resourcebeheer in Azure Portal en uw resourcenaam bevindt zich boven aan de pagina.

  

• Kopieer en plak uw sleutel en resourcenaam op een handige locatie, zoals Microsoft Kladblok.

Azure Storage

• Vervolgens hebt u een Azure Blob Storage-account en ten minste twee containers nodig voor uw bron- en doelbestanden:

  • Broncontainer. In deze container uploadt u uw bestanden voor vertaling (vereist).
  • Doelcontainer. In deze container worden uw vertaalde bestanden opgeslagen (vereist).

• Als uw opslagaccount zich achter een firewall bevindt, moet u aanvullende configuraties inschakelen:

  1. Ga naar Azure Portal en meld u aan bij uw account.

  2. Selecteer uw opslagaccount.

  3. Selecteer Netwerken in de groep Beveiliging en netwerken in het linkerdeelvenster.

  4. Selecteer op het tabblad Firewalls en virtuele netwerken de optie Ingeschakeld in geselecteerde virtuele netwerken en IP-adressen.

     

  5. Schakel alle selectievakjes uit.

  6. Zorg ervoor dat Microsoft-netwerkroutering is geselecteerd.

  7. Selecteer in de sectie Resource-exemplaren Microsoft.CognitiveServices/accounts als het resourcetype en selecteer uw Translator-resource als de naam van het exemplaar.

  8. Zorg ervoor dat het selectievakje Azure-services toestaan in de lijst met vertrouwde services voor toegang tot dit opslagaccount is ingeschakeld. Zie Azure Storage-firewalls en virtuele netwerken configureren voor meer informatie over het beheren van uitzonderingen.

     

  9. Selecteer Opslaan. Het kan tot 5 minuten duren voordat de netwerkwijzigingen zijn doorgegeven.

Beheerde identiteit met RBAC

Voordat u de bewerkingen van de Translator V3-connector voor documentvertaling kunt gebruiken, moet u uw Translator-resource toegang verlenen tot uw opslagaccount met behulp van een beheerde identiteit met op rollen gebaseerd identiteitsbeheer (RBAC).

Een beheerde identiteit maken

Maak eerst een door het systeem toegewezen beheerde identiteit voor uw Translator-resource en verken die identiteitsspecifieke machtigingen voor toegang tot uw Azure-opslagaccount:

1. Ga naar Azure Portal en meld u aan bij uw account.

2. Selecteer de Translator-resource.

3. Selecteer Identiteit in de groep Resourcebeheer in het linkerdeelvenster.

4. Schakel op het tabblad Door systeem toegewezen de wisselknop Status in.

5. Selecteer Opslaan.

   

Roltoewijzing

Wijs vervolgens een Storage Blob Data Contributor rol toe aan de beheerde identiteit in het opslagbereik voor uw opslagresource.

1. Ga naar Azure Portal en meld u aan bij uw account.

2. Selecteer de Translator-resource.

3. Selecteer Identiteit in de groep Resourcebeheer in het linkerdeelvenster.

4. Selecteer onder Machtigingen Azure-roltoewijzingen:

   

5. Kies op de pagina Azure-roltoewijzingen die zijn geopend uw abonnement in de vervolgkeuzelijst en selecteer vervolgens + Roltoewijzing toevoegen.

   

6. Wijs ten slotte de rol Inzender voor opslagblobgegevens toe aan uw Translator-serviceresource. De rol Inzender voor opslagblobgegevens geeft Translator (vertegenwoordigd door de door het systeem toegewezen beheerde identiteit) lees-, schrijf- en verwijdertoegang tot de blobcontainer en -gegevens. Vul in het pop-upvenster Roltoewijzing toevoegen de velden als volgt in en selecteer Opslaan:

   Veld	Waarde
   Scope	Opslag.
   Abonnement	Het abonnement dat is gekoppeld aan uw opslagresource.
   Resource	De naam van uw opslagresource.
   - Rol	Inzender voor Opslagblobgegevens.

7. Nadat het bevestigingsbericht voor roltoewijzing toegevoegd wordt weergegeven, vernieuwt u de pagina om de toegevoegde roltoewijzing te zien.

   

8. Als u de nieuwe roltoewijzing niet meteen ziet, wacht u en vernieuwt u de pagina opnieuw. Wanneer u roltoewijzingen toewijst of verwijdert, kan het tot 30 minuten duren voordat wijzigingen van kracht worden.

   

Een stroom voor documentomzetting configureren

Nu u de vereisten en de eerste installatie hebt voltooid, gaan we aan de slag met de Translator V3-connector om uw stroom voor documentomzetting te maken:

1. Meld u aan bij Power Automate.

2. Selecteer Maken in het linkerzijbalkmenu.

3. Selecteer Direct cloudstroom in het hoofdinhoudsgebied.

   

4. Geef uw stroom een naam in het pop-upvenster en kies Handmatig een stroom activeren en Maken selecteren.

   

5. De eerste stap voor uw directe stroom, handmatig een stroom activeren, wordt weergegeven op het scherm. Selecteer Nieuwe stap.

   

Documenten vertalen

Vervolgens zijn we klaar om een actie te selecteren. U kunt documenten vertalen die zich in uw Azure Blob Storage - of Microsoft SharePoint-account bevinden.

Azure Blob Storage gebruiken

Azure Blob-opslag

Hier volgen de stappen voor het vertalen van een bestand in Azure Blob Storage met behulp van de Translator V3-connector:

• Kies de Translator V3-connector.
• Selecteer documentomzetting.
• Voer uw Azure Blob Storage-referenties en containerlocaties in.
• Vertaal uw documenten door bron- en doeltalen te kiezen.
• De status van de vertaalbewerking ophalen.

1. Voer in het pop-upvenster Een bewerking kiezen Translator V3 in de zoekconnectors en actieszoekbalk in en selecteer het pictogram Microsoft Translator V3 .

   

2. Selecteer de bewerking Documentvertaling starten .

3. Als u de Translator V3-connector voor het eerst gebruikt, moet u uw resourcereferenties invoeren:

   • Verbindingsnaam. Geef een naam voor uw verbinding op.

   • Abonnementssleutel. Uw Translator-resourcesleutels vindt u in de sectie Resourcebeheer van de zijbalk van de resource in Azure Portal. Voer een van uw sleutels in. Zorg ervoor dat uw Translator-resource is toegewezen aan een geografische regio, zoals VS - west (niet wereldwijd).

   • Naam van translator-resource. Voer de naam in van uw Translator-resource boven aan de resourcepagina in Azure Portal. Selecteer Maken.

     

     Notitie

     Nadat u de verbinding hebt ingesteld, hoeft u uw referenties niet opnieuw in te voeren voor volgende stromen.

4. Het actievenster Documentvertaling starten wordt nu weergegeven. Vul de velden als volgt in:

   • Voor het opslagtype van de invoerdocumenten. Selecteer Bestand of map.

   • Selecteer een brontaal in de vervolgkeuzelijst of behoud de standaardoptie voor automatisch detecteren .

   • Locatie van de brondocumenten. Voer de URL voor uw documenten in uw Azure Storage-brondocumentcontainer in.

   • Locatie van de vertaalde documenten. Voer de URL in voor uw Azure Storage-doeldocumentcontainer.

     Uw bron- en doel-URL's zoeken:

     • Ga in het Navigeer naar uw opslagaccount in de Azure-portal.

     • Selecteer containers in de linkerzijbalk onder Gegevensopslag:

       Source	Target
       Schakel het selectievakje naast de broncontainer in	Schakel het selectievakje naast de doelcontainer in.
       Selecteer in het hoofdvenstergebied een bestand of document voor vertaling.	Selecteer het beletselteken aan de rechterkant en kies Eigenschappen.
       De bron-URL bevindt zich boven aan de lijst Eigenschappen. Selecteer het pictogram Kopiëren naar Klembord .	De doel-URL bevindt zich boven aan de lijst Eigenschappen. Selecteer het pictogram Kopiëren naar Klembord .
       Navigeer naar uw Power Automate-stroom en plak de bron-URL in het veld Locatie van het brondocumentenveld .	Navigeer naar uw Power Automate-stroom en plak de doel-URL in de locatie van het veld vertaalde documenten .

   • Kies een doeltaal in de vervolgkeuzelijst en selecteer Opslaan.

     

Status van documenten ophalen

Nu u uw documenten hebt ingediend voor vertaling, gaan we de status van de bewerking controleren.

1. Selecteer Nieuwe stap.

2. Voer Translator V3 in het zoekvak in en kies Microsoft Translator V3.

3. Selecteer Status van documenten ophalen (niet de enkelvoudige actie Documentstatus ophalen).

   

4. Vervolgens gaat u een expressie invoeren om de operation ID waarde op te halen.

5. Selecteer het veld bewerkings-id. Er wordt een vervolgkeuzevenster voor expressies voor dynamische inhoud / weergegeven.

6. Selecteer het tabblad Expressie en voer de volgende expressie in het functieveld in:

   
      body('Start_document_translation').operationID
   
   

   

7. Selecteer OK. De functie wordt weergegeven in het venster Bewerkings-id . Selecteer Opslaan.

   

De verbindingsstroom testen

Tijd om onze stroom- en documentomzettingsresultaten te controleren.

1. Boven aan de pagina ziet u een groene balk die aangeeft dat uw stroom klaar is voor gebruik.

2. Selecteer Testen in de rechterbovenhoek van de pagina.

   

3. Selecteer de volgende knoppen: Test Flow → Handmatig → Testen in het rechtervenster.

4. Selecteer in het volgende venster de knop Stroom uitvoeren .

5. Selecteer ten slotte de knop Gereed .

6. Als het goed is, ontvangt u een bericht dat uw stroom is uitgevoerd en worden groene vinkjes uitgelijnd met elke geslaagde stap.

   

7. Selecteer de stap Documentenstatus ophalen en selecteer vervolgens Onbewerkte uitvoer weergeven in de sectie Uitvoer .

8. Er wordt een venster Documentenstatus ophalen weergegeven. Boven aan het JSON-antwoord ziet "statusCode":200 u dat de aanvraag is geslaagd.

   

9. Als laatste controle gaat u naar uw Doelbroncontainer van Azure Blob Storage. Daar ziet u het vertaalde document in de sectie Overzicht . Het document bevindt zich mogelijk in een map met het label Vertaaltaalcode.

Microsoft SharePoint gebruiken

Microsoft SharePoint

Hier volgen de stappen voor het uploaden van een bestand van uw SharePoint-site naar Azure Blob Storage, het bestand vertalen en het vertaalde bestand retourneren naar SharePoint:

• Haal de inhoud van het bronbestand op van uw SharePoint-site.
• Maak een Azure Storage-blob op basis van het bronbestand.
• Vertaal het bronbestand.
• Status van documenten ophalen.
• Blob-inhoud en -metagegevens ophalen.
• Maak een nieuwe SharePoint-map.
• Maak uw vertaalde bestand in Sharepoint.

Bestandsinhoud ophalen

1. Voer in het pop-upvenster Een bewerking kiezen SharePoint in en selecteer vervolgens de inhoud van het bestand ophalen. Power Automate meldt u automatisch aan bij uw SharePoint-accounts.

   

2. Vul in het stapvenster Bestandsinhoud ophalen de volgende velden in:

   • Siteadres. Selecteer de URL van de SharePoint-site waar het bestand zich bevindt in de vervolgkeuzelijst.
   • Bestands-id. Selecteer het mappictogram en kies de documenten voor vertaling.

Een opslagblob maken

1. Selecteer Nieuwe stap en voer Azure Blob Storage in het zoekvak in.

2. Selecteer de actie Blob maken (V2).

3. Als u de Azure Storage-stap voor de eerste keer gebruikt, moet u de verificatie van uw opslagresource invoeren:

4. Kies in het veld Verificatietype microsoft Entra geïntegreerd en selecteer vervolgens de knop Aanmelden.

   

5. Kies het Microsoft Entra-account dat is gekoppeld aan uw Azure Blob Storage- en Translator-resourceaccounts.

6. Nadat u de Verificatie van Azure Blob Storage hebt voltooid, wordt de stap Blob maken weergegeven. Vul de velden als volgt in:

   • Naam van opslagaccount of blob-eindpunt. Selecteer Aangepaste waarde invoeren en voer de naam van uw opslagaccount in.

   • Mappad. Selecteer het mappictogram en selecteer de brondocumentcontainer.

   • Blobnaam. Voer de naam in van het bestand dat u vertaalt.

   • Blob-inhoud. Selecteer het veld Blob-inhoud om de vervolgkeuzelijst dynamische inhoud weer te geven en kies het pictogram Bestandsinhoud van SharePoint.

     

Documentomzetting starten

1. Selecteer Nieuwe stap.

2. Voer Translator V3 in het zoekvak in en kies Microsoft Translator V3.

3. Selecteer de bewerking Documentvertaling starten .

4. Als u de Translator V3-connector voor het eerst gebruikt, moet u uw resourcereferenties invoeren:

   • Verbindingsnaam. Geef een naam voor uw verbinding op.

   • Abonnementssleutel. Voer een van uw sleutels in die u hebt gekopieerd uit Azure Portal.

   • Naam van translator-resource. Voer de naam in van uw Translator-resource boven aan de resourcepagina in Azure Portal.

   • Selecteer Maken.

     

     Notitie

     Nadat u de verbinding hebt ingesteld, hoeft u uw referenties niet opnieuw in te voeren voor volgende Translator-stromen.

5. Het actievenster Documentvertaling starten wordt nu weergegeven. Vul de velden als volgt in:

6. Voor het opslagtype van de invoerdocumenten. Selecteer Bestand of map.

7. Selecteer een brontaal in de vervolgkeuzelijst of behoud de standaardoptie voor automatisch detecteren .

8. Locatie van de brondocumenten. Selecteer het veld en voeg Pad toe gevolgd door Naam in de vervolgkeuzelijst Dynamische inhoud.

9. Locatie van de vertaalde documenten. Voer de URL in voor uw Azure Storage-doeldocumentcontainer.

   Ga als volgende te werk om de URL van uw doelcontainer te vinden:

   • Ga in het Navigeer naar uw opslagaccount in de Azure-portal.
   • Selecteer Containers in de linkerzijbalk onder Gegevensopslag.
   • Schakel het selectievakje naast de doelcontainer in.
   • Selecteer het beletselteken aan de rechterkant en kies Eigenschappen.
   • De doel-URL bevindt zich boven aan de lijst Eigenschappen. Selecteer het pictogram Kopiëren naar Klembord .
   • Ga terug naar uw Power Automate-stroom en plak de doel-URL in de locatie van het veld vertaalde documenten .

10. Kies een doeltaal in de vervolgkeuzelijst en selecteer Opslaan.

    

Status van documenten ophalen

Voordat u de status van de documenten opzoekt, plannen we een vertraging van 30 seconden om ervoor te zorgen dat het bestand wordt verwerkt voor vertaling:

1. Selecteer Nieuwe stap. Voer Planning in het zoekvak in en kies Vertraging.

   • Voor Count. Voer 30 in.
   • Voor eenheid. Voer tweede in de vervolgkeuzelijst in.

   

2. Selecteer Nieuwe stap. Voer Translator V3 in het zoekvak in en kies Microsoft Translator V3.

3. Selecteer Status van documenten ophalen (niet de enkelvoudige documentstatus ophalen).

   

4. Vervolgens gaat u een expressie invoeren om de operation ID waarde op te halen.

5. Selecteer het veld bewerkings-id . Er wordt een vervolgkeuzevenster voor expressies voor dynamische inhoud / weergegeven.

6. Selecteer het tabblad Expressie en voer de volgende expressie in het functieveld in:

   
     body('Start_document_translation').operationID
   
   

   

7. Selecteer OK. De functie wordt weergegeven in het venster Bewerkings-id . Selecteer Opslaan.

   

Blob-inhoud en -metagegevens ophalen

In deze stap haalt u het vertaalde document op uit Azure Blob Storage en uploadt u het naar SharePoint.

1. Selecteer Nieuwe stap, voer Besturingselement in het zoekvak in en selecteer Toepassen op elke stap in de lijst Acties.

2. Selecteer het invoerveld om het venster Dynamische inhoud weer te geven en selecteer waarde.

   

3. Selecteer Een actie toevoegen.

   

4. Voer Besturingselement in het zoekvak in en selecteer Do tot in de lijst Acties.

5. Selecteer het veld Een waarde kiezen om het venster Dynamische inhoud weer te geven en selecteer de voortgang.

6. Vul de drie velden als volgt in: voortgang → gelijk is aan → 1:

   

7. Selecteer Een actie toevoegen, voer Azure Blob Storage in het zoekvak in en selecteer de actie Blob-inhoud ophalen met behulp van de padactie (V2 ).

8. Selecteer in het veld Opslagaccountnaam of blob-eindpunt de optie Aangepaste waarde invoeren en voer de naam van uw opslagaccount in.

9. Selecteer het padveld Blob om het venster Dynamische inhoud weer te geven, selecteer Expressie en voer de volgende logica in het formuleveld in:

   
      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. Selecteer Een actie toevoegen, voer Azure Blob Storage in het zoekvak in en selecteer de actie Blobmetagegevens ophalen met behulp van pad (V2).

11. Selecteer in het veld Opslagaccountnaam of blob-eindpunt de optie Aangepaste waarde invoeren en voer de naam van uw opslagaccount in.

    

12. Selecteer het padveld Blob om het venster Dynamische inhoud weer te geven, selecteer Expressie en voer de volgende logica in het formuleveld in:

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

Nieuwe map maken

1. Selecteer Een actie toevoegen, voer SharePoint in het zoekvak in en selecteer de actie Nieuwe map maken.
2. Selecteer uw SharePoint-URL in het vervolgkeuzelijstvenster Siteadres .
3. Selecteer in het volgende veld een lijst of bibliotheek in de vervolgkeuzelijst.
4. Geef de nieuwe map een naam en voer deze in het veld /Mappad/ in (plaats de padnaam tussen slashes).

SharePoint-bestand maken

1. Selecteer Een actie toevoegen, voer SharePoint in het zoekvak in en selecteer de actie Bestand maken.

2. Selecteer uw SharePoint-URL in het vervolgkeuzelijstvenster Siteadres .

3. Selecteer in het veld Mappad, in de lijst met dynamische inhoud, onder Nieuwe map maken, het volledige pad.

4. Selecteer in het veld Bestandsnaam, in de lijst met dynamische inhoud, onder Blobmetagegevens ophalen met behulp van het pad (V2) de optie Naam.

5. Selecteer in het veld Bestandsinhoud, in de lijst met dynamische inhoud, onder Blobmetagegevens ophalen met behulp van het pad (V2) Bestandsinhoud.

6. Selecteer Opslaan.

   

De connectorstroom testen

Laten we de vertaalstroom en resultaten van uw document controleren.

1. Boven aan de pagina ziet u een groene balk die aangeeft dat uw stroom klaar is voor gebruik.

2. Selecteer Testen in de rechterbovenhoek van de pagina.

   

3. Selecteer Teststroom → Handmatig → Testen in het rechtervenster.

4. Selecteer in het venster Stroom uitvoeren de knoppen Doorgaan en vervolgens de knoppen Stroom uitvoeren.

5. Selecteer ten slotte de knop Gereed .

6. Als het goed is, ontvangt u het bericht 'Uw stroom is uitgevoerd' en worden de groene vinkjes uitgelijnd met elke geslaagde stap.

   

Dat is het! U hebt geleerd om documentomzettingsprocessen te automatiseren met behulp van de Microsoft Translator V3-connector en Power Automate.

Volgende stappen

De naslaghandleiding voor documentvertaling verkennen